https://github.com/sigsep/sigsep-mus-io

Tools to convert sigsep mus dataset from STEMS <-> WAV
https://github.com/sigsep/sigsep-mus-io

dataset docker sisec stems

Last synced: 2 months ago
JSON representation

Tools to convert sigsep mus dataset from STEMS <-> WAV

• Host: GitHub
• URL: https://github.com/sigsep/sigsep-mus-io
• Owner: sigsep
• License: mit
• Created: 2017-12-13T16:57:57.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2020-07-15T08:32:59.000Z (about 4 years ago)
• Last Synced: 2024-05-16T12:58:43.621Z (5 months ago)
• Topics: dataset, docker, sisec, stems
• Language: Shell
• Homepage:
• Size: 81.1 KB
• Stars: 7
• Watchers: 4
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# SIGSEP MUS STEMS Encoder/Decoder

The purpose of this tool is to decode and encode the sigsep mus stems dataset. By providing a docker based installation setup, we can make sure that all users deal with the same decoded PCM data and therefore foster reproducible research.

## Setup

The easiest way to set up the encoder and decoder for the `MUS` dataset is to install [docker](http://docker.com).

### Pull Docker Container

Pull our precompiled `sigsep-mus-io` image from dockerhub:

```

docker pull faroit/sigsep-mus-io

```

_Alternatively (or if you want to customize the `Dockerfile`) you can clone the repository and build the docker container from command line using:_

```

docker build -t mus .

```

## Usage

### Decode SIGSEP MUS to WAV format

Unzip the MUS dataset to any location of your choice. Lets assume you have it unpacked in `~/data/MUS/`.

#### Using Bash on Mac/Linux

Run the decoding scripts with the following command below. Make sure to change the volume mounts `-v ABSOLUTE/PATH/TO/YOUR/MUS/FOLDER:/data` in the docker command.

```

docker run --rm -v $(~)/data/MUS:/data faroit/sigsep-mus-io /scripts/decode.sh

```

### Using Windows (10)

In Windows Command Line (`cmd`) you can use the directory variables to mount the data directories. Assuming that the data lies in the MUS subfolder of your home directory, you may use:

```

docker run --rm -v %HOMEDRIVE%"%HOMEPATH%/MUS":/data faroit/sigsep-mus-io /scripts/decode.sh

```

### Encode SIGSEP MUS to STEMS format

To encode a MUS estimates directory, you can use the `sh encode.sh` script.

Again, if you have saved the data directoy in a different location than the default folder, please change it

```

docker run --rm -v $(~)/data/ESTIMATE_DIR:/data faroit/sigsep-mus-io /scripts/encode.sh

```

## Manual Conversion

### Requirements

* FFMPEG 3.4

* MP4Box 7.1

* gnu-parallel

### Usage

Run the `decode.sh` or `encode.sh` scripts manually.