Therion requires a number of external program (ie, programs that exists independently of therion): cavern, Tex, MetaPost and pdfTeX. xtherion requires Tcl/Tk. All these programs are freely available for Linux, Windows and Mac OS X.

You can download Therion from its homepage http://therion.speleo.sk/download.php .

If you need to report bugs or patches you may use http://savannah.nongnu.org/bugs/?group=therion .

Linux
Linux users (especially those with Debian) will have no problem, because these programs (except for cavern which is part of the "survex" suite) are usually included in their distribution, and likely already installed. If a program is missing it is enough to install it with the packet manager of the distribution, or, as last resort, get the program source tgz from its website, untar it, configure, make, and install it.

Normally Debian (and Ubuntu) users need only to type the command "apt-get install therion". Users of other distributions can get the sources and compile the program. The Debian package is maintained by Wookey and can be downloaded from http://wookware.org/debian/ . A Slackware package, maintained by J. Prouty, is available at http://zog.utc.edu/~gqv812/therion.html .

There is no configure script, so you might have problem with missing dependencies, or just different versions or place of installation. This may occur with loch: cd to the loch directory and edit the Makefile for the appropriate version of wx-widgets.

You might have problem at run-time due to missing TeX fonts, namely cyrillic (crmss10 etc.) and czechslovak (csss10 etc.). Either install them, or edit the therion configuration file (by default it is /etc/therion.ini or /usr/local/etc/therion.ini) to use your favourite TeX fonts.

Windows
Therion programs for Windows can be downloaded as precompiled binaries. You need to get the setup file "therion-full-0.5.0.exe" (the version number might change).

When you execute the setup file, you get the installation screen as in the figure below. You must choose the installation directory and the submenu of "Start | Programs" that will be associated to Therion (you may accept the defaults).

The Therion setup installs therion, xtherion and all the necessary software, cavern, MetaPost, Tex, pdfTeX, TclTk, and whatever else is required.

When the install is over, you have the submenu "Therion" of "Start | Program". Select its submenu "xtherion" to start xtherion.

The Windows installer works with administrator privileges only. If you want (or must) install as normal user (that does not have admin rights), you must do most of the work by yourself. This is what you basically have to do [S. Mudrak 2007.06.11; it is not very easy solution and I have probably forgotten something]:

