Apply Coregistration (Image Analyst)—ArcGIS Pro

Summary

Resamples the secondary single look complex (SLC) data to the reference SLC grid using a digital elevation model (DEM) and orbit state vector metadata.

For Terrain Observation by Progressive Scan (TOPS) mode radar data, the tool also deramps and demodulates the secondary SLC before resampling. Once resampling is performed, the secondary radar data is reramped and remodulated.

Usage

For Sentinel-1 SLC data, use this tool after the Apply Orbit Correction tool.
To optimize coregistration results, use the highest resolution DEM available for the area of interest.
Use the Compute Coherence tool to measure the success of the coregistration.

Parameters

Label	Explanation	Data Type
Input Reference Radar Data	The input reference radar data.	Raster Dataset; Raster Layer
Input Secondary Radar Data	The input secondary radar data.	Raster Dataset; Raster Layer
Output Secondary Radar Data	The output secondary radar data coregistered to the reference radar data.	Raster Dataset
DEM Raster	The DEM raster that will be used to estimate the local illuminated area.	Mosaic Layer; Raster Layer
Apply geoid correction (Optional)	Specifies whether the vertical reference system of the input DEM will be transformed to ellipsoidal height. Most elevation datasets are referenced to sea level orthometric height, so a correction is required in these cases to convert to ellipsoidal height. Checked—A geoid correction will be made to convert orthometric height to ellipsoidal height (based on EGM96 geoid). This is the default. Unchecked—No geoid correction will be made. Use this option only if the DEM is provided in ellipsoidal height.	Boolean
Polarization Bands (Optional)	The polarization bands that will be corrected. The first band is selected by default.	String

ApplyCoregistration(in_reference_radar_data, in_secondary_radar_data, out_secondary_radar_data, in_dem_raster, {geoid}, {polarization_bands})

Name	Explanation	Data Type
in_reference_radar_data	The input reference radar data.	Raster Dataset; Raster Layer
in_secondary_radar_data	The input secondary radar data.	Raster Dataset; Raster Layer
out_secondary_radar_data	The output secondary radar data coregistered to the reference radar data.	Raster Dataset
in_dem_raster	The DEM raster that will be used to estimate the local illuminated area.	Mosaic Layer; Raster Layer
geoid (Optional)	Specifies whether the vertical reference system of the input DEM will be transformed to ellipsoidal height. Most elevation datasets are referenced to sea level orthometric height, so a correction is required in these cases to convert to ellipsoidal height. GEOID—A geoid correction will be made to convert orthometric height to ellipsoidal height (based on EGM96 geoid). This is the default. NONE—No geoid correction will be made. Use this option only if the DEM is provided in ellipsoidal height.	Boolean
polarization_bands [polarization_bands,...] (Optional)	The polarization bands that will be corrected. The first band is selected by default.	String

Code sample

ApplyCoregistration example 1 (Python window)

This example coregisters the secondary radar dataset to the reference radar grid.

import arcpy
arcpy.env.workspace = r"C:\Data\SAR"


outRadar = arcpy.ia.ApplyCoregistration("Reference_SAR.crf", 
    "SecondarySAR.crf", "dem.tif", "GEOID", "VV") 
outRadar.save("Secondary_SAR_Coreg.crf")

ApplyCoregistration example 2 (stand-alone script)

This example coregisters the secondary radar dataset to the reference radar grid.

# Import system modules and check out ArcGIS Image Analyst extension license
import arcpy
arcpy.CheckOutExtension("ImageAnalyst")
from arcpy.ia import *

# Set local variables
in_reference_radar_data=r"C:\SAR\Reference_SAR.crf"
in_secondary_radar_data=r"C:\SAR\Secondary_SAR.crf"
in_dem_raster=r"C:\DEM\dem.tif"
geoid="GEOID"
polarization_bands ="VV"

# Execute 
outRadar = arcpy.ia.ApplyCoregistration(in_reference_radar_data, 
    in_secondary_radar_data, in_dem_raster, geoid, polarization_bands) 
outRadar.save(r"C:\SAR\Secondary_SAR_Coreg.crf")

Environments

Cell Alignment, Compression, Current Workspace, NoData, Pyramid, Raster Statistics, Resampling Method, Scratch Workspace, Snap Raster, Tile Size

Licensing information

Basic: Requires Image Analyst
Standard: Requires Image Analyst
Advanced: Requires Image Analyst