用于音乐和音频分析的 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,则将自动处理音频编码依赖项。
如果您在 Linux 环境中使用pip
,则可能需要手动安装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()
获取任何版本的 librosa 的 DOI 链接。
如果您想引用 librosa 的设计、动机等,请引用在 SciPy 2015 上发表的论文:
McFee、Brian、Colin Raffel、梁大文、Daniel PW Ellis、Matt McVicar、Eric Battenberg 和 Oriol Nieto。 “librosa:Python 中的音频和音乐信号分析。”第 14 届 Python 科学会议论文集,第 18-25 页。 2015年。
返回顶部 ↥