--------------------------------------------------------------------------------
MODULE DTIBLEND

--------------------------------------------------------------------------------
REPLACES None. DTIBLEND is a new MATRIX utility.

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

FUNCTION

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

FORMAT

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

COMMAND QUALIFIERS

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

DTIBLEND COMMAND DEFAULTS

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

DESCRIPTION


HOLD  TESTDATA1           - open LSL$DTI:TESTDATA1.DTI;0 for readonly
                            input. The edge of this file will be held
                            as control for the corresponding edge of the file
                            opened with the BLEND command.

BLEND TESTDATA2 TESTDATA2__BLENDED
                          - open LSL$DTI:TESTDATA2.DTI;0 for readonly input.
                            This file will be copied to
                            LSL$DTI:TESTDATA2__BLENDED.DTI;0. The edge of this
                            copied file will then be brought into
                            vertical alignment with the corresponding
                            edge of the HOLD file LSL$DTI:TESTDATA1.DTI;0.

IFF TEST__CONTROL.IFF      - open LSL$IF:TEST__CONTROL.IFF:0 for readonly 
                            input. The vector data in this file will be used 
                            to control the amount of change allowed in the edge 
                            blend process.

BORDER 5                  - blend 5 posts in from the blend edge.

GO                        - start processing

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

DTIBLEND COMMANDS

_@ COMMAND

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

--------------------------------------------------------------------------------
FORMAT: _@ file-spec

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

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

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


$ DTIBLEND<CR>
MATRIX module DTIBLEND of 18:30:39 18-FEB-88
DTIBLEND> @PRESETS<CR>
DTIBLEND> ENABLE DIAGNOSTICS
DTIBLEND> BORDER 5
DTIBLEND> RETURN
DTIBLEND>

_! COMMAND

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

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

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

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

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

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

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


DTIBLEND> _! a comment for the sake of it<CR>
DTIBLEND> BORDER 2 ! just blend the very edge posts only

BLEND COMMAND

--------------------------------------------------------------------------------
BLEND

--------------------------------------------------------------------------------
FORMAT: BLEND dti-file-spec [output-dti-file-spec]

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

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

Specifies a DTI file that is to be opened and blended. If the IN_SITU option is enabled, the DTI file will be opened for read and write (modify) access. If the IN_SITU option is disabled (default) the BLEND command must be given two file-specification arguments. In this situation the file defined by the first file-spec is opened readonly as the input file and the second is opened with write access as the output file.

If the user wishes to blend two DTI files to a common mean edge value two BLEND commands should be used instead of one BLEND and one HOLD command.

It is recommended that the IN_SITU processing option is not normally used, as it will irrevocably modify the source input file (of which the user may not have another copy). The IN_SITU option is, however, useful when edge blending large DTI files when the user's virtual address quota or disk space is inadequate for opening additional DTI files for output.

At least one BLEND command must be issued before the GO command will be accepted.

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

The following messages are specific to the BLEND command:


*** ERROR *** Unable to interpret input file-spec

*** ERROR *** Two BLEND commands have already been accepted!
              DTIBLEND requires either a HOLD command and a BLEND command
              or two BLEND commands

*** ERROR *** You must specify a file-spec argument to the BLEND command

*** ERROR *** You must specify two file-spec arguments to
              the BLEND command.
              For example BLEND SW301.DTI SW301OUT.DTI

*** ERROR *** You must specify two file-spec arguments to
              the BLEND command if the IN__SITU option is disabled.

*** ERROR *** Reading BLEND output file-spec

*** ERROR *** Unable to interpret BLEND file-spec

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

DTIBLEND> BLEND SOIL SOIL2<CR>
File    :  LSL$DTI:SOIL.DTI;0
Header  :  MIKE  Data:  REAL
Units are DTI Matrix Values.
Matrix Coverage   SW:       1       1          NE:       449     449
Matrix Interval    E:       1.00                N:       1.00
Value Range         :     -5.00 to  326421.00
File    :  LSL$DTI:SOIL2.DTI;0
Header  :  MIKE  Data:  REAL
Units are DTI Matrix Values.
Matrix Coverage   SW:       1       1          NE:       449     449
Matrix Interval    E:       1.00                N:       1.00
Value Range         :     -5.00 to  326421.00
DTIBLEND> 

BORDER COMMAND

--------------------------------------------------------------------------------
BORDER

--------------------------------------------------------------------------------
FORMAT: BORDER width

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

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

