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).

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

  2. 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.
  3. This creates a <top> application.
  4. Edit the configure/RELEASE file and set the paths to your installation of EPICS base.
  5. 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 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, the shareable library needs to be found. This can be done in two different ways.

  1. 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/". On Windows this might be "set TOMO_RECON_SHARE=C:\tomoRecon\tomoRecon.dll".
  2. 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 This can be done either by renaming the shareable library or by using soft-links to the actual shareable library file.