4 This module wraps the aubio library for Python using the numpy module.
6 Before compiling this module, you must have compiled libaubio.
8 For more information about how this module works, please refer to the [Python/C
9 API Reference Manual] (http://docs.python.org/c-api/index.html) and the
10 [Numpy/C API Reference](http://docs.scipy.org/doc/numpy/reference/c-api.html).
12 Compiling python aubio
13 ----------------------
15 After libaubio has been build successfully, and provided Python development
16 headers and numpy can be found on your system, you should be able to build the
21 To find out more about `setup.py` options:
28 To install the Python module:
32 Using the Python module
33 -----------------------
35 Once the aubio library and the Python module are installed, you will be able to
36 import the aubio module:
43 Alternatively, you may want to use the Python module without installing it by
46 $ export PYTHONPATH=$PYTHONPATH:$PWD/`ls -rtd build/lib.* | head -1`:$PWD/tests
48 Similarly, you can use the aubio module without installing libaubio by pointing
49 LD_LIBRARY_PATH to the path libaubio can be found at:
51 $ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$PWD/../build/src
53 Or on Mac OS X systems, setting DYLD_LIBRARY_PATH:
55 $ export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:$PWD/../build/src
57 Testing the Python module
58 -------------------------
60 Once both the C library and the Python module have been built correctly, and
61 after you have installed them (or setting the environment variable correctly),
62 you should be able to run the tests:
64 $ ./tests/run_all_tests
66 And to try out the demos:
68 $ ./demos/demo_source.wav /path/to/sound/sample.wav
70 You need to install additional modules to run some of the demos. For
71 instance, several demos use [matplotlib](http://matplotlib.org/) to draw plots.
72 Some more demos use [PySoundCard](https://github.com/bastibe/PySoundCard) to
73 play and record sounds.