summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorWim van Aarle <wimvanaarle@gmail.com>2015-02-20 16:08:58 +0100
committerWim van Aarle <wimvanaarle@gmail.com>2015-02-20 16:08:58 +0100
commit4126f910ae9fd2d4fc756e7f07c03049fe26daad (patch)
treef19c26d730e96aa654be06c17563b28f82dc2d16
parente212ab0d4f84adafa0a2fe11f5e16f856504769a (diff)
downloadastra-4126f910ae9fd2d4fc756e7f07c03049fe26daad.tar.gz
astra-4126f910ae9fd2d4fc756e7f07c03049fe26daad.tar.bz2
astra-4126f910ae9fd2d4fc756e7f07c03049fe26daad.tar.xz
astra-4126f910ae9fd2d4fc756e7f07c03049fe26daad.zip
added markdown readme file
-rw-r--r--README.md82
1 files changed, 82 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ec86136
--- /dev/null
+++ b/README.md
@@ -0,0 +1,82 @@
+# The ASTRA Toolbox
+
+The ASTRA Toolbox is a MATLAB 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 to enable building new algorithms.
+
+
+
+## Documentation / samples
+
+See the matlab code samples in samples/ and on http://sf.net/projects/astra-toolbox .
+
+
+## Installation instructions
+
+### Windows, binary
+
+Add the mex and tools subdirectories to your matlab path.
+
+### Linux, from source
+
+Requirements: g++, boost, CUDA (driver+toolkit), matlab
+
+```
+cd build/linux
+./configure --with-cuda=/usr/local/cuda \
+ --with-matlab=/usr/local/MATLAB/R2012a \
+ --prefix=/usr/local/astra
+make
+make install
+```
+Add /usr/local/astra/lib to your LD_LIBRARY_PATH.
+Add /usr/local/astra/matlab and its subdirectories (tools, mex)
+ to your matlab path.
+
+
+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).
+
+
+### Windows, from source using Visual Studio 2008
+
+Requirements: Visual Studio 2008, boost, CUDA (driver+toolkit), matlab.
+Note that a .zip with all required (and precompiled) boost files is
+ available from our website.
+
+Set the environment variable MATLAB_ROOT to your matlab install location.
+Open astra_vc08.sln in Visual Studio.
+Select the appropriate solution configuration.
+ (typically Release_CUDA|win32 or Release_CUDA|x64)
+Build the solution.
+Install by copying AstraCuda32.dll or AstraCuda64.dll from bin/ and
+ all .mexw32 or .mexw64 files from bin/Release_CUDA or bin/Debug_CUDA
+ and the entire matlab/tools directory to a directory to be added to
+ your matlab path.
+
+
+## References
+
+If you use parallel beam GPU code for your research, 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.
+
+## License
+
+The ASTRA Toolbox is open source under the GPLv3 license.
+
+## Contact
+
+email: astra@uantwerpen.be
+website: http://sf.net/projects/astra-toolbox
+
+Copyright: 2010-2015, iMinds-Vision Lab, University of Antwerp
+ 2014-2015, CWI, Amsterdam
+ http://visielab.uantwerpen.be/ and http://www.cwi.nl/ \ No newline at end of file