PROFILE - VECTOR PROFILE GENERATION FROM A DTM

MODULE PROFILE

Vector Profile Generation from a DTM

Issue 2.0 - 9 March 1989
Copyright (C) 1989  Laser-Scan Ltd
Science Park, Milton Road, Cambridge, England CB4 4FY  tel: (0223) 420414
Document "PROFILE Reference"   Category "Reference"
Document Issue  2.0 D R Catlow  09-March-1989
  1.1 F J Brown  30-November-1988
  1.0 D R Catlow  13-May-1988


--------------------------------------------------------------------------------
MODULE PROFILE

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

FUNCTION

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

FORMAT

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

PROMPTS

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

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

DESCRIPTION

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

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

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

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

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

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

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

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

PROFILE COMMANDS

_@ COMMAND

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

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

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

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

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

Typically the commands contained in the file will define frequently used values, such as default BAND and SECTOR parameters.

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

The following messages are specific to the _@ command:


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


PROFILE> @DEFAULT_BANDS
PROFILE> BAND 1 500.0 50.0
PROFILE> BAND 2 1000.0 100.0
PROFILE> BAND 3 2000.0 200.0
PROFILE> RETURN
Returning to terminal input
PROFILE>

_! COMMAND

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

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

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

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

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:


PROFILE> FILEIN TEST !open the file<CR>
PROFILE> !Define a window<CR>
PROFILE> WINDOW 1 1 10 10<CR>
PROFILE>

BAND COMMAND

--------------------------------------------------------------------------------
BAND

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

FORMAT:		BAND band_number width sample_interval

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

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

BAND is used to define the rate at which the DTM is sampled along a profile. Up to 20 different bands may be specified, each with a different width and sample interval. This allows a profile to be generated using a sample interval that varies with distance from the base station. It is generally used to sample the DTM at a lower rate in the immediate vicinity of the base station, and at a higher rate towards the edge of the area of interest.
If BAND is specified, any constant sample interval defined using the SAMPLE_INTERVAL command is ignored.

It is a requirement of the program that bands are defined in ascending sequence. For example, if an attempt to define parameters for band 3 is made, before bands 1 or 2 have been defined, an error message will be generated.

The command SHOW PARAMETERS may be used to output details of band parameters to the terminal.

A sample interval or a series of sample intervals must be specified using the SAMPLE_INTERVAL or BAND commands, before the command GO is given to generate the profiles.

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

The following error messages are specific to the BAND command:


*** ERROR *** Specifying command BAND
Command requires 3 arguments

*** ERROR *** Specifying command BAND
Band number must be in the range 1 to 20

*** ERROR *** Specifying command BAND
Parameters for lower band  must be defined first

*** ERROR *** Specifying command BAND
Band width must be specified as a positive real number

*** ERROR *** Specifying command BAND
Sample interval must be specified as a positive real number

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

PROFILE>BAND 1 1000.5 50.0<CR>
PROFILE>BAND 2 2500.0 100.0<CR>
PROFILE>

BUILDING COMMAND

--------------------------------------------------------------------------------
BUILDING

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

FORMAT:		 BUILDING file-spec

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

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

This command opens and maps into memory a DTI file, containing height information relating to buildings. Details derived from the header of the file are displayed on the terminal to confirm that the file has been successfully opened.

A clutter file may only be specified, after a DTM has been selected using the FILEIN command.

If the clutter file contains a DTI Projection Record, the position of the SW corner of the grid may be determined. This enables the clutter data to be correctly positioned with respect to the DTM. If the origin is unset or the file contains no projection record, the SW corner of the clutter file is assumed to register to the SW corner of the DTM.

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

The following error messages are specific to the BUILDING command:


*** ERROR *** Specifying command BUILDING
Input DTI filename is missing

*** ERROR *** Specifying command BUILDING
The input DTM must be specified first

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

PROFILE>BUILDING TEST_BUILDING


LSL$DTI:TEST_BUILDING.DTI	
Header: MIKE	 Data: WORD

Units are Metres

Matrix coverage    SW:    1     1    NE:   301   251
Matrix Window      SW:    1     1    NE:   301   251
Matrix Interval	    E:	  1	      N:     1
Value Range	     :      0   to   25


PROFILE>

DISABLE ABSOLUTE COMMAND

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

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

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

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

DISABLE ABSOLUTE disables the use of absolute coordinates, and is therefore used to cancel an ENABLE ABSOLUTE command. DISABLE ABSOLUTE causes the program to work in relative coordinates. The coordinates displayed in a SHOW FILEIN or SHOW PARAMETERS output will be relative, and those entered in a WINDOW, POINT, or POSITION command are expected also to be relative to the SW corner of the data.
By default coordinates are entered and displayed in absolute form.

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

The following error message is specific to the DISABLE command:


*** ERROR *** Specifying command DISABLE
Valid command qualifiers are ABSOLUTE, DIAGNOSTICS or TABLE

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


PROFILE> DISABLE ABSOLUTE<CR>
PROFILE>

DISABLE DIAGNOSTICS COMMAND

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

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

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

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

DISABLE DIAGNOSTICS disables the output of diagnostic messages, and is therefore used to cancel an ENABLE DIAGNOSTICS command.
By default diagnostic printout, which is sent to SYS$OUTPUT, is enabled.

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

The following error message is specific to the DISABLE command:


*** ERROR *** Specifying command DISABLE
Valid command qualifiers are ABSOLUTE, DIAGNOSTICS or TABLE

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


