Installation

Python Installation

To start with the installation, download the Anaconda installer for your operating system with Python >= 3.8.

Initial Steps

These steps need to be performed for all operating systems.

1. Create a Github account (The free account is sufficient).

2. Fork the MIA Lab repository:

   1. Go to the MIA Lab repository: https://github.com/ubern-mialab/mialab

   2. Fork the repository by clicking on the Fork button in the right upper corner.

   3. Follow the instructions on Github.

   4. Go to your MIALab fork (You are at the right location if the text in the left upper corner is of structure [yourgithubaccount]/mialab)

   5. Click on the green Clone button and copy the URL (https://github.com/[yourgithubaccount]/mialab.git) shown. You will later use it for cloning your fork to your local machine and probably to UBELIX.

Continue with the operating system specific installation instructions, below.

Operating System Specific Installation Steps

macOS

The installation has not been tested.

git installation

Download git and install.

Clone your MIALab repository fork:

cd /path/to/where/you/want/the/code

Clone the MIALab repository fork using the URL:

git clone https://github.com/[yourgithubaccount]/MIALab.git

Anaconda installation

Follow the instructions on the official website, and then verify the installation:

conda list # which should list all installed Anaconda packages

Create a new Python 3.10 environment with the name mialab (confirm with `y` when promoted during creation)

conda create -n mialab python=3.10

Activate the environment:

conda activate mialab

Install required packages

cd /path/to/MIALab/repository
pip install -r requirements.txt #will install all required packages

Windows

Linux

Finally, if all of the above works without issues, test the installation using:

Execute the installation test script to verify if all the dependencies are setup correctly.

python ./test/test_install.py

Setting up the IDE

Next, move to the IDE page to setup your favorite development environment to be maximally productive with the code involved with this course!

MATLAB Installation:

Follow the instructions on the MathWorks website to install MATLAB on your computer. Operating System specific requirements are here. Once you have MATLAB installed, read through the MATLAB section of the IDE page to learn more about working with this program.