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 is 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 or later 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.
Download
You can download the package containing
snark05Input and
snark05Display
here.
Installation
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 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
snark05Display by typing the following at the command prompt:
For linux/unix users:
$ make
For cygwin users:
$ make -f Makefile.cygwin
After a successful compilation, the
snark05Display executable can be found in the current directory.
If you copy it (as super user) to the
/usr/local/bin directory,
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
snark05Input by typing the following at the command prompt:
For linux/unix users:
$ make
For cygwin users:
$ make -f Makefile.cygwin
After a successful compilation, the
snark05Input executable can be found in the current directory.
If you copy it (as super user) to the
/usr/local/bin directory,
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.
Contact
Deniz Sarioz 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.