PROFILE> DISABLE DIAGNOSTICS<CR>
PROFILE>

DISABLE TABLE COMMAND

--------------------------------------------------------------------------------
DISABLE TABLE

--------------------------------------------------------------------------------
FORMAT: DISABLE TABLE

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

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

DISABLE TABLE disables the use of a digitising table, and is therefore used to cancel an ENABLE TABLE command.
By default the use of a digitising table is determined on program startup by the value assigned to the logical name LSL$AUTO_ENABLE_TABLE.

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

The following error message is specific to the DISABLE command:


*** ERROR *** Specifying command DISABLE
Valid command qualifiers are ABSOLUTE, DIAGNOSTICS or TABLE

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


PROFILE> DISABLE TABLE<CR>
PROFILE>

ENABLE ABSOLUTE COMMAND

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

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

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

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

ENABLE ABSOLUTE enables the use of absolute coordinates, and is cancelled by a DISABLE ABSOLUTE command. ENABLE ABSOLUTE causes the program to work in absolute coordinates. The coordinates displayed in a SHOW FILEIN or SHOW PARAMETERS output will be absolute, and those entered in a WINDOW, POINT, or POSITION command are expected also to be absolute
By default coordinates are entered and displayed in absolute form.

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

The following error message is specific to the ENABLE command:


*** ERROR *** Specifying command ENABLE
Valid command qualifiers are ABSOLUTE, DIAGNOSTICS or TABLE

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


PROFILE> ENABLE ABSOLUTE<CR>
PROFILE>

ENABLE DIAGNOSTICS COMMAND

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

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

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

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

ENABLE DIAGNOSTICS selects output of diagnostic messages. The messages are sent to SYS$OUTPUT.
The diagnostic printout consists of messages describing the process being performed, the percentage complete, and the number of profiles generated.

Note that if you are using a hardcopy terminal no percentage complete figures are generated.

By default diagnostic printout is selected, and may be turned off using the command DISABLE DIAGNOSTICS

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

The following error message is specific to the ENABLE command:


*** ERROR *** Specifying command ENABLE
Valid command qualifiers are ABSOLUTE, DIAGNOSTICS or TABLE

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


PROFILE> ENABLE DIAGNOSTICS<CR>
PROFILE>

ENABLE TABLE COMMAND

--------------------------------------------------------------------------------
ENABLE TABLE

--------------------------------------------------------------------------------
FORMAT: ENABLE TABLE

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

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

ENABLE TABLE allows the use of a digitising table. Its effect is cancelled be the DISABLE TABLE command.
By default the use of a digitising table is determined on program startup by the value assigned to the logical name LSL$AUTO_ENABLE_TABLE.

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

The following error message is specific to the ENABLE command:


*** ERROR *** Specifying command ENABLE
Valid command qualifiers are ABSOLUTE, DIAGNOSTICS or TABLE

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


PROFILE> ENABLE TABLE<CR>
PROFILE>

EXIT COMMAND

--------------------------------------------------------------------------------
EXIT

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

FORMAT:		 EXIT

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

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

The EXIT command is used to exit from PROFILE.
(pressing the Ctrl and Z keys together) may also be used to exit from the program.

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

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

PROFILE>EXIT

$

FILEIN COMMAND

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

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

FORMAT:		 FILEIN file-spec

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

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

This command opens and maps into memory a DTI file, containing the terrain elevation data to be used for profile generation. Details derived from the header of the file are displayed on the terminal to confirm that the file has been successfully opened.

On opening the DTM, a default area of interest covering the whole of the DTM area is defined. A smaller area of interest may be specified using the WINDOW command.

If the input file contains a DTI Projection Record, the absolute position of the SW corner of the DTM is determined. If the file contains no Projection Record, an origin of 0,0 is assumed, and therefore any coordinate values represent DTM offset values.

The input DTM must be specified before the commands BUILDING, GO, POSITION, SETUP MAP, VEGETATION, WATER and WINDOW.

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

The following error message is specific to the FILEIN command:


*** ERROR *** Specifying command FILEIN
Input DTI filename is missing

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

PROFILE>FILEIN TEST


LSL$DTI:TEST.DTI	
Header: MIKE	 Data: WORD

Units are Metres

Matrix coverage    SW:    1     1    NE:   301   251
Matrix Window      SW:    1     1    NE:   301   251
Matrix Interval	    E:	  1	      N:     1
Value Range	     :      0   to    851


PROFILE>

GO COMMAND

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

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

FORMAT:		 GO

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

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

GO is used to initiate the generation of the path profiles, and the output of the profiles to the IFF file.

Before the command is given, the input DTM and output IFF file, the position of the profile origin (base station), and a sample interval using either the SAMPLE_INTERVAL or BAND commands, must have been defined. All other optional commands such as WINDOW, PROFILE_INTERVAL and SECTOR should be first specified, if required.

If diagnostics are enabled, details on the progress of the processing operation are output to the terminal. Successful completion of processing is indicated by the display of the prompt PROFILE> on the terminal.

(pressing the Ctrl and C key together) may be used to abort processing. If is used, the output IFF file will be correctly closed and all features created so far will be preserved.

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

The following error message is specific to the GO command:


*** ERROR *** Specifying command GO
The input DTM must be specified before GO

*** ERROR *** Specifying command GO
The output IFF file must be specified before GO

*** ERROR *** Specifying command GO
Profile origin position has not been defined

