TRANSCO Process
To access this process:
- Enter "TRANSCO" into the Command Line and press <ENTER>.
-
Display the Find Command screen, locate TRANSCO and click Run.
See this process in the Command Table.
Process Overview
Transform coordinates from one coordinate system to another. This is similar to the transform-coordinates command but instead works on data files, not loaded data objects.
Before coordinate transformation is performed, the input file and parameters are checked, and if the transformation cannot be completed with the specified inputs, a message displays indicating failure. This may be due to coordinate system not being recognised, or coordinates not being compatible with the coordinate systems selected.
@SOURCE and @TARGET must reference valid Well Known Transformation (WKT) codes. These codes are listed on the transform-coordinate command screen and TRANSCO process references must match these codes precisely. For example, "EPSG:8321" is fine but "8321" or "EPSG 8321" will cause the process to abort.
Input Files
Name |
Description |
I/O Status |
Required |
Type |
IN |
Input file. Must contain at least X , Y and Z explicit numeric fields. |
Input |
Yes |
Undefined |
Output Files
Name |
I/O Status |
Required |
Type |
Description |
OUT |
Output |
No |
Undefined |
Output file. Will contain updated coordinate fields. |
Fields
Name |
Description |
Source |
Required |
Type |
Default |
X/Y/Z |
X/Y/Z coordinate field in IN. |
IN |
Yes |
Undefined |
Undefined |
Parameters
Name |
Description |
Required |
Default |
Range |
Values |
NORMAL |
Normalise axis order: =0 : Do not normalise axis(0) =1 : Normalise axis order(1) |
No | 1 | 0,1 | 0,1 |
SOURCE |
Expected source coordinate key. This value must exactly match the Coordinate System Selection Code from the interactive transform-coordinates screen. |
Yes | Undefined | Undefined | Any valid WKT code including both alphanumeric and numeric code elements, for example; "EPSG:4326". |
TARGET |
Expected target coordinate key. This value must exactly match the Coordinate System Selection Code from the interactive transform-coordinates screen. |
Yes | Undefined | Undefined | Any valid WKT code including both alphanumeric and numeric code elements, for example; "EPSG:4326". |
Example
!TRANSCO
&IN(mySamples), &OUT(myTransformedSamples), X(XPT), Y(YPT),Z(ZPT),
@NORMAL = 1, @SOURCE(EPSG:27700), @TARGET(EPSG:4326)
Related topics and activities
- transform-coordinates ("tco") (command)
- Transform Coordinates (screen)