Windows Installation

 To follow these instructions you will need:
    (1) An Intel platform box running Win 95/98/2000 or NT.
    (2) A program such as WinZip which can un-zip a .zip file.  Download WinZip
    (3) Matlab 5.X or 6.X for Windows.
    (4) In certain special circumstances, you may need to have the MFC C compiler to compile Mex files.

Steps:

  1. Download (in binary mode) the file 
       BeamLab200PR2.zip
     to your PC by using the appropriate link from the BeamLab home page.
  2. Extract the .zip file into the folder
       /matlab/toolbox/ 
    Remark: If your Matlab root directory is named differently than 
       /matlab
    then use its correct name (for example /MATLABR12) instead of the /matlab convention we use every time the Matlab root directory is referred.

    After you unzip 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, set the current path to
       matlab/toolbox/BeamLab200
    Alternatively, copy the file BeamPath.m from
       matlab/toolbox/BeamLab200
    to
       matlab/toolbox/local
  4. Run 
        BeamPath 
    at the command prompt to start BeamLab 200.  Matlab should return a "Welcome to BeamLab" message as shown in the section Success below.
  5. Try running a script, such as 
        FSSDemo
    to see if it will run. If it does not, recheck all the above steps.

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

    If you already have a startup.m file in the directory matlab/toolbox/local, add to it the line 
        BeamPath;
     
    otherwise, rename BeamPath.m as startup.m.
  2. Upon successful installation, remove the zip file to save space.

Accelerating BeamLab: DLL Files

Many of the basic routines in BeamLab can be accelerated by the use of DLL 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 BeamLab has been installed in order to perform the installation procedure. To check if the process has worked, try the matlab command 
    which BestWedgeletPartition
You should get the response  
    <BEAMLABPATH>\MEXSource\BeamMEXSource\BestWedgeletPartition.dll
or something similar. If you get instead an .m suffix rather than .mex

    <BEAMLABPATH>\MEXSource\BeamMEXSource\BestWedgeletPartition.m
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 BestWedgeletPartition.dll needs to be copied to     
    <BEAMLABPATH>\MEXSource\BeamMEXSource\
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.


Trouble-Shooting Windows

It may be that your version of Matlab has different folders structure than what is assumed here and the folder 
    matlab/toolbox/local 
doesn't exist. In this case look for the folder of Matlab that contains the startup and path definition files and use it instead. In older versions of Matlab it used to be the folder 
    matlab/bin 


If you prefer to place BeamLab in a different folder of Matlab than the one we suggest, it's ok to do so. In this case you will need to edit the file BeamPath.m and chage the line 
    addpath(genpath([matlabroot, PATHNAMESEPARATOR, 'toolbox', PATHNAMESEPARATOR, dr(k).name])); 
Instead of 
    'toolbox'
you will have your chosen folder.

While in Matlab, check that the 
    path
 
command returns a list that looks like the one under item 2 above.

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


Success

When you have a successful installation and upon running "BeamPath", 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 = C:\MATLABR12\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
C:\MATLABR12\toolbox   
 


BeamLab

Modified: September 14, 2002