*** ERROR *** Specifying command GO
Profile sample interval has not been defined

*** ERROR *** Specifying command GO
Profile origin is not within the current area of interest
Redefine the position, or window before issuing GO

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

PROFILE>GO
PROFILE>

HELP COMMAND

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

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

FORMAT:		 HELP [command]

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

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

A brief description is given of the function and format of the specified command.
If no parameter is supplied then a list of all commands available is given.

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

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

PROFILE>HELP FILEIN


FILEIN

	Opens and maps into memory a DTI file, containing the terrain
elevation data to be used for profile generation.  Details derived from the
header are displayed on the terminal to confirm that the file has been
successfully opened


PROFILE>

IFF COMMAND

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

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

FORMAT:		 IFF file-spec

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

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

IFF specifies the name of the output IFF file. This is the file which will contain the terrain profiles.

The commands SET FC and SET LAYER may be used to control the feature code assigned to each profile feature, and define the layer in which the features will be held. The SET AC_BEARING, SET AC_CLUTTER, and SET AC_DISTANCE commands may be used to control the AC type used to hold the profile bearing, a sample point clutter index, and the profile distance value respectively.

An IFF file must be specified before the command GO is issued.

If the input DTM contains a DTI Projection Record, details from the record are transferred to the Map Descriptor (MD) entry of the IFF file.

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

The following message is specific to the IFF command:


*** ERROR *** Specifying command IFF
Output IFF filename is missing 

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

PROFILE>IFF TEST_PROFILES
PROFILE

POINT COMMAND

--------------------------------------------------------------------------------
POINT

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

FORMAT:		 POINT x_coordinate y_coordinate

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

The format of the command parameters is controlled by the UNITS command.

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

The POINT command is used to define the geographical position of a profile end point. The point must lie within the geographical bounds of the DTM, but may be outside any currently defined area of interest.

On giving the command the program will immediately calculate the profile, and write the coordinate and attribute values to the IFF file. Any number of profiles may be defined in this way.

If a digitising table is available, and a map has been registered to the DTM using the SETUP MAP command, puck button 4 may be used to digitise the position of a profile end point.

The position of the base station (profile origin), a sampling interval and the name of an output IFF file must have been defined before the POINT command is given for the first time.

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

The following error messages are specific to the POINT command:


*** ERROR *** Specifying command POINT using puck button
No map set up has been performed

*** ERROR *** Specifying command POINT
The input DTM is undefined

*** ERROR *** Specifying command POINT
Point must lie within DTM bounds

*** ERROR *** Specifying command POINT
Command requires 2 x y coordinate values

*** ERROR *** Specifying command POINT
Latitude and longitude values supplied in wrong format

*** ERROR *** Specifying command POINT
Profile origin position has not been defined

*** ERROR *** Specifying command POINT
The sampling interval has not been defined

*** ERROR *** Specifying command POINT
No output IFF file has been specified

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

PROFILE>POINT 4500000 85000
PROFILE>

POSITION COMMAND

--------------------------------------------------------------------------------
POSITION

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

FORMAT:		 POSITION x_coordinate y_coordinate

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

The format of the command parameters is controlled by the UNITS command.

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

The POSITION command is used to define the geographical position of the base station. This is the point from which all profiles are constructed. The base station must be located within the geographical bounds of the DTM.

It is not necessary for the base station to be positioned exactly on a DTM node. If located between nodes, the terrain height at the profile origin will be interpolated from the DTM.

The height of the terrain surface at the base station position is displayed on the terminal after the POSITION command is given.

If a digitising table is available, and a map has been registered to the DTM using the SETUP MAP command, puck button 0 may be used to digitise the position of the base station.

The base station position must be defined before the GO command is issued.

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

The following error messages are specific to the POSITION command:


*** ERROR *** Specifying command POSITION using puck button
No map set up has been performed

*** ERROR *** Specifying command POSITION
The input DTM is undefined

*** ERROR *** Specifying command POSITION 
Point must lie within DTM bounds

*** ERROR *** Specifying command POSITION
Command requires 2 x y coordinate values

*** ERROR *** Specifying command POSITION
Latitude and longitude values supplied in wrong format

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

PROFILE>POSITION 4500000 85000
Height of terrain surface at base station is 106.00
PROFILE>

PROFILE_INTERVAL COMMAND

--------------------------------------------------------------------------------
PROFILE_INTERVAL

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

FORMAT:		PROFILE_INTERVAL  angle

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

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

The command PROFILE_INTERVAL defines the angular separation of profiles generated radially around the base station position.

In conjunction with the SECTOR command it determines the number of profiles that are generated. For example, if a 360 degree area of interest is defined, and the profile interval is 1 degree, 360 profiles will be generated in the IFF file.

A profile interval of 0 may be specified. This causes the program to construct a profile between every node in the DTM area of interest and the base station. On program startup, the profile interval will be set to 0.

The current profile interval value may be examined using the command SHOW PARAMETERS.

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

The following error messages are specific to the PROFILE_INTERVAL command:


*** ERROR *** Specifying command PROFILE_INTERVAL
Command requires 1 real argument

*** ERROR *** Specifying command PROFILE_INTERVAL
Command requires a real argument in the range 0 to 180

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

PROFILE>PROFILE_INTERVAL 15.0<CR>
PROFILE>

RESET BAND COMMAND

--------------------------------------------------------------------------------
RESET BAND

--------------------------------------------------------------------------------
FORMAT: RESET BAND

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

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