The value supplied for the BORDER command (expressed matrix units) determines the width of the blend zone within each DTI file opened for blend. If the DTI files adjoin top to bottom, BORDER width indicates the number of rows to be blended parallel to the adjoining edge. If the DTI files adjoin side by side, BORDER width indicates the number of columns to be blended parallel to the adjoining edge.

The row or column that lies along the mutual join between the 2 DTI files is treated as part of the blend zone and is included in the BORDER width. In other words, the blend zone width within each BLEND DTI file will be BORDER-1 times the matrix grid interval for that axis. Thus using two blend commands and the default BORDER width of 3, and the DTI files adjoin top to bottom, the edge row and the two adjacent rows in each DTI file will be modified.

By default DTIBLEND applies a BORDER value of 3.

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

The following warning messages are specific to the BORDER command:


*** WARNING *** You must specify an integer argument to the BORDER command 
                For example BORDER 3

*** ERROR *** Invalid border width.
              BORDER arguments must lie in the range 2 to 5

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


DTIBLEND> BORDER 8<CR>
*** ERROR *** Invalid border width.
BORDER arguments must lie in the range 2 to 5
DTIBLEND> BORDER 5<CR>
DTIBLEND>

DESELECT FC COMMAND

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

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

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

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

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

On program startup all FCs are selected for input.

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

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

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

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

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

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


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

DESELECT LAYER COMMAND

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

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

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

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

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

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

On program startup all layers are selected for input.

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

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

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

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

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

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


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

DISABLE DIAGNOSTICS COMMAND

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

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

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

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

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

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

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


DTIBLEND> ENABLE DIAGNOSTICS<CR>
DTIBLEND> SHOW ENABLE<CR>

DIAGNOSTICS .................................................. On
DIVIDEBY ..................................................... Off
INTEGER_HEIGHT ............................................... Off
(Incoming IFF heights expected in type 3 AC entries)
IN_SITU ...................................................... Off
MULTIPLY ....................................................  Off
PME .......................................................... Off
SMOOTH ....................................................... Off
TOFEET ....................................................... Off
TOMETRES ..................................................... Off

DTIBLEND>

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:


DTIBLEND> DISABLE DIVIDEBY<CR>
DTIBLEND>

DISABLE IN_SITU COMMAND

--------------------------------------------------------------------------------
DISABLE IN_SITU

--------------------------------------------------------------------------------
FORMAT: ENABLE IN_SITU

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

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

By default DTIBLEND requires an output file specification to be supplied for the BLEND command. It then creates and opens this file to receive the results of the blend process. Like a HOLD input DTI file, the input DTI file opened with a BLEND command is not altered in any way.

ENABLE IN_SITU enables in-situ processing of the DTI file opened for BLEND.

DISABLE IN_SITU cancels the effect of a previous ENABLE IN_SITU command. However, any DTI input files that have already been specified using BLEND commands when IN_SITU mode was enabled will remain subject to in-situ modification. DTIBLEND issues the following message when a DISABLE IN_SITU command is accepted:


****************************************************************************
*                                                                          *
*                            W A R N I N G                                 *
*                                                                          *
*   Any DTI input files that have already been specified using BLEND       *
*   commands when IN_SITU mode was enabled will remain subject to in-situ  *
*   modification                                                           *
*                                                                          *
****************************************************************************

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

See above for the warning message issued by the DISABLE IN_SITU command.

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


DTIBLEND> DISABLE IN_SITU<CR>

****************************************************************************
*                                                                          *
*                            W A R N I N G                                 *
*                                                                          *
*   Any DTI input files that have already been specified using BLEND       *
*   commands when IN_SITU mode was enabled will remain subject to in-situ  *
*   modification                                                           *
*                                                                          *
****************************************************************************

DISABLE INTEGER_HEIGHT COMMAND

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

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

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

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

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

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

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

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


DTIBLEND> DISABLE INTEGER_HEIGHT<CR>
DTIBLEND>

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:


DTIBLEND> DISABLE MULTIPLYBY<CR>
DTIBLEND>

DISABLE PME COMMAND

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

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

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

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

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

--------------------------------------------------------------------------------
Messages: *** WARNING *** You are not using PME !

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


DTIBLEND> ENABLE PME<CR>
DTIBLEND> DISABLE PME<CR>
DTIBLEND>

DISABLE SMOOTH COMMAND

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

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

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

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

By default standard linear interpolation from one matrix to another is performed, but an alternative action is to perform a smooth (gradual) feathering of one matrix to another.

