MODULE DTICONTOUR

DTI Contouring Program

Issue 2.1 - 6-July-1989
Copyright (C) 1989  Laser-Scan Ltd
Science Park, Milton Road, Cambridge, England CB4 4FY  tel: (0223) 420414
Document "DTICONTOUR Reference"   Category "REFERENCE"
Document Issue 2.1 Jon Barber  06-July-1989
        2.0 Tim Hartnall  07-March-1989
        1.1 Tim Hartnall  30-November-1988
        1.0 Tim Hartnall  23-March-1988

DTICONTOUR - CONTOURING FROM DTI FILE


--------------------------------------------------------------------------------
MODULE DTICONTOUR

--------------------------------------------------------------------------------
REPLACES PANACEA module TIMPANI

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

FUNCTION

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

FORMAT

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

COMMAND QUALIFIERS

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

DESCRIPTION

GENERAL

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

DTICONTOUR AND INPUT FROM DTI FILES

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

DTICONTOUR OUTPUT IFF FILE CHARACTERISTICS

(1)
RA        0.0      1000.0        0.0      1000.0
(2)
HI
 8-OCT-1987 15:30 TIM         DTICONTOUR Create       00:03:48 00:00:00 00000001
(3)
MH 174 0
(4)
MD            2 
(5)
NS Created by DTICONTOUR. Number of smoothing passes = 0
(6)
CC   .00000000E 000  .00000000E 000
     .10000000E 001  .00000000E 000
     .00000000E 000  .10000000E 001
     .00000000E 000  .00000000E 000
     .00000000E 000  .00000000E 000
     .00000000E 000  .00000000E 000
     .00000000E 000  .00000000E 000
     .00000000E 000  .00000000E 000
     .00000000E 000  .00000000E 000
     .00000000E 000  .00000000E 000
(7)
CP        0.0     1000.0        0.0     1000.0
          0.0        0.0        0.0        0.0
       1000.0        0.0     1000.0        0.0
       1000.0     1000.0     1000.0     1000.0
(8)
NO 1 0
(9)
NF 1 1
(10)
FS 0 0 0 0
(11)
TH 0
ST 3 0
      145.8      23.67
      248.9       26.7
      252.4       28.3
EF
(12)
Other features
 .
 .
 .
 .
 .
EO
EM
EJ

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

DTICONTOUR COMMAND DEFAULTS.

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

DTICONTOUR COMMANDS

_@ COMMAND

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

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

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

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

DTICONTOUR offers the facility of command input from an indirect command file. The '@' character preceding a file-spec will cause DTICONTOUR 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 DTICONTOUR 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:


$ DTICONTOUR<CR>
TVES module DTICONTOUR of 13:30:39 18-OCT-87
DTICONTOUR> @PRESETS<CR>
DTICONTOUR> ENABLE DIAGNOSTICS
DTICONTOUR> INTERVAL 10
DTICONTOUR> INDEX_INTERVAL 100
DTICONTOUR> ENABLE SPOT_HEIGHTS
DTICONTOUR> SET CONTOUR_FC 102
DTICONTOUR> SET INDEX_FC 103
DTICONTOUR> SET SPOT_FC 104
DTICONTOUR> SET LAYER 3
DTICONTOUR> RETURN
DTICONTOUR>

_! COMMAND

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

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

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

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

An exclamation mark is the standard DTM 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:


DTICONTOUR> _! a comment for the sake of it<CR>
DTICONTOUR> WINDOW 0.0 0.0 900.0 900.0<CR>
DTICONTOUR> ZLIMITS 0.0 1290.0 ! limits are in metres<CR>
DTICONTOUR> IFF TEST3<CR>
DTICONTOUR> @PRESETS ! use indirect command file for presets<CR>
DTICONTOUR> INTERVAL 10
DTICONTOUR> INDEX_INTERVAL 100
DTICONTOUR> ENABLE SPOT_HEIGHTS
DTICONTOUR> SET CONTOUR_FC 102
DTICONTOUR> SET INDEX_FC 103
DTICONTOUR> SET SPOT_FC 104
DTICONTOUR> SET LAYER 3
DTICONTOUR> RETURN
DTICONTOUR> FILEIN JOE! get the DTI file<CR>
DTICONTOUR> ! do the contouring<CR>
DTICONTOUR> GO<CR>
ELAPSED: 00:05:25.84 CPU: 0:00:05.71 BUFIO: 281 DIRIO: 46 FAULTS: 263
_$

DISABLE ABSOLUTE COMMAND

--------------------------------------------------------------------------------
DISABLE ABSOLUTE

--------------------------------------------------------------------------------
FORMAT: DISABLE ABSOLUTE

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

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

DISABLE ABSOLUTE cancels a previous ENABLE ABSOLUTE command. If DISABLE ABSOLUTE is given, then coordinate values required by the WINDOW command, supplied in metre or projection units, must be specified as an offset from the SW corner of the matrix.
By default window values should be specified as absolute coordinates.

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

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


DTICONTOUR> DISABLE ABSOLUTE<CR>
DTICONTOUR>

DISABLE DIAGNOSTICS COMMAND

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

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

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

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

Disable a previous ENABLE DIAGNOSTICS command.

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

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


DTICONTOUR> ENABLE DIAGNOSTICS<CR>
DTICONTOUR> SHOW ENABLE<CR>

ABSOLUTE ..................................................... On
DIAGNOSTICS .................................................. On
DIVIDEBY ..................................................... Off
FRAME ........................................................ Off
INDEX ........................................................ On
INTEGER_HEIGHT ............................................... Off
(Contour heights will be placed in type 3 AC entries)
LABELLING .................................................... Off
MULTIPLY ....................................................  Off
PME .......................................................... Off
SMOOTHING .................................................... Off
SPOT_HEIGHTS ................................................. Off
(Single point contours to be omitted from output)
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

DTICONTOUR> DISABLE DIAGNOSTICS<CR>
DTICONTOUR>

DISABLE DIVIDEBY COMMAND

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

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

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

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

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

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

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

DTICONTOUR> SHOW ENABLE<CR>

ABSOLUTE ..................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... Off
FRAME ........................................................ Off
INDEX ........................................................ On
INTEGER_HEIGHT ............................................... Off
(Contour heights will be placed in type 3 AC entries)
LABELLING .................................................... Off
MULTIPLY ....................................................  Off
PME .......................................................... Off
SMOOTHING .................................................... Off
SPOT_HEIGHTS ................................................. Off
(Single point contours to be omitted from output)
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

