--------------------------------------------------------------------------------
MODULE TRIANG

--------------------------------------------------------------------------------
REPLACES PANACEA module PANIC

--------------------------------------------------------------------------------

FUNCTION

--------------------------------------------------------------------------------

FORMAT

--------------------------------------------------------------------------------

COMMAND QUALIFIERS

--------------------------------------------------------------------------------

DESCRIPTION

GENERAL

--------------------------------------------------------------------------------

OUTPUT DATA FILES

--------------------------------------------------------------------------------

INPUT DATA FILES

--------------------------------------------------------------------------------

TRIANGULATION CONSTRAINT

--------------------------------------------------------------------------------

CLIFFS

--------------------------------------------------------------------------------

TRIANG AND INPUT FROM DTI FILES

--------------------------------------------------------------------------------

EDGE MATCHING

-------------------------------------------------------------------------------

OBLIGATORY COMMAND SEQUENCE


WINDOW 'real' 'real' 'real' 'real' ! define area of triangulation
ZLIMITS 'real' 'real'              ! specifies the Z-range of the data
MAXPOINTS 'integer'                ! specifies approx. number of points
FILEOUT 'file-spec'                ! create and open output files 
FILEIN  'file-spec'                ! input data (default IFF)
GO                                 ! triangulate it

--------------------------------------------------------------------------------

TRIANG COMMANDS

_@ COMMAND

--------------------------------------------------------------------------------
_@

--------------------------------------------------------------------------------
FORMAT: _@file-spec<CR>

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

TRIANG offers the facility of command input from an indirect command file. The '@' character preceding a file-spec will cause TRIANG to open and read commands from the specified file until:

Nested command files are not supported (i.e. a command file containing an '@' command), although sequential '@' commands are supported when read from SYS$COMMAND.

As an aid to batch log interpretation TRIANG will echo all commands read from an indirect command file.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the _@ command:

*** WARNING *** "@" must precede a file-spec

*** WARNING *** Indirect file error - returning to terminal input

*** ERROR *** Can't open indirect command file 'file-spec'

--------------------------------------------------------------------------------
Examples:


$ TRIANG<CR>
DTMCREATE module TRIANG of 13:30:39 20-AUG-87
TRIANG> @FLOW2<CR>
TRIANG> ENABLE DIAGNOSTICS
TRIANG> FRT FLOW2
FRT file LSL$FRT:FLOW2.FRT;8 opened for read
TRIANG> ASSIGN CLIFF_FC OUTCROPS,7,COAST
TRIANG> RETURN
TRIANG>

_! COMMAND

--------------------------------------------------------------------------------
_!

--------------------------------------------------------------------------------
FORMAT: _! [comment text]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

An exclamation mark is the standard DTMCREATE package comment delimiter. All text (and numbers) which lie to the right of a '!' character are excluded from command interpretation. Comments are useful for annotating command procedures used in batch processing etc_.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


_$ TRIANG<CR>
DTMCREATE module TRIANG of 13:53:27 3-FEB-89
TRIANG> _! a comment for the sake of it<CR>
TRIANG> WINDOW 0.0 0.0 900.0 900.0<CR>
TRIANG> MAXPOINTS 23000<CR>
TRIANG> ZLIMITS 0.0 1290.0 ! limits are in metres<CR>
TRIANG> FILEOUT TEST3<CR>
_.DTA file DUA3:[DEMONSTRATION]TEST3_.DTA;6 opened for write
_.NOD file DUA3:[DEMONSTRATION]TEST3_.NOD;6 opened for write
TRIANG> FILEIN JOE.IFF! get the first IFF file<CR>
IFF file LSL$IF:JOE.IFF;0 opened for read
TRIANG> ! do the triangulation<CR>
TRIANG> GO<CR>
ELAPSED: 00:05:25.84 CPU: 0:00:05.71 BUFIO: 281 DIRIO: 46 FAULTS: 263

ASSIGN BREAKLINE_FC COMMAND

--------------------------------------------------------------------------------
ASSIGN BREAKLINE_FC

