VECTORISE - RASTER TO VECTOR


--------------------------------------------------------------------------------
MODULE VECTORISE

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

FUNCTION

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

FORMAT

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

PROMPTS

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

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

DESCRIPTION

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

FEATURE CODING AND AC LABELS

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

REPRESENTATION OF THE DATA IN THE IFF FILE

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

VECTORISE COMMANDS

COMMAND LIST

The following commands are defined :


	@		!		DISABLE ABSOLUTE	
	DISABLE DIAGNOSTICS		DISABLE LOG_FILE
	DISABLE SMOOTH	ENABLE ABSOLUTE ENABLE DIAGNOSTICS
	ENABLE LOG_FILE	ENABLE SMOOTH	EXIT		FILEIN
	GO		HELP 		IFF		RANGES
	RETURN		SET BORDER_FC	SET INTERIOR_FC SET LAYER
	SHOW ENABLE	SHOW FILEIN	SHOW RANGES	SHOW SETTINGS	
	SPAWN		UNITS		WAIT		WINDOW
	
	

_@ COMMAND

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

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

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

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

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

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


VECTORISE> @DEFAULTS
VECTORISE> ENABLE LOG_FILE
VECTORISE> ENABLE SMOOTH
VECTORISE> SET BORDER_FC 10
VECTORISE> RETURN
Returning to terminal input
VECTORISE>

_! COMMAND

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

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

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

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

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


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

DISABLE ABSOLUTE COMMAND

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

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

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

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

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

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

The following error message is specific to the DISABLE command:


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, DIAGNOSTICS, LOG_FILE or SMOOTH

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


VECTORISE> DISABLE ABSOLUTE<CR>
VECTORISE>

DISABLE DIAGNOSTICS COMMAND

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

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

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

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

DISABLE DIAGNOSTICS allows the user to cancel a previous 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
Command qualifiers are ABSOLUTE, DIAGNOSTICS, LOG_FILE or SMOOTH

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


VECTORISE> DISABLE DIAGNOSTICS<CR>
VECTORISE>

DISABLE LOG_FILE COMMAND

--------------------------------------------------------------------------------
DISABLE LOG_FILE

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

FORMAT:		 DISABLE LOG_FILE

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

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

Disables the output of file and vectorisation process statistics to a log file.
By default no log file is created.

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

The following error message is specific to the DISABLE command:


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, DIAGNOSTICS, LOG_FILE or SMOOTH

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

VECTORISE>DISABLE LOG_FILE
VECTORISE>

DISABLE SMOOTH COMMAND

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

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

FORMAT:		 DISABLE SMOOTH

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

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

Disables the option to smooth all interior links prior to output to the IFF file.
The vectorisation process involves extracting the boundaries of areas as they are represented in the input DTI file. The resulting links therefore reflect the grid nature of the input data, and if unsmoothed, the links have a jagged and characteristic 'staircase' appearance. For many mapping applications a smoothed or interpolated version of the links is often required. This may be achieved by enabling smoothing using the ENABLE SMOOTH command. For applications where an exact correspondence between the vector and raster data is required, or where the 'staircase' appearance of the data is of no concern, smoothing may be disabled using the DISABLE SMOOTH command.
By default no smoothing is applied to the links.

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

The following error message is specific to the DISABLE command:


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, DIAGNOSTICS, LOG_FILE or SMOOTH

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

VECTORISE>DISABLE SMOOTH
VECTORISE>

ENABLE ABSOLUTE COMMAND

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

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

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

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

If ENABLE ABSOLUTE is given, then coordinate values required by the WINDOW command, supplied in metre or projection units, must be specified as absolute (rather than relative) coordinate values.
For example if the projection indicates U.K. National Grid, then the WINDOW values may be specified as 6 figure National Grid coordinates.

By default window values should be specified as absolute coordinates. This option can be disabled using the DISABLE ABSOLUTE command.

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

The following error message is specific to the ENABLE command:


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, DIAGNOSTICS, LOG_FILE or SMOOTH

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