Cancels all previous BAND commands, causing the program to revert to the use of a constant sample interval specified by means of the SAMPLE_INTERVAL command.

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

The following message is specific to the RESET BAND command:


*** ERROR *** Specifying command RESET
Command qualifier is BAND

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


PROFILE> RESET BAND
PROFILE>

RETURN COMMAND

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

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

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

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

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

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

The following messages are specific to the RETURN command:


*** ERROR *** Specifying command RETURN
The RETURN command is only valid in a command file

Returning to terminal input

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


PROFILE> @DEFAULT_BANDS<CR>
PROFILE> BAND 1 1000.0 50.0
PROFILE> BAND 2 2000.0 100.0
PROFILE> RETURN
Returning to terminal input
PROFILE>

SAMPLE_INTERVAL COMMAND

--------------------------------------------------------------------------------
SAMPLE_INTERVAL

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

FORMAT:		SAMPLE_INTERVAL  sample_interval

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

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

The command SAMPLE_INTERVAL defines the rate at which the DTM is sampled when generating a profile. It therefore defines the separation of successive profile sample point coordinates.

The sample interval specified with this command is used for all profiles, and is constant along the profile irrespective of the distance of the sample point from the profile origin (base station). If a sample rate that varies with distance from the profile origin (base station) is required, one or more BAND commands should be used.

A sample interval or a series of sample intervals must be specified using the SAMPLE_INTERVAL or BAND commands, before the command GO is given to generate the terrain profiles.

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

The following error messages are specific to the SAMPLE_INTERVAL command:


*** ERROR *** Specifying command SAMPLE__INTERVAL
Command requires 1 real argument

*** ERROR *** Specifying command SAMPLE__INTERVAL
Command requires a positive value

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

PROFILE>SAMPLE_INTERVAL 10.5<CR>
PROFILE>

SECTOR COMMAND

--------------------------------------------------------------------------------
SECTOR

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

FORMAT:		SECTOR radius [bearing_1] [bearing_2]

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

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

SECTOR is used to define a sector of interest in the DTM. Profiles are only constructed between the profile origin (base station) and DTM nodes that lie within the sector of interest.

The sector of interest is defined in terms of a sector radius, and optionally 2 bearing values defining the angular limits of the sector.

If only a sector radius is supplied, a full circular scan around the base station will be performed, and the bearing values will be set to 0 and 360 degrees.

The order in which the bearing values are specified determines whether the area of interest is inclusive or exclusive to the angular limits. A clockwise convention is used. For example if the first bearing is defined as 40 degrees and the second bearing as 80 degrees, the angular width of the sector of interest will be 40 degrees rather than 320 degrees. If the values are supplied in the order 80 and 40 degrees, the angular width of the sector of interest will be 320 degrees.

Note that a sector of interest will be clipped to any rectangular area of interest that may have been defined.

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

The following error messages are specific to the SECTOR command:


*** ERROR *** Specifying command SECTOR
Command requires either 1 or 3 real arguments

*** ERROR *** Specifying command SECTOR
Sector distance must be specified as a positive real number

*** ERROR *** Specifying command SECTOR
Sector bearing values must be in the range 0 to 360

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

PROFILE>POSITION 100.5 450.3<CR>
PROFILE>SECTOR 1000.0 40.5 90.0<CR>
PROFILE>

SET AC_BEARING COMMAND

--------------------------------------------------------------------------------
SET AC_BEARING

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

FORMAT:		 SET AC_BEARING ac_type

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

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

The SET AC_BEARING command is used to specify the AC type value of the AC entry in the output IFF file that will hold the bearing of the profile.

By default an AC type 1001 will be used.

Use of the SHOW SETTINGS command is recommended to check on the current setting.

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

The following error messages are specific to the SET and SET AC_BEARING commands:


*** ERROR *** Specifying command SET
Command qualifiers are AC_BEARING, AC_CLUTTER, AC_LENGTH, FC, LAYER or SCALE

*** ERROR *** Specifying command SET AC_BEARING
Command requires an integer argument

*** ERROR *** Specifying command SET AC_BEARING
Command requires a feature code in the range 1 to 32767

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

PROFILE>SET AC_BEARING 2005
PROFILE>

SET AC_CLUTTER COMMAND

--------------------------------------------------------------------------------
SET AC_CLUTTER

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

FORMAT:		 SET AC_CLUTTER ac_type

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

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

Specifies the attribute code that will be used to used to identify the clutter index in an IFF Coordinate Block (CB) entry.

By default a value of 1003 is used.

Use of the SHOW SETTINGS command is recommended to check on the current setting.

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

The following error messages are specific to the SET and SET AC_CLUTTER commands:


*** ERROR *** Specifying command SET
Command qualifiers are AC_BEARING, AC_CLUTTER, AC_LENGTH, FC, LAYER or SCALE

*** ERROR *** Specifying command SET AC_CLUTTER
Command requires an integer argument

*** ERROR *** Specifying command SET AC_CLUTTER
Command requires a feature code in the range 1 to 32767

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

PROFILE>SET AC_CLUTTER 2003
PROFILE>

SET AC_LENGTH COMMAND

--------------------------------------------------------------------------------
SET AC_LENGTH

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

FORMAT:		 SET AC_LENGTH ac_type

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

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

The SET AC_LENGTH command is used to specify the AC type value of the AC entry in the output IFF file that will hold the length of the profile.

By default an AC type 1002 will be used.