DTICONTOUR> DISABLE DIVIDEBY<CR>
DTICONTOUR>

DISABLE FRAME COMMAND

--------------------------------------------------------------------------------
DISABLE FRAME

--------------------------------------------------------------------------------
FORMAT: DISABLE FRAME

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

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

DISABLE FRAME cancels the effect of a previous ENABLE FRAME command.

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

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


DTICONTOUR> DISABLE FRAME<CR>
DTICONTOUR>

DISABLE INDEX COMMAND

--------------------------------------------------------------------------------
DISABLE INDEX

--------------------------------------------------------------------------------
FORMAT: DISABLE INDEX

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

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

DISABLE INDEX enables the user to suppress the generation of index contours. A similar effect may be achieved by specifying an INDEX_INTERVAL of zero.

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

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


DTICONTOUR> DISABLE INDEX<CR>
DTICONTOUR>

DISABLE LABELLING COMMAND

--------------------------------------------------------------------------------
DISABLE LABELLING

--------------------------------------------------------------------------------
FORMAT: DISABLE LABELLING

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

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

DISABLE LABELLING cancels the effect of a previous ENABLE LABELLING command.

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

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


DTICONTOUR> DISABLE LABELLING<CR>
DTICONTOUR>

DISABLE MULTIPLYBY COMMAND

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

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

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

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

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

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

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


DTICONTOUR> DISABLE MULTIPLYBY<CR>
DTICONTOUR>

DISABLE PME COMMAND

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

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

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

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

PME is a code optimisation tool and should be invoked by LSL software personnel only.

The DISABLE PME command causes the PME_EXIT routine to be invoked.

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

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

*** WARNING *** You are not using PME!

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


DTICONTOUR> DISABLE PME<CR>
DTICONTOUR>

DISABLE SMOOTH COMMAND

--------------------------------------------------------------------------------
DISABLE SMOOTH

--------------------------------------------------------------------------------
FORMAT: DISABLE SMOOTH

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

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

DISABLE SMOOTH disables the effect of a previous ENABLE SMOOTH command.

--------------------------------------------------------------------------------
Message: None.

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


DTICONTOUR> ENABLE SMOOTH 3<CR> DTICONTOUR> SHOW ENABLE<CR>

ABSOLUTE ..................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... Off
FRAME ........................................................ Off
INDEX ........................................................ On
INTEGER_HEIGHT ............................................... Off
(Contour heights will be placed in type 3 AC entries)
LABELLING .................................................... Off
MULTIPLY ....................................................  Off
PME .......................................................... Off
SMOOTHING .................................................... On
Number of smoothing iterations................................ 3
SPOT_HEIGHTS ................................................. Off
(Single point contours to be omitted from output)
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

DTICONTOUR> DISABLE SMOOTH<CR> DTICONTOUR> SHOW ENABLE<CR> ABSOLUTE ..................................................... On DIAGNOSTICS .................................................. Off DIVIDEBY ..................................................... Off FRAME ........................................................ Off INDEX ........................................................ On INTEGER_HEIGHT ............................................... Off (Contour heights will be placed in type 3 AC entries) LABELLING .................................................... Off MULTIPLY .................................................... Off PME .......................................................... Off SMOOTHING .................................................... Off SPOT_HEIGHTS ................................................. Off (Single point contours to be omitted from output) TOFEET ....................................................... Off TOMETRES ..................................................... Off
DTICONTOUR>

DISABLE SPOT_HEIGHTS COMMAND

--------------------------------------------------------------------------------
DISABLE SPOT_HEIGHTS

--------------------------------------------------------------------------------
FORMAT: DISABLE SPOT_HEIGHTS

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

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

DISABLE SPOT_HEIGHTS disables the effect of a previous ENABLE SPOT_HEIGHTS command.

--------------------------------------------------------------------------------
Message: None.

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


DTICONTOUR> DISABLE SPOT_HEIGHTS<CR>
DTICONTOUR>

DISABLE TOFEET COMMAND

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

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

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

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

It is possible that the input DTI file may have heights recorded in different measurement systems to that required in the output IFF contour file. Two preset height conversion options are available: ENABLE TOMETRES and ENABLE TOFEET.

The ENABLE TOFEET command enables the conversion of heights held in the DTI file in metres to feet. It has the same effect as an explicit ENABLE MULTIPLYBY 3.2808455 command. The contours will then be produced in feet.

If one of the height modification options is selected using ENABLE MULTIPLYBY, ENABLE TOFEET etc_., you must give the contour interval and any ZLIMITS in the target measurement system or height range (ie feet for the ENABLE TOFEET command). Failure to do this will result in unexpected densities of contours!

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

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

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


DTICONTOUR> DISABLE TOFEET<CR>
DTICONTOUR>

DISABLE TOMETRES COMMAND

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

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

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

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

It is possible that the input DTI file may have heights recorded in different measurement systems to that required in the IFF output file. 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 DTI file in feet to metres. It has the same effect as an explicit ENABLE DIVIDEBY 3.2808455 command. The IFF file contours will then be produced in metres.

If one of the height modification options is selected using ENABLE MULTIPLYBY, ENABLE TOMETRES etc_., you must give the contour interval and any ZLIMITS in the target measurement system or height range (ie metres for the ENABLE TOMETRES command). Failure to do this may result in an unexpected contour density!

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

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

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


DTICONTOUR> DISABLE TOMETRES<CR>
DTICONTOUR>

ENABLE ABSOLUTE COMMAND

--------------------------------------------------------------------------------
ENABLE ABSOLUTE

--------------------------------------------------------------------------------
FORMAT: ENABLE ABSOLUTE

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

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

If ENABLE ABSOLUTE is given, then coordinate values required by the WINDOW command, supplied in metre or projection units, must be specified as absolute (rather than relative) coordinate values.

For example if the projection indicates U.K. National Grid, then the WINDOW values may be specified as 6 figure National Grid coordinates.
By default window values should be specified as absolute coordinates. This option can be disabled using the DISABLE ABSOLUTE command.

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

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


DTICONTOUR> ENABLE ABSOLUTE<CR>
DTICONTOUR>

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 DTICONTOUR produces minimal diagnostic printout. If however, the user wishes to receive indications of processing progress and of the effect of windowing on data input, diagnostic printout may be selected with the ENABLE DIAGNOSTICS command.

