Skip to content

Setup

Jump to bottom
kaczmarek-kamil edited this page Apr 23, 2018 · 20 revisions

Setup

There are two main ways to start working with this workshop.

(recommended) Option 1: Google Colaboratory

According to the project's main page:

Colaboratory is a Google research project created to help disseminate machine learning education and research

It is free to use for education and research purposes and we will use it in our workshop. It enables us to work interactively with the Python code directly in your browser.

Setup

step 1: download and install Google Chrome

  1. go to Google Chrome web page.
  2. follow Google's installation instructions.

step 2: download data

Download from here: dataset.

step 3: download the repository to disk

  1. open terminal
  2. cd to your working directory
  3. copy workshop contents to your disk:
$ git clone https://github.com/WUT-ML/appliedmldays_2018.git

Alternatively you can just go to the workshop page on GitHub and click clone or download to download entire repository.

step 4: setup Google Colaboratory

  1. Log in to your Google account
  2. Go to: Google Colaboratory
  3. Upload workshop notebook (see previous step)

At this point you are all set.

😃

Option 2: local setup

This option is targeted towards users who are comfortable with command line, git, and source code handling. We support only Ubuntu machines. If you are on other OS, we will try to figure out best solution for you.

step 1: download data

Download from here: dataset.

step 2: download the repository to disk

  1. open terminal
  2. cd to your working directory
  3. copy workshop contents to your disk:
$ git clone https://github.com/WUT-ML/appliedmldays_2018.git

step 3: setup local environment

  1. create virtualenv:
$ virtualenv workshop -p python3.5
  1. activate virtualenv:
$ source workshop/bin/activate
  1. install required packages:
$ pip3 install -r requirements.txt
$ pip3 install libtiff==0.4.2

You install libtiff separately because this library has custom requirements.

  1. start Jupyter notebook
$ python -m jupyter nbextension enable --py widgetsnbextension
$ python -m jupyter notebook

note that in case of issues try this command: jupyter nbextension enable --py widgetsnbextension --sys-prefix and then jupyter notebook.

Other remarks

Advanced Users may want to Install Fiji: image processing package implemented in Java. Fiji is a tool that will let you easily browse raw data.

At this point you are all set.

😃

Clone this wiki locally