Make SOFA room processing optional and self-contained

SOFA and explicit .jochrtf inputs now render direct sound by default.
--sofa-room enables the project image-source/FDN room, with the compact
preset for Near/Mid and the original large room for Far.

- preserve native HRIR timing and apply Data.Delay once
- remove external reference configuration, radial head synthesis and the
  artificial centre response
- ship both generated float64 room assets and their generator
- retain .jochrtf as an explicit lightweight input and offline export
- keep personalized headphone processing unchanged and update bilingual
  documentation

Checked: independent direct/reflection convolution, FDN FIR/recursive
agreement, fractional delay and metadata timing, chunk invariance,
8 bit-exact personalized regressions, CLI smoke tests, and full-song
D1/D2 renders of two tracks.
This commit is contained in:
TheM14 committed 2026-11-01 15:26:08 +08:00
1 parent 26e84569c2
commit 3ea285e407
19 files changed
+861 -1134

No files matched your search

+22 -2
View File
@@ -4,6 +4,26 @@
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
@@ -21,8 +41,8 @@ joc_huff_code_7ch_pos_index_sparse int64[6,2]
## Binaural rendering tables
`rosella_kernels.npz` contains the fixed 64-QMF/77-hybrid tables used by the
public SOFA binaural path:
`rosella_kernels.npz` contains the fixed 64-QMF/77-hybrid tables used by
`.jochrtf` rendering and personalized bank 1. Full SOFA rendering uses PCM convolution:
```text
format_version little-endian int32[1]