Therion wiki - tfc

1

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:24+00:00

Therion for cavers:1- Intro Therion is the next step in cave surveying software. It works under Windows (9X-2000-XP), *nix and MacOS X. It's GPL-licensed. Usually, cave surveying software works with survey data only (from, to, lenght, compass, clino, etc ). From these data, a centerline is calculated, then this centerline is exported to drawing software like Illustrator, where walls and details are added.

2

Anonymous (anonymous@undisclosed.example.com) — 2010-05-28T19:45:21+00:00

2 Therion for cavers: - How it works * 2.1- GENERALLY SPEAKING * 2.2- LRUD DATA * 2.3- THERION AND XTHERION * 2.4- HOW TO INSTALL

3

Anonymous (anonymous@undisclosed.example.com) — 2006-12-03T20:12:53+00:00

3 - OLD LADIES' PROMENADE First of all, we suggest to do a example survey with a very simple cave. None of Therion's most advanced features will be explained in this chapter, but it will be enough to explain how to insert survey data, how to draw, and how to compile your maps.

21

Anonymous (anonymous@undisclosed.example.com) — 2006-11-12T15:03:02+00:00

2.1 Therion for cavers: Generally speaking For most surveys, you'll need to create 3 text files: 1) .th file with your survey data, 2) .th2 file with your drawing data, 3) thconfig file where you can a) list things which should be part of final work, b) set layout options as symbol set, wether to use legend, etc, and c) specify your output: map and/or atlas and/or 3D model and/or centerline data in SQL format. It's quite convenient to save all three files in the same directory, and to give this…

22

Anonymous (anonymous@undisclosed.example.com) — 2010-05-28T19:45:22+00:00

2.2- LRUD DATA Therion's original idea was that it's no necesary to take LRUD, since you usually draw to-scale sketches in your survey book while surveying. These sketches do have LRUD data implicit, so it was (is) expected that you scan them, then load them into map editor as

23

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:23+00:00

2.3- THERION AND XTHERION Therion is a command line program. It remains hidden, since we use Xtherion as graphic user interface. Xtherion's duty is basically to convert points and lines we draw into commands that can be processed by Therion when we press F9 key (anywhere) or

24

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:23+00:00

2.4- HOW TO INSTALL Download it from On Windows, a double click on installer icon will start installation. Answer “Yes” and “Next” to each and every thing it asks for. Done. You can now start Xtherion by double-clicking their icon. As previously mentioned, you'll work primarily on Xtherion, wich is Therion's graphic user interface.

31

Anonymous (anonymous@undisclosed.example.com) — 2006-12-03T20:13:14+00:00

3.1 - THE PLAN * 3.1.1 - FIRST CONTACT * 3.1.2 - CENTERLINE DATA AND .th FILES * 3.1.3 - THCONFIG * 3.1.4 - DRAW DATA AND .th2 FILES

32

Anonymous (anonymous@undisclosed.example.com) — 2006-12-03T20:15:18+00:00

3.2- EXTENDED ELEVATION To do a extended elevation, you work much the same way as you worked to do the plan. This is, you need to export a xvi image with extended centerline, then you'll draw points, lines and areas over it. So you need a) extend your centerline, b) edit thconfig file to export a xvi image with extended centerline and c) draw it the same you drawed the plan

33

Anonymous (anonymous@undisclosed.example.com) — 2006-12-03T20:15:38+00:00

3.3- CROSS-SECTIONS Altough a cross-section with two or more stations on it is theorically possible, in practice this does not happen. Usually, if it's taken at same place as a station, there could be only one station. Often, there will not be any station in cross-sections. Therion needs at least two stations to scale scrap automatically.

311

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:22+00:00

3.1.1- FIRST CONTACT So you started your Xtherion and got a (black, horizontally-splited) compiler window. What now? Well, you could place cursor over different control panels and buttons and see what they are for. From 0.3.7, when you place the cursor over a button or whatsoever, a help balloon will pop-up with a text string to explain what it is for. The same happens on status bar, at Xtherion's window bottom. Further, status bar will show also information about objects in map editor canvas.…

312

Anonymous (anonymous@undisclosed.example.com) — 2006-12-03T20:13:39+00:00

3.1.2- CENTERLINE DATA AND .th FILES Now that you have see what Therion is able to do, it's time to do your first steps. So please close example's thconfig file, then go to “Window” menu and choose “Text editor”. In text editor window, go to File

313

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:20+00:00

3.1.3- THCONFIG Go to “Window” menu and choose “Compiler”. Then go to File -> Open and choose “thconfig”. Again, this is a template file with comments. The bare bones thconfig could be: source template.th layout xvi-export scale 1 1000 grid-size 1 1 1 m endlayout export map -fmt xvi -layout xvi-export -o irurixo.xvi

314

Anonymous (anonymous@undisclosed.example.com) — 2006-12-03T20:13:59+00:00

3.1.4- DRAW DATA AND .th2 FILES * 3.1.4.1- BACKGROUND IMAGES * 3.1.4.2- SCRAPS * 3.1.4.3- POINTS * 3.1.4.4- LINES * 3.1.4.5- AREAS

321

Anonymous (anonymous@undisclosed.example.com) — 2011-07-06T18:49:52+00:00

3.2.1- HOW TO EXTEND CENTERLINE From 0.3.7, Therion by default will extend all points to the right. To change this, you can edit your centerline data to add some “extend”. You can add “-extend left” to centerline line (in your .th file). All points will extend to left now.

322

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:17+00:00

3.2.2- EXPORTING EXTENDED CENTERLINE AS XVI IMAGE You need to add a line like this to your thconfig file: export -proj extended -fmt xvi -o nombre_extended.xvi In the sample thconfig, simply uncomment the line. Now you can press or “Compile

323

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:18+00:00

3.2.3- DRAWING EXTENDED ELEVATION Of course, .th2 can hold many scraps. Scrap projection does not matter. Simply open your .th2 file and insert the new background image. You can place the image by dragging (double right click + drag) or, more precisely, giving coordinates in pixels for upper left corner of inserted image and pressing

331

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:18+00:00

3.3.1- DRAWING CROSS-SECTIONS Open your .th2 file and insert a new scrap with projection “none”. Next, press Ctrl-L and draw your cross-section. You can draw it anywhere on canvas, but obviously it's better to draw it where a grid is present, so it will be easier a) to-scale drawing, b) to set scale.

332

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:18+00:00

3.3.2- SCALING MANUALLY When you open a new .th2 file. there are 2 red squares at bottom corners of canvas. These points are used to set scale manually. After drawing plan and extended scraps, they could not be visible. If selected object on canvas is not a manually scaled scrap, they will NOT be visible at all. You need to go to

333

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:16+00:00

3.3.3- PLACING CROSS_SECTIONS Cross-sections are used in combination with plan or extended elevation, so you need to have section points *in plan and/or extended elevation scraps*. It's easy to insert section points in cross-section scrap itself. In this case, cross-section will not be displayed in final pdf output.

334

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:17+00:00

3.3.4- DRAWING SECTION LINES Section lines are used to a) point where a cross-section is taken, b) point in what direction it has been taken (towards entrace/towards-bottom), so we can identify left and rigth sides appropiately. They can form an L-shape which traverses passage. Long line joints cross-section with the place it was taken, and traverses passage but it's invisible while on passage. Thus short line is in the opposed side, and shows an arrow pointing direction used when cross-section…

3121

Anonymous (anonymous@undisclosed.example.com) — 2010-05-28T19:45:20+00:00

3.1.2.1- DATA STYLE AND ORDER A bare bones .th file could be: survey FOO -title "FOO Cave" centerline data normal from to length compass clino (survey data here) endcenterline endsurvey Anything between a survey/endsurvey pair of lines is part of the same survey. A survey can have a lot of things in it, first of all, other surveys. So each survey must have a name. This allow for a hierarchical structure (more on this later). For now, the interesting thing into a survey is the centerl…

3122

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:22+00:00

3.1.2.2- UNITS By default, lenght units are meters and angle units are (360) degrees. If you use (400) grades instruments and say, yards as lenght units, your .th file should have lines for it. Here is an example: survey FOO -title “FOO Cave”

3123

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:22+00:00

3.1.2.3- DATE, DECLINATION AND OTHERS You can add other specification lines to your centerline data. In fact, you should specify (at least) date, declination, team members and data style-order. Add units lines if not using degress and meters default. Precission surveyers should have sd (standard deviation) and calibrate lines to fine-tune their instruments, etc. Again, for a complete list and description of available lines, you should read thbook.pdf.

3124

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:23+00:00

3.1.2.4- SURVEY DATA Simply write it as tab-separated text. Once you have a data style-and-order line, you could press the “Scan data format” button on “Table data” control panel. Textboxes order will change accordingly to your data order line. If your data line has more keywords than textboxes in

3125

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:20+00:00

3.1.2.5- FIXED POINTS To give real world coordinates to centerline, you need to have at least a fixed station point. This is, a station point with real coordinates. You should add to survey data a line like this: fix 0 575628 4476124 1250

3141

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:21+00:00

3.1.4.1- BACKGROUND IMAGES Go to Window -> Map editor. Then go to File -> New. Black canvas should be yellow now. It's time to give a name to and save new .th2 file, so relative paths to other things (as background images) can be stablished. The “

3142

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:21+00:00

