Applications/app_SARDEMProjection.md

+# SARDEMProjection
+
+Projects a DEM into SAR geometry.
+
+## Description
+
+This application puts a DEM file into SAR geometry and estimates two additional coordinates.
+In all for each point of the DEM input four components are calculated : C (colunm into SAR image), L (line into SAR image), Z and Y.
+
+## Parameters
+
+**Input DEM** `-indem image` *Mandatory* <br />
+DEM to perform projection on.
+
+**Input SAR image** `-insar image` *Mandatory* <br />
+SAR Image to extract SAR geometry.
+
+**Input file to get precise metadata** `-infilemetadata filename [dtype]` <br />
+Input file to get precise metadata.
+
+**Set H components into projection** `-withh bool` *Default value: false* <br />
+If true, then H components into projection.
+
+**Set XYZ Cartesian components into projection** `-withxyz bool` *Default value: false* <br />
+If true, then XYZ Cartesian components into projection.
+
+**Set SatPos components into projection** `-withsatpos bool` *Default value: false* <br />
+If true, then SatPos components into projection.
+
+**No Data values for the DEM** `-nodata int` *Default value: -32768* <br />
+No Data values for the DEM.
+
+**Output Vector Image** `-out image [dtype]` *Mandatory* <br />
+Output Vector Image (C,L,Z,Y).
+
+**gain value (output of this application)** `-gain float` *Default value: 0* <br />
+Gain value.
+
+**direction in range into DEM geometry to across SAR geometry from Near range to Far range (output of this applicxation)** `-directiontoscandemc int` *Default value: 1* <br />
+Range direction for DEM scan.
+
+**direction in range into DEM geometry to across SAR geometry from Near range to Far range (output of this application)** `-directiontoscandeml int` *Default value: 1* <br />
+Azimut direction for DEM scan.
+
+**Available RAM (MB)** `-ram int` *Default value: 256* <br />
+Available memory for processing (in MB).
+
+## Examples
+
+From the command-line:
+
+```
+otbcli_SARDEMProjection -indem S21E055.hgt -insar s1a-s4-slc-vv-20160818t014650-20160818t014715-012648-013db1-002_SLC.tiff -out S21E55_proj.tif
+```
+
+From Python:
+
+```
+import otbApplication
+
+app = otbApplication.Registry.CreateApplication("SARDEMProjection")
+
+app.SetParameterString("indem", "S21E055.hgt")
+app.SetParameterString("insar", "s1a-s4-slc-vv-20160818t014650-20160818t014715-012648-013db1-002_SLC.tiff")
+app.SetParameterString("out", "S21E55_proj.tif")
+
+app.ExecuteAndWriteOutput()
+```
+
+## Limitations
+
+Only Sentinel 1 products are supported for now.