Therion is a complete platform which processes survey data and
generates maps or 3D models of caves. This suite may be useful for
professional or amateur cavers and researchers in geology or
speleology fields.
The package includes the following components:
- therion: the basic executable program that works as a command-line
compiler and processes input files, which are - including 2D maps -
in text format, to create files with 2D maps or 3D model. 2D maps
can be generated in PDF or SVG formats or other formats handled by
GIS platforms (DXF, ESRI, KML) or Aven (Survex format). 3D models
can be generated in the native format (handled by the component
Loch) or other formats (Compass, 3DMF, VRML, Survex, ecc.) handled
by appropriate viewers.
- xtherion: the executable program that launches the GUI (Graphical
User Interface). Xtherion works as text editor, map editor, and
compiler (instead of therion). This component is not essential:
output files can be generated by therion preparing the input files
with external programs as text or maps editors.
- Loch: a 3D model viewer that supports high-resolution rendering to
file and stereo view using 3D-glasses. This component is not
essential: output 3D models can be displayed with other external
viewers.
- thbook.pdf: the Therion Book, it contains the documentation to use
Therion, generated with pdfTEX during the build process. It will be
installed in /usr/doc/therion-[VERSION]. This component is not
essential: a copy of the book (in basic size format) is also
available in the project homepage.
The build of the optional components is enabled by default. You can
exclude one or more of them by passing to the script the respective
environment variables:
- LOCH=no This disables the build of the native 3D viewer Loch. In
this case wxWidgets and VTK are not required.
- GUI=no This disables the build of Xtherion.
- BOOK=no This disables the build of thbook.pdf.
If you leave enabled the build of Loch, the compilation works also
if you have wxGTK3 (without the dependency wxWidgets) installed in
your system. Other libraries based on wxWidgets (like wxPython3 or
wxPython4 for example) could be detected and used but they are not
tested.
The build requires the library {fmt} as dependency and the source
uses by default an internal {fmt}. This library is available as
slackbuild in Slackbuilds.org (for Slackware 15.0) and a prebuild
package in the official release (for Slackware current). If the
library is installed in your system you would use it. In this case
you can set the build for use of the external library passing an
environment variable to the script as following:
FMT=yes ./therion.SlackBuild
WARNINGS
Note that the platform works only with some standards, interpreters or
programs (like METAPOST, TEX, tcl/tk, ImageMagick, ecc.) that are
available in a full installation of Slackware, and some extensions of
these (like LCDF Typetools, Bwidget, and tkImg) that are available in
Slackbuilds.org. Without these dependencies Therion fails during the
package build (almost) or in runtime for some features (e.g. tkImg,
that is not detected by the build process).
After the installation, a full and extended integrated behavior,
optimized with the custom configuration, requires to set or uncomment
appropriate values in the initialization files in /etc/therion.
Sample data can be downloaded from the project homepage. They can be
used to practice about Therion.
See the thbook.pdf for more information.
b09a23d034