Welcome to the documentation of the apollon feature extraction framework!¶
apollon is a feature extraction and modeling framework for music data analysis. It handles low-level audio feature extraction, their aggreagation using Hidden Markov models, and comparison by means of the self-organizing map. See the Framework chapter for gentle introduction to the mentioned concepts.
Contents¶
Download¶
You can either download the source code from the apollon GitHub repository or clone it directly with
git clone https://github.com/teagum/apollon.git
Installation¶
apollon can be installed on GNU/Linux, macOS, and Windows. Installation process is similar on each of these plaforms. Note, however, that apollon contains CPython extension modules, which have to be compiled locally for GNU/Linux and Windows users. If you work on those platforms, please make shure that there is a C compiler set up on your machine; otherwise the installation will fail. In the case of macOS, a precompiled wheel is provided for the latest version only.
Install using pip¶
The Python packager manager can automatically download and install apollon from Pypi. Simply run the following command from your terminal:
python3 -m pip install apollon
Install from source¶
You can also install and compile apollon directly from its sources in three steps:
Download the apollon source code
Open a terminal and navigate to the apollon root directory
Install and compile with the following command
python3 -m pip install .
Framework¶
Audio Feature Extraction¶
Extract some of the most common low-level audio feauters.
Self-Organizing Map¶
Train some Self-organizing maps.