Installing the MATLAB interface to STIR
This page provides instructions on how to install STIR for MATLAB. You will need STIR 3.1 or later for this to work (at present, use the [github version].
You will need to use the instructions at Installing STIR with CMake. Here we will give more specific information.
These are instructions on how to install the STIR+MATLAB interface have been tested on a unix system with ubuntu 14.04. It relies on CmakeGui (as usual) and an extension of SWIG that has to be installed first.
First, prepare your system with some packages
sudo apt-get install libtool automake autoconf autogen bison
Get a version of SWIG with preliminary MATLAB support
mkdir swig cd swig git clone https://github.com/KrisThielemans/swig.git swig_git
(you could try https://github.com/jaeandersson/swig.git instead which is already a bit more up-to-date) and checkout the right branch
cd swig_git git checkout matlab
SWIG can now be installed
./autogen.sh cd .. mkdir build cd build ../swig_git/configure make sudo make install
In the case were MATLAB is not installed globally, when use the following flag:
Note that the install might fail at the end if it can't find yodl2man, but we don't care. Check with that we now have the right version (should say 3.0.3 or later)
Follow the instructions on this page up to the point where you started cmake-gui.
- press configure
- press ok
- set CMAKE_BUILD_TYPE to Release
- enable BUILD_SWIG_MATLAB
- If you want want to use openMP for acceleration, enable STIR_OPENMP
- press configure
- check that CMake found the correct SWIG file (not the system one). If it did, replace the SWIG variable and "configure" again
- optionally adjust location of STIR-MATLAB files (MATLAB_DEST variable)
- close cmake-gui
Then either install STIR as usual
make sudo make install
or you could build only the STIR+MATLAB first (just to see if it fails or not)
Add path in MATLAB. E.g.
There are a few tests in STIR/src/swig/test/matlab. Just execute these adding the directory where you installed it to your matlab path (e.g. if you choose /usr/local as your CMAKE_INSTALL_PREFIX, in MATLAB do "addpath /usr/local/matlab")
Get started with the examples in STIR/examples/matlab