Run in Google Colab

View on Github

View raw on Github

Module 2: John Snow's map¶

Follow the contents of this notebook and answer all questions (e.g. Q1: ...)

Jupyter + Pandas = Awesomeness¶

Jupyter notebook (lab) and Pandas may be the two most important libraries responsible for the Python's rise in data science. Jupyter lets you interactively explore datasets and code; Pandas lets you handle tabular datasets with superb speed and convenience. And they work so well together! In many cases, Jupyter and Pandas are all you need to load, clean, transform, visualize, and understand a dataset.

If you are not familiar with Pandas, you may want to follow their official tutorial called 10 Minutes to pandas now or in the near future.

Importing pandas¶

The convention for importing pandas is the following

In [1]:

import pandas as pd

import pandas as pd

You can check the version of the library. Because pandas is fast-evolving library, you want to make sure that you have the up-to-date version of the library.

In [3]:

pd.__version__

pd.__version__

Out[3]:

'2.1.1'

You also need matplotlib, which is used by pandas to plot figures. The following is the most common convention to import matplotlib library.

In [4]:

import matplotlib.pyplot as plt

import matplotlib.pyplot as plt

Let's check its version too.

In [5]:

import matplotlib
matplotlib.__version__

import matplotlib matplotlib.__version__

Out[5]:

'3.8.0'

Loading a CSV data file¶

Using pandas, you can read tabular data files in many formats and through many protocols. Pandas supports not only flat files such as .csv, but also various other formats including clipboard, Excel, JSON, HTML, Feather, Parquet, SQL, Google BigQuery, and so on. Moreover, you can pass a local file path or a URL. If it's on Amazon S3, just pass a url like s3://path/to/file.csv. If it's on a webpage, then just use https://some/url.csv.

Let's load a dataset about the location of pumps in the John Snow's map. You can download the file to your computer and try to load it using the local path too.

In [6]:

pump_df = pd.read_csv('https://raw.githubusercontent.com/yy/dviz-course/master/data/pumps.csv')

pump_df = pd.read_csv('https://raw.githubusercontent.com/yy/dviz-course/master/data/pumps.csv')

df stands for "Data Frame", which is a fundamental data object in Pandas. You can take a look at the dataset by looking at the first few lines.

In [7]:

pump_df.head()

pump_df.head()

Out[7]:

	X	Y
0	8.651201	17.891600
1	10.984780	18.517851
2	13.378190	17.394541
3	14.879830	17.809919
4	8.694768	14.905470

Q1: can you print only the first three lines? Refer: http://pandas.pydata.org/pandas-docs/stable/index.html

In [8]:

# YOUR SOLUTION HERE

# YOUR SOLUTION HERE

Out[8]:

	X	Y
0	8.651201	17.891600
1	10.984780	18.517851
2	13.378190	17.394541

You can also sample several rows randomly. If the data is sorted in some ways, sampling may give you a rather unbiased view of the dataset.

In [9]:

pump_df.sample(5)

pump_df.sample(5)

Out[9]:

	X	Y
12	8.999440	5.101023
2	13.378190	17.394541
7	10.660970	7.428647
10	18.914391	9.737819
0	8.651201	17.891600

You can also figure out the number of rows in the dataset by running

In [10]:

len(pump_df)

len(pump_df)

Out[10]:

13

Note that df.size does not give you the number of rows. It tells you the number of elements.

In [11]:

pump_df.size

pump_df.size

Out[11]:

26

You can also look into the shape of the dataset as well as what are the columns in the dataset.

In [12]:

pump_df.shape  # 13 rows and 2 columns

pump_df.shape # 13 rows and 2 columns

Out[12]:

(13, 2)

In [13]:

pump_df.columns

pump_df.columns

Out[13]:

Index(['X', 'Y'], dtype='object')

You can also check out basic descriptive statistics of the whole dataset by using describe() method.

In [14]:

pump_df.describe()

pump_df.describe()

Out[14]:

	X	Y
count	13.000000	13.000000
mean	12.504677	11.963446
std	3.376869	4.957821
min	8.651201	5.046838
25%	8.999440	7.958250
50%	12.571360	11.727170
75%	14.879830	17.394541
max	18.914391	18.517851

