examples

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
examples [2018/01/06 22:19] – [Colour Scales - Lookups] part 3 brucemuttonexamples [2023/12/03 07:41] (current) – Document select map -colour behaviour brucemutton
Line 105: Line 105:
   code metapost   code metapost
      
-  def l_survey_cave (expr p) = +    def l_survey_cave (expr P) = 
-    draw p withpen PenD withcolor (0.1,0.3,0.1); +      T:=identity; 
-  enddef;+      pair zz[]; 
 +      pickup PenC; 
 +      for t = 0 upto length P - 1: 
 +        zz1 := point t of P; 
 +        zz2 := point t+1 of P; 
 +        draw zz1 -- zz2 withcolor (0.1,0.3,0.1); 
 +      endfor; 
 +    enddef;
  
 [[:therion:example_08a|{{therion:cave_08_mini.png}}]] //Click on image to see the full resolution file// [[:therion:example_08a|{{therion:cave_08_mini.png}}]] //Click on image to see the full resolution file//
Line 143: Line 150:
     statistics topo-length off #on     statistics topo-length off #on
     statistics explo-length off #on     statistics explo-length off #on
-   +    
-    #code metapost +
-    #def l_survey_cave (expr p) = +
-      #draw p withpen PenD withcolor (0.5,0.3,0.3); +
-    #enddef; +
-  +
   endlayout   endlayout
      
Line 173: Line 175:
     code metapost     code metapost
      
-    def l_survey_cave (expr p) = +    def l_survey_cave (expr P) = 
-      draw p withpen PenD withcolor (0.5,0.3,0.3);+      T:=identity; 
 +      pair zz[]; 
 +      pickup PenC; 
 +      for t = 0 upto length P - 1: 
 +        zz1 := point t of P; 
 +        zz2 := point t+1 of P; 
 +        draw zz1 -- zz2 withcolor (0.5,0.3,0.3); 
 +      endfor;
     enddef;     enddef;
          
Line 197: Line 206:
     code metapost     code metapost
      
-    def l_survey_cave (expr p) = +  def l_survey_cave (expr P) = 
-      draw p withpen PenD withcolor (0.5,0.3,0.3); +    T:=identity; 
-    enddef;+    pair zz[]; 
 +    pickup PenC; 
 +    for t = 0 upto length P - 1: 
 +      zz1 := point t of P; 
 +      zz2 := point t+1 of P; 
 +      draw zz1 -- zz2 withcolor (0.5,0.3,0.3); 
 +    endfor; 
 +  enddef;
          
   endlayout   endlayout
Line 230: Line 246:
     code metapost     code metapost
      
-    def l_survey_cave (expr p) = +    def l_survey_cave (expr P) = 
-      draw p withpen PenD withcolor (0,0,1);+      T:=identity; 
 +      pair zz[]; 
 +      pickup PenC; 
 +      for t = 0 upto length P - 1: 
 +        zz1 := point t of P; 
 +        zz2 := point t+1 of P; 
 +        draw zz1 -- zz2 withcolor (0,0,1); 
 +      endfor;
     enddef;     enddef;
      
Line 272: Line 295:
   code metapost   code metapost
      
-  def l_survey_cave (expr p) = +    def l_survey_cave (expr P) = 
-    draw p withpen PenD withcolor (0,0,1); +      T:=identity; 
-  enddef;+      pair zz[]; 
 +      pickup PenC; 
 +      for t = 0 upto length P - 1: 
 +        zz1 := point t of P; 
 +        zz2 := point t+1 of P; 
 +        draw zz1 -- zz2 withcolor (0,0,1); 
 +      endfor; 
 +    enddef;
      
   endlayout   endlayout
