Transform Coordinates Dialog

Using this dialog to transform 3D data coordinates using standard transformations

Transform Coordinates dialog

To access this dialog use one of the following:

  • Activate the Sample Analysis ribbon and select Transform | Geographic

  • Run the command transform-coordinates.

  • Quick key 'tco'.

TheTransform Coordinatesdialog is used to transform a spatial data file's coordinates from one system to another using industry-standard coordinate systems .

It handles numerous types of coordinate representations, including cartographic and geodetic transformations.

Command Automation

This command can be automated using the syntax:

oDmApp.ParseCommand("transform-coordinates InFile=[Full path to source file];OutFile=[Full path to created file];InCRS=[Source file CRS reference];OutCRS=[Target file CRS reference];X=[X Coordinate Field];Y=[Y Coordinate Field];Z=[Z Coordinate Field]");

For example:

oDmApp.ParseCommand("transform-coordinates InFile=C:\\Database\\MyProject\\MyStrings.dm;OutFile=C:\\Database\\MyProject\\Transformed_Strings;InCRS=EPSG:32766;OutCRS=EPSG:32761;X=XP;Y=YP;Z=ZP");

 

Field Details:

Source File: details of input file for coordinate transformation:

Filename: browse for an existing file (*.dm). Any file containing XYZ coordinate data fields can be used; these do not need to be standard Datamine coordinate fields.

X Column: using the dropdown, select the column/field containing the X coordinate data.

Y Column: using the dropdown, select the column/field containing the Y coordinate data.

Z Column: using the dropdown, select the column/field containing the Z coordinate data.

note.gif (1017 bytes) Standard Datamine coordinate column/field names are automatically detected.
 

Target File: output file with transformed coordinates.

Filename: define a new file or browse for and select an existing file.

note.gif (1017 bytes)

The input file will then be copied to the output file, with the values in the specific X,Y and Z columns replaced by the transformed equivalent.

 

Source Coordinate System:

Key: select this option to define the input coordinate system using the interactive dialog.

Key Name: type in a standard coordinate key name or click Browse to use the Coordinate System Selection dialog to select the input coordinate system parameters.

Description: a short description of the selected coordinate system.

WKT: select this option to define the coordinate system using a Well Known Text transformation string.

WKT String: type in a standard WKT coordinate transformation string.

note.gif (1017 bytes)

There are a number of Well Known Text format standards used for coordinate transformation. Only the following are supported by your application:

  • EPSG

  • ESRI

  • IGNF

  • OGC

 

 

Status: a read-only display of WKT transformation string related warning and error messages.

Target Coordinate System:

Key: select this option to define the output coordinate system using the interactive dialog.

Key Name: type in a standard coordinate key name or click Browse to use the Coordinate System Selection dialog to select the input coordinate system parameters.

Description: a short description of the selected coordinate system.

WKT: select this option to define the coordinate system using a Well Known Text transformation string.

WKT String: type in a standard WKT coordinate transformation string.

Status: a read-only display of WKT transformation string related warning and error messages.

           If spatial data coordinates are being transformed for the first time, and you are unsure of what Target Coordinate System to use so that the data is displayed in its expected orientation, remember that your application uses a general XYZ cartesian coordinate system where:

  • X coordinates increase towards the East

  • Y coordinates increase towards the North

  • Z coordinates increase upwards.

 

OK: transform the coordinates using the defined parameters.

Cancel: close the dialog without transforming coordinates.

 

note.gif (1017 bytes)

Before the coordinate transformation is performed, the input file and parameters are checked, and the following error message is displayed if the transformation cannot be completed with the specified inputs:

"Could not perform the conversion. This may be due to coordinate system not being recognised, or coordinates not being compatible with the coordinate systems selected."

 

openbook.gif (910 bytes)		  Related Topics

 

Coordinate System Selection Dialog