Skip to content

docs(vmaf): research digest + ADR-1122 for VMAF v1 model port - #1082

Open
Tualua wants to merge 1 commit into
VMAFx:masterfrom
Tualua:docs/vmaf-v1-port-research
Open

docs(vmaf): research digest + ADR-1122 for VMAF v1 model port#1082
Tualua wants to merge 1 commit into
VMAFx:masterfrom
Tualua:docs/vmaf-v1-port-research

Conversation

@Tualua

@Tualua Tualua commented Jul 1, 2026

Copy link
Copy Markdown

Summary

Netflix shipped VMAF v1 in libvmaf v3.2.0 (June 2026). This PR adds a cited
research digest and ADR-1122 deciding how the fork adopts it: opt-in v1
generation, vmaf_v0.6.1 stays default.
Docs-only (planning) — no code yet.

Key finding: v1 is still a libsvm ν-SVR fusion, but VIF is removed and CAMBI
(banding) + speed_chroma (chroma) become core features
(ADM/motion → adm3/motion3).
Six built-in models (1080p@3H, phone@5H, 4K@1.5H, 4K@3H — last on [0, 110]) + HFR
variants; Netflix recommends 10-bit even for 8-bit SDR (aligns with ADR-1121 / PR #1081).

Type

  • docs — documentation only

Checklist

  • Commits follow Conventional Commits.
  • ADR row lives in docs/adr/_index_fragments/1122-*.md + _order.txt (README regenerated).
  • No Netflix golden assertions modified (docs-only).

Bug-status hygiene (ADR-0165)

  • no state delta: planning ADR, not a bug open/close/rule-out.

Deep-dive deliverables (ADR-0108)

  • Research digestdocs/research/2026-07-01-vmaf-v1-models.md.
  • Decision matrix — ADR-1122 ## Alternatives considered (opt-in vs v1-default vs don't-port vs models-only).
  • AGENTS.md invariant note — no rebase-sensitive invariants: docs-only planning ADR, no code touched.
  • Reproducer / smoke-test command — no reproducer needed: docs-only.
  • CHANGELOG fragment — no changelog needed: no user-visible surface changes (planning ADR only).
  • Rebase note — no rebase impact: docs-only; the actual v1 port lands under this ADR later.

Known follow-ups

The v1 implementation (build in JSONs, fix SYCL cambi/speed_chroma, [0,110]
handling, CAMBI enc-params, v1 golden tests, upstream sync to v3.2.0) is scoped in
ADR-1122 and tracked as a follow-up port — this PR only lands the decision + research.

🤖 Generated with Claude Code

https://claude.ai/code/session_01YCP4JCoduujJgccDRGvNKv

Netflix shipped VMAF v1 in libvmaf v3.2.0 (June 2026): still a libsvm
nu-SVR fusion, but VIF is removed and CAMBI (banding) + speed_chroma
(chroma) become core features; ADM/motion move to adm3/motion3. Six
built-in models for 1080p@3H / phone@5H / 4K@1.5H / 4K@3H (last on a
[0,110] range) + HFR variants; Netflix recommends 10-bit measurement
even for 8-bit SDR.

Adds a cited research digest and ADR-1122 deciding to adopt v1 as an
opt-in generation (v0.6.1 stays default), with the port scope: build in
the JSONs, fix SYCL cambi/speed_chroma (now core, currently failing on
Arc A380), handle the [0,110] range end-to-end, plumb CAMBI enc params,
and add new v1 golden refs in separate tests (v0.6.1 golden pairs
untouched). Aligns with the zero-copy 10-bit work (ADR-1121, PR VMAFx#1081).

Refs ADR-1122.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YCP4JCoduujJgccDRGvNKv
@Tualua
Tualua requested a review from lusoris as a code owner July 1, 2026 04:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant