PSTOTPOW

Description

PSTOTPOW creates a single-channel output file that contains the image of the sum of the power of a multichannel polarimetric SAR (POLSAR) image. The total power is defined as the sum of the intensities of all available polarizations. It is useful to characterize features in your image based on total received intensity, regardless of polarization.

Parameters

Name	Type	Caption	Length	Value range
FILI *	String	Input polarimetric SAR image	1 - 192
FILO *	String	Output total power image	1 - 192
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILI

The name of the input polarimetric SAR data set, which must be in one of the following matrix formats: detected, scattering, covariance, coherence, or Kennaugh.

The input data set must have already been imported into the PCIDSK (.pix) format with SARINGEST. Input can also be the key-file name of any GDB-supported POLSAR data set in its distribution format. For more information, including a complete list of supported SAR sensors and data products, follow the link to SARINGEST at the end of this topic.

FILO

The name of the output file that will hold the sum of the available intensities. The output file has the same dimensions as the input, and one floating-point channel.

The file name you specify must not already exist.

MONITOR

The program progress can be monitored by printing the percentage of processing completed. A system parameter, MONITOR, controls this activity.

Available options are:

• ON: Turns the monitor ON (default)
• OFF: Turns the monitor OFF (recommended if running in batch or background mode)

Details

PSTOTPOW generates the sum of available intensities for a SAR data set.

The input data set can contain detected or complex data from dual-po, compact-pol, or fully polarimetric (quad-polarization) data in one of the following matrix formats: scattering (s4c or S3c), covariance (c4r6c or C3r3c), coherency (t4r6c or T3r3c), or Kennaugh (k16r or K9r).

Example

Create a total power image for a RADARSAT-2 image that has already been imported into the PCIDSK (.pix) format by SARINGEST.

EASI>FILI="rsat2_slc.pix" 
EASI>FILO="rsat2_pow.pix"
EASI>run PSTOTPOW
    

Acknowledgements

PCI Geomatics gratefully acknowledges the financial support provided by the Canadian Space Agency through the Earth Observation Application Development Program (EOADP), contract number 9F028-034946.