In order to use THELI GUI, your system needs to meet the following requirements:
Compilers
Libraries
Note
All of these packages should be available as pre-compiled binaries from the online repository of your Linux distribution. This makes for the fastest and easiest installation.
Other requirements
Under Debian/Ubuntu the following commands update your system with all necessary packages (Ubuntu is very slim, hence the long list). Pre-compiled packages for other Linux flavours will likely have very similar names:
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install gfortran csh g++ libqt3-mt-dev gawk gettext wget
sudo apt-get install tcl8.5-dev tk8.5-dev netpbm imagemagick libfftw3-dev
sudo apt-get install xorg-dev pgplot5 libtiff4 libtiff4-dev libpng3
sudo apt-get install binutils-dev build-essential libtie-ixhash-perl
sudo apt-get install libncurses5-dev perl xterm gzip pdl emacs
sudo apt-get install python python-dev python-numpy libxxf86vm-dev
sudo apt-get install python-scipy python-matplotlib libgsl0ldbl libgsl0-dev
If you are updating, simply go to the corresponding section below and follow the instructions. Old installations do not need to be deleted, but you can do so without harm. A new GUI version can be installed anytime.
Note
If you install the THELI pipeline core, then the GUI must be (re-)installed.
Installation takes place in an arbitrary directory, let’s assume this is:
/home/user/THELI/
Move the downloaded files into this directory.
Installing the pipeline core is really easy. Unpack and install it with
tar xvfz theli-<version>.tgz
cd theli-<version>/pipesetup
./install.sh -m "ALL"
Quite some of these programmes can also be used on the command line. To do that, you have to include
/home/user/THELI/theli-<version>/bin/Linux[_64]/
in your PATH environment variable.
Warning
The THELI GUI does not (yet) compile under MacOS! If you want to use the GUI on your Mac, create a virtual machine running Linux and install THELI therein. At the moment I cannot predict when (or if) a native MacOS version can be made.
Unpack and install the GUI with:
tar xvfz gui-<version>.tgz
cd gui-<version>
./install.sh
Note
The installer assumes that the libfftw3 and the libtiff4 libraries are available on your machine (most likely located in /usr/lib/).
Once the installation finished, you will have a theli executable
/home/user/THELI/gui-<version>/theli
and the following directory tree
/home/user/THELI/theli-<version>/
/home/user/THELI/theli-<version>/bin/Linux[_64]/
/home/user/THELI/gui-<version>/
including these three links
/home/user/THELI/gui -> /home/user/THELI/gui-<version>/
/home/user/THELI/theli -> /home/user/THELI/theli-<version>/
/home/user/THELI/theli/gui -> /home/user/THELI/gui-<version>/
The links are created during the installation of the GUI, and they point to the latest installed version. Like that you can install updates of the pipeline core and the GUI without interfering with older installations.
Lastly, you have to copy the scamp executable to
/home/user/THELI/theli-<version>/bin/Linux[_64]/
and include that directory in your PATH environment variable. Collected therein are all binaries used by THELI. Many of those are also very useful command line tools, some of which are mentioned explicitly in this documentation.
Warning
Do not start THELI by clicking on a Desktop icon linked with the executable. In this case a series of environment variables are not propagated correctly, and THELI will not function properly.
The correct way to start THELI is to call the theli executable directly from the command line. If you include
/home/user/THELI/gui
in your PATH variable, then the most recent version is always found, independent of your present working directory.