File: README.Debian

package info (click to toggle)
therion 0.5.1%2Bnmu1
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 5,748 kB
  • ctags: 3
  • sloc: makefile: 55
file content (112 lines) | stat: -rw-r--r-- 4,614 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
Therion for Debian
------------------

Overview 
--------
Therion is cave surveying software. It allows the drawing of cave surveys on
the computer. Data can be added to a drawn plan and it will be realigned to
fit any new closures or fixed points. All the work is done by the Therion
program. The front-end for entering data is Xtherion, which uses Tcl/Tk.

It is the sort of software where you need to read the manual in order to use it 
effectively. You are unlikely to get a PDF out of it without doing that.

Therion used Survex for centreline data processing prior to version 0.3.0,
but now does this processing itself. You can either keep all your data in
Therion format, or you can keep centreline data in Survex form and drawing
data in Therion form. If using the latter scheme, Therion will import .3d
files to get the survey structure and station positions.

Version 0.3 introduced 3D modelling but this was not enabled in the Debian 
version. v0.4 introduces a new modeller, and a corresponding viewer called
loch based on VTK. This is packaged separately as therion-viewer.

The scans used in Xtherion are limited to formats tcl/tk understands. By
default this is GIF and PNM (Portable Anymaps). To allow use of PNG, JPEG
and TIFF you need to install libtk-img. 

Docs
----

The documentation is (from v0.4.0 onwards) in the therion-doc package.

The Therion Book (file:///usr/share/doc/therion-doc/thbook.pdf) is the reference
documentation for the system. 

To get started you will find the Therion by Example and Therion for Plain
Cavers documents more useful as an explanation of how to draw things in 
Therion. A complete export of the wiki pages (FAQ, above docs, tips, code
examples etc) is included in the therion-doc package.  Start at
/usr/share/doc/therion-doc/wikidocs/index.html

All this documentation, is also online at http://therion.speleo.sk/wiki/doku.php 

There is a Mailing list for users at therion@speleo.sk. To subscribe just
send an empty e-mail to therion-subscribe@speleo.sk .

There is also an IRC channel #therion at irc.oftc.net


Config and example files
------------------------

/etc/therion.ini contains the defaults the program uses without a config
file so you won't need to change it unless you need a different charater
set. This is changed from the upstream to remove the need for
czech/slovak TeX fonts by default.

/etc/xtherion.ini allows you to specify various options such as 
character sets and font sizes.

/usr/share/doc/therion/examples contains some example dataset files. Some
of these use czech/slovak fonts. If you are using teTeX then they should
just work. If you are using TeXlive then you need to install
texlive-lang-czeckslovak (a suggests:) and edit /etc/therion.ini to
enable the fonts. See 'Language Support' below for details.


Language support
----------------

Therion has good support for alternate character sets. The thbook
explains how each file specifies a character set. The corresponding fonts
also need to be installed, and therion told about them. The texlive-lang-
packages (or tetex-extra if using tetex) contain the fonts, so install
appropriate ones. You tell therion about the fonts in /etc/therion.ini or
~/therion.ini with a line:
tex-fonts <encoding> <roman> <italic> <bold> <sansserif> <sansserifoblique>
e.g.
tex-fonts xl2 csr10 csti10 csbx10 csss10 csssi10


TeX and MetaPost
----------------

Therion includes MetaPost and TeX macros. Until version 0.2.13 these were
installed in TeX - now they are compiled into the therion executable and 
injected into the TeX/Metapost stream as needed. This is to avoid
problems with paths on non-Debian and non-unix systems.

If you get errors about 'TeX capacity exceeded' then you either have a
bug that is causing runaway recursion, or you really have run out of
memory. This error is more likely with therion 0.4 than 0.3 because it
automatically generates a scrap containing all the centreline data, which
can be several megabytes. Using a select in the thconfig to select the
map(s) you actually want can solve the problem.

Alternatively - if you actiually need to increase the TeX memory
then you need to change main_memory in /etc/texmf/texmf.cnf. For full
docs on this see the TeX-on-Debian doc in /usr/share/doc/tex-common/. The
short version is edit /etc/texmf.d/95NonPath.cnf, then as root run:
update-texmf
fmtutil-sys --all
to update the TeX system.


Conversion of old data
----------------------

The thconvert utility included in 0.3 verisons has now been discontinued, 
as the data format has stabilised.
 
-- Wookey <wookey@debian.org>, Thu, 4 January 2007