THIS 22.1
Creating Datum Definitions
Creating Datum Definitions
The following options can be used to setup DATUM definitions
| keyword | second word | notes |
| start datum | Starts a Datum definition | |
| acronym | acronym | Specifies the datum acronym |
| label | label | Specifies the datum label |
| label | 2nd label | Specifies the label for the optional second constant datum line |
| type | constant_x | Defines the datum as a constant x value |
| constant_y | Defines the datum as a constant y value | |
| constant_y2 | Defines the datum as a constant y2 value | |
| Points | Defined the datum as a set of x,y points | |
| value | value | Specifies the value for a constant x, y or y2 datum |
| 2nd value | 2nd value | Specifies the optional second value for a constant x, y or y2 datum |
| num_points |
#points
x1,y1 y2,y2 |
Specifies the number of points used to define a datum, followed by pairs of x,y values. |
| line_colour | colour (see Line Colours ) | Specify the line colour used to display the datum line (or none) |
| line_style | style (see Setting Curve Styles | Specifies the line style used to display the datum line (or none) |
| line_width | width (see Line Width | Specifies the line width used to display the datum line (or none) |
| fill_colour1 | colour (see Line Colours ) | Defines the colour used to fill above/right of the datum line |
| fill_colour2 | colour (see Line Colours ) | Defines the colour used to fill below/left of the datum line |
| fill_colour3 | colour (see Line Colours ) | Defines the colour used to fill between the two constant datum lines if a second value is present |
| label_font | Define the font used to display the label | |
| label_size | 8,10,12,14,18,24 | Define the font point size used to display the label |
| label_colour | colour (see Line Colours ) | Define the colour used to display the label |
| label_position | Above Centre | Position label at centre above line |
| Above Left | Position label on left above line | |
| Above Right | Position label on right above line | |
| Below Centre | Position label at centre below line | |
| Below Left | Position label on left below line | |
| Below Right | Position label on right below line | |
| None | Turn off label display | |
| Middle Left | Position label on left in middle | |
| Top Left | Position label on left at top | |
| Bottom Left | Position label on left at bottom | |
| Middle Right | Position label on right in middle | |
| Top Right | Position label on right at top | |
| Bottom Right | Position label on right in middle | |
| label_orientation | Horizontal or Vertical | Orientation of the datum label(s) |
| label_point | point number | Position label at datum point |
| end_datum | Ends a Datum definition. |
Each DATUM definition must start with a "start_datum" keyword and end with a "end_datum" keyword. Any lines between a "start_datum" and "end_datum" keyword that do not form part of a datum definition are ignored. From T/HIS 17.0 onwards, FAST-TCF variables defined by "define var name value " can be used inside DATUM defitions.
The following creates a DATUM definition at Y=1000.0 with a label "Hic Limit", the area below the line is filled in GREEN and the area above is filled in RED.
START_DATUM
ACRONYM datum_1
LABEL Hic Limit
TYPE constant_y
VALUE 1000.000000
LINE_COLOUR green
LINE_STYLE solid
LINE_WIDTH normal
FILL_COLOUR_1 red
FILL_COLOUR_2 green
LABEL_FONT default
LABEL_SIZE automatic
LABEL_COLOUR foreground
LABEL_POSITION default
LABEL_ORIENTATION Horizontal
END_DATUM
Alternatively a *.dtm file can be read in using the 'inc' keyword, e.g.
inc C:\my_datum_file.dtm