--------------------------------------------------------------------------------
MODULE    ISTART

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

REPLACES  Customer specific utilities. ISTART is a general purpose utility.

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

FUNCTION

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

FORMAT


--------------------------------------------------------------------------------
PROMPT

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

PARAMETER

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

COMMAND QUALIFIERS

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

RESTRICTIONS

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

DESCRIPTION


0        10        20        30        40        50        60        70
1234567890123456789012345678901234567890123456789012345678901234567890123456789

07                                            X_ORIG    Y_ORIG            1%
00                                                                          1%
00                            SCALE

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

EXAMPLES

$ ISTART CONTOURS
Specify map scale, eg 10000 : 10000
Specify coordinates for the top left control point (X then Y) : 0 1000
Specify coordinates for the bottom left control point (X then Y) : 0 0
Specify coordinates for the bottom right control point (X then Y) : 1000 0
Specify coordinates for the top right control point (X then Y) : 1000 1000
 ELAPSED:    0 00:00:24.71  CPU: 0:00:00.55  BUFIO: 12  DIRIO: 14  FAULTS: 77 
$

$ $ ISTART/OS SQ100450 Specify map scale, eg 10000 : 50000 Specify map extent, (X-extent [Y-extent]) : 40000 40000 Specify grid step, eg. 1000 : 1000 Specify origin offset X then Y : 100000 450000 ELAPSED: 0 00:00:41.71 CPU: 0:00:01.48 BUFIO: 10 DIRIO: 27 FAULTS: 104 $

$ $ ISTART/OS SQ100450/LEARNER ISTART creates an IFF output file. This file will be sent to the directory pointed to by the logical name LSL$IF:. Use SI to assign the logical name LSL$IF: to the directory where you intend the output from ISTART to go. If LSL$IF: does not point to the right directory it is probably best to quit now. Do you wish to continue [YES/NO]? YES You must now specify the map scale. The scale denominator only must be specified, ISTART cannot handle a representative fraction. To specify 1:50000 scale, for example, just type 50000 Specify map scale, eg 10000 : 10000 You must now specify the map extent. It is important to get this right as it will determine the values used in the IFF CP entry, the IFF range and the characteristics of the grid. The map extent is expressed in metres and is usually tied to an O.S. sheet format. For example a 1:50000 scale sheet usually has an extent of 40 x 40 km ie an extent of 40000 metres in X and 40000 in Y. To specify this extent just type 40000. The Y extent will default to that of the X extent. Typical scale/sheet extents are: SCALE X-EXTENT Y-EXTENT 1:1250 500 500 1:2500 1000 1000 1:10000 5000 5000 1:25000 20000 10000 1:50000 40000 40000 1:250000 270000 220000 Specify map extent, (X-extent [Y-extent]) : 5000 %ISTART-W-EQLEXT, X and Y extent values assumed equal You must now specify the grid step in metres. The value that you specify determines the spacing between the grid lines. On a 1:50000 scale map the grid step is usually 1000 metres ie 1Km. To specify this grid step you would have to type 1000. Specify grid step, eg. 1000 : 1000 You have specified the /USER_ORIGIN qualifier and so you must now specify the map origin offset. The numbers that you supply will be written into the IFF MD (Map Descriptor). The origin offset will be used by IMP modules like IMERGE to determine the relationship of the data held in this file with data relating to neighbouring maps. The origin offset should be specified as two floating point numbers, X then Y, eg 11000.0 91000.0. Specify origin offset, X then Y : 560000 270000 ELAPSED: 0 00:02:45.95 CPU: 0:00:04.63 BUFIO: 56 DIRIO: 104 FAULTS: 97 $

$ ISTART _IFF file for output: TST.IFF/TABLE/LOG/MCE/SYMBOLS/LAYER=37 %LSLLIB-I-IFFOPENED, LSL$IF:TST.IFF opened for write Specify map scale, eg 10000 : 50000 Use any cursor button to digitise the TOP LEFT control point, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to digitise the BOTTOM LEFT control point, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to digitise the BOTTOM RIGHT control point, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point).
__________________________________________________________
This is more than 0.33 mm away from the last measurement!
__________________________________________________________
Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). %TSTART-control point abandoned - try again Use any cursor button to digitise the BOTTOM RIGHT control point, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to digitise the TOP RIGHT control point, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Control points (in mm) minus offset: NW (top left ) 0.892 382.960 0.892 382.960 SW (bottom left ) 0.000 0.000 0.000 0.000 SE (bottom right) 179.400 0.700 179.400 0.700 NE (top right ) 176.360 385.093 176.360 385.093 Origin offset is 0.0 in X and 0.0 in Y ELAPSED: 0 00:00:44.42 CPU: 0:00:00.53 BUFIO: 67 DIRIO: 13 FAULTS: 141 $

$ $ ISTART _IFF file for output: TST/TABLE/THOU/CENTRE/LOG/LASERAID %LSLLIB-I-IFFOPENED, LSL$IF:TST.IFF opened for write Specify map scale, eg 10000 : 24000 Use any cursor button to digitise the TOP LEFT control point, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to digitise the BOTTOM LEFT control point, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to digitise the BOTTOM RIGHT control point, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to digitise the TOP RIGHT control point, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). Use any cursor button to repeat the measurement, except: (i) the highest cursor button (which abandons the whole session), (ii) the highest but one button (which abandons just the current control point). %ISTART-E-CPNONCYC, ISTART/CHECK finds that the control points are non-cyclic - output file deleted Control points (in mm) minus offset: NW (top left ) 0.000 60000.000 0.000 60000.000 SW (bottom left ) 0.000 0.000 0.000 0.000 SE (bottom right) -530000.0 -153000.0 -530000.0 -153000.0 NE (top right ) -490000.0 -147000.0 -490000.0 -147000.0 Origin offset is 570000.0 in X and 170000.0 in Y ELAPSED: 0 00:02:07.03 CPU: 0:00:03.82 BUFIO: 49 DIRIO: 93 FAULTS: 102 $


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

MESSAGES (INFORMATIONAL)

These messages give information only, and require no immediate action by the user. They are often used to supply explanatory information in support of a warning or error message.

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

MESSAGES (WARNING)

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

MESSAGES (ERROR)

These messages indicate an error in processing which has caused the program to terminate. The most likely causes are a corrupt or otherwise invalid input IFF file, or an error related to command line processing and file manipulation. It is most unlikely that any output file produced will be correctly processed.

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

MESSAGES (OTHER)

In addition to the above messages which are generated by ISTART itself, other messages may be produced by the command line interpreter (CLI) and by Laser-Scan libraries. In particular, messages may be generated by the IFF library. These are introduced by '%IFF' and are documented in the IFF library users' guide. 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. Generally, however, ISTART will attempt to delete any corrupt output file before program termination.