Tree [181a49] master /
History



File Date Author Commit
cmake-modules 2014-03-27 Paul Brossier Paul Brossier [343d1d] CMakeLists.txt: use local Eigen3 if available
doc 2015-01-13 Thomas Fillon Thomas Fillon [181a49] Update changelog.rst
externals 2014-03-18 Paul Brossier Paul Brossier [e53287] externals/audio-smarc/Makefile: add CFLAGS and ...
matlab 2011-11-07 Benoit Mathieu Benoit Mathieu [8654f6] initial import, published version 0.63
resources 2011-11-07 Benoit Mathieu Benoit Mathieu [8654f6] initial import, published version 0.63
src_cpp 2014-05-04 Matthew Taylor Matthew Taylor [38a3dc] Renames 'end' to 'the_end'.
src_python 2014-03-27 Thomas Fillon Thomas Fillon [5db5aa] Update yaafelib/core.py to reflect renaming of ...
.gitignore 2014-03-27 Paul Brossier Paul Brossier [877e28] .gitignore: re-add doc/build
CITATION.rst 2014-04-01 Thomas Fillon Thomas Fillon [3eec4d] Update markup in CITATION.rst
CMakeLists.txt 2015-01-13 Thomas Fillon Thomas Fillon [0e94e1] Change version to 0.65
COPYING 2011-11-07 Benoit Mathieu Benoit Mathieu [8654f6] initial import, published version 0.63
COPYING.LESSER 2011-11-07 Benoit Mathieu Benoit Mathieu [8654f6] initial import, published version 0.63
DISCLAIMER 2011-11-07 Benoit Mathieu Benoit Mathieu [8654f6] initial import, published version 0.63
INSTALL_WINDOWS 2014-03-19 Georg Holzmann Georg Holzmann [f19363] windows compilation instructions
README.md 2014-05-05 Matthew Taylor Matthew Taylor [d5bb7e] Cleaned up README and switched to markdown.
install.sh 2011-11-07 Benoit Mathieu Benoit Mathieu [8654f6] initial import, published version 0.63
yaafe-config.cmake 2011-11-07 Benoit Mathieu Benoit Mathieu [8654f6] initial import, published version 0.63

Read Me

Install

Yaafe source code should compile on linux and MacOsX platforms, and uses CMake as a compilation tool.
Yaafe requires third-party libraries to enable specific features. Some of these libraries may already be available on your system.

Dependencies

Required

Optional

Depending on optional features you want to use, other librairies may be used:

  • libsndfile: enable reading WAV files format (highly recommended)
  • libmpg123: enable reading MP3 audio files
  • HDF5 >= 1.8: enable H5 output format
  • liblapack: enable some audio features (LSF)
  • FFTW3: use FFTW instead of Eigen for FFT computations (pay attention to licensing issues when linking with the GPL FFTW3 library).

Once previous libraries are installed (some may have been locally installed in <lib-path>),
you can compile with the following steps:

mkdir build
cd build
ccmake -DCMAKE_PREFIX_PATH=<lib-path> -DCMAKE_INSTALL_PREFIX=<install-path> ..
make
make install

For more compilation options, see the online manual.

Environment

You must set your YAAFE_PATH environment var to the "yaafe_extensions" dir so that yaafe can find available features::

export YAAFE_PATH=$DEST_DIR/yaafe_extensions

To easily use Yaafe, you should set the following environment vars::

export PATH=$PATH:$DEST_DIR/bin
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$DEST_DIR/lib
export PYTHONPATH=$PYTHONPATH:$DEST_DIR/python_packages

On MacOsX replace LD_LIBRARY_PATH by DYLD_LIBRARY_PATH

If you use Matlab, you can set your MATLABPATH var::

export MATLABPATH=$MATLABPATH:$DEST_DIR/matlab

Documentation

Documentation is also available online: http://yaafe.sourceforge.net/

To build documentation, you need Sphinx.
Before building documentation, you should set your environment correctly so that sphinx builds documentation
with automatic features documentation.

To build documentation, just run make doc in the build directory. Documentation is built in doc/html.

License

YAAFE is released under the version 3 of the GNU Lesser General Public License. Read COPYING and COPYING.LESSER for
more details. The user should also read DISCLAIMER before linking with optional libraries which have different license policy.

Support

To get help with YAAFE, use the mailing-list yaafe-users@lists.sourceforge.net (registration
at https://lists.sourceforge.net/lists/listinfo/yaafe-users ).

Credits

Yaafe was first developed at [Telecom Paristech / AAO Team] (http://www.tsi.telecom-paristech.fr/aao/en/). It uses several great open-source projects like [Eigen] (http://eigen.tuxfamily.org/), [Smarc] (http://audio-smarc.sourceforge.net/), [libsndfile] (http://www.mega-nerd.com/libsndfile/), [mpg123] (http://www.mpg123.de/), [HDF5] (http://www.hdfgroup.org/HDF5/).

If you want to cite Yaafe in a publication, please see CITATION <CITATION.rst>_.