ComputeModulusAndPhase - Compute Modulus And Phase
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

This application computes the modulus and the phase of a complex SAR image.

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

This application computes the modulus and the phase of a complex SAR image. The input should be a single band image with complex pixels.

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

.. [#] Table: Parameters table for Compute Modulus And Phase.

+-------------+----------------------------------+--------------------------+
|Parameter Key|Parameter Name                    |Parameter Type            |
+=============+==================================+==========================+
|in           |Input Image                       |Input image               |
+-------------+----------------------------------+--------------------------+
|modulus      |Modulus                           |Output image              |
+-------------+----------------------------------+--------------------------+
|phase        |Phase                             |Output image              |
+-------------+----------------------------------+--------------------------+
|ram          |Available RAM (Mb)                |Int                       |
+-------------+----------------------------------+--------------------------+
|inxml        |Load otb application from xml file|XML input parameters file |
+-------------+----------------------------------+--------------------------+
|outxml       |Save otb application to xml file  |XML output parameters file|
+-------------+----------------------------------+--------------------------+

- **Input Image**: Input image (complex single band).
- **Modulus**: Modulus of the input image computes with the following formula: :math:`\sqrt{real\*real + imag\*imag}` where real and imag  are respectively the real and the imaginary part of the input complex image. .
- **Phase**: Phase of the input image computes with the following formula:  :math:`\tan^{-1}(\frac{imag}{real})` where real and imag are respectively the real and the imaginary part of the input complex image.
- **Available RAM (Mb)**: Available memory for processing (in MB).
- **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_ComputeModulusAndPhase -in monobandComplexFloat.tif -modulus modulus.tif -phase phase.tif

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

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

	ComputeModulusAndPhase.SetParameterString("modulus", "modulus.tif")

	ComputeModulusAndPhase.SetParameterString("phase", "phase.tif")

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

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

The application takes as input single band image with complex pixels.

Authors
~~~~~~~

This application has been written by Alexia Mondot (alexia.mondot@c-s.fr) and Mickael Savinaud (mickael.savinaud@c-s.fr).

See Also
~~~~~~~~

These additional resources can be useful for further information: 
  | Despeckle, SARPolarMatrixConvert, SARPolarSynth