forked from astra-toolbox/astra-toolbox
-
Notifications
You must be signed in to change notification settings - Fork 3
/
README.txt
204 lines (131 loc) · 6.62 KB
/
README.txt
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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
-----------------------------------------------------------------------
This file is part of the ASTRA Toolbox
Copyright: 2010-2024, imec Vision Lab, University of Antwerp
2014-2024, CWI, Amsterdam
https://visielab.uantwerpen.be/ and https://www.cwi.nl/
License: Open Source under GPLv3
Contact: [email protected]
Website: https://www.astra-toolbox.com/
-----------------------------------------------------------------------
The ASTRA Toolbox is a MATLAB and Python toolbox of high-performance GPU
primitives for 2D and 3D tomography.
We support 2D parallel and fan beam geometries, and 3D parallel and cone beam.
All of them have highly flexible source/detector positioning.
A large number of 2D and 3D algorithms are available, including FBP, SIRT,
SART, CGLS.
The basic forward and backward projection operations are GPU-accelerated, and
directly callable from MATLAB and Python to enable building new algorithms.
Documentation / samples:
-------------------------
See the MATLAB and Python code samples in the samples/ directory and on
https://www.astra-toolbox.com/ .
Installation instructions:
---------------------------
Linux/Windows, using conda for python
-------------------------------------
Requirements: `conda <https://conda.io/>`_ python environment, with 64 bit Python 3.9-3.12.
We provide packages for the ASTRA Toolbox in the astra-toolbox channel for the
conda package manager. We depend on CUDA packages available from the nvidia
channel. To install ASTRA into the current conda environement, run:
conda install -c astra-toolbox -c nvidia astra-toolbox
We also provide development packages between releases occasionally:
conda install -c astra-toolbox/label/dev -c nvidia astra-toolbox
Windows, binary:
-----------------
Add the mex and tools subdirectories to your MATLAB path, or install the Python
wheel using pip. We require the Microsoft Visual Studio 2017 redistributable
package. If this is not already installed on your system, it is included as
vc_redist.x64.exe in the ASTRA zip file.
Linux, from source:
--------------------
For Matlab:
Requirements: g++ (7 or higher), boost, CUDA (11.0 or higher),
Matlab (R2012a or higher)
cd build/linux
./autogen.sh # when building a git version
./configure --with-cuda=/usr/local/cuda \
--with-matlab=/usr/local/MATLAB/R2012a \
--prefix=$HOME/astra \
--with-install-type=module
make
make install
Add $HOME/astra/matlab and its subdirectories (tools, mex) to your matlab path.
If you want to build the Octave interface instead of the Matlab interface,
specify --enable-octave instead of --with-matlab=... . The Octave files
will be installed into $HOME/astra/octave . On some Linux distributions
building the Astra Octave interface will require the Octave development package
to be installed (e.g., liboctave-dev on Ubuntu).
NB: Each matlab version only supports a specific range of g++ versions.
Despite this, if you have a newer g++ and if you get errors related to missing
GLIBCXX_3.4.xx symbols, it is often possible to work around this requirement
by deleting the version of libstdc++ supplied by matlab in
MATLAB_PATH/bin/glnx86 or MATLAB_PATH/bin/glnxa64 (at your own risk),
or setting LD_PRELOAD=/usr/lib64/libstdc++.so.6 (or similar) when starting
matlab.
For Python:
Requirements: g++ (7 or higher), boost, CUDA (11.0 or higher), Python (3.x)
cd build/linux
./autogen.sh # when building a git version
./configure --with-cuda=/usr/local/cuda \
--with-python \
--with-install-type=module
make
make install
This will install Astra into your current Python environment.
As a C++ library:
Requirements: g++ (7 or higher), CUDA (11.0 or higher)
cd build/linux
./autogen.sh # when building a git version
./configure --with-cuda=/usr/local/cuda
make
make install-dev
This will install the Astra library and C++ headers.
macOS, from source:
--------------------
Use the Homebrew package manager to install boost, libtool, autoconf, automake.
cd build/linux
./autogen.sh
CPPFLAGS="-I/usr/local/include" NVCCFLAGS="-I/usr/local/include" ./configure \
--with-cuda=/usr/local/cuda \
--with-matlab=/Applications/MATLAB_R2016b.app \
--prefix=$HOME/astra \
--with-install-type=module
make
make install
Windows, from source using Visual Studio 2017:
-----------------------------------------------
Requirements: Visual Studio 2017 (full or community), boost (recent),
CUDA (11.0 or higher), Matlab (R2012a or higher)
and/or WinPython 3.x.
Using the Visual Studio IDE:
Set the environment variable MATLAB_ROOT to your matlab install location.
Copy boost headers to lib\include\boost, and boost libraries to lib\x64.
Open build\msvc\astra_vc14.sln in Visual Studio.
Select the appropriate solution configuration (typically Release_CUDA|x64).
Build the solution.
Install by copying AstraCuda64.dll and all .mexw64 files from
build\msvc\bin\x64\Release_CUDA and the entire matlab/tools directory to a directory
to be added to your matlab path.
Using .bat scripts in build\msvc:
Edit build_env.bat and set up the correct directories.
Run build_setup.bat to automatically copy the boost headers and libraries.
For matlab: Run build_matlab.bat. The .dll and .mexw64 files will be in bin\x64\Release_Cuda.
For python 3.12: Run build_python312.bat. Astra will be directly installed into site-packages.
Testing your installation:
---------------------------
To perform a (very) basic test of your ASTRA installation in Python, you can
run the following Python command.
import astra
astra.test()
To test your ASTRA installation in Matlab, the equivalent command is:
astra_test
References:
------------
If you use the ASTRA Toolbox for your research, we would appreciate it if you would refer to the following papers:
W. Van Aarle, W J. Palenstijn, J. Cant, E. Janssens, F. Bleichrodt, A. Dabravolski, J. De Beenhouwer, K. J. Batenburg, and J. Sijbers, "Fast and Flexible X-ray Tomography Using the ASTRA Toolbox", Optics Express, vol. 24, no. 22, pp. 25129-25147, 2016
W. Van Aarle, W J. Palenstijn, J. De Beenhouwer, T. Altantzis, S. Bals, K. J. Batenburg, and J. Sijbers, "The ASTRA Toolbox: a platform for advanced algorithm development in electron tomography", Ultramicroscopy, vol. 157, pp. 35–47, 2015
Additionally, if you use parallel beam GPU code, we would appreciate it if you would refer to the following paper:
W. J. Palenstijn, K J. Batenburg, and J. Sijbers, "Performance improvements
for iterative electron tomography reconstruction using graphics processing
units (GPUs)", Journal of Structural Biology, vol. 176, issue 2, pp. 250-253,
2011, https://dx.doi.org/10.1016/j.jsb.2011.07.017