VECTORISE> ENABLE ABSOLUTE<CR>
VECTORISE>

ENABLE DIAGNOSTICS COMMAND

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

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

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

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

ENABLE DIAGNOSTICS allows the user to enable diagnostic printout.
The diagnostic printout consists of a series of messages indicating which operation is currently being preformed by VECTORISE, and the percentage progress.
The messages are sent to SYS$OUTPUT. Note that if you are using a hardcopy terminal no percentage progress figures are generated.
By default diagnostic printout is selected, and may be disabled using the command DISABLE DIAGNOSTICS

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

The following error message is specific to the DISABLE command:


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, DIAGNOSTICS, LOG_FILE or SMOOTH

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


VECTORISE> ENABLE DIAGNOSTICS<CR>
VECTORISE>

ENABLE LOG_FILE COMMAND

--------------------------------------------------------------------------------
ENABLE LOG_FILE

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

FORMAT:		 ENABLE LOG_FILE

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

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

Enables the output of file and vectorisation process statistics to a log file. The contents of the log file may be examined using a screen editor or sent to a line-printer.
The log file is given the extension LOG, and a name partly constructed from the output IFF filename, thus 'LSL$IF:IFF_filename.LOG'
An example log file is included in the documentation in the section VECTORISE LOG FILE.
By default no log file is created.

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

The following error message is specific to the ENABLE command:


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, DIAGNOSTICS, LOG_FILE or SMOOTH

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

VECTORISE>ENABLE LOG_FILE
VECTORISE>

ENABLE SMOOTH COMMAND

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

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

FORMAT:		 ENABLE SMOOTH

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

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

Enables the option to smooth all interior links prior to output to the IFF file.
The vectorisation process involves extracting the boundaries of areas as they are represented in the input DTI file. The resulting links therefore reflect the grid nature of the input data, and if unsmoothed the links have a jagged and characteristic 'staircase' appearance. For applications where an exact correspondence between the vector and raster data is required, the links should be held in this form, however for mapping applications a smoothed or interpolated version of the links is often required.
If smoothing is enabled, a Bezier interpolation algorithm using parameters that have been carefully chosen as most applicable for vectorised data, is applied to the links before output to the IFF file. Interpolation is performed on each link in turn. No interpolation is applied to links forming part of the image border, or to links that are defined by less than 4 coordinate points.
By default no smoothing is applied to the links.

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

The following error message is specific to the ENABLE command:


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, DIAGNOSTICS, LOG_FILE or SMOOTH

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

VECTORISE>ENABLE SMOOTH
VECTORISE>

EXIT COMMAND

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

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

FORMAT:		 EXIT

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

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

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

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

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

VECTORISE>EXIT
$

FILEIN COMMAND

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

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

FORMAT:		FILEIN file-spec

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

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

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

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

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

The following error message is specific to the FILEIN command:


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

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

VECTORISE>FILEIN TEST


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

Units are DTI Matrix Values

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

VECTORISE>

GO COMMAND

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

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

FORMAT:		GO

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

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

The GO command is used to initiate the vectorising process.

The IFF, FILEIN and RANGES commands must have been previously given to define the output IFF file, the the image to be processed, and to control how vectorisation should proceed.

The VECTORISE > prompt is displayed when vectorisation has been completed. The output IFF file is closed, however the input DTI file remains open until the EXIT command is given, or a new input file is selected using the FILEIN command. The current window and range values are preserved unless a new input DTI file is selected; the status of options set using ENABLE or DISABLE commands, or the values of various variables defined using the SET command remain unchanged.

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

The following error messages are specific to the GO command


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

*** ERROR *** Specifying command GO
The input DTI file is undefined

*** ERROR *** Specifying command GO
No ranges have been defined

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

VECTORISE>GO
VECTORISE>

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 specified then a list of all commands available is given.

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

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

VECTORISE>HELP ENABLE LOG_FILE


ENABLE LOG_FILE

	Enables the output of file and vectorisation process statistics
	to a log file.
	The contents of the log file may be examined using a screen
	editor or sent to a line-printer.