The ENABLE SMOOTH command enables the smooth feathering interpolation action to be applied.

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

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


DTIBLEND> DISABLE SMOOTH<CR>
DTIBLEND>

DISABLE TOFEET COMMAND

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

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

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

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

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

The ENABLE TOFEET command enables the conversion of heights held in the IFF file in metres to feet. It has the same effect as an explicit ENABLE MULTIPLYBY 3.2808455 command. For example, if the DTI file heights are in feet, it is possible to read in one IFF control file with heights in feet with one IFF command and then use the ENABLE TOFEET command and read in another file with heights in metres, converting to feet during read-in.

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

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

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


DTIBLEND> DISABLE TOFEET<CR>
DTIBLEND>

DISABLE TOMETRES COMMAND

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

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

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

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

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

The ENABLE TOMETRES command enables the conversion of heights held in the IFF file in feet to metres. It has the same effect as an explicit ENABLE DIVIDEBY 3.2808455 command. For example, if the DTI file heights are in metres, it is possible to read in one IFF control file with heights in metres with one IFF command and then use the ENABLE TOMETRES command and read in another file with heights in feet, converting to metres during read-in.

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

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

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


DTIBLEND> DISABLE TOMETRES<CR>
DTIBLEND>

ENABLE DIAGNOSTICS COMMAND

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

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

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

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

ENABLE DIAGNOSTICS allows the user to enable diagnostic printout.

On a heavily loaded computer it may be reassuring to ENABLE DIAGNOSTICS to indicate the progress of processing.

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

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


DTIBLEND> ENABLE DIAGNOSTICS<CR>
DTIBLEND> SHOW ENABLE<CR> DIAGNOSTICS .................................................. On DIVIDEBY ..................................................... Off INTEGER_HEIGHT ............................................... Off (Incoming IFF heights expected in type 3 AC entries) IN_SITU ...................................................... Off MULTIPLY .................................................... Off PME .......................................................... Off SMOOTH ....................................................... Off TOFEET ....................................................... Off TOMETRES ..................................................... Off
DTIBLEND> DISABLE DIAGNOSTICS<CR>
DTIBLEND> SHOW ENABLE<CR> DIAGNOSTICS .................................................. Off DIVIDEBY ..................................................... Off INTEGER_HEIGHT ............................................... Off (Incoming IFF heights expected in type 3 AC entries) IN_SITU ...................................................... Off MULTIPLY .................................................... Off PME .......................................................... Off SMOOTH ....................................................... Off TOFEET ....................................................... Off TOMETRES ..................................................... Off
DTIBLEND>

ENABLE DIVIDEBY COMMAND

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

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

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

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

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

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


DTIBLEND> ENABLE DIVIDEBY 39.2<CR>
DTIBLEND>

ENABLE IN_SITU COMMAND

--------------------------------------------------------------------------------
ENABLE IN_SITU

--------------------------------------------------------------------------------
FORMAT: ENABLE IN_SITU

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

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

By default, DTIBLEND requires an output file specification to be supplied for the BLEND command. It then creates and opens this file to receive the results of the blend process. Like a HOLD input DTI file, the input DTI file opened with a BLEND command is not altered in any way.

ENABLE IN_SITU enables in-situ processing of the DTI file opened for BLEND. ENABLE IN_SITU completely changes the way DTIBLEND treats the BLEND command. When the IN_SITU command is specified, DTIBLEND expects only one DTI file-spec argument to the BLEND command. This DTI file is then opened for both read and write and the results of the blend process are written back into the same file.

Because of the danger of modifying a unique input file in an irrevocable fashion using the ENABLE IN_SITU command, DTIBLEND issues a stern warning after accepting the IN_SITU command:


****************************************************************************
*                                                                          *
*                            W A R N I N G                                 *
*                                                                          *
*  Use of the BLEND command with only one file-spec argument will result   *
*   in the input file being overwritten. If you want the results of the    *
*    edge blend process to be written to a new output file the BLEND       *
*       command must be specified with two file-spec arguments.            *
*                                                                          *
****************************************************************************

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

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

*** WARNING *** You are already using IN_SITU!

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


$ DTIBLEND<CR>
MATRIX module DTIBLEND of 12:23:19 18-MAR-88
DTIBLEND> ENABLE IN_SITU<CR>