You can slice the data like a list

In [15]:

pump_df[:2]

pump_df[:2]

Out[15]:

	X	Y
0	8.651201	17.891600
1	10.984780	18.517851

In [16]:

pump_df[-2:]

pump_df[-2:]

Out[16]:

	X	Y
11	16.00511	5.046838
12	8.99944	5.101023

In [17]:

pump_df[1:5]

pump_df[1:5]

Out[17]:

	X	Y
1	10.984780	18.517851
2	13.378190	17.394541
3	14.879830	17.809919
4	8.694768	14.905470

or filter rows using some conditions.

In [18]:

pump_df[pump_df.X > 13]

pump_df[pump_df.X > 13]

Out[18]:

	X	Y
2	13.378190	17.394541
3	14.879830	17.809919
8	13.521460	7.958250
9	16.434891	9.252130
10	18.914391	9.737819
11	16.005110	5.046838

Now let's load another CSV file that documents the cholera deaths. The URL is https://raw.githubusercontent.com/yy/dviz-course/master/data/deaths.csv

Q2: load the death dataset and inspect it

1. load this dataset as death_df.
2. show the first 2 rows.
3. show the total number of rows.

In [19]:

# YOUR SOLUTION HERE

# YOUR SOLUTION HERE

In [20]:

# YOUR SOLUTION HERE

# YOUR SOLUTION HERE

Out[20]:

	X	Y
0	13.588010	11.09560
1	9.878124	12.55918

In [21]:

# YOUR SOLUTION HERE

# YOUR SOLUTION HERE

Out[21]:

578

Some visualizations?¶

Let's visualize them! Pandas actually provides a nice visualization interface that uses matplotlib under the hood. You can do many basic plots without learning matplotlib. So let's try.

In [22]:

death_df.plot()

death_df.plot()

Out[22]:

<Axes: >

This is not what we want! When asked to plot the data, it tries to figure out what we want based on the type of the data. However, that doesn't mean that it will successfully do so!

Oh by the way, depending on your environment, you may not see any plot. If you don't see anything run the following command.

In [23]:

%matplotlib inline

%matplotlib inline

The commands that start with % is called the magic commands, which are available in IPython and Jupyter. The purpose of this command is telling the IPython / Jupyter to show the plot right here instead of trying to use other external viewers.

Anyway, this doesn't seem like the plot we want. Instead of putting each row as a point in a 2D plane by using the X and Y as the coordinate, it just created a line chart. Let's fix it. Please take a look at the plot method documentation. How should we change the command? Which kind of plot do we want to draw?

Yes, we want to draw a scatter plot using x and y as the Cartesian coordinates.

In [24]:

death_df.plot(x='X', y='Y', kind='scatter', label='Deaths')

death_df.plot(x='X', y='Y', kind='scatter', label='Deaths')

Out[24]:

<Axes: xlabel='X', ylabel='Y'>

I think I want to reduce the size of the dots and change the color to black. But it is difficult to find how to do that! It is sometimes quite annoying to figure out how to change how the visualization looks, especially when we use matplotlib. Unlike some other advanced tools, matplotlib does not provide a very coherent way to adjust your visualizations. That's one of the reasons why there are lots of visualization libraries that wrap matplotlib. Anyway, this is how you do it.

In [25]:

death_df.plot(x='X', y='Y', kind='scatter', label='Deaths', s=2, c='black')

death_df.plot(x='X', y='Y', kind='scatter', label='Deaths', s=2, c='black')

Out[25]:

<Axes: xlabel='X', ylabel='Y'>

Can we visualize both deaths and pumps?

In [26]:

death_df.plot(x='X', y='Y', s=2, c='black', kind='scatter', label='Deaths')
pump_df.plot(x='X', y='Y', kind='scatter', c='red', s=8, label='Pumps')

death_df.plot(x='X', y='Y', s=2, c='black', kind='scatter', label='Deaths') pump_df.plot(x='X', y='Y', kind='scatter', c='red', s=8, label='Pumps')

Out[26]:

<Axes: xlabel='X', ylabel='Y'>

Oh well, this is not what we want! We want to overlay them to see them together, right? How can we do that? Before going into that, we probably want to understand some key components of matplotlib figures.

