Un package python pour l'analyse musicale et audio.
soundfile
audioread
apt get
)yum
)Voir https://librosa.org/doc/ pour un manuel de référence complet et des didacticiels d'introduction.
La galerie d'exemples avancés devrait vous donner une idée rapide du genre de choses que librosa peut faire.
Retour en haut ↥
La dernière version stable est disponible sur PyPI et vous pouvez l'installer en disant
python -m pip install librosa
Les utilisateurs d'Anaconda peuvent installer en utilisant conda-forge
:
conda install -c conda-forge librosa
Pour construire librosa à partir des sources, disons
python setup.py build
Ensuite, pour installer librosa, disons
python setup.py install
Si tout s'est bien passé, vous devriez pouvoir exécuter les commandes suivantes depuis une console python :
import librosa
librosa.show_versions()
Cela devrait imprimer une description de votre environnement logiciel, ainsi que les versions installées des autres packages utilisés par librosa.
Les utilisateurs d'OS X doivent suivre le guide d'installation ci-dessous.
Alternativement, vous pouvez télécharger ou cloner le référentiel et utiliser pip
pour gérer les dépendances :
unzip librosa.zip
python -m pip install -e librosa
ou
git clone https://github.com/librosa/librosa.git
python -m pip install -e librosa
En appelant pip list
vous devriez maintenant voir librosa
comme un package installé :
librosa (0.x.x, /path/to/librosa)
Retour en haut ↥
librosa
utilise soundfile
et audioread
pour charger des fichiers audio.
Notez que les anciennes versions de soundfile
(antérieures à 0.11) ne prennent pas en charge le MP3, ce qui obligera librosa à recourir à la bibliothèque audioread
.
soundfile
Si vous utilisez conda
pour installer librosa, les dépendances d'encodage audio seront gérées automatiquement.
Si vous utilisez pip
dans un environnement Linux, vous devrez peut-être installer libsndfile
manuellement. Veuillez vous référer à la documentation d'installation de SoundFile pour plus de détails.
audioread
et des MP3 Pour alimenter audioread
avec plus de puissance de décodage audio (par exemple, pour lire des fichiers MP3), vous devrez peut-être installer ffmpeg ou GStreamer .
Notez que sur certaines plateformes, audioread
a besoin d'au moins un des programmes pour fonctionner correctement.
Si vous utilisez Anaconda, installez ffmpeg en appelant
conda install -c conda-forge ffmpeg
Si vous n'utilisez pas Anaconda, voici quelques commandes courantes pour différents systèmes d'exploitation :
apt-get
) : apt-get install ffmpeg
ou
apt-get install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
yum
): yum install ffmpeg
ou
yum install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
brew install ffmpeg
ou
brew install gstreamer
téléchargez les binaires ffmpeg à partir de ce site Web ou les binaires gstreamer à partir de ce site Web
Pour GStreamer, vous devez également installer les liaisons Python avec
python -m pip install pygobject
Retour en haut ↥
Veuillez adresser les questions non liées au développement et les sujets de discussion à notre forum Web à l'adresse https://groups.google.com/forum/#!forum/librosa.
Retour en haut ↥
Si vous souhaitez citer librosa dans un ouvrage scientifique, il existe deux manières de le faire.
Si vous utilisez la bibliothèque pour votre travail, par souci de reproductibilité, merci de citer la version que vous avez utilisée telle qu'indexée sur Zenodo :
À partir de la version 0.10.2 de librosa ou d'une version ultérieure, vous pouvez également utiliser librosa.cite()
pour obtenir le lien DOI pour n'importe quelle version de librosa.
Si vous souhaitez citer librosa pour sa conception, sa motivation, etc., veuillez citer l'article publié lors de SciPy 2015 :
McFee, Brian, Colin Raffel, Dawen Liang, Daniel PW Ellis, Matt McVicar, Eric Battenberg et Oriol Nieto. "librosa : analyse des signaux audio et musicaux en python." Dans Actes de la 14e conférence Python in Science, pp. 2015.
Retour en haut ↥