On a heavily loaded computer it may be reassuring to ENABLE DIAGNOSTICS for the contouring stage of DTICONTOUR processing to indicate progress through the data set. A messages indicating contouring progress is issued as contours of each new contour height are generated.

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

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


DTICONTOUR> ENABLE DIAGNOSTICS<CR> DTICONTOUR> SHOW ENABLE<CR> ABSOLUTE ..................................................... On DIAGNOSTICS .................................................. On DIVIDEBY ..................................................... Off FRAME ........................................................ Off INDEX ........................................................ On INTEGER_HEIGHT ............................................... Off (Contour heights will be placed in type 3 AC entries) LABELLING .................................................... Off MULTIPLY .................................................... Off PME .......................................................... Off SMOOTHING .................................................... Off SPOT_HEIGHTS ................................................. Off (Single point contours to be omitted from output) TOFEET ....................................................... Off TOMETRES ..................................................... Off
DTICONTOUR>

ENABLE DIVIDEBY COMMAND

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

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

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

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

The ENABLE DIVIDEBY enables the user to divide all incoming DTI 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.

--------------------------------------------------------------------------------
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:


DTICONTOUR> ENABLE DIVIDEBY 10.0<CR>
DTICONTOUR> SHOW ENABLE<CR>

ABSOLUTE ..................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... On
Matrix heights to be divided by .............................. 10.0
FRAME ........................................................ Off
INDEX ........................................................ On
INTEGER_HEIGHT ............................................... Off
(Contour heights will be placed in type 3 AC entries)
LABELLING .................................................... Off
MULTIPLY ....................................................  Off
PME .......................................................... Off
SMOOTHING .................................................... Off
SPOT_HEIGHTS ................................................. Off
(Single point contours to be omitted from output)
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

ENABLE FRAME COMMAND

--------------------------------------------------------------------------------
ENABLE FRAME

--------------------------------------------------------------------------------
FORMAT: ENABLE FRAME

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

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

Causes DTICONTOUR to output a frame feature to the IFF file which represents the extent of the contour window defined by the WINDOW command.

If no WINDOW command is issued, the frame represents the boundary of the whole area covered by the DTI file.

The frame feature is given the feature code specified with the SET FRAME_FC command. In the absence of a SET FRAME_FC command, feature code 0 is used.

By default, DTICONTOUR does not create a frame feature.

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

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


DTICONTOUR> ENABLE FRAME<CR>
DTICONTOUR>

ENABLE INDEX COMMAND

--------------------------------------------------------------------------------
ENABLE INDEX

--------------------------------------------------------------------------------
FORMAT: ENABLE INDEX

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

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

ENABLE INDEX enables the user to cancel the effect of a previous DISABLE INDEX command. By default DTICONTOUR will always generate index contours.

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

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


DTICONTOUR> ENABLE INDEX<CR>
DTICONTOUR>

ENABLE LABELLING COMMAND

--------------------------------------------------------------------------------
ENABLE LABELLING

--------------------------------------------------------------------------------
FORMAT: ENABLE LABELLING

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

None

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

ENABLE LABELLING enable the user to instruct DTICONTOUR to generate label features for contours, index contours, and if ENABLE SPOT_HEIGHTS is specified, spot heights.

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

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


DTICONTOUR> ENABLE LABELLING<CR>
DTICONTOUR>

ENABLE MULTIPLYBY COMMAND

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

--------------------------------------------------------------------------------
FORMAT: ENABLE MULTIPLYBY constant

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

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

The ENABLE MULTIPLYBY enables the user to multiply all incoming DTI 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.

--------------------------------------------------------------------------------
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:


DTICONTOUR> ENABLE MULTIPLYBY 10.0<CR>
DTICONTOUR> SHOW ENABLE<CR>

ABSOLUTE ..................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... Off
FRAME ........................................................ Off
INDEX ........................................................ On
INTEGER_HEIGHT ............................................... Off
(Contour heights will be placed in type 3 AC entries)
LABELLING .................................................... Off
MULTIPLY ..................................................... On
Matrix heights to be multiplied by ........................... 10.0
PME .......................................................... Off
SMOOTHING .................................................... Off
SPOT_HEIGHTS ................................................. Off
(Single point contours to be omitted from output)
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

DTICONTOUR>

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.

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

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

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

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


$ DTICONTOUR<CR>
TVES module DTICONTOUR of 13:30:39 18-OCT-87
DTICONTOUR> ENABLE PME<CR>
DTICONTOUR>

ENABLE SMOOTH COMMAND

--------------------------------------------------------------------------------
ENABLE SMOOTH

--------------------------------------------------------------------------------
FORMAT: ENABLE SMOOTH iterations

--------------------------------------------------------------------------------
Command parameter:

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

ENABLE SMOOTH causes DTICONTOUR to apply a moving least squares filter to the contour strings generated during the matrix lacing process. The number of times that the filter is applied is controlled by the 'iterations' argument.

By default DTICONTOUR does not smooth the contour strings

Because linear interpolation is used in DTICONTOUR, areas of equal Z value may lead to the formation of contours resembling a "staircase", where the contour makes right angled turns. There is insufficient information for the simple algorithm to lace the contours relative to a more global context.

It is important to note that although cartographically unappealing, the contours produced by DTICONTOUR are "truth". Because linear interpolation is used, the contours represent what is really there in the DTI file, not the expression of a high order surface patch. The linear interpolation used is not only fast, but provides a powerful quality check on the DTI file contents.

--------------------------------------------------------------------------------
Message: None.

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


DTICONTOUR> ENABLE SMOOTH 3<CR> DTICONTOUR> SHOW ENABLE<CR>

ABSOLUTE ..................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... Off
FRAME ........................................................ Off
INDEX ........................................................ On
INTEGER_HEIGHT ............................................... Off
(Contour heights will be placed in type 3 AC entries)
LABELLING .................................................... Off
MULTIPLY ....................................................  Off
PME .......................................................... Off
SMOOTHING .................................................... On
Number of smoothing iterations................................ 3
SPOT_HEIGHTS ................................................. Off
(Single point contours to be omitted from output)
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

DTICONTOUR>

ENABLE SPOT_HEIGHTS COMMAND

--------------------------------------------------------------------------------
ENABLE SPOT_HEIGHTS

