uvisbox.Modules.SquidGlyphs.squid_glyphs_mesh
=============================================

.. py:module:: uvisbox.Modules.SquidGlyphs.squid_glyphs_mesh




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

.. py:function:: squid_glyphs_2d_mesh(positions, stats_2d, scale=0.2)

   Build 2D squid glyph mesh from statistics.

   Creates arrow-shaped glyphs with three components:
   1. Base rectangle (uncertainty in magnitude)
   2. Shaft rectangle (tapered middle section)
   3. Head triangle (arrow tip)

   :param positions: Shape (n, 2) - glyph positions
   :type positions: numpy.ndarray
   :param stats_2d: From squid_glyphs_2d_summary_statistics()
   :type stats_2d: dict
   :param scale: Glyph scale factor (default: 0.2)
   :type scale: float

   :returns: **mesh_2d** -- Contains ``points`` with shape (k, 2) and ``polygons`` with shape
             (m, 3).
   :rtype: dict


.. py:function:: squid_glyphs_3d_mesh(positions, stats_3d, point_values=None, scale=0.5, resolution=10)

   Build 3D squid glyph mesh from statistics.

   :param positions: Shape (n, 3) - glyph positions
   :type positions: numpy.ndarray
   :param stats_3d: From squid_glyphs_3d_summary_statistics()
   :type stats_3d: dict
   :param point_values: Shape (n,) - scalar values for coloring
   :type point_values: numpy.ndarray, optional
   :param scale: Glyph scale factor (default: 0.5)
   :type scale: float
   :param resolution: Circle resolution (default: 10)
   :type resolution: int

   :returns: **mesh_3d** -- Contains ``points`` with shape (k, 3), ``polygons`` with shape (m, 3),
             and ``point_values`` with shape (k,).
   :rtype: dict


.. py:function:: squid_glyphs_meshing_3D(pca_components, positions, vectors, spread_min_vectors, median_vectors, spread_max_vectors, scaler_values, glyph_types, scale, resolution, num_of_glyphs)

   Build superelliptical squid glyphs for 3D visualization.

   Creates glyphs with these components:
   1. Base disk (at position)
   2. Body cylinder (from base to shoulder)
   3. Shaft (tapered section)
   4. Head cone (arrow tip)

   :param pca_components: PCA components for cross-section shape
   :type pca_components: numpy.ndarray
   :param positions: Glyph center positions (n, 3)
   :type positions: numpy.ndarray
   :param vectors: Ensemble vectors (unused, for compatibility)
   :type vectors: numpy.ndarray
   :param spread_min_vectors: Vector statistics in spherical coordinates
   :type spread_min_vectors: numpy.ndarray
   :param median_vectors: Vector statistics in spherical coordinates
   :type median_vectors: numpy.ndarray
   :param spread_max_vectors: Vector statistics in spherical coordinates
   :type spread_max_vectors: numpy.ndarray
   :param scaler_values: Scalar values for coloring
   :type scaler_values: numpy.ndarray
   :param glyph_types: Glyph type flags (0=none, 1=full, 2=arrow only)
   :type glyph_types: numpy.ndarray
   :param scale: Overall glyph scale
   :type scale: float
   :param resolution: Number of vertices per circle
   :type resolution: int
   :param num_of_glyphs: Number of full glyphs to create
   :type num_of_glyphs: int

   :returns: **points, polygons, points_values** -- Mesh geometry and scalar values
   :rtype: tuple