--------------------------------------------------------------------------------
MODULE    ITRANS

--------------------------------------------------------------------------------
REPLACES  Projection computation and transformation functions of IPR

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

FUNCTION

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

FORMAT


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

PROMPTS


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

COMMAND PARAMETERS

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

RESTRICTIONS

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

COMMAND QUALIFIERS

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

DESCRIPTION

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

EXAMPLES

$ ITRANS EXAMPLE EXGEOG<CR> %ITRANS-W-NOV2MD, map descriptor in 'DUA0:[IFF.IMP.ITRANS]EXAMPLE.IFF;1' is not version 2 Enter projection data for current IFF file

******************************************
Enter spheroid code (0): 9<CR> (Airy) Enter projection code (100): 101<CR> (UK national grid) Enter scale of map (0.0): 2500<CR> Enter unit code (2): <CR> (metres) Define local origin as Eastings and Northings (0.0 0.0): 599000 499000<CR> Enter projection data for target IFF file
*****************************************
Using spheroid : 9 (Airy) Enter projection code (101): 100<CR> (Geographic (ie Lat and Long)) Enter scale of map (2500.0): <CR> Enter unit code (5): ?<CR> Allowable Units and their codes are:- 0 Unset 1 feet 2 metres 3 seconds of arc 4 degrees of arc 5 radians 101 mm on table 102 mm on map sheet 103 thous (mils) on table 104 thous (mils) on map sheet 105 user units 110 1/10 seconds of arc Enter unit code (5): 4<CR> (degrees of arc) Define local origin as Latitude and Longitude (54.347 1.062): <CR> Longitude (1.062): <CR> Input projection system
***********************
Spheroid : 9 (Airy) Projection : 101 (UK national grid) Scale : 2500.0 Units : 2 (metres) Local origin : 599000.000 (Eastings) 499000.000 (Northings) Output projection system
************************
Spheroid : 9 (Airy) Projection : 100 (Geographic (ie Lat and Long)) Scale : 2500.0 Units : 4 (degrees of arc) Local origin : 54.347 (Latitude) 1.062 (Longitude) ELAPSED: 00:00:47.89 CPU: 0:00:05.67 BUFIO: 68 DIRIO: 55 FAULTS: 108 $

$ ITRANS/LOG/OUTPUT EXGEOG EXMERC<CR> %LSLLIB-I-IFFOPENED, DUA0:[IFF.IMP.ITRANS]EXGEOG.IFF;1 opened for read Existing map descriptor: Spheroid : 9 (Airy) Projection : 100 (Geographic (ie Lat and Long)) Scale : 2500.0 Units : 4 (degrees of arc) Local origin : 54.347 (Latitude) 1.062 (Longitude) Enter projection data for target IFF file

*****************************************
Using spheroid : 9 (Airy) Enter projection code (100): 5<CR> (Mercator) The Mercator projection requires the following additional information:- Latitude that has true scale in DDD MM SS.SS format ( 0 00 00.000N): 49N<CR> Longitude of the central meridian in DDD MM SS.SS format ( 0 00 00.000E): 2W<CR> Eastings of the origin of the projection (0.0): <CR> Northings of the origin of the projection (0.0): <CR> Enter scale of map (2500.0): <CR> Enter unit code (2): <CR> (metres) Define local origin as Eastings and Northings (224044.019 4733264.099): <CR> Northings (4733264.099): <CR> %LSLLIB-I-IFFOPENED, DUA0:[IFF.IMP.ITRANS]EXMERC.IFF;1 opened for write ELAPSED: 00:00:40.70 CPU: 0:00:04.43 BUFIO: 45 DIRIO: 69 FAULTS: 280 $ $ ITRANS/POINT<CR> Enter projection data for source system
***************************************
Enter spheroid code (0): <CTRL/Z> %ITRANS-W-EOF, program terminated prematurely by '_^Z' ELAPSED: 00:00:03.19 CPU: 0:00:00.34 BUFIO: 6 DIRIO: 0 FAULTS: 135

$ ITRANS/POINT/OUTPUT=EXPOINT<CR>
 
Enter projection data for source system
***************************************
Enter spheroid code (0): 9<CR> (Airy) Enter projection code (100): 101<CR> (UK national grid) Enter unit code (2): <CR> (metres) Enter projection data for target system
***************************************
Using spheroid : 9 (Airy) Enter projection code (101): 5<CR> (Mercator) The Mercator projection requires the following additional information:- Latitude that has true scale in DDD MM SS.SS format ( 0 00 00.000N): 49N<CR> Longitude of the central meridian in DDD MM SS.SS format ( 0 00 00.000E): 2W<CR> Eastings of the origin of the projection (0.0): <CR> Northings of the origin of the projection (0.0): <CR> Enter unit code (2): <CR> (metres) Eastings and Northings: 599000 500000<CR> Transformed point 224092.895 4734388.290 Eastings and Northings: 599000 499000<CR> Transformed point 224044.019 4733264.099 Eastings and Northings: 600000 499000<CR> Transformed point 225168.075 4733215.114 Eastings and Northings: 600000 500000<CR> Transformed point 225217.195 4734339.279 Eastings and Northings: <CTRL/Z> ELAPSED: 00:00:45.68 CPU: 0:00:00.84 BUFIO: 50 DIRIO: 15 FAULTS: 145 $

================================== ITRANS ====================================== ITRANS invoked by TIM using terminal LTA75: at 9-NOV-1986 08:52:29.05 Command line: ITRANS/POINT/OUTPUT=EXPOINT Input projection system

***********************
Spheroid : 9 (Airy) Projection : 101 (UK national grid) Units : 2 (metres) Output projection system
************************
Spheroid : 9 (Airy) Projection : 5 (Mercator) Latitude of true scale : 49 00 00.000N Longitude of the central meridian : 2 00 00.000W Eastings of origin : 0.000 Northings of origin : 0.000 Units : 2 (metres) Transformed points
******************
Input Point Output Point Easting Northing Easting Northing 599000.000 500000.000 224092.895 4734388.290 599000.000 499000.000 224044.019 4733264.099 600000.000 499000.000 225168.075 4733215.114 600000.000 500000.000 225217.195 4734339.279

$ ITRANS/DESCR/OUTPUT=EXDESC/LOG EXMERC<CR> %LSLLIB-I-IFFOPENED, DUA0:[IFF.IMP.ITRANS]EXMERC.IFF;1 opened for read Existing map descriptor: Spheroid : 9 (Airy) Projection : 5 (Mercator) Latitude of true scale : 49 00 00.000N Longitude of the central meridian : 2 00 00.000W Eastings of origin : 0.000 Northings of origin : 0.000 Scale : 2500.0 Units : 2 (metres) Local origin : 224044.019 (Eastings) 4733264.099 (Northings) Enter projection data for current IFF file

******************************************
Enter spheroid code (9): <CR> (Airy) Enter projection code (5): <CR> (Mercator) The Mercator projection requires the following additional information:- Latitude that has true scale in DDD MM SS.SS format ( 49 00 00.000N): <CR> Longitude of the central meridian in DDD MM SS.SS format ( 2 00 00.000W): <CR> Eastings of the origin of the projection (0.0): <CR> Northings of the origin of the projection (0.0): <CR> Enter scale of map (2500.0): <CR> Enter unit code (2): 105<CR> (user units) Define local origin as Eastings and Northings (224044.019 4733264.099): 0<CR> Northings (4733264.099): 0<CR> %LSLLIB-I-IFFOPENED, DUA0:[IFF.IMP.ITRANS]EXMERC.IFF;1 opened for update %ITRANS-I-MDPTCHED, MD entry patched into 'DUA0:[IFF.IMP.ITRANS]EXMERC.IFF;1' ELAPSED: 00:00:26.64 CPU: 0:00:01.15 BUFIO: 52 DIRIO: 25 FAULTS: 165