--------------------------------------------------------------------------------
FORMAT: ENABLE SPOT_HEIGHTS

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

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

It is possible that single DTI post values lying in peaks and troughs of the DTI surface, are at exactly the same height as a contour. This would result in the generation of a single point contour. As such features are conventionally represented by spot heights, the ENABLE SPOT_HEIGHTS option is provided to output any single point contours as spot height features to the IFF file.

By default, DTICONTOUR does not create spot height features; the single point features are discarded.

The spot height features are given the feature code specified with the SET SPOT_FC command. In the absence of a SET SPOT_FC command, feature code 1 is used.

Spot height features are always given labels if the ENABLE LABELLING option is selected. The feature code of the spot height label features is specified with the SET SPOT_LABEL_FC command argument. In the absence of a SET SPOT_LABEL_FC command, feature code 0 is used.

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

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


DTICONTOUR> SET SPOT_FC 23<CR>
DTICONTOUR> SET SPOT_LABEL_FC 3<CR>
DTICONTOUR> ENABLE SPOT_HEIGHTS<CR>
DTICONTOUR>

ENABLE TOFEET COMMAND

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

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

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

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

It is possible that the DTI input files may have heights recorded in a different measurement system to that required in the IFF output file. Two height conversion options are available: ENABLE TOMETRES and ENABLE TOFEET.

The ENABLE TOFEET command enables the conversion of input DTI file heights from feet to metres. It has the same effect as an explicit ENABLE MULTIPLYBY 3.2808455 command. The IFF file will then be produced in feet.

If one of the height modification options is selected using ENABLE MULTIPLYBY, ENABLE TOFEET etc_., you must give the contour interval and any ZLIMITS in the target measurement system or height range (ie feet for the ENABLE TOFEET command). Failure to do this may result in an unexpected density of contours!

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

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


DTICONTOUR> ENABLE TOFEET<CR>
DTICONTOUR>

ENABLE TOMETRES COMMAND

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

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

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

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

It is possible that the input DTI file may have heights recorded in different measurement systems to that required in the IFF output file. Two height conversion options are available: ENABLE TOFEET and ENABLE TOMETRES.

The ENABLE TOMETRES command results in the conversion of heights held in the DTI file in feet to metres. It has the same effect as an explicit ENABLE DIVIDEBY 3.2808455 command. The IFF contours will then be produced in metres.

If one of the height modification options is selected using ENABLE MULTIPLYBY, ENABLE TOMETRES etc_., you must give the contour interval and any ZLIMITS in the target measurement system or height range (ie metres for the ENABLE TOMETRES command). Failure to do this may result in an unexpected density of contours!

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

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


DTICONTOUR> ENABLE TOMETRES<CR>
DTICONTOUR>

FILEIN COMMAND

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

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

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

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

The FILEIN command opens and maps into memory a DTI file, containing the matrix data to be processed. Details derived from the header of the file are displayed on the terminal to confirm that the file has been successfully opened.

A FILEIN command must be issued before the UNITS, WINDOW, ZLIMITS or GO commands will be accepted.
If the logical name LSL$MATRIX_DEFAULT_WINDOW is defined with a value of "1", then a default area of interest defined in matrix units of bottom left hand corner 1,1 and top right hand corner 200,200 is set when the file is opened. If the logical name is absent or has any other value, or if the input DTI file has fewer than 200 columns or 200 rows, then a default window equivalent to the total matrix is set. The area of interest may be redefined using the command WINDOW.

--------------------------------------------------------------------------------
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:

DTICONTOUR> FILEIN 52N09E_DTED_UTM<CR>
DTI file LSL$DTI:52N09E_DTED_UTM.DTI;0 opened for read
File    :  LSL$DTI:52N09E_DTED_UTM.DTI;0
Header  :  LSLA  Data:  WORD
Units are metres
Matrix Coverage   SW:  500083.88 5761241.50    NE:  568683.88 5872941.50
Matrix Window     SW:  500083.88 5761241.50    NE:  568683.88 5872941.50
Matrix Interval    E:     100.00                N:     100.00
Value Range         :     4   to    434

DTICONTOUR>

GO COMMAND

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

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

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

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

The GO command can only be issued after FILEIN and IFF commands have been used.

The number of contours produced is controlled by the arguments supplied to the INTERVAL and INDEX_INTERVAL commands.

The type of contours produced is determined by using the ENABLE SMOOTH command. The default is to produce simple linear contours, which tend to wander in a "staircase" like manner in areas of low relief. If ENABLE SMOOTH is selected smoothed contours will result with the "staircases" suppressed.

On a heavily loaded computer it may be reassuring to ENABLE DIAGNOSTICS for the contouring stage of DTICONTOUR processing to indicate progress through the data set. A message indicating contouring progress is then issued as contours of each new contour height are generated.

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

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


DTICONTOUR> ENABLE DIAGNOSTICS<CR>
DTICONTOUR> GO<CR>

=====================  STARTING CONTOUR GENERATION  =====================
Units are metres
Matrix Coverage   SW:  500083.88 5761241.50    NE:  568683.88 5872941.50
Contouring window SW:  500083.88 5761241.50    NE:  568683.88 5872941.50
All heights between     4.000 and   434.000 will be contoured
               +------------------------+
               | Tracing index contours |
               +------------------------+
Tracing index contours with a height of   250.000
            +-------------------------------+
            | Tracing intermediate contours |
            +-------------------------------+
Tracing intermediate contours with a height of    50.000
Tracing intermediate contours with a height of   100.000
Tracing intermediate contours with a height of   150.000
Tracing intermediate contours with a height of   200.000
Tracing intermediate contours with a height of   300.000
Tracing intermediate contours with a height of   350.000
Tracing intermediate contours with a height of   400.000

ELAPSED: 00:05:25.84 CPU: 0:00:05.71 BUFIO: 281 DIRIO: 46 FAULTS: 263
_$

HELP COMMAND

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

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

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

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

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

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

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

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

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


DTICONTOUR> HELP ENABLE TOMETRES<CR>

DTICONTOUR

ENABLE

TOMETRES

DTICONTOUR>

IFF COMMAND

--------------------------------------------------------------------------------
IFF

--------------------------------------------------------------------------------
FORMAT: IFF file-spec

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

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

The IFF command enables specification of the IFF file which is to receive the contours.

The IFF command must be issued before the GO command.

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

