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.
|
||||
|
||||
|
||||
Reference in new issue
Block a user