ConvertSensorToGeoPoint - Convert Sensor Point To Geographic Point
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Sensor to geographic coordinates conversion.

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

This Application converts a sensor point of an input image to a geographic point using the Forward Sensor Model of the input image.

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 *ConvertSensorToGeoPoint* .

.. [#] Table: Parameters table for Convert Sensor Point To Geographic Point.

+--------------+---------------------------------------+--------------------------+
|Parameter Key |Parameter Name                         |Parameter Type            |
+==============+=======================================+==========================+
|in            |Sensor image                           |Input image               |
+--------------+---------------------------------------+--------------------------+
|input         |Point Coordinates                      |Group                     |
+--------------+---------------------------------------+--------------------------+
|input.idx     |X value of desired point               |Float                     |
+--------------+---------------------------------------+--------------------------+
|input.idy     |Y value of desired point               |Float                     |
+--------------+---------------------------------------+--------------------------+
|output        |Geographic Coordinates                 |Group                     |
+--------------+---------------------------------------+--------------------------+
|output.idx    |Output Point Longitude                 |Float                     |
+--------------+---------------------------------------+--------------------------+
|output.idy    |Output Point Latitude                  |Float                     |
+--------------+---------------------------------------+--------------------------+
|output.town   |Main town near the coordinates computed|String                    |
+--------------+---------------------------------------+--------------------------+
|output.country|Country of the image                   |String                    |
+--------------+---------------------------------------+--------------------------+
|inxml         |Load otb application from xml file     |XML input parameters file |
+--------------+---------------------------------------+--------------------------+
|outxml        |Save otb application to xml file       |XML output parameters file|
+--------------+---------------------------------------+--------------------------+

**Sensor image**: Input sensor image.

- **X value of desired point**: X coordinate of the point to transform.
- **Y value of desired point**: Y coordinate of the point to transform.

**[Point Coordinates]**

- **X value of desired point**: X coordinate of the point to transform.
- **Y value of desired point**: Y coordinate of the point to transform.

**[Geographic Coordinates]**

- **Output Point Longitude**: Output point longitude coordinate.
- **Output Point Latitude**: Output point latitude coordinate.
- **Main town near the coordinates computed**: Nearest main town of the computed geographic point.
- **Country of the image**: Country of the input image.

**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_ConvertSensorToGeoPoint -in QB_TOULOUSE_MUL_Extract_500_500.tif -input.idx 200 -input.idy 200

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 ConvertSensorToGeoPoint application 
	ConvertSensorToGeoPoint = otbApplication.Registry.CreateApplication("ConvertSensorToGeoPoint")

	# The following lines set all the application parameters:
	ConvertSensorToGeoPoint.SetParameterString("in", "QB_TOULOUSE_MUL_Extract_500_500.tif")

	ConvertSensorToGeoPoint.SetParameterFloat("input.idx", 200)

	ConvertSensorToGeoPoint.SetParameterFloat("input.idy", 200)

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

Limitations
~~~~~~~~~~~

None

Authors
~~~~~~~

This application has been written by OTB-Team.

See Also
~~~~~~~~

These additional resources can be useful for further information: 
  | ConvertCartoToGeoPoint application, otbObtainUTMZoneFromGeoPoint