humbledata / beginners-data-workshop

Humble Data aims to increase inclusivity and provide a safe community for Python and Data Science. We organise free workshops for people who are outside of the mainstream in the data science and tech industry.

Humble Data Workshop

ℹ️ If you would like to know more about this workshop, please apply here.

---

Load the environment using pip-tools

# Activate environment
workon beginners-data-workshop

# Update packages from requirements.txt
# If this is the first time, then pip install pip-tools
pip-sync

# Install new package & update requirements.txt
pip install new-package-name
pip freeze  # to check version number

# Copy paste package & version to requirements.in
pip-compile
pip-sync

Attendee Setup

1. Visit [https://bit.ly/humble-python-setup] to install Python onto your machine.
2. The notebooks in this project should work great with Anaconda out of the box. If you want to create your own virtual environment for this workshop, your mentor will guide you through the simplest setup.

Note: The Development Setup outlined below will work for you, but is more complex than what you need to follow this workshop. This setup is designed to make it easy to upgrade Python dependencies (e.g. pandas, Seaborn), and run automated checks to highlight if any code in the notebooks is broken (we call this a "test suite").

Development Setup

This project uses pyenv, pyenv-virtualenvwrapper and Poetry. Please see here for a step-by-step installation guide.

# Install Python
pyenv install $(cat .python-version)
pyenv shell $(cat .python-version)
python -m pip install --upgrade pip
python -m pip install virtualenvwrapper
pyenv virtualenvwrapper

# Setup the virtualenv
mkvirtualenv -p python$(cat .python-version) $(cat .venv)
python -V
python -m pip install --upgrade pip

# Install dependencies with Poetry
poetry self update
poetry install --no-root --remove-untracked

# Create Jupyter Kernel
python -m ipykernel install --user --name beginners-data-workshop --display-name "Python (beginners-data-workshop)"

# Install Jupyter Extensions static files
jupyter contrib nbextension install --user
# More info: https://jupyter-contrib-nbextensions.readthedocs.io/en/latest/install.html

---

License

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

beginners-data-workshop's Issues

Notebook 2: improve how we teach SettingWithCopyWarning

Let's move this repo to be under the Humble Data

Misleading explanation for why python doess not require variable declarations

Hi!

I'm one of the mentors and while looking through the first notebook, I saw this explanation: "Python is an object oriented programming language. You do not need to declare variables (or their types) before using them as every variable in python is an object."

I don't think that's quite true. You do not need to declare variables or their types because Python is a dynamically typed language, not because it is object oriented. Java is object oriented and yet Java requires variable declarations with types. Maybe the confusion comes from this fact: Python has types; however, the types are linked not to the variable names but to the objects themselves (but this is not the case in Java, which is also object oriented).

Notebook 3.1 needs solutions

Typo in 1. Beginning with Python.ipynb

The word can appears twice on line 179 in notebook 1. Beginning with Python.ipynb

"**!!! Variable can can change type when re-assigned.**"

Using Colab instead of Jupyter Notebooks

In the past workshops I've run for beginners, Colab is way easier for beginners to get started with. The most difficult part those workshops was setting up the environment/conda.

I suggest you consider colab as an option

Display settings in notebooks/2. First steps with Pandas.ipynb don't work correctly in Jupyter Lite

In section Display settings in notebooks/2. First steps with Pandas.ipynb after changing pd.options.display.max_rows to whatever value (on the screenshot 50 but I've tried others too) there is no influence on how display method behaves in Jupyter Lite.

Notebook 2: pandas deprecation at the end

Possibly related to the SettingWithCopyWarning, needs a .copy() somewhere in the notebook...and possibly solved by #36

Replace `master` branch with `main` branch

Guideline for beginner's day set up

Write a md file to teach a person with no Python experience to set up a working environment on their computer to run the workshop.

1. download Anaconda
2. clone/download the repo
3. run the notebook

Notebook 3.2 could be rewritten with more solutions + remove warning at end