Use of the SHOW SETTINGS command is recommended to check on the current setting.

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

The following error messages are specific to the SET and SET AC_LENGTH commands:


*** ERROR *** Specifying command SET
Command qualifiers are AC_BEARING, AC_CLUTTER, AC_LENGTH, FC, LAYER or SCALE

*** ERROR *** Specifying command SET AC_LENGTH
Command requires an integer argument

*** ERROR *** Specifying command SET AC_LENGTH
Command requires a feature code in the range 1 to 32767

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

PROFILE>SET AC_LENGTH 2004
PROFILE>

SET FC COMMAND

--------------------------------------------------------------------------------
SET FC

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

FORMAT:		 SET FC feature_code

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

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

The SET FC command is used to specify the feature code value that is given to all features in the output IFF file.

By default all features are given a feature code value of 1.

Use of the SHOW SETTINGS command is recommended to check on the current setting.

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

The following error messages are specific to the SET and SET FC commands:


*** ERROR *** Specifying command SET
Command qualifiers are AC_BEARING, AC_CLUTTER, AC_LENGTH, FC, LAYER or SCALE

*** ERROR *** Specifying command SET FC
Command requires 1 integer argument

*** ERROR *** Specifying command SET FC
Command requires a feature code in the range 1 to 32767

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

PROFILE>SET FC 4
PROFILE>

SET LAYER COMMAND

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

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

FORMAT:		 SET LAYER layer

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

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

The SET LAYER command is used to specify the layer into which features are placed in the output IFF file.

By default features are written to layer 1 in the IFF file.

Use of the SHOW SETTINGS command is recommended to check on the current setting.

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

The following error messages are specific to the SET and SET LAYER commands:


*** ERROR *** Specifying command SET
Command qualifiers are AC_BEARING, AC_CLUTTER, AC_LENGTH, FC, LAYER or SCALE

*** ERROR *** Specifying command SET LAYER
Command requires 1 integer argument

*** ERROR *** Specifying command SET LAYER
Command requires a feature code in the range 1 to 32767

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

PROFILE>SET LAYER 4
PROFILE>

SET SCALE COMMAND

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

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

FORMAT:		 SET SCALE scale

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

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

The SET SCALE command is used to specify the scale of the output IFF file. The scale value is stored in the MD (Map Descriptor) entry of the IFF file. The command is required since a scale value is not available from the DTI Projection Record.

By default a scale value of 50000 (ie. 1:50000) is written to the output IFF file.

Use of the SHOW SETTINGS command is recommended to check on the current setting.

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

The following error messages are specific to the SET and SET SCALE commands:


*** ERROR *** Specifying command SET
Command qualifiers are AC_BEARING, AC_CLUTTER, AC_LENGTH, FC, LAYER or SCALE

*** ERROR *** Specifying command SET SCALE
Command requires a real argument

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

PROFILE>SET SCALE 10000
PROFILE>

SETUP MAP COMMAND

--------------------------------------------------------------------------------
SETUP MAP

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

FORMAT:		 SETUP MAP

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

The SETUP MAP command allows a source document to be registered to the input DTM.

In order to register the map and a DTM, the DTM should have first been specified, and a source document should have been securely attached to the surface of a digitising table.

On giving the command you will be asked to digitise 4 rectangular registration points. The registration points represent 4 points on the map that correspond to the 4 corners of the DTM. The points are digitised in the order top left (NW), bottom left (SW), bottom right (SE) and top right (NE) using any button on the table puck. A point should be digitised in response to a prompt on the terminal.
An error message is generated if any of the angles of the digitised rectangle are less than 88 degrees, or greater than 92 degrees (ie. if the corner points of the rectangle are more than 2 degrees off rectangular). In this case you will be asked to redigitise the 4 registration points.
Setup of the map may be aborted using (pressing the Ctrl and Z keys together), or by pressing Button F on the table puck.

Following the registration of a map to the DTM, coordinate values required by the POINT, POSITION, SECTOR and WINDOW commands, may be input using the table puck.

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

The following error messages are specific to the SETUP and SETUP MAP commands:


*** ERROR *** Specifying command SETUP
Command qualifier is MAP

*** ERROR *** Specifying command SETUP MAP
Command is invalid if the table has not been initialised

*** ERROR *** Specifying command SETUP MAP
The input DTM must be specified before SETUP MAP

*** ERROR *** Setting up MAP
Badly digitised corner points; try again

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

PROFILE>SETUP MAP


Digitise map NW corner>

Digitise map SW corner>

Digitise map SE corner>

Digitise map NE corner>


PROFILE>

SHOW CLUTTER COMMAND

--------------------------------------------------------------------------------
SHOW CLUTTER

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

FORMAT:		 SHOW CLUTTER

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

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

SHOW CLUTTER displays the file specification of all currently defined clutter grid files. These are the names of the DTI files selected using the BUILDING, VEGETATION and WATER commands.

If a clutter file has not been specified, the file will be shown as undefined.

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

The following message is specific to the SHOW command:


*** ERROR *** Specifying command SHOW
Command qualifiers are CLUTTER, ENABLE, FILEIN, PARAMETERS or SETTINGS

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

PROFILE>SHOW CLUTTER


Current status:

BUILDING   File      : Undefined
VEGETATION File      : LSL$DTI:VEGETATION_TEST.DTI;1
WATER      File      : Undefined


PROFILE>

SHOW ENABLE COMMAND

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

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

