Toastpp Files

Toast++ software suite for forward and inverse Modelling in Optical Tomography
Copyright 2014-2016 Martin Schweiger and Simon Arridge

    The Toast++ homepage is located at www.toastplusplus.org and contains
    useful information and examples.

    The Toast++ SVN repository and precompiled distribution packages can be
    found at https://sourceforge.net/projects/toastpp/

    Toast++ is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    Toast++ is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with Foobar.  If not, see <http://www.gnu.org/licenses/>.


Version 2.0.0
-------------
    - Cleanup of Matlab interface. Some missing functions have been added to
      the new version of the Matlab interface, including support for the
      surface projection methods required by some of the fluorescence
      tomography examples.

    - Support for the old Matlab interface. If you require the old interface,
      e.g. for legacy scripts, please use version 1.0.4. Both versions can be
      installed side-by-side if required.

    - Updated the Toast-Matlab help files for the new interface.

    - Binary distributions are now by default compiled with multithreading
      support and with static Mesa-3D library support for hardware-accelerated
      projector routines.

    - Support for 32-bit versions has been dropped.


Installation of binary distribution
-----------------------------------

    You need to download two files for the installation:

    - The Common package (toast_v2.0.0_common.zip) This file contains all the
      platform-independent files (scripts, data files, examples, help files)

    - The appropriate binary package for your operating system (e.g.
      toast_v2.0.0_linux64.zip). This file contains the binary files
      (executables, libraries, mex files) for your platform. Currently
      supported are Windows64, Linux64 and MacOS64.

    Unpack both files into the same directory. You should end up with a single
    "toast" subdirectory. Note that some unzip utilities, especially on
    Windows, may create an additional top-level subdirectory with the package
    name, e.g. toast_v2.0.0_common/toast and toast_v2.0.0_win64/toast. If this
    happens, you need to merge the two toast subdirectories by hand.

    On Linux, run

        source toastenv.sh

    found in the toast root directory, to set the Toast environment variables.
    (toastenv.csh is the equivalent shell script for c-shell). On Windows,
    this step can be skipped.

    Launch Matlab, and run mtoast2_install (found in the toast root directory)
    from the Matlab prompt. This will set the Matlab paths to the Toast
    Matlab directories. Save the paths for later use.

    The Toast toolbox is now ready to use.


Installation from sources
-------------------------

    Check out a copy of the current Toast++ development code using the
    command

    svn checkout http://svn.code.sf.net/p/toastpp/code/ toastpp-code

    If you are using a GUI-based SVN client, such as TortoiseSVN, just
    point your repository URL to http://svn.code.sf.net/p/toastpp/code/
    and check out the HEAD version.

    For compilation and installation instructions, see file INSTALL in your
    checked-out Toast++ source folder.