https://github.com/jarmitage/resonators
Resonant filter bank synthesis on Bela based on [resonators~] Max/Pd object
https://github.com/jarmitage/resonators
audio bela belaplatform cpp filters maxmsp puredata resonators synthesis
Last synced: 2 months ago
JSON representation
Resonant filter bank synthesis on Bela based on [resonators~] Max/Pd object
- Host: GitHub
- URL: https://github.com/jarmitage/resonators
- Owner: jarmitage
- Created: 2019-03-29T15:54:32.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2022-03-31T15:47:31.000Z (about 3 years ago)
- Last Synced: 2025-03-17T11:55:01.426Z (2 months ago)
- Topics: audio, bela, belaplatform, cpp, filters, maxmsp, puredata, resonators, synthesis
- Language: C++
- Size: 473 KB
- Stars: 18
- Watchers: 1
- Forks: 3
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Resonators
Resonant filter bank synthesis on Bela based on the [[resonators~] Max/Pd object](https://github.com/CNMAT/CNMAT-Externs/blob/6f0208d3a1/src/resonators~/resonators~.c):
```cpp
#include
#include "Resonators.h"
#include "Model.h"
ResonatorBank resBank;
ResonatorBankOptions resBankOptions = {};
ModelLoader model;
bool setup(BelaContext *context, void *userData) {
model.load("models/marimba.json");
resBankOptions.total = model.getSize();
resBank.setup(resBankOptions, context->audioSampleRate, context->audioFrames);
resBank.setBank(model.get());
resBank.update();
return true;
}
void render(BelaContext *context, void *userData) {
for (unsigned int n = 0; n < context->audioFrames; ++n) {
float in = audioRead(context, n, 0); // an excitation signal
float out = resBank.render(in);
audioWrite(context, n, 0, out);
audioWrite(context, n, 1, out);
}
}
```
The corresponding `marimba.json`:
```javascript
{
"metadata": {
"name": "marimba",
"fundamental": 800,
"resonators": 8
},
"resonators": [
{ "freq": 800, "gain": 0.500000, "decay": 0.2 },
{ "freq": 1600, "gain": 0.033333, "decay": 0.4 },
{ "freq": 2400, "gain": 0.016666, "decay": 0.6 },
{ "freq": 3200, "gain": 0.006666, "decay": 0.7 },
{ "freq": 4000, "gain": 0.003333, "decay": 0.8 },
{ "freq": 4800, "gain": 0.001666, "decay": 0.9 },
{ "freq": 5400, "gain": 0.000666, "decay": 1.0 },
{ "freq": 6200, "gain": 0.000333, "decay": 1.0 }
]
}
```
---
### Bela examples
1. An individual resonator.
2. A bank of resonators based on a model file.
3. Loading updated models periodically into a bank of resonators via `scp`.
4. Multiple banks of resonators based on a model file, tranposed up a scale.
5. Combination of examples 3 & 4, plus Bela scope for inputs.
---
### Resonance models
Collection of ~100 resonance models of mostly percussion instruments, based on [aLib resonance models](http://alimomeni.net/project/alib-resonance-models/)
- Indian percussion instruments (Chakoa, Dhalki, Hand-Dhal, khol, Madal, Manjeera, Mirdangam, Stick-Dhal)
- A set of 12 Ghanaian double-bells, recorded with hard and soft beater
- Guitar strings plucked behind the bridge
- SampleCell Dumbeck, Gong
---
### `p5.js` GUI
WIP! Relies on Bela WebSocket server wrapper and integration with `Resonator.h`.
- `BelaWS.js`: connects to Bela over a Web Socket
- `Resonators.js`: real-time bidirectional updating of resonator model, using `p5.js`
---
### Jupyter & Python
Some convenience functions, not pretty yet...
- Importing Max/Pd formatted models (see references below)
- Working with models as Pandas dataframes
- Loading/saving/converting to/from `.csv` `.coll` & `.json`
- `scp`-ing models to Bela for real-time updates
---
### Max/Pd References
- Max version: https://github.com/CNMAT/CNMAT-Externs/releases/tag/v1.0.4 (resonators~.mxo)
- Pd example patches: https://github.com/batchku/aLib/tree/master/for%20resonators
- Example resonance models: http://alimomeni.net/project/alib-resonance-models
---
### Python Bindings
Bindings for Python are available via [Swig](http://www.swig.org/), meaning Resonators can be used from a Python script or a Jupyter notebook:
```python
model = resonators.ModelLoader()
model.load(args.model_path)
rb_ops = resonators.ResonatorBankOptions()
rb_ops.total = model.getSize()
rb = resonators.ResonatorBank()
rb.setup(rb_ops, 44100.0, 128)
rb.setBank(model.getShiftedToNote("c4"))
rb.update()
out = rb.render(0.5)
```
- At the top level directory, run `cmake .`, and then `make`.
- If this succeeds, run `py/test_bindings.py` to confirm.
- For now, you can crudely `sys.path.append` the directory to import the module.
_Note_: this has been tested with Python 3.6.5 (and should support Python 2.7+), SWIG 4.0.0 and CMake 3.14.3 on OSX 10.14.
---
### License
Unless otherwise stated, [CC0](https://creativecommons.org/share-your-work/public-domain/cc0/).
---
### TODO
##### Resonators
- More comprehensive comments/documentation
- Add examples for real-time manipulation of model parameters
- Add functions for useful/interesting real-time variation of model parameters
##### Models
- Real-time functions for simple scaling of `gain` and `decay` parameters
- Generate models (offline) based on samples (using [HPSS](http://librosa.github.io/librosa/generated/librosa.decompose.hpss.html)?)
##### Data analysis/offline exploration
[x] Python bindings for `Resonators.cpp` for offline synthesis (merged [05c089c](https://github.com/jarmitage/resonators/commit/291681df3f56fd44a8118ba048b1ceeae8ed7749))
- Clean up Python utils
- Add Jupyter notebook examples
##### p5.js
- Refactor the `p5.js` sketch to work with [topic/p5-gui](https://github.com/adanlbenito/Bela/tree/topic/p5-gui)