cover-song-identification

KO | EN

gitlite — search

#go #golang #machine-learning #rust #macos #nodejs #java #windows #awesome #awesome-list #vue #ios #mcp #open-source

cover-song-identification

(★ 11)

Cover Song Identification with Keras

cover-song-identification Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Cover Song Identification
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/vignejs/cover-song-identification/master) [![MIT license](https://img.shields.io/badge/License-MIT-blue.svg)](https://lbesson.mit-license.org/) ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/th)

[<img src="https://deepnote.com/buttons/launch-in-deepnote.svg">](https://deepnote.com/project/82619257-0268-4ccc-bfdb-af99b74ce311)

Cover Song Identification with Siamese Network. Embeddings can be generated with CNN encoder for faster retrieval of similar (cover) songs for a given query song.

## Dataset
Dataset taken from [Da-Tacos](https://github.com/MTG/da-tacos), which consists of subsets i.e benchmark and coveranalysis. Benchmark subset has 15000 songs with 1000 unique works each with 13 performances (2000 songs were added as noise), whereas Coveranalysis subset has 10000 songs with 5000 unique works each with 2 performances. You can find more in their official github [repo](https://github.com/MTG/da-tacos).

## Preprocess

```
➜ python preprocess.py --help
Usage: preprocess.py [OPTIONS] COMMAND [ARGS]...

script contains two subcommands to either generates a single h5 file from
  audio directory or da-tacos dataset

Options:
  --help  Show this message and exit.

Commands:
  da-tacos         command to downsize the da-tacos dataset, generates a...
  from-audio-dir  command to convert audio files directly to a single h5...

```
### Generating from da-tacos dataset
```
➜ python preprocess.py da-tacos --help
Usage: preprocess.py da-tacos [OPTIONS]

command to downsize the da-tacos dataset, generates a single h5 file for
  each subset

Options:
  -d, --data-dir PATH             path to datasets folder which contains da-
                                  tacos_benchmark_subset_single_files/ and da-
                                  tacos_coveranalysis_subset_single_files/
                                  folders  [default: datasets]

-p, --pcp-features [crema|chroma_cens|hpcp]
                                  select pcp feature (use this option multiple
                                  times for more than one selection)
                                  [default: crema]

-s, --spect-len INTEGER         Resized output spectral length  [default:
                                  500]

--help                          Show this message and exit.

```
### Generating from an audio directory
```
➜ python preprocess.py from-audio-dir --help
Usage: preprocess.py from-audio-dir [OPTIONS]

command to convert audio files directly to a single h5 file for testing
  and evaluation.

Options:
  -a, --audio-dir PATH            path to audio folder  [required]
  -o, --output-dir PATH           path to output folder, where the script will
                                  generate an intermediate features folder and
                                  single h5 file from that folder.  [default:
                                  datasets]

-r, --run-mode [parallel|single]
                                  Whether to run the extractor in single or
                                  parallel mode.  [default: parallel]

-n, --workers INTEGER           No of workers in parallel mode  [default:
                                  -1]

-s, --spect-len INTEGER         Resized output spectral length  [default:
                                  500]

--help                          Show this message and exit.

```

## Training
<a href="https://colab.research.google.com/github/vignejs/cover-song-identification/blob/master/train.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>

The model was trained on crema pcp features from benchmark subset resized to 23x500 by tiling 2 times in pitch dimension and removing the last row as inspired by [[1]](#1).
Siamese has two input CNN encoder with shared weights for learning the embeddings for each input audio features.
The two input pair being performance from same works as positive class and performance of one of the work and other from randomly chosen work as negative class.
The L1 distance of these two encoder is densely connected to one sigmoidal output.
Lookahead optimizer in used in conjunction with Adam for better performance.
Model was validated on coveranalysis subset.

| ![a single CNN encoder](https://raw.githubusercontent.com/vignets/cover-song-identification/master/images/nn.png) |
|:--:| 
|*a single CNN encoder*|

## Evaluation
<a href="https://colab.research.google.com/github/vignejs/cover-song-identification/blob/master/evaluate.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>

Model was from evaluated on a small dataset from youtube, which has 10 original works with varying no. of performances. You can get the pretrained and testset for evaluation from [here](https://github.com/vignejs/cover-song-identification/releases/tag/v0.1.0).

### Results
k|mAP@k|topk
--|--|--
|1| 0.700|70.00
|2| **0.725**|**80.00**
|5| 0.644|74.00
|10| 0.621|75.00

## Visualizing Embeddings
Visualizing embeddings of audio tracks in the testset by reducing dimension to 3d and 2d space with PCA. 
| ![pca 3d](https://raw.githubusercontent.com/vignets/cover-song-identification/master/images/pca_3d.png) |
|:--:| 
|*embeddings in 3d space*|

| ![pca 2d](https://raw.githubusercontent.com/vignets/cover-song-identification/master/images/pca_2d.png) |
|:--:| 
|*embeddings in 2d space*|

## References
><a id="1">[1]</a>
Yesiler, Furkan, Joan Serra, and Emilia Gomez. “Accurate and Scalable Version Identification Using Musically-Motivated Embeddings.” ICASSP 2020 - 2020 IEEE International Conference on Acoustics, Speech and Signal Processing (ICASSP) (2020): n. pag. Crossref. Web.

## Issues
If you face any problem file an issue. Pull requests are welcome.

## License
[MIT](LICENSE)

cover-song-identification

cover-song-identification Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

cover-song-identification

cover-song-identification Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README