The following messages are specific to the IFF command:


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

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


DTICONTOUR> IFF DUA3:[DEMONSTRATION]IDAHO<CR>
%LSLLIB-I-IFFOPENED, DUA3:[DEMONSTRATION]IDAHO_.IFF;6 opened for write
DTICONTOUR>

INTERVAL COMMAND

--------------------------------------------------------------------------------
INTERVAL

--------------------------------------------------------------------------------
FORMAT: INTERVAL interval

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

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

The INTERVAL argument specifies the height interval between successive contours.

Failure to set the contour interval will result in the application of a default interval of 10% of the height range within the area of the DTI file defined by the WINDOW command. If no WINDOW command is issued then 10% of the height range of the whole DTI file will be used. If ZLIMITS are specified, with or without the WINDOW command, then the default contour interval is 10% of the height range defined by the ZLIMITS arguments.

If you intend to use the TOMETRES, TOFEET, MULTIPLYBY, or DIVIDEBY options, ensure that you specify the contour interval relative to the TARGET measurement system. Failure to do this will result in far more (or less!) contours than you had bargained for!

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

*** ERROR *** Missing interval argument
Only one value please !
Taking first value only ('real')

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


DTICONTOUR> INTERVAL 10.0<CR>
DTICONTOUR>

INDEX_INTERVAL COMMAND

--------------------------------------------------------------------------------
INDEX_INTERVAL

--------------------------------------------------------------------------------
FORMAT: INDEX_INTERVAL interval

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

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

The INDEX_INTERVAL argument specifies the height interval between successive index contours. Index contours are given a different feature code (specified by the SET INDEX_FC command) in the IFF output file to enable them to be differentiated from other (or "intermediate") contours.

Failure to specify the index contour interval will result in the application of a default index interval of five times the ordinary contour interval.

If you intend to use the TOMETRES, TOFEET, MULTIPLYBY, or DIVIDEBY options, ensure that you specify the index contour interval relative to the TARGET measurement system. Failure to do this will result in far more (or less!) contours than you had bargained for!

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

*** ERROR *** Missing interval argument
Only one value please !
Taking first value only ('real')

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


DTICONTOUR> INTERVAL 10.0<CR>
DTICONTOUR> INDEX_INTERVAL 200.0<CR>
DTICONTOUR>

LABEL FLOAT COMMAND

--------------------------------------------------------------------------------
LABEL FLOAT

--------------------------------------------------------------------------------
FORMAT: LABEL FLOAT

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

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

LABEL FLOAT enables the user to specify that contour labels are to be displayed as floating point numbers. DTICONTOUR generates labels to 5 significant figures.

A very long floating point number will often fail the contour curve test (specified using LABEL MAXCURVE). If only zeros follow the decimal point, DTICONTOUR will display the label as an integer to increase the likelihood of the label site being acceptable.

Spot height labels are always displayed as floating point values.

By default DTICONTOUR will generate floating point labels. Integer labels are generated only if the LABEL INTEGER command is issued.

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

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


DTICONTOUR> LABEL FLOAT<CR>
DTICONTOUR>

LABEL INTEGER COMMAND

--------------------------------------------------------------------------------
LABEL INTEGER

--------------------------------------------------------------------------------
FORMAT: LABEL INTEGER

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

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

LABEL INTEGER enables the user to specify that contour labels are to be displayed as integer numbers.

Spot height labels are always displayed as floating point values.

By default DTICONTOUR will generate floating point labels. Integer labels are generated only if the LABEL INTEGER command is issued.

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

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


DTICONTOUR> LABEL INTEGER<CR>
DTICONTOUR>

LABEL INDEX_MODULUS COMMAND

--------------------------------------------------------------------------------
LABEL INDEX_MODULUS

--------------------------------------------------------------------------------
FORMAT: LABEL INDEX_MODULUS height

--------------------------------------------------------------------------------
Command parameter:

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

The LABEL INDEX_MODULUS command enables the user to specify a real (floating point) height to determine which index contours are to be considered for annotation. Only index contours which are exactly divisible by this value will be considered for labelling.

For example, if the user specifies that LABEL INDEX_MODULUS 100.0 is to be used in conjunction with an index contour interval of 50.0, every other index contour will be labelled.

By default an index height modulus of 1.0 is used, i.e. all index contours are considered for labelling.

A LABEL INDEX_MODULUS argument of zero will suppress labelling of index contours.

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

*** ERROR *** Missing modulus argument
Only one value please !
Taking first value only ('real')

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


DTICONTOUR> INTERVAL 10.0
DTICONTOUR> INDEX_INTERVAL 40.0
DTICONTOUR> LABEL INDEX_MODULUS 80.0<CR>
DTICONTOUR>

LABEL MAXCURVE COMMAND

--------------------------------------------------------------------------------
LABEL MAXCURVE

--------------------------------------------------------------------------------
FORMAT: LABEL MAXCURVE curve

--------------------------------------------------------------------------------
Command parameter:

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

LABEL MAXCURVE enables the user to alter the default parameter which defines the maximum rate of change of curvature along along a line before that section of line is considered to be unsuitable for labelling.

The acceptable range of values for LABEL MAXCURVE is 0.0 to 1.0. As LABEL MAXCURVE approaches 0.0, less and less labelling will be output because the tolerance of curve sharpness is decreased. A LABEL MAXCURVE value of 1.0 will result in labelling being output regardless of curve sharpness. The default value is 0.7

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

*** ERROR *** Missing maximum curvature argument
Only one value please !
Taking first value only ('real')

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


DTICONTOUR> LABEL MAXCURVE 0.3<CR>
DTICONTOUR>

LABEL MINGAP COMMAND

--------------------------------------------------------------------------------
LABEL MINGAP

--------------------------------------------------------------------------------
FORMAT: LABEL MINGAP distance

--------------------------------------------------------------------------------
Command parameter:

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

The LABEL MINGAP argument specifies the minimum distance travelled along a contour before DTICONTOUR will begin looking for a suitable site for label insertion. By default DTMCREATE uses 10% of the maximum (x,y) axis of the window defined by the WINDOW command. If no WINDOW command is issued, then 10% of the maximum (x,y) axis of the whole DTI file is used.

