drawingchecklist

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
drawingchecklist [2018/12/23 02:11] – [points] boxed label placeholder brucemuttondrawingchecklist [2023/06/11 23:09] (current) – [lines] Add default arrow setting (-head end) brucemutton
Line 29: Line 29:
   * 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.   * 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.   * 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]]   * See also the [[faq#surveys_and_drawings|faq page]]
  
Line 102: Line 103:
 ===== station ===== ===== station =====
 (These are just a type of [[drawingchecklist#points|point]].  See [[drawingchecklist#points|below]])\\ (These are just a type of [[drawingchecklist#points|point]].  See [[drawingchecklist#points|below]])\\
-''__point station__'' <code> -name <prefix><No>@survey </code>+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__''  
 +<code> -name <prefix><No>@survey  
 + 
 +## Options applicable to extended elevation scraps only 
 + 
 + -from <station> ## 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] | [<station>] ## 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). 
 +</code>
 You can label the stations using ''point station-name'' or ''debug station-names'' as described in [[drawingchecklist#points|Points Labels]] below. You can label the stations using ''point station-name'' or ''debug station-names'' as described in [[drawingchecklist#points|Points Labels]] below.
  
Line 116: Line 131:
 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; 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 wall line is not displayed, and will be ignored by the scrap join algorithm. 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 -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 wall line is not displayed, but can be used by the automatic scrap join algorithm when it chooses which points to join. 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.+  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) (Note that irrespective of visibility settings, any point and any line point can be joined manually)
Line 136: Line 151:
 ## apply the following to wall 'line point' options as required  ## apply the following to wall 'line point' options as required 
  
-  altitude .   ## include the dot, adds the altitude of the nearest survey station to the wall+  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 bedrock # default thick solid line
   subtype clay # < 0.06mm ie silt & clay to a geologist      subtype clay # < 0.06mm ie silt & clay to a geologist   
Line 148: Line 163:
   subtype # pit -height [10 m]  ##usually refers to pit from surface, not underground pit or shaft   subtype # pit -height [10 m]  ##usually refers to pit from surface, not underground pit or shaft
          
-  subtype invisible +  subtype invisible  # preview above outlines are not displayed for wall segments that have subtype invisible set.  Preview below outlines are displayed.
   subtype unsurveyed    subtype unsurveyed 
   subtype presumed    subtype presumed 
Line 190: Line 205:
 <code> -text "LabelText"  <code> -text "LabelText" 
  
-# "<br><left><right><centre>" ## formats multi-line text justification, <left> is the default.  <br> = newline +# "<br><left><right><centre>" ## formats multi-line text justification within a label, <left> is the default.  <br> = newline 
 # <thsp> ## thin space # <thsp> ## thin space
-# <rm> ## roman font  +# <rm> ## change to roman font from this point on ... 
-# <it> ## roman italic font +# <it> ## ... roman italic font ... 
-# <bf> ## roman bold font +# <bf> ## ... roman bold font ... 
-# <ss> ## sans serif font [default for point label] +# <ss> ## ... sans serif font ... [default for point label] 
-# <si> ## sans serif italic font[default for point remark]+# <si> ## ... 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 following<lang:en>Type here the English language translation<lang:mi>Type here Te Reo Maori translation" # "Type here undefined language text, or text to appear if specified language text does not match one of the following<lang:en>Type here the English language translation<lang:mi>Type here Te Reo Maori translation"
Line 204: Line 219:
 #<rtl>   </rtl> ## beginning and end of right-to-left text" #<rtl>   </rtl> ## beginning and end of right-to-left text"
  
 +## -scale sets the size of the entire label string, unless it is modified by <size:S>, <size:N> or <size:N%> within a string.  The label retains the property set by -scale, regardless of any <size:*> 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 <size:*> 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 xl ## main passage names 
 # -scale l ## Significant features in main passages  # -scale l ## Significant features in main passages 
Line 210: Line 227:
 # -scale xs ## station names, air draught dates, less important information  # -scale xs ## station names, air draught dates, less important information 
  
-# -scale <number> ## 1.0 ≡ medium symbol size, for all point and line symbols #5.4.1+# -scale <number> ## 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:S>  ## size of text using predefined scales xs, s, m, l or xl.  Applicable v6.1.1 
 +# <size:N%> ## 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:N>  ## 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 # -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 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  (So it pays to scan your sketches or rotate your 'paperless' images to match the 
-intended finished output orientation).+intended finished output rotation).
 </code> </code>
  
 ''__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 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** \\ **Passage Size, Features, Fills and Speleothems** \\
Line 274: Line 297:
 ''__point water__'' \\ ''__point water__'' \\
 ''__point water-flow__ # water-flow:intermittent water-flow:paleo'' ## paleo = scallop flow direction\\ ''__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 bedrock__''  # shows bedding or joint direction (point orientation is perpendicular to bedding/joint orientation) \\
 ''__point clay__'' \\ ''__point clay__'' \\
 +''__point mud__'' [SBE]\\
 +''__point mudcrack__'' [SBE]\\
 ''__point sand__'' \\ ''__point sand__'' \\
 ''__point pebbles__'' \\ ''__point pebbles__'' \\
Line 292: Line 319:
 ''__point clay-tree__'' \\ ''__point clay-tree__'' \\
 ''__point curtain__'' \\ ''__point curtain__'' \\
 +''__point curtains__'' \\
 ''__point crystal__'' \\ ''__point crystal__'' \\
 ''__point disk__'' \\ ''__point disk__'' \\
 +''__point disk-pillar__'' \\
 +''__point disk-pillars__'' \\
 +''__point disk-stalactite__'' \\
 +''__point disk-stalactites__'' \\
 +''__point disk-stalagmite__'' \\
 +''__point disk-stalagmites__'' \\
 ''__point flowstone__'' \\ ''__point flowstone__'' \\
 ''__point flute__'' \\ ''__point flute__'' \\
Line 299: Line 333:
 ''__point gypsum-flower__'' \\ ''__point gypsum-flower__'' \\
 ''__point helictite__'' \\ ''__point helictite__'' \\
 +''__point helictites__'' \\
 ''__point moon-milk__'' \\ ''__point moon-milk__'' \\
 +''__point pendant__'' [SBE]\\
 ''__point popcorn__'' \\ ''__point popcorn__'' \\
 ''__point raft__'' \\ ''__point raft__'' \\
Line 320: Line 356:
 ''__point stalagmite__'' \\ ''__point stalagmite__'' \\
 ''__point stalagmites__'' \\ ''__point stalagmites__'' \\
 +
 +''__point stalactite-stalagmite__'' \\
 +''__point stalactites-stalagmites__'' \\
  
 ''__point pillar__'' \\ ''__point pillar__'' \\
 ''__point pillars__'' \\ ''__point pillars__'' \\
 +''__point pillar-with-curtains__'' \\
 +''__point pillars-with-curtains__'' \\
 +
 +''__point volcano__'' [SBE]\\
  
-''__point paleo-material__'' \\+''__point bones__'' [SBE]\\ 
 +''__point human-bones__'' [SBE]\\ 
 +''__point paleo-material__'' # bones etc\\
  
 ''__point root__'' \\ ''__point root__'' \\
 +''__point tree-trunk__'' [SBE]\\
 ''__point vegetable-debris__'' \\ ''__point vegetable-debris__'' \\
 +''__point seed-germination__'' [SBE]\\
  
 **Passage Ends** \\ **Passage Ends** \\
Line 375: Line 422:
  
 **Man made, Equipment**\\ **Man made, Equipment**\\
 +''__point alter__'' [SBE]\\
 ''__point anchor__'' \\ ''__point anchor__'' \\
 +''__point archeo-excavation__'' [SBE]\\
 ''__point archeo-material__'' \\ ''__point archeo-material__'' \\
 +''__point audio__'' [SBE]\\
 ''__point bridge__'' \\ ''__point bridge__'' \\
 ''__point camp__'' \\ ''__point camp__'' \\
 +''__point electric-light__'' [SBE]\\
 +''__point ex-voto__'' [SBE]\\
 ''__point fixed-ladder__'' \\ ''__point fixed-ladder__'' \\
 +''__point gate__'' [SBE]\\
 +''__point handrail__'' \\
 +''__point masonry__'' [SBE]\\
 +''__point nameplate__'' [SBE]\\
 ''__point no-equipment__'' \\ ''__point no-equipment__'' \\
 +''__point photo__'' [SBE]\\
 ''__point rope-ladder__'' \\ ''__point rope-ladder__'' \\
 ''__point rope__'' \\ ''__point rope__'' \\
 ''__point steps__'' \\ ''__point steps__'' \\
 ''__point traverse__'' \\ ''__point traverse__'' \\
 +''__point via-ferrata__'' \\
 +''__point walkway__'' [SBE]\\
 +''__point wheelchair__'' [SBE]\\
 +''__point no-wheelchair__'' [SBE]\\
 ===== lines ===== ===== 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. \\ **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. \\
Line 393: Line 454:
  
 **Labels** \\ **Labels** \\
-''__line arrow__ # -head both -head none -head begin'' \\+''__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.\\ 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 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). \\
Line 409: Line 470:
 **Passages** \\ **Passages** \\
 ''__[[drawingchecklist#wall|line wall]]__''  \\ ''__[[drawingchecklist#wall|line wall]]__''  \\
 +''__line abyss-entrance__'' [SBE]\\
 +''__line dripline__'' [SBE]\\
 ''__line floor-step__'' \\ ''__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 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 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 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 <none|center>'' ## to specify no tick marks, at centre only,eg ''__line contour__ # -gradient <none|center>'' ## to specify no tick marks, at centre only,eg
Line 441: Line 505:
 ''__line ceiling-meander__'' \\ ''__line ceiling-meander__'' \\
 ''__line overhang__'' \\ ''__line overhang__'' \\
-\\+ 
 +''__line fault__'' [SBE]\\ 
 +''__line joint__'' [SBE]\\ 
 **Passage Fills** \\ **Passage Fills** \\
  
 ''__line border__ # border:invisible  border:visible border:temporary border:presumed'' \\ ''__line border__ # border:invisible  border:visible border:temporary border:presumed'' \\
-''__line moon-milk__''\\+''__line rimstone-dam__'' [SBE]\\ 
 +''__line rimstone-pool__'' [SBE]\\ 
 +''__line moon-milk__'' \\
 ''__line rock-border__'' ## //See the [[drawingchecklist#wall|yellow tick advice]] above// \\ ''__line rock-border__'' ## //See the [[drawingchecklist#wall|yellow tick advice]] above// \\
 ''__line rock-edge__'' ## internal edge of large boulder \\ ''__line rock-edge__'' ## internal edge of large boulder \\
 ''__line water-flow__ # water-flow:conjectural water-flow:intermittent'' \\ ''__line water-flow__ # water-flow:conjectural water-flow:intermittent'' \\
 ''__line flowstone__''  ## tick on down slope side\\ ''__line flowstone__''  ## tick on down slope side\\
 +''__line low-ceiling__'' [SBE]\\
 +''__line pit-chimney__'' [SBE]\\
 \\ \\
 **Man made, Equipment** \\ **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. ''__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. This line type detects whether it is drawn in elevation or in plan, and plots appropriately.
Line 461: Line 535:
   line xxxx -scale <number> ## 1.0 ≡ medium symbol size, for all point and line symbols #5.4.1 <need to verify syntax>   line xxxx -scale <number> ## 1.0 ≡ medium symbol size, for all point and line symbols #5.4.1 <need to verify syntax>
  
 +''__line via-ferrata__'' \\
 +''__line walkway__'' [SBE]\\
 ===== areas ===== ===== areas =====
 **Workflow to create a new area with XTherion;** \\ **Workflow to create a new area with XTherion;** \\
Line 486: Line 562:
 ''__area debris__''  # < ~2m? \\ ''__area debris__''  # < ~2m? \\
 ''__area blocks__''  # more than ~2m?\\ ''__area blocks__''  # more than ~2m?\\
 +\\
 +''__area mudcrack__'' [SBE]\\
 ''__area flowstone__'' \\ ''__area flowstone__'' \\
 ''__area moonmilk__'' \\ ''__area moonmilk__'' \\
 +\\
 +''__area pillar__'' [SBE]\\
 +''__area pillar-with-curtains__'' [SBE]\\
 +''__area stalactite__'' [SBE]\\
 +''__area stalactite-stalagmite__'' [SBE]\\
 +''__area stalagmite__'' [SBE]\\
 +\\
 ''__area ice__'' \\ ''__area ice__'' \\
 ''__area snow__'' ''__area snow__''
  • drawingchecklist.1545527489.txt.gz
  • Last modified: 5 years ago
  • by brucemutton