ConvertCartoToGeoPoint - Cartographic to geographic coordinates conversion

Convert cartographic coordinates to geographic ones.

Detailed description

This application computes the geographic coordinates from cartographic ones. User has to give the X and Y coordinate and the cartographic projection (see mapproj parameter for details).

Parameters

This section describes in details the parameters available for this application. Table [1] presents a summary of these parameters and the parameters keys to be used in command-line and programming languages. Application key is ConvertCartoToGeoPoint .

[1]Table: Parameters table for Cartographic to geographic coordinates conversion.
Parameter Key Parameter Name Parameter Type
carto Input cartographic coordinates Group
carto.x X cartographic coordinates Float
carto.y Y cartographic coordinates Float
mapproj Map Projection Choices
mapproj utm Universal Trans-Mercator (UTM) Choice
mapproj lambert2 Lambert II Etendu Choice
mapproj lambert93 Lambert93 Choice
mapproj wgs WGS 84 Choice
mapproj epsg EPSG Code Choice
mapproj.utm.zone Zone number Int
mapproj.utm.northhem Northern Hemisphere Boolean
mapproj.epsg.code EPSG Code Int
long Output long Float
lat Output lat Float
inxml Load otb application from xml file XML input parameters file
outxml Save otb application to xml file XML output parameters file

[Input cartographic coordinates]

  • X cartographic coordinates: X cartographic coordinates in the projection defined by mapproj parameter.
  • Y cartographic coordinates: Y cartographic coordinates in the projection defined by mapproj parameter.

Map Projection: Defines the map projection to be used. Available choices are:

  • Universal Trans-Mercator (UTM): A system of transverse mercator projections dividing the surface of Earth between 80S and 84N latitude.
  • Zone number: The zone number ranges from 1 to 60 and allows defining the transverse mercator projection (along with the hemisphere).
  • Northern Hemisphere: The transverse mercator projections are defined by their zone number as well as the hemisphere. Activate this parameter if your image is in the northern hemisphere.
  • Lambert II Etendu: This is a Lambert Conformal Conic projection mainly used in France.
  • Lambert93: This is a Lambert 93 projection mainly used in France.
  • WGS 84: This is a Geographical projection.
  • EPSG Code: This code is a generic way of identifying map projections, and allows specifying a large amount of them. See www.spatialreference.org to find which EPSG code is associated to your projection;.
  • EPSG Code: See www.spatialreference.org to find which EPSG code is associated to your projection.

Output long: Point longitude coordinates in decimal degrees.

Output lat: Point latitude coordinates in decimal degrees.

Load otb application from xml file: Load otb application from xml file.

Save otb application to xml file: Save otb application to xml file.

Example

To run this example in command-line, use the following:

otbcli_ConvertCartoToGeoPoint -carto.x 367074.625 -carto.y 4835740 -mapproj utm -mapproj.utm.northhem true -mapproj.utm.zone 31

To run this example from Python, use the following code snippet:

#!/usr/bin/python

# Import the otb applications package
import otbApplication

# The following line creates an instance of the ConvertCartoToGeoPoint application
ConvertCartoToGeoPoint = otbApplication.Registry.CreateApplication("ConvertCartoToGeoPoint")

# The following lines set all the application parameters:
ConvertCartoToGeoPoint.SetParameterFloat("carto.x", 367074.625)

ConvertCartoToGeoPoint.SetParameterFloat("carto.y", 4835740)

ConvertCartoToGeoPoint.SetParameterString("mapproj","utm")

ConvertCartoToGeoPoint.SetParameterString("mapproj.utm.northhem","true")

ConvertCartoToGeoPoint.SetParameterInt("mapproj.utm.zone", 31)

# The following line execute the application
ConvertCartoToGeoPoint.ExecuteAndWriteOutput()

Limitations

None

Authors

This application has been written by OTB-Team.