$ ITRANS/OUTPUT/LOG EXMERC EXAMPLE1<CR> %LSLLIB-I-IFFOPENED, DUA0:[IFF.IMP.ITRANS]EXMERC.IFF;1 opened for read Existing map descriptor: Spheroid : 9 (Airy) Projection : 5 (Mercator) Latitude of true scale : 49 00 00.000N Longitude of the central meridian : 2 00 00.000W Eastings of origin : 0.000 Northings of origin : 0.000 Scale : 2500.0 Units : 105 (user units) Local origin : 0.000 (Eastings) 0.000 (Northings) Data are not in projection units Existing control points are: 48.876 1124.191 0.000 0.000 1124.056 -48.985 1173.176 1075.180 Do you wish to use these control points [N]? N<CR> Enter control point values in metres on Mercator projection Enter coordinates of NW corner: 224092.90 4734388.29 Enter coordinates of SW corner: 224044.02 4733264.10 Enter coordinates of SE corner: 225168.08 4733215.11 Enter coordinates of NE corner: 225217.20 4734339.28 Enter projection data for target IFF file

*****************************************
Using spheroid : 9 (Airy) Enter projection code (5): 101<CR> (UK national grid) Enter scale of map (2500.0): <CR> Enter unit code (2): <CR> (metres) Define local origin as Eastings and Northings (599001.892 498956.5): 599000 499000<CR> %LSLLIB-I-IFFOPENED, DUA0:[IFF.IMP.ITRANS]EXAMPLE1.IFF;1 opened for write ELAPSED: 00:02:07.74 CPU: 0:00:08.42 BUFIO: 52 DIRIO: 72 FAULTS: 272

================================== ITRANS ====================================== ITRANS invoked by TIM using terminal LTA75: at 9-DEC-1986 09:12:29.05 Command line: ITRANS/OUTPUT/LOG EXMERC EXAMPLE1 Input projection system

***********************
Spheroid : 9 (Airy) Projection : 5 (Mercator) Latitude of true scale : 49 00 00.000N Longitude of the central meridian : 2 00 00.000W Eastings of origin : 0.000 Northings of origin : 0.000 Scale : 2500.0 Units : 105 (user units) Local origin : 0.000 (Eastings) 0.000 (Northings) Control points (from CP entry) used for 2 point transformation
**************************************************************
Input Target Final 48.876 1124.191 48.880 1173.180 48.879 1173.182 0.000 0.000 0.000 48.990 0.001 48.988 1124.056 -48.985 1124.060 0.000 1124.059 0.002 1173.176 1075.180 1173.180 1124.170 1173.181 1124.168 Default origin calculated as: 224044.020 4733215.110 Output projection system
************************
Spheroid : 9 (Airy) Projection : 101 (UK national grid) Scale : 2500.0 Units : 2 (metres) Local origin : 599000.000 (Eastings) 499000.000 (Northings) Input file : DUA0:[IFF.IMP.ITRANS]EXMERC.IFF;1 Output file: DUA0:[IFF.IMP.ITRANS]EXAMPLE1.IFF;1

$ itrans/point/datum/height<CR>
 
Enter projection data for source system
***************************************
Enter spheroid code (0): 5<CR> (World Geodetic System 72 (WGS 72)) Define Geoidal - spheroidal separation (0.0): <CR> Enter projection code (100): <CR> (Geographic (ie Lat and Long)) Enter unit code (200): <CR> (dd mm ss.ss format) Define shift in X from original datum to target datum (0.0): 0.0<CR> Define shift in Y from original datum to target datum (0.0): 0.0<CR> Define shift in Z from original datum to target datum (0.0): 4.5<CR> Define rotation about Z axis of the target datum from the original datum (in DDD MM SS.SS format) (+ 0 00 00.000) : 00 00 00.554<CR> Define scale difference between datums (in ppm) (0.0) : 0.2263<CR> Enter projection data for target system
***************************************
Enter spheroid code (5): 22<CR> (World Geodetic System 84 (WGS 84)) Define Geoidal - spheroidal separation (0.0): <CR> Enter projection code (100): <CR> (Geographic (ie Lat and Long)) Enter unit code (200): <CR> (dd mm ss.ss format) Input projection system
***********************
Spheroid : 5 (World Geodetic System 72 (WGS 72)) (with Geoid - Spheroid separation of 0.0) Projection : 100 (Geographic (ie Lat and Long)) Units : 200 (dd mm ss.ss format) Parameters used for datum conversion
************************************
DX = 0.00 DY = 0.00 DZ = 4.50 RZ = + 0 00 00.554 SF = 0.23 (parts per million) Output projection system
************************
Spheroid : 22 (World Geodetic System 84 (WGS 84)) (with Geoid - Spheroid separation of 0.0) Projection : 100 (Geographic (ie Lat and Long)) Units : 200 (dd mm ss.ss format) Latitude, Longitude and Height: 39 13 26.5782n 98 32 32.2870w 570.88<CR> Transformed point 39 13 26.698N 98 32 31.733W 573.25 Latitude, Longitude and Height: ^Z ELAPSED: 0 00:02:07.87 CPU: 0:00:00.18 BUFIO: 66 DIRIO: 0 FAULTS: 147 $