--------------------------------------------------------------------------------
FORMAT: ASSIGN BREAKLINE_FC feature-code[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The ASSIGN BREAKLINE_FC command complements the DEASSIGN BREAKLINE_FC command. ASSIGN BREAKLINE_FC enables the user to specify the feature codes of IFF features which are to be treated as breaklines when included in the triangulation.

By default no feature codes are assigned for breaklines, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation. Explicit IFF layer or feature codes may be removed from a assignment list by use of the appropriate DEASSIGN command.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the ASSIGN BREAKLINE_FC command:

*** WARNING *** You must have read an FRT file to be able to use group names
*** WARNING *** No groups have been defined in the FRT
*** WARNING *** Illegal feature code 'integer'
*** WARNING *** Bad group name 'group-name'

--------------------------------------------------------------------------------
Examples:


TRIANG> ASSIGN BREAKLINE_FC 6:9,WATER,126<CR>
TRIANG>

ASSIGN BREAKLINE_LAYER COMMAND

--------------------------------------------------------------------------------
ASSIGN BREAKLINE_LAYER

--------------------------------------------------------------------------------
FORMAT: ASSIGN BREAKLINE_LAYER layer[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The ASSIGN BREAKLINE_LAYER command complements the DEASSIGN BREAKLINE_LAYER command. The ASSIGN BREAKLINE_LAYER command enables the user to specify the IFF layer numbers containing features which are to be treated as breaklines when included in the triangulation.

By default no layers are assigned for breaklines, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation. Explicit IFF layer or feature codes may be removed from a assignment list by use of the appropriate DEASSIGN command.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the ASSIGN BREAKLINE_LAYER command:

*** WARNING *** Too many layer arguments in one command
*** WARNING *** Illegal layer number 'integer'

--------------------------------------------------------------------------------
Examples:


TRIANG> ASSIGN BREAKLINE_LAYER 21:29,126<CR>
TRIANG>

ASSIGN CLIFF_FC COMMAND

--------------------------------------------------------------------------------
ASSIGN CLIFF_FC

--------------------------------------------------------------------------------
FORMAT: ASSIGN CLIFF_FC feature-code[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The ASSIGN CLIFF_FC command complements the DEASSIGN CLIFF_FC command. The ASSIGN CLIFF_FC command enables the user to specify the feature codes of IFF features which are to be treated as cliffs when included in the triangulation.

For information about digitising and the internal treatment of clifflines, see the main Description section above.

By default no feature codes are assigned for breaklines, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation. Explicit IFF layer or feature codes may be removed from a assignment list by use of the appropriate DEASSIGN command.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the ASSIGN CLIFF_FC command:

*** WARNING *** You must have read an FRT file to be able to use group names
*** WARNING *** No groups have been defined in the FRT
*** WARNING *** Illegal feature code 'integer'
*** WARNING *** Bad group name 'group-name'

--------------------------------------------------------------------------------
Examples:


TRIANG> ASSIGN CLIFF_FC 6:9,WATER,126<CR>
TRIANG>

ASSIGN CLIFF_LAYER COMMAND

--------------------------------------------------------------------------------
ASSIGN CLIFF_LAYER

--------------------------------------------------------------------------------
FORMAT: ASSIGN CLIFF_LAYER layer[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The ASSIGN CLIFF_LAYER command complements the DEASSIGN CLIFF_LAYER command. The ASSIGN CLIFF_LAYER command enables the user to specify the IFF layer numbers containing features which are to be treated as breaklines when included in the triangulation.

For information about digitising and the internal treatment of clifflines, see the main Description section above.

By default no layers are assigned for cliffs, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation. Explicit IFF layer or feature codes may be removed from a assignment list by use of the appropriate DEASSIGN command.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the ASSIGN CLIFF_LAYER command:

*** WARNING *** Too many layer arguments in one command
*** WARNING *** Illegal layer number 'integer'

--------------------------------------------------------------------------------
Examples:


TRIANG> ASSIGN CLIFF_LAYER 21:29,126<CR>
TRIANG>

ASSIGN RIDGE_FC COMMAND

--------------------------------------------------------------------------------
ASSIGN RIDGE_FC

--------------------------------------------------------------------------------
FORMAT: ASSIGN RIDGE_FC feature-code[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The ASSIGN RIDGE_FC command complements the DEASSIGN RIDGE_FC command. ASSIGN RIDGE_FC enables the user to specify the feature codes of IFF features which are to be treated as breaklines when included in the triangulation.

By default no feature codes are assigned for ridgelines, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation. Explicit IFF layer or feature codes may be removed from a assignment list by use of the appropriate DEASSIGN command.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the ASSIGN RIDGE_FC command:

*** WARNING *** You must have read an FRT file to be able to use group names
*** WARNING *** No groups have been defined in the FRT
*** WARNING *** Illegal feature code 'integer'
*** WARNING *** Bad group name 'group-name'

--------------------------------------------------------------------------------
Examples:


TRIANG> ASSIGN RIDGE_FC 6:9,WATER,126<CR>
TRIANG>

ASSIGN RIDGE_LAYER COMMAND

--------------------------------------------------------------------------------
ASSIGN RIDGE_LAYER

--------------------------------------------------------------------------------
FORMAT: ASSIGN RIDGE_LAYER layer[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The ASSIGN RIDGE_LAYER command complements the DEASSIGN RIDGE_LAYER command. The ASSIGN RIDGE_LAYER command enables the user to specify the IFF layer numbers containing features which are to be treated as ridgelines when included in the triangulation.

By default no layers are assigned for breaklines, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation. Explicit IFF layer or feature codes may be removed from a assignment list by use of the appropriate DEASSIGN command.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the ASSIGN RIDGE_LAYER command:

*** WARNING *** Too many layer arguments in one command
*** WARNING *** Illegal layer number 'integer'

--------------------------------------------------------------------------------
Examples:


TRIANG> ASSIGN RIDGE_LAYER 21:29,126<CR>
TRIANG>

ASSIGN RIVER_FC COMMAND

--------------------------------------------------------------------------------
ASSIGN RIVER_FC

--------------------------------------------------------------------------------
FORMAT: ASSIGN RIVER_FC feature-code[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The ASSIGN RIVER_FC command complements the DEASSIGN RIVER_FC command. ASSIGN RIVER_FC enables the user to specify the feature codes of IFF features which are to be treated as breaklines when included in the triangulation.

By default no feature codes are assigned for cliffs, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation. Explicit IFF layer or feature codes may be removed from a assignment list by use of the appropriate DEASSIGN command.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the ASSIGN FC command:

*** WARNING *** You must have read an FRT file to be able to use group names
*** WARNING *** No groups have been defined in the FRT
*** WARNING *** Illegal feature code 'integer'
*** WARNING *** Bad group name 'group-name'

--------------------------------------------------------------------------------
Examples:


TRIANG> ASSIGN RIVER_FC 6:9,WATER,126<CR>
TRIANG>

ASSIGN RIVER_LAYER COMMAND

--------------------------------------------------------------------------------
ASSIGN RIVER_LAYER

--------------------------------------------------------------------------------
FORMAT: ASSIGN RIVER_LAYER layer[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The ASSIGN RIVER_LAYER command complements the DEASSIGN RIVER_LAYER command. The ASSIGN RIVER_LAYER command enables the user to specify the IFF layer numbers containing features which are to be treated as breaklines when included in the triangulation.

By default no layers are assigned for breaklines, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation. Explicit IFF layer or feature codes may be removed from a assignment list by use of the appropriate DEASSIGN command.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the ASSIGN RIVER_LAYER command:

*** WARNING *** Too many layer arguments in one command
*** WARNING *** Illegal layer number 'integer'

--------------------------------------------------------------------------------
Examples:


TRIANG> ASSIGN RIVER_LAYER 21:29,126<CR>
TRIANG>

DATUM COMMAND

--------------------------------------------------------------------------------
DATUM

--------------------------------------------------------------------------------
FORMAT: DATUM value

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DATUM command enables specification of a height datum to be added to IFF and DTI heights read using subsequent FILEIN commands.

On program statup a DATUM default value of 0.0 is assumed.

Height information within a single IFF file may be stored relative to different height data providing that the features pertaining to each height datum can be distinguished by feature code or layer. The DATUM command can be used to set the height datum for a subsequent FILEIN command. If required a single IFF file may be read in many times relative to different height data, feature selection being achieved by SELECT FC and SELECT LAYER commands.

If the DATUM command is specified prior to reading a DTI file (using the FORMAT DTI and FILEIN commands), the datum change is applied to all posts within the DTI file.

If the INVERSE command has been used to specify height inversion the heights are inverted before the datum value is added.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the DATUM command:


*** ERROR *** You must specify a floating point argument to the DATUM command
*** WARNING *** You must specify a floating point argument to the DATUM command

--------------------------------------------------------------------------------
Examples:


TRIANG> DATUM 8.2<CR>
TRIANG> FILEIN HUNSTANTON_BATHEMETRY<CR> IFF file LSL$IF:HUNSTANTON_BATHEMETRY.IFF;0 opened for read +----------------------------------------------------------------+ | | | Starting pass through IFF file | | | +----------------------------------------------------------------+ There are now 671 points in the DTM area
TRIANG> DATUM 0.0<CR>
TRIANG> FILEIN ATILLA<CR> IFF file LSL$IF:ATTILA.IFF;0 opened for read +----------------------------------------------------------------+ | | | Starting pass through IFF file | | | +----------------------------------------------------------------+ There are now 55527 points in the DTM area
TRIANG>

DEASSIGN BREAKLINE_FC COMMAND

--------------------------------------------------------------------------------
DEASSIGN BREAKLINE_FC

--------------------------------------------------------------------------------
FORMAT: DEASSIGN BREAKLINE_FC feature-code[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DEASSIGN BREAKLINE_FC command complements the ASSIGN BREAKLINE_FC command. DEASSIGN BREAKLINE_FC enables the user to remove specified feature codes from the list of feature codes that have been assigned for interpretation as breaklines.

By default no feature codes are assigned for breaklines, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the DEASSIGN BREAKLINE_FC command:

*** WARNING *** You must have read an FRT file to be able to use group names
*** WARNING *** No groups have been defined in the FRT
*** WARNING *** Illegal feature code 'integer'
*** WARNING *** Bad group name 'group-name'

--------------------------------------------------------------------------------
Examples:


TRIANG> DEASSIGN BREAKLINE_FC 6:9,CLIFFS,126<CR>
TRIANG>

DEASSIGN BREAKLINE_LAYER COMMAND

--------------------------------------------------------------------------------
DEASSIGN BREAKLINE_LAYER

--------------------------------------------------------------------------------
FORMAT: DEASSIGN BREAKLINE_LAYER layer[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DEASSIGN BREAKLINE_LAYER command complements the ASSIGN BREAKLINE_LAYER command. DEASSIGN BREAKLINE_LAYER enables the user to remove specified layers from the list of layers that have been assigned for interpretation as breaklines.

By default no layers are assigned for breaklines, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the DEASSIGN BREAKLINE_LAYER command:

*** WARNING *** Too many layer arguments in one command
*** WARNING *** Illegal layer number 'integer'

--------------------------------------------------------------------------------
Examples:


TRIANG> DEASSIGN BREAKLINE_LAYER 21:29,126<CR>
TRIANG>

DEASSIGN CLIFF_FC COMMAND

--------------------------------------------------------------------------------
DEASSIGN CLIFF_FC

--------------------------------------------------------------------------------
FORMAT: DEASSIGN CLIFF_FC feature-code[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DEASSIGN CLIFF_FC command complements the ASSIGN CLIFF_FC command. DEASSIGN CLIFF_FC enables the user to remove specified feature codes from the list of feature codes that have been assigned for interpretation as cliffs.

For information about digitising and the internal treatment of clifflines, see the main Description section above.

By default no feature codes are assigned for cliffs, breaklines, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the DEASSIGN CLIFF_FC command:

*** WARNING *** You must have read an FRT file to be able to use group names
*** WARNING *** No groups have been defined in the FRT
*** WARNING *** Illegal feature code 'integer'
*** WARNING *** Bad group name 'group-name'

--------------------------------------------------------------------------------
Examples:


TRIANG> DEASSIGN CLIFF_FC 6:9,WATER,126<CR>
TRIANG>

DEASSIGN CLIFF_LAYER COMMAND

--------------------------------------------------------------------------------
DEASSIGN CLIFF_LAYER

--------------------------------------------------------------------------------
FORMAT: DEASSIGN CLIFF_LAYER layer[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DEASSIGN CLIFF_LAYER command complements the ASSIGN CLIFF_LAYER command. DEASSIGN CLIFF_LAYER enables the user to remove specified layers from the list of layers that have been assigned for interpretation as cliffs during triangulation formation.

For information about digitising and the internal treatment of clifflines, see the main Description section above.

By default no layers are assigned for cliffs, breaklines, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the DEASSIGN CLIFF_LAYER command:

*** WARNING *** Too many layer arguments in one command
*** WARNING *** Illegal layer number 'integer'

--------------------------------------------------------------------------------
Examples:


TRIANG> DEASSIGN CLIFF_LAYER 21:29,126<CR>
TRIANG>

DEASSIGN RIDGE_FC COMMAND

--------------------------------------------------------------------------------
DEASSIGN RIDGE_FC

--------------------------------------------------------------------------------
FORMAT: DEASSIGN RIDGE_FC feature-code[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DEASSIGN RIDGE_FC command complements the ASSIGN RIDGE_FC command. DEASSIGN RIDGE_FC enables the user to remove specified IFF feature codes from the list of those assigned for use as ridgelines within the triangulation.

By default no feature codes are assigned for breaklines, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the DEASSIGN FC command:

*** WARNING *** You must have read an FRT file to be able to use group names
*** WARNING *** No groups have been defined in the FRT
*** WARNING *** Illegal feature code 'integer'
*** WARNING *** Bad group name 'group-name'

--------------------------------------------------------------------------------
Examples:


TRIANG> DEASSIGN RIDGE_FC 6:9,WATER,126<CR>
TRIANG>

DEASSIGN RIDGE_LAYER COMMAND

--------------------------------------------------------------------------------
DEASSIGN RIDGE_LAYER

--------------------------------------------------------------------------------
FORMAT: DEASSIGN RIDGE_LAYER layer[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DEASSIGN RIDGE_LAYER command complements the ASSIGN RIDGE_LAYER command. DEASSIGN RIDGE_LAYER enables the user to remove specified layers from the list of layers that have been assigned for interpretation as ridgelines during triangulation formation.

By default no layers are selected for breaklines, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the DEASSIGN RIDGE_LAYER command:

*** WARNING *** Too many layer arguments in one command
*** WARNING *** Illegal layer number 'integer'

--------------------------------------------------------------------------------
Examples:


TRIANG> DEASSIGN RIDGE_LAYER 21:29,126<CR>
TRIANG>

DEASSIGN RIVER_FC COMMAND

--------------------------------------------------------------------------------
DEASSIGN RIVER_FC

--------------------------------------------------------------------------------
FORMAT: DEASSIGN RIVER_FC feature-code[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DEASSIGN RIVER_FC command complements the ASSIGN RIVER_FC command. DEASSIGN RIVER_FC enables the user to remove specified IFF feature codes from the list of those assigned for use as rivers within the triangulation.

By default no feature codes are assigned for breaklines, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the DEASSIGN FC command:

*** WARNING *** You must have read an FRT file to be able to use group names
*** WARNING *** No groups have been defined in the FRT
*** WARNING *** Illegal feature code 'integer'
*** WARNING *** Bad group name 'group-name'

--------------------------------------------------------------------------------
Examples:


TRIANG> DEASSIGN RIVER_FC 6:9,WATER,126<CR>
TRIANG>

DEASSIGN RIVER_LAYER COMMAND

--------------------------------------------------------------------------------
DEASSIGN RIVER_LAYER

--------------------------------------------------------------------------------
FORMAT: DEASSIGN RIVER_LAYER layer[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DEASSIGN RIVER_LAYER command complements the ASSIGN RIVER_LAYER command. DEASSIGN RIVER_LAYER enables the user to remove specified layers from the list of layers that have been selected for interpretation as rivers during triangulation formation.

By default no layers are assigned for breaklines, rivers etc_. and all IFF data that lie within the WINDOW bounds are included in the triangulation.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the DEASSIGN RIVER_LAYER command:

*** WARNING *** Too many layer arguments in one command
*** WARNING *** Illegal layer number 'integer'

--------------------------------------------------------------------------------
Examples:


TRIANG> DEASSIGN RIVER_LAYER 21:29,126<CR>
TRIANG>

DESELECT FC COMMAND

--------------------------------------------------------------------------------
DESELECT FC

--------------------------------------------------------------------------------
FORMAT: DESELECT FC feature-code[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DESELECT FC command complements the SELECT FC command. DESELECT FC enables the user to prevent TRIANG from reading in any IFF features which have the specified feature codes.

On program startup all FCs are selected for input.

Specific FC selections may then be made with the SELECT FC command. Only the specified FCs will be used for input. All FCs not explicitly specified in a SELECT FC command will be then excluded from input.

ALL FC and layer selections are cancelled by the SELECT ALL command; i.e. all layers and FCs are reselected for input.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the DESELECT FC command:

*** WARNING *** You must have read an FRT file to be able to use group names
*** WARNING *** No groups have been defined in the FRT
*** WARNING *** Illegal feature code 'integer'
*** WARNING *** Bad group name 'group-name'

--------------------------------------------------------------------------------
Examples:


TRIANG> DESELECT FC 6:9,WATER,126<CR>
TRIANG>

DESELECT LAYER COMMAND

--------------------------------------------------------------------------------
DESELECT LAYER

--------------------------------------------------------------------------------
FORMAT: DESELECT LAYER layer[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DESELECT LAYER command complements the SELECT LAYER command. DESELECT LAYER enables the user to prevent TRIANG from reading in any IFF features which lie within the specified layers.

The DESELECT LAYER command complements the SELECT LAYER command. DESELECT LAYER enables the user to prevent TRIANG from reading in any IFF features which lie within the specified layers.

On program startup all layers are selected for input.

Specific layer selections may then be made with the SELECT FC command. Only the specified layers will be used for input. All layers not explicitly specified in SELECT LAYER commands will be then excluded from input.

ALL FC and layer selections are cancelled by the SELECT ALL command; i.e. all layers and FCs are reselected for input.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. The use can use the SHOW SELECTIONS command to examine current input selections and SHOW ASSIGNMENTS to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the DESELECT LAYER command:

*** WARNING *** Too many layer arguments in one command
*** WARNING *** Illegal layer number 'integer'

--------------------------------------------------------------------------------
Examples:


TRIANG> DESELECT LAYER 21:29,126<CR>
TRIANG>

DISABLE CONSTRAINT COMMAND

--------------------------------------------------------------------------------
DISABLE CONSTRAINT

--------------------------------------------------------------------------------
FORMAT: DISABLE CONSTRAINT

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

TRIANG always seeks to produce a Delaunay triangulation. Unfortunately a triangulation which fits the Delaunay ideal may not necessarily honour the paths of the string input from IFF file. The constraint option ensures that triangulation never cuts through through any string features.

The CONSTRAINT option is applied by default and must be explicitly disabled with the DISABLE CONSTRAINT command if an unmodified Delaunay triangulation is required.

The current status of the CONSTRAINT option can be examined using the SHOW ENABLE command.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


$ TRIANG<CR>
DTMCREATE module TRIANG of 13:30:39 20-AUG-87
TRIANG> SHOW ENABLE<CR>

CONSTRAINT ................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... Off
GRAPHICS ..................................................... Off
INTEGER_HEIGHT ............................................... Off
(Incoming IFF heights expected in type 3 AC entries)
INVERSE ...................................................... Off
MULTIPLY ..................................................... Off
PME .......................................................... Off
SQUARE ....................................................... On
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

TRIANG> DISABLE CONSTRAINT<CR>
TRIANG> SHOW ENABLE<CR> CONSTRAINT ................................................... Off DIAGNOSTICS .................................................. Off DIVIDEBY ..................................................... OFF GRAPHICS ..................................................... Off INTEGER_HEIGHT ............................................... Off (Incoming IFF heights expected in type 3 AC entries) INVERSE ...................................................... Off MULTIPLY ..................................................... Off PME .......................................................... Off SQUARE ....................................................... On TOFEET ....................................................... Off TOMETRES ..................................................... Off
TRIANG>

DISABLE DIAGNOSTICS COMMAND

--------------------------------------------------------------------------------
DISABLE DIAGNOSTICS

--------------------------------------------------------------------------------
FORMAT: DISABLE DIAGNOSTICS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE DIAGNOSTICS allows the user to disable a previous ENABLE DIAGNOSTICS command.

The current status of the DIAGNOSTICS option can be examined using the SHOW ENABLE command.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


TRIANG> ENABLE DIAGNOSTICS<CR>
TRIANG> SHOW ENABLE<CR>

CONSTRAINT ................................................... On
DIAGNOSTICS .................................................. On
DIVIDEBY ..................................................... Off
GRAPHICS ..................................................... Off
INTEGER_HEIGHT ............................................... Off
(Incoming IFF heights expected in type 3 AC entries)
INVERSE ...................................................... Off
MULTIPLY ..................................................... Off
PME .......................................................... Off
SQUARE ....................................................... On
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

TRIANG> DISABLE DIAGNOSTICS<CR>
TRIANG> SHOW ENABLE<CR> CONSTRAINT ................................................... On DIAGNOSTICS .................................................. Off DIVIDEBY ..................................................... Off GRAPHICS ..................................................... Off INTEGER_HEIGHT ............................................... Off (Incoming IFF heights expected in type 3 AC entries) INVERSE ...................................................... Off MULTIPLY ..................................................... Off PME .......................................................... Off SQUARE ....................................................... On TOFEET ....................................................... Off TOMETRES ..................................................... Off
TRIANG>

DISABLE DIVIDEBY COMMAND

--------------------------------------------------------------------------------
DISABLE DIVIDEBY

--------------------------------------------------------------------------------
FORMAT: DISABLE DIVIDEBY

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE DIVIDEBY allows the user to disable a previous ENABLE DIVIDEBY command.

The current status of the DIVIDEBY option can be examined using the SHOW ENABLE or SHOW HEIGHTS commands.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


TRIANG> SHOW DIVIDEBY<CR>
TRIANG> SHOW ENABLE<CR>

CONSTRAINT ................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... Off
GRAPHICS ..................................................... Off
INTEGER_HEIGHT ............................................... Off
(Incoming IFF heights expected in type 3 AC entries)
INVERSE ...................................................... Off
MULTIPLY ..................................................... Off
PME .......................................................... Off
SQUARE ....................................................... On
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

TRIANG> ENABLE DIVIDEBY 39.2<CR>
TRIANG> SHOW DIVIDEBY<CR>
TRIANG> SHOW ENABLE<CR> CONSTRAINT ................................................... On DIAGNOSTICS .................................................. Off DIVIDEBY ..................................................... On Incoming heights to be divided by ............................ 39.2 GRAPHICS ..................................................... Off INTEGER_HEIGHT ............................................... Off (Incoming IFF heights expected in type 3 AC entries) INVERSE ...................................................... Off MULTIPLY ..................................................... Off PME .......................................................... Off SQUARE ....................................................... On TOFEET ....................................................... Off TOMETRES ..................................................... Off
TRIANG>

DISABLE GRAPHICS COMMAND

--------------------------------------------------------------------------------
DISABLE GRAPHICS

--------------------------------------------------------------------------------
FORMAT: DISABLE GRAPHICS

--------------------------------------------------------------------------------
Command parameter: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The DISABLE GRAPHICS command cancels the effect of a previous ENABLE GRAPHICS command.

The current status of the GRAPHICS option can be examined using the SHOW ENABLE command.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


$ TRIANG<CR>
DTMCREATE module TRIANG of 13:30:39 20-AUG-87
TRIANG> SHOW ENABLE<CR>

CONSTRAINT ................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... Off
GRAPHICS ..................................................... Off
INTEGER_HEIGHT ............................................... Off
(Incoming IFF heights expected in type 3 AC entries)
INVERSE ...................................................... Off
MULTIPLY ..................................................... Off
PME .......................................................... Off
SQUARE ....................................................... On
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

TRIANG> ENABLE GRAPHICS<CR>
TRIANG> SHOW ENABLE<CR> CONSTRAINT ................................................... On DIAGNOSTICS .................................................. Off DIVIDEBY ..................................................... Off GRAPHICS ..................................................... On INTEGER_HEIGHT ............................................... Off (Incoming IFF heights expected in type 3 AC entries) INVERSE ...................................................... Off MULTIPLY ..................................................... Off PME .......................................................... Off SQUARE ....................................................... On TOFEET ....................................................... Off TOMETRES ..................................................... Off
TRIANG>

DISABLE INTEGER_HEIGHT COMMAND

--------------------------------------------------------------------------------
DISABLE INTEGER_HEIGHT

--------------------------------------------------------------------------------
FORMAT: DISABLE INTEGER_HEIGHT

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

In IFF files height values are transmitted via AC (Ancillary Code) or ZS (3D string) entries. By default contour and spot height Z values are read from type 3 ACs as floating point values. By use of the ENABLE INTEGER_HEIGHT command, integer heights may be read from type 2 ACs.

The DISABLE INTEGER_HEIGHT command disables the effect of a previous ENABLE INTEGER_HEIGHT command and heights will be read from type 3 (floating point) ACs.

The current status of the INTEGER_HEIGHT option can be examined using the SHOW ENABLE or SHOW HEIGHTS commands.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


TRIANG> SHOW ENABLE<CR>

CONSTRAINT ................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... On
Incoming heights to be divided by ...........................   4.900 
GRAPHICS ..................................................... Off
INTEGER_HEIGHT ............................................... Off
(Incoming IFF heights expected in type 3 AC entries)
INVERSE ...................................................... Off
MULTIPLY ....................................................  Off
PME .......................................................... Off
SQUARE ....................................................... On
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

TRIANG> ENABLE INTEGER_HEIGHT<CR>
TRIANG> SHOW ENABLE<CR> CONSTRAINT ................................................... On DIAGNOSTICS .................................................. Off DIVIDEBY ..................................................... On Incoming heights to be divided by ........................... 4.900 GRAPHICS ..................................................... Off INTEGER_HEIGHT ............................................... On (Incoming IFF heights expected in type 2 AC entries) INVERSE ...................................................... Off MULTIPLY .................................................... Off PME .......................................................... Off SQUARE ....................................................... On TOFEET ....................................................... Off TOMETRES ..................................................... Off
TRIANG>

DISABLE INVERSE COMMAND

--------------------------------------------------------------------------------
DISABLE INVERSE

--------------------------------------------------------------------------------
FORMAT: DISABLE INVERSE

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE INVERSE allows the user to disable a previous ENABLE INVERSE command. By default heights are not inverted.

The current status of the INVERSE option can be examined using the SHOW ENABLE or SHOW HEIGHTS commands.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


TRIANG> ENABLE INVERSE <CR>
TRIANG> SHOW ENABLE<CR>

CONSTRAINT ................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... Off
GRAPHICS ..................................................... Off
INTEGER_HEIGHT ............................................... Off
(Incoming IFF heights expected in type 3 AC entries)
INVERSE ...................................................... On
MULTIPLY ....................................................  Off
PME .......................................................... Off
SQUARE ....................................................... On
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

TRIANG>

DISABLE MULTIPLYBY COMMAND

--------------------------------------------------------------------------------
DISABLE MULTIPLYBY

--------------------------------------------------------------------------------
FORMAT: DISABLE MULTIPLYBY

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE MULTIPLYBY allows the user to disable a previous ENABLE MULTIPLYBY command.

The current status of the MULTIPLYBY option can be examined using the SHOW ENABLE or SHOW HEIGHTS commands.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


TRIANG> ENABLE MULTIPLYBY 39.2<CR>
TRIANG>

DISABLE PME COMMAND

--------------------------------------------------------------------------------
DISABLE PME

--------------------------------------------------------------------------------
FORMAT: DISABLE PME

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The ENABLE PME and DISABLE PME commands are reserved for Laser-Scan use. PME is a code optimisation tool and should be invoked by LSL software personnel only.

DISABLE PME disables the effect of a previous ENABLE PME command and causes the PME_EXIT routine to be invoked.

The current status of the PME option can be examined using the SHOW ENABLE command.

--------------------------------------------------------------------------------
Message:

The following warning message is specific to the DISABLE PME command:

*** WARNING *** You were not using PME anyway!

--------------------------------------------------------------------------------
Examples:


$ TRIANG<CR>
DTMCREATE module TRIANG of 13:30:39 20-AUG-87
TRIANG> ENABLE PME<CR>
TRIANG> WINDOW 0. 0. 800. 760.<CR>
TRIANG> ZLIMITS 0 765<CR>
TRIANG> MAXPOINTS 78000<CR>
TRIANG> FILEOUT CHARITY<CR>
_.DTA file DUA3:[DEMONSTRATION]CHARITY_.DTA;6 opened for write
_.NOD file DUA3:[DEMONSTRATION]CHARITY_.NOD;6 opened for write
TRIANG> FRT CHASTITY<CR>
FRT file LSL$FRT:CHASTITY.FRT;8 opened for read
TRIANG> FILEIN FAITH<CR>
IFF file LSL$IF:FAITH.IFF;0 opened for read
TRIANG> ASSIGN BREAKLINE_FC 1:7,WATER,80,102<CR>
TRIANG> FILEIN ATILLA<CR>
TRIANG> DISABLE PME<CR>
TRIANG> GO<CR>
ELAPSED: 00:05:25.84 CPU: 0:00:05.71 BUFIO: 281 DIRIO: 46 FAULTS: 263
_$

DISABLE SQUARE COMMAND

--------------------------------------------------------------------------------
DISABLE SQUARE

--------------------------------------------------------------------------------
FORMAT: DISABLE SQUARE

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

By default TRIANG checks that the control points in an IFF input file are square to the map coordinate system. If the map held in the IFF file is not square to the coordinate system axes there is a danger that some rows or columns of the DTM will be missed out or be incomplete as DTMCREATE uses only axis minima and maxima to define the model area. If the IFF control point values are not square and the SQUARE option is active then an error message is issued and the run aborted.

The DISABLE SQUARE command disables the squaring test for IFF control points.

The current status of the SQUARE option can be examined using the SHOW ENABLE command.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


$ TRIANG<CR>
DTMCREATE module TRIANG of 13:30:39 20-AUG-87
TRIANG> SHOW ENABLE<CR>

CONSTRAINT ................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... Off
GRAPHICS ..................................................... Off
INTEGER_HEIGHT ............................................... Off
(Incoming IFF heights expected in type 3 AC entries)
INVERSE ...................................................... Off
MULTIPLY ....................................................  Off
PME .......................................................... Off
SQUARE ....................................................... On
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

TRIANG> DISABLE SQUARE<CR>
TRIANG>

DISABLE TOFEET COMMAND

--------------------------------------------------------------------------------
DISABLE TOFEET

--------------------------------------------------------------------------------
FORMAT: DISABLE TOFEET

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

It is possible that different input files may have heights recorded in different measurement systems. The model must be relative to one system only. Two preset height conversion options are available: ENABLE TOMETRES and ENABLE TOFEET.

The ENABLE TOFEET command enables the conversion of heights held in the IFF file in metres to feet. It has the same effect as an explicit ENABLE MULTIPLYBY 3.2808455 command. It is possible to read in one file with heights in feet with one FILEIN command and then use the ENABLE TOFEET command and read in another file with heights in metres converting to feet during read-in. The DTM will then be produced in feet.

If one of the height modification options is enabled using ENABLE MULTIPLYBY, ENABLE TOFEET etc_., you must give the ZLIMITS in the target measurement system or height range (ie feet for the ENABLE TOFEET command). Failure to do this may result in flattening of all model relief!.

N.B. DISABLE TOFEET will not cancel an explicit ENABLE MULTIPLYBY 3.2808455 command.

The current status of the TOFEET option can be examined using the SHOW ENABLE or SHOW HEIGHTS commands.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


TRIANG> ENABLE TOFEET<CR>
TRIANG>

DISABLE TOMETRES COMMAND

--------------------------------------------------------------------------------
DISABLE TOMETRES

--------------------------------------------------------------------------------
FORMAT: DISABLE TOMETRES

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

It is possible that different input files may have heights recorded in different measurement systems. The model must be relative to one system only. Two height conversion options are available: ENABLE TOFEET and ENABLE TOMETRES.

The ENABLE TOMETRES command results in the conversion of heights held in the IFF file in feet to metres. It has the same effect as an explicit ENABLE DIVIDEBY 3.2808455 command. It is possible to read in one file with heights in feet with one FILEIN command and then use the ENABLE TOMETRES command and read in another file with heights in feet converting to metres during read-in. The DTM will then be produced in metres.

If one of the height modification options is enabled using ENABLE MULTIPLYBY, ENABLE TOMETRES etc_., you must give the ZLIMITS in the target measurement system or height range (ie metres for the ENABLE TOMETRES command). Failure to do this may result in flattening of all model relief.

N.B. DISABLE TOMETRES will not cancel an explicit ENABLE DIVIDEBY 3.2808455 command.

The current status of the TOMETRES option can be examined using the SHOW ENABLE or SHOW HEIGHTS commands.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


TRIANG> ENABLE TOMETRES<CR>
TRIANG>

ENABLE CONSTRAINT COMMAND

--------------------------------------------------------------------------------
ENABLE CONSTRAINT

--------------------------------------------------------------------------------
FORMAT: ENABLE CONSTRAINT

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

TRIANG always seeks to produce a Delaunay triangulation. Unfortunately a triangulation which fits the Delaunay ideal may not necessarily honour the paths of the string input from IFF file. The constraint option ensures that triangulation never cuts through through any string features.

The CONSTRAINT option is applied by default and must be explicitly disabled with the DISABLE CONSTRAINT command if an unmodified Delaunay triangulation is required.

The current status of the CONSTRAINT option can be examined using the SHOW ENABLE command.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


$ TRIANG<CR>
DTMCREATE module TRIANG of 13:30:39 20-AUG-87
TRIANG> SHOW ENABLE<CR>

CONSTRAINT ................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... Off
GRAPHICS ..................................................... Off
INTEGER_HEIGHT ............................................... Off
(Incoming IFF heights expected in type 3 AC entries)
INVERSE ...................................................... Off
MULTIPLY ..................................................... Off
PME .......................................................... Off
SQUARE ....................................................... On
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

TRIANG> DISABLE CONSTRAINT<CR>
TRIANG> SHOW ENABLE<CR> CONSTRAINT ................................................... Off DIAGNOSTICS .................................................. Off DIVIDEBY ..................................................... Off GRAPHICS ..................................................... Off INTEGER_HEIGHT ............................................... Off (Incoming IFF heights expected in type 3 AC entries) INVERSE ...................................................... Off MULTIPLY ..................................................... Off PME .......................................................... Off SQUARE ....................................................... On TOFEET ....................................................... Off TOMETRES ..................................................... Off
TRIANG>

ENABLE DIAGNOSTICS COMMAND

--------------------------------------------------------------------------------
ENABLE DIAGNOSTICS

--------------------------------------------------------------------------------
FORMAT: ENABLE DIAGNOSTICS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE DIAGNOSTICS allows the user to enable diagnostic printout.

Because it is usually used in a batch processing environment, by default TRIANG produces minimal diagnostic printout. If however, the user wishes to receive indications of processing progress and of the effect of input data assignments and selections on data input, diagnostic printout may be selected with the ENABLE DIAGNOSTICS command.

It should be noted that if DIAGNOSTICS are enabled, TRIANG can produce voluminous printout, particularly if used during the input phase in conjunction with selections from IFF files.

On a heavily loaded computer it may be reassuring to ENABLE DIAGNOSTICS for the triangulation stage of TRIANG processing to indicate progress through the data set. If SYS$OUTPUT is directed to a video screen terminal, messages indicating percentage progress are issued.

The current status of the DIAGNOSTICS option can be examined using the SHOW ENABLE command.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


TRIANG> ENABLE DIAGNOSTICS<CR>
TRIANG> SHOW ENABLE<CR>

CONSTRAINT ................................................... On
DIAGNOSTICS .................................................. On
DIVIDEBY ..................................................... OFF
GRAPHICS ..................................................... Off
INTEGER_HEIGHT ............................................... Off
(Incoming IFF heights expected in type 3 AC entries)
INVERSE ...................................................... Off
MULTIPLY ..................................................... Off
PME .......................................................... Off
SQUARE ....................................................... On
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

TRIANG>

ENABLE DIVIDEBY COMMAND

--------------------------------------------------------------------------------
ENABLE DIVIDEBY

--------------------------------------------------------------------------------
FORMAT: ENABLE DIVIDEBY denominator

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The ENABLE DIVIDEBY enables the user to divide all incoming heights by a specified (floating point) constant. For example, the command ENABLE DIVIDEBY 2.0 will cause all incoming heights to be divided by 2.0. An ENABLE DIVIDEBY 3.2808455 command has the same effect as an ENABLE TOMETRES command.

The current status of the DIVIDEBY option can be examined using the SHOW ENABLE or SHOW HEIGHTS commands.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the ENABLE DIVIDEBY command:


*** WARNING *** You are already planning to multiply by 'constant'
ENABLE DIVIDEBY command now overrides ENABLE MULTIPLYBY command
*** WARNING *** You must specify a value for DIVIDEBY

--------------------------------------------------------------------------------
Examples:


TRIANG> ENABLE DIVIDEBY 39.2<CR>
TRIANG>

ENABLE GRAPHICS COMMAND

--------------------------------------------------------------------------------
ENABLE GRAPHICS

--------------------------------------------------------------------------------
FORMAT: ENABLE GRAPHICS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

TRIANG offers the option to generate graphic output to indicate processing progress. By default graphic output is disabled. To prevent a user selecting graphics when it is inappropriate to the current terminal, TRIANG uses a lookup table of terminal characteristics associated with all available terminal lines (see Appendix 1). An invalid graphics selection will result in a warning message and the default NO GRAPHICS option being selected.

Graphics selection may be cancelled with the DISABLE GRAPHICS command.

The current status of the GRAPHICS option can be examined using the SHOW ENABLE command.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the ENABLE GRAPHICS command:

*** ERROR  *** reading lookup file at line 'integer'
*** WARNING *** Unable to open "LSL$LOOKUP:TERMTYPE.DAT"
Sorry 'name' terminal  'terminal-ident' isn't in the lookup table
Sorry 'name' terminal 'terminal-ident' can't support graphics
*** ERROR  *** translating logical name LSL$DTMCREATETERMINAL

--------------------------------------------------------------------------------
Examples:


$ TRIANG<CR>
DTMCREATE module TRIANG of 13:30:39 20-AUG-87
TRIANG> SHOW ENABLE<CR>

CONSTRAINT ................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... OFF
GRAPHICS ..................................................... Off
INTEGER_HEIGHT ............................................... Off
(Incoming IFF heights expected in type 3 AC entries)
INVERSE ...................................................... Off
MULTIPLY ..................................................... Off
PME .......................................................... Off
SQUARE ....................................................... On
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

TRIANG> ENABLE GRAPHICS<CR>
TRIANG>

ENABLE INTEGER_HEIGHT COMMAND

--------------------------------------------------------------------------------
ENABLE INTEGER_HEIGHT

--------------------------------------------------------------------------------
FORMAT: ENABLE INTEGER_HEIGHT

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

In IFF files, height values are transmitted via AC (Ancillary Code) or ZS (3D string) entries. By default contour and spot height Z values are read from type 3 ACs as floating point values. By use of the ENABLE INTEGER_HEIGHT command, integer heights may be read from type 2 ACs.

ENABLE INTEGER_HEIGHT causes TRIANG to take heights from type 2 (integer) AC (Ancillary Code) entries in an IFF input file.

The current status of the INTEGER_HEIGHT option can be examined using the SHOW ENABLE or SHOW HEIGHTS commands.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


TRIANG> ENABLE INTEGER_HEIGHT<CR>
TRIANG> SHOW ENABLE<CR>

CONSTRAINT ................................................... Off
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... OFF
GRAPHICS ..................................................... Off
INTEGER_HEIGHT ............................................... On
(Incoming IFF heights expected in type 2 AC entries)
INVERSE ...................................................... Off
MULTIPLY ..................................................... Off
PME .......................................................... Off
SQUARE ....................................................... On
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

TRIANG>

ENABLE INVERSE COMMAND

--------------------------------------------------------------------------------
ENABLE INVERSE

--------------------------------------------------------------------------------
FORMAT: ENABLE INVERSE

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Incoming IFF heights may be inverted if the ENABLE INVERSE command is specified prior to reading an IFF file with a FILEIN command. This enables modelling of hydrographic data where sea depths are often stored as positive heights, drying zone heights as negative and land heights as positive!

By default heights are not inverted.

If the DATUM command has been used to specify a change of height datum the heights are inverted before the datum value is added.

The current status of the INVERSE option can be examined using the SHOW ENABLE or SHOW HEIGHTS commands.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


TRIANG> DATUM 8.2<CR>
TRIANG> ENABLE INVERSE <CR>
TRIANG> SHOW ENABLE<CR> CONSTRAINT ................................................... Off DIAGNOSTICS .................................................. Off DIVIDEBY ..................................................... Off GRAPHICS ..................................................... Off INTEGER_HEIGHT ............................................... On (Incoming IFF heights expected in type 2 AC entries) INVERSE ...................................................... On MULTIPLY ..................................................... Off PME .......................................................... Off SQUARE ....................................................... On TOFEET ....................................................... Off TOMETRES ..................................................... Off
TRIANG> FILEIN HUNSTANTON_BATHEMETRY<CR> IFF file LSL$IF:HUNSTANTON_BATHEMETRY.IFF;0 opened for read +----------------------------------------------------------------+ | | | Starting pass through IFF file | | | +----------------------------------------------------------------+ There are now 671 points in the DTM area
TRIANG> DATUM 0.0<CR>
TRIANG> DISABLE INVERSE <CR>
TRIANG> SHOW ENABLE<CR> CONSTRAINT ................................................... Off DIAGNOSTICS .................................................. Off DIVIDEBY ..................................................... OFF GRAPHICS ..................................................... Off INTEGER_HEIGHT ............................................... On (Incoming IFF heights expected in type 2 AC entries) INVERSE ...................................................... Off MULTIPLY ..................................................... Off PME .......................................................... Off SQUARE ....................................................... On TOFEET ....................................................... Off TOMETRES ..................................................... Off
TRIANG> FILEIN ATILLA<CR> IFF file LSL$IF:ATILLA.IFF;0 opened for read +----------------------------------------------------------------+ | | | Starting pass through IFF file | | | +----------------------------------------------------------------+ There are now 55527 points in the DTM area
TRIANG>

ENABLE MULTIPLYBY COMMAND

--------------------------------------------------------------------------------
ENABLE MULTIPLYBY

--------------------------------------------------------------------------------
FORMAT: ENABLE MULTIPLYBY multiplicand

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The ENABLE MULTIPLYBY enables the user to multiply all incoming heights by a specified (floating point) constant. For example, the command ENABLE MULTIPLYBY 2.0 will cause all incoming heights to be multiplied by 2.0. An ENABLE MULTIPLYBY 3.2808455 command has the same effect as an ENABLE TOFEET command.

The current status of the MULTIPLYBY option can be examined using the SHOW ENABLE or SHOW HEIGHTS commands.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the ENABLE MULTIPLYBY command:


*** WARNING *** You are already planning to divide by 'constant'
ENABLE MULTIPLY command now overrides ENABLE DIVIDEBY command
*** WARNING *** You must specify a value for MULTIPLYBY

--------------------------------------------------------------------------------
Examples:


TRIANG> ENABLE MULTIPLYBY 39.2<CR>
TRIANG>

ENABLE PME COMMAND

--------------------------------------------------------------------------------
ENABLE PME

--------------------------------------------------------------------------------
FORMAT: ENABLE PME

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The ENABLE PME and DISABLE PME commands are reserved for Laser-Scan use. PME is a code optimisation tool and should be invoked by LSL software personnel only.

ENABLE PME causes the PME_INIT routine to be invoked.

The current status of the PME option can be examined using the SHOW PME command.

--------------------------------------------------------------------------------
Message:

The following warning message is specific to the ENABLE PME command:

*** WARNING *** You are already using PME!

--------------------------------------------------------------------------------
Examples:


$ TRIANG<CR>
DTMCREATE module TRIANG of 13:30:39 20-AUG-87
TRIANG> ENABLE PME<CR>
TRIANG> ENABLE DIAGNOSTICS<CR>
TRIANG> WINDOW 0. 0. 800. 760.<CR>
TRIANG> ZLIMITS 0 765<CR>
TRIANG> MAXPOINTS 78000<CR>
TRIANG> FILEOUT CHARITY<CR>
_.DTA file DUA3:[DEMONSTRATION]CHARITY_.DTA;6 opened for write
_.NOD file DUA3:[DEMONSTRATION]CHARITY_.NOD;6 opened for write
TRIANG> FRT CHASTITY<CR>
FRT file LSL$FRT:CHASTITY.FRT;8 opened for read
TRIANG> FILEIN FAITH<CR>
TRIANG> ASSIGN BREAKLINE_FC 1:7,WATER,80,102<CR>
TRIANG> FILEIN ATILLA<CR>
IFF file LSL$IF:ATILLA.IFF;0 opened for read
TRIANG> DISABLE PME<CR>
TRIANG> GO<CR>
ELAPSED: 00:05:25.84 CPU: 0:00:05.71 BUFIO: 281 DIRIO: 46 FAULTS: 263
_$

ENABLE SQUARE COMMAND

--------------------------------------------------------------------------------
ENABLE SQUARE

--------------------------------------------------------------------------------
FORMAT: ENABLE SQUARE

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

By default TRIANG checks that the control points in an IFF input file are square to the map coordinate system. If the map held in the IFF file is not square to the coordinate system axes there is a danger that some rows or columns of the DTM will be missed out or be incomplete as DTMCREATE uses only axis minima and maxima to define the model area. If the IFF control point values are not square and the SQUARE option is active then an error message is issued and the run aborted.

The ENABLE SQUARE command enables the squaring test for IFF control points.

The current status of the SQUARE option can be examined using the SHOW ENABLE command.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


$ TRIANG<CR>
DTMCREATE module TRIANG of 13:30:39 20-AUG-87
TRIANG> SHOW ENABLE<CR>

CONSTRAINT ................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... OFF
GRAPHICS ..................................................... Off
INTEGER_HEIGHT ............................................... Off
(Incoming IFF heights expected in type 3 AC entries)
INVERSE ...................................................... Off
MULTIPLY ..................................................... Off
PME .......................................................... Off
SQUARE ....................................................... On
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

TRIANG> DISABLE SQUARE<CR>
TRIANG> SHOW ENABLE<CR> CONSTRAINT ................................................... Off DIAGNOSTICS .................................................. Off DIVIDEBY ..................................................... OFF GRAPHICS ..................................................... Off INTEGER_HEIGHT ............................................... Off (Incoming IFF heights expected in type 3 AC entries) INVERSE ...................................................... Off MULTIPLY ..................................................... Off PME .......................................................... Off SQUARE ....................................................... Off TOFEET ....................................................... Off TOMETRES ..................................................... Off
TRIANG>

ENABLE TOFEET COMMAND

--------------------------------------------------------------------------------
ENABLE TOFEET

--------------------------------------------------------------------------------
FORMAT: ENABLE TOFEET

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

It is possible that different input files may have heights recorded in different measurement systems. The model must be relative to one system only. Two height conversion options are available: ENABLE TOMETRES and ENABLE TOFEET.

The ENABLE TOFEET command enables the conversion of input file heights from metres to feet. It has the same effect as an explicit ENABLE MULTIPLYBY 3.2808455 command. It is possible to read in one file with heights in feet with one FILEIN command and then use the ENABLE TOFEET command and read in another file with heights in metres converting to feet during read-in. The DTM will then be produced in feet.

If one of the height modification options is enabled using ENABLE MULTIPLYBY, ENABLE TOFEET etc_., you must give the ZLIMITS in the target measurement system or height range (ie feet for the ENABLE TOFEET command). Failure to do this may result in flattening of all model relief!.

The current status of the TOFEET option can be examined using the SHOW ENABLE or SHOW HEIGHTS commands.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


TRIANG> ENABLE TOFEET<CR>
TRIANG>

ENABLE TOMETRES COMMAND

--------------------------------------------------------------------------------
ENABLE TOMETRES

--------------------------------------------------------------------------------
FORMAT: ENABLE TOMETRES

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

It is possible that different input files may have heights recorded in different measurement systems. The model must be relative to one system only. Two height conversion options are available: ENABLE TOFEET and ENABLE TOMETRES.

The ENABLE TOMETRES command results in the conversion of heights held in the IFF file in feet to metres. It has the same effect as an explicit ENABLE DIVIDEBY 3.2808455 command. It is possible to read in one file with heights in metres with one FILEIN command and then use the ENABLE TOMETRES command and read in another file with heights in feet converting to metres during read-in. The DTM will then be produced in metres.

If one of the height modification options is enabled using ENABLE MULTIPLYBY, ENABLE TOMETRES etc_., you must give the ZLIMITS in the target measurement system or height range (ie metres for the ENABLE TOMETRES command). Failure to do this may result in flattening of all model relief.

The current status of the TOMETRES option can be examined using the SHOW ENABLE or SHOW HEIGHTS commands.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


TRIANG> ENABLE TOMETRES<CR>
TRIANG>

FILEIN COMMAND

--------------------------------------------------------------------------------
FILEIN

--------------------------------------------------------------------------------
FORMAT: FILEIN file-spec

--------------------------------------------------------------------------------
COMMAND PARAMETERS:

--------------------------------------------------------------------------------
DESCRIPTION:

The FILEIN command causes the specified file-spec to be opened and used as an input file to TRIANG. A FILEIN command cannot be issued until FILEOUT, ZLIMITS, MAXPOINTS and WINDOW commands have been given.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the FILEIN command:

*** WARNING *** You must specify a file-spec argument to the FILEIN command
*** ERROR *** Unable to interpret input file-spec

--------------------------------------------------------------------------------
Examples:


TRIANG> FILEIN DUA3:[DEMONSTRATION]IDAHO<CR>
IFF file DUA3:[DEMONSTRATION]IDAHO.IFF;1 opened for read
TRIANG> ! Now using the FORMAT command to change the format
TRIANG> ! of the input file from IFF (default) to DTI
TRIANG> FORMAT DTI
TRIANG> FILEIN AREA5
DTI file LSL$DTI:AREA5.DTI;0 opened for read
TRIANG>

FILEOUT COMMAND

--------------------------------------------------------------------------------
FILEOUT

--------------------------------------------------------------------------------
FORMAT: FILEOUT file-spec

--------------------------------------------------------------------------------
COMMAND PARAMETERS:

--------------------------------------------------------------------------------
DESCRIPTION:

The FILEOUT command causes the specified file-spec to be used as the generic name for the two TRIANG output files used to transfer the triangulation data structure between the DTMCREATE modules.

The FILEOUT command must be issued before the first FILEIN command.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the FILEOUT command:


*** WARNING *** You must specify a file-spec argument to the FILEOUT command
*** ERROR *** reading output file-spec

--------------------------------------------------------------------------------
Examples:


TRIANG> FILEOUT DUA3:[DEMONSTRATION]IDAHO<CR>
_.DTA file DUA3:[DEMONSTRATION]IDAHO_.DTA;6 opened for write
_.NOD file DUA3:[DEMONSTRATION]IDAHO_.NOD;6 opened for write
TRIANG>

FORMAT COMMAND

--------------------------------------------------------------------------------
FORMAT

--------------------------------------------------------------------------------
FORMAT: FORMAT format

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The FORMAT command enables the user to specify the file format that is to be read into TRIANG during the data initialisation phase. The FORMAT command may be used swap between input file formats as often as required. The default file format is 'IFF'.

It is important to remember to issue the appropriate FORMAT command before the FILEIN command if the file format is different to that read in using a previous FILEIN command.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the FORMAT command:


*** WARNING *** Unknown format - must be either DTI or IFF
*** WARNING *** You must specify an argument to the FORMAT command

--------------------------------------------------------------------------------
Examples:


$ TRIANG<CR>
DTMCREATE module TRIANG of 13:30:39 20-AUG-87
TRIANG> WINDOW 0. 0. 800. 760.<CR>
TRIANG> ZLIMITS 0 765<CR>
TRIANG> MAXPOINTS 78000<CR>
TRIANG> FILEOUT CHARITY<CR>
_.DTA file DUA3:[DEMONSTRATION]CHARITY_.DTA;6 opened for write
_.NOD file DUA3:[DEMONSTRATION]CHARITY_.NOD;6 opened for write
TRIANG> FORMAT DTI<CR>
TRIANG> FILEIN FAITH.DTI<CR>
Origin? 1000.0 2000.0
TRIANG> FRT CHASTITY<CR>
FRT file LSL$FRT:CHASTITY.FRT;8 opened for read
TRIANG> FORMAT IFF<CR>
TRIANG> ASSIGN BREAKLINE_FC 1:7,WATER,80,102<CR>
TRIANG> FILEIN ATILLA<CR>
IFF file LSL$IF:ATILLA.IFF;0 opened for read
TRIANG> GO<CR>
ELAPSED: 00:05:25.84 CPU: 0:00:05.71 BUFIO: 281 DIRIO: 46 FAULTS: 263
_$

FRT COMMAND

--------------------------------------------------------------------------------
FRT

--------------------------------------------------------------------------------
FORMAT: FRT file-spec

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The FRT command allows the user to specify an FRT file which contains feature code group definitions. The availability of feature code groups simplifies the specification of complex feature code assignments for breaklines etc_.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the FRT command:


*** ERROR *** reading FRT file-spec
*** ERROR *** unable to open specified FRT

--------------------------------------------------------------------------------
Examples:

TRIANG> ASSIGN CLIFF_FC OUTCROPS,7,COAST<CR>
*** WARNING *** You must have read an FRT file to be able to use group names
TRIANG> FRT HOVER<CR>
FRT file LSL$FRT:HOVER.FRT;8 opened for read
TRIANG> ASSIGN CLIFF_FC OUTCROPS,7,COAST<CR>
TRIANG>

GO COMMAND

--------------------------------------------------------------------------------
GO

--------------------------------------------------------------------------------
FORMAT: GO

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

When all necessary files have been read in the GO command will commence the triangulation process. Unless relatively small data-sets are being handled (say less then 50,000 data points) it is strongly recommended that TRIANG is run in batch mode at an off-peak time.

The GO command will cause TRIANG to first produce an ideal Delaunay triangulation. If the CONSTRAINT option is enabled TRIANG will then constrain the idealised triangulation to the paths of input data strings. When all triangulation creation and modification is complete TRIANG writes out the data structure to binary disk files and then exits.

--------------------------------------------------------------------------------
Messages:

Once the GO command has been issued no more conversational messages of the *** WARNING *** format will be issued. Any messages will relate to serious processing problems and will normally result in abnormal TRIANG termination. The messages relating to non-interactive processing problems are presented at the end of this document.

--------------------------------------------------------------------------------
Examples:


TRIANG> GO<CR>

ELAPSED: 0 00:05:21.82 CPU: 0:00:01.40 BUFIO: 51 DIRIO: 15 FAULTS: 170
$

HELP COMMAND

--------------------------------------------------------------------------------
HELP

--------------------------------------------------------------------------------
FORMAT: HELP subject

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
Description:

The HELP command looks the rest of the line up in the DTMCREATE HELP library. This library contains a brief summary of the operation of each command.

The information is looked up in the TRIANG section of the DTMCREATE help library, LSL$HELP:DTMCREATE.HLB.

--------------------------------------------------------------------------------
Messages:

Where required, warning messages are output via the VMS LBR$OUTPUT_HELP utility.

--------------------------------------------------------------------------------
Examples:


TRIANG> HELP MAXPOINTS<CR>

MAXPOINTS

TRIANG>

MAXPOINTS COMMAND

--------------------------------------------------------------------------------
MAXPOINTS

--------------------------------------------------------------------------------
FORMAT: MAXPOINTS estimate

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
Description:

The value supplied for the MAXPOINTS command determines the dimensioning of TRIANG internal workspace and the number of imaginary points placed around the edge of the triangulation. It is very likely that the user will have only a very rough idea of the amount of data expected within the window defined using the WINDOW command. This does not matter as only a rough estimate is needed. If ludicrously few points are estimated, say 10% of the actual data-set, then program running times will be significantly increased because the box data structure will not accurately reflect changes in data density. A rough figure, say 80% accurate, is better than nothing.

The number of points specified using the MAXPOINTS command must reflect the total from ALL the files input using FILEIN commands which lie within the triangulation window specified using the WINDOW command.

To calculate the number of points extracted from a DTI file determine how much of the DTI files lies within the TRIANG window, divide this by the DTI file x or y grid step as appropriate then multiply the resulting number of row and columns together. The DTI file size, coverage and x and y grid steps and Z-range may be simply determined by reading the file into MATRIX utility DTIEDIT.

The IMP utility IINFO can be used to determine how many points there are within an IFF file, in total, by feature code and by layer. It cannot, however, reveal the number of points that lie within a subwindow of the whole IFF file. The Z range of the IFF file may be determined using the same run of IINFO if the /HEIGHT qualifier is specified.

If there are more than the permitted number of points within the window then a smaller WINDOW should be specified and the data triangulated in two or more separate triangulations. Allow a small amount of overlap between adjacent windows, the sub-DTMs created by TRIGRID from these separate triangulations will then perfectly edge match when joined together using MATRIX utility DTITILE.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the MAXPOINTS command:

*** WARNING *** You can't change MAXPOINTS now as workspace allocation has begun
*** WARNING *** You must specify an integer argument to the MAXPOINTS command
*** WARNING *** Too many points. (Max. possible number without redimensioning = 'integer')
*** WARNING *** MAXPOINTS has not been set
*** WARNING *** Overrun of neighbour stack space may occur

--------------------------------------------------------------------------------
Examples:


TRIANG> MAXPOINTS 75000<CR>
TRIANG> SHOW MAXPOINTS<CR>

Estimated number of incoming points = 75000
(Max possible number without redimensioning = 99730)

TRIANG>

PAUSE COMMAND

--------------------------------------------------------------------------------
PAUSE

--------------------------------------------------------------------------------
FORMAT: PAUSE

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Pauses TRIANG execution and issues a prompt for a carriage return to continue execution. This command is designed for use in software demonstration situations.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


TRIANG> PAUSE<CR>


Press to continue<CR>
TRIANG>

QUIT COMMAND

--------------------------------------------------------------------------------
QUIT

--------------------------------------------------------------------------------
FORMAT: QUIT

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
Description:

The QUIT command causes TRIANG to exit immediately, closing all input files and closing and deleting all output files.

(pressing the Ctrl and Z keys together) may also be used to quit from the program.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

TRIANG> QUIT<CR>
ELAPSED: 00:05:25.84 CPU: 0:00:05.71 BUFIO: 281 DIRIO: 46 FAULTS: 263
_$

RETURN COMMAND

--------------------------------------------------------------------------------
RETURN

--------------------------------------------------------------------------------
FORMAT: RETURN

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Restores command input from an indirect file to SYS$COMMAND.

A typical application is to allow the user to use an indirect command file to set up those run time defaults which are constant within a flowline and then return to input from the terminal (or batch stream) for the run specific commands. To do this RETURN must be the last command in the indirect command file.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the RETURN command:

RETURN command detected - returning to terminal input
RETURN command ignored - command input is already from terminal

--------------------------------------------------------------------------------
Examples:


TRIANG> @FLOW2<CR>
TRIANG> ENABLE DIAGNOSTICS
TRIANG> FRT FLOW2
FRT file LSL$FRT:FLOW2.FRT;8 opened for read
TRIANG> ASSIGN CLIFF_FC OUTCROPS,7,COAST
TRIANG> RETURN
TRIANG>

SELECT ALL

--------------------------------------------------------------------------------
SELECT ALL

--------------------------------------------------------------------------------

FORMAT: SELECT ALL

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

This command resets all feature input selections. If features are subsequently selected using the other SELECT commands then all features are first implicitly deselected.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the SELECT command.


*** ERROR *** Specifying command SELECT
Command qualifiers are ALL, FC or LAYER

--------------------------------------------------------------------------------
Examples:

TRIANG>SELECT ALL


TRIANG>SELECT FC 7:10,56:78
TRIANG>SELECT FC 11:20


TRIANG>

SELECT FC COMMAND

--------------------------------------------------------------------------------
SELECT FC

--------------------------------------------------------------------------------
FORMAT: SELECT FC feature-code[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The SELECT FC command complements the DESELECT FC command. SELECT FC enables the user to select any IFF features which have the specified feature codes.

On program startup all FCs are selected for input. IFF features which are not required for input must be specifically excluded using the appropriate DESELECT FC and DESELECT LAYER commands. For example, the command DESELECT FC 0:7 11:300 302:32767 will leave only features with FCs 8,9,10, and 301 selected for input.

The first SELECT FC command has the effect of deselecting all FCs from input except those explicitly specified as the arguments to the SELECT FC command. Subsequent SELECT FC commands have the effect of adding the specified FCs to the list of FCs selected for input.

All layers and FCs may be reselected for input by specifying the SELECT ALL command.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the SELECT FC command:

*** WARNING *** You must have read an FRT file to be able to use group names
*** WARNING *** No groups have been defined in the FRT
*** WARNING *** Illegal feature code 'integer'
*** WARNING *** Bad group name 'group-name'

--------------------------------------------------------------------------------
Examples:


TRIANG> SELECT FC 6:9,WATER,126<CR>
TRIANG>

SELECT LAYER COMMAND

--------------------------------------------------------------------------------
SELECT LAYER

--------------------------------------------------------------------------------
FORMAT: SELECT LAYER layer[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The SELECT LAYER command complements the DESELECT LAYER command. SELECT LAYER enables the user to select any IFF features which are contained within the specified layers.

By default TRIANG will input all features within an IFF file, regardless of the layer in which they lie.

On program startup all layers are selected for input. IFF features which are not required for input must be specifically excluded using the appropriate DESELECT FC and DESELECT LAYER commands. For example, the command DESELECT LAYER 0:7 11:300 302:32767 will leave only features which lie within layers 8,9,10, and 301 selected for input.

The first SELECT LAYER command has the effect of deselecting all layers from input except those explicitly specified as the arguments to the SELECT LAYER command. Subsequent SELECT LAYER commands have the effect of adding the specified layers to the list of FCs selected for input.

All layers and FCs may be reselected for input by specifying the SELECT ALL command.

Note that selections made with the DESELECT and SELECT commands will override input data assignments (e.g. ASSIGN BREAKLINE_FC) which share the same feature code or layer numbers. Thus even though FC 9 has been assigned breakline status by an ASSIGN BREAKLINE_FC 9 command, all features with FC 9 will be excluded from input if the user has specified a DESELECT_FC 9 command. Use the SHOW SELECTIONS command to examine current input selections and the SHOW ASSIGNMENTS command to examine current assignments.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the SELECT LAYER command:

*** WARNING *** Too many layer arguments in one command
*** WARNING *** Illegal layer number 'integer'

--------------------------------------------------------------------------------
Examples:


TRIANG> SELECT LAYER 21:29,126<CR>
TRIANG>

SHOW COMMAND

--------------------------------------------------------------------------------
SHOW

--------------------------------------------------------------------------------
FORMAT: SHOW subject

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

SHOW enables the user to examine the current status of TRIANG options and parameter settings.

--------------------------------------------------------------------------------
Messages:

TRIANG issues the following message if the SHOW command is specified without an argument:


*** ERROR *** Specifying command SHOW

Available SHOW command qualifiers are:

ASSIGNMENTS      BREAKLINES      CLIFFLINES     DATUM      ENABLE    FC

FILES            FORMAT          FRT            HEIGHTS    LAYER

MAXPOINTS        RIDGELINES      RIVERS         SELECTIONS

UNITS      	 WINDOW          ZLIMITS

This feature can be used to advantage if the user wishes to quickly determine for which items the SHOW facility is available.

--------------------------------------------------------------------------------
Examples:


_$ TRIANG<CR>
DTMCREATE module TRIANG of 13:53:27 3-FEB-89
TRIANG> SHOW<CR>

*** ERROR *** Specifying command SHOW
Available SHOW command qualifiers are:
ASSIGNMENTS      BREAKLINES      CLIFFLINES     DATUM      ENABLE    FC
FILES            FORMAT          FRT            HEIGHTS    LAYER
MAXPOINTS        RIDGELINES      RIVERS         SELECTIONS
UNITS        WINDOW          ZLIMITS
TRIANG> SHOW BREAKLINES<CR>
BREAKLINES:
No layers assigned for breaklines
No feature codes assigned for breaklines

TRIANG>

SHOW ASSIGNMENTS COMMAND

--------------------------------------------------------------------------------
SHOW ASSIGNMENTS

--------------------------------------------------------------------------------
FORMAT: SHOW ASSIGNMENTS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of TRIANG feature code and layer assignments made using ASSIGN and DEASSIGN commands. The SHOW ASSIGNMENTS command has the effect of issuing SHOW BREAKLINES, SHOW CLIFFLINES, SHOW RIDGELINES and SHOW RIVERS commands sequentially.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

$ TRIANG<CR>

DTMCREATE module TRIANG of 13:53:27  3-FEB-89
TRIANG> SHOW ASSIGNMENTS<CR>
BREAKLINES:
No layers assigned for breaklines
No feature codes assigned for breaklines
CLIFFLINES:
No layers assigned for cliffs
No feature codes assigned for cliffs
RIDGELINES:
No layers assigned for ridgelines
No feature codes assigned for ridgelines
RIVERS:
No layers assigned for rivers
No feature codes assigned for rivers

TRIANG>

SHOW BREAKLINES COMMAND

--------------------------------------------------------------------------------
SHOW BREAKLINES

--------------------------------------------------------------------------------
FORMAT: SHOW BREAKLINES

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of TRIANG feature code and layer breakline assignments made using ASSIGN and DEASSIGN commands.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR>
DTMCREATE module TRIANG of 13:53:27  3-FEB-89
TRIANG> SHOW BREAKLINES<CR>
No layers assigned for breaklines
No feature codes assigned for breaklines

TRIANG>

SHOW CLIFFLINES COMMAND

--------------------------------------------------------------------------------
SHOW CLIFFLINES

--------------------------------------------------------------------------------
FORMAT: SHOW CLIFFLINES

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of TRIANG feature code and layer cliffline assignments made using ASSIGN and DEASSIGN commands.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR>
DTMCREATE module TRIANG of 13:53:27  3-FEB-89
TRIANG> SHOW CLIFFLINES<CR>
No layers assigned for clifflines
No feature codes assigned for clifflines

TRIANG>

SHOW DATUM COMMAND

--------------------------------------------------------------------------------
SHOW DATUM

--------------------------------------------------------------------------------
FORMAT: SHOW DATUM

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of of the height datum which is to be added to all incoming IFF and DTI heights.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR> DTMCREATE module TRIANG of 13:53:27 3-FEB-89 TRIANG> SHOW DATUM<CR> Height datum 0.0 to be added to all incoming heights
TRIANG>

SHOW ENABLE COMMAND

--------------------------------------------------------------------------------
SHOW ENABLE

--------------------------------------------------------------------------------
FORMAT: SHOW ENABLE

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of all TRIANG processing options.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR>
DTMCREATE module TRIANG of 13:53:27  3-FEB-89
TRIANG> SHOW ENABLE<CR>
CONSTRAINT ................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... OFF
GRAPHICS ..................................................... Off
INTEGER_HEIGHT ............................................... Off
(Incoming IFF heights expected in type 3 AC entries)
INVERSE ...................................................... Off
MULTIPLY ..................................................... Off
PME .......................................................... Off
SQUARE ....................................................... On
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

TRIANG>

SHOW FC COMMAND

--------------------------------------------------------------------------------
SHOW FC

--------------------------------------------------------------------------------
FORMAT: SHOW FC

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of TRIANG feature code input selections.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR>
DTMCREATE module TRIANG of 13:53:27  3-FEB-89
TRIANG> SHOW FC<CR>
Feature codes selected for input:
0-32767

TRIANG>

SHOW FILES COMMAND

--------------------------------------------------------------------------------
SHOW FILES

--------------------------------------------------------------------------------
FILES: SHOW FILES

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of TRIANG input file FILES and output file useage.

SHOW FILES enables the user to determine whether he has opened the output files (by using the FILEOUT command) and what names have been used. It also enables the user to keep track of which IFF and DTI files have been successfully read into TRIANG using FILEIN commands. Up to 20 input files can be displayed using the SHOW FILES command.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR>
DTMCREATE module TRIANG of 13:53:27  3-FEB-89
TRIANG> SHOW FILES<CR>
INPUT:
No input files sucessfully read yet.
OUTPUT:
Output filename not yet specified.

TRIANG>

SHOW FORMAT COMMAND

--------------------------------------------------------------------------------
SHOW FORMAT

--------------------------------------------------------------------------------
FORMAT: SHOW FORMAT

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of TRIANG input file format selection. TRIANG can read either IFF or DTI files, the file type is set using the FORMAT command.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR> DTMCREATE module TRIANG of 13:53:27 3-FEB-89 TRIANG> SHOW FORMAT<CR> Input expected from IFF file
TRIANG>

SHOW FRT COMMAND

--------------------------------------------------------------------------------
SHOW FRT

--------------------------------------------------------------------------------
FRT: SHOW FRT

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of TRIANG FRT selection.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR>
DTMCREATE module TRIANG of 13:53:27  3-FEB-89
TRIANG> SHOW FRT<CR>
No FRT file selected

TRIANG>

SHOW HEIGHTS COMMAND

--------------------------------------------------------------------------------
SHOW HEIGHTS

--------------------------------------------------------------------------------
HEIGHTS: SHOW HEIGHTS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of TRIANG height modification and datum options.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR> DTMCREATE module TRIANG of 13:53:27 3-FEB-89 TRIANG> SHOW HEIGHTS<CR> Incoming heights expected in IFF type 3 AC entries MULTIPLYBY and DIVIDEBY are disabled. No imperial or metric conversion to be applied to incoming heights Height datum 0.000 to be added to all incoming heights No inversion to be applied to incoming heights
TRIANG>

SHOW LAYER COMMAND

--------------------------------------------------------------------------------
SHOW LAYER

--------------------------------------------------------------------------------
FORMAT: SHOW LAYER

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of TRIANG layer input selections.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR>
DTMCREATE module TRIANG of 13:53:27  3-FEB-89
TRIANG> SHOW LAYER<CR>
Layers selected for input:
0-32767

TRIANG>

SHOW MAXPOINTS COMMAND

--------------------------------------------------------------------------------
SHOW MAXPOINTS

--------------------------------------------------------------------------------
FORMAT: SHOW MAXPOINTS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of the MAXPOINTS parameter.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR>
DTMCREATE module TRIANG of 13:53:27  3-FEB-89
TRIANG> SHOW MAXPOINTS<CR>
Estimated number of incoming points = 0 
(Max possible number without redimensioning = 79380)

TRIANG>

SHOW RIDGELINES COMMAND

--------------------------------------------------------------------------------
SHOW RIDGELINES

--------------------------------------------------------------------------------
FORMAT: SHOW RIDGELINES

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of TRIANG feature code and layer ridgeline assignments made using ASSIGN and DEASSIGN commands.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR>
DTMCREATE module TRIANG of 13:53:27  3-FEB-89
TRIANG> SHOW RIDGELINES<CR>
No layers assigned for ridgelines
No feature codes assigned for ridgelines

TRIANG>

SHOW RIVERS COMMAND

--------------------------------------------------------------------------------
SHOW RIVERS

--------------------------------------------------------------------------------
FORMAT: SHOW RIVERS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of TRIANG feature code and layer river assignments made using ASSIGN and DEASSIGN commands.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR>
DTMCREATE module TRIANG of 13:53:27  3-FEB-89
TRIANG> SHOW RIVERS<CR>
No layers assigned for rivers
No feature codes assigned for rivers

TRIANG>

SHOW SELECTIONS COMMAND

--------------------------------------------------------------------------------
SHOW SELECTIONS

--------------------------------------------------------------------------------
FORMAT: SHOW SELECTIONS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of TRIANG layer and feature code input selections.

SHOW selections has the same effect as issuing SHOW FC and SHOW LAYER commands sequentially.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR>
DTMCREATE module TRIANG of 13:53:27  3-FEB-89
TRIANG> SHOW SELECTIONS<CR>
Feature codes selected for input:
0-32767
Layers selected for input:
0-32767

TRIANG>

SHOW UNITS COMMAND

--------------------------------------------------------------------------------
SHOW UNITS

--------------------------------------------------------------------------------
FORMAT: SHOW UNITS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of TRIANG window units as set using the UNITS command.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR>
DTMCREATE module TRIANG of 13:53:27  3-FEB-89
TRIANG> SHOW UNITS<CR>
Window to be specified in metres

TRIANG>

SHOW WINDOW COMMAND

--------------------------------------------------------------------------------
SHOW WINDOW

--------------------------------------------------------------------------------
FORMAT: SHOW WINDOW

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current triangulation window values.

The units of the WINDOW command parameters are set using the UNITS command. By default metre units are assumed. If it is more convenient to specify the window in latitude and longitude the sexagesimal lat long values may be supplied after specifying a UNITS LATLONG command. This assumes that the data read in from the DTI and IFF files are in units of tenths second of arc. A similar assumption is made for UNITS SECONDS.

The SHOW WINDOW command displays the window values in the units currently selected by the UNITS command. No projection transformation is performed, so the unwise user could easily specify that the window be shown as latitude longitude despite the fact that his data are in metres!

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR> DTMCREATE module TRIANG of 13:53:27 3-FEB-89 TRIANG> SHOW WINDOW<CR> Window to be specified in metres Triangulation window currently unset
TRIANG>

SHOW ZLIMITS COMMAND

--------------------------------------------------------------------------------
SHOW ZLIMITS

--------------------------------------------------------------------------------
FORMAT: SHOW ZLIMITS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Shows current status of the ZLIMITS parameters.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

_$ TRIANG<CR> DTMCREATE module TRIANG of 13:53:27 3-FEB-89 TRIANG> SHOW ZLIMITS<CR> Z-limits currently undefined
TRIANG>

SPAWN COMMAND

--------------------------------------------------------------------------------
SPAWN

--------------------------------------------------------------------------------
FORMAT: SPAWN command-line

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The SPAWN command enables you to create a subprocess while within TRIANG. When the subprocess terminates control is returned to TRIANG.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the SPAWN command:

*** WARNING *** SPAWN requires a valid DCL command line
*** ERROR *** Unable to spawn command, returning to TRIANG

--------------------------------------------------------------------------------
Examples:


TRIANG> SPAWN DIRECTORY *_.DTA;*<CR>

Directory DUA3:[DTMCREATE.ACCEPTANCE_TESTS]
TEST1_.DTA;1              8/8       18-AUG-1987 07:56  [LSL,TIM]
TEST2_.DTA;2              7/8       18-AUG-1987 17:17  [LSL,TIM]
TEST2_.DTA;1              7/8       18-AUG-1987 17:07  [LSL,TIM]
Total of 3 files, 22/24 blocks.

TRIANG>

UNITS COMMAND

--------------------------------------------------------------------------------
UNITS

--------------------------------------------------------------------------------
FORMAT: UNITS units

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The UNITS command enables the user to specify in what units of measurement he wishes to define the triangulation window using the WINDOW command, or in what units of measurement details from the header of the DTI file are displayed.

By default metre units are assumed.
The UNITS command should be given before specifying the triangulation window if the user wishes to specify the window in non-metre units.

If UNITS SECONDS or UNITS LATLONG are used it is assumed that the data read in using FILEIN commands are in units of tenth seconds of arc.

UNITS METRES (the default) or UNITS PROJECTION assume that the the data read in using FILEIN commands are in metres or projection units. In a future release of DTMCREATE coordinate consistency checks between input files will be implemented.

Currently the projection information for the first input file read with a FILEIN command is copied to the .NOD and .DTA output files for subsequent use in setting up the header of the LSLA type DTI file created in TRIGRID.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the UNITS command:

*** ERROR *** Specifying command UNITS
Command qualifiers are METRES,PROJECTION,SECONDS or LATLONG

--------------------------------------------------------------------------------
Examples:


TRIANG> UNITS LATLONG<CR>
TRIANG> WINDOW 52 00 00N 08 30 00 E 52 30 00 N 09 00 00 E<CR>
TRIANG>

WAIT COMMAND

--------------------------------------------------------------------------------
WAIT

--------------------------------------------------------------------------------
FORMAT: WAIT seconds

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The WAIT command causes processing to be suspended for a specified number of seconds. It is designed for use in software demonstration situations and is of no value in a production flowline.

--------------------------------------------------------------------------------
Messages:

The following warning message is specific to the WAIT command:

*** WARNING *** You must specify the number of seconds to wait

--------------------------------------------------------------------------------
Examples:


TRIANG> WAIT 4.0<CR>
TRIANG>

WINDOW COMMAND

--------------------------------------------------------------------------------
WINDOW

--------------------------------------------------------------------------------
FORMAT: WINDOW xmin ymin xmax ymax

--------------------------------------------------------------------------------
Command parameters:

The units of the WINDOW command parameters are set using the UNITS command. By default metre units are assumed. If it is more convenient to specify the window in latitude and longitude the sexagesimal lat long values may be supplied after specifying a UNITS LATLONG command. This assumes that the data read in from the DTI and IFF files are in units of tenths second of arc. A similar assumption is made for UNITS SECONDS.

Remember that the WINDOW parameters must be specified in the order SW latitude longitude, NE latitude longitude if using latlong units, (i.e. x and y specification is reversed).

--------------------------------------------------------------------------------
DESCRIPTION:

The command is used to define rectangular limits to the area of data to be included within the triangulation. The limits must be specified in the order bottom left hand (or south west) corner then top right hand (or north east) corner.

WINDOW command parameters must be expressed in absolute coordinate space (i.e. including the origin offset), not local map coordinate space (which excludes the origin offset). Only by doing this will the correct data clipping limits be applied to IFF and DTI data coming from different source files.

The WINDOW command can be used to clip data from input IFF or DTI files.

The WINDOW command is obligatory.

The rectangular limits set by the WINDOW command cannot be reset once a FILEIN command has been issued as the WINDOW command arguments are used to determine scaling between DTMCREATE internal workspace coordinates and map units.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the WINDOW command:


*** WARNING **** Unable to read WINDOW arguments
*** WINDOW **** is still unset, please respecify the WINDOW command
*** ERROR **** window values define a zero width window
*** ERROR **** window values define a zero height window

--------------------------------------------------------------------------------
Examples:


TRIANG> WINDOW 0.0 0.0 120.0 120.0<CR>
TRIANG>

ZLIMITS COMMAND

--------------------------------------------------------------------------------
ZLIMITS

--------------------------------------------------------------------------------
FORMAT: ZLIMITS real1 real2

--------------------------------------------------------------------------------
COMMAND PARAMETERS:

--------------------------------------------------------------------------------
Description:

All data is scaled by TRIANG to an internal common form. Until all the required IFF and DTI files have been read in the full range of the Z-variable is unknown. The ZLIMITS command allows the user to specify the Z-variable range before any IFF files are read. The values that the user supplies are used to set up the Z-scaling. The ZLIMITS command requires only a rough indication of the expected minimum and maximum Z values. It is important to remember though, that the Z range specified should represent not only that of the first data set but also of any subsequent IFF files. The Z range should also reflect any later grid that may be interpolated allowing for any expected highs or lows outside the possible data range.

IMPORTANT If one of the height modification options is enabled using ENABLE MULTIPLYBY, ENABLE TOFEET etc_., you must give the ZLIMITS in the target measurement system or height range (ie feet for the TOFEET command). Failure to do this may result in flattening of all model relief!

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the ZLIMITS command:

*** WARNING *** You must specify minimum and maximum Z value arguments For example ZLIMITS 80.0 3000.0 *** WARNING *** You cannot reset the ZLIMITS once a file has been read in

--------------------------------------------------------------------------------
Examples:


TRIANG> SHOW ZLIMITS<CR>
Z-limits currently undefined
TRIANG> ZLIMITS 0 850<CR>
TRIANG> SHOW ZLIMITS<CR>
Zmin= 0.000 zmax= 850.000
TRIANG>

--------------------------------------------------------------------------------

EXAMPLES

$ TRIANG<CR> DTMCREATE module TRIANG of 14:17:49 24-AUG-87 TRIANG> ! set expected number of data points for internal scaling<CR> TRIANG> ! purposes<CR> TRIANG> MAXPOINTS 4000<CR>* TRIANG> ! set Z-limits for internal scaling purposes<CR> TRIANG> ZLIMITS 90.0 560.0<CR> TRIANG> ! define area that is to be triangulated<CR> TRIANG> WINDOW 0.0 0.0 100.0 100.0 TRIANG> ! give the name to be used for the output .NOD and .DTA files<CR> TRIANG> FILEOUT TESTPIECE<CR>
_.DTA file SYS$DISK:[]TESTPIECE.DTA;0 opened for write
_.NOD file SYS$DISK:[]TESTPIECE.NOD;0 opened for write TRIANG> ENABLE DIAGNOSTICS ! to show what is going on<CR> TRIANG> SHOW ENABLE<CR> CONSTRAINT ................................................... On DIAGNOSTICS .................................................. On DIVIDEBY ..................................................... OFF GRAPHICS ..................................................... Off INTEGER_HEIGHT ............................................... Off (Incoming IFF heights expected in type 3 AC entries) INVERSE ...................................................... Off MULTIPLY ..................................................... Off PME .......................................................... Off SQUARE ....................................................... On TOFEET ....................................................... Off TOMETRES ..................................................... Off TRIANG> SHOW SELECTIONS<CR> Feature codes selected for input: 0-32767 Layers selected for input: 0-32767 TRIANG> ! specify the feature codes of features that are to be read in as<CR> TRIANG> ! 1) breaklines<CR> TRIANG> ASSIGN BREAKLINE_FC 77:92<CR> TRIANG> ! 2) ridgelines<CR> TRIANG> ASSIGN RIDGE_FC 12<CR> TRIANG> ! 3) rivers<CR> TRIANG> ASSIGN RIVER_FC 18:21,35<CR> TRIANG> ! we have some unwanted road data in layer 16 which we will exclude<CR> TRIANG> ! from the triangulation:<CR> TRIANG> DESELECT LAYER 16<CR> TRIANG> SHOW ASSIGNMENTS<CR> BREAKLINES: No layers assigned for breaklines Feature codes assigned for breaklines: 77-92 CLIFFLINES: No layers assigned for cliffs No feature codes assigned for cliffs RIDGELINES: No layers assigned for ridgelines Feature codes assigned for ridgelines: 12 RIVERS: No layers assigned for rivers Feature codes assigned for rivers: 18-21,35 TRIANG> SHOW SELECTIONS<CR> LAYERS: Layers assigned for input: 16 FCs: All feature codes selected for input TRIANG> ! get the data from the IFF file<CR> TRIANG> FILEIN TESTDATA5<CR> IFF file LSL$IF:TESTDATA5.IFF;0 opened for read +----------------------------------------------------------------+ | | | Starting pass through IFF file | | | +----------------------------------------------------------------+ 52 points retained out of 240 in feature with FSN 1 (1) 52 points retained out of 198 in feature with FSN 2 (2) 50 points retained out of 188 in feature with FSN 3 (3) 41 points retained out of 178 in feature with FSN 4 (4) 0 points retained out of 167 in feature with FSN 5 (5) 0 points retained out of 17 in feature with FSN 22 (22) 0 points retained out of 19 in feature with FSN 25 (25) 0 points retained out of 42 in feature with FSN 26 (26) 9 points retained out of 11 in feature with FSN 27 (27) 16 points retained out of 19 in feature with FSN 28 (28) 22 points retained out of 205 in feature with FSN 29 (29) 53 points retained out of 238 in feature with FSN 30 (30) 35 points retained out of 170 in feature with FSN 31 (31) 28 points retained out of 173 in feature with FSN 32 (32) 0 points retained out of 168 in feature with FSN 33 (33) 0 points retained out of 26 in feature with FSN 34 (34) 0 points retained out of 51 in feature with FSN 47 (47) 0 points retained out of 23 in feature with FSN 48 (48) 0 points retained out of 70 in feature with FSN 49 (49) 0 points retained out of 57 in feature with FSN 50 (50) 51 points retained out of 193 in feature with FSN 66 (66) 32 points retained out of 172 in feature with FSN 67 (67) 44 points retained out of 183 in feature with FSN 68 (68) 45 points retained out of 179 in feature with FSN 69 (69) 0 points retained out of 8 in feature with FSN 70 (70) 0 points retained out of 2 in feature with FSN 71 (71) 0 points retained out of 96 in feature with FSN 72 (72) 0 points retained out of 4 in feature with FSN 73 (73) 50 points retained out of 214 in feature with FSN 74 (74) 0 points retained out of 307 in feature with FSN 75 (75) 54 points retained out of 203 in feature with FSN 76 (76) 0 points retained out of 65 in feature with FSN 77 (77) 0 points retained out of 39 in feature with FSN 78 (78) 0 points retained out of 61 in feature with FSN 79 (79) 0 points retained out of 52 in feature with FSN 80 (80) 0 points retained out of 10 in feature with FSN 81 (81) 0 points retained out of 152 in feature with FSN 82 (82) 0 points retained out of 11 in feature with FSN 83 (83) 0 points retained out of 13 in feature with FSN 84 (84) 0 points retained out of 230 in feature with FSN 85 (85) 0 points retained out of 107 in feature with FSN 86 (86) 0 points retained out of 11 in feature with FSN 87 (87) 0 points retained out of 48 in feature with FSN 88 (88) 0 points retained out of 153 in feature with FSN 89 (89) 0 points retained out of 103 in feature with FSN 103 (103) 44 points retained out of 390 in feature with FSN 104 (104) 50 points retained out of 269 in feature with FSN 105 (105) 43 points retained out of 219 in feature with FSN 106 (106) 0 points retained out of 104 in feature with FSN 107 (107) 310 points retained out of 337 in feature with FSN 130 (130) 0 points retained out of 124 in feature with FSN 131 (131) 0 points retained out of 37 in feature with FSN 136 (136) 0 points retained out of 60 in feature with FSN 137 (137) 0 points retained out of 1 in feature with FSN 161 (161) 0 points retained out of 1 in feature with FSN 162 (162) 0 points retained out of 1 in feature with FSN 163 (163) 0 points retained out of 1 in feature with FSN 164 (164) *** WARNING *** Feature with FSN 9998 (165) has no type 3 AC - feature ignored *** WARNING *** Feature with FSN 9997 (166) has no type 3 AC - feature ignored *** WARNING *** Feature with FSN 9999 (167) has no type 3 AC - feature ignored *** WARNING *** Feature with FSN 9996 (168) has no type 3 AC - feature ignored There are now 771 points in the DTM area TRIANG> ! It is known that the four features which did not have type 3 ACs<CR> TRIANG> ! were in fact some supplementary registration marks which should<CR> TRIANG> ! have been deselected from input. As it is, their lack of height<CR> TRIANG> ! tagging has resulted in TRIANG omitting them anyway.<CR> TRIANG> ! As we have no further files to read in we can triangulate the data<CR> TRIANG> GO<CR> +----------------------------------------------------------------+ | | | Generating Delaunay triangulation | | | +----------------------------------------------------------------+ Triangulation complete for 1205 points, of which 434 are imaginary +----------------------------------------------------------------+ | | | Starting triangulation constraint - initialising structure | | | +----------------------------------------------------------------+ +----------------------------------------------------------------+ | | | Setting up random access node/neighbour list | | | +----------------------------------------------------------------+ +----------------------------------------------------------------+ | | | Patching breaklines | | | +----------------------------------------------------------------+ +----------------------------------------------------------------+ | | | Patching contours | | | +----------------------------------------------------------------+ +----------------------------------------------------------------+ | | | Restructuring data order | | | +----------------------------------------------------------------+ +----------------------------------------------------------------+ | | | String reassembly | | | +----------------------------------------------------------------+ +----------------------------------------------------------------+ | | | Writing to .NOD and .DTA files | | | +----------------------------------------------------------------+ There are 1211 points in the constrained triangulation ELAPSED: 0 00:14:22.40 CPU: 0:00:40.47 BUFIO: 468 DIRIO: 317 FAULTS: 8815

See triangmsg.html generated from TRIANGMSG.RNO.