pvx Benchmarks

Generated from commit 35e9761 (commit date: 2026-05-25T08:14:42-04:00).

Reproducible benchmark summary for core short-time Fourier transform/inverse short-time Fourier transform (STFT/ISTFT) path across central processing unit/Compute Unified Device Architecture/Apple-Silicon-native contexts.

Quick Setup (Install + PATH)

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -e .
pvx --help

If pvx is not found, add the virtualenv binaries to your shell path (zsh):

printf 'export PATH="%s/.venv/bin:$PATH"\n' "$(pwd)" >> ~/.zshrc
source ~/.zshrc
pvx --help

Reproduce

python3 scripts/scripts_generate_docs_extras.py --run-benchmarks

Benchmark Spec

• Sample rate: 48000 Hz
• Duration: 4.0 s
• Signal suite size: 4
• Signal recipe: deterministic synthetic suite: tonal, speech-like, transient stereo, chirp/texture stereo
• STFT config: n_fft=2048, win_length=2048, hop_size=512, window=hann, center=True

Signal	Channels	Duration (s)	Description
tonal_ramp_mono	1	4.000	Deterministic harmonic blend with slow ramp.
speech_like_mono	1	4.000	Speech-like harmonic formants with sparse glottal-like impulses.
transient_drums_stereo	2	4.000	Percussive burst train for onset retention and stereo timing drift.
chirp_texture_stereo	2	4.000	Wideband chirp-plus-texture to stress spectral and phase stability.

Host

• Platform: macOS-15.1.1-arm64-arm-64bit-Mach-O
• Machine: arm64
• Python: 3.14.3

Backend Summary

Backend	Status	Cases (ok/total)	Mean xRT	Mean elapsed (ms)	Peak host memory (MB)	Mean quality score (/100)	Mean SNR in (dB)	Mean SI-SDR (dB)	Mean LSD (dB)	Mean ModSpec	Mean Smear	Mean EnvCorr	Mean Coherence Drift	Mean Phasiness	Mean Musical Noise	Mean SNR vs CPU (dB)	Mean LSD vs CPU (dB)	Notes
cpu	ok	4/4	146.39	31.02	17.70	97.50	100.980	153.813	0.0000	0.0000	0.0000	1.0000	0.0000	0.0511	0.0000	n/a	n/a
cuda	unavailable	0/4	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	CUDA mode requires CuPy. Install a matching cupy-cudaXXx package.
apple_silicon_native_cpu	ok	4/4	147.28	30.58	17.70	97.50	100.980	153.813	0.0000	0.0000	0.0000	1.0000	0.0000	0.0511	0.0000	100.980	0.0000

Per-Signal Results

Backend	Signal	Channels	Duration (s)	Status	xRT	Elapsed (ms)	Quality (/100)	SNR in (dB)	SI-SDR (dB)	LSD (dB)	ModSpec	Smear	EnvCorr	Coherence Drift	Phasiness	Musical Noise	SNR vs CPU (dB)	LSD vs CPU (dB)	Notes
apple_silicon_native_cpu	chirp_texture_stereo	2	4.000	ok	96.99	41.24	100.00	102.306	155.139	0.0000	0.0000	0.0000	1.0000	0.0000	0.0000	0.0000	102.306	0.0000
apple_silicon_native_cpu	speech_like_mono	1	4.000	ok	197.66	20.24	100.00	99.925	152.758	0.0000	0.0000	0.0000	1.0000	n/a	0.0000	0.0000	99.925	0.0000
apple_silicon_native_cpu	tonal_ramp_mono	1	4.000	ok	195.35	20.48	100.00	107.760	160.593	0.0000	0.0000	0.0000	1.0000	n/a	0.0000	0.0000	107.760	0.0000
apple_silicon_native_cpu	transient_drums_stereo	2	4.000	ok	99.12	40.36	90.00	93.930	146.763	0.0000	0.0000	0.0000	1.0000	0.0000	0.2042	0.0000	93.930	0.0000
cpu	chirp_texture_stereo	2	4.000	ok	93.13	42.95	100.00	102.306	155.139	0.0000	0.0000	0.0000	1.0000	0.0000	0.0000	0.0000	n/a	n/a
cpu	speech_like_mono	1	4.000	ok	198.94	20.11	100.00	99.925	152.758	0.0000	0.0000	0.0000	1.0000	n/a	0.0000	0.0000	n/a	n/a
cpu	tonal_ramp_mono	1	4.000	ok	194.70	20.54	100.00	107.760	160.593	0.0000	0.0000	0.0000	1.0000	n/a	0.0000	0.0000	n/a	n/a
cpu	transient_drums_stereo	2	4.000	ok	98.77	40.50	90.00	93.930	146.763	0.0000	0.0000	0.0000	1.0000	0.0000	0.2042	0.0000	n/a	n/a
cuda	chirp_texture_stereo	2	4.000	unavailable	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	CUDA mode requires CuPy. Install a matching cupy-cudaXXx package.
cuda	speech_like_mono	1	4.000	unavailable	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	CUDA mode requires CuPy. Install a matching cupy-cudaXXx package.
cuda	tonal_ramp_mono	1	4.000	unavailable	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	CUDA mode requires CuPy. Install a matching cupy-cudaXXx package.
cuda	transient_drums_stereo	2	4.000	unavailable	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	n/a	CUDA mode requires CuPy. Install a matching cupy-cudaXXx package.

Interpretation notes:

• xRT (times real-time): higher is faster.
• Quality (/100) is a composite from core artifact metrics; use it as a quick ranking aid, not as a single acceptance criterion.
• Lower is better for LSD, ModSpec, Smear, Coherence Drift, Phasiness, and Musical Noise.
• Higher is better for SNR, SI-SDR, and Envelope Correlation.

Raw machine-readable benchmark output: docs/benchmarks/latest.json.

Attribution

See ATTRIBUTION.md.