3.1.4.2- SCRAPS Drawings are divided into “scraps”. Anything between a scrap/endscrap pair of lines is part of the same scrap. Into the scraps, we will find points, lines and areas. You'll see scraps and their contents in “File commands” control panel.

3143

Anonymous (anonymous@undisclosed.example.com) — 2010-05-28T19:45:19+00:00

3.1.4.3- POINTS Go to “File commands” control panel again. Click on rectangle next to “Action” to show action options menu. Choose “Insert point”. The “Insert scrap” button will change into “Insert point”. Press it to begin inserting points. All this steps could be done by pressing

3144

Anonymous (anonymous@undisclosed.example.com) — 2010-05-28T19:45:21+00:00

3.1.4.4- LINES Usually, wall lines are the first thing we draw on map editor window. However, we have explained points first. Since this is an introductory work, it's probably better to explain things from the simplest object. Simplest object is, of course, a point. Lines are made from points, so there is some logic explaining them after stand-alone points. You can either draw lines or points first, it doesn't matter.

3145

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:17+00:00

3.1.4.5- AREAS Usually we use areas to point some fill on the passages, be it water, sump, clay, sand... Areas are limited by lines. These lines can be of any type, but they must intersect. To be sure that lines really intersect, it's better to draw lines beyond passage walls. This out-limits parts will be clipped. The same effect can be achieved inside passages by using line type border with

31345

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:21+00:00

3.1.4.3.5- OTHER POINT TYPES As you can see in point type menu, there are more point types than mentioned here. Most of them are symbols for speleothems, passage fills, passage ends, equipement... We will don't mention them here, because it's only an introductory work. Many of them don't need any option tobe used (i.e, speleothem points). We suggest you to try these points. If, after compilation, they don't show as expected, go to thbook.pdf and read about this point type options. You'll find…

31431

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:21+00:00

3.1.4.3.1- STATION POINTS First of all, we will draw and reference stations. The .xvi image shows centerline with stations. Click on one of them. Point control panel will open. Therion will set type “station”. In “options” box, you'll see “

31432

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:18+00:00

3.1.4.3.2- GRADIENT ARROWS So you have already referenced all your stations in the scrap. What now? Well, you could place your gradient arrows. Enter point insertion mode, click to insert new point, then go to Point control panel and choose “gradient

31433

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:19+00:00

3.1.4.3.3- LABELS Now you can insert some labels, like “P100” or “Entrance”. Insert a point where label should be placed, then go to Point control panel and choose “label” from “type” menu. Next, write this on options textbox: -text

31434

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:19+00:00

3.1.4.3.4- SECTION This is used to anchor cross-sections. Each cross-sections drawing must be in their own scrap with projection “none”. More on this later. Insert a point where a cross-section has been taken, chosse type “section” from menu, then write on options textbox:

31441

Anonymous (anonymous@undisclosed.example.com) — 2007-10-10T02:31:27+00:00

3.1.4.4.1- HOW TO DRAW STRAIGHT LINES As previously mentioned, lines are made from points. Now that we are on “line point insertion” mode, click on the canvas, then click again in another place. You should now have a straight line between 2 points. You can extend your line by clicking where needed. You will see the line is made up from straight segments between line points.

31442

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:19+00:00

3.1.4.4.2- HOW TO DRAW CURVES As you have seen, to draw straigth lines it's enough to click where you want a point to be. To draw a curve, you need to drag instead. This is: choose a convenient place for your point, do click and hold the mouse's button down. Now move the mouse, always holding button down. You'll get a curve. The more you move the mouse, the more pronounced the curve is. Play a little bit. When your curve looks OK, release mouse button. Done.

31443

Anonymous (anonymous@undisclosed.example.com) — 2006-12-03T20:14:59+00:00

3.1.4.4.3- LINE TYPES Line types are choosed on “Line control” panel. Clic on triangle next to “type” to see menu. Choose what you need. Draw your lines. Remember, by default Xtherion will create lines with last type you used. So the fastest way is to draw all lines of same type (i.e., walls) then change type (i.e., contours) to draw all your contours, and so on.

314431

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:20+00:00

3.1.4.4.3.1- WALLS This is the default type suggested by Xtherion, so you probably have already at least a “wall”. Walls are the limits of the scrap. Most simbols are clipped if they are out of scrap's limits. This is handy, because you don't need to adjust other lines exactly. I.E., after your walls are drawed, you can extend your countours out of the walls. Those out-limit parts will not be printed. So you don't need to care about adjusting contour ends to wall exactly. In fact, since areas …

314432

Anonymous (anonymous@undisclosed.example.com) — 2006-09-22T10:44:20+00:00

3.1.4.4.3.2- OTHER LINE TYPES Most line types are self explanative and don't need any option. As you can guess, countour is used to draw contour lines, pit is used to draw pits, and so on. Rock-border and rock-edge are used to draw block borders and block inner lines respectively.