Repository navigation
Conversation
…red HRTF + room authority Add callback-owned hysteretic energy/cross-correlation recovery of input M/S difference after binaural convolution, never mono-summing that content. Active only for strongly negative correlation, gain-slewed, finite/RT-safe; zero for correlated source and spatialMix=0. Apply to ROOM-OFF, experimental distance and native SPACE branches with consistent output trim, reuse scene limiter, preserve JUCE state/ACK ABI.
…PCM chunk parity at 44.1/48k Numerical tests exercise native impulse, FRONT/RIGHT/REAR/LEFT collapse rescue, independent L/R, 128-frame chunk parity, finite peak guard, positive-correlation no-op, silence reset, device prepare and spatialMix=0 dry identity.
…evidence Render original harmonic material at matched time/level as coherent front, anti-phase front and anti-phase rear with exact native core. Do not normalize WAVs or claim dearVR externalization.
…out full room renders
…i-stage quality gate
…, not Chromium/Windows FAT Use existing native core fixture in Fast UI plus a separate original three-WAV evidence and same-runner CPU benchmark. Full UI runner still protects GUI-changing SonKu branches. No network HRTF fetch or slow native installer blocks.
…ase side Use the existing per-sample 20ms correlation evidence for complementary positive-coherence hysteresis; no extra buffering, allocation, or new thread. Expose coefficient correction target strength to native FIR scheduler.
Prevent coherent stereo comb nulls by steering common L/R content toward measured center HRIR, while algebraically preserving left-minus-right directional transfer. Hysteretic coherent evidence ramps weights; coefficient updates remain on existing 16-frame cadence and 6ms per-tap slew. Reuse same two native source convolutions, SPSC/graph and state ABI.
…comb notch Assert per-ear 48k KEMAR spectrum old 60-degree stereo sum has a deep notch; coherent native FIR now converges to center HRIR within 14%, retaining side difference and preserving partition/phase/mono guards at 44.1/48k.
…23 baseline Use compile-time pinned baseline include only in the offline tool (never native JUCE) and add 2k harmonic plus 60-degree coherent FRONT/REAR cases. Existing full listening suite remains supported.
…3 in 5 matched WAVs Sparse checkout only immutable baseline SonKu headers; compile both native cores and assess exact coherent center, directional 2kHz comb recovery, anti-phase L/R RMS and peak safety. Keep benchmark same runner and upload both sides without Windows/Chromium rebuild.
…-FIR Mid/Side correction Document exact-phase cancellation, frequency-domain KEMAR comparison, invariant side transfer, bounded coherence ramps, matched baseline native WAV evidence and explicit limits beyond a real BRIR.
…e baseline-vs-candidate CI
…itrary PCM block splits Assert native Chamber 5m reflection+FDN still preserves both ears, phase/finiteness, bounded peak and exact 16k-sample 256-frame partition parity.
…n at deep HRTF notches
…t externalization limitations
SonKu P1.1 mixed-frequency music integrity — verified engineering checkpoint (2026-11-14)Current draft head: Actual source-level change
Evidence: PASS
Gate NOT YET METThe recovered side may remain head-locked; cross-band changes may affect width/tonality. No blind matched-level SonKu vs dearVR listening, personalized licensed HRTF, real BRIR/elevation, verified physical FRONT/REAR externalization or ASIO XRUN measurements. Keep PR draft. No main merge, release or claim of dearVR equivalence. Independent science/vendor context: official dearVR PRO 2 manual; SOFA/AES69; 2026 BRIR/externalization study; Steam Audio documentation; ITU-R BS.1116. The algorithm in this PR is independent SonKu work, not reverse-engineered proprietary dearVR/AMBEO code. |
P1.1 Final verified CI + callback percentiles (2026-11-14)Head
These are isolated runner samples, not ASIO callback deadlines, Windows XRUN counts, performance comparison to the same-runner previous alpha.23, or full WIRE+VST3 graph proof. The benchmark adds no callback allocation. CPU estimates are informational, not a release gate pass. Technical honesty / next gateCurrent protective stereo side remains partly head-locked. The room model is four-wall planar reflection with an ITD/ILD approximation, not multi-elevation, HRTF-convolved directional BRIR. dearVR PRO 2 manual documents directional early reflections incl. floor/ceiling and separate dry/reflections/reverb, while Sennheiser discloses proprietary Clarity as a timbre/externalization tradeoff; no proprietary code/data has been copied. New 2026 NI-BRIR human listening research (Shen & Wang, Trends in Hearing, doi:10.1177/23312165261468752) also supports treating frontal externalization and early-reflection balance as a separately measured challenge, not a generic reverb increase. Next acceptance gate should evaluate licensed 3D SOFA/AES69 HRTFs and directional reflection/BRIR candidate in isolated A/B with HRIR ITD/ILD, binaural phase, DRR, loudness/headroom, crossfade continuity and CPU p99, followed by matched-level, blinded human headphone comparison SonKu/dearVR/original stereo. Leave #674 draft; do not merge or release on synthetic PCM CI alone. |
P2.0 Directional early reflections — independently derived, implemented, tested (2026-11-14)Active draft head: Verified source root cause
Actual DSP implementation
Objective facts, not subjective claims
Research-grounded basis and explicit limitations
DecisionKEEP PR #674 DRAFT; no main merge, public release or default GUI activation. P2 is an actual source-level engineering milestone but the ~4–6x CPU cost versus the light mode is a real release blocker. Next: independently validate lower-cost directional convolution (with same PCM/spectral/ITD/ILD transfer and moving source fidelity), bring licensed multi-elevation SOFA HRTF and six-surface BRIR where permitted, and perform matched-loudness blinded headphones with dearVR PRO 2 and original stereo, followed by Windows ASIO p50/p95/p99 + XRUN and actual native graph WIRE/VST3 FAT. Only publish after audible preference and reliable hardware proof. |
P3.0 SonKu source-direction fusion — VERIFIED native DSP and exact PCM (2026-11-14)GitHub SHA: Science / operator context
Reproducible objective findings
Next actual barriers, not marketing
Decision: maintain draft #674 and published public alpha.23 intact. P3 is tested native optimization of P2 for zero source spread, not proof that SonKu now equals dearVR PRO 2. |
…p PCM and CPU gates
2026-11-14 P4 / P5 verification — native 60° HRIR CPU optimization and no-ghost room reactivationVerified draft HEAD: Implemented native DSP, not cosmetic progress
Measured evidence: stereo spread 60°, 48k/128, same-runner, 3 secondsThree independent GitHub Actions hosted-Linux comparisons:
Native C++ 44.1/48k, 0/60/120° stereo spread, moving HRIR, independent input channels, transient source and three delay-ring wraps: PASS, maximum absolute P2-vs-P4 wet-signal difference <2e-6. P0/P1 old six native PCM music A/B and 380-point KEMAR broad frequency checks still PASS. Original source 48k/16-bit eight-WAV A/B: FRONT/REAR, 60°/120°, four P2 reference vs four P4 contiguous renderings with genuinely different L/R harmonics. Numeric evidence: maximum difference 1 PCM 16bit LSB, at most 0.00104% interleaved samples differed (worst REAR 120°: 0.0000104167 fraction); stereo five-harmonic spectral change at 165/940/2200/4700/5100Hz <0.00002dB. This is not bit-identical WAV in all scenes. The initial bit-identity gate intentionally failed and was corrected into strict measured 1-LSB/0.01dB tolerance, not waived. See What research does / does not justify
Product and release decisionCurrent |
|
MILESTONE A — archival closure WITHOUT MERGING. This older P0/P6/M4 SonKu native-space/room/stereo experimental PR is now historical research. The actual owner-listening-approved P9.9 production integration is merged #733; this earlier research chain is not a product release or safe merge source. Source branch: |
Owner field problem
8D-SonKu lacks dearVR-style externalization, apparent distance and musical tonal integrity. Owner reports extensive audio cancellation. The public alpha.23 is the unaffected baseline; do not alter its tag or user installer.
Root cause proven in source
SonKuSpatialCoreaccumulates two directional measured KEMAR HRIR-filtered source channels into each ear:ears[0] += L*H0L + R*H1L, similarly right. At 0° stereo spread the filters match; any anti-phase stereo L=-R cancels exactly, even when neither input is silent. At nonzero spread similar low-frequency responses still permit partial cancellation. Not a CSS/PNG problem.Implemented P0 experiment
SonKuStereoIntegrity.hfixed-state per-instance correlation gate: ~20ms evidence, -0.78/-0.55 hysteresis, 15ms slew, silence reset, bounded inputs. Inject a boundedside = (L-R)/2after binaural/room summing only when strongly negatively correlated. Audio PCM remains one native JUCE callback. No third-party code or impulse response copied.Deliberate limitations
This is a protective stereo bed, not a magic externalized BRIR; by itself it can sound partly head-locked and does not fix all HRTF coloration or distance perception. Do not say dearVR-quality or merge into public main without user headphone listening, matched-source subjective tests, normal-music tonal verification and ASIO CPU/field approval. Subsequent P1 spectral compensation and P2 directional reflection/HRTF personalization require separate evidence.
Acceptance
Exact-source Fast UI native PCM, targeted audio WAV output, deterministic waveform parity, same-runner informational CPU benchmark, and source/regression CI. Never rewrite licensed HRIR or control ABI.
P0.2 objective comb-filter repair (implemented + tested)
H_L'=H_L+mu*(H_center-(H_L+H_R)/2)and same forH_R'; the side differenceH_L'-H_R'remains unchanged. No third per-sample convolution, extra audio graph, ABI/state/GUI change. The P0 negative-coherence stereo side rescue remains separate.4a6e47e2905a4aa995f879045a907abee8b1aae5: FRONT coherent/spread60 +7.19 dB at 2kHz; REAR coherent/spread60 +11.64 dB at 2kHz. Anti-phase FRONT and REAR/zero spread recover RMS 0.04922 each ear from a near-zero prior output. Original coherent center/spread0 byte-exact. Native C++ 44.1/48k tests and PCM chunk parity PASS, plus original 5×4s generated sample matched 48k/16bit WAV per version and 10 WAVs + objective metrics artifact.docs/SONKU_DEARVR_QUALITY_GAP_AND_MUSIC_INTEGRITY_20261113.md; further HRTF/BRIR, DRR, spectral calibration, head motion and human blind A/B remain explicit release blockers. Keep this PR draft until owner headphone/Windows tests.P1.0 analytical frequency coverage (follow-up checkpoint)
Added
tests/sonku_hrir_spectral_audit.cppand an audio-only CI step. It analyzes published KEMAR coefficients at 380 combinations (44.1/48 kHz × five azimuths × two ears × 19 frequencies from 125–8000 Hz); reports original coherent MID coloration and verifies exactly centered response and unchanged stereo-SIDE transfer after algebraic correction. The Action artifact includes a downloadableKEMAR-SPECTRAL-AUDIT.csv. No realtime FFT, extra convolution, GUI control, state ABI change or patented code. This is not externalization qualification; blind headphone/dearVR matched A/B remains necessary. This checkpoint must pass before merge.