build_tools.syllable_analysis.plotting
======================================

.. py:module:: build_tools.syllable_analysis.plotting

.. autoapi-nested-parse::

   Plotting utilities for analysis visualizations.

   This subpackage provides both static (matplotlib) and interactive (Plotly)
   visualization functions for dimensionality reduction and feature analysis.

   Modules
   -------
   styles
       Shared styling constants for consistent visualization appearance
   static
       Matplotlib-based static plotting for publication-quality PNG outputs
   interactive
       Plotly-based interactive plotting for exploratory HTML visualizations

   Usage Example
   -------------
   Static Visualization::

       from build_tools.syllable_analysis.plotting import (
           create_tsne_scatter,
           save_static_plot
       )

       fig = create_tsne_scatter(tsne_coords, frequencies)
       save_static_plot(fig, Path("output.png"), dpi=300)

   Interactive Visualization::

       from build_tools.syllable_analysis.plotting import (
           PLOTLY_AVAILABLE,
           create_interactive_scatter,
           save_interactive_html
       )

       if PLOTLY_AVAILABLE:
           fig = create_interactive_scatter(records, tsne_coords)
           save_interactive_html(fig, Path("output.html"), perplexity=30, random_state=42)
       else:
           print("Plotly not installed - skipping interactive visualization")

   Notes
   -----
   - Matplotlib is always available (required dependency for static plots)
   - Plotly is optional (check PLOTLY_AVAILABLE before using interactive functions)
   - All styling constants can be imported from the styles module or this package



Submodules
----------

.. toctree::
   :maxdepth: 1

   /autoapi/build_tools/syllable_analysis/plotting/interactive/index
   /autoapi/build_tools/syllable_analysis/plotting/static/index
   /autoapi/build_tools/syllable_analysis/plotting/styles/index