****************************************************************************
*                                                                          *
*                            W A R N I N G                                 *
*                                                                          *
*  Use of the BLEND command with only one file-spec argument will result   *
*   in the input file being overwritten. If you want the results of the    *
*    edge blend process to be written to a new output file the BLEND       *
*       command must be specified with two file-spec arguments.            *
*                                                                          *
****************************************************************************


DTIBLEND>

ENABLE INTEGER_HEIGHT COMMAND

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

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

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

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

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

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

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

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


DTIBLEND> ENABLE INTEGER_HEIGHT<CR>
DTIBLEND>

ENABLE SMOOTH COMMAND

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

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

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

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

By default standard linear interpolation from one matrix to another is performed, but an alternative action is to perform a smooth (gradual) feathering of one matrix to another.

The ENABLE SMOOTH command enables the smooth feathering interpolation action to be applied.

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

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


DTIBLEND> ENABLE SMOOTH<CR>
DTIBLEND>

ENABLE TOFEET COMMAND

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

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

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

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

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

The ENABLE TOFEET command enables the conversion of heights held in the IFF file in metres to feet. It has the same effect as an explicit ENABLE MULTIPLYBY 3.2808455 command. For example, if the DTI file heights are in feet, it is possible to read in one IFF control file with heights in feet with one IFF command and then use the ENABLE TOFEET command and read in another file with heights in metres, converting to feet during read-in.

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

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

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


DTIBLEND> ENABLE TOFEET<CR>
DTIBLEND>

ENABLE TOMETRES COMMAND

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

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

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

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

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

The ENABLE TOMETRES command enables the conversion of heights held in the IFF file in feet to metres. It has the same effect as an explicit ENABLE DIVIDEBY 3.2808455 command. For example, if the DTI file heights are in metres, it is possible to read in one IFF control file with heights in metres with one IFF command and then use the ENABLE TOMETRES command and read in another file with heights in feet, converting to metres during read-in.

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

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

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


DTIBLEND> ENABLE TOMETRES<CR>
DTIBLEND>

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:


$ DTIBLEND<CR>
MATRIX module DTIBLEND of 12:23:19 18-MAR-88
DTIBLEND> ENABLE PME<CR>

FRT COMMAND

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

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

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

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

The FRT command allows the user to specify an FRT file which contains feature code group definitions. The availability of feature code groups simplifies the specification of complex feature code selections for blend process control.

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

The following messages are specific to the FRT command:


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

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

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

DTIBLEND> SELECT FC 7,COAST<CR>

DTIBLEND> SELECT FC 7,COAST<CR>
DTIBLEND>

GO COMMAND

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

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

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

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

The GO command signifies the end of command interaction with the user and DTI file processing begins.

Before DTI file processing is begun, DTIBLEND checks that two DTI input files have been specified using either BLEND or HOLD commands.

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

The following messages are specific to the GO command:


*** WARNING *** You must specify 2 DTI files for input. Either use a
                BLEND and a HOLD command or 2 BLEND commands

Two DTI files must be supplied before submitting a GO command.


*** ERROR *** Although abutting along a common horizontal axis, the input
              DTI files do not join across a common edge.

*** ERROR *** Although abutting along a common vertical axis, the input
              DTI files do not join across a common edge.

The DTI files have a common edge coordinate, but do not overlap along it. --------------------------------------------------------------------------------
Examples:


$ DTIBLEND<CR> DTIBLEND> GO<CR>

*** WARNING *** You must specify 2 DTI files for input. Either use a
BLEND and a HOLD command or 2 BLEND commands DTIBLEND> HOLD SW12I88<CR>
File : LSL$DTI:SW12I88.DTI;0 Header : MIKE Data: REAL Units are DTI Matrix Values. Matrix Coverage SW: 1 1 NE: 449 449 Matrix Interval E: 1.00 N: 1.00 Value Range : 0.00 to 326.00 DTIBLEND> GO<CR>

HELP COMMAND

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

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

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

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

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

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

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

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

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


DTIBLEND> HELP ENABLE PME<CR>

DTIBLEND

ENABLE

PME


DTIBLEND>

HOLD COMMAND

--------------------------------------------------------------------------------
HOLD

--------------------------------------------------------------------------------
FORMAT: HOLD dti-file-spec

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

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

Specifies a DTI file that is to be opened readonly. It is the edge of this file which is held fixed, to which the DTI file opened with the BLEND command will be blended.

If the user wishes to blend two DTI files to a common mean edge value, two BLEND commands should be used instead of one BLEND and one HOLD command.

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

