TherionTherion

therion.speleo.sk

what is behind it?

Therion

Therion – tool for drawing awards winning and art looking maps of caves???If you try to use Therion, , you may ask yourself:

therion.speleo.sk

Why is it so complicated?Why is it so slow?Why there is so strange user interface?Why is it more programing than art of drawing?Why is it not wysiwyg?

The answer for several your questions could be: Therion is non-commercial and multi-platform

The answer for remaining questions is: Cave data is complex and there are no simple, comprehensive solutions

It is because it was devised and coded long ago

Therion

Therion – tips for ambitious new users (from Bruce Mutton)

therion.speleo.sk

The obvious one, drawings are automatically morphed (round-tripped), to fit the survey centerline, regardless of any changes or loop closures that may subsequently occur

Uses textual input data files (reading will be with us for a while yet, have you ever tried to decipher your original input from a binary file 10 years after the software became defunct?)

With the exception of the drawing files, Therion never writes to the input files, so a bug in the software can never trash your data. Drawing files are textual, so if there is a problem, you can generally get in there with a text editor and figure out what is wrong, and then fix it.

Text files, and hence Therion, are version control software friendly. Go back to inspect any change ever made to the input data, or recreate the dataset as it was five years ago. Simultaneously edit and process your dataset while others in the survey team are doing the same on different sides of the mountain. Merge and share all your edits later on with removable media or via a central web repository.

Symbolic representation of entities. The output language and drawings can be chosen from a number of predetermined sets, or they can be customized quite readily.

Batch processing (make one or more changes, propagate them easily to selected outputs). Features are added or modified on request of, or in consultation with users. Open source (source code is available to inspect and modify, we are not constrained to a single

author) and the software originates in Europe (less likely to have those unit conversion bugs if you use SI units!)

Therion

Therion – the complex Solution for the Documentation of Caves - base Terms

Data structure – inspired by Survex (http://survex.com)- the main principle is to archive data exactly in the form they were

recorded in the time of a surveying trip, strictly in plain text files

therion.speleo.sk

Loop closure – Therion’s own method or the method of Survex

Automatic morphing (round-tripping)

Scrap

Map – independent from data structure, many different map- unattached basic drawing ‘building block’ for maps

- one or more scraps or maps- one or more surveys (centerline)Metapost- definition of symbols how they look, the drawing of the scrapsTeX- typesetting, the final layout of ‘printed’ or 2D outputs

Therion

Tree structure of data, what is it name space

Cave A Cave B

survey_A12

1, 2.1, a, b-3, xyz, …

call stations

1, 3c5, 2.1, 3.a_1, …

call stations

survey_AB

19@survey_A1.survey_A12.survey_A123, 19@survey_A3.survey_A123, 19@survey_B1, …

survey_A1 survey_B1

survey_A123

survey_A2 survey_A3

1@survey_A1, 1@survey_A2, …

3@survey_A1.survey_A12, 3@survey_A3, …

Name Sp ace

A namespace uniquely identifies a set of names so that there is no ambiguity when objects having different origins but the same names are mixed together.

karst area

therion.speleo.sk

s t a t i o n s s c r a p s

m a p s

Therion

Survey – declination, input, equate, join, map possibilities to define surveying data

Survey – base piece of Therions puzzle, inspiration by Survex.

• Survey – ‚first level‘ should archive one survey trip including log, comments, date (and declination), participants, their roles, measured data + comments, definition of maps based only on surveying data (not scraps), definition of maps based on scraps), etc.

•ThBook is a reference – (almost) all commands and parameters

– Also „input“ of related .th2 files (drawings) – It could include definitions of „join“s of particular scraps too.

• Survey – ‚higher level’ to connect several survey trips – „equate“ identifies matching stations – more joins – more complex maps, etc.

therion.speleo.sk

• Read Therion wiki, ask the Forum to learn Therion

Therion

Scrap — base element of Therion’s maps ‒ 1/3Scrap – another piece of Therion’s puzzle– scrap is small piece of map, which must not overlay itself,– if there are at least two stations it is calibrated automatically, if not it should be calibrated manually,– you draw each scrap independently, without caring what is above, below or adjoining, one scrap in time.

in red circles there are examples whereanother scrap had to be defined

therion.speleo.sk

Map colored by scraps

Therion

Scrap — base element of Therion’s maps —2/3 – scraps are typically saved in plain text files with extension .th2,– it is good idea to use more .th2 files, each one for one scrap + section(s) because to manipulate with huge .th2 files could be rather slow, – you may input as many as necessary .th2 files into one survey and join them together by command join scrap_1 scrap_2 …,– to tune scraps connections you may use two or more concurrently

