حزمة بايثون لتحليل الموسيقى والصوت.
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
إذا سارت الأمور على ما يرام، فمن المفترض أن تكون قادرًا على تنفيذ الأوامر التالية من وحدة تحكم بايثون:
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:
من الإصدار 0.10.2 أو الأحدث من librosa، يمكنك أيضًا استخدام librosa.cite()
للحصول على رابط DOI لأي إصدار من librosa.
إذا كنت ترغب في الاستشهاد بـ librosa لتصميمها ودوافعها وما إلى ذلك، فيرجى الاستشهاد بالمقالة المنشورة في SciPy 2015:
ماكفي، وبريان، وكولين رافيل، وداوين ليانغ، ودانيال بي دبليو إليس، ومات ماكفيكار، وإريك باتنبرغ، وأوريول نييتو. "librosa: تحليل إشارات الصوت والموسيقى في بيثون." في وقائع مؤتمر الثعبان الرابع عشر في العلوم، الصفحات من 18 إلى 25. 2015.
العودة إلى الأعلى ↥