Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tachi-hi/hpss
Harmonic/Percussive Sound Separation
https://github.com/tachi-hi/hpss
audio audio-signal-processing hpss music-information-retrieval music-signal-processing signal-processing
Last synced: 26 days ago
JSON representation
Harmonic/Percussive Sound Separation
- Host: GitHub
- URL: https://github.com/tachi-hi/hpss
- Owner: tachi-hi
- License: mit
- Created: 2012-12-05T13:35:27.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2021-07-29T10:44:16.000Z (over 3 years ago)
- Last Synced: 2023-10-20T23:19:24.461Z (over 1 year ago)
- Topics: audio, audio-signal-processing, hpss, music-information-retrieval, music-signal-processing, signal-processing
- Language: C++
- Homepage:
- Size: 39.1 KB
- Stars: 39
- Watchers: 4
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
README
# HPSS (Harmonic/Percussive Sound Separation)
[](https://github.com/tachi-hi/HPSS/actions?query=workflow%3Abuild)
[](https://github.com/tachi-hi/HPSS/actions?query=workflow%3ALaTeXplot)
[](https://opensource.org/licenses/MIT)
## About
This software separates a music audio signal (monaural PCM (`.wav`) format) to two components, "harmonic" and "percussive."
The codes in this repository were used in the experiments of the following paper. [[IEEE Xplore](https://doi.org/10.1109/TASLP.2014.2351131)]
```bibtex
@article{tachibana2014hpss,
author={Hideyuki Tachibana and Nobutaka Ono and Hirokazu Kameoka and Shigeki Sagayama},
journal={IEEE/ACM Transactions on Audio, Speech, and Language Processing},
title={Harmonic/Percussive Sound Separation Based on Anisotropic Smoothness of Spectrograms},
year={2014},
volume={22},
number={12},
pages={2059-2073},
}
```
## LICENSE
- [MIT](LICENSE)
- For academic use, please cite the paper above.
## Directory
+ src: source codes
+ scripts: scripts
## How to use (on UNIX-like systems)
### Libraries
Install `boost` and `fftw3` as follows,
# apt
sudo apt-get install libboost-dev libfftw3-dev
# yum
sudo yum install boost-devel fftw3-devel
### Build
cd your_working_directory
git clone https://github.com/tachi-hi/HPSS
cd HPSS/src; make; cd -
Then two programs `HPSS_separation` and `HPSS_smoothness_eval` will be generated.
Note that the codes are not refactored sufficiently yet.
+ The help message of `HPSS_smoothness_eval` may not help you.
### Known bugs (to be fixed)
This program accepts only the monaural (1ch) wav files.
If you apply the program to a stereo wav file, it will emit the segmentation fault and halt.
## Other Resources
### Other HPSS Implementation
#### Sliding version
Another implementation of HPSS is availabel below.
Note that the algorithm used in the program below is not identical to the one described in the paper above (and the codes in this repository).
[https://github.com/tachi-hi/slidingHPSS](https://github.com/tachi-hi/slidingHPSS)
#### Windows GUI version (not available now)
GUI version (not coded by me) ~~is~~ was available below.
Note that the algorithm used in the program below is not identical to the one described in the paper above (and the codes in this repository).
- ~~http://hil.t.u-tokyo.ac.jp/pages/downloads.html~~ ... link expired
#### Audacity
see http://ismir2015.uma.es/LBD/LBD16.pdf
#### librosa
[librosa](http://librosa.github.io/librosa/), a audio processing module for python, also contains a module named [hpss](http://librosa.github.io/librosa/generated/librosa.decompose.hpss.html), though the algorithm is different from the one described in the above paper.
### Links to other softwares used in the above paper
+ [OpenBliSSART](http://openblissart.github.io/openBliSSART/)
+ [BSS EVAL](http://bass-db.gforge.inria.fr/bss_eval/)