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.