Human-centered Data Science - Winter Term 2020

This repository contains all material needed to participate in the course Human-centered Data Science of the research group Human-Centered Computing (HCC) at Freie Universität Berlin.

First things first

1. The repository (code section) contains everything related to the programming assignments we will do throughout the course.
2. All other information (lecture slides, assignment instructions, etc.) you find in the ➡️ wiki⬅️.
3. You should also clone the wiki by running git clone https://github.com/FUB-HCC/hcds-winter-2020.wiki.git or git clone git@github.com/FUB-HCC/hcds-winter-2020.wiki.git.
4. You need to clone the code repository in order to deliver your assignments or to test/run the code of fellow students.

Getting started

We use the "Amazing Python Data Workflow with Poetry, Pandas, and Jupyter"¹ to make sure everyone in the course uses the same environment and we don't run into any dependency hell 🌋.

Prerequisites

In order to take part in the course, please ensure that you have a Python version greater or equal to 3.6.1, a working installation of Poetry and git installed.

Setup

1. Clone this repository and move it into the repo root.

   git clone https://github.com/FUB-HCC/hcds-winter-2020.git cd hcds-winter-2020

2. Install the dependencies in the repo root.

   poetry install

3. Create a subshell within the virtual environment by running:

   poetry shell

4. Open the project with Jupyter in your browser.

   jupyter notebook

Troubleshooting

• Problems when installing poetry? When installing poetry something goes wrong. It's not automatically in your path, so if you run poetry --version nothing happens. If you use zsh or oh-my-zsh then you need to add the following line to your .zshrc file export PATH="$HOME/.poetry/bin:$PATH.

• Trouble with previewing notebooks directly in GitHub? --> https://nbviewer.jupyter.org/

---

[1] https://mungingdata.com/python/jupyter-workflow-poetry-pandas/, accessed: 2020-10-28