The following messages are specific to the HOLD command:


*** ERROR *** Unable to interpret input file-spec

*** ERROR *** A HOLD command has already been accepted. If the HOLD
              command is used, the other DTI file must be opened using the BLEND
              command.

*** ERROR *** Two BLEND commands have already been accepted. If the HOLD
              command is used, only one BLEND command can be specified.

*** ERROR *** You must specify a file-spec argument to the HOLD command
              For example HOLD SW301.DTI

*** ERROR *** reading DTI offset

You must specify both the X and the Y origin offset
DTI file 'file-spec' is now closed. Please respecify the HOLD command

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

DTIBLEND> HOLD SW12I88<CR>
File    :  LSL$DTI:SW12I88.DTI;0
Header  :  MIKE  Data:  REAL
Units are DTI Matrix Values.
Matrix Coverage   SW:       1       1          NE:       449     449
Matrix Interval    E:       1.00                N:       1.00
Value Range         :      0.00 to  326.00
DTIBLEND> 

IFF COMMAND

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

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

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

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

The IFF command causes the specified IFF file to be opened and used as an input file to DTIBLEND.

DTIBLEND is designed to be compatible with the "new" type IFF files introduced in conjunction with the IMP (IFF Map Processing) package. The origin offset entry in a type 2 MD (Map Descriptor) is used to offset coordinate values within an input IFF file. Although downwards compatible with "old" type IFF files a warning message is issued if an IFF file is found not to contain a set type 2 MD (Map Descriptor) entry.

Heights

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

Cliff lines are associated with two constant floating point height values; one for the terrain to the left of the cliffline (relative to the direction of digitising) and one for the height of the terrain to the right. Clifflines are not currently supported by DTIBLEND.

More then one input file may be specified using a new IFF command for each file. Defaults may be changed between reading files. This means that IFF files with different allocations of IFF entries for height information may be combined. Imperial heights may be converted to metric on input with the ENABLE TOMETRES command. The reverse is possible with the ENABLE TOFEET command. Incoming heights may be multiplied or divided by a user specified constant with the ENABLE MULTIPLYBY and ENABLE DIVIDEBY commands respectively.

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

The following messages are specific to the IFF command:

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

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


DTIBLEND> IFF DUA3:[DEMONSTRATION]IDAHO<CR>
DTIBLEND>

LIST COMMAND

------------------------------------------------------------------------------
LIST

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

FORMAT:		LIST file_spec

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

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

The LIST command specifies the name of a file which will contain a log of the DTIBLEND run.

The SHOW FILES command will display the name of the currently specified LIST file.

The following is a typical example of a file created by DTIBLEND :


============================== D T I B L E N D ================================

DTIBLEND log file created by TIM at  3-JUN-1988 15:04:24.96 using DTIBLEND


Two files specified for blend:
LSL$DTI:TOP1.DTI;0

LSL$DTI:BOTTOM.DTI;0

With a BORDER value of 3, all DTI z values are subject to change that
lie within the rectangle defined by:
SW corner:          0.000         196.000
NE corner:        200.000         204.000

In LSL$DTI:TOP1.DTI;0 this affects:
Column 1 to column 101 and row 1 to row 3

In LSL$DTI:BOTTOM.DTI;0 this affects:
Column 1 to column 101 and row 101 to row 99

IFF control is supplied by:

LSL$DATA_ROOT:[USER.DATA]CONTROL.IFF;4

Heights expected in type 3 ACs

IFF selections:

Layers:
0-32767

Feature codes:
0-32767

================================================================================

--------------------------------------------------------------------------------
IFF file #1 is LSL$DATA_ROOT:[USER.DATA]CONTROL.IFF;4
File has no IFF HI entry.

Two BLEND files specified - calculating mean values for the common edge


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

Blending posts in DTI file LSL$DTI:TOP1.DTI;0


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

Blending posts in DTI file LSL$DTI:BOTTOM.DTI;0


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

The following error messages are specific to the LIST command:


*** WARNING *** You must specify a file-spec argument to the LIST command

*** ERROR *** You must specify a file-spec argument to the LIST command

*** ERROR *** Unable to interpret input file-spec

--------------------------------------------------------------------------------
Example:

DTIBLEND>LIST JEMIMA.LIS
DTIBLEND>

NULL COMMAND

--------------------------------------------------------------------------------
NULL

--------------------------------------------------------------------------------
FORMAT: NULL null_value

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