The relationship between the LABEL MINGAP argument value and the frequency of labels occurring along a contour line can be subtle. If the LABEL MINGAP argument is too big, DTICONTOUR may be unable to label any contours because the contours are shorter then the LABEL MINGAP distance. Less obvious, however, is the interaction between a dense contour pattern and a large LABEL MINGAP distance. Because the inter-contour gap is smaller in a dense contour map there will be fewer sites suitable for the insertion of labels anyway. If, in addition a large LABEL MINGAP value is specified, many of the possible label sites will be rendered unsuitable. The net result is a contour map with few or no labels. As a general rule of thumb, the LABEL MINGAP value should be lowered for DTI files defining dense contour areas.

If there is wide variation in contour density between sub-areas of the DTI file, the contours should be generated using several DTICONTOUR runs, each with a different window and a LABEL MINGAP value appropriate to the contour density. The windows should not overlap. When all the windows are complete, the IFF contour files can be edge butted together using the IMP (IFF Map Processing) package utility IMERGE.

As linear interpolation is used for contour generation, edge matching should be perfect. Some edge matching imperfections may be introduced, however, by the ENABLE SMOOTH option in areas of little or no relief variation.

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

*** ERROR *** Missing label minimum gap argument
Only one value please !
Taking first value only ('real')

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


DTICONTOUR> LABEL MINGAP 130.0<CR>

LABEL MODULUS COMMAND

--------------------------------------------------------------------------------
LABEL MODULUS

--------------------------------------------------------------------------------
FORMAT: LABEL MODULUS height

--------------------------------------------------------------------------------
Command parameter:

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

The LABEL MODULUS command enables the user to specify a real (floating point) height to determine which intermediate (i.e. non-index) contours are to be considered for labelling. Only intermediate contours which are exactly divisible by this value will be considered for labelling.

For example, if the user specifies that LABEL MODULUS 10.0 is to be used in conjunction with a contour interval of 5.0, every other contour will be labelled.

By default a height modulus of 1.0 is used, i.e. all intermediate contours are considered for labelling.

A LABEL MODULUS argument of zero will suppress labelling of intermediate contours.

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

*** ERROR *** Missing modulus argument
Only one value please !
Taking first value only ('real')

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


DTICONTOUR> INTERVAL 10.0<CR>
DTICONTOUR> INDEX_INTERVAL 40.0<CR>
DTICONTOUR> LABEL MODULUS 10.0<CR> ! label all contours

LABEL SIZE COMMAND

--------------------------------------------------------------------------------
LABEL SIZE

--------------------------------------------------------------------------------
FORMAT: LABEL SIZE size

--------------------------------------------------------------------------------
Command parameter:

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

The LABEL SIZE argument enables the user to alter the default size for contour labels. This default is calculated as 0.5% of the DTI maximum (x,y) range. The value displayed by the SHOW LABELLING command is the height of the label characters in IFF output file units. New label sizes should always be expressed in terms of output IFF file units, bearing in mind of course the contour density and legibility requirements.

The LABEL SIZE argument actually specifies the height of the label characters, the character width is calculated to be 0.7 of the character height.

It is most important that the user appreciates the relationship between the contour label size and the frequency of labels occurring along a contour line. If the label size is too big, DTICONTOUR will be able to fit the label into the gap between adjacent contours less often than in the case when the label size is small. Clearly, a dense contour map will offer less opportunities for labelling than a contour map having few contours, and even fewer opportunities if the label size is big.

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

*** ERROR *** Missing label size argument
Only one value please !
Taking first value only ('real')

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


DTICONTOUR> LABEL SIZE 3.0<CR>
DTICONTOUR>

PAUSE COMMAND

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

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

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

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

Pauses DTICONTOUR 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:


DTICONTOUR> PAUSE<CR>


Press to continue<CR>
DTICONTOUR>

QUIT COMMAND

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

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

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

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

The QUIT command causes DTICONTOUR to exit immediately, closing all input files and closing and deleting the output IFF file.

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

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

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

DTICONTOUR> QUIT<CR>
ELAPSED: 00:00:20.04 CPU: 0:00:04.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:


DTICONTOUR> @FLOW2<CR>
DTICONTOUR> ENABLE DIAGNOSTICS
DTICONTOUR> RETURN
DTICONTOUR>

SET CONTOUR_FC COMMAND

--------------------------------------------------------------------------------
SET CONTOUR_FC

--------------------------------------------------------------------------------
FORMAT: SET CONTOUR_FC feature-code

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

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

SET CONTOUR_FC enables the user to specify the feature code to be used for ordinary contours. By default, a feature code of 0 is assumed for ordinary (or "intermediate") contours and index contours.

When choosing a feature code for contours, ensure that the feature code is in the FRT file which is to be used for plotting the contours and that the feature code has an appropriate graphical type.

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

*** WARNING *** Feature codes must lie in the range 0 to 32767.

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


DTICONTOUR> SET CONTOUR_FC 209<CR>
DTICONTOUR>

SET FRAME_FC COMMAND

--------------------------------------------------------------------------------
SET FRAME_FC

--------------------------------------------------------------------------------
FORMAT: SET FRAME_FC feature-code

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

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

SET FRAME_FC enables the user to specify the feature code to be used for the optional plot frame. By default, a feature code of 0 is assumed for the frame.

When choosing a feature code for the frame, ensure that the feature code is in the FRT file which is to be used for plotting the data and that the feature code has an appropriate graphical type.

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

*** WARNING *** Feature codes must lie in the range 0 to 32767.

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


DTICONTOUR> SET FRAME_FC 209<CR>
DTICONTOUR>

SET INDEX_FC COMMAND

--------------------------------------------------------------------------------
SET INDEX_FC

--------------------------------------------------------------------------------
FORMAT: SET INDEX_FC feature-code

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

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

SET INDEX_FC enables the user to specify the feature code to be used for index contours. By default, a feature code of 0 is assumed for both ordinary (or "intermediate") contours and index contours.

When choosing a feature code for index contours, ensure that the feature code is in the FRT file which is to be used for plotting the contours and that the feature code has an appropriate graphical type.

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

*** WARNING *** Feature codes must lie in the range 0 to 32767.

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


DTICONTOUR> SET INDEX_FC 209<CR>
DTICONTOUR>

SET INDEX_LABEL_FC COMMAND

--------------------------------------------------------------------------------
SET INDEX_LABEL_FC

--------------------------------------------------------------------------------
FORMAT: SET INDEX_LABEL_FC feature-code

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

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

