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]
+17 -1
View File
@@ -4,6 +4,22 @@
本目录保存 Python 生产路径使用的静态表数据,不保存用户 HRTF。
SOFA与压缩HRTF输入默认仅渲染直达声。可选`--sofa-room`读取下列资产,由原项目`public_room.py`中的同一四路FDN独立生成,不包含HRTF或外部模型系数。早反射按资产记录的几何使用同一六面镜像算法计算,随后使用所选完整HRIR或压缩方向场。个性化路线继续读取其模型自身的房间参数。
格式均为`sofa-project-room-v1`,采样率48 kHz。JSON记录FDN及几何参数、系数SHA-256和截断尾能量。
| 文件 | 预设 | `late_fir` |
|---|---|---|
| `sofa-room-compact.npz` | Near/Mid默认紧凑房间 | `float64[2,37383]` |
| `sofa-room.npz` | Far默认/可显式选择的原大房间 | `float64[2,81600]` |
紧凑预设的尺寸取自[Zahorik 2009表1的模型9](https://pmc.ncbi.nlm.nih.gov/articles/PMC2730711/),晚期时间尺度按本项目原预设的`V/S`比例缩放;它不是对论文BRIR的完整复现。可重生成两套资产:
```powershell
python src\generate_sofa_room.py
python src\generate_sofa_room.py --preset compact
```
`tables.npz` 保存 JOC 核心解码表:
```text
@@ -21,7 +37,7 @@ joc_huff_code_7ch_pos_index_sparse int64[6,2]
## 双耳渲染表
`rosella_kernels.npz` 保存公开 SOFA 双耳路径使用的 64-QMF/77-hybrid 固定表:
`rosella_kernels.npz` 保存`.jochrtf`压缩渲染和个性化bank 1使用的64-QMF/77-hybrid固定表;完整SOFA路线直接在PCM域卷积:
```text
format_version little-endian int32[1]
Binary file not shown.
Binary file not shown.