/c_speech_features

A port of python_speech_features to C.

Primary LanguageCOtherNOASSERTION

C Speech Features

This library is a complete port of python_speech_features to C.

Usage

Clone this repository in your C/C++ project:

git clone https://github.com/cwiiis/c_speech_features

and add these files to your build:

c_speech_features.c
kiss_fft130/kiss_fft.c
kiss_fft130/tools/kiss_fftr.c

Alternatively, you can build shared and static libraries to use with your project instead of importing the files directly. Using cmake, from within a check-out:

cmake -DCMAKE_C_FLAGS="-O2" -DCMAKE_INSTALL_PREFIX="/usr/local" -DENABLE_DOUBLE=OFF
make

This will result in libc_speech_features.so and libc_speech_features_static.a being built (or platform equivalents), which you can link in your project. An install target is also provided, allowing system-wide use of the library, but this is not recommended.

Refer to c_speech_features.h for documentation.

Bindings

Python

Building python bindings requires SWIG and numpy. Run:

python setup.py install

This will build and install the statically linked c_speech_features module, which can then be used in any python script. Refer to python/test/test.py to see examples of its use. For the most part, it is a drop-in replacement for python_speech_features.

Differences to python_speech_features

  • c_speech_features only supports one datatype, which is defined at compile-time. Currently, this can be either 32-bit (float), or 64-bit (double). python_speech_features operates in 64-bit by default.
  • The winfunc parameter is an array instead of a function, and is expected to be as wide as necessary depending on context.

Uses

It is not recommended to replace python_speech_features with c_speech_features in a Python context. python_speech_features is safer and will output better error messages when fed with incorrect parameters. c_speech_features is most likely to crash in such situations. On the other hand, this module can be useful to debug issues when using c_speech_features in more appropriate contexts, or if you have very specific needs. c_speech_features is likely to perform faster when compiled with optimisation than python_speech_features. In 64-bit, the gains are minimal, except for particular functions, where as in 32-bit the gains can be substantial (at the cost of precision).