Metadata-Version: 2.4
Name: alignment-comparison-plots
Version: 0.1.1
Summary: Interactive phoneme-level plots for comparing forced-alignment outputs across Praat TextGrid corpora.
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: matplotlib>=3.10.8
Requires-Dist: praat-textgrids>=1.4.0
Requires-Dist: pyqt6>=6.10.2
Description-Content-Type: text/markdown

# alignment-comparison-plots

[![GitHub](https://img.shields.io/badge/GitHub-WiscLab/alignment--comparison--plots-181717?logo=github)](https://github.com/WiscLab/alignment-comparison-plots)

When two forced aligners (e.g. MFA and Wav2TextGrid) produce different `.TextGrid` files for the same audio, it can be hard to know where and how they disagree. This package provides ready-made Qt charts that let you visually audit alignment quality and inter-aligner agreement across an entire corpus in seconds. See the full documentation for details on the included set of plotting functions.

**[Full documentation →](https://WISCLab.github.io/alignment-comparison-plots/)**

## Install

```bash
pip install alignment-comparison-plots
# or with uv
uv add alignment-comparison-plots
```

Requires Python ≥ 3.11.

## Quickstart

```python
import glob
from alignment_comparison_plots import plot_phoneme_counts

paths_a = glob.glob("/path/to/alignment_a/**/*.TextGrid", recursive=True)
paths_b = glob.glob("/path/to/alignment_b/**/*.TextGrid", recursive=True)

plot_phoneme_counts(paths_a=paths_a, paths_b=paths_b, label_a="Ref", label_b="Hyp")
```

## License

MIT