SET INDEX_LABEL_FC enables the user to specify the feature code to be used for index contour label features. By default, a feature code of 0 is assumed for label features on index contours.

When choosing a feature code for index contour label features, ensure that the feature code is in the FRT file which is to be used for plotting the contours and that the feature code has an appropriate graphical type.

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

*** WARNING *** Feature codes must lie in the range 0 to 32767.

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


DTICONTOUR> SET INDEX_LABEL_FC 209<CR>
DTICONTOUR>

SET LABEL_FC COMMAND

--------------------------------------------------------------------------------
SET LABEL_FC

--------------------------------------------------------------------------------
FORMAT: SET LABEL_FC feature-code

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

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

SET LABEL_FC enables the user to specify the feature code to be used for ordinary (or "intermediate") contour label features. By default, a feature code of 0 is assumed for label features on ordinary contours.

When choosing a feature code for label features, ensure that the feature code is in the FRT file which is to be used for plotting the contours and that the feature code has an appropriate graphical type.

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

*** WARNING *** Feature codes must lie in the range 0 to 32767.

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


DTICONTOUR> SET LABEL_FC 209<CR>
DTICONTOUR>

SET LAYER COMMAND

--------------------------------------------------------------------------------
SET LAYER

--------------------------------------------------------------------------------
FORMAT: SET LAYER layer-number

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

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

SET LAYER enables the user to specify the number of the layer which is to contain the contour features. By default, layer 1 is created.

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

*** WARNING *** Layer numbers must lie in the range 0 to 32767.

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


DTICONTOUR> SET LAYER 1008<CR>
DTICONTOUR>

SET SCALE COMMAND

--------------------------------------------------------------------------------
SET SCALE

--------------------------------------------------------------------------------
FORMAT: SET SCALE scale

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

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

The scale field in the MD is by default set to 50000, as this information is unavailable in the DTI file header. The user may override this default scale by use of the SET SCALE command. The argument to the SET SCALE command should be specified as an integer value to represent the denominator of the scale fraction, thus a desired scale of 1:250000 must be specified as 250000.

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

*** WARNING *** Illegal SCALE value 'number'

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


DTICONTOUR> SET SCALE 100000<CR>
DTICONTOUR>

SET SPOT_FC COMMAND

--------------------------------------------------------------------------------
SET SPOT_FC

--------------------------------------------------------------------------------
FORMAT: SET SPOT_FC feature-code

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

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

SET SPOT_FC enables the user to specify the feature code to be used for spot heights. By default, a feature code of 1 is assumed for spot height features.

When choosing a feature code for spot heights, ensure that the feature code is in the FRT file which is to be used for plotting the spot heights and that the feature code has an appropriate graphical type, i_.e_. unorientated symbol.

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

*** WARNING *** Feature codes must lie in the range 0 to 32767.

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


DTICONTOUR> SET SPOT_FC 2<CR>
DTICONTOUR>

SET SPOT_LABEL_FC COMMAND

--------------------------------------------------------------------------------
SET SPOT_LABEL_FC

--------------------------------------------------------------------------------
FORMAT: SET SPOT_LABEL_FC feature-code

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

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

SET SPOT_LABEL_FC enables the user to specify the feature code to be used for label features relating to spot heights. By default, a feature code of 0 is assumed for label features on spot heights.

When choosing a feature code for label features, ensure that the feature code is in the FRT file which is to be used for plotting the contours and that the feature code has an appropriate graphical type.

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

*** WARNING *** Feature codes must lie in the range 0 to 32767.

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


DTICONTOUR> SET SPOT_LABEL_FC 209<CR>
DTICONTOUR>

SHOW COMMAND

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

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

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

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

SHOW enables the user to examine the current status of the DTICONTOUR defaults, e.g. SHOW FILES will give the current status of the contouring window parameters and input and output files; SHOW SETTINGS will show the current status of the settings made for the IFF file with SET commands, etc.

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

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

$ DTICONTOUR<CR>
DTMCREATE module DTICONTOUR of 09:13:58 18-NOV-87
DTICONTOUR> SHOW ENABLE<CR>
ABSOLUTE ..................................................... On
DIAGNOSTICS .................................................. Off
DIVIDEBY ..................................................... Off
FRAME ........................................................ Off
INDEX ........................................................ On
INTEGER_HEIGHT ............................................... Off
(Contour heights will be placed in type 3 AC entries)
LABELLING .................................................... Off
MULTIPLY ....................................................  Off
PME .......................................................... Off
SMOOTHING .................................................... Off
SPOT_HEIGHTS ................................................. Off
(Single point contours to be omitted from output)
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

DTICONTOUR> QUIT<CR> ELAPSED: 0 00:00:19.08 CPU: 0:00:04.95 BUFIO: 10 DIRIO: 111 FAULTS: 68 _$

SPAWN COMMAND

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

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

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

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

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

--------------------------------------------------------------------------------
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 DTICONTOUR

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


DTICONTOUR> SPAWN DIRECTORY *_.DTI;*<CR>

Directory DUA3:[TVES.ACCEPTANCE_TESTS]
TEST1_.DTI;1              8/8       18-Oct-1987 07:56  [LSL,TIM]
TEST2_.DTI;2              7/8       18-Oct-1987 17:17  [LSL,TIM]
TEST2_.DTI;1              7/8       18-Oct-1987 17:07  [LSL,TIM]
Total of 3 files, 22/24 blocks.

DTICONTOUR>

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 an area of interest in the input DTI file using the WINDOW command, or in what units of measurement details from the header of the DTI file are displayed using the SHOW FILES command.
The command should be given after defining the input DTI file, since an appropriate default units of measurement is set up whenever an input DTI file is opened, (see general Description).

The command may also be used to define the units of measurement in the output IFF file. If matrix units are currently selected, the coordinates in the IFF file are recorded as real (floating point) column and row values; if metres or projection units are selected before giving the GO command, the IFF data is recorded as metre or projection unit coordinate values.

The following rules are applied when testing the validity of a UNITS command argument supplied by the user:

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

The following error messages are specific to the UNITS command:

*** ERROR *** Specifying command UNITS
Command qualifiers are MATRIX,METRES,PROJECTION,SECONDS or LATLONG
*** ERROR *** Specifying command UNITS
Command qualifier is invalid for the input file
*** WARNING  *** Specifying command UNITS
                You must use the FILEIN command to specify the input
                DTI file first

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


