4.10.9 SARDecompositions

From one-band complex images (each one related to an element of the Sinclair matrix), returns the selected decomposition.

Detailed description

From one-band complex images (HH, HV, VH, VV), returns the selected decomposition.

The H-alpha-A decomposition is currently the only one available; it is implemented for the monostatic case (transmitter and receiver are co-located).
User must provide three one-band complex images HH, HV or VH, and VV (monostatic case <=>HV = VH).
The H-alpha-A decomposition consists in averaging 3x3 complex coherency matrices (incoherent analysis); the user must provide the size of the averaging window, thanks to the parameter inco.kernelsize.
The applications returns a float vector image, made up of three channels : H (entropy), Alpha, A (Anisotropy).

Parameters

This section describes in details the parameters available for this application. Table 4.166, page 806 presents a summary of these parameters and the parameters keys to be used in command-line and programming languages. Application key is SARDecompositions.





Parameter key

Parameter type

Parameter description




inhh

Input image

Input Image

inhv

Input image

Input Image

invh

Input image

Input Image

invv

Input image

Input Image

out

Output image

Output Image

decomp

Choices

Decompositions

decomp haa

Choice

H-alpha-A decomposition

inco

Group

Incoherent decompositions

inco.kernelsize

Int

Kernel size for spatial incoherent averaging.

ram

Int

Available RAM (Mb)

inxml

XML input parameters file

Load otb application from xml file

outxml

XML output parameters file

Save otb application to xml file











Table 4.166: Parameters table for SARDecompositions.

Input Image Input image (HH)

Input Image Input image (HV)

Input Image Input image (VH)

Input Image Input image (VV)

Output Image Output image

Decompositions Available choices are:

Incoherent decompositions This group allows setting parameters related to the incoherent decompositions.

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_SARDecompositions -inhh HH.tif -invh VH.tif -invv VV.tif -decomp haa -out HaA.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 SARDecompositions application 
SARDecompositions = otbApplication.Registry.CreateApplication("SARDecompositions") 
 
# The following lines set all the application parameters: 
SARDecompositions.SetParameterString("inhh", "HH.tif") 
 
SARDecompositions.SetParameterString("invh", "VH.tif") 
 
SARDecompositions.SetParameterString("invv", "VV.tif") 
 
SARDecompositions.SetParameterString("decomp","haa") 
 
SARDecompositions.SetParameterString("out", "HaA.tif") 
 
# The following line execute the application 
SARDecompositions.ExecuteAndWriteOutput()

Limitations

None

Authors

This application has been written by OTB-Team.

See also

These additional ressources can be useful for further information: