uvisbox.Modules.UncertaintyLobes.uncertainty_lobes_vis
======================================================

.. py:module:: uvisbox.Modules.UncertaintyLobes.uncertainty_lobes_vis

.. autoapi-nested-parse::

   Visualization rendering for uncertainty lobes.

   This module renders uncertainty lobe meshes using matplotlib:
       - Draw outer lobes (wedges)
       - Draw inner lobes (wedges)
       - Draw median direction arrows





Module Contents
---------------

.. py:function:: visualize_uncertainty_lobes(mesh, show_median=True, ax=None, outer_lobe_edge_color='skyblue', outer_lobe_face_color='skyblue', inner_lobe_edge_color='skyblue', inner_lobe_face_color='skyblue', median_arrow_color='blue', outer_lobe_alpha=0.3, inner_lobe_alpha=1.0, median_arrow_alpha=1.0)

   Render uncertainty lobe mesh with matplotlib.

   Draws wedge-shaped glyphs representing directional uncertainty with:
   - Outer wedges (light blue, semi-transparent) - larger angular spread
   - Inner wedges (light blue, opaque) - smaller angular spread
   - Median arrows (blue) - showing the most probable direction

   :param mesh: From uncertainty_lobes_mesh() containing:
                - 'wedges': outer lobe wedge data
                - 'inner_wedges': inner lobe wedge data (optional)
                - 'arrows': median direction arrow data
   :type mesh: dict
   :param show_median: Whether to show median direction arrows (default: True)
   :type show_median: bool
   :param ax: Existing axis to draw on. If None, creates new figure and axis.
   :type ax: matplotlib.Axes, optional
   :param outer_lobe_edge_color: Matplotlib color for outer lobe edges. Default is ``'skyblue'``.
   :type outer_lobe_edge_color: color, optional
   :param outer_lobe_face_color: Matplotlib color for outer lobe faces. Default is ``'skyblue'``.
   :type outer_lobe_face_color: color, optional
   :param inner_lobe_edge_color: Matplotlib color for inner lobe edges. Default is ``'skyblue'``.
   :type inner_lobe_edge_color: color, optional
   :param inner_lobe_face_color: Matplotlib color for inner lobe faces. Default is ``'skyblue'``.
   :type inner_lobe_face_color: color, optional
   :param median_arrow_color: Matplotlib color for median direction arrows. Default is ``'blue'``.
   :type median_arrow_color: color, optional
   :param outer_lobe_alpha: Opacity for outer lobe wedges, including their edges. Must be in
                            ``[0, 1]``. Default is ``0.3``.
   :type outer_lobe_alpha: float, optional
   :param inner_lobe_alpha: Opacity for inner lobe wedges, including their edges. Must be in
                            ``[0, 1]``. Default is ``1.0``.
   :type inner_lobe_alpha: float, optional
   :param median_arrow_alpha: Opacity for median direction arrows. Must be in ``[0, 1]``. Default
                              is ``1.0``.
   :type median_arrow_alpha: float, optional

   :returns: **ax** -- The axis with drawn lobe glyphs
   :rtype: matplotlib.Axes