Figure and Axes¶

Why do we have two separate plots? The reason is that, by default, the plot method creates a new \emph{figure} instead of putting them inside a single figure. In order to avoid it, we need to either create an Axes and tell plot to use that axes. What is an axes? See this illustration.

A figure can contain multiple axes (link). The figure below contains two axes:

and an axes can contain multiple plots (link).

Conveniently, when you call plot method, it creates an axes and returns it to you

In [27]:

ax = death_df.plot(x='X', y='Y', s=2, c='black', kind='scatter', label='Deaths')

ax = death_df.plot(x='X', y='Y', s=2, c='black', kind='scatter', label='Deaths')

In [28]:

ax

ax

Out[28]:

<Axes: xlabel='X', ylabel='Y'>

This object contains all the information and objects in the plot we see. Whatever we want to do with this axes (e.g., changing x or y scale, overlaying other data, changing the color or size of symbols, etc.) can be done by accessing this object.

Then you can pass this axes object to another plot to put both plots in the same axes. Note ax=ax in the second plot command. It tells the plot command where to draw the points.

In [29]:

ax = death_df.plot(x='X', y='Y', s=2, c='black', alpha=0.5, kind='scatter', label='Deaths')
pump_df.plot(x='X', y='Y', kind='scatter', c='red', s=8, label='Pumps', ax=ax)

ax = death_df.plot(x='X', y='Y', s=2, c='black', alpha=0.5, kind='scatter', label='Deaths') pump_df.plot(x='X', y='Y', kind='scatter', c='red', s=8, label='Pumps', ax=ax)

Out[29]:

<Axes: xlabel='X', ylabel='Y'>

Although simply invoking the plot() command is quick and easy when doing an exploratory data analysis, it is usually better to be formal about figure and axes objects.

