Skip to content

8D-SonKu M3: bounded source-distance and large-room A/B without Square regression - #643

Closed
masarray wants to merge 8 commits into
feat/8d-sonku-v2-externalization-acoustics-20261113from
feat/8d-sonku-v4-distance-spaces-20261113
Closed

masarray wants to merge 8 commits into
feat/8d-sonku-v2-externalization-acoustics-20261113from
feat/8d-sonku-v4-distance-spaces-20261113

Conversation

@masarray

Copy link
Copy Markdown
Owner

8D-SonKu V4 — M3 distance + larger rooms (OFFLINE candidate, not shipped)

Base: stacked on #629 / exact Square Orbit + V3 FDN, NOT main. The listener-approved checkpoint/8d-sonku-square-orbit-approved-20261113 3a74b0273c7a is untouched. #606 remains separate parent. Keep this PR draft, merge only after its parents, reconciliation and release gates.

Delivered

  • Introduced bounded SonKuRoomGeometry{widthMeters,depthMeters,distanceMeters} for offline/inactive DSP instances (5–40 m room edges, 1.6–10 m source distance, >0.5 m wall clearance and bounded fixed delay path).
  • Width/depth independently change 2-emitter × 4-wall image-source reflection path length, delay, level; radius independently scales the direct KEMAR HRTF by 1.6/r and reflected path level by 1.6/path. Existing FDN is unchanged, explicitly OFF in V4 probes (avoids faking hall size by arbitrary tail).
  • New deterministic listening WAVs, all with same source/48k stereo/continuous two 10-second 360° turns:
    • 14.4 × 14.4 m, 1.6 m source, larger room only;
    • 14.4 × 14.4 m, 5 m source, distance only;
    • 28.8 × 28.8 m, 1.6 m source, large space only;
    • 28.8 × 28.8 m, 8 m source, distance in large space.
  • Existing approved 7.2 × 7.2 m, 1.6 m source A/B remains unchanged and is the control.
  • Regression: exact PCM parity for implicit vs explicit approved Square, delayed echo onset as size grows, independently verifiable 1.6/r direct attenuation with ER off, rejection of invalid/outside-wall edits, WAV differences and amplitudes, continuous orbit seams. CPU tool now includes large/distant geometry.

Performance and safety architecture

  • Existing fixed 8192-frame ER rings, C++ HRTF FIR, geometry update every 64 frames; no extra realtime allocation/thread/FFT/locking/IO. Geometry setters reject an already-active effect and are NOT exposed to a live JUCE/GUI callback. No new native session schema, no product setting or VST3; default runtime uses byte-exact legacy arithmetic.
  • Physical limitations acknowledged: first-order 2D wall images only, no roof/floor, personalized HRTF, validated distance-dependent air absorption, path propagation delay, tuned large-hall RT60 or higher-order reflections.
  • See docs/SONKU_V4_DISTANCE_SPACE_DECISION_20261113.md for source references, listening and release gates.

Release blockers

Research: Allen–Berkley JASA DOI 10.1121/1.382599 and Steam Audio core guide; no vendor implementation copied.

Copy link
Copy Markdown
Owner Author

Exact SHA M3 qualification — 2026-11-13

Commit d056bcd01a841d43ca689e658980143177d2d26e PASS scoped Fast Native, Fast UI and real Chromium SonKu editor + offline C++ WAV renderer/contract; run 43377371664 and fast native run 43377371757.

Listening artifact: ArSonMix-SonKu-Headphone-Audio-43377371664, artifact 14015047059 (51,049,963 bytes). Contains old baseline and four new 48 kHz stereo double-orbit WAVs; follow updated LISTENING-GUIDE.txt. Editor screenshot artifact.

New files to compare: sonku-v2-square-orbit-cw-2x.wav vs sonku-v4-spacious-near-orbit-cw-2x.wav (14.4 m at 1.6 m), sonku-v4-spacious-far-orbit-cw-2x.wav (14.4 m at 5.0 m), sonku-v4-large-near-orbit-cw-2x.wav (28.8 m at 1.6 m), sonku-v4-large-far-orbit-cw-2x.wav (28.8 m at 8.0 m).

Runner-local performance only (3 s PCM, Linux, 48 kHz, 128 frames): direct V1 55.955 ms; approved square ER V2 62.652 ms; ER+FDN V3 66.388 ms; M3 large-far geometry+ER 62.430 ms (~2.08% of one CI core). This is not ASIO hardware proof, no strict worst-case realtime bound, and does not imply 28.8 m physical room realism.

Explicit limits: source distance uses relative 1.6/r direct HRTF pressure and 1.6/path reflections; late FDN OFF in M3 probes. No calibrated air absorption/direct time-of-flight, floor/ceiling, HRIR-convolved reflections, automatic room RT60 or headphone perceptual pass. No new native GUI, session schema, or public installer. Keep draft stack #606 -> #629 -> #643 until user A/B and Windows physical qualification; preserve approved Square checkpoint.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

Deploying arsonmix with  Cloudflare Pages  Cloudflare Pages

Latest commit: d056bcd
Status:⚡️  Build in progress...

View logs

Copy link
Copy Markdown
Owner Author

Integrated SonKu consolidation checkpoint — 2026-11-13

The acoustic/native stack is now reconciled into PR #649, an integrated draft based on current main. Its two-parent merge carries this PR's history and the latest #606 native/GUI/updater/WIRE parent simultaneously. Please do not merge this older stacked PR independently into main, or queue redundant Windows builds: the canonical combined qualification now belongs to #649, after which old drafts can be closed as superseded.

Preserved: approved Square Orbit checkpoint 3a74b0273c7a7e13d5d2614183d19995eb12ad57, 8-line FDN, fixed ring/no-RT-clear behavior, source-distance + room models, typed native SPACE controls, schema v2 session restore, real Chromium ACK/readback and musical A/B WAV. All remain pending actual Windows/ASIO and listener release gates.

Copy link
Copy Markdown
Owner Author

MILESTONE A: historical research PR archived as CLOSED UNMERGED. This original early SonKu HRTF, room, distance or FX-insert experiment was superseded as a release path by owner-approved P9.9 #733. Not all source was necessarily imported; the experimental branch remains available for exact code recovery. Original source branch feat/8d-sonku-v4-distance-spaces-20261113, head SHA d056bcd01a841d43ca689e658980143177d2d26e, target feat/8d-sonku-v2-externalization-acoustics-20261113. Full disposition and immutable heads: docs/governance/MILESTONE_A_PR_BRANCH_RECONCILIATION_20261117.md on chore/milestone-a-pr-history-20261117. No branch/checkpoint deletion, no merge, no DSP/GUI change, no release. Reopen only under a separately scoped task after approval.

@masarray masarray closed this Nov 17, 2026
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