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:
1 parent
26e84569c2
commit
3ea285e407
19 files changed
+861
-1134
No files matched your search
+22
-2
@@ -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
@@ -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.
Reference in new issue
Block a user