Installing aubio for Python¶
aubio is available as a package for Python 2.7 and Python 3. The aubio extension is written C using the Python/C and the Numpy/C APIs.
For general documentation on how to install Python packages, see Installing Packages.
Installing aubio with pip¶
aubio can be installed from PyPI using pip
:
$ pip install aubio
See also Installing from PyPI for general documentation.
Note
aubio is currently a source only package, so you will need a compiler to install it from PyPI. See also Installing aubio with conda for pre-compiled binaries.
Installing aubio with conda¶
Conda packages are available through the conda-forge channel for Linux, macOS, and Windows:
$ conda config --add channels conda-forge
$ conda install -c conda-forge aubio
Double precision¶
This module can be compiled in double-precision mode, in which case the default type for floating-point samples will be 64-bit. The default is single precision mode (32-bit, recommended).
To build the aubio module with double precision, use the option –enable-double of the build_ext subcommand:
$ ./setup.py clean
$ ./setup.py build_ext --enable-double
$ pip install -v .
Note: If linking against libaubio, make sure the library was also compiled in Double precision mode.
Checking your installation¶
Once the python module is installed, its version can be checked with:
$ python -c "import aubio; print(aubio.version, aubio.float_type)"
The command line aubio is also installed:
$ aubio -h
Python tests¶
A number of Python tests are provided in the python/tests folder. To run them, install pytest and run it from the aubio source directory:
$ pip install pytest
$ git clone https://git.aubio.org/aubio/aubio
$ cd aubio
$ pytest