DTICONTOUR> UNITS MATRIX<CR>
DTICONTOUR>

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:


DTICONTOUR> WAIT 4.0<CR>
DTICONTOUR>

WINDOW COMMAND

--------------------------------------------------------------------------------
WINDOW

--------------------------------------------------------------------------------
FORMAT: WINDOW xmin ymin xmax ymax

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

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

The command is used to define rectangular limits to the area of data to be included within the contouring. The limits must be specified in the order bottom left hand (or south west) corner then top right hand (or north east) corner.

The WINDOW command is used to limit the contouring process to a specified area of interest in the DTI file.

The area of interest should lie within the bounds of the DTI file.

If the logical name LSL$MATRIX_DEFAULT_WINDOW is defined with a value of "1", then a default area of interest defined in matrix units of bottom left hand corner 1,1 and top right hand corner 200,200 is set when the file is opened. If the logical name is absent or has any other value, or if the input DTI file has fewer than 200 columns or 200 rows, then a default window equivalent to the total matrix is set.

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

The following warning messages are specific to the WINDOW command:


*** WARNING **** Unable to read WINDOW arguments
*** WARNING **** 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:


DTICONTOUR> UNITS LATLONG<CR>
DTICONTOUR> WINDOW 52 10 00.0N 06 00 00.0E 52 30 00.0N 06 30 00.0E<CR>
DTICONTOUR>

ZLIMITS COMMAND

--------------------------------------------------------------------------------
ZLIMITS

--------------------------------------------------------------------------------
FORMAT: ZLIMITS real1 real2

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

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

The ZLIMITS command enables the user to specify that contouring is only to be done between the stated minimum and maximum Z values. Heights that lie outside the specified limits will not be contoured.

IMPORTANT

If one of the height modification options is selected 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 a lot more (or less) contours than you expected!

--------------------------------------------------------------------------------
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

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


DTICONTOUR> SHOW WINDOW<CR>
XMIN = 0.0 XMAX = 100.0 YMIN = 0.0 YMAX = 100.0
Z-limits currently undefined
DTICONTOUR> ZLIMITS 0 850<CR>
DTICONTOUR> SHOW WINDOW<CR>
Xmin = 0.0 Xmax = 100.0 Ymin = 0.0 Ymax = 100.0
Zmin= 0.000 Zmax= 850.000
DTICONTOUR>

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

EXAMPLES

$ $ DTICONTOUR<CR> DTMCREATE module DTICONTOUR of 15:02:26 16-NOV-87 DTICONTOUR> FILEIN 52N09E_DTED_UTM<CR> DTI file LSL$DTI:52N09E_DTED_UTM.DTI;0 opened for read File : LSL$DTI:52N09E_DTED_UTM.DTI;0 Header : LSLA Data: WORD Units are metres Matrix Coverage SW: 500083.88 5761241.50 NE: 568683.88 5872941.50 Matrix Window SW: 500083.88 5761241.50 NE: 568683.88 5872941.50 Matrix Interval E: 100.00 N: 100.00 Value Range : 4 to 1104 DTICONTOUR> IFF 5209_WORD<CR> %LSLLIB-I-IFFOPENED, LSL$SOURCE_ROOT:[TVES.DTICONTOUR]5209_WORD.IFF;2 opened for write DTICONTOUR> WINDOW 500083.88 5761241.50 538683.88 5802941.50<CR> DTICONTOUR> ENABLE SMOOTH 2<CR> DTICONTOUR> ENABLE FRAME<CR> DTICONTOUR> SET FRAME_FC 2<CR> DTICONTOUR> SET FC 5<CR> DTICONTOUR> SET INDEX_FC 3<CR> DTICONTOUR> SET LABEL_FC 1<CR> DTICONTOUR> SET INDEX_LABEL_FC 1<CR> DTICONTOUR> ENABLE SPOT<CR> DTICONTOUR> SET SPOT_FC 4<CR> DTICONTOUR> SET SPOT_LABEL_FC 1<CR> DTICONTOUR> INTERVAL 50<CR> DTICONTOUR> INDEX_INTERVAL 250<CR> DTICONTOUR> ENABLE LABELLING<CR> DTICONTOUR> LABEL SIZE 120<CR> DTICONTOUR> LABEL MINGAP 2000<CR> DTICONTOUR> LABEL MAXCURVE 0.75<CR> DTICONTOUR> LABEL MODULUS 0 ! don't label intermediate contours<CR> DTICONTOUR> LABEL INDEX_MODULUS 250 ! but do label all index ones<CR> DTICONTOUR> LABEL INTEGER<CR> DTICONTOUR> ENABLE DIAGNOSTICS<CR> DTICONTOUR> GO ! go!<CR> ===================== STARTING CONTOUR GENERATION ===================== Units are metres Matrix Coverage SW: 500083.88 5761241.50 NE: 568683.88 5872941.50 Contouring window SW: 500083.88 5761241.50 NE: 538683.88 5802941.50 All heights between 4.000 and 1104.000 will be contoured +------------------------+ | Tracing index contours | +------------------------+ Tracing index contours with a height of 250.000 Tracing index contours with a height of 500.000 Tracing index contours with a height of 750.000 Tracing index contours with a height of 1000.000 +-------------------------------+ | Tracing intermediate contours | +-------------------------------+ Tracing intermediate contours with a height of 50.000 Tracing intermediate contours with a height of 100.000 Tracing intermediate contours with a height of 150.000 Tracing intermediate contours with a height of 200.000 Tracing intermediate contours with a height of 300.000 Tracing intermediate contours with a height of 350.000 Tracing intermediate contours with a height of 400.000 Tracing intermediate contours with a height of 450.000 Tracing intermediate contours with a height of 550.000 Tracing intermediate contours with a height of 600.000 Tracing intermediate contours with a height of 650.000 Tracing intermediate contours with a height of 700.000 Tracing intermediate contours with a height of 800.000 Tracing intermediate contours with a height of 850.000 Tracing intermediate contours with a height of 900.000 Tracing intermediate contours with a height of 950.000 Tracing intermediate contours with a height of 1050.000 Tracing intermediate contours with a height of 1100.000 ELAPSED: 0 00:16:15.77 CPU: 0:10:05.76 BUFIO: 103 DIRIO: 4683 FAULTS: 36493 $

DTICONTOUR messages

See dticontourmsg.html generated from DTICONTOURMSG.RNO.