Code Processing

This option is describes how point codes are be used to create strings and assign symbols to points, with optional scaling of the symbol.
This can be used for scalable symbols such as trees etc.

Code Library

During Form Strings by Code Library or Field Obs Session Reduction or Old Field Observation Reduction or Import ASCII File the following processing can optionally be done:


Point Code Format

The general format of the point code is
   CodeValue + FunctionIndicator - Remarks
A + sign is used to start the Function Indicator,
A - sign is used to start the Remark.
You must have a Code Value must be present, either of the other two are optional.

Examples:



Function Indicator

FieldContents
CnnCanopy diameter or spread for a tree (used to scale the size of displayed symbol).
Those with nn (Cnn) should be followed by a number (C6.5 = Canopy size = 6.5 meters)
Point Attributes: You can use a Point attribute to do the scaling. Add a point Attribute 'Canopy', with a value (scale value). Now setup your config XML file with (scale_attr="Canopy") for a point.
DnnDiameter of tree trunk, information only - not used by program.
HnnHeight of tree, information only - not used by program
XnnnObservation is check shot to point nnn.
GSize and rotate symbol by next 2 shots.
This shot and next 2 shots are used to scale and orient the symbol.
Usually used for comms pits to scale and orient the symbol to the pit
NPoint is to be non contourable
RPoint is to have height removed during processing
KClose string to start point.
If a function indicator K is on the last point in the string the string will be closed.
TUse next point number for orientation of symbol.
Take 2 shots, the first shot st the centre of the symbol with this function indicator,
the second shot away from the symbol, the symbol will be oriented towards the second point.
OOrientation of the symbol. Enter the bearing of the symbol.
e.g. for 220 degrees symbol enter 'O220'
UChange the point Height by ADDING the supplied value to the height.
Enter the height above ground/staff level to be added to the point height.
This option can be used to take an observation at ground level,
but add the height of the item actually being measured.
e.g. for 1.25 metres enter 'U1.25'
ZChange the point Height by SUBTRACTING the supplied value from the height.
Enter the depth below ground/staff level to be subtracted from the point height.
This option can be used to take an observation at ground level,
but subtract the depth of the item actually being measured.
e.g. for 0.9 metres enter 'Z0.9'

Trees

A typical tree code is as follows:
   TR+H9C6D500
Where
   TR is the code to indicate a tree
   + indicates the rest of the string may hold parameters, [Must be present]
   H9 = Height of tree is 9 metres
   C6 = Canopy diameter 9 metres
   D500 = Diameter of Trunk of tree is 0.5 metres

The same tree code can also be written as:
   TR+H9.5C6.1D.5
   TR+H9,C6,D500    Optionally, commas can be used between the values.
   TR+H=9,C=6,D=500    Equal signs are allowed for readability.
   TR+H9000,C6000D0.5
The height, canopy and diameter values can be written as decimal numbers. Any number larger than 99 is assumed to be in mm rather than metres.

The values can be in any order.
   TR+D500H9C6
   TR+C6D500T4

The code 'TR' is associated with a particular symbol, thus different tree types (Gum, Pine) can use different codes/symbols.

The Canopy size value is used to draw the symbol at a size so that it is drawn to scale (at the selected job plot scale).

Comms Pits

A typical Pit code is as follows:
   COM1+G
Where
   COM is the code to indicate a pit
   1 is the string number (if strung)    + is the action code, actions follow
   G = The two following shots will be used to scale and orient the symbol
Notes: When the following two shots are used, it does not check that they form a right angle.
   Dist from pt2-pt3 is the Symbol Size (width)
   Dist from pt1-pt2 is the Symbol Y Size (length)
   Bearing from pt1-pt2 is the Symbol Bearing/Angle
Note: This option always ticks the 'Symbol Size in Metres' attribute for the point.

The same pit code can also be written as:
   COM1+G400x800x45
   COM1+G = Pit indicator, action code and G to define size and orientation of the pit
   400 = width of pit, in mm or metres, X co-ord
   800 = length of pit, in mm or metres, Y co-ord
   45 = bearing of pit, the pit will be rotated by 45 degrees clockwise
   If no bearing is entered, the bearing will be 0 (North).



Symbols - Definition

See the Symbolisation for details of the standard symbols and how to define your own symbols.
The symbols can be defined at the bottom of the strings definition file or in a separate file.