templates

Template files:

The file penny_falls.svx contains essentially the same data as penny_falls.th, in a slightly different format.

The key SURVEX template:

; Survey of Penny falls
; A continuation of Ave Maria hall

*date 2018.07.22 ; Expedition Klic Globin
*title "Penny Falls"
*team "James Wilson" compass clino tape notes
*team "James Hooper" compass clino tape notes

;Data entered by David Kirkpatrick on 25/07/2018

*begin penny_falls
	
	*data normal from to tape compass clino ignoreall

	;Data
	1	2	4.12	93	56
	...


	;notes
	;STN1 is PSS
	...

*end penny_falls

*equate penny_falls.penny_falls.15 ave_maria.ave_maria.1 

The key THERION template:

#Survey of Penny Falls, expedition Klic Globin
#A continuation of Ave Maria hall
#Data entered by David Kirkpatrick on 25/07/2018

survey penny_falls
	
	input "penny_falls-p.th2" # this is our therion 2D file containing lines, points and areas

	map m1-p -projection plan 
		penny_falls-p1 #including our first scrap in penny_falls-p.th2
	endmap

	map m2-p -projection plan
		penny_falls-p2 #including our second scrap in penny_falls-p.th2
	endmap

	join penny_falls-p1 penny_falls-p2

	centreline
		date 2018.07.22
		explo-team "James Wilson"
		explo-team "James Hooper"
		team "James Wilson" insts notes tape
		team "James Hooper" insts notes tape

		units length meters
    	units compass clino degrees
    	data normal from to length compass clino
    	1	2	4.12	93	56
		...


		#notes
		#STN1 is PSS
		...


	endcentreline

endsurvey

The Key therion compiler file.

Below, a sample file containing a new local layout, which incidentally could be hosted in a file called layout.th and then included via input path/to/layout.th

source "cave_system.th"

	layout local
  		scale 1 500
  		colour map-fg altitude 			# colour by altitude with RGB call like [92 86 65]
  		map-header 25 75 e 				# dictates where the map header should appear
  		#symbol-hide line survey    		# hide or show survey lines 
  		#symbol-hide point station 		# hide or show survey stationq
  		legend on
  		symbol-assign line slope BCRA  
	endlayout

export map -projection plan -o cave_system.pdf -layout local # this produces the pdf output

export model -fmt survex -o cave_system.3d #this produces the Aven .3d file for visualising data.

export model -o cave_system.lox #the native Loch view 3D file is produced here.

Template Therion 2D files (.th2)

This is where you essentially draw the cave survey. Please see the great tutorial on (link to superb tutorial) using therion to draw to have a play with real data and get to know the xtherion graphics user interface.

The building block of the Therion survey are the scraps: simple bits of cave, which can self-intersect or overlap. The more scraps the better.

A sample scrap code

Have a look at the .th2 files.

Each scrap begins and ends with the same syntax:

scrap
	line
	endline
	
endscrap

• Does the passage incline steeply? Break it into several scraps.
• Are there multiple pitches? Break it into several scraps
• Are there multiple branches? Break them into scraps.
• Should I break a scrap at a junction? No. Put the juncture between scraps at a relatively simple bit of cave passage. This makes life a lot easier!

On average, I have 3-4 scraps per survey trip in Sistem Migovec, and that's often not enough...

Another note: I like the depth colouring which can be achieved with the line

layout 
	colour map-fg altitude
endlayout.

But each scrap can only support one colour (no gradients), so the more scraps there are, the smoother the colour transition between high level passages and low level.