FORMAT:		 SHOW ENABLE

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

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

Displays the current status of all the PROFILE options that may be enabled or disabled using the ENABLE and DISABLE commands.
The name of the option is shown, followed by either the word ON or OFF to indicate its current status.
If the command SHOW ENABLE is used before any ENABLE or DISABLE commands have been given, the default status of the options is displayed.

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

The following message is specific to the SHOW command:


*** ERROR *** Specifying command SHOW
Command qualifiers are CLUTTER, ENABLE, FILEIN, PARAMETERS or SETTINGS

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

PROFILE>SHOW ENABLE


Current status:

ABSOLUTE          On        DIAGNOSTICS      On         TABLE         Off



PROFILE>

SHOW FILEIN COMMAND

--------------------------------------------------------------------------------
SHOW FILEIN

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

FORMAT:		 SHOW FILEIN

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

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

Details extracted from the header of the DTM are displayed on the terminal, along with details of the current window (rectangular area of interest).

The header values are shown in the current units of measurement. This is dependent on the header type of the input file, or may be set explicitly using the UNITS command.

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

The following messages are specific to the commands SHOW and SHOW FILEIN:


*** ERROR *** Specifying command SHOW
Command qualifiers are CLUTTER, ENABLE, FILEIN, PARAMETERS or SETTINGS

*** WARNING *** The input DTM is undefined

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

PROFILE>SHOW FILEIN


LSL$DTI:TEST.DTI	
Header: MIKE	 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


PROFILE>

SHOW PARAMETERS COMMAND

--------------------------------------------------------------------------------
SHOW PARAMETERS

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

FORMAT:		 SHOW PARAMETERS

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

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

The SHOW PARAMETERS command is used to display information about the profile origin (base station), sample and profile intervals, sample bands and sector of interest.

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

The following message is specific to the SHOW command:


*** ERROR *** Specifying command SHOW
Command qualifiers are CLUTTER, ENABLE, FILEIN, PARAMETERS or SETTINGS

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

PROFILE>SHOW PARAMETERS


Base Station       :
 X Y Z (Metres)    : 443500.00  82550.00   43.00
       (Matrix)    :     69.00     50.00   43.00

Sector of Interest :

  RADIUS    BEARING 1    BEARING 2      WIDTH
  6000.00      0.00       360.00       360.00

Profile Interval   :    0.00 degrees (i.e. use all DTM nodes)

Sampling Interval  :   Variable (see Band Information)

Sample Bands       :   (in metres)

BAND       WIDTH      OUTER DISTANCE      SAMPLE INTERVAL
  1       3000.00        3000.00             200.00
  2       1000.00        4000.00             100.00
  3       1000.00        5000.00              50.00


PROFILE>

SHOW SETTINGS COMMAND

--------------------------------------------------------------------------------
SHOW SETTINGS

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

FORMAT:		 SHOW SETTINGS

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

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

Displays the name of all PROFILE parameters that may be set using the SET command, and their current values.
If the SHOW SETTINGS command is given before using a SET command, the values shown are the default values that are allocated to the parameters by PROFILE.

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

The following message is specific to the SHOW command:


*** ERROR *** Specifying command SHOW
Command qualifiers are CLUTTER, ENABLE, FILEIN, PARAMETERS or SETTINGS

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

PROFILE>SHOW SETTINGS


Current values:

AC_BEARING       1001       AC_CLUTTER       1003       AC_LENGTH       1002

FC                  1       LAYER               1       SCALE          50000.0


PROFILE>

SUB_SAMPLE COMMAND

--------------------------------------------------------------------------------
SUB_SAMPLE

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

FORMAT:	        SUB_SAMPLE column_interval row_interval

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

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

SUB_SAMPLE is used to define the interval at which PROFILE samples the columns and rows of the DTM with a profile interval of 0.

By default with a profile interval of 0, PROFILE constructs a path profile between the base station and each DTM node that lies within the rectangular or sector areas of interest using SUB_SAMPLE values of 1 and 1. If SUB_SAMPLE values of 2 and 2 are used, then only profiles between the base station and every second node along a DTM column and row, are constructed.

Note that if the number of columns and rows in the rectangular area of interest is not exactly divisible by the sub-sample values, profiles between the last column or row nodes are generated.

The SUB_SAMPLE command is used in situations where it is necessary to reduce the total number of profiles generated for subsequent analysis. The current sub-sampling intervals may be examined using the SHOW PARAMETERS command.

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

The following error messages are specific to the SUB_SAMPLE command:


*** ERROR *** Specifying command SUB_SAMPLE
Command requires 2 integer arguments

*** ERROR *** Specifying command SUB_SAMPLE
Command requires 2 positive integer arguments

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

PROFILE>SUB_SAMPLE 2 2
PROFILE>

SPAWN COMMAND

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

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

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

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

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

The command is generally used for file management purposes.

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

The following error messages are specific to the SPAWN command:


*** ERROR *** Specifying command SPAWN 
Command requires a valid DCL command line

*** ERROR *** Unable to spawn command, returning to PROFILE

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

PROFILE> SPAWN DIRECTORY LSL$DTI:*_._DTI

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.

PROFILE>

UNITS COMMAND

--------------------------------------------------------------------------------
UNITS

--------------------------------------------------------------------------------
FORMAT: UNITS units

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

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

