Convert SAR Units (Image Analyst)

Available with Image Analyst license.

Summary

Converts the scaling of the input synthetic aperture radar (SAR) data between amplitude and power and between linear and decibels (dB).

Usage

• This tool simplifies SAR product interpretation and improves image display by reducing the range of amplitude or intensity values through the conversion to a dB value.

• You can also convert data from amplitude to power and vice versa.

Parameters

Dialog

Label	Explanation	Data Type
Input Radar Data	The input radar data.	Raster Dataset; Raster Layer
Output Radar Data	The converted radar dataset.	Raster Dataset
Conversion Type (Optional)	Specifies the type of backscatter conversion that will be applied. Linear to dB—The unitless value will be converted to decibels (dB) values. This is the default. dB to linear—The dB values will be converted to unitless values. Amplitude to power—The amplitude values will be converted to power values by squaring the amplitude. Power to amplitude—The power values will converted to amplitude values by applying the square root to the power.	String

Python

ConvertSARUnits(in_radar_data, out_radar_data, {conversion_type})

Name	Explanation	Data Type
in_radar_data	The input radar data.	Raster Dataset; Raster Layer
out_radar_data	The converted radar dataset.	Raster Dataset
conversion_type (Optional)	Specifies the type of backscatter conversion that will be applied. LINEAR_TO_DB—The unitless value will be converted to decibels (dB) values. This is the default. DB_TO_LINEAR—The dB values will be converted to unitless values. AMPLITUDE_TO_POWER—The amplitude values will be converted to power values by squaring the amplitude. POWER_TO_AMPLITUDE—The power values will converted to amplitude values by applying the square root to the power.	String

Code sample

ConvertSARUnits example 1 (Python window)

This example converts unitless values to decibels.

import arcpy
arcpy.env.workspace = "D:\Data\SAR\S1\20181014"
outRadar = arcpy.ia.ConvertSARUnits(
     "IW_manifest_TNR_CalB0_Dspk_RTFG0_GTC.crf", "LINEAR_TO_DB")
outRadar.save("IW_manifest_TNR_CalB0_Dspk_RTFG0_GTC_dB.crf")

ConvertSARUnits example 2 (stand-alone script)

This example converts unitless values to decibels.

# 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 = "D:\Data\SAR\S1\20181014\IW_manifest_TNR_CalB0_Dspk_RTFG0_GTC.crf"
out_radar ="D:\Data\SAR\S1\20181014\IW_manifest_TNR_CalB0_Dspk_RTFG0_GTC_dB.crf"
conversion_type = ""LINEAR_TO_DB"

# Execute 
outRadar = arcpy.ia.ConvertSARUnits(in_radar, conversion_type)
outRadar.save(out_radar)

Environments

Cell Alignment, Cell Size, Compression, Current Workspace, Extent, Geographic Transformations, NoData, 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