pyats

A desktop viewer/editor for ATS spectral-analysis (.ats) files: view, edit, and resynthesize the sinusoidal partials and the noise/residual bands, then save back to .ats or export to WAV.

Install

macOS / Linux:

python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"

Windows:

py -m venv .venv
.venv\Scripts\pip install -e ".[dev]"

Run

# macOS / Linux
.venv/bin/python -m pyats
# Windows
.venv\Scripts\python -m pyats
# Analyze a WAV into an ATS file
.venv/bin/pyats-analyze input.wav output.ats

Test

.venv/bin/pytest          # macOS / Linux
.venv\Scripts\pytest      # Windows

Documentation

See the full User Manual for platform-by-platform installation (macOS and Windows) and a complete guide to analysis, the display, tools, partial and noise editing, playback, and WAV export.

Features

• Analyze a mono WAV into an .ats file — from the GUI (File ▸ Analyze…, with full control over the analysis parameters) or the pyats-analyze command line.
• View partials (frequency × time, amplitude as brightness) and the 25-band noise heatmap, with a Partials / Noise / Both view mode and a contrast control.
• Three selection tools: Pointer (partials), Time (regions), Box (spectral).
• Partial edits: scale amplitude, transpose/shift frequency, mute, delete, fill gaps — all undoable.
• DAW-style clipboard: copy/cut/paste with crossfades.
• Noise-band editing: scale (dB) and mute the residual over a box region.
• Additive + residual resynthesis with a moving playhead; playback follows the view mode and the current selection; adjustable residual level.
• Save byte-faithful .ats files, inspect the header (File ▸ File Info…), and export mono 16-bit WAV.

License

Released under the MIT License.