Un paquete de Python para análisis de música y audio.
soundfile
audioread
apt get
)yum
)Consulte https://librosa.org/doc/ para obtener un manual de referencia completo y tutoriales introductorios.
La galería de ejemplos avanzados debería darle una idea rápida de los tipos de cosas que librosa puede hacer.
Volver arriba ↥
La última versión estable está disponible en PyPI y puede instalarla diciendo
python -m pip install librosa
Los usuarios de Anaconda pueden instalar usando conda-forge
:
conda install -c conda-forge librosa
Para construir librosa desde la fuente, digamos
python setup.py build
Luego, para instalar librosa, diga
python setup.py install
Si todo salió bien, deberías poder ejecutar los siguientes comandos desde una consola de Python:
import librosa
librosa.show_versions()
Esto debería imprimir una descripción de su entorno de software, junto con las versiones instaladas de otros paquetes utilizados por librosa.
Los usuarios de OS X deben seguir la guía de instalación que se proporciona a continuación.
Alternativamente, puedes descargar o clonar el repositorio y usar pip
para manejar las dependencias:
unzip librosa.zip
python -m pip install -e librosa
o
git clone https://github.com/librosa/librosa.git
python -m pip install -e librosa
Al llamar pip list
deberías ver librosa
ahora como un paquete instalado:
librosa (0.x.x, /path/to/librosa)
Volver arriba ↥
librosa
utiliza soundfile
y audioread
para cargar archivos de audio.
Tenga en cuenta que las versiones anteriores de soundfile
(anteriores a 0.11) no son compatibles con MP3, lo que hará que librosa recurra a la biblioteca audioread
.
soundfile
Si estás usando conda
para instalar librosa, las dependencias de codificación de audio se manejarán automáticamente.
Si está utilizando pip
en un entorno Linux, es posible que necesite instalar libsndfile
manualmente. Consulte la documentación de instalación de SoundFile para obtener más detalles.
audioread
y MP3 Para alimentar audioread
con más potencia de decodificación de audio (por ejemplo, para leer archivos MP3), es posible que necesite instalar ffmpeg o GStreamer .
Tenga en cuenta que en algunas plataformas, audioread
necesita al menos uno de los programas para funcionar correctamente.
Si está utilizando Anaconda, instale ffmpeg llamando
conda install -c conda-forge ffmpeg
Si no está utilizando Anaconda, aquí hay algunos comandos comunes para diferentes sistemas operativos:
apt-get
): apt-get install ffmpeg
o
apt-get install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
yum
): yum install ffmpeg
o
yum install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
brew install ffmpeg
o
brew install gstreamer
descargue los binarios de ffmpeg desde este sitio web o los binarios de gstreamer desde este sitio web
Para GStreamer, también necesita instalar los enlaces de Python con
python -m pip install pygobject
Volver arriba ↥
Dirija las preguntas que no sean de desarrollo y los temas de discusión a nuestro foro web en https://groups.google.com/forum/#!forum/librosa
Volver arriba ↥
Si desea citar librosa en un trabajo académico, hay dos formas de hacerlo.
Si está utilizando la biblioteca para su trabajo, en aras de la reproducibilidad, cite la versión que utilizó tal como está indexada en Zenodo:
Desde la versión 0.10.2 de librosa o posterior, también puede usar librosa.cite()
para obtener el enlace DOI para cualquier versión de librosa.
Si desea citar a librosa por su diseño, motivación, etc., cite el artículo publicado en SciPy 2015:
McFee, Brian, Colin Raffel, Dawen Liang, Daniel PW Ellis, Matt McVicar, Eric Battenberg y Oriol Nieto. "librosa: Análisis de señales de audio y música en Python". En Actas de la 14.ª conferencia sobre Python en la ciencia, págs. 18-25. 2015.
Volver arriba ↥