tomoRecon

Mark Rivers

University of Chicago

This page is the home of tomoRecon, which is software for performing parallel beam tomography reconstruction using multiple threads. It uses the EPICS libCom library for operating system independent support for threads, mutexes, message queues, etc. It uses a C++ version of the Gridrec software for the actual reconstruction. The library is provided in both source code form, and as 64-bit shareable libraries for Windows, Linux, and Mac OSX. The shareable libraries can be called from C++, IDL, GDL, or other languages.

Please email any comments and bug reports to Mark Rivers who is responsible for coordinating development and releases.

Where to find it

You can download the software from the links in the table below. The software can also be accessed through the APS BCDA Subversion repository.

Module Version	Release Date	Source Code	Pre-built binaries	Documentation	Release Notes
1-2	11-March-2013	tomoReconR1-2.tgz	tomoRecon_Prebuilt_R1-2.tgz	tomoReconDoc	Release notes
1-1	7-March-2013	tomoReconR1-1.tgz	tomoRecon_Prebuilt_R1-1.tgz	tomoReconDoc	Release notes
1-0	17-August-2012	tomoReconR1-0.tgz	tomoRecon_Prebuilt_R1-0.tgz	tomoReconDoc	Release notes

Installation and Building

If using the source code distribution, it must be installed and built for use at your site. These steps only need to be performed once for the site (unless versions of the module running under different releases of EPICS and/or the other required modules are needed).

Create an installation directory for the module, usually this will end with

.../support/
Place the distribution file in this directory. Then issue the commands (Unix style)
```
gunzip measCompRX-Y.tgz
tar xvf tomoReconRX-Y.tar
```
where X-Y is the release.
This creates a <top> application.
```
.../support/tomoReconRX-Y
```
Edit the configure/RELEASE file and set the paths to your installation of EPICS base.
Run gnumake in the top level directory and check for any compilation errors.

IDL and GDL can be used as the "front-end" to tomoRecon, with IDL or GDL reading and writing the files and displaying images. The GSECARS IDL tomography software contains a file called tomo_recon.pro that calls the tomoRecon shareable library. The documentation for tomo_recon explains how to use these IDL routines. The tomo_recon routines are also included in this tomoRecon package.

To use tomoRecon from IDL or GDL with tomo_recon.pro, the shareable library needs to be found. This can be done in two different ways.

Define the environment variable TOMO_RECON_SHARE to point to the shareable library. For example on the Linux bash shell "export TOMO_RECON_SHARE=/usr/local/lib/libtomoRecon.so". On Windows this might be "set TOMO_RECON_SHARE=C:\tomoRecon\tomoRecon.dll".
If the environment variables does not exist, then it looks for the shareable library in the IDL "path", and the shareable library must be named: 'tomoRecon_' + !version.os + '_' + !version.arch + '.so' or '.dll' For example, tomoRecon_Win32_x86_64.dll or tomoRecon_linux_x86_64.so. This can be done either by renaming the shareable library or by using soft-links to the actual shareable library file.