From: Paul Brossier Date: Fri, 22 Jul 2016 19:50:21 +0000 (+0200) Subject: README.md: link to python/README.md X-Git-Tag: 0.4.4~275 X-Git-Url: https://git.aubio.org/?a=commitdiff_plain;h=655150cee58444f28637e5c45b84e3b9f599ddec;p=aubio.git README.md: link to python/README.md --- diff --git a/MANIFEST.in b/MANIFEST.in index a062a1a1..15fd25ac 100644 --- a/MANIFEST.in +++ b/MANIFEST.in @@ -1,5 +1,5 @@ include AUTHORS COPYING README.md VERSION ChangeLog -include python/README +include python/README.md include Makefile wscript */wscript_build include waf include aubio.pc.in diff --git a/README.md b/README.md index 70a995be..90680858 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,8 @@ Python module ------------- A python module to access the library functions is also provided. Please see -the file `python/README` for more information on how to use it. +the file [`python/README.md`](python/README.md) for more information on how to +use it. Examples tools -------------- diff --git a/python/README b/python/README deleted file mode 100644 index d28b7ea5..00000000 --- a/python/README +++ /dev/null @@ -1,64 +0,0 @@ -Python aubio module -=================== - -This module wraps the aubio library for Python using the numpy module. - -Before compiling this module, you must have compiled libaubio. - -For more information about how this module works, please refer to the [Python/C -API Reference Manual] (http://docs.python.org/c-api/index.html) and the -[Numpy/C API Reference](http://docs.scipy.org/doc/numpy/reference/c-api.html). - -Compiling python aubio ----------------------- - -After libaubio has been build successfully, and provided Python development -headers and numpy can be found on your system, you should be able to build the -aubio Python module: - - $ ./setup.py build - -To find out more about `setup.py` options: - - $ ./setup.py --help - -Installing ----------- - -To install the Python module: - - $ ./setup.py install - -Using the Python module ------------------------ - -Once the aubio library and the Python module are installed, you will be able to -import the aubio module: - - $ python - [...] - >>> import aubio - >>> - -Alternatively, you may want to use the Python module without installing it by -setting PYTHONPATH: - - $ export PYTHONPATH=$PYTHONPATH:$PWD/`ls -rtd build/lib.* | head -1`:$PWD/tests - -Testing the Python module -------------------------- - -Once both the C library and the Python module have been built correctly, and -after you have installed them (or setting the environment variable correctly), -you should be able to run the tests: - - $ ./tests/run_all_tests - -And to try out the demos: - - $ ./demos/demo_source.py /path/to/sound/sample.wav - -You need to install additional modules to run some of the demos. For -instance, several demos use [matplotlib](http://matplotlib.org/) to draw plots. -Some more demos use [PySoundCard](https://github.com/bastibe/PySoundCard) to -play and record sounds. diff --git a/python/README.md b/python/README.md new file mode 100644 index 00000000..d28b7ea5 --- /dev/null +++ b/python/README.md @@ -0,0 +1,64 @@ +Python aubio module +=================== + +This module wraps the aubio library for Python using the numpy module. + +Before compiling this module, you must have compiled libaubio. + +For more information about how this module works, please refer to the [Python/C +API Reference Manual] (http://docs.python.org/c-api/index.html) and the +[Numpy/C API Reference](http://docs.scipy.org/doc/numpy/reference/c-api.html). + +Compiling python aubio +---------------------- + +After libaubio has been build successfully, and provided Python development +headers and numpy can be found on your system, you should be able to build the +aubio Python module: + + $ ./setup.py build + +To find out more about `setup.py` options: + + $ ./setup.py --help + +Installing +---------- + +To install the Python module: + + $ ./setup.py install + +Using the Python module +----------------------- + +Once the aubio library and the Python module are installed, you will be able to +import the aubio module: + + $ python + [...] + >>> import aubio + >>> + +Alternatively, you may want to use the Python module without installing it by +setting PYTHONPATH: + + $ export PYTHONPATH=$PYTHONPATH:$PWD/`ls -rtd build/lib.* | head -1`:$PWD/tests + +Testing the Python module +------------------------- + +Once both the C library and the Python module have been built correctly, and +after you have installed them (or setting the environment variable correctly), +you should be able to run the tests: + + $ ./tests/run_all_tests + +And to try out the demos: + + $ ./demos/demo_source.py /path/to/sound/sample.wav + +You need to install additional modules to run some of the demos. For +instance, several demos use [matplotlib](http://matplotlib.org/) to draw plots. +Some more demos use [PySoundCard](https://github.com/bastibe/PySoundCard) to +play and record sounds.