VECTORISE>

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 receive the vectorised data.

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:

VECTORISE>IFF TEST
VECTORISE>

RANGES COMMAND

--------------------------------------------------------------------------------
RANGES

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

FORMAT:		 RANGES lower_value [:upper_value] [,...]

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

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

This command defines the ranges within the DTI file which are used to partition the DTI file into separate areas for vectorisation.
The DTI value range may be divided into a series of equal value ranges by supplying one parameter. Alternatively the image may be segmented into a series of irregular value ranges by specifying a series of lower and upper values.
RANGE automatically invokes a SHOW RANGES command, to show how the DTI image has been divided into range values for vectorisation.

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

The following error messages are specific to the RANGES command:



*** ERROR *** Specifying command RANGES
The input DTI file must be specified before RANGES

*** ERROR *** Specifying command RANGES
Command requires at least 1 integer argument

*** ERROR *** Specifying command RANGES
Values are not in required format

*** ERROR *** Specifying command RANGES
Invalid range  to 

*** ERROR *** Specifying command RANGES
Range is outside DTI data range

*** ERROR *** Specifying command RANGES
 is an invalid interval value

*** ERROR *** Specifying command RANGES
Maximum number of ranges will be exceeded if an interval value of 
is used

--------------------------------------------------------------------------------
Examples:
In the following examples the input DTI file has a data value range of 0 to 100.

VECTORISE>RANGE 1:10,11:20,21:100


No. of Ranges    :     4
Range 1          :     0
Range 2          :     1     :    10
Range 3          :    11     :    20
Range 4          :    21     :   100


VECTORISE>RANGE 1:70,10

No. of Ranges    :     5
Range 1          :     0
Range 2          :     1     :    70
Range 3          :    71     :    80
Range 4          :    81     :    90
Range 5          :    91     :   100


VECTORISE>RANGE 20

No. of Ranges    :     6
Range 1          :     0
Range 2          :     1     :    20
Range 3          :    21     :    40
Range 4          :    41     :    60
Range 5          :    61     :    80
Range 6          :    81     :   100


VECTORISE>

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 for a flowline, and then return to input from the terminal for the run specific commands. To do this RETURN must be the last command in the indirect command file.

A RETURN command is only valid if present in a command file.

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


VECTORISE> @DEFAULTS
VECTORISE> ENABLE LOG_FILE
VECTORISE> ENABLE SMOOTH
VECTORISE> SET BORDER_FC 10
VECTORISE> RETURN
Returning to terminal input
VECTORISE>

SET BORDER_FC COMMAND

--------------------------------------------------------------------------------
SET BORDER_FC

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

FORMAT:		 SET BORDER_FC feature_code

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

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

Defines the feature code that is attached to all links that form part of the image border. The image border is defined by the means of the WINDOW command.
If the SET BORDER_FC command is not supplied, links that form part of the border will be assigned a value of 1 by default.

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

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


*** ERROR *** Specifying command SET
Command qualifiers are BORDER_FC, INTERIOR_FC or LAYER

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

*** ERROR *** Specifying command SET BORDER_FC
Command requires a feature code value in the range 0 to 32767

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

VECTORISE>SET BORDER_FC 10
VECTORISE>

SET INTERIOR_FC COMMAND

--------------------------------------------------------------------------------
SET INTERIOR_FC

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

FORMAT:		 SET INTERIOR_FC feature_code

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

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

Defines the feature code that is attached to all links that form part of the boundary of an interior area.
If the SET INTERIOR_FC command is not supplied, interior links will be assigned a value of 2 by default.

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

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


*** ERROR *** Specifying command SET
Command qualifiers are BORDER_FC, INTERIOR_FC or LAYER

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

*** ERROR *** Specifying command SET INTERIOR_FC
Command requires a feature code value in the range 0 to 32767

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

VECTORISE>SET INTERIOR_FC 20
VECTORISE>

SET LAYER COMMAND

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

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

