ConvertCartoToGeoPoint - Cartographic to geographic coordinates conversion
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Convert cartographic coordinates to geographic one.

Detailed description
--------------------

This application computes the geographic coordinates from a cartographic one. User has to give the X and Y coordinate and the cartographic projection (UTM/LAMBERT/LAMBERT2/LAMBERT93/SINUS/ECKERT4/TRANSMERCATOR/MOLLWEID/SVY21).

Parameters
----------

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

.. [#] 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             |Output Cartographic 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 specified projection.
- **Y cartographic coordinates**: Y cartographic coordinates in the specified projection.

**Output Cartographic Map Projection**: Parameters of the output 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.

**Output lat**: Point latitude coordinates.

**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","1")

	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.