Unix Instructions

  1. Binary Download the archive to, for example, /tmp.
  2. Uncompress the archive: uncompress WaveLab0802.tar.Z
  3. Decide where you want the WaveLab directory to reside. It will have
    a number of subdirectories and occupy at least 5 MB disk space.
  4. cd to the place you want the directory to reside
  5. tar xvf <WaveLabTarFile>, where <WaveLabTarFile> should be
    the absolute pathname of the WaveLab0802.tar archive, for example
    with the /tmp prefix if necessary.
  6. After you de-tar the file for your machine, you should have the
    following directory structure:

    Wavelab
    Wavelab\Biorthogonal
    Wavelab\Books
    Wavelab\Books\WaveTour
    Wavelab\Browsers
    Wavelab\Browsers\One-D
    Wavelab\Browsers\WaveTour
    Wavelab\Continuous
    Wavelab\Datasets
    Wavelab\Denoising
    Wavelab\Documentation
    Wavelab\FastAlgoritms
    Wavelab\Fractals
    Wavelab\Interpulating
    Wavelab\Invariant
    Wavelab\Median
    Wavelab\MexSource
    Wavelab\Meyer
    Wavelab\Orthogonal
    Wavelab\Packets
    Wavelab\Packets\One-D
    Wavelab\Packets\Two-D
    Wavelab\Papers
    Wavelab\Papers\Adapt
    Wavelab\Papers\Asymp
    Wavelab\Papers\Blocky
    Wavelab\Papers\Correl
    Wavelab\Papers\Ideal
    Wavelab\Papers\MinEntSeg
    Wavelab\Papers\Mipt
    Wavelab\Papers\RiskAnalysis
    Wavelab\Papers\ShortCourse
    Wavelab\Papers\SpinCycle
    Wavelab\Papers\Tour
    Wavelab\Papers\VillardDelans
    Wavelab\Pursuit
    Wavelab\TimeFrequency
    Wavelab\Utilities
    Wavelab\Workouts
    Wavelab\Workouts\BestOrthoBasis
    Wavelab\Workouts\MatchingPersuit
    Wavelab\Workouts\MultiFractal
    Wavelab\workouts\Toons
  7. Edit the file WavePath.m, put the lines
    if strcmp(Friend,'<YourMachineType>'),
    WAVELABPATH = '<AbsolutePathNameforWaveLabMainDirectory>' ;
    PATHNAMESEPARATOR = '<YourMachine*sPathSeparator>';
    end

    in the appropriate place (this will be evident). Here {\tt Friend} has been
    predefined by the \Matlab\ command Friend = computer; Also, WAVELABPATH names the place where WaveLab will reside. For an individual user without root privileges, a good choice is ~<USERLOGIN>/matlab/WaveLab, where <USERLOGIN> is the user's account name. For a system manager with root priveleges, a good choice is <MatlabToolBoxPath>/WaveLab, where <MatlabToolBoxPath> is the name of the directory containing all the Matlab toolboxes.
  8. Copy all the wavelab files from the place you put the original Wavelab archive (for example /tmp) to their final destination as named in the variable WAVELABPATH, for example in your home directory ~user/matlab/WaveLab.
  9. In the matlab subdirectory of your home directory, put a copy
    of the files startup.m and WavePath.m, both from the directory named above
    in WAVELABPATH.
  10. At this point check that you have a working system. Launch Matlab. It should now start up with a banner indicating that WaveLab 800 is installed. Try running a script, such as SCDemo, to see if it will run. If it does not, recheck all the above steps

 

Accelerating WaveLab: MEX Files

Many of the basic routines in WaveLab can be accelerated by the use of Mex files. These are binaries of routines coded in C and run in some cases 10 times faster than their .m counterparts. They will be installed automatically by Matlab when you run Matlab if you have permissions to write the files in the correct places. Hence if you are system manager, you should run Matlab at least once after WaveLab has been installed in order to perform theinstallation procedure. To check if the process has worked, try the matlab command which FWT_PO. You should get the response <WAVELABPATH>/Orthogonal/FWT_PO.mexlx or something similar. If you get instead <WAVELABPATH>/Orthogonal/FWT_PO.m -- note the .m suffix rather than .mex??? -- start troubleshooting.

If you cannot get the MEX files to install automatically, you can download mex files for certain platforms from us. These can be installed manually, copying them into the appropriate locations. For example, the file FWT_PO.mexsg64 needs to be copied to <WAVELABPATH>/Orthogonal/FWT_PO.mexsg64. In general, each mex file needs to be in the directory of its homologous .m file.

If you are unable to get the .mex files to work at all, don't worry -- WaveLab will still work, but more slowly.

 

Trouble-Shooting UNIX Installation

Compare the output of ls -r WaveLab with Documentation/WLFiles to see if you have all the files. Compare the output of the Matlab command path with the list above to see if you have all the
directories in your path.

 

Success

When you have a successful installation, you should see something like the following when you invoke Matlab:

Commands to get started: intro, demo, help help
Commands for more information: help, whatsnew, info, subscribe

Welcome to WaveLab v 802
Setting Global Variables
Pathnames Successfully Set
global WAVELABPATH = "/v0/levio/matlab/WaveLab802/"
global PATHNAMESEPARATOR = "/"; global MATLABVERSION = 5.1
global PREFERIMAGEGRAPHICS = 1
WaveLab v 802 Setup Complete

Available Demos - Figures from the following papers:
AdaptDemo - ``Adapting to Unknown Smoothness via Wavelet Shrinkage''
AsympDemo - ``Wavelet Shrinkage: Asymptopia?''
BlockyDemo - ``Smooth Wavelet Decompositions with Blocky Coefficient Kernels''
CorrelDemo - ``Wavelet Threshold Estimators for Data with Correlated Noise''
IdealDemo - ``Ideal Spatial Adaptation via Wavelet Shrinkage''
MESDemo - ``Minimum Entropy Segmentation''
MIPTDemo - ``Nonlinear Wavelet Transforms based on Median-Interpolaton''
RiskDemo - ``Exact Risk Analysis of Wavelet Regression''
SCDemo - ``Nonlinear Wavelet Methods for Recovery of Signals, Densities
and Spectra from Indirect and Noisy Data''
SpinDemo - ``Translation-Invariant De-Noising''
TourDemo - ``Wavelet Shrinkage and W.V.D. -- A Ten-Minute Tour''
VdLDemo - ``WaveLab and Reproducible Research''

Available Workouts:
BBWorkout - Workouts for Best Basis
MPWorkout - Workouts for Matching Pursuit
MultiFrac - Workouts for Continuous Wavelet Transform
Toons - The Cartoon Guide to Wavelets

Available Book(s):
WaveTour - ``WaveLet Tour of Signal Processing''


Modified Oct. 1, 1999 DLD