Skip to content

chris-hld/spaudiopy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

e4a66a8 · Dec 22, 2024
Jul 21, 2023
Nov 18, 2021
Nov 22, 2024
Feb 5, 2024
Dec 22, 2024
Nov 5, 2024
Dec 14, 2021
Mar 2, 2023
Feb 4, 2019
Sep 1, 2020
Nov 22, 2024

Repository files navigation

spaudiopy

Documentation Status PyPI version Cross-Platform Test

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.