uvisbox.Modules.UncertaintyLobes.uncertainty_lobes_stats
========================================================

.. py:module:: uvisbox.Modules.UncertaintyLobes.uncertainty_lobes_stats

.. autoapi-nested-parse::

   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
---------------

.. py:function:: uncertainty_lobes_summary_statistics(ensemble_vectors, percentile1=90, percentile2=50, workers=None)

   Compute vector depth statistics for uncertainty lobes.

   :param ensemble_vectors: Shape (n, m, 2) - Cartesian ensemble vectors at n positions with m members
   :type ensemble_vectors: numpy.ndarray
   :param percentile1: First percentile for depth filtering (outer lobe). Higher values include more vectors.
                       Default: 90
   :type percentile1: float (0-100)
   :param percentile2: Second percentile for depth filtering (inner lobe). If None, only one lobe is drawn.
                       Default: 50
   :type percentile2: float or None (0-100)
   :param workers: Number of parallel workers for computation. Default is None (sequential).
                   For ensemble size >= 30, parallelization can provide speedup.
   :type workers: int, optional

   :returns: **stats** -- Contains polar ensemble vectors, depths, median vectors, inner and outer
             lobe angles and radii, and median angles and magnitudes.
   :rtype: dict