Macintosh Installation of BeamLab .200

To follow these instructions you will need:

    (1) A Macintosh running MacOS 7.5 or later
    (2) A program such as Stuffit Expander which can un-zip a .zip file.
    (3) Matlab 5.X or 6.X for Macintosh
    (4) In certain special circumstances, you may need to have the MPW C compiler to compile Mex files.

Steps:

  1. Binary Download the file 
        BeamLab0200PR2.zip
    to your Macintosh. You will need about 10MB of disk space.
  2. Extract  the archive to the Toolbox folder of your Matlab folder.
    After you extract the file,  you should have the following subdirectory structure:

    BeamLab200
    BeamLab200:Beamlets
    BeamLab200:Beamlets:Beamlet2D
    BeamLab200:Beamlets:Beamlet3D
    BeamLab200:CurvPublish
    BeamLab200:Datasets
    BeamLab200:Documentation
    BeamLab200:MexSource
    BeamLab200:Papers
    BeamLab200:Papers:BL3D
    BeamLab200:Papers:BMIA
    BeamLab200:Papers:DCRT
    BeamLab200:Papers:DRT
    BeamLab200:Papers:FSS
    BeamLab200:Papers:RP
    BeamLab200:Ridgelets
    BeamLab200:SlantStack
    BeamLab200:Utilities
    BeamLab200:Workouts

  3. In Matlab, either set the current path to
        matlabroot:toolbox:BeamLab200
    or copy the file BeamPath.m from
        matlabroot:toolbox:BeamLab200
    to
        matlabroot:toolbox:local
  4. Run BeamPath at the command prompt to start BeamLab 200. You will see a "Welcome to BeamLab" message as shown in the section Success below.
Note:
  1. If you want Matlab to automatically load BeamLab upon start-up, copy the file BeamPath.m from the folder BeamLab200 to the folder Matlab:Toolbox:Local. Using Find File from the Mac Finder, determine if you have any files named startup.m (besides the one contained in Matlab:Toolbox:BeamLab) in the hierarchy rooted at Matlab. If you don't, skip to step 3 below.
  2. If you do have more than one startup.m file, copy and append the contents of the BeamPath.m in Matlab:Toolbox:BeamLab200 to the startup.m. The setup is complete.
  3. Edit BeamPath.m if your Matlab directory has a different pathname reference than the one supplied at the top of this file. 
  4. Upon successful installation, remove the zip file to save space.

Accelerating BeamLab: MEX Files

Many of the basic routines in BeamLab 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 can be installed automatically by Matlab when you run Matlab if you have the MPW C compiler. To check if the process has worked, try the matlab command 
    which BestWedgeletPartition
You should get the response  
    Macintosh HD:Matlab:Toolbox:BeamLab:MEXSource:BeamMEXSource:BestWedgeletPartition.mex 
or something similar. If you get instead 
    Macintosh HD:Matlab:Toolbox:BeamLab:MEXSource:BeamMEXSource:BestWedgeletPartition.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 from us. These can be installed manually and copied into the appropriate locations. For example, the file 
    BestWedgeletPartition.mex 
goes to the same directory of the file
    BestWedgeletPartition.m
or something similar. 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 -- BeamLab will still work, but more slowly.

Success

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

Welcome to BeamLab v 200

Setting Global Variables:
global MATLABVERSION = 6
global BEAMLABVERSION = 200
global BEAMLABPATH = HD:MATLAB:toolbox:BeamLab200:
global PATHNAMESEPARATOR = ":"
global PREFERIMAGEGRAPHICS = 1

BeamLab 200 Setup Complete

Currently available browsers for figures from the following papers:
BMIABrowser - old demo for paper "Beamlets and Multiscale Image Analysis"
BMIADemo - new demo for paper "Beamlets and Multiscale Image Analysis"
BL3DDemo - demo for paper "3D Beamlets"
DCRTDemo - demo for paper "Digital Curvelet Transform"
DRTDemo - demo for paper "Digital Ridgelet Transform"
FSSDemo - demo for paper "Fast Slant Stack"
RPDemo - demo for "Ridgelet Packets"

Currently available workouts:
BeamletsDecoratedPartitionDemo - workout for "Beamlets"
guiparFSSFig1 to guiparFSSFig4 - workouts for "Fast Slant Stack"
BestPartitionDemo - workout for paper "Ridgelet Packets"

For more information, please visit: 
http://www-stat.stanford.edu/~beamlab

Please ignore the following message if WaveLab has been installed.

There are BeamLab functions which call WaveLab functions.
We recommend that the users download WaveLab from the website                    http://www-stat.stanford.edu/~wavelab
and install the package in the directory
HD:MATLAB:toolbox      

 
BeamLab

Modified September 14, 2002