visqol-python 3.6.0__tar.gz → 3.7.0__tar.gz

{visqol_python-3.6.0 → visqol_python-3.7.0}/CHANGELOG.md

@@ -4,6 +4,45 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [3.7.0] - 2026-05-30
+
+### Fixed
+- **Audio-mode C++ parity in fine realignment** (`finely_align_and_recreate_patches`):
+  the previous "B2 optimisation" skipped the per-patch spectrogram rebuild
+  whenever the fine-alignment lag was zero, on the assumption that the rebuilt
+  spectrogram would be identical to the original patch. That assumption is
+  wrong. The original patch is sliced out of the **full-signal** Gammatone
+  spectrogram (warm IIR filter state, carrying history), whereas the rebuild
+  runs Gammatone over the **sliced** audio from a cold filter state — so the
+  leading frames differ even when no shift is applied. C++ ViSQOL always
+  rebuilds and keeps whichever scores higher, so skipping it silently dropped
+  that improvement. The skip is removed; every matched patch is now rebuilt and
+  compared, exactly as C++ does.
+  - **Impact:** audio MOS-LQO now matches the C++ binary to ULP. Max diff over
+    the 10 conformance cases dropped from **2.41 × 10⁻² → 1.17 × 10⁻⁴**; 9 of 10
+    cases are bit-exact (~10⁻¹⁴). The lone residual (`contrabassoon_24aac`,
+    1.17 × 10⁻⁴) is an unrelated sub-sample boundary-patch alignment rounding,
+    now smaller than the speech-mode parity gap.
+  - Existing audio scores shift by up to ~0.024 MOS where they were previously
+    too low; this is a move **toward** the C++ ground truth, not away from it.
+  - Speech polynomial and lattice scores are unaffected (bit-identical before
+    and after).
+
+### Performance
+- Fine realignment now rebuilds the spectrogram for every patch (including
+  `lag == 0`), so it no longer benefits from the zero-lag skip. Net effect is
+  roughly **1.4–1.5× slower realignment** (e.g. `guitar48_stereo` 0.44 s → 0.65 s
+  end-to-end with Numba + pyFFTW). This is the cost of exact C++ parity and is
+  consistent with the project's precision-first policy. Audio-mode RTF rises
+  from ~0.036 (3.6.0) to ~0.054 — still ~1.7× faster than the C++ binary
+  (~0.093) and faster than 3.5.0 (~0.067).
+
+### Changed
+- **Dropped Python 3.9 support** (`requires-python = ">=3.10"`). Downstream
+  projects still on 3.9 should pin `visqol-python<3.7`.
+- CI: bumped GitHub Actions to Node-24-compatible major versions
+  (checkout v5, setup-python v6, upload/download-artifact v5).
+
 ## [3.6.0] - 2026-05-27
 
 ### Added
@@ -218,6 +257,7 @@ All v3.5.0 conformance baselines preserved within ULP precision:
 - Bundled SVR model (`libsvm_nu_svr_model.txt`)
 - GitHub Actions workflow for auto-publish to PyPI via Trusted Publisher
 
+[3.7.0]: https://github.com/talker93/visqol-python/compare/v3.6.0...v3.7.0
 [3.6.0]: https://github.com/talker93/visqol-python/compare/v3.5.0...v3.6.0
 [3.5.0]: https://github.com/talker93/visqol-python/compare/v3.4.0...v3.5.0
 [3.4.0]: https://github.com/talker93/visqol-python/compare/v3.3.6...v3.4.0