FORMAT:		 SET LAYER layer_code

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

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

Defines the number of the layer that is created to contain the vectorised data in the output IFF file.
If the command SET LAYER is not supplied, the vectorised data is written to layer 1 in the output IFF file.

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

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


*** ERROR *** Specifying command SET
Command qualifiers are BORDER_FC, INTERIOR_FC or LAYER

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

*** ERROR *** Specifying command SET LAYER
Command requires a layer number in the range 1 to 32767

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

VECTORISE>SET LAYER 10
VECTORISE>

SET SCALE COMMAND

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

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

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

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

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

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

*** ERROR *** Specifying command scale.
Command requires a positive real number

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


VECTOTISE>SET SCALE 100000<CR>
VECTORISE>

SHOW ENABLE COMMAND

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

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

FORMAT:		 SHOW ENABLE

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

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

Displays the current status of all the VECTORISE 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 for the options is displayed.

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

The following message is specific to the command SHOW:


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

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

VECTORISE>SHOW ENABLE


Current status:

ABSOLUTE        On	DIAGNOSTICS     On        LOG_FILE       Off        

SMOOTH         Off


VECTORISE>

SHOW FILEIN COMMAND

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

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

FORMAT:		 SHOW FILEIN

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

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

Details extracted from the header of the currently opened DTI file are displayed on the terminal. Details of the current window or area of interest defined by the WINDOW command are also displayed.
The header values are shown in the current units of measurement. This is dependent on the header type of the input DTI file, or may be set explicitly by the user with the UNITS command.

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

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


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

*** WARNING *** The input DTI file is undefined

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

VECTORISE>SHOW FILEIN


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

Units are DTI Matrix Values

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


VECTORISE>

SHOW RANGES COMMAND

--------------------------------------------------------------------------------
SHOW RANGES

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

FORMAT:		 SHOW RANGES

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

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

Details of the current defined value ranges are displayed on the terminal. The number of ranges, and the range of values associated with each area are shown.

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

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


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

*** WARNING *** No ranges have been defined 

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

VECTORISE>SHOW RANGES


No. of Ranges    :     4
Range 1	         :     0
Range 2          :     1     :    10
Range 3          :    11     :    20
Range 4          :    21     :   100


VECTORISE>

SHOW SETTINGS COMMAND

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

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

FORMAT:		 SHOW SETTINGS

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

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

Displays the name of all VECTORISE variables 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 variables by VECTORISE.

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

The following message is specific to the command SHOW:


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

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

VECTORISE>SHOW SETTINGS


Current values:

BORDER_FC        1        INTERIOR_FC      2        LAYER            1

SCALE	    500000.00


VECTORISE>

SPAWN COMMAND

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

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

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

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

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

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

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


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

VECTORISE>

UNITS COMMAND

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

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

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

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

The UNITS command enables the user to specify in what units of measurement he wishes to define an area of interest in the input DTI file using the WINDOW command, or in what units of measurement details from the header of the DTI file are displayed using the SHOW FILEIN command.
The command should be given after defining the input DTI file, since an appropriate default units of measurement is set up whenever an input DTI file is opened.

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

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

The following error messages are specific to the UNITS command:


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

*** ERROR *** Specifying command UNITS
Command qualifier is invalid for the input file

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


VECTORISE> UNITS MATRIX<CR>
VECTORISE>

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:


VECTORISE> WAIT 4.0<CR>
VECTORISE>

WINDOW COMMAND

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

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

FORMAT:		WINDOW  xmin ymin xmax ymax

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

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

The WINDOW command is used to limit the vectorising process to a specified area of interest in the DTI file.
The values must be specified in the order bottom left hand (or south west) corner then top right hand (or north east) corner.
The area of interest should lie within the bounds of the DTI file.
If the logical name LSL$MATRIX_DEFAULT_WINDOW is defined with a value of "1", then a default area of interest defined in matrix units of bottom left hand corner 1,1 and top right hand corner 200,200 is set when the file is opened. If the logical name is absent or has any other value, or if the input DTI file has fewer than 200 columns or 200 rows, then a default window equivalent to the total matrix is set.

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

