snark05Input and snark05Display are utilities for the snark05 programming system for image reconstruction from projections.

snark05Input is a graphical input interface that makes it easier to specify commands for snark05.
snark05Display can be used in the visualization and analysis of output files created by snark05.

Both of these utilities are deployed only as source code, under the Q Public License v1.0.

Hardware requirement

We currently support only (IBM-compatible) 32-bit Intel processors. This does not necessarily imply that these utilites or the following installation instructions will not work on other systems, but development and testing have been performed only on 32-bit Intel processors.

OS requirement

Unix, in specific, Linux, in specific, Red Hat, in specific, Fedora Core 4 or later.
With some minor modifications to Makefiles, these utilities should compile and run on any Unix/X11 system. The following instructions, in addition to assuming that you have an X11-based window manager, further assume that you are running the commmands from the bash shell, which is the default for Red Hat. While you are free to try to install these utilities on any other platform, we have not tried it, and the instructions below might not be very useful for you.
NOTE: The instructions have been tested on cygwin recently but it requires you to install the cygwin in a specific manner before installing snark05. Details are given on the official snark05 website in the installation instructions.

A recommendation

We recommend that you download all software and go through the steps of the installation procedure, including in the requirements phase, as non-super user (unless otherwise indicated). You are also generally cautioned against running a window manager, and hence these utilities, as super user.

Software requirements

The snark05 utilities were developed and tested using the open-source Qt/X11 API, version 3.3, obtained under QPL 1.0. Hence, Qt/X11 API version 3.3 (Qt4.0 is not backward compatible with 3.3) must be installed on your system.

You certainly need a C++ compiler, linker, and an implementation of the C++ Standard Template Library installed. (We used gcc 4.0.0 20050519 (Red Hat 4.0.0-8).) Again, these should come by default with Red Hat Fedora Core 4.

In addition, before you can compile, you need an installed copy of the snark05 programming system, which is not open-source. It MUST be installed as per the installation instructions mentioned on the snark05 website.

Download

You can download the package containing snark05Input and snark05Display here.

Installation

NOTE: If you downloaded and installed these programs following earlier instructions, remove the old versions of the programs before continuing. They are probably located in /usr/local/include.

After downloading the package, you can install snark05 utilities with the following command sequence:

1. Before you install either software, and making sure that the Qt/X11 API is installed on your system, invoke the following command to make sure that the QTDIR environment variable is set correctly:
$ echo $QTDIR
If you get a line containing a path (like /usr/lib/qt-3.3) you can proceed to the next step. Otherwise set this variable to the location where Qt library can be found. Here is an example (in bash, the default shell for RedHat Linux) for setting the variable QTDIR:
$ export QTDIR=/usr/lib/qt-3.3
In general, this ought to be set correctly every time before snark05Display is used.

2. Change into the directory where you downloaded the snark05 utilities package.

3. Untar and unzip the package by typing the following at the command prompt:
$ tar xvzf snark05ID.tar.gz

4. Change into snark05Display directory
$ cd snark05Display

5. Before you run make for snark05Display& snark05Input, make sure that the value of SNARK05ROOT environment variable is set correctly and is pointing to the snark05 installation directory. To check use the following command:
$ echo $SNARK05ROOT
It should print the directory where snark05 is installed.

6. Compile and install snark05Display by typing the following at the command prompt:

For linux/unix users
$ make
$ su
# make install
# exit
If a local install of SNARK05 was done, the su and exit steps above are not necessary.

For cygwin users
$ make -f Makefile.cygwin
$ make -f Makefile.cygwin install

For all users

After a successful compilation and installation, the snark05Display executable can be found in the $SNARK05ROOT/bin directory. If this directory is in the $PATH, snark05Display can be invoked by any user from within any directory by simply typing at the command prompt:
$ snark05Display
(provided that QTDIR is set properly in the user's environment).

NOTE: In cygwin you must use startx to execute both snark05Input & snark05Display. Type the following in the cygwin window:
$ startx
A new window will pop up which should be used to execute snark05Input & snark05Display.


7. Change into snark05Input directory
$ cd ../snark05Input

8. Compile and install snark05Input by typing the following at the command prompt:

For linux/unix users
$ make
$ su
# make install
# exit
If a local install of SNARK05 was done, the su and exit steps above are not necessary.

For cygwin users
$ make -f Makefile.cygwin
$ make -f Makefile.cygwin install

For all users

After a successful compilation, the snark05Input executable can be found in the $SNARK05ROOT/bin directory. If this directory is in the $PATH, snark05Input can be invoked by any user from within any directory by simply typing at the command prompt:
$ snark05Input
(provided that QTDIR is set properly in the user's environment).

NOTE: In cygwin you must use startx to execute both snark05Input & snark05Display. Type the following in the cygwin window:
$ startx
A new window will pop up which should be used to execute snark05Input & snark05Display.

Uninstall

To remove snark05Input or snark05Display, check that $SNARK05ROOT points to where snark05 was installed, change into the directory where you downloaded the snark05 utilities package, and then run the uninstall command appropriate for your computer. To remove snark05Display these are:

For linux/unix users
$ cd snark05Display
$ su
# make uninstall
# exit
$ cd ..
$ rm -Rf snark05Display
For cygwin users
$ cd snark05Display
$ make -f Makefile.cygwin uninstall
$ cd ..
$ rm -Rf snark05Display
The instructions for removing snark05Input are identical, except that instead of "snark05Display" one needs to write "snark05Input" everywhere.

Contact

Ran Davidi currently maintains snark05Input and snark05Display on behalf of the DIG group. You may contact him with the understanding that no technical support is offered and there will be no manual for these utilities, or their installation.