$ ITRANS/FOUR/CONTROL=EXAMPLE RWR_GRID RWR_OUT<CR> Existing map descriptor: Spheroid : 9 (Airy) Projection : 101 (UK national grid) Scale : 2500.0 Units : 2 (metres) Local origin : 499000.000 (Eastings) 599000.000 (Northings)

%ITRANS_W_ERRCPTS, residuals in X and Y of 0.59 1.81 metres
Do you wish to continue with these residuals [N]? Y Default origin of current IFF file has been computed as: Easting 499000.000 Northing 599000.0 Enter projection data for target IFF file
*****************************************
Using spheroid : 9 (Airy) Using projection: 101 (UK national grid) Enter unit code (105): <CR> (user units) Define local origin as Eastings Northings (499000.0 599000.0): <CR> (599000.0) <CR> Input projection system
***********************
Spheroid : 9 (Airy) Projection : 101 (UK national grid) Scale : 2500.0 Units : 2 (metres) Local origin : 499000.000 (Eastings) 599000.000 (Northings) Control points (from command file) used for 4 point transformation
******************************************************************
Input Target Final 499000.000 600000.000 499000.000 600000.000 498999.688 599999.375 499000.000 599000.000 499000.000 599000.000 498999.826 598999.653 500000.000 599000.000 500000.000 599000.000 499999.688 598999.375 500000.000 600000.000 500002.500 600005.000 500002.049 600004.097 499250.000 599500.000 499250.000 599500.000 499250.035 599500.069 499750.000 599500.000 499750.000 599500.000 499750.590 599501.181 499500.000 599250.000 499500.000 599250.000 499500.035 599250.069 499500.000 599750.000 499500.000 599750.000 499500.590 599751.181 Default origin calculated as: 499000.000 599000.000 Output projection system
************************
Spheroid : 9 (Airy) Projection : 101 (UK national grid) Scale : 2500.0 Units : 105 (user units) Local origin : 499000.000 (Eastings) 599000.000 (Northings) ELAPSED: 0 00:00:39.71 CPU: 0:00:01.48 BUFIO: 67 DIRIO: 104 FAULTS: 218 In this example the /CONTROL qualifier has been given in conjunction with the /FOUR qualifier. This has the effect of reading the control points from a file, in this case called EXAMPLE.DAT (shown below), which is held in the current directory and performing a four point empirical transformation using these control points.

! ! This is an example control point file ! ! The coordinates are absolute; ie they include the local origin ! 499000.000 600000.000 499000.000 600000.000 499000.000 599000.000 499000.000 599000.000 500000.000 599000.000 500000.000 599000.000 500000.000 600000.000 500002.500 600005.000 ! this is only point in error 499250.000 599500.000 499250.000 599500.000 499750.000 599500.000 499750.000 599500.000 499500.000 599250.000 499500.000 599250.000 499500.000 599750.000 499500.000 599750.000 ; ; and this is the end of it

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

MESSAGES (INFORMATIONAL)

These messages give information only, and require no immediate action from the user.

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

MESSAGES (WARNING)

These messages are output when an error has occurred that can be corrected immediately by the user.

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

MESSAGES (FATAL)

After these messages have been output, ITRANS will be aborted. This may leave an invalid IFF file that should be deleted.

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

MESSAGES (OTHER)

In addition to the above messages which are generated by ITRANS 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. In most cases IFF errors will be due to a corrupt input file, and this should be the first area of investigation. If the cause of the error cannot be traced by the user and Laser-Scan are consulted, then the input file should be preserved to facilitate diagnosis.