• Create the Therion directory under Program Files and copy the programs and data files there;
• Create a .therion folder in the user home directory, C:\\Documents and Settings\\user_name;
• Copy therion.ini and xtherion.ini to this folder;
• Edit mpost/pdftex-path to mpost.exe/pdftex.exe exacutables in the bin/win32 folder. For example mpost-path should be "C:/Documents and Settings/user_name/My Documents/Therion/bin/win32/pdfetex.exe" 9notice that the path-separator is the normal slash and not the backslash);
• Add set xth(gui,compcmd) "C:\\Documents and Setting\\user_name\\My Documents\\Therion\\therion.exe" to the \it{xtherion.ini file (here use the double backslash);
• Now xtherion should work by changing directory to C:\Documents and Settings\user_name\My Documents\Therion\bin and running wish84.exe ../xtherion.tcl. You can create a shortcut that does this all.

Mac (by M. Sluka)
There are no precompiled binaries for Mac. You have to

1. Install the Developer Tools, XCode from Mac OS X installation
2. Install Survex: download the source tgz from the website, untar it, then configure, make, and install it. (Use always sudo instead of su).
3. Install the TeX package: use the ii installer from http://ii2.sourceforge.net/tex-index.html
4. Install AquaTcl/Tk from http://tcltkaqua.sourceforge.net/ There is a Tcl/Tk as part of Mac OS X installation, but the BI installer will install the latest version.
5. For the latest features you will need ImageMagic as well. You may download the binaries from http://www.imagemagick.org/download/binaries/ImageMagick-universal-apple-darwin8.7.0.tar.gz
6. Download the Therion package. Follow the instructions in the appendix of The Therion Book. To install use sudo make install.
7. You may install the PDF viewer xpdf. It is better that Acrobat reader because it does not lock the open file, so therion may overwrite it. With acroread you allways have to close the PDF map before compiling. You can find xpdf for Mac OS X at ... You will need the DarwinPorts installer too: http://darwinports.com . If port does not work execute the command export PATH=$PATH:/opt/local/bin from the terminal. Then install xpdf: sudo port install xpdf.

Under Mas OS X there are several problems. You must use the "control key" instead of the normal "command key", the mouse right button does not work. etc.

cavern is part of survex, a suite of programs for the processing of survey data. Survex is distributed under GPL and can be downloaded from http://www.survex.org . It is available in source code, for those who want to compiile it, or as precompiled binary for Linux (deb and rpm), and Windows and Mac OS X.

xtherion is written in Tcl/Tk. Therefore you need the Tcl/Tk interpreter to execute it. If you do not have the BWidget module, you should add it: download the file BWidget-1.7.0.tar.gz.

NOTE: I do not remember any more if one needs also tclunit.tcl.

If you plan to use scanned images in PNG or JPEG format, you need the extension module tkImg: tkimg1.3.tar.bz2.

ImageMagik is a suite of image manipulation programs. therion uses identify and convert.

Therion is using: plain metapost, plain pdfetex (because of memory requirements), and by default, it has CM and CS (latin2) font mappings [sm 2006.12.23].

TeX is usually included in Linux distributions, and contains MetaPost within it. If this is not the case you can download TeX and MetaPost from CTAN (Comprehensive TeX Archive Network) or from TUG (TeX users group).

I would like to say something about the possible problems that one might face, and how to solve them. Unfortunately (of by good luck) i did not have any trouble. If anyone has some experience about this ...

pdfTeX is a version of TeX that produces an output in PDF, besides the DVI.

loch is the current 3D viewer used in therion. The old thtom has been dropped since version 0.5.

To compile and install the loch 3D viewer you need VTK, a visualization toolkit, available at http://www.vtk.org . If you need to install it as well, you must have cmake (http://www.cmake.org/ ). The VTK libraries used by loch are vtkHybrid, vtkImaging, vtkIO, vtkGraphics, vtkRendering, vtkGenericFiltering, vtkFiltering, vtkCommon [Ph. Schuchardt]. For the complete list of the libraries needed by loch see the file loch/README.

Therion can be downloaded from http://therion.speleo.sk/download.php .

The compressed archive (therion-0.3.10.tar.gz) contains

• the source files of the program therion;
• the xtherion editor for the therion data files. Itis based on Tcl/Tk;
• documentation: the subdirectory thbook and the man pages for therion and xtherion in the subdirectory man;
• examples and tests, in the subdirectories examples and tests;
• data files (definitions), in the subdirectory lib;
• MetaPost files, in the subdirectory mpost;
• a 3D viewer based on VTK (loch);
• the subdirectory tex with the file therion.tex, containing the TeX commands of therion;
• glyfs and encodings in texenc;
• the subdirectory thchencdata with characters encoding data;
• the subdirectory thlang for the localization (local languages);
• the subdirectory extern containing utility functions used by therion;
• the subdirectory geomag contains a script for the magnetic declination correction, based on IGRF (International Geomagnetic Reference Field) coefficients;
• the subdirectory thcdt with the functions for the constrained Delaunay triangulation, used in the construction of 3D models. The code is adapted from {http://cs.nyu.edu/exact/core/cdt/}.

After uncompressing the archive, you must compile with the command "make". By default "make" generates the program therion and xtherion and the documentation (the Therion book). If all goes well, you can install therion with the command "make install". If you do not install Therion, you can nevertheless use therion and xtherion from the directory where you uncompressed the archive.

The Makefile is set for Linux; Windows and Mac OS X are commented. If you are still using one of them, you must configure the compilation by typing "make config-win32" or "make config-macosx", respectively. This assumes that you have a development environment with "make"; MinGW or gcc . Surely, the easiest thing to do is to get the precompiled binaries.