-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.md.old
109 lines (76 loc) · 3.54 KB
/
README.md.old
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
![Toast++ logo](http://web4.cs.ucl.ac.uk/research/vis/toast/images/toast_logo_small.jpg)
![Toast++ header text](http://web4.cs.ucl.ac.uk/research/vis/toast/images/toastpp_label.png)
[![Build Status](https://travis-ci.org/toastpp/toastpp.svg?branch=master)](https://travis-ci.org/toastpp/toastpp)
[![Build status](https://ci.appveyor.com/api/projects/status/6mvhactrbdfot94o/branch/master?svg=true)](https://ci.appveyor.com/project/samuelpowell/toastpp/branch/master)
Toast++ - Image Reconstruction in Optical Tomography
====================================================
2008-2016 (c) Martin Schweiger and Simon Arridge, University College London
Toast++ is an open-source software suite for image reconstruction in optical
tomography. It is developed by Martin Schweiger and Simon Arridge at University
College London.
The TOAST suite is available for download online at http://toastplusplus.org.
Please check the TOAST web site regularly for updates.
Toast++ is distributed with a GPL v3 license. Please see file COPYING for
details.
Downloading Toast++
-------------------
Pre-compiled binaries for several computer platforms are hosted on GitHub:
https://github.com/toastpp/toastpp/releases
You will need to download two zip files:
- The "Common" package containing device-independent scripts and examples
- One of the platform-dependent packages for Windows, Linux or Mac-OS.
Installing precompiled Toast++ packages
---------------------------------------
If you are using the pre-compiled packages, just unzip both packages into *the
same* directory. You should end up with a single "toast" root directory.
Note that some unzip utilities, in particular on Windows, store the zip contents
under a directory named after the zip file, e.g. `toast_v2.0.0_common.zip` ->
`toast_v2.0.0_common/`
In that case, you will end up with two separate directories, and must merge the
two toast subdirectories from both manually.
Preparing the Toast++ environment
---------------------------------
(Required for both precompiled and compiled installations)
On Linux, type from the terminal prompt:
```
cd <toast root dir>
export TOASTDIR=$PWD
source toastenv.sh
```
This step can be skipped for Windows and OS X installations.
To set the Toast++ paths for the Matlab toolbox, type from the Matlab prompt:
```
cd <toast root dir>
mtoast2_install
```
Save the paths to make them permanent.
Getting started:
----------------
After setting up the TOAST toolbox, you can start by running the included
demos. In Matlab, type
```
doc
```
Follow the link to the Toast++ Toolbox documentation under "Supplemental
Software". This will bring up the main help page of the Toast++ toolbox.
Here you find links to the Toast demos (under "Live examples") and tutorial
scripts (under "Script tutorials"). It also contains a brief introduction to
DOT and links to the Toast++ homepage.
To view a list of the available commands in the Toolbox, type
```
doc toast2 (lists the core classes and functions)
doc utilities (lists auxiliary functions)
doc gui (lists a few sample applications with user interface)
```
For troubleshooting, please refer to the TOAST Frequently Asked Question
page and the message board, accessible from the TOAST home page. If you
cannot resolve a problem, you can contact the authors via the Contacts page.
Building from source
--------------------
The Toast++ sources are available from GitHub:
(https://github.com/toastpp/toastpp)
To clone the current development version:
```
git clone https://github.com/toastpp/toastpp.git
```
Follow the instructions under doc/install to build.