Keep only the Rosella and .jochrtf binaural paths

The runtime renders two inputs now: the Rosella .personalized_headphone model and
an already compiled .jochrtf field. SOFA import, the full-HRIR direct renderer
and the SOFA -> .jochrtf fitting compiler leave this checkout; they continue as
an offline tool that only produces caches this repository loads.

The .jochrtf renderer goes back to the implementation that predates the direct
SOFA work: 64-QMF analysis, 77 hybrid bands, per-object hybrid path delays and
the project room (six first-order images plus the shared FDN tail) computed in
code. It is restored verbatim under the .jochrtf vocabulary
(SofaBinauralBackend -> JochrtfBackend) and gains one switch:
--jochrtf-room on|off, off by default. With the room off the renderer outputs
only the field's direct binaural sound, and in either mode it reads no audio
assets.

Because the room is computed in code again, the generated sofa-room*.npz assets
and the modules only the SOFA path used are removed (sofa_canonical, sofa_hrir,
sofa_direct_backend, sofa_room, hybrid_paths, partitioned_convolution,
point_source, compile_hrtf, generate_sofa_room). data/ keeps the decode tables
and the Rosella filterbanks.

The CLI drops --sofa-hrtf, --hrtf-radius-m, --sofa-interpolation,
--hrtf-cache-policy, --hrtf-cache-dir, --sofa-room, --sofa-room-preset and
--source-reference-distance-m. A .jochrtf is still explicit through
--compiled-hrtf-cache, and the default binaural input is the personalized model.

Rosella parsing, filterbank, room and timing are untouched and its output stays
bit-identical. The .jochrtf path reproduces the pre-SOFA renderer sample for
sample, with the room on and with it off.
This commit is contained in:
TheM14 committed 2026-11-01 19:00:40 +08:00
1 parent 3ea285e407
commit 07a26b41fe
21 files changed
+692 -2309

No files matched your search

-20
View File
@@ -4,26 +4,6 @@
This directory contains static production tables. It does not contain user HRTFs.
SOFA and compact HRTF inputs render direct sound by default. Optional `--sofa-room`
loads generated FIR assets from the original four-line FDN in `public_room.py`.
It contains no HRTF or external-model coefficients. Early reflections use the same
module's six-wall image model and the selected full HRIRs or compact field. Personalized rendering
continues to use its model's room parameters.
Both archives use `sofa-project-room-v1`, 48 kHz and float64. `sofa-room-compact.npz`
contains `[2,37383]` taps and is the Near/Mid default; `sofa-room.npz` contains
`[2,81600]` taps for the Far default and explicit original-room selection. JSON records
FDN/geometry parameters, coefficient SHA-256 and omitted tail energy.
Compact dimensions follow [model 9 in Zahorik 2009, Table 1](https://pmc.ncbi.nlm.nih.gov/articles/PMC2730711/).
Late time scales follow the V/S ratio of the original project preset; this does not
reproduce the paper's BRIR algorithm. Regenerate both assets with:
```powershell
python src\generate_sofa_room.py
python src\generate_sofa_room.py --preset compact
```
`tables.npz` contains the JOC core decoding tables:
```text