Applications/app_SARCoRegistration.md

+# SARCoRegistration
+
+CoRegistration between two SAR images.
+
+## Description
+
+This application does the coregistration between two SAR images thanks to a deformation grid.
+
+## Parameters
+
+**Input deformation grid** `-ingrid image` *Mandatory* <br />
+Input deformation grid.
+
+**Input SAR Slave image** `-insarslave image` *Mandatory* <br />
+Input SAR Slave image.
+
+**Input SAR Master image (for metadata only)** `-insarmaster image` *Mandatory* <br />
+Input SAR Master image (for metadata only).
+
+**Grid Step for range dimension into SLC geometry** `-gridsteprange int` *Default value: 150* <br />
+Grid Step for range dimension into  SLC geometry.
+
+**Grid Step for azimut dimension into SLC geometry** `-gridstepazimut int` *Default value: 150* <br />
+Grid Step for azimut dimension into  SLC geometry.
+
+**Doppler 0 in azimut for SAR Slave Image** `-doppler0 float` *Default value: 0* <br />
+Doppler 0 in azimut for SAR Slave Image.
+
+**Size Tiles for output cut** `-sizetiles int` *Default value: 50* <br />
+Size Tiles for output cut.
+
+**Margin for window extractions into Slave Image** `-margin int` *Default value: 7* <br />
+Margin for window extractions into Slave Image.
+
+**Number of Ramps for filtering inside coregistration** `-nbramps int` *Default value: 257* <br />
+Number of Ramps for filtering inside coregistration.
+
+**Coregistrated slave image into master geometry** `-out image [dtype]` *Mandatory* <br />
+Output Image : Coregistrated slave image into master geometry.
+
+**Set Output conversion with cInt16 to false** `-cint16 bool` *Default value: false* <br />
+If true, then output conversion to cInt16.
+
+**Available RAM (MB)** `-ram int` *Default value: 256* <br />
+Available memory for processing (in MB).
+
+## Examples
+
+From the command-line:
+
+```
+otbcli_SARCoRegistration -insarslave s1b-s4-slc-vv-20160929t014610-20160929t014634-002277-003d71-002.tiff -insarmaster s1a-s4-slc-vv-20160818t014650-20160818t014715-012648-013db1-002_SLC.tiff -ingrid ./FineDeformation.tiff -doppler0 0.011851326955 -out s1b-s4-coregistrated.tiff
+```
+
+From Python:
+
+```
+import otbApplication
+
+app = otbApplication.Registry.CreateApplication("SARCoRegistration")
+
+app.SetParameterString("insarslave", "s1b-s4-slc-vv-20160929t014610-20160929t014634-002277-003d71-002.tiff")
+app.SetParameterString("insarmaster", "s1a-s4-slc-vv-20160818t014650-20160818t014715-012648-013db1-002_SLC.tiff")
+app.SetParameterString("ingrid", "./FineDeformation.tiff")
+app.SetParameterFloat("doppler0", 0.011851326955)
+app.SetParameterString("out", "s1b-s4-coregistrated.tiff")
+
+app.ExecuteAndWriteOutput()
+```
+
+## Limitations
+
+Only Sentinel 1 (IW and StripMap mode) and Cosmo products are supported for now.