Back to Top

Generate Radiometric Terrain Corrected Data (Image Analyst)

In this topic

  1. Summary
  2. Usage
  3. Parameters
  4. Environments
  5. Licensing information

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

DialogPython

LabelExplanationData Type
Input Radar Data

The input radar data.

The input data must be Level 1 radar data.

Raster Dataset; Raster Layer
Output Radar Data

The RTC 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.

Select all polarization bands if the output will be with the SAR Analysis tools.

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
Username
(Optional)

The Copernicus Data Space Ecosystem login credential username.

This parameter is only valid when the input data has Sentinel restituted or Sentinel precise orbit types.

String
Password
(Optional)

The Copernicus Data Space Ecosystem login credential password.

This parameter is only valid when the input data has Sentinel restituted or Sentinel precise orbit types.

String Hidden
Cloud Storage Connection
(Optional)

The Copernicus Data Space Ecosystem cloud storage connection file.

File

Derived Output

LabelExplanationData Type
Updated Folder

The output folder where the radar products are saved.

Workspace

GenerateRadiometricTerrainCorrectedData(in_radar_data, out_radar_data, in_dem_raster, {geoid}, {polarization_bands}, {output_units}, {processing_level}, {out_folder}, {username}, {password}, {cloud_storage_connection})
NameExplanationData Type
in_radar_data

The input radar data.

The input data must be Level 1 radar data.

Raster Dataset; Raster Layer
out_radar_data

The RTC 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.

Select all polarization bands if the output will be with the SAR Analysis tools.

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
username
(Optional)

The Copernicus Data Space Ecosystem login credential username.

This parameter is only valid when the input data has Sentinel restituted or Sentinel precise orbit types.

String
password
(Optional)

The Copernicus Data Space Ecosystem login credential password.

This parameter is only valid when the input data has Sentinel restituted or Sentinel precise orbit types.

String Hidden
cloud_storage_connection
(Optional)

The Copernicus Data Space Ecosystem cloud storage connection file.

File

Derived Output

NameExplanationData 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

Related topics

  • An overview of the Synthetic Aperture Radar toolset
  • Capella GEC workflow
  • Capella GEO workflow
  • Capella Sensor Independent Complex Data workflow
  • ICEYE GRD workflow
  • ICEYE Sensor Independent Complex Data workflow
  • RADARSAT Constellation Mission Ground Range Detected workflow
  • RADARSAT Constellation Mission SLC workflow
  • RADARSAT-2 ground range workflow
  • RADARSAT-2 SLC workflow
  • Sentinel-1 GRD workflow
  • Sentinel-1 SLC workflow

Feedback on this topic?

In this topic
  1. Summary
  2. Usage
  3. Parameters
  4. Environments
  5. Licensing information