Line 353: Line 383:
 [[http://cachtice.speleo.sk/mapa_cj/template.html|{{therion:cj_icon.gif}}]] //Click on picture to see original size// [[http://cachtice.speleo.sk/mapa_cj/template.html|{{therion:cj_icon.gif}}]] //Click on picture to see original size//
 ---- ----
-=====Colour Scales - Lookups===== +=====Colour Palette Scales - Lookups===== 
-Therion Development 5.4.1+4369eea (late 2017) introduced a new concept, lookups, to control colour graduation for map and atlas outputs.+Therion 5.4.2 (8 Jan 2019) introduced a new concept, lookups, to create and control collections of map-foreground colour palettes for map and atlas outputs.  Lookups can define the text and appearance of 'colour legends'.
  
-[[https://www.mail-archive.com/therion@speleo.sk/msg06798.html|Original forum post advising of this change]]+[[https://www.mail-archive.com/therion@speleo.sk/msg06798.html|Original forum post advising of this change to the development release Nov 2017]]
  
 Whether or not you use lookups, you can specify the parameter that is depicted in colouring of 2D outputs. Whether or not you use lookups, you can specify the parameter that is depicted in colouring of 2D outputs.
Line 391: Line 421:
 They take the form... They take the form...
   lookup [altitude | explo-date | topo-date | map | scrap][:index] [-title "custom title text"]   lookup [altitude | explo-date | topo-date | map | scrap][:index] [-title "custom title text"]
-   # now list parameters, optional colours, optional text overides to appear in each legend entry, as in the examples below+   # now list parameters, optional colours, optional text overides to appear in each legend entry,  
 +   # as in the examples below.  the parameter listings take the general form... 
 +    
 +   <parameter(s)> [colour] ["text"] 
 +    
 +   # do not specify any colours if you want Therion to use it's default colour palette, just use  
 +   # empty brackets, [], in place of a colour specification, if you want to specify text for a particular parameter. 
 +   
   endlookup   endlookup
  
 **lookup altitude examples** **lookup altitude examples**
 +
 +The default automatic altitude colour bands take their highest and lowest values from the highest and lowest survey stations for the parts of the survey that are used in the rendering. It takes all the survey stations within the "cave" (ie. not in a "flags surface" section), from whichever surveys and subsurveys are going to be used in the rendering (if you are using a map, it will be whichever surveys and subsurveys have some of their parts included in that map), and finds the highest and lowest station. This happens even if the highest and lowest stations within those surveys are not even rendered because they are not included in a scrap.
 +
 +The legend will then be divided up into 7 numbers; the highest station, the lowest station, and 5 equally spaced values in between. These values are then rounded to the nearest integer when rendering (this rounding will also happen when displaying legend lookup values). This makes it quite possible that no scrap will ever be the colour of the highest and lowest stations, since scraps normally have more than one station in them, and the scrap altitude and colour will be taken from the average of those. The colour, as with lookup colours, will be faded the appropriate distance between the nearest colour values on either side.
 +
 +This also means that for a cave with very little vertical range, the default legend may show "10, 10, 11, 11, 11, 12, 12", when in actual fact, the numbers are all part way between 10 and 12.
 +
 +Using a lookup table allows you to take much more control, giving neater colour intervals (like one colour every 10 metres), or allowing the highest and lowest scraps to actually be the top and bottom colours.
  
   lookup altitude -title "Altitude legend"   lookup altitude -title "Altitude legend"
Line 405: Line 450:
   endlookup   endlookup
  
-It should generate red -> blue scale with desired values. +It should generate red -> blue scale with desired values. Note that this is a linear fade with red at one end, blue at the other, and purple in the middle; it does **not** rotate the hue via orange, yellow or green in the middle.
  
 You may specify multiple lookup tables for same criterion using an index, ie  ":" separator in label You may specify multiple lookup tables for same criterion using an index, ie  ":" separator in label
Line 427: Line 472:
   color map-fg altitude:scale2   color map-fg altitude:scale2
  
-Also intervals should work:+Also intervals, or bands, should work:
  
-  lookup altitude +  lookup altitude:banded 
-   [1500 1600] [] "cave floor 1"+   [1500 1600] [] "cave floor 1" #If the text is omitted, then the default will display the range, ie 1600 m - 1500 m
    [1800 1900] [] "cave floor 2"    [1800 1900] [] "cave floor 2"
   endlookup   endlookup
 +This will produce a single colour for passage between 1500 and 1600 m and between 1800 and 1900 m, and leave all other passage, above, in between, and below, uncoloured.
  
 +The default altitude rainbow is not made with a continuous range of colour hues. Instead, it is made with 7 discrete colours, with altitudes between them fading between the discrete colours. This means that you can use a lookup table to exactly replicate this colour behaviour, using the following colour values which match the default ones used by Therion (shown here within the range of altitudes from 4 to 96 metres):
 +
 +  lookup altitude:manualrainbow
 +    96 [100 25 25]
 +    81 [100 87.25 25]
 +    65 [49.75 100 25]
 +    50 [25 100 61.75]
 +    35 [25 74.5 100]
 +    20 [37 25 100]
 +    4 [99.25 25 100]
 +  endlookup
  
 **lookup date examples** **lookup date examples**
Line 455: Line 512:
 Same should work with scraps.  Same should work with scraps. 
  
-With maps you may specify colour of a particular map when selecting it your thconfig, without the need for a lookup+**Specifying individual map colours at compile time** 
 + 
 +With maps you may specify colour of a particular map when selecting it in your thconfig, overriding or without the need for any layout or lookup statements 
 + 
 +  select map1 -colour [100 0 0] 
 +   
 +The Therion Book 6.1.7 suggests that map command-like options include colour, however this seems to be incorrect.  The -colour option seems to be a select parameter (not a map parameter) and can be described like this... 
 + 
 +**‘select’** 
 + 
 +Description: selects objects (surveys and maps) for export… 
 + 
 +Options: 
 +… 
 + 
 +• colo[u]r <colour>  set the map colour when selecting a map; this option overrides the specified colour palette ONLY when the layout specifies colour map-fg [map], [scrap] or [<colour>].  It has no effect when the layout specifies colour map-fg [altitude].  It has no effect when the layout specifies colour map-fg [topo-date] or [explo-date], for the scraps whose associated surveys have dates assigned. 
 + 
 +In summary: 
 + 
 +Select map -colour overrides layout or lookup colour map-fg statements when… 
 + 
 +  * colour map-fg [r g b] 
 +  * colour map-fg scrap 
 +  * colour map-fg map 
 + 
 +Select map -colour does not override layout or lookup colour map-fg statements when…
  
-  select map1 -color [100 0 0]  # This does not work for me.  Bruce +  * colour map-fg altitude 
-Make sure you don't have any 'colour map-fg' statements however, as if present they will override [I THINK]+  * colour map-fg topo-date, unless the map has no date 
 +  * colour map-fg explo-date, unless the map has no date
  
  
  • examples.1515273579.txt.gz
  • Last modified: 7 years ago
  • by brucemutton