MATLABStarter is a series of startup functions for MATLAB that dynamically add MATLAB .m files, Java folders and .jar archives in user- or administrator-defined folders to the MATLAB path and optionally updates any subversion or git working copies found.
MATLABStarter can be used to set up a multi-user environment (e.g. a facility) or for personal use and relies on the presence of one or more environment variables.
To use automatic code update, make sure to have subversion version 1.6 or higher and/or git installed and in the path. Moreover, users should have read/write access to the working copies for the automatic update to work.
If you want to set up MATLABStarter for a shared environment, you should download and extract the four functions startup.m, envvars.m cgenpath.m and updateRepositories.m in the toolbox/local subfolder of the MATLAB installation directory.
This will be something like:
Windows: C:\Program Files\MATLAB\R2012a\toolbox\local Mac OS X: /Applications/MATLAB_R2012a.app/toolbox/local/ Linux: /opt/MATLAB/R2012a/toolbox/local
Considering that every new version of Mac OS X makes it one step harder to set environment variables that are visible from applications not started via the terminal, MATLABStarter v0.2 adds an alternative (optional) method to simplify this step.
Since MATLABStarter v0.2, the global environment variables (see below) can be set in the envvars.m file. The instructions below will help you set them in the classic way.
The only mandatory environment variable is MATLABHOME.
In a shared environment, MATLABHOME should be set at system level (i.e. set for all users) and point to a folder that contains the code to be visible to all users. It you are the only user of MATLAB in your machine, MATLABHOME can also be set for your account only.
The optional environment variable MATLABUSERFOLDER is meant for individual users to add their own folders to the MATLAB path. MATLABUSERFOLDER is added at the top of the path and MATLAB will change to MATLABUSERFOLDER at the end of startup, so that users can directly work in their user folder. Setting MATLABUSERFOLDER makes most sense in a shared environment: on a single-user environment, set MATLABHOME instead.
The optional environment variable IMARISPATH is used in combination with IceImarisConnector and should point to the $IMARIS_ROOT_DIR folder. Notice that this variable is only used on Windows and Mac OS X and ignored on Linux.
One last optional environment variable to be used in combination with ImarisConnector is XTENSIONS, that should point to the $IMARIS_ROOT_DIR/XT/matlab folder. Notice that this variable is only used on Windows and ignored on Mac OS X and Linux.
Edit the envvars.m file and set the following variable (uncomment the relevant entries):