The UNITS command defines in which units of measurement arguments to the POSITION and POINT commands are specified, and the units of measurement used when defining an area of interest in the input DTM by means of the WINDOW command.
The command also controls in what format details from the header of the DTM are displayed when the SHOW FILEIN command is given.
The command also controls in what format details of the current parameters are displayed when the SHOW PARAMETERS command is given.

The command should be given after defining the input DTM since an appropriate default units of measurement is set up when the file is opened. If the DTM file is of header type TED4 or UHL1 (ie DTED files), then the default is latitude and longitude specified in degrees, minutes and seconds; for all other header types metre units are assumed.

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

The following error messages are specific to the UNITS command:


*** ERROR *** Specifying command UNITS
Command qualifiers are MATRIX, METRES, PROJECTION, SECONDS or LATLONG

*** ERROR *** Specifying command UNITS
Command qualifiers LATLONG or SECONDS are only valid for DTED input DTI files

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


PROFILE> UNITS MATRIX<CR>
PROFILE>

VEGETATION COMMAND

--------------------------------------------------------------------------------
VEGETATION

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

FORMAT:		 VEGETATION file-spec

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

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

This command opens and maps into memory a DTI file, containing height information relating to vegetation. Details derived from the header of the file are displayed on the terminal to confirm that the file has been successfully opened.

A clutter file may only be specified after a DTM has been selected using the FILEIN command.

If the clutter file contains a DTI Projection Record, the position of the SW corner of the grid may be determined. This enables the clutter data to be correctly positioned with respect to the DTM. If the origin is unset or the file contains no projection record, the SW corner of the clutter file is assumed to register to the SW corner of the DTM.

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

The following error messages are specific to the VEGETATION command:


*** ERROR *** Specifying command VEGETATION
Input DTI filename is missing

*** ERROR *** Specifying command VEGETATION
Input DTM must be specified first

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

PROFILE>VEGETATION TEST_VEGETATION


LSL$DTI:TEST_VEGETATION.DTI	
Header: MIKE	 Data: WORD

Units are Metres

Matrix coverage    SW:    1     1    NE:   301   251
Matrix Window      SW:    1     1    NE:   301   251
Matrix Interval	    E:	  1	      N:     1
Value Range	     :      0   to   10


PROFILE>

WAIT COMMAND

--------------------------------------------------------------------------------
WAIT

--------------------------------------------------------------------------------
FORMAT: WAIT seconds

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

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

The WAIT command causes processing to be suspended for a specified number of seconds. It is designed for use in software demonstration situations and is of no value in a production flowline.

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

The following error message is specific to the WAIT command:


*** ERROR *** Specifying command WAIT
Command requires a real argument

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


PROFILE> WAIT 4.0<CR>
PROFILE>

WATER COMMAND

--------------------------------------------------------------------------------
WATER

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

FORMAT:		 WATER file-spec

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

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

This command opens and maps into memory a DTI file, containing information relating to water. Details derived from the header of the file are displayed on the terminal to confirm that the file has been successfully opened.

A clutter file may only be specified, after a DTM has been selected using the FILEIN command.

If the clutter file contains a DTI Projection Record, the position of the SW corner of the grid may be determined. This enables the clutter data to be correctly positioned with respect to the DTM. If the origin is unset or the file contains no projection record, the SW corner of the clutter file is assumed to register to the SW corner of the DTM.

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

The following error messages are specific to the WATER command:


*** ERROR *** Specifying command WATER
Input DTI filename is missing

*** ERROR *** Specifying command WATER
Input DTM must be specified first

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

PROFILE>WATER TEST_WATER


LSL$DTI:TEST_WATER.DTI	
Header: MIKE	 Data: WORD

Units are Metres

Matrix coverage    SW:    1     1    NE:   301   251
Matrix Window      SW:    1     1    NE:   301   251
Matrix Interval	    E:	  1	      N:     1
Value Range	     :      -1   to    0


PROFILE>

WINDOW COMMAND

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

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

FORMAT:		WINDOW  xmin ymin xmax ymax

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

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

The WINDOW command is used to limit profile calculation to a rectangular geographical area. Only profiles between the base station and DTM nodes that lie within the rectangle are generated when the GO command is given. The rectangular window is ignored when the POINT command is used.
The area of interest should lie within the geographical bounds of the DTM.

If a digitising table is available, puck Button 1 may be used to give the command WINDOW. When the button is pressed, you will be asked to digitise 2 points inside the map area, defining the SW (bottom lefthand) and NE (top righthand) corners of the rectangle. Definition of the area of interest may be abandoned by pressing puck Button F.

Note, that when the DTM is first opened, a default area of interest is set which corresponds to the whole of the DTM.

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

The following messages are specific to the WINDOW command:


*** ERROR *** Specifying command WINDOW
The input DTM must be specified before WINDOW

*** ERROR *** Specifying command WINDOW using puck button
No map set up has been performed

*** ERROR *** Specifying command WINDOW
Command requires 4 arguments

*** ERROR *** Specifying command WINDOW
NE corner values must exceed SW corner values

*** ERROR *** Specifying command WINDOW
Supplied values exceed matrix extents

*** ERROR *** Specifying command WINDOW
Latitude and longitude values supplied in wrong format

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

PROFILE>WINDOW 1 1 200 200
PROFILE>UNITS LATLONG
PROFILE>WINDOW 42 00 00N 3 00 00E 42 30 00N 2 58 40E
PROFILE>

PROFILE EXAMPLES

EXAMPLES

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

EXAMPLES

$ PROFILE

