boson-lv / spafe

:sound: spafe: Simplified Python Audio Features Extraction

Spafe

Simplified Python Audio Features Extraction

Table of Contents

• Structure
  • Filter banks
  • Spectrograms
  • Features
  • Frequencies
• Installation
  • Dependencies
  • Installation guide
• How to use
• Contributing
• Citing

Structure

spafe aims to simplify feature extractions from mono audio files. Spafe includes various computations related to filter banks, spectrograms, frequencies and cepstral features . The library has the following structure:

Filter banks

• Bark filter banks
• Gammatone filter banks
• Linear filter banks
• Mel filter banks

Spectrograms

• Bark spectrogram
• CQT spectrogram
• Erb spectrogram
• Mel spectrogram

Features

• Bark Frequency Cepstral Coefficients (BFCCs)
• Constant Q-transform Cepstral Coefficients (CQCCs)
• Gammatone Frequency Cepstral Coefficients (GFCCs)
• Linear Frequency Cepstral Coefficients (LFCCs)
• Linear Prediction Components (LPCs)
• Mel Frequency Cepstral Coefficients (MFCCs)
• Inverse Mel Frequency Cepstral Coefficients (IMFCCs)
• Magnitude based Spectral Root Cepstral Coefficients (MSRCCs)
• Normalized Gammachirp Cepstral Coefficients (NGCCs)
• Power-Normalized Cepstral Coefficients (PNCCs)
• Phase based Spectral Root Cepstral Coefficients (PSRCCs)
• Perceptual Linear Prediction Coefficents (PLPs)
• Rasta Perceptual Linear Prediction Coefficents (RPLPs)

The theory behind features computed using spafe can be summmarized in the following graph:

Frequencies

• Dominant frequencies
• Fundamental frequencies

Installation

Dependencies

spafe requires:

• Python (>= 3.5)
• NumPy (>= 1.22.0)
• SciPy (>= 1.8.0)

if you want to use the visualization module/ functions of spafe, you will need to install:

• Matplotlib (>= 3.5.2)

Installation guide

Once you have the Dependencies installed, use one of the following install options.

Install from PyPI

• To freshly install spafe:

pip install spafe

• To update an existing installation:

pip install -U spafe

Install from Anaconda

• Spafe is also available on anaconda:

conda install spafe

Install from source

• You can build spafe from source, by following:

git clone [email protected]:SuperKogito/spafe.git
cd spafe
python setup.py install

How to use

Various examples on how to use spafe are present in the documentation https://superkogito.github.io/spafe.

<!> Please make sure you are referring to the correct documentation version.

Contributing

Contributions are welcome and encouraged. To learn more about how to contribute to spafe please refer to the Contributing guidelines

Citing

• If you want to cite spafe as a software used in your work, please cite the version used as indexed at Zenodo: