Polarimetric Radar Vegetation Index (prvi_fp )#

polsartools.prvi_fp(in_dir, win=1, fmt='tif', cog=False, ovr=[2, 4, 8, 16], comp=False, max_workers=None, block_size=(512, 512), progress_callback=None)[source]

Calculate Polarimetric Radar Vegetation Index (PRVI) from full-pol SAR data.

This function computes the Polarimetric Radar Vegetation Index (PRVI) using full-polarimetric SAR data. PRVI is specifically designed to assess vegetation density and biomass by utilizing the complete polarimetric information available in the coherency (T3) or covariance (C3) matrix.

Examples

>>> # Basic usage with default parameters
>>> prvi_fp("/path/to/fullpol_data")

>>> # Advanced usage with custom parameters
>>> prvi_fp(
...     in_dir="/path/to/fullpol_data",
...     win=5,
...     fmt="tif",
...     cog=True,
...     block_size=(1024, 1024)
... )
Parameters:

  • in_dir (str) – Path to the input folder containing full-pol T3 or C3 matrix files.

  • win (int, default=1) – Size of the spatial averaging window. Larger windows reduce speckle noise but decrease spatial resolution.

  • fmt ({'tif', 'bin'}, default='tif') – Output file format: - ‘tif’: GeoTIFF format with georeferencing information - ‘bin’: Raw binary format

  • cog (bool, default=False) – If True, creates a Cloud Optimized GeoTIFF (COG) with internal tiling and overviews for efficient web access.

  • ovr (list[int], default=[2, 4, 8, 16]) – Overview levels for COG creation. Each number represents the decimation factor for that overview level.

  • comp (bool, default=False) – If True, uses LZW compression for GeoTIFF outputs.

  • max_workers (int | None, default=None) – Maximum number of parallel processing workers. If None, uses CPU count - 1 workers.

  • block_size (tuple[int, int], default=(512, 512)) – Size of processing blocks (rows, cols) for parallel computation. Larger blocks use more memory but may be more efficient.

Returns:

Writes one output file to disk: - ‘prvi_fp.tif’ or ‘prvi_fp.bin’

Return type:

None

The formlation of PRVI interms of degree of polarization and cross-pol backscatter intensity can be expressed as follows:

\[\text{PRVI}_{fp}=(1-\text{DOP}_{fp})\sigma^\circ_{\text{XY}}\]

where, \(\text{DOP}_{fp}\) 3D Barakt degree of polarization and can be expressed as shown below. Further details on the PRVI can be found in [[1]](#1)

\[\text{DOP}_{fp}=\sqrt{1-\frac{27\times\text{det([T3])}}{\text{(Trace[T3])}^3}}\]

This Page