uvisbox.Modules.UncertaintyLobes.uncertainty_lobes_vis

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

uvisbox.Modules.UncertaintyLobes.uncertainty_lobes_vis.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)[source]

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

Parameters:

  • mesh (dict) – From uncertainty_lobes_mesh() containing: - ‘wedges’: outer lobe wedge data - ‘inner_wedges’: inner lobe wedge data (optional) - ‘arrows’: median direction arrow data

  • show_median (bool) – Whether to show median direction arrows (default: True)

  • ax (matplotlib.Axes, optional) – Existing axis to draw on. If None, creates new figure and axis.

  • outer_lobe_edge_color (color, optional) – Matplotlib color for outer lobe edges. Default is 'skyblue'.

  • outer_lobe_face_color (color, optional) – Matplotlib color for outer lobe faces. Default is 'skyblue'.

  • inner_lobe_edge_color (color, optional) – Matplotlib color for inner lobe edges. Default is 'skyblue'.

  • inner_lobe_face_color (color, optional) – Matplotlib color for inner lobe faces. Default is 'skyblue'.

  • median_arrow_color (color, optional) – Matplotlib color for median direction arrows. Default is 'blue'.

  • outer_lobe_alpha (float, optional) – Opacity for outer lobe wedges, including their edges. Must be in [0, 1]. Default is 0.3.

  • inner_lobe_alpha (float, optional) – Opacity for inner lobe wedges, including their edges. Must be in [0, 1]. Default is 1.0.

  • median_arrow_alpha (float, optional) – Opacity for median direction arrows. Must be in [0, 1]. Default is 1.0.

Returns:

ax – The axis with drawn lobe glyphs

Return type:

matplotlib.Axes