junjiez / census2020

Visualizing 230 years of US Census data

US Census 2020

Visualizing the US census data over the past 230 years!

In this tutorial we walk through an example of using jupyter notebooks and pandas to create a bar chart race for the US census data from the past 230 years. The final bar chart race is available here!

To view the notebook tutorial in your browser click 👉 here 👈

If you would like to run the notebook on your own machine, follow the steps below. If you already know how to run jupyter notebooks and how to install python packages, you can go straight to the notebook by running:

jupyter notebook

and then opening USCensus2020.ipynb from within the jupyter notebook interface. The entire tutorial and all of its steps are described in the notebook.

If you need help setting up jupyter notebooks on your machine, follow the instructions below:

Getting Started with Jupyter Notebooks

Requisites

The only hard requirement is a running version of python 3.3 or newer. To install the latest python 3.x version go to python.org/downloads and follow the installation instructions.

Installation

1a Setting up Virtual Environment [Linux or Mac]

Clone this repo with:

git clone https://github.com/AntonMu/Census2020
cd Census2020

Create Virtual (Linux/Mac) Environment (requires venv which is included in the standard library of Python 3.3 or newer):

python3 -m venv env
source env/bin/activate

Make sure that, from now on, you run all commands from within your virtual environment.

1b Setting up Virtual Environment [Windows]

Use the Github Desktop GUI to clone this repo to your local machine. Navigate to the Census2020 project folder and open a power shell window by pressing Shift + Right Click and selecting Open PowerShell window here in the drop-down menu.

Create Virtual (Windows) Environment (requires venv which is included in the standard library of Python 3.3 or newer):

py -m venv env
.\env\Scripts\activate

Make sure that, from now on, you run all commands from within your virtual environment.

2 Install Required Packages [Windows, Mac or Linux]

To install required packages run:

pip3 install -r requirements.txt

Run Jupyter Notebook

Once the requirements installed, you are able to start the jupyter notebook service via:

jupyter notebooks

This should automaticaly open a web browser with the notebook server. If it doesn't work you can go to a web browser and manually go to localhost:8888.

Finally, open USCensus2020.ipynb from within the jupyter notebook interface.

Licensing

This work is licensed under a Creative Commons Attribution 4.0 International License. This means that you are free to:

• Share — copy and redistribute the material in any medium or format
• Adapt — remix, transform, and build upon the material for any purpose, even commercially.

Under the following terms:

• Attribution — a link to this github repo!