-
Notifications
You must be signed in to change notification settings - Fork 48
Lab 0. Setting up
The invite code for the workshop Discord is: (contact us for a new link)
You can either use the online Discord page (https://discordapp.com/) or download the app.
This provides a way for workshop members to share links, ask questions or message one another.
Before we can get started, we need to download a few things. First, we need to download the project files we will use for this workshop. The following step-by-step instructions will guide you through making a git account, forking the repository and cloning it to your computer.
Before we start, please make sure that git is installed. There is the GitHub Desktop version and the regular git.
- Before we start, you need a GitHub account, so please go to github.com/join and create one if you don't have one yet.
- Login to your new or existing GitHub account.
- Navigate to this repository and fork on the fork button in the top right corner. More help This will create your own copy of the repository under your account.
- Now open your command line or terminal.
- Make a folder on your local computer for this workshop. So if you e.g. want to create, a folder called e.g.
NN4A
you would write a function likemkdir NN4A
and then hit return. 5 Now enter your new folder by typingcd NN4A
. ChangeNN4A
to whatever you named the folder in the previous command. - Now clone the forked version of this repository. You can do this with the command
git clone http:/<<<YourGithubUserName>>>/RealtimeAudioClassification.git
Remember to replace<<<YourGithubUserName>>>
with your GitHub username. - If you now navigate into the folder with
cd RealtimeAudioClassification
and runls
(dir
on Windows) you should see the project files like e.g.00_Setup
,01_Spectrum Generation
,02_Training
.
Here is a cheat sheet if you need help with UNIX commands.
Here is another GitHub cheat sheet and a GIT Command Line cheat sheet.
Before we can use these project files, we have to install a few tools and software libraries.
- Install Jupyter Notebooks. (Skip this step if you already have Jupyter Notebooks installed.)
- Start Jupyter notebooks in the RealtimeAudioClassification folder that you recently cloned.
- Within Jupyter, navigate to the folder
00_Setup
and open the Notebook inside. The notebook is calledSetup.ipynb
. - Follow the steps inside that notebook to install and test the software libraries we need for this workshop.
Jupyter Notebooks are the main "IDE" that we will be using in this workshop. Jupyter Notebooks is great to try out different code snippets, and to selectively debug the code you are writing.
Everything in these notebooks resolves around cells. The current active cell has a blue or green stripe on the left side. (Why green or blue? Look here!) Normally a cell contains a section of code that is executed together. For example, we often define each function in its own cell.
You can edit the code that is in that cell by clicking into the cell.
To run the code in the cell, you can click on the button on the top that says >| Run
or press down shift + return
at the same time on your keyboard.
This will run this cell and select the cell below. If you want to run multiple cells in succession, you can press shift + return
a few times to quickly run the whole notebook.
If you followed the setup steps to install the packages and download the data-set, then we can proceed in running the relevant code.
For the first lab, we will use our very own Cats-Vs-Dogs dataset. Download the dataset here: Cats vs Dogs.
After downloading the dataset, unzip and move the files to the AudioData/
folder in your workshop repository folder. Any Dataset you might want to train on later should also go in the AudioData folder to make the easiest use of the existing scripts.