CONTRS : Contour a map

LEVELS contour levels specification
lintyp assignment of line types to contour levels
dash specification of dashed line dash-gap sequence
dot specification of dotted line dash-gap sequence
color specify contour colors

CONTRS Option Code Arg   Def
  type of input to expect fourr   input from mapfile  
    slant   input from slafile  
  vector scale factor scal n   1.0
  first layer to contour flayer n   origin from bdf
  last layer to contour llayer n   max. from bdf
  increment between layers dlayer n   incr. from bdf
  superimpose layers super   yes  
  interpolation type cubic   cubic interpolation  
    linear   linear interpolation  
  curve smoothing smooth   smoothing on curves  
    nsmooth   no smoothing  
  resolution for smoothing resol n   0.10
  mesh points as crosses mesh   yes  
  plot border of map border   plot border  
    nborder   do not plot border  
  plot atoms near plane atoms n distance n from plane  
  plot atom names nnames   do not plot names  
  off plane atoms dist   plot italic distances  
  draw the atomic bonds draw      
  rotate map 90 degrees rotate   rotate clockwise  
  vector function plot [a] mod   modulus of vector  
    vect   3-component vector  
  contour filling filled   switch on [b] [c]  

[a] Note that these function require input from a sla file.

[b] Contour filling is currently very, very rudimentary. The The zero level is a baseline and contours are filled downwards to -ive and then upwards to +ive. The upshot is that for re-entrant contour levels the contour will (a) be filled one color in the wrong direction and (b) be overwritten by the nearest local maxima/minima of the reentrant curve portion. You have been warned!

[c] Contour filling will not be apparent unless PLOTX or PREVUE are invoked with the "color fill" option.

LEVELS Option Code Arg    
  type of contour [a] arith   arithmetic intervals  
    geom   geometric intervals  
    direct   explicit levels input  
  number of contours [a] [b] nc n number of contours  
  starting contour level [b] start n first level  
  level incr. ratio [b] incr n increment (max 90)  
  include levels of -ve sign nnegate   do not include  
    negate   include  
  include zero level nzincl   do not include  
    zincl   include  

[a] These items are mandatory.

[b] Codes nc , start , and incr are not allowed for the direct option - follow the direct flag on the input line with the levels desired. The levels line can function in a cumulative manner for the direct option. The negate and zincl operations are not performed until all line input is complete.

lintyp Option Code Arg   Def
  dashed line [a] dashed n m    
  dotted lines dotted n m    
  solid line solid n m    

[a] The n is the first line and m the last line to be assigned to this type. Both n and m must be input. The lines are assigned sequentially. Options can be input in any order and in any combination of line types.

dash [a] 1 number of elements in the dash-gap sequence  
  2 first dash length  
  3 first gap length  
  4 second dash length  
  5 second gap length  

[a] A maximum of 10 elements is allowed. The lengths are relative to a y-dimension (down the page) of 10 units.

dot 1- same format as the dash line but applies to dotted line types  

color 1 temperature spectrum color scale temp    
    hue, saturation=1.0, brightness=1.0 hue    
    greyscale color scheme grey    
  2 Lower color limit     0.0
  3 Upper color limit     1.0
  4 fixed color for Zero contour level     auto
    or      
  1 explicit RGB entries in following fields RGB    
  2 - one color per contour level in hexadecimal notation      
    black=000000, red=FF0000, green=00FF00, blue=0000FF