Generate Radiometric Terrain Corrected Data (Image Analyst)

Available with Image Analyst license.

Summary

Transforms Level 1 synthetic aperture radar (SAR) data to a radiometric terrain-corrected (RTC) dataset. Use the RTC data for analysis and visualization.

This tool creates a SAR output that removes unwanted noise and distortions by applying the appropriate RTC workflow according to the input SAR sensor, mode, and product type.

Usage

• This tool replaces the need to run each SAR correction tool individually, such as Download Orbit File, Apply Orbit Correction, Remove Thermal Noise, Apply Radiometric Calibration, Deburst, Multilook, Apply Radiometric Terrain Flattening, Despeckle, and Apply Geometric Terrain Correction. The tool detects the input sensor and mode to perform the appropriate RTC workflow in a single script to make the RTC process efficient.

• Use the Processing Level parameter to optionally save the output radar products during the RTC workflow. Only create the output products that are needed, as they may use a lot of disk space.

Parameters

Dialog

Label	Explanation	Data Type
Input Radar Data	The input radar data. This data needs to be Level 1 radar data.	Raster Dataset; Raster Layer
Output Radar Data	The radiometric terrain-corrected radar dataset.	Raster Dataset
DEM Raster	The input DEM. The DEM that will be used to estimate the local illuminated area and the local incidence angle.	Raster Dataset; 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 filtered. The first band is selected by default.	String
Output Units (Optional)	Specifies the units that will be used for the RTC outputs. Linear—The units of the output will be in linear backscatter. This is the default. Decibel (dB)—The units of the output will be in decibels.	String
Processing Level (Optional)	Specifies the radar products that will be retained. The available processing levels depend on the input radar data and its corresponding processing workflow. By default, no option will be used, and no radar products will be retained. Remove Thermal Noise— The output from the Remove Thermal Noise tool will be retained. Apply Radiometric Calibration—The output from the Apply Radiometric Calibration tool will be retained and calibrated to Beta nought. Deburst—The output from the Deburst tool will be retained. Multilook—The output from the Multilook tool will be retained. Apply Radiometric Terrain Flattening—The output from the Apply Radiometric Terrain Flattening tool will be retained and calibrated to Gamma nought Despeckle—The output from the Despeckle tool will be retained. Apply Geometric Terrain Correction—The output from the Apply Geometric Terrain Correction tool will be retained.	String
Output Folder (Optional)	The output folder where the output radar products will be retained.	Workspace

Derived Output

Label	Explanation	Data Type
Updated Folder	The output folder where the radar products are saved.	Workspace

Python

GenerateRadiometricTerrainCorrectedData(in_radar_data, out_radar_data, in_dem_raster, {geoid}, {polarization_bands}, {output_units}, {processing_level}, {out_folder})

Name	Explanation	Data Type
in_radar_data	The input radar data. This data needs to be Level 1 radar data.	Raster Dataset; Raster Layer
out_radar_data	The radiometric terrain-corrected radar dataset.	Raster Dataset
in_dem_raster	The input DEM. The DEM that will be used to estimate the local illuminated area and the local incidence angle.	Raster Dataset; 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 filtered. The first band is selected by default.	String
output_units (Optional)	Specifies the units that will be used for the RTC outputs. LINEAR—The units of the output will be in linear backscatter. This is the default. DECIBEL—The units of the output will be in decibels.	String
processing_level [processing_level,...] (Optional)	Specifies the radar products that will be retained. The available processing levels depend on the input radar data and its corresponding processing workflow. By default, no option will be used, and no radar products will be retained. TNR— The output from the Remove Thermal Noise tool will be retained. CalB0—The output from the Apply Radiometric Calibration tool will be retained and calibrated to Beta nought. DBST—The output from the Deburst tool will be retained. ML—The output from the Multilook tool will be retained. RTFG0—The output from the Apply Radiometric Terrain Flattening tool will be retained and calibrated to Gamma nought DSPK—The output from the Despeckle tool will be retained. GTC—The output from the Apply Geometric Terrain Correction tool will be retained.	String
out_folder (Optional)	The output folder where the output radar products will be retained.	Workspace

Derived Output

Name	Explanation	Data Type
updated_folder	The output folder where the radar products are saved.	Workspace

Code sample

GenerateRadiometricTerrainCorrectedData example 1 (Python window)

This example creates radiometric terrain-corrected SAR data and the Remove Thermal Noise output product.

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

out_radar_data = arcpy.ia.GenerateRadiometricTerrainCorrectedData(
    "S1B_IW_GRDH_1SDV_20181014T014104_20181014T014129_013142_018486_D82E.SAFE\manifest.safe", 
    "dem.tif", "GEOID", "VV", "DECIBEL", "RTF", "IW_D82E_Intermediate") 

out_radar_data.save("IW_D82E_RTC.crf")

GenerateRadiometricTerrainCorrectedData example 2 (stand-alone script)

This example creates radiometric terrain-corrected SAR data and the Remove Thermal Noise output product.

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

# Set local variables
in_radar=r"C:\SAR\S1B_IW_GRDH_1SDV_20181014T014104_20181014T014129_013142_018486_D82E.SAFE\manifest.safe"
in_dem=r"C:\SAR\dem.tif"
geoid="GEOID"
polarization="VV"
out_units="DECIBEL"
proecssing_level="RTF"
out_folder=r"C:\SAR\"IW_D82E _Intermediate"

#Create output
outRadar = arcpy.ia.GenerateRadiometricTerrainCorrectedData(in_radar, 
    in_dem, geoid, polarization, out_units, proecssing_level, out_folder) 
outRadar.save(out_radar)

Environments

Compression, Current Workspace, Extent, Geographic Transformations, NoData, Output CONFIG Keyword, Output Coordinate System, Parallel Processing Factor, 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