Ein Python-Paket für Musik- und Audioanalyse.
soundfile
audioread
apt get
)yum
)Unter https://librosa.org/doc/ finden Sie ein vollständiges Referenzhandbuch und Einführungs-Tutorials.
Die erweiterte Beispielgalerie soll Ihnen einen schnellen Eindruck davon vermitteln, was librosa alles kann.
Zurück nach oben ↥
Die neueste stabile Version ist auf PyPI verfügbar und Sie können sie installieren, indem Sie sagen
python -m pip install librosa
Anaconda-Benutzer können mit conda-forge
installieren:
conda install -c conda-forge librosa
Zum Beispiel, um Librosa aus der Quelle aufzubauen
python setup.py build
Dann, sagen wir, um librosa zu installieren
python setup.py install
Wenn alles gut gelaufen ist, sollten Sie in der Lage sein, die folgenden Befehle von einer Python-Konsole aus auszuführen:
import librosa
librosa.show_versions()
Dadurch sollte eine Beschreibung Ihrer Softwareumgebung zusammen mit den installierten Versionen anderer von librosa verwendeter Pakete ausgedruckt werden.
Benutzer von OS X sollten der unten angegebenen Installationsanleitung folgen.
Alternativ können Sie das Repository herunterladen oder klonen und pip
verwenden, um Abhängigkeiten zu verwalten:
unzip librosa.zip
python -m pip install -e librosa
oder
git clone https://github.com/librosa/librosa.git
python -m pip install -e librosa
Wenn Sie pip list
aufrufen, sollten Sie librosa
jetzt als installiertes Paket sehen:
librosa (0.x.x, /path/to/librosa)
Zurück nach oben ↥
librosa
verwendet soundfile
und audioread
um Audiodateien zu laden.
Beachten Sie, dass ältere Versionen von soundfile
(vor 0.11) MP3 nicht unterstützen, was dazu führt, dass librosa auf die audioread
-Bibliothek zurückgreift.
soundfile
Wenn Sie conda
zur Installation von librosa verwenden, werden Abhängigkeiten von der Audiokodierung automatisch gehandhabt.
Wenn Sie pip
in einer Linux-Umgebung verwenden, müssen Sie libsndfile
möglicherweise manuell installieren. Weitere Informationen finden Sie in der SoundFile-Installationsdokumentation.
audioread
und MP3-Unterstützung Um audioread
mit mehr Audio-Dekodierungsleistung zu versorgen (z. B. zum Lesen von MP3-Dateien), müssen Sie möglicherweise entweder ffmpeg oder GStreamer installieren.
Beachten Sie, dass audioread
auf einigen Plattformen mindestens eines der Programme benötigt, um ordnungsgemäß zu funktionieren.
Wenn Sie Anaconda verwenden, installieren Sie ffmpeg per Aufruf
conda install -c conda-forge ffmpeg
Wenn Sie Anaconda nicht verwenden, finden Sie hier einige allgemeine Befehle für verschiedene Betriebssysteme:
apt-get
): apt-get install ffmpeg
oder
apt-get install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
yum
): yum install ffmpeg
oder
yum install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
brew install ffmpeg
oder
brew install gstreamer
Laden Sie ffmpeg-Binärdateien von dieser Website oder gstreamer-Binärdateien von dieser Website herunter
Für GStreamer müssen Sie auch die Python-Bindungen mit installieren
python -m pip install pygobject
Zurück nach oben ↥
Bitte richten Sie Fragen und Diskussionsthemen, die nichts mit der Entwicklung zu tun haben, an unser Webforum unter https://groups.google.com/forum/#!forum/librosa
Zurück nach oben ↥
Wenn Sie librosa in einer wissenschaftlichen Arbeit zitieren möchten, gibt es zwei Möglichkeiten.
Wenn Sie die Bibliothek für Ihre Arbeit nutzen, geben Sie aus Gründen der Reproduzierbarkeit bitte die von Ihnen verwendete Version an, die bei Zenodo indiziert ist:
Ab librosa Version 0.10.2 oder höher können Sie auch librosa.cite()
verwenden, um den DOI-Link für jede Version von librosa abzurufen.
Wenn Sie librosa wegen seines Designs, seiner Motivation usw. zitieren möchten, zitieren Sie bitte den auf SciPy 2015 veröffentlichten Artikel:
McFee, Brian, Colin Raffel, Dawen Liang, Daniel PW Ellis, Matt McVicar, Eric Battenberg und Oriol Nieto. „librosa: Audio- und Musiksignalanalyse in Python.“ In Proceedings of the 14th Python in Science Conference, S. 18-25. 2015.
Zurück nach oben ↥