build_tools.syllable_analysis.plotting

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

• build_tools.syllable_analysis.plotting.interactive
• build_tools.syllable_analysis.plotting.static
• build_tools.syllable_analysis.plotting.styles