uvisbox.Modules.UncertaintyLobes.uncertainty_lobes_stats

Statistics computation for uncertainty lobes.

This module computes vector depth statistics for uncertainty lobe visualization:

  • Convert Cartesian → Polar coordinates

  • Compute vector depths

  • Calculate spreads (min/max magnitude and angle)

Module Contents

uvisbox.Modules.UncertaintyLobes.uncertainty_lobes_stats.uncertainty_lobes_summary_statistics(ensemble_vectors, percentile1=90, percentile2=50, workers=None)[source]

Compute vector depth statistics for uncertainty lobes.

Parameters:

  • ensemble_vectors (numpy.ndarray) – Shape (n, m, 2) - Cartesian ensemble vectors at n positions with m members

  • percentile1 (float (0-100)) – First percentile for depth filtering (outer lobe). Higher values include more vectors. Default: 90

  • percentile2 (float or None (0-100)) – Second percentile for depth filtering (inner lobe). If None, only one lobe is drawn. Default: 50

  • workers (int, optional) – Number of parallel workers for computation. Default is None (sequential). For ensemble size >= 30, parallelization can provide speedup.

Returns:

stats – Contains polar ensemble vectors, depths, median vectors, inner and outer lobe angles and radii, and median angles and magnitudes.

Return type:

dict