--------------------------------------------------------------------------------
MODULE DTIEDIT
--------------------------------------------------------------------------------
REPLACES MATRIX module DTI
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
$ DTIEDIT
--------------------------------------------------------------------------------
DTIEDIT is an interactive, command driven program. Command input is expected when the following prompt is issued:
DTIEDIT>
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
The program will handle all types of digital terrain image headers, and currently supported data formats (ie. bit,byte,word,longword and real).
The matrix is displayed as an image of up to 26 classes, with each class (ie. band of values) being represented by an alphabetic character (lowest A, highest Z). The class interval may be varied using the STEP command, while the range of values displayed may be defined using the LIMITS command.
The area of the matrix displayed, and available for editing, is determined using the ORIGIN command. It is possible to set the number of columns shown on the screen to either 80 or 132, and to scroll the display in the y direction using the keypad.
Two different modes of operation may be distinguished. Command line mode is used to issue program commands such as FILEIN and ORIGIN, while keypad mode is used to interact with the displayed data. The two modes of operation are described below.
--------------------------------------------------------------------------------
The commands that may be issued are documented in detail in the section on DTIEDIT commands. Commands are available to:
--------------------------------------------------------------------------------
On giving the command, the DTI data is displayed on the screen as a series of characters. A different character is used for each separate value step. Character A is used to represent a value at the bottom of the range; character Z to represent a value at the top of the range. The characters _+ and _- are used to indicate a data value that is either above or below the data display limits. Matrix points with a value of 0 are displayed using a space (ie. as an absent character).
Information on the current position of the screen cursor, and the data value at the matrix position, is shown on the bottom line of the screen. This information will change as the cursor is interactively moved around the matrix display.
Following the display of the matrix on the screen, the keypad keys (on the right of the keyboard) may be used to move the screen cursor around the display, and to edit the matrix data.
The keypad keys have the following meanings:
+---------------------------------------------------+ | PF1 | PF2 | PF3 | PF4 | | | | | | | | | | | | | | | | | undefined | undefined | undefined | undefined | | | | | | |------------|------------|------------|------------| | 7 | 8 | 9 | - | | | | | | | | | | | | up _& left | up | up _& right | edit | | | | | | |------------|------------|------------|------------| | 4 | 5 | 6 | , | | | | | | | | | | return to | | left | undefined | right | command | | | | | line mode | |------------|------------|------------|------------| | 1 | 2 | 3 | Enter | | | | | | | | | | | |down _& left | down |down _& right| | | | | | | |------------|------------|------------| | | 0 | . | undefined | | | | | | | define | | | undefined | edit | | | | rectangle | |
|_________________________|____________|____________|The keypad keys 1 2 3 4 6 7 8 9 are used to move the screen cursor around the display. The arrow keys to the left of the keypad may also be used for this purpose.
Keypad key '_,' is used to return to command line mode.
Keypad key '_.' may be used to select a rectangle in the matrix for
editing. The key selects the bottom left hand corner of the area to be
edited. Moving the cursor up or to the right of this point causes a
rectangle to be pulled out in reverse video. If the edit key is now
pressed (see below), all matrix points displayed in reverse video may be
changed to a new value.
Keypad key '_-' is used to edit a single matrix data value, or all data
values in a rectangular area (if an area has been defined using the '_.'
key). On pressing the key you will be prompted for a new data value on
the bottom of the screen.
Editing of the matrix values is only possible if the ENABLE EDIT command has
been previously given in command line mode. An indication of whether it is
possible to edit the matrix values, is shown on the bottom line of the screen.
If an attempt to edit a matrix point using the '_-' key is made when
editing is not enabled, an error message is generated.
If the '_-' key is pressed, you will be prompted for a matrix
value. The value is specified either
using the numeric keyboard keys '+-1234567890.'
or by means of the alpha keys A - Z. In the latter case, the character
will be translated into a number defining the top of the band.
The value is written to the matrix by means of the
In most situations, it is advisable to define a new value using the numeric
keys.
The number supplied must be valid for the type of data held in the DTI file,
and is validated against the following ranges:
The
To leave a matrix value unchanged, and return control to the keypad, simply
press
--------------------------------------------------------------------------------
Take command input from the specified file.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
file-spec
The file to be opened and used for command input.
Any parts of the file-spec not supplied will be taken from the default
specification 'SYS$DISK:[].COM;0'.
--------------------------------------------------------------------------------
DTIEDIT offers the facility of command input from an indirect command
file. The '@' character preceding a file-spec will cause DTIEDIT 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 DTIEDIT will echo all commands
read from an indirect command file.
--------------------------------------------------------------------------------
The following messages are specific to the _@ command:
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Treat all text to the right of the '!' as a comment.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
comment text
text that is to be treated as a comment and which will be excluded from
command interpretation.
--------------------------------------------------------------------------------
An exclamation mark is the standard MATRIX 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.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
The CHANGE command is used to transfer control from command line mode to
keypad mode.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
The CHANGE command transfers control from command line mode to keypad
mode.
Once the matrix has been displayed, it is possible to move the cursor
around the screen using the appropriate keypad commands. If the command
ENABLE EDIT has been previously specified, it is also possible to
interactively edit the DTI data values. The introductory section provides full
details on available keypad commands.
Control may be transferred back to command line mode using the keypad key
',' or by using
Note that the CHANGE command cannot be given from an indirect command
file.
--------------------------------------------------------------------------------
The following messages are specific to the CHANGE command:
--------------------------------------------------------------------------------
DTIEDIT>CHANGE<CR>
--------------------------------------------------------------------------------
Cancels a previous ENABLE BELL command
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
DISABLE BELL turns off the audible warning that is normally given when
an attempt is made to move the screen cursor beyond the lefthand or righthand
edge of the screen, or outside the bounds of the DTI data area.
The current status of the option may be examined using the SHOW DISPLAY
command.
--------------------------------------------------------------------------------
The following messages are specific to the DISABLE command:
--------------------------------------------------------------------------------
DTIEDIT>DISABLE BELL<CR>
--------------------------------------------------------------------------------
Disables the editing of DTI data values.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
DISABLE EDIT is used to disable the editing of DTI data values. If
EDIT is disabled, any attempt to change a data value using a command line EDIT
command, or using the keypad key '-' in keypad mode, will be disallowed, and
will cause the error message Edit option is not enabled to be displayed.
By default editing of the matrix is disabled, and if required must be
enabled using the ENABLE EDIT command.
The current status of the option may be examined using the SHOW DISPLAY
command.
--------------------------------------------------------------------------------
The following messages are specific to the DISABLE command:
--------------------------------------------------------------------------------
DTIEDIT>DISABLE EDIT<CR>
--------------------------------------------------------------------------------
Changes the value of all matrix points in a rectangular area to a
specified value.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
xmin ymin
xmax ymax
data_value
--------------------------------------------------------------------------------
The EDIT AREA command is used to change the value of all matrix points in
a rectangular area to a specified value.
The coordinates of the defining rectangle must lie within the bounds of
the DTI file data area.
Note, that as with all DTI edit commands, the edit is performed
immediately and 'in situ' on the current DTI file.
--------------------------------------------------------------------------------
The following messages are specific to the EDIT and EDIT AREA commands:
DTIEDIT>EDIT AREA 1 1 34 45 345<CR>
--------------------------------------------------------------------------------
Changes the value of all matrix points along the defined line to a
specified value.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
xstart ystart
xend yend
data_value
--------------------------------------------------------------------------------
The EDIT LINE command is used to change the value of all matrix points
along the defined line to a specified value.
The start and end points of the line must lie within the bounds of the
DTI file data area.
Note, that as with all DTI edit commands, the edit is performed
immediately and 'in situ' on the current DTI file.
--------------------------------------------------------------------------------
The following messages are specific to the EDIT and EDIT LINE commands:
DTIEDIT>EDIT LINE 12 24 34 45 345<CR>
--------------------------------------------------------------------------------
Changes a single matrix point to a specified value.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
x_coord y_coord
data_value
--------------------------------------------------------------------------------
The EDIT POINT command is used to change the value of a single matrix
point to a specified value.
The point must lie within the bounds of the DTI file data area.
Note, that as with all DTI edit commands, the edit is performed
immediately and 'in situ' on the current DTI file.
--------------------------------------------------------------------------------
The following messages are specific to the EDIT and EDIT POINT commands:
DTIEDIT>EDIT POINT 34 45 345<CR>
--------------------------------------------------------------------------------
Enables the output of an audible warning when an attempt is made to move
the cursor outside the display area.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
ENABLE BELL selects the output of an audible warning when an attempt is
made to move the screen cursor beyond the lefthand or righthand edge of the
screen, or outside the bounds of the DTI data area.
By default the option is selected, and may be disabled using the DISABLE
BELL command.
--------------------------------------------------------------------------------
The following messages are specific to the ENABLE command:
--------------------------------------------------------------------------------
DTIEDIT>ENABLE BELL<CR>
--------------------------------------------------------------------------------
Enables the option to edit matrix values using the EDIT commands, or
interactively when in change mode.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
ENABLE EDIT selects the option of editing matrix values. By default
editing of the matrix is disabled. The ENABLE EDIT command must therefore
be given in order to use the various command line EDIT commands, or in order
to edit values when in keypad mode.
The current status of the option may be examined using the SHOW DISPLAY
command.
--------------------------------------------------------------------------------
The following messages are specific to the ENABLE command:
--------------------------------------------------------------------------------
DTIEDIT>ENABLE EDIT<CR>
--------------------------------------------------------------------------------
Terminates the program.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
The EXIT command is used to exit from DTIEDIT.
If the values in the DTI file have been edited such that the minimum and
maximum value range has been changed, the range values in the header of the
DTI file will be updated before the file is closed.
--------------------------------------------------------------------------------
The following message is specific to the EXIT command:
--------------------------------------------------------------------------------
DTIEDIT>EXIT
$
--------------------------------------------------------------------------------
Selects and opens the input DTI file.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
file-spec
The specification for the input DTI file.
--------------------------------------------------------------------------------
The FILEIN command opens and maps into memory a DTI file.
On reading a file, the values associated with the ORIGIN command are set
to column 1, row 1, and the data value range in the file is used to calculate
a default display step interval. The values associated with the LIMITS
command are set to the minimum and maximum data values contained in the
header.
--------------------------------------------------------------------------------
The following error message is specific to the FILEIN command:
--------------------------------------------------------------------------------
DTIEDIT>FILEIN TEST
--------------------------------------------------------------------------------
Give help on a subject
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
command
The command on which help is required.
--------------------------------------------------------------------------------
A brief description is given of the function and format of the specified
command.
The information is extracted from the DTIEDIT section of the MATRIX
help library, LSL$HELP:MATRIX.HLB.
If no parameter is specified, a list of all the commands available
in DTIEDIT is displayed.
--------------------------------------------------------------------------------
Where required, warning messages are output via the VMS LBR$OUTPUT_HELP
utility.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Defines lower and upper data display limits.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
lower_value upper_value
--------------------------------------------------------------------------------
The LIMITS command is used to define lower and upper data display limits.
When the CHANGE command is given, any data value that lies below the
lower limit is shown using the character '-', while a data value above the
upper limit is shown as the character '+'.
By default the LIMITS values are set to the minimum and maximum data
values in the DTI file, when the file is opened. The LIMITS command is
used to change these defaults, while the RESET LIMITS command may be used
to reset to the default values.
Note that if the data display range specified with the LIMITS command,
when taken in conjunction with the current STEP value, results in the
generation of more than 26 step intervals, the STEP value is adjusted
appropriately.
After giving the LIMITS command, details of the current limits and
step values, are shown on the terminal.
--------------------------------------------------------------------------------
The following messages are specific to the LIMITS command:
DTIEDIT>LIMITS 120 550<CR>
--------------------------------------------------------------------------------
Defines the display origin.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
x_coord y_coord
--------------------------------------------------------------------------------
The ORIGIN command is used to define the origin of the display. The
coordinate values supplied with the command determine which area of the
matrix will be displayed on the screen. The specified matrix point will appear
at the bottom lefthand corner of the screen when the matrix is displayed
using the CHANGE command.
The coordinates supplied with the command must lie within the
bounds of the DTI file.
The number of columns of data displayed is dependent on the size of
the matrix and the current screen width defined using the SET SCREEN command.
--------------------------------------------------------------------------------
The following messages are specific to the ORIGIN command:
DTIEDIT>ORIGIN 120 50<CR>
--------------------------------------------------------------------------------
Outputs an area of the matrix in a classified form, to a printer or
to a specified file.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
number_columns
number_rows
file_spec
--------------------------------------------------------------------------------
The PRINT command is used to output the whole or part of the DTI file,
either to a disk file, or to a printer on SYS$PRINT. The data values are
output in the same classified form as they would appear on the screen if
the CHANGE command is given.
The area output is determined by the current ORIGIN values, and by
the parameter arguments.
The number of columns output may not exceed 132. The number of columns
will be truncated if necessary. There is no restriction on the number of
rows that may be output.
Current LIMITS and STEP values are used to determine the representation
of the matrix values.
--------------------------------------------------------------------------------
The following messages are specific to the PRINT command:
DTIEDIT>PRINT 100 100<CR>
--------------------------------------------------------------------------------
Sets the lower and upper data display limits to the minimum and
maximum data values in the DTI file.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
The command RESET LIMITS is used to set the lower and upper matrix
display limits to the minimum and maximum data values in the DTI file. The
command is generally used to return to the default values, when the lower and
upper display values have been previously set using the LIMITS command, or
to set the limits to be equal to new DTI minimum and maximum values.
Note that if the data display range when taken in conjunction with the
current STEP value, results in the generation of more than 26 step intervals,
the STEP value is adjusted appropriately.
After giving the RESET LIMITS command, details of the current limits and
step values, are shown on the terminal.
--------------------------------------------------------------------------------
The following messages are specific to the RESET and RESET LIMITS commands:
--------------------------------------------------------------------------------
DTIEDIT>RESET LIMITS
DTIEDIT>
--------------------------------------------------------------------------------
Determines the minimum and maximum data values in the DTI file.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
The command RESET MINMAX is used to determine the minimum and maximum
data values in the DTI file. The command is generally used to recalculate
the minimum and maximum range following a series of edit commands, and
often preceding a RESET LIMITS command. The newly determined values
are written to the header of the DTI file.
Note, that if any edits are performed on the DTI file, and no RESET
MINMAX command is given before the EXIT command is used, the
minimum and maximum data values will be calculated before closing the DTI
file.
The message Determining minimum and maximum values - please wait
indicates that the data values are being calculated.
After giving the RESET MINMAX command, details from the DTI header
are output to the terminal.
--------------------------------------------------------------------------------
The following messages are specific to the RESET and RESET MINMAX commands:
--------------------------------------------------------------------------------
DTIEDIT>RESET MINMAX
DTIEDIT>
--------------------------------------------------------------------------------
Calculates a default display step interval from the current lower and
upper limit values.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
The command RESET STEP is used to calculate a default display step
interval. The step interval is calculated using the the current lower and
upper limit values. The procedure involves divided the current limit range by
26.
After giving the RESET STEP command, details of the current limits and
step values, are shown on the terminal.
--------------------------------------------------------------------------------
The following messages are specific to the RESET and RESET STEP commands:
--------------------------------------------------------------------------------
DTIEDIT>RESET STEP
DTIEDIT>
--------------------------------------------------------------------------------
Restores command input from an indirect command file to SYS$COMMAND.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Restores command input from an indirect command file to SYS$COMMAND.
A typical application is to use an indirect command file to set up a
number of run time defaults for a flowline, and then return to input from the
terminal for the run specific commands. To do this RETURN must be the last
command in the indirect command file.
A RETURN command is only valid if present in a command file.
--------------------------------------------------------------------------------
The following messages are specific to the RETURN command:
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
The SET SCREEN command sets the width of the terminal screen. A width
of 80 or 132 characters may be selected.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
width
The screen width. An integer value of 80 or 132 is required.
--------------------------------------------------------------------------------
The SET SCREEN command is to change the the width of the terminal screen.
A width of 80 or 132 characters may be selected. The width value is used when
the matrix values are displayed on the screen using the CHANGE command.
The current screen width may be examined using the SHOW DISPLAY command.
--------------------------------------------------------------------------------
The following error messages are specific to the SET and SET SCREEN
commands:
--------------------------------------------------------------------------------
DTIEDIT> SET SCREEN 132
--------------------------------------------------------------------------------
Shows information on the parameters that control how the DTI data values
will be displayed on the screen when the CHANGE command is given.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
The command SHOW DISPLAY may be used to examine the current status of
the parameters that control how the DTI data values will be displayed on the
screen.
Information on the ORIGIN, LIMITS, and STEP, along with details of the
screen width is given. The status of the BELL and EDIT options are shown.
--------------------------------------------------------------------------------
The following message is specific to the command SHOW:
--------------------------------------------------------------------------------
DTIEDIT>SHOW DISPLAY
DTIEDIT>
--------------------------------------------------------------------------------
Displays information extracted from the header of the input DTI file.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Details extracted from the header of the DTI file are displayed on the
terminal.
The header values are shown in the current units of measurement.
--------------------------------------------------------------------------------
The following messages are specific to the commands SHOW and SHOW FILEIN:
--------------------------------------------------------------------------------
DTIEDIT>SHOW FILEIN
--------------------------------------------------------------------------------
The SPAWN command enables a subprocess to be created from within DTIEDIT.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
command-line
Specifies a DCL command string to be executed as if typed in response to
a '$' prompt. When the command completes, the subprocess terminates and control
is returned to DTIEDIT. The command line cannot exceed 80 characters.
--------------------------------------------------------------------------------
The SPAWN command enables you to create a subprocess while within
DTIEDIT. When the subprocess terminates, control is returned to DTIEDIT.
--------------------------------------------------------------------------------
The following error messages are specific to the SPAWN command:
--------------------------------------------------------------------------------
DTIEDIT> SPAWN DIRECTORY LSL$DTI:*_._DTI
--------------------------------------------------------------------------------
Defines the display step interval.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
step_interval
--------------------------------------------------------------------------------
The command STEP is used to set a display step interval, and therefore to
classify the data into a series of value ranges. When the CHANGE command is
given a different letter will be used by used to display each step range.
A default step interval is calculated when the DTI file is first opened,
or when the RESET STEP command is given, using the lower and upper limit
values. This default may be changed using the STEP command.
Note that if the step interval value, taken in conjunction with the
current lower and upper display limit values, results in the generation of
more than 26 step intervals, the upper limits value is adjusted appropriately.
After giving the STEP command, details of the current limits and
step values, are shown on the terminal.
--------------------------------------------------------------------------------
The following messages are specific to the STEP command:
--------------------------------------------------------------------------------
DTIEDIT>STEP 100
DTIEDIT>
--------------------------------------------------------------------------------
Substitutes with a new value all matrix points having a specified value.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
AREA
xmin ymin
xmax ymax
old_value
new_value
--------------------------------------------------------------------------------
The SUBSTITUTE command is used to replace all occurrences of a matrix
data value with a new data value eg. using the command SUBSTITUTE 4 24,
all matrix points with a value of 4 are replaced by a value of 24.
Using the AREA qualifier, substitution may be restricted to a rectangular
area. The coordinates of the defining rectangle are supplied as command
parameters, and must lie within the bounds of the DTI file data area.
If the AREA qualifier is not present, substitution is performed on the
total DTI file.
Note, that as with all DTI edit commands, the edit is performed
immediately and 'in situ' on the current DTI file.
--------------------------------------------------------------------------------
The following messages are specific to the SUBSTITUTE and SUBSTITUTE AREA
commands:
DTIEDIT>ENABLE EDIT
--------------------------------------------------------------------------------
Specifies the units of measurement that will be used to display header
details from the DTI file.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
units
A keyword defining the measurement units, chosen from:
--------------------------------------------------------------------------------
The UNITS command controls in what format details from the header of the
DTI are displayed, when the SHOW FILEIN command is given.
--------------------------------------------------------------------------------
The following error messages are specific to the UNITS command:
--------------------------------------------------------------------------------
$
In the example above command line mode is used to define the input
DTI file; to enable the editing of the file; to perform three edits on the
matrix data, and to print the results of the edit on the lineprinter.
The representation of 50 columns and 50 rows of the matrix, as it
would appear on the lineprinter is shown below.
If the cause of the error cannot be traced by the user, and
Laser-Scan are consulted, then the output file should be preserved to
facilitate diagnosis.
key causes the last digit of a value to be deleted, or if the
value has been generated using an alpha key, the value to be cancelled.
DTIEDIT COMMANDS
_@ COMMAND
_@
FORMAT: _@ file-spec
Command parameters:
DESCRIPTION:
Messages:
*** ERROR *** Specifying command @
Command file specification is missing
*** ERROR *** Specifying command @
Unable to open indirect command file 'file-spec'
*** ERROR *** Specifying command @
Nested command files not supported
Examples:
DTIEDIT> @DTIEDIT_EDITS
DTIEDIT> DISABLE BELL
DTIEDIT> ENABLE EDIT
DTIEDIT> RETURN
DTIEDIT>
_! COMMAND
_!
FORMAT: _! [comment text]
Command parameters:
DESCRIPTION:
Messages: None.
Examples:
DTIEDIT> FILEIN TEST !open the file<CR>
DTIEDIT> !Define the screen width<CR>
DTIEDIT> SET SCREEN 132<CR>
DTIEDIT>
CHANGE COMMAND
CHANGE
FORMAT: CHANGE
Command parameters: _None
DESCRIPTION:
On giving the command, the DTI data is displayed on the screen as a
series of characters. Each character represents a separate value step. The
step interval is defined when the DTI file is first opened, or may be
specifically set using the STEP command. The LIMITS command controls the range
of data values that will be shown.
The ORIGIN command determines which area of the matrix will be displayed.
The column and row specified with the ORIGIN command will appear in the
bottom lefthand corner of the screen.
Messages:
*** ERROR *** Specifying command CHANGE
No DTI file has been defined
*** ERROR *** Specifying command CHANGE
Command not valid when reading from a command file
*** ERROR *** Specifying command CHANGE
Terminal is not a VT100 compatible display
Examples:
DISABLE BELL COMMAND
DISABLE BELL
FORMAT: DISABLE BELL
DESCRIPTION:
Messages:
*** ERROR *** Specifying command DISABLE
Command qualifiers are BELL or EDIT
Examples:
DTIEDIT>
DISABLE EDIT COMMAND
DISABLE EDIT
FORMAT: DISABLE EDIT
Command parameters: _None
DESCRIPTION:
Messages:
*** ERROR *** Specifying command DISABLE
Command qualifiers are BELL or EDIT
Examples:
DTIEDIT>
EDIT AREA COMMAND
EDIT AREA
FORMAT: EDIT AREA xmin ymin xmax ymax data_value
Command parameters:
The coordinates of the bottom left hand corner of the rectangle. An
integer column and row value is required.
The coordinates of top right hand corner of the rectangle. An integer
column and row value is required.
The value to which the matrix points are to be changed. Depending on
the type of data held in the DTI file, an integer or real data value is
required. The data type also determines the valid range of the data value.
DESCRIPTION:
Messages:
*** ERROR *** Specifying command EDIT
Command qualifiers are AREA, LINE, or POINT
*** ERROR *** Specifying command EDIT AREA
No DTI file has been defined
*** ERROR *** Specifying command EDIT AREA
The coordinates of the rectangle are out of range
*** ERROR *** Specifying command EDIT AREA
The top righthand point must exceed the bottom lefthand point
*** ERROR *** Specifying command EDIT AREA
The data value is missing
*** ERROR *** Specifying command EDIT AREA
The data value is invalid for the DTI data type
--------------------------------------------------------------------------------
Examples:
DTIEDIT>
EDIT LINE COMMAND
EDIT LINE
FORMAT: EDIT LINE xstart ystart xend yend data_value
Command parameters:
The coordinates of the line start point. An integer column and row value
is required.
The coordinates of the line end point. An integer column and row value is
required.
The value to which the matrix points are to be changed. Depending on
the type of data held in the DTI file, an integer or real data value is
required. The data type also determines the valid range of the data value.
DESCRIPTION:
Messages:
*** ERROR *** Specifying command EDIT
Command qualifiers are AREA, LINE, or POINT
*** ERROR *** Specifying command EDIT LINE
No DTI file has been defined
*** ERROR *** Specifying command EDIT LINE
The coordinates of the line are out of range
*** ERROR *** Specifying command EDIT LINE
The data value is missing
*** ERROR *** Specifying command EDIT LINE
The data value is invalid for the DTI data type
--------------------------------------------------------------------------------
Examples:
DTIEDIT>
EDIT POINT COMMAND
EDIT POINT
FORMAT: EDIT POINT x_coord y_coord data_value
Command parameters:
The coordinates of the matrix point. An integer column and row value is
required.
The value to which the matrix point is to be changed. Depending on
the type of data held in the DTI file, an integer or real data value is
required. The data type also determines the valid range of the data value.
DESCRIPTION:
Messages:
*** ERROR *** Specifying command EDIT
Command qualifiers are AREA, LINE, or POINT
*** ERROR *** Specifying command EDIT POINT
No DTI file has been defined
*** ERROR *** Specifying command EDIT POINT
The coordinates of the point are out of range
*** ERROR *** Specifying command EDIT POINT
The data value is missing
*** ERROR *** Specifying command EDIT POINT
The data value is invalid for the DTI data type
--------------------------------------------------------------------------------
Examples:
DTIEDIT>
ENABLE BELL COMMAND
ENABLE BELL
FORMAT: ENABLE BELL
Command parameters: _None
DESCRIPTION:
An explanatory warning message is displayed on the bottom line of the
screen.
Messages:
*** ERROR *** Specifying command ENABLE
Command qualifiers are BELL or EDIT
Examples:
DTIEDIT>
ENABLE EDIT COMMAND
ENABLE EDIT
FORMAT: ENABLE EDIT
Command parameters: _None
DESCRIPTION:
If an attempt to edit the matrix is made before the ENABLE EDIT command
is given, an error message is generated.
Messages:
*** ERROR *** Specifying command ENABLE
Command qualifiers are BELL or EDIT
Examples:
DTIEDIT>
EXIT COMMAND
EXIT
FORMAT: EXIT
Command parameters: None.
DESCRIPTION:
Messages:
Updating minimum and maximum range values - Please wait.
Examples:
FILEIN COMMAND
FILEIN
FORMAT: FILEIN file-spec
Command parameters:
Any part of the file specification not supplied is taken from the default
'LSL$DTI:DTI.DTI'.
DESCRIPTION:
Details derived from the header of the file are displayed on the terminal
to confirm that the file has been successfully opened.
Messages:
*** ERROR *** Specifying command FILEIN
Input DTI filename is missing
Example:
LSL$DTI:TEST.DTI
Header: LSLA Data: WORD
Units are DTI Matrix Values
Matrix Coverage SW: 1 1 NE: 301 251
Matrix Interval E: 1 N: 1
Value Range : 0 to 851
DTIEDIT>
HELP COMMAND
HELP
FORMAT: HELP command
Command parameters:
Description:
Messages:
Examples:
DTIEDIT>HELP FILEIN<CR>
DTIEDIT
FILEIN
The FILEIN command opens and maps into memory a DTI file.
Details derived form the header of the file are displayed on the
terminal to confirm that the file has been successfully opened.
DTIEDIT>
LIMITS COMMAND
LIMITS
FORMAT: LIMITS lower_value upper_value
Command parameters:
The lower and upper data value limits. Two integer values are required.
Both values must lie within the file minimum and maximum data values.
DESCRIPTION:
Messages:
*** ERROR *** Specifying command LIMITS
Command requires 2 integer arguments
*** ERROR *** Specifying command LIMITS
Upper value must exceed lower value
--------------------------------------------------------------------------------
Examples:
Display Origin : 1 1
Data Display Limits : 120 550
Data Display Step : 50
Screen Width : 80
Warning Bell : Off
Edit of Data Values : Off
DTIEDIT>
ORIGIN COMMAND
ORIGIN
FORMAT: ORIGIN x_coord y_coord
Command parameters:
The coordinates of the matrix point that will be displayed at the bottom
lefthand corner of the screen. An integer column and row value is required.
DESCRIPTION:
The screen cursor will automatically be positioned on this point.
Messages:
*** ERROR *** Specifying command ORIGIN
Command requires 2 integer arguments
*** ERROR *** Specifying command ORIGIN
No DTI file has been defined
*** ERROR *** Specifying command ORIGIN
The coordinates of the origin are out of range
--------------------------------------------------------------------------------
Examples:
DTIEDIT>
PRINT COMMAND
PRINT
FORMAT: PRINT number_columns number_rows [file-spec]
Command parameters:
The number of columns to output. An integer value is required.
The number of rows to output. An integer value is required.
An optional parameter specifying the output list file. If no file
specification is supplied, a temporary file DTIEDIT.DAT will be created,
which will be spooled to SYS$PRINT, and deleted once listed. Any file
specification supplied will be parsed against the default DTIEDIT.DAT.
DESCRIPTION:
Messages:
*** ERROR *** Specifying command PRINT
No DTI file has been defined
*** ERROR *** Specifying command PRINT
Number of columns exceeds 132
Number of columns will be truncated
--------------------------------------------------------------------------------
Examples:
DTIEDIT>
RESET LIMITS COMMAND
RESET LIMITS
FORMAT: RESET LIMITS
Command parameters: None.
DESCRIPTION:
Messages:
*** ERROR *** Specifying command RESET
Command qualifiers are LIMITS, MINMAX or STEP
*** ERROR *** Specifying command RESET LIMITS
No DTI file has been defined
Examples:
Display Origin : 1 1
Data Display Limits : 120 550
Data Display Step : 50
Screen Width : 80
Warning Bell : Off
Edit of Data Values : Off
RESET MINMAX COMMAND
RESET MINMAX
FORMAT: RESET MINMAX
Command parameters: None.
DESCRIPTION:
Messages:
*** ERROR *** Specifying command RESET
Command qualifiers are LIMITS, MINMAX or STEP
*** ERROR *** Specifying command RESET MINMAX
No DTI file has been defined
Examples:
LSL$DTI:TEST.DTI
Header: LSLA Data: WORD
Units are DTI Matrix Values
Matrix Coverage SW: 1 1 NE: 301 251
Matrix Window SW: 1 1 NE: 200 200
Matrix Interval E: 1 N: 1
Value Range : 0 to 851
RESET STEP COMMAND
RESET STEP
FORMAT: RESET STEP
Command parameters: None.
DESCRIPTION:
Messages:
*** ERROR *** Specifying command RESET
Command qualifiers are LIMITS, MINMAX or STEP
*** ERROR *** Specifying command RESET STEP
No DTI file has been defined
Examples:
Display Origin : 1 1
Data Display Limits : 120 550
Data Display Step : 50
Screen Width : 80
Warning Bell : Off
Edit of Data Values : Off
RETURN COMMAND
RETURN
FORMAT: RETURN
Command parameters: None.
DESCRIPTION:
Messages:
*** ERROR *** Specifying command RETURN
The RETURN command is only valid in a command file
Returning to terminal input
Examples:
DTIEDIT> @SETUP<CR>
DTIEDIT> ENABLE EDIT
DTIEDIT> DISABLE BELL
DTIEDIT> RETURN
Returning to terminal input
DTIEDIT>
SET SCREEN COMMAND
SET SCREEN
FORMAT: SET SCREEN width
Command parameters:
DESCRIPTION:
Messages:
*** ERROR *** Specifying command SET
Command qualifier is SCREEN
*** ERROR *** Specifying command SET SCREEN
Command requires an integer argument
*** ERROR *** Specifying command SET SCREEN
Valid screen widths are 80 or 132
Examples:
DTIEDIT>
SHOW DISPLAY COMMAND
SHOW DISPLAY
FORMAT: SHOW DISPLAY
Command parameters: None.
DESCRIPTION:
Messages:
*** ERROR *** Specifying command SHOW
Command qualifiers are DISPLAY or FILEIN
Examples:
Display Origin : 1 1
Data Display Limits : 120 550
Data Display Step : 50
Screen Width : 80
Warning Bell : Off
Edit of Data Values : Off
SHOW FILEIN COMMAND
SHOW FILEIN
FORMAT: SHOW FILEIN
Command parameters: None.
DESCRIPTION:
Messages:
*** ERROR *** Specifying command SHOW
Command qualifiers are DISPLAY, FILEIN
*** WARNING *** The input DTI file is undefined
Examples:
LSL$DTI:TEST.DTI
Header: LSLA Data: WORD
Units are DTI Matrix Values
Matrix Coverage SW: 1 1 NE: 301 251
Matrix Window SW: 1 1 NE: 200 200
Matrix Interval E: 1 N: 1
Value Range : 0 to 851
DTIEDIT>
SPAWN COMMAND
SPAWN
FORMAT: SPAWN command-line
Command parameters:
DESCRIPTION:
Messages:
*** ERROR *** Specifying command SPAWN
Command requires a valid DCL command line
*** ERROR *** Specifying command SPAWN
DCL command line cannot exceed 80 characters
*** ERROR *** Unable to spawn command, returning to DTIEDIT
Examples:
Directory DUA3:[LSL.DTI]
TEST1_.DTI;1 8/8 18-AUG-1987 07:56 [LSL,DAVEC]
TEST2_.DTI;1 7/8 18-AUG-1987 17:17 [LSL,DAVEC]
TEST2_.DTI;2 7/8 18-AUG-1987 17:34 [LSL,DAVEC]
Total of 3 files, 22/24 blocks.
DTIEDIT>
STEP COMMAND
STEP
FORMAT: STEP step_interval
Command parameters:
The display step interval. A positive integer value is required.
DESCRIPTION:
Messages:
*** ERROR *** Specifying command STEP
Command requires an integer argument
*** ERROR *** Specifying command STEP
Command requires a positive integer argument
Examples:
Display Origin : 1 1
Data Display Limits : 120 550
Data Display Step : 100
Screen Width : 80
Warning Bell : Off
Edit of Data Values : Off
SUBSTITUTE COMMAND
SUBSTITUTE
FORMAT: SUBSTITUTE [ AREA xmin ymin xmax ymax ]
old_value new_value
Command parameters:
An optional qualifier that enables the value substitution to be
restricted to a rectangular area defined by the parameters xmin, ymin, xmax
and ymax. If the qualifier is not given, substitution is performed on an area
corresponding to the total matrix.
The coordinates of the bottom left hand corner of the rectangle. An
integer column and row value is required.
The coordinates of top right hand corner of the rectangle. An integer
column and row value is required.
The existing matrix value which is to be changed. Depending on
the type of data held in the DTI file, an integer or real data value is
required. The data type also determines the valid range of the data value.
The matrix value which is to be substituted. Depending on
the type of data held in the DTI file, an integer or real data value is
required. The data type also determines the valid range of the data value.
DESCRIPTION:
Messages:
*** ERROR *** Specifying command SUBSTITUTE
No DTI file has been defined
*** ERROR *** Specifying command SUBSTITUTE AREA
The coordinates of the rectangle are out of range
*** ERROR *** Specifying command SUBSTITUTE AREA
The top righthand point must exceed the bottom lefthand point
*** ERROR *** Specifying command SUBSTITUTE
The data value is invalid for the DTI data type
--------------------------------------------------------------------------------
Examples:
DTIEDIT>SUBSTITUTE AREA 1 1 34 45 345 23<CR>
DTIEDIT>
UNITS COMMAND
UNITS
FORMAT: UNITS units
Command parameters:
MATRIX Matrix grid interval units, i.e rows and columns
METRES Metre offsets from the south west corner of the DTM
SECONDS Latitude and Longitude in seconds of arc
LATLONG Latitude and Longitude in degrees, minutes and seconds
PROJECTION Projection Record Units (eg. mms. on the source document)
DESCRIPTION:
The command should be given after defining the input DTI file,
since DTI matrix units are always used by default when a file is opened.
Messages:
*** ERROR *** Specifying command UNITS
Command qualifiers are MATRIX, METRES, SECONDS, LATLONG or PROJECTION
*** ERROR *** Specifying command UNITS
Command qualifier is invalid for the input file
Examples:
DTIEDIT> UNITS MATRIX<CR>
DTIEDIT>
EXAMPLES
EXAMPLES
$ DTIEDIT
DTIEDIT>FILEIN TEST
LSL$DTI:TEST.DTI
Header: LSLA Data: WORD
Units are DTI Matrix Values
Matrix Coverage SW: 1 1 NE: 301 251
Matrix Window SW: 1 1 NE: 200 200
Matrix Interval E: 1 N: 1
Value Range : 0 to 851
DTIEDIT>ENABLE EDIT<CR>
DTIEDIT>EDIT AREA 1 1 50 50 50
DTIEDIT>EDIT AREA 30 30 40 40 200
DTIEDIT>EDIT LINE 1 1 10 10 100
DTIEDIT>PRINT 50 50
DTIEDIT>EXIT
Determining minimum and maximum values - please wait
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAADDDDDDDDDDDAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAADDDDDDDDDDDAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAADDDDDDDDDDDAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAADDDDDDDDDDDAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAADDDDDDDDDDDAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAADDDDDDDDDDDAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAADDDDDDDDDDDAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAADDDDDDDDDDDAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAADDDDDDDDDDDAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAADDDDDDDDDDDAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAADDDDDDDDDDDAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
ABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
BAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
DTI file: LSL$DTI:TEST.DTI DTI window: SW 1 1 NE 50 50
Character Values:
MESSAGES (OTHER)
MESSAGES (OTHER)
In addition to the above messages which are generated by the program itself,
other messages may be produced by by Laser-Scan libraries. In
particular, messages may be generated by the DTI library or by the
Laser-Scan I/O library, LSLLIB. DTI library messages are introduced by %DTI
and are documented in the MATRIX Reference manual. LSLLIB messages are
introduced by '%LSLLIB' and are generally self-explanatory. They are often
used to explain the details of program generated errors.