arry1138 / spaudiopy

Spatial Audio Python Package

spaudiopy

Spatial Audio Python Package.

The focus (so far) is on spatial audio encoders and decoders. The package includes e.g. spherical harmonics processing and (binaural renderings of) loudspeaker decoders, such as VBAP and AllRAD.

Documentation

You can find the latest package documentation here:
https://spaudiopy.readthedocs.io/

Some details about the implementation can be found in my thesis, or just contact me.

Quickstart

It's easiest to start with something like Anaconda as a Python distribution. You'll need Python >= 3.6 .

You can simply install the latest release with pip:
pip install spaudiopy

This also works for the latest commit:
pip install git+https://github.com/chris-hld/spaudiopy.git@master

From Source

Alternatively, if you want to go into detail and install the package from source:

1. Create a conda environment, called e.g. 'spaudio':
   conda create --name spaudio python=3.8 anaconda portaudio
2. Activate this new environment:
   conda activate spaudio

Get the latest source code from GitHub:
git clone https://github.com/chris-hld/spaudiopy.git && cd spaudiopy

Install the package and remaining dependencies:
pip install -e .

Contributions

This is meant to be an open project and contributions or feature requests are always welcome!

Some functions are also (heavily) inspired by other packages, e.g. https://github.com/polarch/Spherical-Harmonic-Transform, https://github.com/spatialaudio/sfa-numpy, https://github.com/AppliedAcousticsChalmers/sound_field_analysis-py .

Licence

MIT -- see the file LICENSE for details.