Model Free 3-Component decomposition for dual-co-pol (mf3cd)#

polsartools.mf3cd(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]

Computes decomposed powers, and a scattering type parameter from the input dual-co-polarization T2 matrix data, and writes the output in various formats (GeoTIFF or binary). The computation is performed in parallel for efficiency.

Example:#

>>> mf3cd("path_to_T2_folder", win=5, fmt="tif", cog=True)
This will compute decomposed powers from the dual-co-pol T2 matrix in the specified folder,
generating output in Geotiff format with Cloud Optimized GeoTIFF settings enabled.

Parameters:#

in_dirstr

Path to the input folder containing T2 matrix data.

winint, optional

Size of the processing window (default is 1).

fmtstr, optional

Output format of the files; can be “tif” (GeoTIFF) or “bin” (binary) (default is “tif”).

cogbool, optional

If True, outputs Cloud Optimized GeoTIFF (COG) (default is False).

ovrlist of int, optional

List of overview levels to be used for COGs (default is [2, 4, 8, 16]).

compbool, optional

If True, applies LZW compression to GeoTIFF outputs (default is False).

max_workersint, optional

Number of parallel workers for processing (default is None, which uses one less than the number of available CPU cores).

block_sizetuple of int, optional

Size of each processing block (default is (512, 512)), defining the spatial chunk dimensions used in parallel computation.

Returns:#

None

The function writes the computed decomposed powers to the specified output format.

Output Files:#

  • “Ps_mf3cd.tif” or “Ps_mf3cd.bin”

  • “Pd_mf3cd.tif” or “Pd_mf3cd.bin”

  • “Pv_mf3cd.tif” or “Pv_mf3cd.bin”

  • “Theta_DP_mf3cd.tif” or “Theta_DP_mf3cd.bin”

This Page