Despeckle
^^^^^^^^^

Perform speckle noise reduction on SAR image.

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

This application reduce speckle noise. Four methods are available: Lee, Frost, GammaMAP and Kuan.

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

.. [#] Table: Parameters table for Despeckle.

+-----------------------+--------------------------+----------------------------------+
|Parameter Key          |Parameter Type            |Parameter Description             |
+=======================+==========================+==================================+
|in                     |Input image               |Input image                       |
+-----------------------+--------------------------+----------------------------------+
|out                    |Output image              |Output image                      |
+-----------------------+--------------------------+----------------------------------+
|ram                    |Int                       |Int                               |
+-----------------------+--------------------------+----------------------------------+
|filter                 |Choices                   |Choices                           |
+-----------------------+--------------------------+----------------------------------+
|filter lee             | *Choice*                 |Lee                               |
+-----------------------+--------------------------+----------------------------------+
|filter frost           | *Choice*                 |Frost                             |
+-----------------------+--------------------------+----------------------------------+
|filter gammamap        | *Choice*                 |GammaMap                          |
+-----------------------+--------------------------+----------------------------------+
|filter kuan            | *Choice*                 |Kuan                              |
+-----------------------+--------------------------+----------------------------------+
|filter.lee.rad         |Int                       |Int                               |
+-----------------------+--------------------------+----------------------------------+
|filter.lee.nblooks     |Float                     |Float                             |
+-----------------------+--------------------------+----------------------------------+
|filter.frost.rad       |Int                       |Int                               |
+-----------------------+--------------------------+----------------------------------+
|filter.frost.deramp    |Float                     |Float                             |
+-----------------------+--------------------------+----------------------------------+
|filter.gammamap.rad    |Int                       |Int                               |
+-----------------------+--------------------------+----------------------------------+
|filter.gammamap.nblooks|Float                     |Float                             |
+-----------------------+--------------------------+----------------------------------+
|filter.kuan.rad        |Int                       |Int                               |
+-----------------------+--------------------------+----------------------------------+
|filter.kuan.nblooks    |Float                     |Float                             |
+-----------------------+--------------------------+----------------------------------+
|inxml                  |XML input parameters file |XML input parameters file         |
+-----------------------+--------------------------+----------------------------------+
|outxml                 |XML output parameters file|XML output parameters file        |
+-----------------------+--------------------------+----------------------------------+

**Input Image**
Input image.

**Output Image**
Output image.

**Available RAM (Mb)**
Available memory for processing (in MB).

**speckle filtering method**
 Available choices are: 

- **Lee** : Lee filter


 - **Radius** : Radius for lee filter.

 - **nb looks** : Nb looks for lee filter.


 - **Frost** : Frost filter


  - **Radius** : Radius for frost filter.

  - **deramp** : Decrease factor declaration.


  - **GammaMap** : GammaMap filter


   - **Radius** : Radius for GammaMAP filter.

   - **nb looks** : Nb looks for GammaMAP filter.


   - **Kuan** : Kuan filter


    - **Radius** : Radius for Kuan filter.

    - **nb looks** : Nb looks for Kuan filter.



**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_Despeckle -in sar.tif -filter lee -filter.lee.rad 5 -out despeckle.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 Despeckle application 
	Despeckle = otbApplication.Registry.CreateApplication("Despeckle")

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

	Despeckle.SetParameterString("filter","lee")

	Despeckle.SetParameterInt("filter.lee.rad", 5)

	Despeckle.SetParameterString("out", "despeckle.tif")

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

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

None

Authors
~~~~~~~

This application has been written by OTB-Team.