Add the captured Rosella filterbank and select it per bank
The Rosella path now chooses its filterbank. Bank 1 is the public bank
the reference implementation has always used (13 taps / 6 slots,
961 samples); bank 2 is the captured bank the reference headphone
renderer actually runs (11 taps / 3 slots, 448 samples).
- src/rosella_captured_filterbank.py implements the four half-steps in
float64/complex128; the captured prototype, rotation and hybrid
coefficients live in data/rosella_captured_kernels.npz
- src/rosella_bank.py owns the choice: both banks expose the same four
stages, each with its own coefficients, history and latency
- RosellaBinauralRenderer takes filterbank= and derives the startup
skip, the flush capacity and the report fields from it
- --rosella-filterbank 1|2 selects the bank, default 1; it is rejected
for the SOFA and .jochrtf inputs instead of being ignored
- document both banks in docs/rosella_filterbank.{md,en.md}, and point
the binaural docs, the data README and the options tables at it
Checked: the captured stages reproduce the reference vectors the C++
core checks (within 1e-10), an impulse returns at 961 and 448 samples,
and chunking, reset and bank independence hold for both.
This commit is contained in:
1 parent
247e2a90b6
commit
0e98e91762
13 files changed
+606
-24
No files matched your search
@@ -72,6 +72,25 @@ $$Y_p = \sum_{q\in C_p}\Bigl(\operatorname{Re}X_q + j\,s_q\,\operatorname{Im}X_q
|
||||
The same values also appear in other public implementations of these standards
|
||||
(for example FFmpeg's `aacps_tablegen.h` and `aacsbrdata.h`).
|
||||
|
||||
### Captured Rosella filterbank
|
||||
|
||||
`rosella_captured_kernels.npz` holds the bank the reference headphone renderer
|
||||
actually runs (`--rosella-filterbank 2`):
|
||||
|
||||
```text
|
||||
format_version little-endian int32[1]
|
||||
qmf_prototype float32[64,10]
|
||||
rotation complex64[64]
|
||||
hybrid complex64[22]
|
||||
```
|
||||
|
||||
The table values are promoted to float64/complex128 on load. The full
|
||||
analysis/synthesis latency is 448 samples (961 for the public bank). These
|
||||
values come from runtime buffer captures of the reference renderer, not from the
|
||||
public standards above; the C++ core compiles the same data in as
|
||||
`src/hrtf/rosella_filterbank_tables.h`. This file also contains no personalized
|
||||
HRTF or room tuning.
|
||||
|
||||
Public availability of a standard does not by itself grant permission to
|
||||
practice related patent claims.
|
||||
|
||||
|
||||
@@ -64,6 +64,23 @@ $$Y_p = \sum_{q\in C_p}\Bigl(\operatorname{Re}X_q + j\,s_q\,\operatorname{Im}X_q
|
||||
|
||||
相同数值可在 FFmpeg(`aacps_tablegen.h`、`aacsbrdata.h`)等公开实现中查到。
|
||||
|
||||
### Rosella 捕获版滤波器组
|
||||
|
||||
`rosella_captured_kernels.npz` 保存参考头戴渲染器实际运行的那套滤波器组
|
||||
(`--rosella-filterbank 2`):
|
||||
|
||||
```text
|
||||
format_version little-endian int32[1]
|
||||
qmf_prototype float32[64,10]
|
||||
rotation complex64[64]
|
||||
hybrid complex64[22]
|
||||
```
|
||||
|
||||
表值载入后提升为 float64/complex128;全链 latency 为 448 samples(公开版为 961)。
|
||||
这些数值来自参考渲染器的运行时缓冲捕获,不是上述公开标准的推导值;C++ 内核以
|
||||
`src/hrtf/rosella_filterbank_tables.h` 的形式内置同一组数据。文件同样不含个性化
|
||||
HRTF 或 room 调参。
|
||||
|
||||
标准可公开获取不等于获准实施相关专利。
|
||||
|
||||
`.sofa` 是用户可见的 source of truth;`.jochrtf` 是可删除、可从 SOFA 重建的
|
||||
|
||||
Binary file not shown.
Reference in new issue
Block a user