[[start]]>>[[do]]>>[[templates]]>>[[drawingchecklist]] ====== Drawing Checklist: ====== If you are learning to draw you should first work through [[tfc|Therion for Cavers]] and [[tbe|Therion by Examples]]. The Therion Book that downloaded with your version of Therion is the definitive command reference. If you already have the background knowledge, and just need a quick prompt to remember how to draw consistent maps, this page might be helpful. I flick to this page every time I start a drawing. ===== To make a new drawing: ===== - Open Xtherion and activate the map editor window (F2) - **Create a new file** (leftmost lefthand toolbar button) - Save the file (It should bring up a 'save as' dialog so that you can choose where to save the new file - see the bold text [[drawingchecklist#scrap|under the scrap heading below]] for a file naming convention) - **Insert background images or xvi file** (bottom side menu item). If you have some PocketTopo paperless survey data, then the [[paperless#data_transfer_from_pockettopo_to_therion|paperless data transfer]] page (and or [[contrib:complimentarycaveapps#topparser|TopParser]]) might be helpful to get you through this step. - **Create scrap(s)** (leftmost righthand toolbar button). Again, see [[drawingchecklist#scrap|below]] for naming and options. - **Insert point** survey [[drawingchecklist#station|stations]] - About now you could add your scrap to a map object definition, make sure that map definition is referred to in one of the maps selected for export. Now you can compile regularly to check that it works and that it looks how you expect. - Create cave [[drawingchecklist#wall|walls]]. Make sure the yellow tick points to INSIDE of the passage. - **Create passage details** from bottom to top (ie **start on the floor and work towards the ceiling**), usually this means [[drawingchecklist#areas|area borders and areas]] then lines and points for passage features and labels - Move on to the next scrap... ===== Tips ===== Here is how to create a [[tips#list_of_all_possible_default_symbols|list of all possible default symbols]] in all available symbol sets ==== Scrap Drawing ==== * Use mostest: Save! * Use most: point * Use moderately: line * Use sparingly: area * Keep scraps small and simple. Break them near junctions, changes of complexity. This allows you to easily rearrange the map definitions at a later date. Monster scraps can be very hard to break up later on, but many small scraps are very easy to rearrange. * Keep scraps small and simple. Break them at changes of elevation (say more than 5% of expected cave depth). This allows better representation of colour by elevation maps as each scrap can only have one colour. * Assuming you have two monitors keep the previous output open on one while editing in the Xtherion drawing editor on the other. * Use points lines and areas that have consistent looking symbol options available. The Brazilian Speleological Society [SBE] symbols have a unique look, and so I have identified entities below that only have SBE symbols available. You may wish to either favour or avoid these. * See also the [[faq#surveys_and_drawings|faq page]] ==== Constrain Possible Errors ==== * Compile often, the source of errors is not always obvious, and frequent compiles help to narrow the list of possible error sources. * Check the scrap distortions (and loop errors) reported by Therion frequently. Unexpectedly large values (sort to the top of the lists and) probably mean you've plotted or named a station incorrectly. You can see this graphically in pdfs by including a 'debug all' or 'debug first' followed by debug station-names and possibly debug second or debug scrap-names statements in your layout. See [[faq#how_do_i_use_debug_mode_in_layout]] * Save the log file with your outputs. This way you can debug some types of historical errors. * Export a __map__ to kml every so often to check that your scraps are properly drawn. PDF, and to a lesser extent, Loch outputs are tolerant of a number of drawing errors, whereas you can see them in Google Earth manifested as missing or miss-drawn pieces of cave passage. The usual culprits are described in the link below. *[[tips#avoiding_invisible_or_misshapen_scraps_in_loch_and_google_earth|Avoiding Invisible or Misshapen Scraps in Loch and Google Earth]] *Check for and remove accidentally drawn [[tips#checking_and_erasing_empty_objects_in_th2_files|empty objects]] every so often. ====== Common 'options text box entries' for drawing with Xtherion ====== Use the following as a guide when using Xtherion, while creating your own Therion drawings. The format used below is... entity name followed by options # optional options ## comments ===== scrap ===== **Workflow to create a new scrap with XTherion;** Ctrl+R, THEN type or select the scrap id (name), projection and options. Then create points lines and areas that are to be part of this scrap. \\ (closer to workflow for lines and areas than it is to workflow for points)\\ \\ The initial part of each scrap id (name) should match the file name. For example the following scraps will be in the \\ **-.th2** file, where; \\ = one or two letter survey identifier, \\ = very brief name of the part of the cave, and \\ = Plan, Elev000, ElevExt or None, for instance. \\ NOTE: Don't use the <> delimiters Projection none is used when drawing cross sections. Refer to [[drawingchecklist#points| point section]] below. ^scrap id: ^projection:^ |-**Plan**-**s1** | plan| |-**Elev000**-**s1** | elevation 000 deg| |-**ElevExt**-**s1** | extended| |--**x1** | none| -author date "M Name" -copyright year "Organisation" # -title "optionalScrapTitle" # -station-names @ ## avoids including in individual station's names # -flip horizontal ## if for example your extended elevation scrap is to be attached to a centreline that is extended left but it was drawn in PocketTopo to the right ## eg -station-names [] @ # if prefix is blank ## or -station-names [] # if suffix is blank ## or -station-names [] [] #if you want to cancel a previous station-names definition Where you need to enter a 'person' data type, such as 'author' (or survey 'team' or 'explo-team' member for surveys) Therion assumes a person has two words in their name (first name and last name). If you enter more than two words, Therion will report an error unless you use a forward slash, ''/'', in place of ONE of the spaces. See also [[faq#how_do_i_add_peoples_names_if_they_have_more_than_two_words_names|FAQ]] entry. More than one ''/'' and Therion will give you an error. Once there is a ''/'', you can have as many spaces as you like. Suggested usage is that you use the ''/'' to separate forenames from surnames. These examples will work: -author 2017 "Bruce Mutton" # correct, / not required with two names -author 2017 "Bruce/Mutton" # correct, / is optional with two names -author 2017 "Mary Anne/von Mutton" # correct, / is required with more than two names -author 2017 "Bruce/von Mutton" # correct and will presumably alpha sort on 'von' -author 2017 "Bruce von/Mutton" # works but presumably will alpha sort on 'Mutton' -author 2017 "Bruce van/der Mutton" # works but presumably will alpha sort on 'der' You can enter multiple authors (or dates of authorship) for any one scrap by entering multiple ''-author "name"'' attribute statements. See also the tips on ''station-names'' and ''revise'' at the bottom of [[paperless#data_transfer_from_pockettopo_to_therion|paperless data transfer]].\\ //Be warned that if you copy text with quotes from this web page, chances are the character pasted into Xtherion or your text editor will look like a ", but will cause Therion to crash with an apparently unrelated error. You will need to manually overtype the " each time you paste it.// * //The outline of a scrap is defined by lines that have the option -outline set to 'in' or 'out'.// Wall lines have '-outline out' set by default. * Each scrap must represent a continuous length of passage. There should be no gaps within the body of the scrap. * If a passage passes over or under itself, then the overlapping parts must be in separate scraps. * If you want to include one or more //background images// in the finished output, then (once it has been inserted as a //background image// in the drawing file) you can insert it into a scrap (Bottom option in Xtherion's Scrap pane). //Background images// inserted into scraps are known as //background sketches//. To output these, you will need ''sketches on'' in your layout, as by default, sketches are off. Beware they take a long time to compile and result in large output files. This feature is not intended for surface image bitmaps (refer to the Therion Book). * When finishing up your drawing, you might like to force Therion to join adjacent scraps seamlessly, if they don't automatically do so. Refer to [[tips#joining_scraps_together]] ===== station ===== (These are just a type of [[drawingchecklist#points|point]]. See [[drawingchecklist#points|below]])\\ Each plan, elevation or extended scrap must have either; * at least two ''point stations'' defined, or * one ''point station'' defined, and also have the scrap accurately scaled, otherwise Therion cannot properly relate the scrap drawing to the survey centreline. ''__point station__'' -name @survey ## Options applicable to extended elevation scraps only -from ## Applicable to extended elevations where two or more instances of a station are plotted. Choose the instance of the station that this point refers to by referencing the other station in the leg to be represented. -extend [previous] | [] ## You can adjust the extension of the centreline using this option. Pg 25 Therion Book (I am not clear on this, if you have any insight into syntax or usage cases, please post on the forum). You can label the stations using ''point station-name'' or ''debug station-names'' as described in [[drawingchecklist#points|Points Labels]] below. ===== wall ===== Walls (and lines with ''-outline in/out'') define the outline of the scrap. Walls are just a special type of [[drawingchecklist#lines|line]] that; * have the option '-outline out' set by default, * clip many symbols that typically only appear inside the cave passage (unless ''-outline none'' is set), * have their own special subtypes, and altitude labeling, that are not available to other lines, * define the shape of previewed (above and below) scrap outlines (other linetypes with -outline set to in or out do not do this ), * are used by the automatic scrap join algorithm to decide which line ends to join (unless ''-subtype invisible'' is set). To clarify this last point it's worth noting that there are two different ways of making a wall line invisible, which are treated differently by the automatic scrap join algorithm; line wall -subtype invisible # The entire wall line is not displayed, and will be ignored by the scrap join algorithm. The wall shape is plotted with preview below, but not with preview above. Typical use is to 'close' an open end of a scrap if it is wider than it is long, or to define the shape of the open end of a scrap, say, at an entrance. line wall -visibility off # The entire wall line is not displayed, but can be used by the automatic scrap join algorithm when it chooses which points to join. The wall shape is plotted with both preview below and preview above. ie A normal wall in all respects, just invisible. Can be used to define the shape of the open end of a scrap, say, at an entrance or if a wall is made from really huge blocks you want to draw their shapes. (Note that irrespective of visibility settings, any point and any line point can be joined manually) See [[drawingchecklist#lines|below]] for general line tips.\\ \\ ''__line wall__'' \\ //Always check that the little **yellow tick mark** (on the left hand side of the first line point) **points towards the inside or free space side of whatever object you're drawing** (in this case, the void space inside the cave, but for rock-borders it would be the inside of the rock, lower side of pitch edge, higher side of chimney or ceiling-step or for areas the inside of the area, or down slope side of a line flowstone). While in theory Therion is becoming more resilient to this type of drawing misdemeanour, in practice I find that with 3D models and kml plans it still seems to be important (v 2.3.6 to v 5.3.16). A simple trick is to draw lines counter-clockwise, except for pillars or interior walls of oxbows which should have '-outline in' and be drawn clockwise.// # -outline in ## for passage walls that form a closed interior loop (or pillar) within the current scrap # -outline none ## for passage wall lines that don't define the inside or outside of a scrap # -outline out ## (the default) can be used with 'subtype invisible' for scrap boundaries that are not 'straight across' between the open ends of the walls, or must be used where the open ends of the scrap are wider than the scrap is long ### entrance of cave, transparent pits, overhangs at the end of gallery venting into room, etc. ## apply the following to wall 'line point' options as required altitude . ## include the dot, adds a label showing the altitude of the nearest survey station to the wall subtype bedrock # default thick solid line subtype clay # < 0.06mm ie silt & clay to a geologist subtype sand # < 2mm subtype pebbles # < 200mm ie cobbles & gravels to a geologist subtype debris # < ~2m? subtype blocks # more than ~2m? subtype flowstone subtype moonmilk subtype ice subtype # pit -height [10 m] ##usually refers to pit from surface, not underground pit or shaft subtype invisible # preview above outlines are not displayed for wall segments that have subtype invisible set. Preview below outlines are displayed. subtype unsurveyed subtype presumed subtype underlying subtype overlying ## or use any defined line-type as the outline of a scrap simply by drawing that line and setting '-outline out' or '-outline in' as appropriate. ===== points ===== **Workflow to create a new point with XTherion;** Ctrl+P, then insert a point, THEN type or select the point type. \\ (differs from workflow for lines and areas)\\ \\ ''__point u:xxxx__'' where xxxx is the name of a user defined symbol that you have defined or referenced in a layout.\\ **Labels** \\ ''__point label__ -text "xx" #-scale m -align l'' ## Recommended for general usage. \\ # Point label always gives you text of the size you specify, at default character spacing. # The label text has an opaque bounding box that obscures most objects beneath it. If this is frustrating, then line label might be a better option. # Suggest you do not use -orientation as it results in slight label rotation variations due to morphing. See also [[drawingchecklist#lines|Line label]] \\ \\ Placeholder TO DO: Make an entry about boxed labels, and how to use them. Based on [[https://www.mail-archive.com/therion@speleo.sk/msg07230.html|this forum conversation]] and [[https://www.mail-archive.com/therion@speleo.sk/msg07234.html|this one.]] ''__point remark__ ##similar to label''\\ ''__point altitude__'' \\ ''__point height__ -value [-10? m] # + or unsigned for up, - for down, ? if uncertain'' ## arbitrary indicator of feature height or depth \\ ''__point passage-height__ -value '' ## labels drawing and controls 3d height of passage above and below survey centreline in Loch. See also point dimensions and further passage-height explanation below. \\ ''__point date__ -value 2012.05.12 -scale xs'' ## arbitrary date label, say for date of observation or past limits of exploration. Dates are now (v5.3.11 Dec2012) shown in exported map outputs using the short form format set in the operating system locale settings. \\ You can label individual survey stations by using ''point station-name'' or label all survey stations using ''debug station-names'' inside of a layout; ''__point station-name__ -scale xs'' ## labels with the name of the nearest station (unless you override it with ''-text "xx"'') \\ ''__debug station-names__'' ## or ''__debug all__'', labels all survey stations. \\ By default the above two statements create station name labels with just the station name. If you want to include the survey name(s), you should include in a layout; \\ ''__survey-level__ all'' ## If you want to include only say 2 survey hierarchy levels, then use ''survey-level 2'' \\ The following parameters (in the box below) apply to most labels, and show how to control justification of multi-line text, multilingual text, size and alignment.\\ You DO need to type the < and > delimiters shown below __within__ the label text strings. \\ -text "LabelText" # "
" ## formats multi-line text justification within a label, is the default.
= newline # ## thin space # ## change to roman font from this point on ... # ## ... roman italic font ... # ## ... roman bold font ... # ## ... sans serif font ... [default for point label] # ## ... sans serif italic font ... [default for point remark] # "Type here undefined language text, or text to appear if specified language text does not match one of the followingType here the English language translationType here Te Reo Maori translation" # or more simply stated... # "Undefined language textEnglish translationTe Reo Maori translationБългарски translation" # ## beginning and end of right-to-left text" ## -scale sets the size of the entire label string, unless it is modified by , or within a string. The label retains the property set by -scale, regardless of any parameter that it may contain. ie if you invoke min-symbol-scale, the entire label will be shown or hidden based on the -scale property, irrespective of any controls within the -text string. ## In general the size in points of labels should be set, preferably, by using the fonts-setup layout statement if you want to override Therion's default settings. # -scale xl ## main passage names # -scale l ## Significant features in main passages # -scale m ## Significant features in minor passages # -scale s ## Minor features in side passages # -scale xs ## station names, air draught dates, less important information # -scale ## relative to -scale m (0.5 ≡ xs, 1.0 ≡ m, 2.0 ≡ xl symbol size, ). Applicable for all point and line symbols v5.4.1 # ## size of text using predefined scales xs, s, m, l or xl. Applicable v6.1.1 # ## size of text relative to the -scale parameter for this label, where 1 =< N =< 999. Therion rounds N% to nearest 10% before it is applied to the label. # ## size of the text in points, where 1 =< N =< 127 # -align r # l c tl tr bl br ## right, left, centre of insertion point, etc relative to the scrap as viewed in Xtherion, NOT to the finished output (So it pays to scan your sketches or rotate your 'paperless' images to match the intended finished output rotation). ''__point map-connection__'' ## place one of these on a scrap that you may decide to offset. It causes Therion to generate a dashed line between the main map and the offset map. My convention is that I only place a point map-connection in locations where a person can travel from a passage that is not offset, to the passage that is offset. This maximises the maps usefulness for navigation purposes. ''__point danger__'' \\ **Passage Size, Features, Fills and Speleothems** \\ ''__point section__ -scrap -Plan-x1 -align top-right'' ## Use to insert a cross-section scrap, drawn with ''-projection none'', into your plan, extended or elevation scraps. The ''-align'' parameter is particularly important to position the section well when you may want to output at differing scales. See [[drawingchecklist#scrap|scrap]] above and [[drawingchecklist#lines|line section]] below. \\ ''__point dimensions__ -value [10? 1.5 m]'' ## ? indicates uncertainty, can optionally specify units \\ ## where there's no up down data, controls 3d height of passage above and below centreline in Loch \\ ## you may use it when: 1. the sketch is not in scale, but there are notes of dimensions from nearest station, 2. the object is vertically shifted according the station (walls for sloping section, for example).\\ ''__point extra__'' ## additional morphing point. \\ -dist 20m ## distance to the nearest survey station. If -dist not specified, then assumes the 'point extra' is at a distance specified by the LRUD value from the nearest survey station. -from ## You can specify which station that the distance is measured from. ''__point passage-height__ -value '' ## labels drawing and controls 3d height of passage above and below survey centreline in Loch. \\ -value [5 m] ## (no sign) distance between floor and ceiling -ie passage height where no significant water exists -value [+5 m] ## (+ sign) height to ceiling -ie airspace where there is a significant body of water -value [-5 m] ## depth to floor or depth of water (use pit or floor step for depth of that type of feature) -value [+1 -4? m] ## (both explicitly signed) distance to ceiling (or airspace), distance to floor (or depth of water) Quite often the context you use passage height in will not suit the default legend descriptors (or your preferences) for the the passage height symbol. You can add a 'text' statement to your thconfig file to tailor the legend text to your needs; eg a variety of possibilities follow, my tentative recommendation is to use the first of each group and //adopt a drawing convention of only using signed values where there is a body of water involved//, text en "point passage-height:unsigned" "passage height" text en "point passage-height:negative" "water depth" text en "point passage-height:positive" "air space" text en "point passage-height:positive" "ceiling height" text en "point passage-height:both" "air space, water depth" text en "point passage-height:both" "height above, depth below water" text en "point passage-height:both" "ceiling height, water depth" text en "point passage-height:both" "height above, depth below centreline" #(this is actually what is modelled in Loch) As you may well have multiple contexts within one cave map, and each subtype of the ''text'' statement will apply to the entire output, you will need to think carefully about how you want to use this feature. ie perhaps 'ceiling height' is more generic than 'air space' The dual function of passage-height for labelling and defining passage height in models is problematic. For example where passage-height is used to indicate water depths and ceiling height above water, if the survey centreline is not at water surface level, the Loch model will incorrectly define the passage floor and ceiling heights. ''__point air-draught__ #air-draught:winter air-draught:summer'' \\ -scale m # xs s l xl ## adjusts strength of draught or size of water flow arrow ''__point gradient__'' -scale m # xs s l xl ## adjusts size of gradient arrow ''__point sink__'' ## use in conjunction with point or line water-flow, best if orientation matches water-flow orientation\\ ''__point spring__'' ## use in conjunction with point or line water-flow, best if orientation matches water-flow orientation\\ ''__point water__'' \\ ''__point water-flow__ # water-flow:intermittent water-flow:paleo'' ## paleo = scallop flow direction\\ ''__point water-drip__'' [SBE]\\ ''__point bat__'' [SBE]\\ ''__point bedrock__'' # shows bedding or joint direction (point orientation is perpendicular to bedding/joint orientation) \\ ''__point clay__'' \\ ''__point mud__'' [SBE]\\ ''__point mudcrack__'' [SBE]\\ ''__point sand__'' \\ ''__point pebbles__'' \\ ''__point debris__'' \\ ''__point blocks__'' \\ ''__point guano__'' \\ ''__point karren__'' \\ ''__point scallop__'' \\ ''__point aragonite__'' \\ ''__point anastomosis__'' \\ ''__point cave-pearl__'' \\ ''__point clay-tree__'' \\ ''__point curtain__'' \\ ''__point curtains__'' \\ ''__point crystal__'' \\ ''__point disk__'' \\ ''__point disk-pillar__'' \\ ''__point disk-pillars__'' \\ ''__point disk-stalactite__'' \\ ''__point disk-stalactites__'' \\ ''__point disk-stalagmite__'' \\ ''__point disk-stalagmites__'' \\ ''__point flowstone__'' \\ ''__point flute__'' \\ ''__point gypsum__'' \\ ''__point gypsum-flower__'' \\ ''__point helictite__'' \\ ''__point helictites__'' \\ ''__point moon-milk__'' \\ ''__point pendant__'' [SBE]\\ ''__point popcorn__'' \\ ''__point raft__'' \\ ''__point raft-cone__'' \\ ''__point soda-straw__'' \\ ''__point wall-calcite__'' \\ ''__point rimstone-pool__'' \\ ''__point rimstone-dam__'' \\ ''__point snow__'' \\ ''__point ice__'' \\ ''__point ice-stalactite__'' \\ ''__point ice-stalagmite__'' \\ ''__point ice-pillar__'' \\ ''__point stalactite__'' \\ ''__point stalactites__'' # not documented, but you can use 's' to indicate multiple stals\\ ''__point stalagmite__'' \\ ''__point stalagmites__'' \\ ''__point stalactite-stalagmite__'' \\ ''__point stalactites-stalagmites__'' \\ ''__point pillar__'' \\ ''__point pillars__'' \\ ''__point pillar-with-curtains__'' \\ ''__point pillars-with-curtains__'' \\ ''__point volcano__'' [SBE]\\ ''__point bones__'' [SBE]\\ ''__point human-bones__'' [SBE]\\ ''__point paleo-material__'' # bones etc\\ ''__point root__'' \\ ''__point tree-trunk__'' [SBE]\\ ''__point vegetable-debris__'' \\ ''__point seed-germination__'' [SBE]\\ **Passage Ends** \\ ''__point dig__'' \\ ''__point narrow-end__'' \\ ''__point low-end__'' \\ ''__point flowstone-choke__'' \\ ''__point breakdown-choke__'' \\ ''__point clay-choke__'' \\ ''__point entrance__'' ## entrance points in a scrap drawing ONLY show up in that drawing.\\ If you wish to have your entrances show up and be labeled in models, then, to define a 'cave', add an ''-entrance'' option to the scrap definition. eg survey 01 -title "Growler Cave 1" -entrance 1.3 ... endsurvey 01 Now, if you want the model to display and label all of the other entrances (that are part of the same 'cave') you should add ''station ... entrance'' statements within the survey centreline. station 1.20 "resurgence" entrance # ie another entrance in another part of the same cave In this example, an entrance symbol, and the text "resurgence", will show up in Loch models, Google Earth maps and models, and cave-list outputs. See example below, which has 'Growler Cave 1', as defined above, and 4 other entrances, of passage I have considered to be part of the same cave (there are other caves not shown here, hence the 'Growler Caves' toplevel entry in the list - Therion has extracted that name from the toplevel survey title). {{:bds:growler_cave-list.png|}}{{:bds:growler_Loch.png?300|:bds:growler_Loch.png - Click to enlarge}} {{:bds:growler_model_and_map_kml.png?400|:bds:growler_model_and_map_kml.png - Click to enlarge}} \\ For more detail, check out the [[faq#how_do_i_specify_a_main_entrance_and_also_the_other_entrances|FAQ page - main entrance definition]] ''__point continuation__'' -text "Description" -attr who "M Name" -attr what climb -attr priority low -attr ref plan # -explored 8.0m '**who**' is the person(s) who identified the the item, or the person assigned to resolve the issue.\\ '**what**' can be rift|climb|pitch|squeeze|tight|sump|rock-pile or whatever you like. (I'm thinking of using it as a 'to do' list so I could add, for example survey|re-rig)\\ '**priority**' can be any number, text phrase or be omitted,\\ '**ref**' is intended to indicate where the data entry to this point is made, ie plan|elev|centreline, where = ext for extended elevation, or, say 090 for the direction of a projected elevation, or centreline if it is in the .th file (Therion does not yet report the location of this information, so manually entering it helps down the track when you want to make edits and updates).\\ \\ String values of these attribute fields only need to be in quotes if they contain a space.\\ \\ This next syntax is not really drawing, as it applies to centrelines, but it achieves the same effect in the outputs... station mk103 "mk103 drains swamp, passage descends" \ continuation attr who "My Name" attr what pit attr priority high \ attr ref centreline \ # entrance air-draught doline sink not explored Notice that in centrelines with the 'station' statement we use 'attr' and not '-attr'. \\ \\ In both cases the attributes are exported to continuation-lists (and cave-lists if the entrance of the cave is a 'continuation point') and if entered into a drawing scrap, to the relevant plan or elevation pdf file. See the end of the Therion Book or [[http://therion.speleo.sk/wiki/doku.php?do=search&id=LayoutShowContinuationQmarkOnly+]] for examples of how to get a 'debug like' highlighted textual output on your drawings. It's a bit cumbersome to use 'continuation points' as a 'to do' list, but it does allow multiple or single points of data entry, and output in textural, pictorial or database format. **Man made, Equipment**\\ ''__point alter__'' [SBE]\\ ''__point anchor__'' \\ ''__point archeo-excavation__'' [SBE]\\ ''__point archeo-material__'' \\ ''__point audio__'' [SBE]\\ ''__point bridge__'' \\ ''__point camp__'' \\ ''__point electric-light__'' [SBE]\\ ''__point ex-voto__'' [SBE]\\ ''__point fixed-ladder__'' \\ ''__point gate__'' [SBE]\\ ''__point handrail__'' \\ ''__point masonry__'' [SBE]\\ ''__point nameplate__'' [SBE]\\ ''__point no-equipment__'' \\ ''__point photo__'' [SBE]\\ ''__point rope-ladder__'' \\ ''__point rope__'' \\ ''__point steps__'' \\ ''__point traverse__'' \\ ''__point via-ferrata__'' \\ ''__point walkway__'' [SBE]\\ ''__point wheelchair__'' [SBE]\\ ''__point no-wheelchair__'' [SBE]\\ ===== lines ===== **Workflow to create a new line with XTherion;** Ctrl+L, THEN type or select the line type, then draw the line, adding any subtypes point by point as you go. \\ (differs from workflow for points)\\ * //Any line can be made to behave like a scrap outline or 'wall' by setting ''-outline out'' or ''-outline in''//\\ \\ ''__line u:xxxx__'' where xxxx is the name of a user defined line symbol that you have defined or referenced in a layout.\\ **Labels** \\ ''__line arrow__ # -head end (default) -head both -head none -head begin'' \\ Often arrows are associated with a label (or remark or date) and it is of benefit if the visibility of such arrows is controlled by the same statements that control the visibility of the label.\\ If you assign the context of the label to the arrow, you can achieve this using ''symbol-hide point label'' (or ''point remark'' or ''point date'' or ''line label'' or ''group text'', as appropriate). \\ If you assign the scale of the label to the arrow, you can achieve this using ''min-symbol-scale s'' or ''min-symbol-scale m''\\ line arrow -context point label -scale xs #visibility of this arrow will be controlled as though it were a point label of scale xs ''__line label__ -text "Label Text" # -scale s'' ## Line label gives you text fitted to the curve and length of the line. # If the line is longer than is necessary for the specified scale (text height), then the characters are spaced out to fit the line. # If the line is too short, the text scale is reduced so that the text will fit. # Unlike point label, each character has its own opaque bounding box, so line label does not obscure so much of any objects that render beneath it. see also [[drawingchecklist#points|Point Label]] \\ ''__line pit__'' (or ''line wall:pit'') ''-height [+10 m]'' ## -ve and ? values not allowed, as they are for ''point height''. At present, only AUT symbolset responds to height, by filling in triangles where height > 20m \\ \\ ''__line section__ # -direction begin -direction end -direction both -direction '' ## If both bezier control points are active, they individually control length of displayed section line. For drawing cross sections, see [[drawingchecklist#scrap|scrap]] and [[drawingchecklist#points|point section]] above.\\ ''__line survey__'' ## drawn automatically by Therion, but perhaps you could use it?\\ ''__line map-connection__'' ## In case you want to manually draw a map-connection line, perhaps on an [[extend|extended elevation]]. Refer to "Stations in extended elevation scraps" on page 95 of the Therion Book **Passages** \\ ''__[[drawingchecklist#wall|line wall]]__'' \\ ''__line abyss-entrance__'' [SBE]\\ ''__line dripline__'' [SBE]\\ ''__line floor-step__'' \\ ''__line pit__ # -height [10 m] '' ## pit or shaft within the cave, not from surface. At present, only AUT symbolset responds to height, by filling in triangles where height > 20m\\ ''__line floor-meander__'' \\ ''__line gradient__'' \\ ''__line slope__'' # must specify l-size for at least one line point, and optionally orientation at one or more line points, ''-border on'' ## to get a line at the top edge\\ ''__line contour__ # -gradient '' ## to specify no tick marks, at centre only,eg line contour -gradient center 1184.0 735.0 1192.0 756.0 1197.0 770.0 1197.0 782.0 1197.0 794.0 1196.0 822.0 1187.0 841.0 1178.0 860.0 1169.0 873.0 1159.0 879.0 smooth off endline or alternatively don't specify gradient for the line, but specify 'gradient point' in the black options box for ticks at particular line points only, eg \\ line contour 1184.0 735.0 1192.0 756.0 1197.0 770.0 1197.0 782.0 gradient point 1197.0 794.0 1196.0 822.0 1187.0 841.0 gradient point 1178.0 860.0 1169.0 873.0 1159.0 879.0 smooth off endline You __cannot__ specify lsize or orientation for line contour.\\ \\ ''__line chimney__'' \\ ''__line ceiling-step__'' \\ ''__line ceiling-meander__'' \\ ''__line overhang__'' \\ ''__line fault__'' [SBE]\\ ''__line joint__'' [SBE]\\ **Passage Fills** \\ ''__line border__ # border:invisible border:visible border:temporary border:presumed'' \\ ''__line rimstone-dam__'' [SBE]\\ ''__line rimstone-pool__'' [SBE]\\ ''__line moon-milk__'' \\ ''__line rock-border__'' ## //See the [[drawingchecklist#wall|yellow tick advice]] above// \\ ''__line rock-edge__'' ## internal edge of large boulder \\ ''__line water-flow__ # water-flow:conjectural water-flow:intermittent'' \\ ''__line flowstone__'' ## tick on down slope side\\ ''__line low-ceiling__'' [SBE]\\ ''__line pit-chimney__'' [SBE]\\ \\ **Man made, Equipment** \\ ''__line handrail__'' \\ ''__line rope__'' \\ ''__line steps__ -attr c 4'' ## v5.3.11 A bit different to most lines. Draw a rectangle (or other polygon) matching the outline shape of the stairs and add the option ''-attr c'' and then write the number of stair treads. This line type detects whether it is drawn in elevation or in plan, and plots appropriately. {{:metapost:steps.png?200|}} {{:metapost:stepsplan.png?200|}} {{:metapost:stepselev.png?200|}} Steps begin parallel with first section of line, yellow tick must be oriented inside. line xxxx -scale ## 1.0 ≡ medium symbol size, for all point and line symbols #5.4.1 ''__line via-ferrata__'' \\ ''__line walkway__'' [SBE]\\ ===== areas ===== **Workflow to create a new area with XTherion;** \\ Create a border for the area, then create the area, preferably a unique closed border for each area drawn immediately prior to the area creation.\\ Draw the border as per line creation workflow above, then create the area using this workflow...\\ Ctrl+A, THEN type or select the area type, then select the previously drawn lines that define the area extent. \\ (differs from workflow for points, but similar to workflow for lines)\\ \\ //See the [[drawingchecklist#wall|yellow tick advice]] above// \\ * Avoid using passage walls or other shared lines as borders for passage fill areas. Use instead a closed border especially for each area. This avoids problems later if you need to split lines in two (upsets the id), such as when joined scraps are relying on the id being unchanged. * Usually use //line border// or //line border:invisible// for area borders, but almost any type of line could be used. * Generally you should draw areas before other passage fill objects, and draw them from bottom to top, ie sand (under water) first, then water, clay island in water, flowstone on the clay. * Remember, best results will probably be achieved by minimising the use of areas, so a better approach to the previous item would be; draw //point sand//, draw border and //area water//, draw //point clay -scale xl// for the island (if it is a small island, or border and //area clay// if it is larger), draw //point flowstone// on the island. * Some useful information on how pdf viewers treat visibility and areas [[contrib:externalviewers#for_pdf_files]] and [[:tips#drawing_order_how_to_draw_symbols_over_or_under_an_area]]\\ ''__area u:xxxx__'' where xxxx is the name of a user defined area symbol that you have defined or referenced in a layout. ''__area water__'' \\ ''__area sump__'' \\ ''__area bedrock__ ''# cleans the background, makes an empty area on map. Use //point bedrock// to show bedding \\ ''__area clay__'' # < 0.06mm ie silt & clay to a geologist, mud to a NZ caver \\ ''__area sand__'' # < 2mm \\ ''__area pebbles__'' # < 200mm ie cobbles & gravels to a geologist \\ ''__area debris__'' # < ~2m? \\ ''__area blocks__'' # more than ~2m?\\ \\ ''__area mudcrack__'' [SBE]\\ ''__area flowstone__'' \\ ''__area moonmilk__'' \\ \\ ''__area pillar__'' [SBE]\\ ''__area pillar-with-curtains__'' [SBE]\\ ''__area stalactite__'' [SBE]\\ ''__area stalactite-stalagmite__'' [SBE]\\ ''__area stalagmite__'' [SBE]\\ \\ ''__area ice__'' \\ ''__area snow__'' ===== Options Common to many points, lines and areas ===== -clip off -scale m # xs s l xl or a number ## adjusts size. xs ≡ 0.5, m ≡ 1.0, xl ≡ 2.0 -align r # l c tl tr bl br ## right, left, centre of insertion point, etc -place bottom # default top ## adjusts which symbols plot on bottom, middle or top ## intuitively therion places floor symbols and areas on the bottom and ceiling symbols on the top. Beyond this you have some control in that symbols that appear first in the scrap tend to plot on top. See Therion Book "How the map is put together" for details. If all else fails you may need to put offending symbols or areas on another scrap and place it under or over the scrap you are working on. (Don't use break if your new scrap has no walls defined v5.3.3) -context ## makes this entity behave as though it is symbol-type when symbol-show or symbol-hide is applied. EG you might like the 'point date -value 2012.05.12' associated with a point air-draught to behave like a point air-draught, OR you might like an arrow associated with a point label to show or hide along with the point labels (and other text). And for 'line point' options... adjust horizontal # vertical ## For elevation (and cross sections?) drawings; moves the current 'line point' so that the preceding segment is always horizontal or vertical regardless of any morphing that is applied to the scrap. Good for drawing water surfaces, rope hangs and waterfalls. You can control the visibility of symbols in maps and atlas by using ''symbol-show'' and ''symbol-hide'' statements in layouts; The visibility of collections of symbols can be controlled using groups. Pre-defined groups are listed in [[tbe:wiki4#maps|Therion by Examples 4.5 Maps]]. You can include individual symbols in a particular group by specifying a ''-context'' option when you draw it. Regarding drawing over or under area fills, refer to [[tips#drawing_order_how_to_draw_symbols_over_or_under_an_area]]