| Environments | PYTHON :: EASI :: MODELER |
| Quick links | Description :: Parameters :: Parameter descriptions :: Details :: Examples :: Algorithm :: References :: Related |
| Back to top |
| Back to top |
psrecons(fili, filo)
| Name | Type | Caption | Length | Value range |
|---|---|---|---|---|
| FILI * | str | Input compact polarimetric SAR image | 1 - | |
| FILO * | str | Output pseudo fully polarimetric covariance matrix | 1 - |
| Back to top |
FILI
The name of the input file containing the CP data. The file must contain either two channels of complex-valued scattering data (matrix type = S2c) or three channels of single-look or multilook covariance data (matrix type = C2r1c). Each image layer must have an identical transmit polarization that is neither linearly horizontal nor linearly vertical.
The input data can be a synthesized PIX (.pix) file created from an FP data set using predefined CP configurations in PSCOMPACT or ones you define by using PSS2C. You can also import configurations from a CP data set by using SARINGEST or by specifying the key-file name of any GDB-supported CP data set in its distribution format.
For more information on ingesting SAR data with SARINGEST and GDB-supported file formats, follow the links at the end of this topic.
FILO
The name of the output file that will contain the pseudo FP covariance matrix. The file must not already exist and must have the same dimensions as the input CP image. The output is structured as a symmetrized covariance file containing three real-valued channels and three complex-valued channels (matrix type = c3r3c).
and channel 6 = C23 =
= 0| Back to top |
and C23 =
=
based on the estimated coherence of C13 =
The output is written as a symmetrized covariance matrix (C3r3c).
| Channel 1 | = | C11 | = |
|
= |
|
(Real) |
| Channel 2 | = | 2* C22 | = |
|
= |
|
(Real) |
| Channel 3 | = | C33 | = |
|
= |
|
(Real) |
| Channel 4 | = |
C12
|
= |
|
= | 0 | (Complex) |
| Channel 5 | = | C13 | = |
|
= |
|
(Complex) |
| Channel 6 | = |
C23
|
= |
|
= | 0 | (Complex) |
The output is compatible with any module for which you can use FP data as input.
The input file must be a data set that is already imported in PCIDSK format by SARINGEST. It can also be the key-file name of any GDB-supported POLSAR data set in its distribution format. For more information, and a complete list of supported polarimetric SAR sensors and data products, follow the link to SARINGEST at the end of this topic.
| Back to top |
Create a simulated multilook CP data set in CTLR mode (RH, RV) by using PSCOMPACT. Reconstruct a pseudo FP covariance matrix from the simulated CP data, and then generate the Freeman-Durden decomposition by using PSFREDUR. Generate the Freeman-Durden decomposition using the FP data, and then compare the results.
from pci.psboxcar import psboxcar
from pci.pscompact import pscompact
from pci.psrecons import psrecons
from pci.psfredur import psfredur
fili = "RS2_SLC_FQ09subset.pix" #FP data
filo = "RSAT2_FQ_Boxcar7.pix" #7x7 multilooked FQ
flsz=[7,7]
psboxcar(fili, filo, flsz)
fili = "RSAT2_FQ_Boxcar7.pix"
filo = "RSAT2_CP_Boxcar7_RH_RV.pix" # multilook simulated CTLR CP mode
comptyp = "CTLR"
pscompact(fili, filo, comptyp)
fili = "RSAT2_CP_Boxcar7_RH_RV.pix"
filo = "RSAT2_CP_Boxcar7_reconsCov.pix" # Reconstructed pseudo covariance matrix
psrecons(fili, filo)
fili = "RSAT2_CP_Boxcar7_reconsCov.pix"
filo = "RSAT2_CP_Boxcar7_reconsCov_FreemanDurden.pix" # Freeman-Durden decomposition applied on the pseudo covariance matrix
psfredur(fili, filo)
fili = "RSAT2_FQ_Boxcar7.pix" # multilook FP data
filo = "RSAT2_FQ_Boxcar7_FreemanDurden.pix " # Freeman-Durden decomposition applied on the covariance matrix.
psfredur(fili, filo)
Create pseudo FP covariance matrix by using multilooked RISAT CP data as input. Create a Cloude-Pottier decomposition from the reconstructed covariance matrix by using PSEABA.
from pci.psboxcar import psboxcar
from pci.psrecons import psrecons
from pci.pseaba import pseaba
fili = "RISAT_RH_RV.pix" #single-look CP data
filo = "RISAT_Boxcar7.pix" # multilook CP data
FLSZ = 7,7
psboxcar(fili, filo, flsz)
fili = "RISAT_Boxcar7.pix"
filo = "RISAT_Boxcar7_ReconsCov.pix" # Reconstructed pseudo covariance matrix
psrecons(fili, filo)
fili = "RISAT_Boxcar7_ReconsCov.pix"
filo = "RISAT_Boxcar7_ReconsCov_PSEABA.pix" # Cloude-Pottier decomposition
geteigen = 0
pseaba(fili, filo, geteigen)
| Back to top |
If required, the CP data is converted to covariance (C2r1c). Each element of the compact covariance matrix (J) represents the intensity from the interaction between the transmit-polarization vector (T), target-scattering vector (S) and receive-polarization vector (R). Because CP data has a common transmit (by definition) and two independent receives, each CP covariance element is given by Jxy =(T'SRx)(T'SRy)*, where T' is the transpose of the transmit polarization vector, Rx and Ry are the receive polarization vectors and * is the complex conjugate.
After some manipulation, it is possible to rewrite Jxy = ((T*⊗Rx)⊗(Ry⊗T))'vec (S*' ⊗S) = Axy vec (S*' ⊗S), where ⊗ is the Kronecker product. If you let J be the 4 x 1 matrix of Jxy values, and A be the 4 x 5 matrix of Axy values, and U the 5 x 1 relevant elements of vec (S*' ⊗S), you get J=AU.
The solution to the pseudo covariance elements is found by rearranging the matrices to isolate C22 and estimate its value based on the previously iterated values of C11, C33 and C13. The iteration process continues until C22 converges. The technique for standard CP configurations (that is, CTLR, DCP and pi/4) is described in the cited References.
This module is not limited to the standard CP configurations.
| Back to top |
Nord, M. E., Ainsworth, T. L., Lee, J.-S., and Stacy, N. J. S., "Comparison of compact polarimetric synthetic aperture radar modes", IEEE Trans. Geosci. Remote Sens., vol. 47, no. 1, pp. 174–188, January 2009.
Souissi, B., Ouarzeddine, M., Belhadj-Aissa, A., "Investigation of the capability of the Compact Polarimetry mode to Reconstruct Full Polarimetry mode using RADARSAT-2 data", Advanced Electromagnetics, vol. 1., no. 1, May 2012.
Sabry, R., Vachon, P., "A Unified Framework for General Compact and Quad Polarimetric SAR Data and Imagery Analysis", IEEE Transactions on Geoscience and Remote Sensing, volume: 52, issue: 1, 2014.
© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.