This repository contains excercises and supporting code for the course T-717-SPST at Reykjavik University. (Work in progress)
- Exercise 1: Digital Audio
- Exercise 2: Audio Manipulation
- Exercise 3: Domain Specific TTS
- Exercise 4: Script Design
- Exercise 5: Record Your Data
- Exercise 6: Festival in Docker
- Exercise 7: Ossian in AWS (Not part of course anymore)
- Exercise 8: Evaluate your TTS
- Final Project
All the code in this repository is written in Python 3. The recommended approach is to create a python virtual environment:
- Create the virtual environment with one of the following:
- macOS/Linux:
python3 -m venv .env
orvirtualenv -p python3 ..env
- Windows:
python -m venv ./env
orpy -3 -m venv .env
- macOS/Linux:
- Activate it with
source ./env/bin/activate
if you are in the project directory. Otherwise you dosource /path/to/your/environment/bin/activate
.
You can however use Python in any way you see fit and perhaps you may have all the requirements already installed system wide.
Install Python requirements with pip install -r requirements.txt
. You can of course install any additional python requirements using pip
, just make sure you have your virtual environment activated when you do.
Note: The requirements list might not work for you or the list might be out-of-date. If this is the case it should be sufficient to simply install the following requirements using pip install
:
numpy
librosa
matplotlib
To get the best experience make sure that your VS Code workspace is using the correct Python interpreter. If you are using a virtual environment then the workspace setting python.pythonPath
has to be set to /path/to/venv/bin/python
. Normally VS Code takes care of doing this for you by recognizing that there is a virtual environment in the workspace. If not:
- Make sure you have the VSC Python extension installed (search for
ms-python.python
in the extension search) - Press the settings cog in the bottom left inside VSC and select
settings
. - Select
Workspace
- search for
pythonpath
and edit the value to point to your python interpreter as explained above.
You can read a more detailed document about python environments in VSC here.
I would recommend forking this repository before starting your work. By doing that you could easily version control your own work throughout the course. Notes:
- This repository will ignore
*.wav
files, except for thedata/
directories in assignments 1-3. If you want to track your results as well, either save them in these./data
directories or modify the.gitignore
file. - This repository is a work in progress so when important changes are made, follow this to update your fork according to the upstream.
Each assignment has a README.md
which includes the assignment description and what to turn in. You should return a PDF file where each question in README.md
that is marked with (*)
is answered. Try to adhere to the numbering in the README.md
files. For example, label the answer to the first question in this assignment as 1.1
. Furthermore:
- Each assignment has a
template.py
file. This file should be included in your submission with your own code filled in as well as any other helper functions you write to generate your results. - Some assignments have an
example.py
file that shows how to use some of the functions that are given intools.py
. - In some of the assignments you are asked to generate and save waveforms to disk. In those cases, it is good to include those as well. Turn in your assignment on the Canvas page for the course.