Пакет Python для анализа музыки и аудио.
soundfile
audioread
apt get
)yum
)См. https://librosa.org/doc/ для получения полного справочного руководства и вводных руководств.
Расширенная галерея примеров должна дать вам быстрое представление о том, что может делать librosa.
Вернуться наверх ↥
Последняя стабильная версия доступна на PyPI, и вы можете установить ее, сказав:
python -m pip install librosa
Пользователи Anaconda могут установить с помощью conda-forge
:
conda install -c conda-forge librosa
Чтобы собрать librosa из исходного кода, скажем
python setup.py build
Затем, чтобы установить librosa, скажем
python setup.py install
Если все прошло хорошо, вы сможете выполнить следующие команды из консоли Python:
import librosa
librosa.show_versions()
При этом должно быть распечатано описание вашей программной среды, а также установленные версии других пакетов, используемых librosa.
Пользователи OS X должны следовать инструкциям по установке, приведенным ниже.
Альтернативно вы можете скачать или клонировать репозиторий и использовать pip
для обработки зависимостей:
unzip librosa.zip
python -m pip install -e librosa
или
git clone https://github.com/librosa/librosa.git
python -m pip install -e librosa
Вызвав pip list
вы должны увидеть librosa
как установленный пакет:
librosa (0.x.x, /path/to/librosa)
Вернуться наверх ↥
librosa
использует soundfile
и audioread
для загрузки аудиофайлов.
Обратите внимание, что более старые версии soundfile
(до 0.11) не поддерживают MP3, что приведет к тому, что librosa вернется к использованию библиотеки audioread
.
soundfile
Если вы используете conda
для установки librosa, зависимости кодирования звука будут обрабатываться автоматически.
Если вы используете pip
в среде Linux, вам может потребоваться установить libsndfile
вручную. Подробную информацию см. в документации по установке SoundFile.
audioread
и поддержка MP3 Чтобы обеспечить audioread
большей мощностью декодирования звука (например, для чтения файлов MP3), вам может потребоваться установить ffmpeg или GStreamer .
Обратите внимание, что на некоторых платформах для правильной работы audioread
требуется хотя бы одна из программ.
Если вы используете Anaconda, установите ffmpeg, вызвав
conda install -c conda-forge ffmpeg
Если вы не используете Anaconda, вот несколько общих команд для разных операционных систем:
apt-get
): apt-get install ffmpeg
или
apt-get install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
yum
): yum install ffmpeg
или
yum install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
brew install ffmpeg
или
brew install gstreamer
загрузите двоичные файлы ffmpeg с этого сайта или двоичные файлы gstreamer с этого сайта
Для GStreamer вам также необходимо установить привязки Python с помощью
python -m pip install pygobject
Вернуться наверх ↥
Пожалуйста, направляйте вопросы, не связанные с разработкой, и темы для обсуждения на наш веб-форум по адресу https://groups.google.com/forum/#!forum/librosa.
Вернуться наверх ↥
Если вы хотите процитировать librosa в научной работе, есть два способа сделать это.
Если вы используете библиотеку для своей работы, для воспроизводимости укажите версию, которую вы использовали, проиндексированную в Zenodo:
Начиная с версии librosa 0.10.2 или более поздней, вы также можете использовать librosa.cite()
, чтобы получить ссылку DOI для любой версии librosa.
Если вы хотите процитировать librosa за ее дизайн, мотивацию и т. д., цитируйте статью, опубликованную на SciPy 2015:
Макфи, Брайан, Колин Раффел, Давен Лян, Дэниел П.В. Эллис, Мэтт Маквикар, Эрик Баттенберг и Ориол Ньето. «librosa: анализ аудио и музыкальных сигналов в Python». В материалах 14-й конференции «Питон в науке», стр. 18-25. 2015.
Вернуться к началу ↥