{visqol_python-3.6.0/visqol_python.egg-info → visqol_python-3.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: visqol-python
-Version: 3.6.0
+Version: 3.7.0
 Summary: ViSQOL - Virtual Speech Quality Objective Listener (Pure Python)
 Author: Shan Jiang
 License-Expression: Apache-2.0
@@ -14,7 +14,6 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -22,7 +21,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
 Classifier: Topic :: Scientific/Engineering
 Classifier: Typing :: Typed
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy>=1.20
@@ -32,12 +31,12 @@ Requires-Dist: libsvm-official>=3.25
 Provides-Extra: accel
 Requires-Dist: numba>=0.57; extra == "accel"
 Provides-Extra: lattice
-Requires-Dist: ai-edge-litert>=2.1.5; python_version >= "3.10" and extra == "lattice"
+Requires-Dist: ai-edge-litert>=2.1.5; extra == "lattice"
 Provides-Extra: fftw
 Requires-Dist: pyfftw>=0.13; extra == "fftw"
 Provides-Extra: all
 Requires-Dist: numba>=0.57; extra == "all"
-Requires-Dist: ai-edge-litert>=2.1.5; python_version >= "3.10" and extra == "all"
+Requires-Dist: ai-edge-litert>=2.1.5; extra == "all"
 Requires-Dist: pyfftw>=0.13; extra == "all"
 Provides-Extra: test
 Requires-Dist: pytest>=7.0; extra == "test"
@@ -46,7 +45,7 @@ Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: ruff>=0.4; extra == "dev"
 Requires-Dist: mypy>=1.8; extra == "dev"
 Requires-Dist: numba>=0.57; extra == "dev"
-Requires-Dist: ai-edge-litert>=2.1.5; python_version >= "3.10" and extra == "dev"
+Requires-Dist: ai-edge-litert>=2.1.5; extra == "dev"
 Requires-Dist: pyfftw>=0.13; extra == "dev"
 Dynamic: license-file
 

{visqol_python-3.6.0 → visqol_python-3.7.0}/pyproject.toml

@@ -8,7 +8,7 @@ dynamic = ["version"]
 description = "ViSQOL - Virtual Speech Quality Objective Listener (Pure Python)"
 readme = "README.md"
 license = "Apache-2.0"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 authors = [
     {name = "Shan Jiang"},
 ]
@@ -22,7 +22,6 @@ classifiers = [
     "Intended Audience :: Developers",
     "Intended Audience :: Science/Research",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -40,11 +39,11 @@ dependencies = [
 
 [project.optional-dependencies]
 accel = ["numba>=0.57"]
-lattice = ["ai-edge-litert>=2.1.5; python_version >= '3.10'"]
+lattice = ["ai-edge-litert>=2.1.5"]
 fftw = ["pyfftw>=0.13"]
 all = [
     "numba>=0.57",
-    "ai-edge-litert>=2.1.5; python_version >= '3.10'",
+    "ai-edge-litert>=2.1.5",
     "pyfftw>=0.13",
 ]
 test = ["pytest>=7.0"]
@@ -53,7 +52,7 @@ dev = [
     "ruff>=0.4",
     "mypy>=1.8",
     "numba>=0.57",
-    "ai-edge-litert>=2.1.5; python_version >= '3.10'",
+    "ai-edge-litert>=2.1.5",
     "pyfftw>=0.13",
 ]
 
@@ -80,7 +79,7 @@ visqol = ["model/*.txt", "model/*.tflite", "py.typed"]
 testpaths = ["tests"]
 
 [tool.ruff]
-target-version = "py39"
+target-version = "py310"
 line-length = 95
 
 [tool.ruff.lint]

{visqol_python-3.6.0 → visqol_python-3.7.0}/visqol/__init__.py

@@ -13,7 +13,7 @@ Usage:
     print(f"MOS-LQO: {result.moslqo}")
 """
 
-__version__: str = "3.6.0"
+__version__: str = "3.7.0"
 
 from visqol.api import ProgressCallback, VisqolApi
 from visqol.audio_utils import AudioSignal

{visqol_python-3.6.0 → visqol_python-3.7.0}/visqol/api.py

@@ -10,9 +10,8 @@ from __future__ import annotations
 
 import logging
 import os
-from collections.abc import Sequence
+from collections.abc import Callable, Sequence
 from concurrent.futures import ProcessPoolExecutor, as_completed
-from typing import Callable
 
 import numpy as np
 from numpy.typing import NDArray

{visqol_python-3.6.0 → visqol_python-3.7.0}/visqol/patch_selector.py

@@ -469,14 +469,19 @@ def finely_align_and_recreate_patches(
 
     1. Extract audio sub-signals
     2. Re-align at fine granularity
-    3. **If lag == 0, skip spectrogram rebuild** (B2 optimisation)
-    4. Rebuild spectrograms only when alignment changed
-    5. Recompute NSIM
-    6. Keep the better result (original or re-aligned)
-
-    The B2 optimisation avoids redundant Gammatone filtering when the
-    fine alignment produces zero shift — the rebuilt spectrograms would
-    be identical to the originals, so skipping saves **~2-3 s** per file.
+    3. Rebuild spectrograms from the (re)aligned audio slices
+    4. Recompute NSIM
+    5. Keep the better result (original or re-aligned)
+
+    The rebuild is performed for **every** patch, including those with
+    ``lag == 0``.  This mirrors C++ exactly: the original patch was sliced
+    out of the *full-signal* spectrogram (its Gammatone IIR state is warm,
+    carrying history from earlier samples), whereas the rebuilt patch runs
+    Gammatone over the *sliced* audio from a cold filter state.  The two
+    therefore differ in their leading frames even when no time shift is
+    applied, and C++ keeps whichever scores higher.  Skipping the rebuild
+    on ``lag == 0`` (a former "optimisation") silently dropped this
+    improvement and broke audio-mode C++ parity by up to ~0.024 MOS.
     """
     realigned_results: list[PatchSimilarityResult] = list(sim_results)
 
@@ -506,17 +511,13 @@ def finely_align_and_recreate_patches(
         except Exception:
             continue
 
-        # B2 optimisation: if lag is zero, alignment didn't change anything.
-        # The rebuilt spectrogram would be identical to the original, so the
-        # recomputed NSIM would also be identical — skip the expensive rebuild.
-        if lag == 0.0:
-            continue
-
         # Check we have enough samples
         if len(ref_aligned.data) <= window.size or len(deg_aligned.data) <= window.size:
             continue
 
-        # 3. Rebuild spectrograms (only when lag != 0)
+        # 3. Rebuild spectrograms from the aligned slices (always — see docstring:
+        #    cold vs warm Gammatone state makes this differ from the original
+        #    patch even when lag == 0, so it is not a redundant recompute).
         try:
             ref_spec = spect_builder.build(ref_aligned, window)
             deg_spec = spect_builder.build(deg_aligned, window)

{visqol_python-3.6.0 → visqol_python-3.7.0/visqol_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: visqol-python
-Version: 3.6.0
+Version: 3.7.0
 Summary: ViSQOL - Virtual Speech Quality Objective Listener (Pure Python)
 Author: Shan Jiang
 License-Expression: Apache-2.0
@@ -14,7 +14,6 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -22,7 +21,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
 Classifier: Topic :: Scientific/Engineering
 Classifier: Typing :: Typed
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy>=1.20
@@ -32,12 +31,12 @@ Requires-Dist: libsvm-official>=3.25
 Provides-Extra: accel
 Requires-Dist: numba>=0.57; extra == "accel"
 Provides-Extra: lattice
-Requires-Dist: ai-edge-litert>=2.1.5; python_version >= "3.10" and extra == "lattice"
+Requires-Dist: ai-edge-litert>=2.1.5; extra == "lattice"
 Provides-Extra: fftw
 Requires-Dist: pyfftw>=0.13; extra == "fftw"
 Provides-Extra: all
 Requires-Dist: numba>=0.57; extra == "all"
-Requires-Dist: ai-edge-litert>=2.1.5; python_version >= "3.10" and extra == "all"
+Requires-Dist: ai-edge-litert>=2.1.5; extra == "all"
 Requires-Dist: pyfftw>=0.13; extra == "all"
 Provides-Extra: test
 Requires-Dist: pytest>=7.0; extra == "test"
@@ -46,7 +45,7 @@ Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: ruff>=0.4; extra == "dev"
 Requires-Dist: mypy>=1.8; extra == "dev"
 Requires-Dist: numba>=0.57; extra == "dev"
-Requires-Dist: ai-edge-litert>=2.1.5; python_version >= "3.10" and extra == "dev"
+Requires-Dist: ai-edge-litert>=2.1.5; extra == "dev"
 Requires-Dist: pyfftw>=0.13; extra == "dev"
 Dynamic: license-file
 

{visqol_python-3.6.0 → visqol_python-3.7.0}/visqol_python.egg-info/requires.txt

@@ -8,27 +8,21 @@ numba>=0.57
 
 [all]
 numba>=0.57
-pyfftw>=0.13
-
-[all:python_version >= "3.10"]
 ai-edge-litert>=2.1.5
+pyfftw>=0.13
 
 [dev]
 pytest>=7.0
 ruff>=0.4
 mypy>=1.8
 numba>=0.57
-pyfftw>=0.13
-
-[dev:python_version >= "3.10"]
 ai-edge-litert>=2.1.5
+pyfftw>=0.13
 
 [fftw]
 pyfftw>=0.13
 
 [lattice]
-
-[lattice:python_version >= "3.10"]
 ai-edge-litert>=2.1.5
 
 [test]