The following messages are specific to the WINDOW command:


*** ERROR *** Specifying command WINDOW
The input DTI file must be specified before WINDOW

*** ERROR *** Specifying command WINDOW
Command requires 2 x y coordinate pairs

*** 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 in wrong format

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

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

EXAMPLE VECTORISE SESSIONS

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

EXAMPLE VECTORISE SESSION

EXAMPLE VECTORISE SESSIONS

$ VECTORISE

VECTORISE> filein test

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

Units are DTI Matrix Values

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

VECTORISE> window 50 50 150 100
VECTORISE> ranges 200

No. of Ranges   :      6
Range   1       :      0           
Range   2       :      1   to    200
Range   3       :    201   to    400
Range   4       :    401   to    600
Range   5       :    601   to    800
Range   6       :    801   to    851
 
VECTORISE> enable smooth
VECTORISE> enable log_file
VECTORISE> iff test
VECTORISE> go


+-------------------------------------------------------------+
|                                                             |
|                Carrying out Line Following                  |
|                    Patch Number    1                        |
|                                                             |
+-------------------------------------------------------------+

+-------------------------------------------------------------+
|                                                             |
|                Writing segments to IFF file                 |
|                                                             |
+-------------------------------------------------------------+

Total number of segments output ...............  31


+-------------------------------------------------------------+
|                                                             |
|                   Writing node to IFF file                  |
|                                                             |
+-------------------------------------------------------------+

Total number of nodes output ..................  22


VECTORISE> exit

In this example, file LSL$DTI:TEST.DTI has been selected as the input file. An area of interest has been defined in matrix units using the WINDOW command. Only the data inside the specified rectangle will be processed. A constant range value of 200 has been used, and this has resulted in the data being classified into 6 area ranges. The options to interpolate the links before output, and to write processing and statistical information to a log file have been enabled. The vector data resulting from the vectorisation process is written to the file LSL$IF:TEST.IFJ Since no SET LAYER command has been given, the data is written to layer 1 in the file, and since no SET BORDER_FC or SET INTERIOR_FC commands have been given, border links are given a feature code of 1, while all other links are given a feature code of 2.

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

VECTORISE LOG FILE

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

EXAMPLE VECTORISE SESSION

-------------------------------------------------------------------------------- If the ENABLE LOG_FILE command is given prior to initiating the vectorising process, a LOG file containing details of the run is generated.


--------------------------------------------------------------------------
VECTORISE LOG file Created on                 : 15-SEP-87   10:24:27
--------------------------------------------------------------------------
Input from file     :  LSL$DTI:SWDTED.DTI
 
Matrix Coverage   SW:     1     1  NE:   301   251
Matrix Window     SW:   100   100  NE:   150   150
Matrix Interval    E:     1         N:     1
Value Range         :     0   to    851
 
Output to file      :  DUA0:[LSL.IFF]TEST.IFJ;2
--------------------------------------------------------------------------
Range Values        :
 
Range    1          :      0    
Range    2          :      1   to    200   
Range    3          :    201   to    400   
Range    4          :    401   to    600   
Range    5          :    601   to    800   
Range    6          :    801   to    851   
 
--------------------------------------------------------------------------
 
Output is to layer 1
Border links are feature code 1
Interior links are feature code 2
Option to smooth links is NOT selected
 
--------------------------------------------------------------------------
Vectorisation summary             :

Total number of segments output   :     33
Border segments                   :     18
Interior segments                 :     15

Total number of nodes output      :     22
Border nodes                      :     18
Junction nodes                    :      2
Loop nodes                        :      2

Link point storage used           :   0.15%
Link ends storage used            :   0.08%
Node point storage used           :   0.14%
Node arm storage used             :   0.08%
--------------------------------------------------------------------------

VECTORISE messages

See vectorisemsg.html generated from VECTORISEMSG.RNO.