running XTherions, as well on MacOSX too. Take care all files are saved before compilation in such case.

Therion

Scrap — base element of Therion’s maps —3/3

— wall clip off mostly every object of scrap,— wall is oriented line, it has outside (bedrock) side and inside

(empty space) side, it is determined by parameter outline, by default -outline out,

— closed wall should have -outline in parameter which determine, that space inside is a bedrock,

— -outline none means that wall will not clip off objects,— any line may have parameter -outline and it will behave as wall,— when Therion is following walls it will look from end point for

nearest beginning point of wall. It may produce a mess so use wall invisible to close empty space properly!

Wall – object with special features:

Therion

Map — base element of Therion’s output ‒ 1/2Map – yet another piece of Therion’s puzzle – Map is a list of scraps, surveys or maps to create ‘printed’ or 2D outputs

therion.speleo.sk

– Structure of maps is absolutely independent of structure of the centerlines, you may define the map of two adjoining caves, one scrap from each cave only to check a connection or use stations from different surveys in one scrap, for example,

map from_scraps1.map -projection plan

scrap_1.scrapscrap_2.scrapbreakscrap_3.scrap

endmap

map from_maps.map -projection plan

from_scraps1.mapbreakfrom_scraps2.map

endmap

map from_surv.map -projection plan

survey1survey2

endmap

break — forces drawing of top set of objects over lower objects

– You may define many different maps based on the same data set.

Therion

Map — base element of Therion’s output ‒ 2/2thconfig – where you select map for output

– Structure of surveys or maps is in side menu of compiler window after first successful compilation (file .xtherion.dat)

therion.speleo.sk

source CJ.th

select zd_bd.biely_dom_cely.CJ

export map -o only_centerline.pdf

source CJ.th

select zd_bd.map@zd_bd.biely_dom_cely.CJ

export map map_from_scraps.pdf

– Select it by doubleclick

54.4

54.3

54.2 54.1

54.0

57.1

57.359.0

57.4

57.259.1

59.2

59.3

59.4

59.5

538

53.3

53.254.0

52.8

52.9

55.1

55.2

52.0

52.152.2

52.3

52.4

52.5

52.657.4

58.1

58.2

58.3

57.5

57.6

57.7

57.8

57.9

Sikmina cela

Length: 181m

Depth: 26m

Surveyed by: Martin Hajduk, Martin Sluka 2014 – 2015

Drawn by: Martin Sluka 2016

1952.0

52.152.2

52.3

52.4

52.5

52.6

52.7

52.8

52.9

53.1 53.2

53.3

54.0

54.154.2

54.3

54.4

55.0

55.1

55.2

radavc.20141231.ms.a

10m

Length: 103m

Depth: 22m

Therion

Metapost & T XMetapost – powerful tool to generate vector graphics, fully programable.• draw symbols – from „point station coordinates“ it will generate real

symbol for station and place it to coordinates• draw scraps – points, lines, areas• definitions are in folder mpost in source code of Therion• you may modify, change, add definitions• you may change definitions sets, choose symbols from different sets• list of symbols – use „—print-symbols“ in compilation time

E therion.speleo.sk

Therion

METAPOST & T XTeX – extremely powerful tool for page layout, fully programable• styl used for typesetting of formulas (Word, Indesign, …), InDesign

paragraph typesetting optimalisation, … • you may modify layout of map, page of atlas, etc.• definitions are in folder tex in source code of Therion

E

layout my_layout scale 1 200 page-setup 29.7 21 27.7 19 1 1 cm size 26.7 18 cm overlap 0.5 cm code tex-atlas

\def dopage{\box\mapbox} \insertmaps

endlayout

\def\dopage{% \vbox{\centerline{\framed{\mapbox}} \bigskip \line{% \vbox to \ht\navbox{ \hbox{\size[20]\the\pagelabel

therion.speleo.sk

Therion

Therion – good idea to use it??? therion.speleo.sk

Anyway!!! if you are up to a challenge and motivated

you will generate living, plain text code, describing a cave

you may cooperate over internet, use version control code (GitHub, etc.)

eventually, you will save time of yourself and your colleagues

help make it better and save time for those who follow

Source code on Github – https://github.com/therion/therionWeb page of Therion and Wiki – https://therion.speleo.sk

Many thanks to Bruce Mutton for his help.