*** WARNING ***  Unable to initialise the table monitor
PROFILE will assume no table is available
PROFILE>FILEIN OS44000800

File    :  LSL$DTI:OS44000800.DTI
Header  :  ALVY  Data:  WORD

Units are Metres

Matrix Coverage   SW:  440000.00   80000.00    NE:  460000.00  100000.00
Matrix Window     SW:  440000.00   80000.00    NE:  460000.00  100000.00
Matrix Interval    E:      50.00                N:      50.00
Value Range         :     0   to    235

PROFILE>WINDOW 440000 80000 450000 90000

File    :  LSL$DTI:os44000800.DTI
Header  :  ALVY  Data:  WORD

Units are Metres

Matrix Coverage   SW:  440000.00   80000.00    NE:  460000.00  100000.00
Matrix Window     SW:  440000.00   80000.00    NE:  450000.00   90000.00
Matrix Interval    E:      50.00                N:      50.00
Value Range         :     0   to    235

PROFILE>POSITION 445000 85000
Height of terrain surface at base station is   145.00

PROFILE>SECTOR 6000
PROFILE>PROFILE_INTERVAL 3
PROFILE>SAMPLE_INTERVAL 100
PROFILE>SHOW PARAMETERS

Base Station       :
 X Y Z (Metres)    : 445000.00  85000.00  145.00
       (Matrix)    :     99.00     99.00  145.00

Sector of Interest :

  RADIUS    BEARING 1    BEARING 2      WIDTH
  6000.00      0.00       360.00       360.00

Profile Interval   :    3.00 degrees

Sampling Interval  :  100.00

Sample Bands       :      Undefined

PROFILE>IFF DAVEC
PROFILE>GO
%LSLLIB-I-IFFOPENED, LSL$DATA_ROOT:[LSL.IFF]DAVEC.IFF;1 opened for write

+----------------------------------------------------------------+
|                                                                |
|              Generating the terrain profiles                   |
|                                                                |
+----------------------------------------------------------------+

Total of 121 profiles written to IFF file
PROFILE>EXIT

In this example an area of interest in the DTM is defined using the WINDOW command. The base station (profile origin) is positioned in the centre of the area of interest. The SECTOR command has been used to define the radius of a circle surrounding the base station. The PROFILE_INTERVAL command is used to define the angular separation of the radial profiles, while the SAMPLE_INTERVAL command has been used to define a constant rate of sampling along the profiles. Output is to the file 'LSL$IF:DAVEC.IFF'. Diagnostics are enabled by default.

$PROFILE

WARNING ***  Unable to initialise the table monitor
PROFILE will assume no table is available
PROFILE>FILE OS44000800

File    :  LSL$DTI:OS44000800.DTI
Header  :  ALVY  Data:  WORD

Units are Metres

Matrix Coverage   SW:  440000.00   80000.00    NE:  460000.00  100000.00
Matrix Window     SW:  440000.00   80000.00    NE:  460000.00  100000.00
Matrix Interval    E:      50.00                N:      50.00
Value Range         :     0   to    235

PROFILE>WINDOW 440000 80000 445000 85000

File    :  LSL$DTI:OS44000800.DTI
Header  :  ALVY  Data:  WORD

Units are Metres

Matrix Coverage   SW:  440000.00   80000.00    NE:  460000.00  100000.00
Matrix Window     SW:  440000.00   80000.00    NE:  445000.00   85000.00
Matrix Interval    E:      50.00                N:      50.00
Value Range         :     0   to    235

PROFILE>POSITION 443500 82550
Height of terrain surface at base station is    43.00

PROFILE>SECTOR 6000
PROFILE>BAND 1 3000 200
PROFILE>BAND 2 1000 100
PROFILE>BAND 3 1000 50
PROFILE>IFF DAVEC
PROFILE>SHOW PARAMETERS

Base Station       :
 X Y Z (Metres)    : 443500.00  82550.00   43.00
       (Matrix)    :     69.00     50.00   43.00

Sector of Interest :

  RADIUS    BEARING 1    BEARING 2      WIDTH
  6000.00      0.00       360.00       360.00

Profile Interval   :    0.00 degrees (i.e. use all DTM nodes)

Sampling Interval  :   Variable (see Band Information)

Sample Bands       :   (in metres)

BAND       WIDTH      OUTER DISTANCE      SAMPLE INTERVAL
  1       3000.00        3000.00             200.00
  2       1000.00        4000.00             100.00
  3       1000.00        5000.00              50.00

PROFILE>GO
%LSLLIB-I-IFFOPENED, LSL$DATA_ROOT:[LSL.IFF]DAVEC.IFF;3 opened for write

Total distance of BANDS less than sector distance
Width of BAND 3 extended to   2000.00

+----------------------------------------------------------------+
|                                                                |
|              Generating the terrain profiles                   |
|                                                                |
+----------------------------------------------------------------+

Total of 10200 profiles written to IFF file

PROFILE>EXIT

In this example a profile is constructed between the base station and each DTM node in the sector of interest. A series of BAND commands have been given to define a sample interval that varies with distance along the profile. Since the total width of the bands, is less than the sector distance, the outer band has been extended. ELAPSED: 0 00:47:55.38 CPU: 0:09:00.06 BUFIO: 284 DIRIO: 7160 FAULTS: 527

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 IFF and DTI libraries or by the Laser-Scan I/O library, LSLLIB. IFF library messages are introduced by '%IFF' and are documented in the IFF library users' guide. 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.

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.