PSUSWIS

Unsupervised Wishart classification


EnvironmentsPYTHON :: EASI :: MODELER
Quick linksDescription :: Parameters :: Parameter descriptions :: Details :: Example :: Algorithm :: Acknowledgements :: References :: Related

Back to top

Description


PSUSWIS performs an unsupervised Wishart classification of a polarimetric SAR (POLSAR) data set. The classification method is similar to the standard supervised maximum likelihood classification, except that the distance measured is customized for polarimetric data. The training classes are derived from an existing unsupervised classification result. The output image is a single-channel image with pixel values representing the class number, which can be between one and nine for a PSFREDUR and PSKROG input, between one and 12 for PSG4U2 and PSPHDW and between one and 16 for a PSCLOPOT input. The use of iteration refines the classification, but increases the processing time.
Back to top

Parameters


Name Type Caption Length Value range
FILI* String Input polarimetric SAR image 1 - 192  
FILE* String Input classified raster (Decomposition) 1 - 192  
ITERATIO Integer Number of iterations 0 - 1 0 - 11
Default: 5
FILO* String Output Wishart classified raster 1 - 192  
MONITOR String Monitor mode 0 - 3 ON, OFF
Default: ON

* Required parameter
Back to top

Parameter descriptions

FILI

The name of the input polarimetric SAR data set, which must be either non-symmetrized or symmetrized fully polarimetric (quad-polarization) complex data. The input data set must be in one of the following matrix formats: covariance, coherence, or Kennaugh. It is suggested that the input data set have an equivalent number of looks (ENL) of at least 25. If the data set is single-look complex, an ENL of 25 can be achieved by applying a polarimetric filter, such as boxcar, prior to classification.

The input file must be a data set that has already been imported into the PCIDSK (.pix) format by 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 POLSAR sensors and data products, follow the link to SARINGEST at the end of this topic.

FILE

The name of the initial classification source raster, which must contain either one classified byte channel or multiple floating-point channels, depending on the classification method used. If the classification source contains only one byte-layer channel, it is assumed to be a Cloude-Pottier or van Zyl classification. If the classification source contains multiple floating-point channels, the Freeman-Durden, Krogager, G4U2, or PHDW classification is assumed to be the source. The file must have the same dimensions as the input SAR image. The classification source represents training areas for the output classes in the Wishart classification.

ITERATIO

The number of iterations used to refine the classification. The default number of iterations is 5, and the maximum number is 11. Increasing the number of iterations improves the discrimination, but linearly increases the processing time.

This parameter is optional.

FILO

The name of the output file that will hold the classification results. The output file has the same number of dimensions as the input SAR image, and one channel. Its pixel values specify the class number assigned to each pixel. The output image is a single-channel image with pixel values representing the class number, which can be between one and nine for a PSFREDUR and PSKROG input, between one and 12 for PSG4U2 and PSPHDW and between one and 16 for a PSCLOPOT input. The use of iteration refines the classification, but increases the processing time. Pixels that cannot be classified are represented by the pixel value of 0, usually with a value of 0 in all channels of the input image.

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:

Back to top

Details

PSUSWIS performs an unsupervised Wishart classification of a polarimetric SAR data set. The classification algorithm is similar to the PSSWIS algorithm, except that the training classes are provided by the results of an earlier classification performed on the same data set.

The initial classification source can be obtained by running PSFREDUR, PSKROG, PSG4U2, or PSPHDW. Results classified previously from PSCLOPOT and PSVANZYL can be refined by increasing the number of iterations.

The input data set must contain fully polarimetric (quad-polarization) data in one of the following matrix formats: covariance (c4r6c or C3r3c), coherence (t4r6c or T3r3c), or Kennaugh (k16r or K9r), with a suggested number of looks (ENL) of at least 25.

The training classes in the initial classification source are used to form the average coherence matrix for every class. The class value 0 is assigned to pixels with invalid matrix representations (a 0 value or negative determinant) because the classification is not possible in this case.

When the algorithm is completed, each pixel in the output channel represents the closest class according to the defined minimum distance criteria. The pixels for which classification is not possible have a value of 0 (null class). The classes present in the output depend on the input data. The output raster has metadata summarizing the classes.

Output class descriptions when the input is from Freeman-Durden:

Output class descriptions when the input is from Krogager:

Output class descriptions when the input is from G4U2:

Output class descriptions when the input is from PHDW:

Output class descriptions when the input is Cloude-Pottier:

Output class descriptions when input is van Zyl:

Back to top

Example

Perform an unsupervised Wishart classification of a RADARSAT-2 data set. The input RADARSAT-2 SLC-Q data set has been ingested with SARINGEST and is first averaged with PSBOXCAR to increase its ENL to 25. PSCLOPOT is used with the default class boundaries to derive the starting classes. PSUSWIS is then used to refine the initial Cloude-Pottier classification. Because of the nature of the classification, the output has the same number of classes as the input Cloude-Pottier classification, but the output numbers do not match the Cloude-Pottier feature space.

EASI>FILI="rsat2_slc.pix" 
EASI>FILO="R2_enl25.pix"
EASI>FLSZ=5
EASI>run PSBOXCAR

EASI>FILI="R2_enl25.pix" 
EASI>CBDT=""
EASI>FILO="Clopot.pix"
EASI>run PSCLOPOT

EASI>FILI="R2_enl25.pix" 
EASI>FILE="Clopot.pix" 
EASI>ITERATIO=5
EASI>FILO="R2_Uswis.pix"
EASI>run PSUSWIS
      
Back to top

Algorithm

The unsupervised Wishart classification algorithm is defined in the article cited in the References section. The maximum likelihood classification of each pixel is provided by the class that minimizes the distance between the pixel and the class. The distance measure is optimized for polarimetric SAR data with the coherence (and covariance) matrices following the complex Wishart distribution.

The classification algorithm in PSUSWIS is similar to the supervised Wishart classification algorithm in PSSWIS, but differs in two important ways:

Depending on the input classification used for training data, the PSUSWIS algorithm follows two different processing flows. In the following description, the number of classes for the Cloude-Pottier classifier is 16. If the customized class boundaries are used, the actual number used in computation will be same as the number of classes in the input classified source raster. With the Freeman-Durden classification, pixels are allowed to change class only if the old and new classes both represent the same dominant scattering mechanism.

With both classification flows, the distance is similarly defined. Given a class, m, with a mean coherence matrix (T_hat)m, and a pixel (i,j) with the coherence matrix T(i,j), the distance, d, is defined as follows:

        d = ln|(T_hat)m| + Trace( ((T_hat)m)^-1 * (T(i,j) )
      

The vertical bars (||) represent the determinant of the matrix. Trace() represents the trace of the matrix, which is defined as the sum of its diagonal elements.

The processing in PSUSWIS with a Cloude-Pottier classification in FILE proceeds as follows.

The processing in PSUSWIS, with a Freeman-Durden classification as FILE, proceeds as follows.

Back to top

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.

Back to top

References

Lee, J. S., M. Grunes, E. Pottier, and L. Ferro-Famil. "Segmentation of Polarimetric Images that Preserves Scattering". Proceedings of the European Conference on Synthetic Aperture Radar (EUSAR), Cologne, June 4-6, 2002.

Lee, J. S., M. R. Grunes, T. L. Ainsworth, L.J. Du, D. L. Schuler, and S. R. Cloude. "Unsupervised classification using polarimetric decomposition and the complex Wishart classifier", IEEE Trans Geoscience and Remote Sensing, 37, no. 5, (1999): 2249-2258.

© PCI Geomatics Enterprises, Inc.®, 2024. All rights reserved.