olilarkin/librosa.cpp

🎵 librosa.cpp — C++17 port của librosa, chạy trên web, Apple và native

Bản port C++17 của librosa với hỗ trợ WebAssembly, SwiftPM và CLI, kiểm chứng đúng bằng cross-validation so với Python gốc.

librosa.cpp là một bản port C++17 của thư viện phân tích âm thanh và nhạc librosa, xây dựng trên Eigen. Dự án này theo dõi bản cập nhật từ upstream librosa==0.11.0 và được thiết kế để chạy trên nhiều nền tảng như native (Linux/macOS), Apple (qua SwiftPM) và web (qua WebAssembly).

Được xây dựng bởi cộng đồng với sự hỗ trợ từ các công cụ agent, librosa.cpp mang lại hầu hết các tính năng mạnh mẽ của librosa trong môi trường C++, kết hợp với các backend FFT linh hoạt và khả năng kiểm chứng độ chính xác thông qua JSON reference outputs.

✨ Điểm nổi bật

• STFT / ISTFT, CQT, mel-spectrograms, chroma: Hỗ trợ đầy đủ các phép biến đổi tần số và đặc trưng spektral cơ bản.
• MFCC và các đặc trưng spektral khác: Bao gồm centroid, bandwidth, flatness, rolloff, contrast.
• Onset detection và onset strength: Phát hiện điểm bắt đầu và đo độ mạnh của chúng.
• Tempo estimation và beat tracking: Ước lượng nhịp độ và theo dõi nhịp điệu.
• HPSS và NMF decomposition: Tách nguồn hài hòa/nhịp điệu và phân rã không âm phủ.
• Pitch detection (YIN, pYIN) và tuning estimation: Phát hiện cao độ và ước lượng điều chỉnh âm thanh.
• Viterbi decoding, DTW, sequence utilities: Các công cụ xử lý chuỗi và căn chỉnh thời gian.
• Effects (time stretching, pitch shifting, trimming, remixing): Các hiệu ứng chỉnh sửa âm thanh.
• CLI rosa: Công cụ phân tích nhanh từ dòng lệnh.
• SwiftPM package: Gói Swift với API Swift và target C ABI cho nền tảng Apple.
• WebAssembly/npm package: Gói web với API TypeScript và demo trình duyệt.

💡 Vì sao đáng chú ý

librosa.cpp nổi bật bởi khả năng kiểm chứng độ chính xác thông qua một hệ thống cross-validation so sánh trực tiếp với bản tham chiếu Python của librosa. Điều này đảm bảo rằng mọi thuật toán đều được port chính xác, không chỉ dừng ở cú pháp mà còn ở kết quả tính toán.

Ngoài ra, dự án hỗ trợ nhiều backend FFT khác nhau (FFTW3, Apple Accelerate, pocketfft, pffft), cho phép người dùng lựa chọn tùi ưu cho từng nền tảng và yêu cầu bản quyền. Đặc biệt, backend pocketfft dựa trên cùng một thư viện NumPy/SciPy sử dụng, mang lại tính nhất quán cao.

#librosa #C++ #WebAssembly #Swift #AudioAnalysis #MusicInformationRetrieval #TiniX