音楽とオーディオを分析するための 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
正しく動作するために少なくとも 1 つのプログラムが必要であることに注意してください。
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
この Web サイトから ffmpeg バイナリをダウンロードするか、この Web サイトから gstreamer バイナリをダウンロードします
GStreamer の場合は、Python バインディングもインストールする必要があります。
python -m pip install pygobject
トップに戻る ↥
開発以外の質問やディスカッションのトピックは、Web フォーラム (https://groups.google.com/forum/#!forum/librosa) に送ってください。
トップに戻る ↥
学術著作物で librosa を引用したい場合は、2 つの方法があります。
仕事でライブラリを使用している場合は、再現性を高めるために、Zenodo でインデックス付けされているときに使用したバージョンを引用してください。
librosa バージョン 0.10.2 以降では、 librosa.cite()
を使用して librosa の任意のバージョンの DOI リンクを取得することもできます。
librosa のデザインや動機などについて引用したい場合は、SciPy 2015 で公開された論文を引用してください。
マクフィー、ブライアン、コリン・ラフェル、ダーウェン・リアン、ダニエル・PW・エリス、マット・マクヴィカー、エリック・バッテンバーグ、オリオール・ニエト。 「librosa: Python によるオーディオおよび音楽信号分析」第 14 回 Python in Science Conference の議事録、18 ~ 25 ページ。 2015年。
トップに戻る ↥