avqi

Status: Current Last updated: 2026-04-08 07:40 EDT

Calculate the Acoustic Voice Quality Index (AVQI) from paired audio files. Requires paired continuous speech (.cs.*) and sustained vowel (.sv.*) recordings per speaker. Produces .avqi.txt output.

Uses positional INPUT_DIR OUTPUT_DIR arguments (not the shared PATHS... -o OUTPUT form used by align, morphotag, etc.).

Quick start

# Calculate AVQI for all paired audio in a directory
batchalign3 avqi input_dir/ output_dir/

# Use the remote server
batchalign3 --server http://your-server:8001 avqi input_dir/ output_dir/

Pipeline

flowchart TD
    start([avqi invoked]) --> resolve[Resolve paired audio files\n.cs.wav + .sv.wav per speaker]
    resolve --> prep[Rust audio prep\nprepare CS + SV PCM artifacts]
    prep --> worker["execute_v2(task='avqi') → Python worker\nparselmouth + torchaudio analysis"]
    worker --> output[Write AVQI results\nHarmonics-to-noise ratio, jitter, shimmer, etc.]
    output --> done([Output .avqi.txt files])

Options

Positional arguments

avqi options

Input file naming convention

For each speaker, place two files in INPUT_DIR:

• SPEAKER.cs.wav (or .mp3, .mp4), continuous speech sample
• SPEAKER.sv.wav: sustained vowel sample

The pair is matched by the common stem before .cs. / .sv.. Missing partners are reported as an error.

Output format

Each speaker pair produces SPEAKER.avqi.txt with AVQI metrics including: harmonics-to-noise ratio (HNR), jitter, shimmer, and the composite AVQI score. BA3 uses the same metrics and text format as BA2 while moving audio preprocessing behind the typed media-analysis worker boundary.

Gotchas

avqi prefers the local daemon when auto_daemon is enabled. Use explicit --server to override.

Both files must be present. A missing .cs.* or .sv.* partner causes the whole pair to fail.

Related documentation

• Command I/O: avqi, I/O patterns
• Command Flowcharts: avqi, full architecture flowchart

This page last changed: 2026-06-19 (commit c82a6d03). The whole book last changed: 2026-09-16 (commit 34d249d8).