Here is the recommended way to create a plot. Call the subplots() method (see https://matplotlib.org/3.2.1/api/_as_gen/matplotlib.pyplot.subplots.html) to get the figure and axes objects explicitly.

As you can see below, subplots() creates an empty figure and returns the figure and axes object to you. Then you can fill this empty canvas with your plots. Whatever manipulation you want to make about your figure (e.g., changing the size of the figure) or axes (e.g., drawing a new plot on it) can be done with fig and ax objects. So whenever possible, use this method!

Now, can you use this method to produce the same plot just above?

In [30]:

import matplotlib.pyplot as plt
fig, ax = plt.subplots()

# YOUR SOLUTION HERE

import matplotlib.pyplot as plt fig, ax = plt.subplots() # YOUR SOLUTION HERE

Out[30]:

<Axes: xlabel='X', ylabel='Y'>

Voronoi diagram¶

Let's try the Voronoi diagram. You can use the scipy.spatial.Voronoi and scipy.spatial.voronoi_plot_2d from scipy, the scientific python library.

In [31]:

from scipy.spatial import Voronoi, voronoi_plot_2d

from scipy.spatial import Voronoi, voronoi_plot_2d

Take a look at the documentation of Voronoi and voronoi_plot_2d and

Q3: produce a Voronoi diagram that shows the deaths, pumps, and voronoi cells

In [32]:

# you'll need this
points = pump_df.values
points

# you'll need this points = pump_df.values points

Out[32]:

array([[ 8.6512012, 17.8915997],
       [10.9847803, 18.5178509],
       [13.37819  , 17.3945408],
       [14.8798304, 17.8099194],
       [ 8.694768 , 14.9054699],
       [ 8.8644161, 12.75354  ],
       [12.5713596, 11.72717  ],
       [10.6609697,  7.428647 ],
       [13.5214596,  7.95825  ],
       [16.4348907,  9.2521296],
       [18.9143906,  9.7378187],
       [16.0051098,  5.0468378],
       [ 8.9994402,  5.1010232]])

In [33]:

# YOUR SOLUTION HERE

# YOUR SOLUTION HERE

Saving the figure¶

You can also save your figure into PDF, PNG, etc. If you run the following, the plot will not only be displayed here, but also be saved as foo.png.

In [34]:

import matplotlib.pyplot as plt
plt.plot([1,2,3], [4,2,3])
plt.savefig('foo.png')

import matplotlib.pyplot as plt plt.plot([1,2,3], [4,2,3]) plt.savefig('foo.png')

Q4: Save your Voronoi diagram. Make sure that your plot contains the scatterplot of deaths & pumps as well as the Voronoi cells

In [35]:

# YOUR SOLUTION HERE

# YOUR SOLUTION HERE

Ok, that was a brief introduction to pandas and some simple visualizations. Now let's talk about web a little bit.

HTML & CSS Basics¶

HTML review¶

Webpages are written in a standard markup language called HTML (HyperText Markup Language). The basic syntax of HTML consists of elements enclosed within < and > symbols. Markup tags often come in a pair, the opening tag without / and the closing tag with /. For instance, when we assign the title of the webpage, we write <title>This is the title of the page</title>. You can find tutorials and references from many websites, including W3Schools. Here is an example of a simple HTML document (from w3schools homepage):

<!DOCTYPE html>
<html>
<title>HTML Tutorial</title>
<body>

<h1>This is a heading</h1>
<p>This is a paragraph.</p>

</body>
</html>

Here is a list of important tags and their descriptions.

• <html> - Surrounds the entire document.

• <head> - Contains information about the document. E.g. the title, metadata, scripts to load, stylesheets, etc.

• <title> - Assigns title to the page. This is what you see in the tab and what you have when the page is bookmarked.

• <body> - The main part of the document.

• <h1>, <h2>, <h3>, ... - Headings (Smaller the number, larger the size).

• <p> - Paragraph. e.g., <p>Here is a paragraph</p>

• <br> - Line break.

• <em> - emphasize text.

• <strong> - Bold font.

• <a> - Defines a hyperlink and allows you to link out to the other webpages. See examples

• <img> - Place an image. See examples

• <ul>, <ol>, <li> - Unordered lists with bullets, ordered lists with numbers and each item in list respectively. See examples

• <table> - Make a table, specifying contents of each cell. See examples

• <!--> - Comments – will not be displayed.

• <span> - This will mark a certain part of text but will not necessarily change how they look. CSS or Javascript can access them and change how they look or behave.

• <div> - Similar to <span>, but used for a block that contains many elements.

CSS review¶

While HTML specifies the content and structure, it does not say how they should look.

CSS (Cascading Style Sheets) is the primary language that is used for the look and formatting of a web document. In the context of creating visualization, CSS becomes critical when you create web-based (Javascript-based) visualizations.

A CSS stylesheet consists of one or more selectors, properties and values. For example:

body {   
    background-color: white;   
    color: steelblue;   
}

Selectors are the HTML elements to which the specific styles (combination of properties and values) will be applied. In the above example, all text within the body tags will be in steelblue.

There are three ways to include CSS code in HTML. This is called "referencing".

Embed CSS in HTML - You can place the CSS code within style tags inside the head tags. This way you can keep everything within a single HTML file but does make the code lengthy.

<head>  			
  <style type="text/css">
      .description {
      font: 16px times-new-roman;
      }
      .viz {
      font: 10px sans-serif;
      } 
  </style>
</head>

Reference an external stylesheet from HTML is a much cleaner way but results in the creation of another file. To do this, you can copy the CSS code into a text file and save it as a .css file in the same folder as the HTML file. In the document head in the HTML code, you can then do the following:

<head>
  <link rel="stylesheet" href="main.css">
</head>

Attach inline styles - You can also directly attach the styles in-line along with the main HTML code in the body. This makes it easy to customize specific elements but makes the code very messy, because the design and content get mixed up.

<p style="color: green; font-size:36px; font-weight:bold;">Inline styles can be handy sometimes.</p>

Q5: Create a simple HTML page that displays the Voronoi diagram that you saved. Feel free to add more plots, explanations, and any styles. Make sure to check you can run the Python webserver and open the HTML file that you created.

Btw, you can also export Jupyter notebook into various formats. Click File -> Export Notebook As and play with it.

Now submit your work¶

Export your notebook to HTML (lab02_notebook_lastname_firstname.html). Then also rename your HTML (CSS) files from HTML/CSS exercise in the format of lab02_lastname_firstname. Upload these files to Canvas.

In [ ]: