Skip to content
Snippets Groups Projects
Commit f42c2745 authored by Dipam Chakraborty's avatar Dipam Chakraborty
Browse files

Merge branch 'master' of...

Merge branch 'master' of gitlab.aicrowd.com:aicrowd/challenges/sound-demixing-challenge-2023/sdx-2023-music-demixing-track-starter-kit
parents f1c14320 08ac463a
No related branches found
No related tags found
No related merge requests found
![Banner image](https://images.aicrowd.com/uploads/ckeditor/pictures/1044/content_Desktop_Banner-mdx.png) ![Banner image](https://aicrowd-production.s3.eu-central-1.amazonaws.com/misc/sound-demixing-challenge-23/static/images/Desktop+Banner+(1).png)
# **[Audio Demixing Challenge 2023 - Music Demixing Track](https://www.aicrowd.com/challenges/music-demixing-challenge-2023/problems/music-demixing-track)** - Starter Kit # **[Sound Demixing Challenge 2023 - Music Demixing Track](https://www.aicrowd.com/challenges/sound-demixing-challenge-2023/problems/music-demixing-track)** - Starter Kit
[![Discord](https://img.shields.io/discord/565639094860775436.svg)](https://discord.gg/fNRrSvZkry) [![Discord](https://img.shields.io/discord/565639094860775436.svg)](https://discord.gg/fNRrSvZkry)
This repository is the Audio Demixing Challenge 2023 - Music Demixing Track **Starter kit**! It contains: This repository is the Sound Demixing Challenge 2023 - Music Demixing Track **Starter kit**! It contains:
* **Documentation** on how to submit your models to the leaderboard * **Documentation** on how to submit your models to the leaderboard
* **The procedure** for best practices and information on how we evaluate your agent, etc. * **The procedure** for best practices and information on how we evaluate your agent, etc.
* **Starter code** for you to get started! * **Starter code** for you to get started!
Quick Links: Quick Links:
* [Audio Demixing Challenge 2023 - Music Demixing Track - Competition Page](https://www.aicrowd.com/challenges/music-demixing-challenge-2023/problems/music-demixing-track) * [Sound Demixing Challenge 2023 - Music Demixing Track - Competition Page](https://www.aicrowd.com/challenges/sound-demixing-challenge-2023/problems/music-demixing-track)
* [Discussion Forum](https://www.aicrowd.com/challenges/music-demixing-challenge-2023/discussion) * [Discussion Forum](https://www.aicrowd.com/challenges/sound-demixing-challenge-2023/discussion)
* [Audio Demixing 2023 Challenge Overview](https://www.aicrowd.com/challenges/music-demixing-challenge-2023/) * [Sound Demixing 2023 Challenge Overview](https://www.aicrowd.com/challenges/sound-demixing-challenge-2023/)
# 📝 Table of Contents # 📝 Table of Contents
1. [About the Audio Demixing Challenge 2023](#about-the-music-demixing-challenge-2023) 1. [About the Sound Demixing Challenge 2023](#about-the-sound-demixing-challenge-2023)
2. [Evaluation](#evaluation) 2. [Evaluation](#evaluation)
3. [Baselines](#baselines) 3. [Baselines](#baselines)
4. [How to test and debug locally](#how-to-test-and-debug-locally) 4. [How to test and debug locally](#how-to-test-and-debug-locally)
...@@ -25,7 +25,7 @@ Quick Links: ...@@ -25,7 +25,7 @@ Quick Links:
7. [Setting up your codebase](#setting-up-your-codebase) 7. [Setting up your codebase](#setting-up-your-codebase)
8. [FAQs](#faqs) 8. [FAQs](#faqs)
# 🎶 About the Audio Demixing Challenge 2023 # 🎶 About the Sound Demixing Challenge 2023
Have you ever sung using a karaoke machine or made a DJ music mix of your favourite song? Have you wondered how hearing aids help people listen more clearly or how video conference software reduces background noise? Have you ever sung using a karaoke machine or made a DJ music mix of your favourite song? Have you wondered how hearing aids help people listen more clearly or how video conference software reduces background noise?
...@@ -33,7 +33,7 @@ They all use the magic of audio separation. ...@@ -33,7 +33,7 @@ They all use the magic of audio separation.
Music source separation (MSS) attracts professional music creators as it enables remixing and revising songs in a way traditional equalisers don't. Suppressed vocals in songs can improve your karaoke night and provide a richer audio experience than conventional applications. Music source separation (MSS) attracts professional music creators as it enables remixing and revising songs in a way traditional equalisers don't. Suppressed vocals in songs can improve your karaoke night and provide a richer audio experience than conventional applications.
The Audio Demixing Challenge 2023 (ADX23) is an opportunity for researchers and machine learning enthusiasts to test their skills by creating a system to **perform audio source separation**. The Sound Demixing Challenge 2023 (SDX23) is an opportunity for researchers and machine learning enthusiasts to test their skills by creating a system to **perform audio source separation**.
Given an **audio signal as input** (referred to as a "mixture"), you must **decompose in its different parts**. Given an **audio signal as input** (referred to as a "mixture"), you must **decompose in its different parts**.
...@@ -77,9 +77,9 @@ for each song. Finally, the overall score is obtained by averaging SDRsong over ...@@ -77,9 +77,9 @@ for each song. Finally, the overall score is obtained by averaging SDRsong over
# 🤖 Baselines # 🤖 Baselines
We use the [Open-Unmix](https://github.com/sigsep/open-unmix-pytorch) library for the baseline. Specifically, we provide trained checkpoints for the UMXL model. You can use the baseline by switching to the `openunmix-baseline` [branch](https://gitlab.aicrowd.com/aicrowd/challenges/music-demixing-challenge-2023/adx-2023-music-demixing-track-starter-kit/-/blob/openunmix-baseline/) on this repository. To test the models locally, you need to install `git-lfs`. We use the [Open-Unmix](https://github.com/sigsep/open-unmix-pytorch) library for the baseline. Specifically, we provide trained checkpoints for the UMXL model. You can use the baseline by switching to the `openunmix-baseline` [branch](https://gitlab.aicrowd.com/aicrowd/challenges/sound-demixing-challenge-2023/sdx-2023-music-demixing-track-starter-kit/-/blob/openunmix-baseline/) on this repository. To test the models locally, you need to install `git-lfs`.
When submitting your own models, you need to submit the checkpoints using `git-lfs`. Check the instructions shared in the inference file [here](https://gitlab.aicrowd.com/aicrowd/challenges/music-demixing-challenge-2023/adx-2023-music-demixing-track-starter-kit/-/blob/openunmix-baseline/my_submission/openunmix_separation_model.py) When submitting your own models, you need to submit the checkpoints using `git-lfs`. Check the instructions shared in the inference file [here](https://gitlab.aicrowd.com/aicrowd/challenges/sound-demixing-challenge-2023/sdx-2023-music-demixing-track-starter-kit/-/blob/openunmix-baseline/my_submission/openunmix_separation_model.py)
# 💻 How to Test and Debug Locally # 💻 How to Test and Debug Locally
...@@ -94,7 +94,7 @@ You can use the submission script `source submit.sh <submission_text>` ...@@ -94,7 +94,7 @@ You can use the submission script `source submit.sh <submission_text>`
More information on submissions can be found in [SUBMISSION.md](/docs/submission.md). More information on submissions can be found in [SUBMISSION.md](/docs/submission.md).
#### A high level description of the Challenge Procedure: #### A high level description of the Challenge Procedure:
1. **Sign up** to join the competition [on the AIcrowd website](https://www.aicrowd.com/challenges/music-demixing-challenge-2023). 1. **Sign up** to join the competition [on the AIcrowd website](https://www.aicrowd.com/challenges/sound-demixing-challenge-2023).
2. **Clone** this repo and start developing your solution. 2. **Clone** this repo and start developing your solution.
3. **Train** your models on IGLU, and ensure run.sh will generate rollouts. 3. **Train** your models on IGLU, and ensure run.sh will generate rollouts.
4. **Submit** your trained models to [AIcrowd Gitlab](https://gitlab.aicrowd.com) 4. **Submit** your trained models to [AIcrowd Gitlab](https://gitlab.aicrowd.com)
...@@ -106,7 +106,7 @@ of the competition. ...@@ -106,7 +106,7 @@ of the competition.
# 💽 Dataset # 💽 Dataset
Download the public dataset for this task using this [link](https://www.aicrowd.com/challenges/music-demixing-challenge-2023/problems/music-demixing-track/dataset_files), you'll need to accept the rules of the competition to access the data. The data is same as the well known MUSDB18-HQ dataset and its compressed version. Download the public dataset for this task using this [link](https://www.aicrowd.com/challenges/sound-demixing-challenge-2023/problems/music-demixing-track/dataset_files), you'll need to accept the rules of the competition to access the data. The data is same as the well known MUSDB18-HQ dataset and its compressed version.
# 📑 Setting Up Your Codebase # 📑 Setting Up Your Codebase
...@@ -179,11 +179,11 @@ The machine where the submission will run will have following specifications: ...@@ -179,11 +179,11 @@ The machine where the submission will run will have following specifications:
* 16GB RAM * 16GB RAM
# 📎 Important links # 📎 Important links
- 💪 [Challenge Page](https://www.aicrowd.com/challenges/music-demixing-challenge-2023/problems/music-demixing-track) - 💪 [Challenge Page](https://www.aicrowd.com/challenges/sound-demixing-challenge-2023/problems/music-demixing-track)
- 🗣️ [Discussion Forum](https://www.aicrowd.com/challenges/music-demixing-challenge-2023/discussion) - 🗣️ [Discussion Forum](https://www.aicrowd.com/challenges/sound-demixing-challenge-2023/discussion)
- 🏆 [Leaderboard](https://www.aicrowd.com/challenges/music-demixing-challenge-2023/problems/music-demixing-track/leaderboards) - 🏆 [Leaderboard](https://www.aicrowd.com/challenges/sound-demixing-challenge-2023/problems/music-demixing-track/leaderboards)
- 🎵 [Music Demixing Challenge 2021](https://www.aicrowd.com/challenges/music-demixing-challenge-ismir-2021) - 🎵 [Music Demixing Challenge 2021](https://www.aicrowd.com/challenges/music-demixing-challenge-ismir-2021)
You may also like the new [Cinematic Sound Demixing track](https://www.aicrowd.com/challenges/music-demixing-challenge-2023/problems/cinematic-sound-demixing-track) You may also like the new [Cinematic Sound Demixing track](https://www.aicrowd.com/challenges/sound-demixing-challenge-2023/problems/cinematic-sound-demixing-track)
**Best of Luck** 🎉 🎉 **Best of Luck** 🎉 🎉
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment