README.md

# Introduction to Machine Learning using Python

Materials for the SIS machine learning workshop.


## Setup Instructions

The setup is based on the Conda distribution for Python called Anaconda
(https://www.anaconda.com/products/individual).

### I. Install Anaconda

1. If you don’t have Anaconda yet, download and install Anaconda from
   https://www.anaconda.com/products/individual, or, in case you work on a ETH-managed
   computer, install Anaconda via the
   [ETH AppV Software Kiosk](https://app.ethz.ch/kiosk).

### II. Install Conda environment

#### on MacOS:

1. Open Terminal.app, change directory to the directory with workshop materials
   (`$ cd path/to/dir`) and run:

       $ conda env create -f environment.yml

#### on Linux

1. Open Terminal, change directory to the directory with workshop materials
   (`$ cd path/to/dir`) and run:

       $ run conda env create -f environment_linux.yml

#### on Windows

1. Start the Anaconda Navigator and Select "Environments"
2. Press "Import Environment" Button.
3. Click at the folder icon; using the File Selection Dialog navigate to the to the directory with workshop materials and select `environment.yml` file.
4. Press "Import" Button.
5. Click on the black triangle and from the dropdown list select "Open Terminal".

### III. Check installation

1. In the Terminal run:

      $ conda run -n machine_learning_workshop_2021 python -c "import tensorflow, matplotlib, numpy, pandas; print('OK')"

   Your setup is OK if this command returns without any error message.

2. Check if you can start JupyterLab in your Web browser by running in the Terminal:

      $ conda run -n machine_learning_workshop_2021 jupyter lab


## Using JupyterLab

The course content is provided as Jupyter Notebooks. Please make sure to familiarize
yourself with
[JupyterLab Interface](https://jupyterlab.readthedocs.io/en/latest/user/interface.html).

The Setup Instructions include information on how to start JupyterLab in a Web browser.

## Preparation Script

The workshop materials contain a `00_numpy_pandas_matplotlib_intro.ipynb`
Jupyter Notebook with an introduction to NumPy, pandas and Matplotlib libraries, which we
are used without further introduction during the workshop. Please prepare yourself and
go through the notebook.