Skip to content
Snippets Groups Projects
Commit 344701b5 authored by Mikolaj Rybinski's avatar Mikolaj Rybinski
Browse files

Update README.md and rm deprecated Install.md

parent 9cb51eb0
No related branches found
No related tags found
1 merge request!39Draft: Resolve "Update installation instructions"
# Setting up the Conda environment
## Install conda
https://conda.io/docs/user-guide/install/
## Install the environment
### On Linux:
* Open a terminal and navigate to the workshop git repository
* Run the following command:
~~~~bash
conda env create -f environment_linux.yml
~~~~
### On Mac:
* Open a terminal and navigate to the workshop git repository
* Run the following command:
~~~~bash
conda env create -f environment_mac.yml
~~~~
### On Windows
* Open the Anaconda Prompt and navigate to the workshop git repository
* Run the following command:
~~~~
conda env create -f environment.yml
~~~~
# README
# Introduction to Machine Learning using Python
Material related to the SIS machine learning workshop.
Materials for the SIS machine learning workshop.
## Setting up the conda environment on personal computers
* **Install conda**
https://conda.io/docs/user-guide/install/
## Setup Instructions
* **Install the environment**
* On Mac:
* Open a terminal and navigate to the workshop git repository
* Run the command: `conda env create -f environment.yml`
<br/>
* On Linux:
* Open a terminal and navigate to the workshop git repository
* Run the command: `conda env create -f environment_linux.yml`
<br/>
* On Windows
* Open Anaconda prompt and navigate to the workshop git repository
* Run the command: `conda env create -f environment.yml`
<br/><br/>
* **Check installation**
The setup is based on the Conda distribution for Python called Anaconda
(https://www.anaconda.com/products/individual).
* On **Linux**/**Mac** - open a terminal
### I. Install Anaconda
* On **Windows** - open Anaconda prompt
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).
and run the following commands:
~~~~
conda activate machine_learning_workshop
jupyter notebook
~~~~
### II. Install Conda environment
(For some versions of Anaconda on **Windows** you might have to run just **activate machine_learning_workshop** intead of **conda activate ...**)
#### on MacOS:
1. Open Terminal.app, change directory to the directory with workshop materials
(`$ cd path/to/dir`) and run:
in case your installation worked your browser should open jupyter.
$ 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.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment