Tutorial Structure and Setup

All of the material needed to go through this tutorial is here on this website. Feel free to browse it at your own pace.

How to Use This Website

On the left-hand side of this web page you’ll see the table of contents for the entire tutorial. If you don’t see the contents, click the hamburger (☰) icon to expand the left-hand column. On the right-hand side of the page you’ll see the table of contents for this particular page. To navigate to the next section you can either click on the next section on the tutorial’s table of contents on the left-hand side, or you can scroll to the bottom of the page to click the button on the bottom right to go to the next section.

This Book is Interactive

Most of the material presented here is written in the python3 programming language. It is presented in the Jupyter Notebook format, which allows us to interweave the lecture material with the code interactively. Click here for a quick guide on how to use Jupyter Notebooks.

Not every chapter will have runnable code, but the ones that do will have a little rocket icon in the top right-hand corner (see Fig. 1).

Note

Not all content will be visible in the notebooks when you view them outside of this page. For instance, special sections on the website this “Notes” block, links to reference references or glossary terms, etc, will only work on the live website you are currently viewing.

Running Locally

There are links to download each notebook at top right of the page.

Fig. 2 There are links to download each notebook at top right of the page.

We have included links to our github repo which has requirements.txt (or environment.yml) to set up your own environment so that you can use these tools locally, if you so choose. To run the notebook locally, select “.ipynb” (“Download Source File”) from the downloads drop down menu at the top right corner of the page.

If you choose to run locally, here are the recommended steps:

  1. Clone the github repo into a new directory.

  2. Make a new conda environment.

    • If you want to install using the included environment.yml file see the (instructions here). Then activate your environment.

    • If you want to install using pip, activate your environment and the run pip install -r requirements.txt. Note that you should have ffmpeg installed prior to installing the requirements (instructions here).

  3. Run jupyter lab in your command line and navigate to the URL that it prints in the console
    (instructions here).

  4. Learn!

Getting in Touch

Github

There are links to the Github repository for this website and its notebooks at the top right corner of every page of this site.

Found a bug? Typo?

Feel free to open an issue here. This link is also at the top right corner of every page.

ISMIR2020 Slack Channel

Feel free to join the conversation on the ISMIR2020 Slack. Channel name: #tutorial-4-open-source-separation.

Let’s get started!

Press the button on the bottom right to advance to the next section.