Steps:
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
Note:
- 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.- Upon successful installation, remove the zip file to save space.
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.
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