Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save pavanandhukuri/f360ebb1ad119cd5319068a545569060 to your computer and use it in GitHub Desktop.
Save pavanandhukuri/f360ebb1ad119cd5319068a545569060 to your computer and use it in GitHub Desktop.
Created on Cognitive Class Labs
{
"cells": [
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"<a href=\"https://cognitiveclass.ai\"><img src = \"https://ibm.box.com/shared/static/9gegpsmnsoo25ikkbl4qzlvlyjbgxs5x.png\" width = 400> </a>\n",
"\n",
"<h1 align=center><font size = 5>Pie Charts, Box Plots, Scatter Plots, and Bubble Plots</font></h1>"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"## Introduction\n",
"\n",
"In this lab session, we continue exploring the Matplotlib library. More specificatlly, we will learn how to create pie charts, box plots, scatter plots, and bubble charts."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"## Table of Contents\n",
"\n",
"<div class=\"alert alert-block alert-info\" style=\"margin-top: 20px\">\n",
"\n",
"1. [Exploring Datasets with *p*andas](#0)<br>\n",
"2. [Downloading and Prepping Data](#2)<br>\n",
"3. [Visualizing Data using Matplotlib](#4) <br>\n",
"4. [Pie Charts](#6) <br>\n",
"5. [Box Plots](#8) <br>\n",
"6. [Scatter Plots](#10) <br>\n",
"7. [Bubble Plots](#12) <br> \n",
"</div>\n",
"<hr>"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"# Exploring Datasets with *pandas* and Matplotlib<a id=\"0\"></a>\n",
"\n",
"Toolkits: The course heavily relies on [*pandas*](http://pandas.pydata.org/) and [**Numpy**](http://www.numpy.org/) for data wrangling, analysis, and visualization. The primary plotting library we will explore in the course is [Matplotlib](http://matplotlib.org/).\n",
"\n",
"Dataset: Immigration to Canada from 1980 to 2013 - [International migration flows to and from selected countries - The 2015 revision](http://www.un.org/en/development/desa/population/migration/data/empirical2/migrationflows.shtml) from United Nation's website.\n",
"\n",
"The dataset contains annual data on the flows of international migrants as recorded by the countries of destination. The data presents both inflows and outflows according to the place of birth, citizenship or place of previous / next residence both for foreigners and nationals. In this lab, we will focus on the Canadian Immigration data."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"# Downloading and Prepping Data <a id=\"2\"></a>"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Import primary modules."
]
},
{
"cell_type": "code",
"execution_count": 1,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [],
"source": [
"import numpy as np # useful for many scientific computing in Python\n",
"import pandas as pd # primary data structure library"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Let's download and import our primary Canadian Immigration dataset using *pandas* `read_excel()` method. Normally, before we can do that, we would need to download a module which *pandas* requires to read in excel files. This module is **xlrd**. For your convenience, we have pre-installed this module, so you would not have to worry about that. Otherwise, you would need to run the following line of code to install the **xlrd** module:\n",
"```\n",
"!conda install -c anaconda xlrd --yes\n",
"```"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Download the dataset and read it into a *pandas* dataframe."
]
},
{
"cell_type": "code",
"execution_count": 2,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Solving environment: done\n",
"\n",
"\n",
"==> WARNING: A newer version of conda exists. <==\n",
" current version: 4.5.11\n",
" latest version: 4.7.12\n",
"\n",
"Please update conda by running\n",
"\n",
" $ conda update -n base -c defaults conda\n",
"\n",
"\n",
"\n",
"## Package Plan ##\n",
"\n",
" environment location: /home/jupyterlab/conda/envs/python\n",
"\n",
" added / updated specs: \n",
" - xlrd\n",
"\n",
"\n",
"The following packages will be downloaded:\n",
"\n",
" package | build\n",
" ---------------------------|-----------------\n",
" openssl-1.1.1 | h7b6447c_0 5.0 MB anaconda\n",
" certifi-2019.9.11 | py36_0 154 KB anaconda\n",
" xlrd-1.2.0 | py36_0 188 KB anaconda\n",
" ------------------------------------------------------------\n",
" Total: 5.4 MB\n",
"\n",
"The following packages will be UPDATED:\n",
"\n",
" certifi: 2019.9.11-py36_0 conda-forge --> 2019.9.11-py36_0 anaconda\n",
" openssl: 1.1.1c-h516909a_0 conda-forge --> 1.1.1-h7b6447c_0 anaconda\n",
" xlrd: 1.1.0-py37_1 --> 1.2.0-py36_0 anaconda\n",
"\n",
"\n",
"Downloading and Extracting Packages\n",
"openssl-1.1.1 | 5.0 MB | ##################################### | 100% \n",
"certifi-2019.9.11 | 154 KB | ##################################### | 100% \n",
"xlrd-1.2.0 | 188 KB | ##################################### | 100% \n",
"Preparing transaction: done\n",
"Verifying transaction: done\n",
"Executing transaction: done\n",
"Data downloaded and read into a dataframe!\n"
]
}
],
"source": [
"!conda install -c anaconda xlrd --yes\n",
"df_can = pd.read_excel('https://s3-api.us-geo.objectstorage.softlayer.net/cf-courses-data/CognitiveClass/DV0101EN/labs/Data_Files/Canada.xlsx',\n",
" sheet_name='Canada by Citizenship',\n",
" skiprows=range(20),\n",
" skipfooter=2\n",
" )\n",
"\n",
"print('Data downloaded and read into a dataframe!')"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Let's take a look at the first five items in our dataset."
]
},
{
"cell_type": "code",
"execution_count": 3,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>Type</th>\n",
" <th>Coverage</th>\n",
" <th>OdName</th>\n",
" <th>AREA</th>\n",
" <th>AreaName</th>\n",
" <th>REG</th>\n",
" <th>RegName</th>\n",
" <th>DEV</th>\n",
" <th>DevName</th>\n",
" <th>1980</th>\n",
" <th>...</th>\n",
" <th>2004</th>\n",
" <th>2005</th>\n",
" <th>2006</th>\n",
" <th>2007</th>\n",
" <th>2008</th>\n",
" <th>2009</th>\n",
" <th>2010</th>\n",
" <th>2011</th>\n",
" <th>2012</th>\n",
" <th>2013</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>0</th>\n",
" <td>Immigrants</td>\n",
" <td>Foreigners</td>\n",
" <td>Afghanistan</td>\n",
" <td>935</td>\n",
" <td>Asia</td>\n",
" <td>5501</td>\n",
" <td>Southern Asia</td>\n",
" <td>902</td>\n",
" <td>Developing regions</td>\n",
" <td>16</td>\n",
" <td>...</td>\n",
" <td>2978</td>\n",
" <td>3436</td>\n",
" <td>3009</td>\n",
" <td>2652</td>\n",
" <td>2111</td>\n",
" <td>1746</td>\n",
" <td>1758</td>\n",
" <td>2203</td>\n",
" <td>2635</td>\n",
" <td>2004</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1</th>\n",
" <td>Immigrants</td>\n",
" <td>Foreigners</td>\n",
" <td>Albania</td>\n",
" <td>908</td>\n",
" <td>Europe</td>\n",
" <td>925</td>\n",
" <td>Southern Europe</td>\n",
" <td>901</td>\n",
" <td>Developed regions</td>\n",
" <td>1</td>\n",
" <td>...</td>\n",
" <td>1450</td>\n",
" <td>1223</td>\n",
" <td>856</td>\n",
" <td>702</td>\n",
" <td>560</td>\n",
" <td>716</td>\n",
" <td>561</td>\n",
" <td>539</td>\n",
" <td>620</td>\n",
" <td>603</td>\n",
" </tr>\n",
" <tr>\n",
" <th>2</th>\n",
" <td>Immigrants</td>\n",
" <td>Foreigners</td>\n",
" <td>Algeria</td>\n",
" <td>903</td>\n",
" <td>Africa</td>\n",
" <td>912</td>\n",
" <td>Northern Africa</td>\n",
" <td>902</td>\n",
" <td>Developing regions</td>\n",
" <td>80</td>\n",
" <td>...</td>\n",
" <td>3616</td>\n",
" <td>3626</td>\n",
" <td>4807</td>\n",
" <td>3623</td>\n",
" <td>4005</td>\n",
" <td>5393</td>\n",
" <td>4752</td>\n",
" <td>4325</td>\n",
" <td>3774</td>\n",
" <td>4331</td>\n",
" </tr>\n",
" <tr>\n",
" <th>3</th>\n",
" <td>Immigrants</td>\n",
" <td>Foreigners</td>\n",
" <td>American Samoa</td>\n",
" <td>909</td>\n",
" <td>Oceania</td>\n",
" <td>957</td>\n",
" <td>Polynesia</td>\n",
" <td>902</td>\n",
" <td>Developing regions</td>\n",
" <td>0</td>\n",
" <td>...</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>1</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" </tr>\n",
" <tr>\n",
" <th>4</th>\n",
" <td>Immigrants</td>\n",
" <td>Foreigners</td>\n",
" <td>Andorra</td>\n",
" <td>908</td>\n",
" <td>Europe</td>\n",
" <td>925</td>\n",
" <td>Southern Europe</td>\n",
" <td>901</td>\n",
" <td>Developed regions</td>\n",
" <td>0</td>\n",
" <td>...</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>1</td>\n",
" <td>1</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>1</td>\n",
" <td>1</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"<p>5 rows × 43 columns</p>\n",
"</div>"
],
"text/plain": [
" Type Coverage OdName AREA AreaName REG \\\n",
"0 Immigrants Foreigners Afghanistan 935 Asia 5501 \n",
"1 Immigrants Foreigners Albania 908 Europe 925 \n",
"2 Immigrants Foreigners Algeria 903 Africa 912 \n",
"3 Immigrants Foreigners American Samoa 909 Oceania 957 \n",
"4 Immigrants Foreigners Andorra 908 Europe 925 \n",
"\n",
" RegName DEV DevName 1980 ... 2004 2005 2006 \\\n",
"0 Southern Asia 902 Developing regions 16 ... 2978 3436 3009 \n",
"1 Southern Europe 901 Developed regions 1 ... 1450 1223 856 \n",
"2 Northern Africa 902 Developing regions 80 ... 3616 3626 4807 \n",
"3 Polynesia 902 Developing regions 0 ... 0 0 1 \n",
"4 Southern Europe 901 Developed regions 0 ... 0 0 1 \n",
"\n",
" 2007 2008 2009 2010 2011 2012 2013 \n",
"0 2652 2111 1746 1758 2203 2635 2004 \n",
"1 702 560 716 561 539 620 603 \n",
"2 3623 4005 5393 4752 4325 3774 4331 \n",
"3 0 0 0 0 0 0 0 \n",
"4 1 0 0 0 0 1 1 \n",
"\n",
"[5 rows x 43 columns]"
]
},
"execution_count": 3,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_can.head()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Let's find out how many entries there are in our dataset."
]
},
{
"cell_type": "code",
"execution_count": 4,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"(195, 43)\n"
]
}
],
"source": [
"# print the dimensions of the dataframe\n",
"print(df_can.shape)"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Clean up data. We will make some modifications to the original dataset to make it easier to create our visualizations. Refer to *Introduction to Matplotlib and Line Plots* and *Area Plots, Histograms, and Bar Plots* for a detailed description of this preprocessing."
]
},
{
"cell_type": "code",
"execution_count": 5,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"data dimensions: (195, 38)\n"
]
}
],
"source": [
"# clean up the dataset to remove unnecessary columns (eg. REG) \n",
"df_can.drop(['AREA', 'REG', 'DEV', 'Type', 'Coverage'], axis=1, inplace=True)\n",
"\n",
"# let's rename the columns so that they make sense\n",
"df_can.rename(columns={'OdName':'Country', 'AreaName':'Continent','RegName':'Region'}, inplace=True)\n",
"\n",
"# for sake of consistency, let's also make all column labels of type string\n",
"df_can.columns = list(map(str, df_can.columns))\n",
"\n",
"# set the country name as index - useful for quickly looking up countries using .loc method\n",
"df_can.set_index('Country', inplace=True)\n",
"\n",
"# add total column\n",
"df_can['Total'] = df_can.sum(axis=1)\n",
"\n",
"# years that we will be using in this lesson - useful for plotting later on\n",
"years = list(map(str, range(1980, 2014)))\n",
"print('data dimensions:', df_can.shape)"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"# Visualizing Data using Matplotlib<a id=\"4\"></a>"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Import `Matplotlib`."
]
},
{
"cell_type": "code",
"execution_count": 6,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Matplotlib version: 3.1.1\n"
]
}
],
"source": [
"%matplotlib inline\n",
"\n",
"import matplotlib as mpl\n",
"import matplotlib.pyplot as plt\n",
"\n",
"mpl.style.use('ggplot') # optional: for ggplot-like style\n",
"\n",
"# check for latest version of Matplotlib\n",
"print('Matplotlib version: ', mpl.__version__) # >= 2.0.0"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"# Pie Charts <a id=\"6\"></a>\n",
"\n",
"A `pie chart` is a circualr graphic that displays numeric proportions by dividing a circle (or pie) into proportional slices. You are most likely already familiar with pie charts as it is widely used in business and media. We can create pie charts in Matplotlib by passing in the `kind=pie` keyword.\n",
"\n",
"Let's use a pie chart to explore the proportion (percentage) of new immigrants grouped by continents for the entire time period from 1980 to 2013. "
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 1: Gather data. \n",
"\n",
"We will use *pandas* `groupby` method to summarize the immigration data by `Continent`. The general process of `groupby` involves the following steps:\n",
"\n",
"1. **Split:** Splitting the data into groups based on some criteria.\n",
"2. **Apply:** Applying a function to each group independently:\n",
" .sum()\n",
" .count()\n",
" .mean() \n",
" .std() \n",
" .aggregate()\n",
" .apply()\n",
" .etc..\n",
"3. **Combine:** Combining the results into a data structure."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"<img src=\"https://s3-api.us-geo.objectstorage.softlayer.net/cf-courses-data/CognitiveClass/DV0101EN/labs/Images/Mod3Fig4SplitApplyCombine.png\" height=400 align=\"center\">"
]
},
{
"cell_type": "code",
"execution_count": 7,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"<class 'pandas.core.groupby.generic.DataFrameGroupBy'>\n"
]
},
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>1980</th>\n",
" <th>1981</th>\n",
" <th>1982</th>\n",
" <th>1983</th>\n",
" <th>1984</th>\n",
" <th>1985</th>\n",
" <th>1986</th>\n",
" <th>1987</th>\n",
" <th>1988</th>\n",
" <th>1989</th>\n",
" <th>...</th>\n",
" <th>2005</th>\n",
" <th>2006</th>\n",
" <th>2007</th>\n",
" <th>2008</th>\n",
" <th>2009</th>\n",
" <th>2010</th>\n",
" <th>2011</th>\n",
" <th>2012</th>\n",
" <th>2013</th>\n",
" <th>Total</th>\n",
" </tr>\n",
" <tr>\n",
" <th>Continent</th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>Africa</th>\n",
" <td>3951</td>\n",
" <td>4363</td>\n",
" <td>3819</td>\n",
" <td>2671</td>\n",
" <td>2639</td>\n",
" <td>2650</td>\n",
" <td>3782</td>\n",
" <td>7494</td>\n",
" <td>7552</td>\n",
" <td>9894</td>\n",
" <td>...</td>\n",
" <td>27523</td>\n",
" <td>29188</td>\n",
" <td>28284</td>\n",
" <td>29890</td>\n",
" <td>34534</td>\n",
" <td>40892</td>\n",
" <td>35441</td>\n",
" <td>38083</td>\n",
" <td>38543</td>\n",
" <td>618948</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Asia</th>\n",
" <td>31025</td>\n",
" <td>34314</td>\n",
" <td>30214</td>\n",
" <td>24696</td>\n",
" <td>27274</td>\n",
" <td>23850</td>\n",
" <td>28739</td>\n",
" <td>43203</td>\n",
" <td>47454</td>\n",
" <td>60256</td>\n",
" <td>...</td>\n",
" <td>159253</td>\n",
" <td>149054</td>\n",
" <td>133459</td>\n",
" <td>139894</td>\n",
" <td>141434</td>\n",
" <td>163845</td>\n",
" <td>146894</td>\n",
" <td>152218</td>\n",
" <td>155075</td>\n",
" <td>3317794</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Europe</th>\n",
" <td>39760</td>\n",
" <td>44802</td>\n",
" <td>42720</td>\n",
" <td>24638</td>\n",
" <td>22287</td>\n",
" <td>20844</td>\n",
" <td>24370</td>\n",
" <td>46698</td>\n",
" <td>54726</td>\n",
" <td>60893</td>\n",
" <td>...</td>\n",
" <td>35955</td>\n",
" <td>33053</td>\n",
" <td>33495</td>\n",
" <td>34692</td>\n",
" <td>35078</td>\n",
" <td>33425</td>\n",
" <td>26778</td>\n",
" <td>29177</td>\n",
" <td>28691</td>\n",
" <td>1410947</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Latin America and the Caribbean</th>\n",
" <td>13081</td>\n",
" <td>15215</td>\n",
" <td>16769</td>\n",
" <td>15427</td>\n",
" <td>13678</td>\n",
" <td>15171</td>\n",
" <td>21179</td>\n",
" <td>28471</td>\n",
" <td>21924</td>\n",
" <td>25060</td>\n",
" <td>...</td>\n",
" <td>24747</td>\n",
" <td>24676</td>\n",
" <td>26011</td>\n",
" <td>26547</td>\n",
" <td>26867</td>\n",
" <td>28818</td>\n",
" <td>27856</td>\n",
" <td>27173</td>\n",
" <td>24950</td>\n",
" <td>765148</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Northern America</th>\n",
" <td>9378</td>\n",
" <td>10030</td>\n",
" <td>9074</td>\n",
" <td>7100</td>\n",
" <td>6661</td>\n",
" <td>6543</td>\n",
" <td>7074</td>\n",
" <td>7705</td>\n",
" <td>6469</td>\n",
" <td>6790</td>\n",
" <td>...</td>\n",
" <td>8394</td>\n",
" <td>9613</td>\n",
" <td>9463</td>\n",
" <td>10190</td>\n",
" <td>8995</td>\n",
" <td>8142</td>\n",
" <td>7677</td>\n",
" <td>7892</td>\n",
" <td>8503</td>\n",
" <td>241142</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"<p>5 rows × 35 columns</p>\n",
"</div>"
],
"text/plain": [
" 1980 1981 1982 1983 1984 1985 \\\n",
"Continent \n",
"Africa 3951 4363 3819 2671 2639 2650 \n",
"Asia 31025 34314 30214 24696 27274 23850 \n",
"Europe 39760 44802 42720 24638 22287 20844 \n",
"Latin America and the Caribbean 13081 15215 16769 15427 13678 15171 \n",
"Northern America 9378 10030 9074 7100 6661 6543 \n",
"\n",
" 1986 1987 1988 1989 ... 2005 \\\n",
"Continent ... \n",
"Africa 3782 7494 7552 9894 ... 27523 \n",
"Asia 28739 43203 47454 60256 ... 159253 \n",
"Europe 24370 46698 54726 60893 ... 35955 \n",
"Latin America and the Caribbean 21179 28471 21924 25060 ... 24747 \n",
"Northern America 7074 7705 6469 6790 ... 8394 \n",
"\n",
" 2006 2007 2008 2009 2010 \\\n",
"Continent \n",
"Africa 29188 28284 29890 34534 40892 \n",
"Asia 149054 133459 139894 141434 163845 \n",
"Europe 33053 33495 34692 35078 33425 \n",
"Latin America and the Caribbean 24676 26011 26547 26867 28818 \n",
"Northern America 9613 9463 10190 8995 8142 \n",
"\n",
" 2011 2012 2013 Total \n",
"Continent \n",
"Africa 35441 38083 38543 618948 \n",
"Asia 146894 152218 155075 3317794 \n",
"Europe 26778 29177 28691 1410947 \n",
"Latin America and the Caribbean 27856 27173 24950 765148 \n",
"Northern America 7677 7892 8503 241142 \n",
"\n",
"[5 rows x 35 columns]"
]
},
"execution_count": 7,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# group countries by continents and apply sum() function \n",
"df_continents = df_can.groupby('Continent', axis=0).sum()\n",
"\n",
"# note: the output of the groupby method is a `groupby' object. \n",
"# we can not use it further until we apply a function (eg .sum())\n",
"print(type(df_can.groupby('Continent', axis=0)))\n",
"\n",
"df_continents.head()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 2: Plot the data. We will pass in `kind = 'pie'` keyword, along with the following additional parameters:\n",
"- `autopct` - is a string or function used to label the wedges with their numeric value. The label will be placed inside the wedge. If it is a format string, the label will be `fmt%pct`.\n",
"- `startangle` - rotates the start of the pie chart by angle degrees counterclockwise from the x-axis.\n",
"- `shadow` - Draws a shadow beneath the pie (to give a 3D feel)."
]
},
{
"cell_type": "code",
"execution_count": 8,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
"<Figure size 360x432 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# autopct create %, start angle represent starting point\n",
"df_continents['Total'].plot(kind='pie',\n",
" figsize=(5, 6),\n",
" autopct='%1.1f%%', # add in percentages\n",
" startangle=90, # start angle 90° (Africa)\n",
" shadow=True, # add shadow \n",
" )\n",
"\n",
"plt.title('Immigration to Canada by Continent [1980 - 2013]')\n",
"plt.axis('equal') # Sets the pie chart to look like a circle.\n",
"\n",
"plt.show()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"The above visual is not very clear, the numbers and text overlap in some instances. Let's make a few modifications to improve the visuals:\n",
"\n",
"* Remove the text labels on the pie chart by passing in `legend` and add it as a seperate legend using `plt.legend()`.\n",
"* Push out the percentages to sit just outside the pie chart by passing in `pctdistance` parameter.\n",
"* Pass in a custom set of colors for continents by passing in `colors` parameter.\n",
"* **Explode** the pie chart to emphasize the lowest three continents (Africa, North America, and Latin America and Carribbean) by pasing in `explode` parameter.\n"
]
},
{
"cell_type": "code",
"execution_count": 17,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"image/png": "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5s+fH/zzzz8H2Gw2SUlJ8Xr44YdPWywWw/Lly4NNJpNt4cKFB0NCQgoPHDjg8cILLzRNT0938/T0tL399ttH27dvnz9+/Pjm/v7+1n379nmHh4fntm3bNm/Xrl0+s2fPPpaWlub27LPPNjt58qQHAMycOfNor169ckaPHh125swZd7PZbHjooYfOTJgw4bxzvK+88kqDDRs2BBQUFBgiIyOz58yZc9RgMKC4/c3JyZGJEye2OHLkiGfz5s3z8/PzxbnO9957r+6FCxdMI0eObO3v729dtWrVAQCYNm1ao40bN/p7eHjYvv7660MNGza0nj592u3ZZ59tdvr0aXcAmD59+rHevXvnONb38ccf1x02bNiF6OjoHAAwGAy499570wGt5WzGjBlNCwoKDB4eHrZ33333SERERMH8+fOD4+Pj/c1msyEvL88we/bs1IceeqjVL7/8shcATp8+bRo+fHirtLQ0jyFDhlyYPn36KQAoLCzEI4880nz//v3eTZs2zf/kk09SfX19bb/99pv3yy+/3CQ3N9cQEBBgnTNnTmrjxo0tH3/8cciiRYtCLRaLNGnSpODTTz894uvraxs/fnxzHx+fwqSkJJ8LFy6Ynn/++RP2mInm7ejibs63zTJ5yOMicvlvyORp7Nn14ZsObPsypRBAAQD8tgtnNm7D+n63or/LAq7GcvSEzM3DrUITsrMHMlIAoH7L9tWpu2JRjABeB9AzNtHy0NROpouuDoiIqKaotV0Wi9KrV6/sNWvWJG/cuDEpJibm4rvvvls/LCzMfPfdd5978MEHzyQkJCQVlWwVFhbKunXr9k2bNu34u+++27CouhctWhQ0ZMiQi3369Mk+duyY56lTpy4nwykpKV6fffZZyqpVq/Z98MEHjby8vGwbN25MioyMzPn666+DAeDvf/97s9dee+3Yhg0b9r300ksnpk6derlrXWpqqueyZcsOvPXWWycct/nCCy807datW9amTZuS1q9fn9ShQ4d8AJg7d27qhg0b9q1ZsyZpwYIF9c6dO3fVHfZJkyadjY+P3/fLL7/szc/PNyxbtsy/pP39+OOP63p6eto2bdqU9Mwzz5w6cOCAj3OdTz/99Nng4GDL4sWLD9iTsfz8fEOXLl2yN23alNSlS5fszz//PBQApk6d2uTRRx89Ex8fv2/+/PmHp06d2ty5voMHD3pF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\n",
"text/plain": [
"<Figure size 1080x432 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"colors_list = ['gold', 'yellowgreen', 'lightcoral', 'lightskyblue', 'lightgreen', 'pink']\n",
"explode_list = [0.1, 0, 0, 0, 0.1, 0.1] # ratio for each continent with which to offset each wedge.\n",
"\n",
"df_continents['Total'].plot(kind='pie',\n",
" figsize=(15, 6),\n",
" autopct='%1.1f%%', \n",
" startangle=90, \n",
" shadow=True, \n",
" labels=None, # turn off labels on pie chart\n",
" pctdistance=1.12, # the ratio between the center of each pie slice and the start of the text generated by autopct \n",
" colors=colors_list, # add custom colors\n",
" explode=explode_list # 'explode' lowest 3 continents\n",
" )\n",
"\n",
"# scale the title up by 12% to match pctdistance\n",
"plt.title('Immigration to Canada by Continent [1980 - 2013]', y=1.12) \n",
"\n",
"plt.axis('equal') \n",
"\n",
"# add legend\n",
"plt.legend(labels=df_continents.index, loc='upper left') \n",
"\n",
"plt.show()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"**Question:** Using a pie chart, explore the proportion (percentage) of new immigrants grouped by continents in the year 2013.\n",
"\n",
"**Note**: You might need to play with the explore values in order to fix any overlapping slice values."
]
},
{
"cell_type": "code",
"execution_count": 27,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"image/png": "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7ZdVbGxss61bt/o6b//Pf/5TMzs7+9L77mpeh6L88ssvvv369Wt26623turcuXPLkSNHNnBsvzTHjh0zDBkypBEAzJ07NzQuLq6+8z4HDx707Nq1a8vriZPomqVKU5MZO/R6TNHp2KuhPGXm55i9/L0qqkLmeP+xKNjGjwVG1I2qoPNVVf0ArGZSRkTu7Ib44/75mfAO5dnesIhz5Xpfs02bNtXw8/Mr7N69ew4AjB49+ty1tPP999+HNm/ePGfJkiVBttkYy5XZbMbAgQMzAGSUd9vl5csvv4wYMmTIRX9//+u+SejJkyc9xowZ0/iDDz44FB0dnWO1WrFw4cLgzMxMXVnaN5vNqFevnvmrr746dL2xEFUE024ZrNNhnqcBV3y5QdfvYm6WyaduQEU8t3kAtjqstweQU6dF+3CDl49fMce4s27QkrJ+vFcZEbmjGyIhu1EsXbo0cMaMGbUtFosuMDDQMnv27EN5eXm6RYsWhet0OrVixYrQKVOmHE1ISAjw8/MrfOGFF87ExsY2a926dfZvv/0WkJWVpX/77beP9OrV64o/KPv37/fKzc3VvfHGG8c+/PDD2vaEbO7cuaE//fRTkNVqlUOHDvk89thjp81ms2758uWhBoPBumDBgj/DwsIK9+/f7zVhwoT6aWlpHt7e3tb33nvvr1atWuWPGDEiKjAw0JKSkuJrNBpzmzdvnrdr1y6/6dOnHz158qTHc8891+DEiRNeADB16tS/unfvnjN48ODGZ86c8TSZTLphw4adGTly5HnneF977bXaGzZsCCooKNC1bds2e8aMGX/pdDoUd705OTkyatSohocPH/aOiorKz8/Pv+K2tP/9739rXrhwwTBo0KCbAgMDLatWrdoPAC+//HKdhISEQC8vL+vnn39+IDIy0nL69GmP5557rsHp06c9AWDSpElHe/TokePY3uzZs2vefffdF6Kjo3MAQKfT4aGHHkoDtMrZ5MmT6xcUFOi8vLys77///uGWLVsWzJ07N3TdunWBJpNJl5eXp5s+ffqRYcOGNd28efNeADh9+rThvvvua3ry5EmvmJiYC5MmTToFAIWFhRg+fHjUvn37fOvXr5//v//974i/v79127ZtvlOmTKmXm5urCwoKssyYMeNI3bp1zbNnzw5buHBhuNlslnr16hV8/PHHh/39/a0jRoyI8vPzK0xO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\n",
"text/plain": [
"<Figure size 1080x432 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"### type your answer here\n",
"colors_list = ['gold', 'yellowgreen', 'lightcoral', 'lightskyblue', 'lightgreen', 'pink']\n",
"explode_list = [0, 0, 0, 0.1, 0.1, 0.1] # ratio for each continent with which to offset each wedge.\n",
"\n",
"df_continents[\"2013\"].plot(kind='pie', figsize=(15, 6), explode=explode_list, colors=colors_list, autopct='%1.1f%%', pctdistance=1.12, startangle=90, \n",
" shadow=True, \n",
" labels=None )\n",
"plt.title('Immigration to Canada by Continent in 2013', y=1.12) \n",
"\n",
"plt.axis('equal') \n",
"plt.legend(labels=df_continents.index, loc='upper left') \n",
"plt.show()\n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"explode_list = [0.1, 0, 0, 0, 0.1, 0.2] # ratio for each continent with which to offset each wedge.\n",
"-->\n",
"\n",
"<!--\n",
"df_continents['2013'].plot(kind='pie',\n",
" figsize=(15, 6),\n",
" autopct='%1.1f%%', \n",
" startangle=90, \n",
" shadow=True, \n",
" labels=None, # turn off labels on pie chart\n",
" pctdistance=1.12, # the ratio between the pie center and start of text label\n",
" explode=explode_list # 'explode' lowest 3 continents\n",
" )\n",
"-->\n",
"\n",
"<!--\n",
"\\\\ # scale the title up by 12% to match pctdistance\n",
"plt.title('Immigration to Canada by Continent in 2013', y=1.12) \n",
"plt.axis('equal') \n",
"-->\n",
"\n",
"<!--\n",
"\\\\ # add legend\n",
"plt.legend(labels=df_continents.index, loc='upper left') \n",
"-->\n",
"\n",
"<!--\n",
"\\\\ # show plot\n",
"plt.show()\n",
"-->"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"# Box Plots <a id=\"8\"></a>\n",
"\n",
"A `box plot` is a way of statistically representing the *distribution* of the data through five main dimensions: \n",
"\n",
"- **Minimun:** Smallest number in the dataset.\n",
"- **First quartile:** Middle number between the `minimum` and the `median`.\n",
"- **Second quartile (Median):** Middle number of the (sorted) dataset.\n",
"- **Third quartile:** Middle number between `median` and `maximum`.\n",
"- **Maximum:** Highest number in the dataset."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"<img src=\"https://s3-api.us-geo.objectstorage.softlayer.net/cf-courses-data/CognitiveClass/DV0101EN/labs/Images/boxplot_complete.png\" width=440, align=\"center\">"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"To make a `box plot`, we can use `kind=box` in `plot` method invoked on a *pandas* series or dataframe.\n",
"\n",
"Let's plot the box plot for the Japanese immigrants between 1980 - 2013."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 1: Get the dataset. Even though we are extracting the data for just one country, we will obtain it as a dataframe. This will help us with calling the `dataframe.describe()` method to view the percentiles."
]
},
{
"cell_type": "code",
"execution_count": 28,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th>Country</th>\n",
" <th>Japan</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>1980</th>\n",
" <td>701</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1981</th>\n",
" <td>756</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1982</th>\n",
" <td>598</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1983</th>\n",
" <td>309</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1984</th>\n",
" <td>246</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
"Country Japan\n",
"1980 701\n",
"1981 756\n",
"1982 598\n",
"1983 309\n",
"1984 246"
]
},
"execution_count": 28,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# to get a dataframe, place extra square brackets around 'Japan'.\n",
"df_japan = df_can.loc[['Japan'], years].transpose()\n",
"df_japan.head()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 2: Plot by passing in `kind='box'`."
]
},
{
"cell_type": "code",
"execution_count": 29,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
"<Figure size 576x432 with 1 Axes>"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"df_japan.plot(kind='box', figsize=(8, 6))\n",
"\n",
"plt.title('Box plot of Japanese Immigrants from 1980 - 2013')\n",
"plt.ylabel('Number of Immigrants')\n",
"\n",
"plt.show()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"We can immediately make a few key observations from the plot above:\n",
"1. The minimum number of immigrants is around 200 (min), maximum number is around 1300 (max), and median number of immigrants is around 900 (median).\n",
"2. 25% of the years for period 1980 - 2013 had an annual immigrant count of ~500 or fewer (First quartile).\n",
"2. 75% of the years for period 1980 - 2013 had an annual immigrant count of ~1100 or fewer (Third quartile).\n",
"\n",
"We can view the actual numbers by calling the `describe()` method on the dataframe."
]
},
{
"cell_type": "code",
"execution_count": 30,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th>Country</th>\n",
" <th>Japan</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>count</th>\n",
" <td>34.000000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>mean</th>\n",
" <td>814.911765</td>\n",
" </tr>\n",
" <tr>\n",
" <th>std</th>\n",
" <td>337.219771</td>\n",
" </tr>\n",
" <tr>\n",
" <th>min</th>\n",
" <td>198.000000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>25%</th>\n",
" <td>529.000000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>50%</th>\n",
" <td>902.000000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>75%</th>\n",
" <td>1079.000000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>max</th>\n",
" <td>1284.000000</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
"Country Japan\n",
"count 34.000000\n",
"mean 814.911765\n",
"std 337.219771\n",
"min 198.000000\n",
"25% 529.000000\n",
"50% 902.000000\n",
"75% 1079.000000\n",
"max 1284.000000"
]
},
"execution_count": 30,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_japan.describe()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"One of the key benefits of box plots is comparing the distribution of multiple datasets. In one of the previous labs, we observed that China and India had very similar immigration trends. Let's analyize these two countries further using box plots.\n",
"\n",
"**Question:** Compare the distribution of the number of new immigrants from India and China for the period 1980 - 2013."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 1: Get the dataset for China and India and call the dataframe **df_CI**."
]
},
{
"cell_type": "code",
"execution_count": 32,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th>Country</th>\n",
" <th>India</th>\n",
" <th>China</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>1980</th>\n",
" <td>8880</td>\n",
" <td>5123</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1981</th>\n",
" <td>8670</td>\n",
" <td>6682</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1982</th>\n",
" <td>8147</td>\n",
" <td>3308</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1983</th>\n",
" <td>7338</td>\n",
" <td>1863</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1984</th>\n",
" <td>5704</td>\n",
" <td>1527</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
"Country India China\n",
"1980 8880 5123\n",
"1981 8670 6682\n",
"1982 8147 3308\n",
"1983 7338 1863\n",
"1984 5704 1527"
]
},
"execution_count": 32,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"### type your answer here\n",
"df_CI = df_can.loc[['India', 'China'], years].transpose()\n",
"df_CI.head()\n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"df_CI= df_can.loc[['China', 'India'], years].transpose()\n",
"df_CI.head()\n",
"-->"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Let's view the percentages associated with both countries using the `describe()` method."
]
},
{
"cell_type": "code",
"execution_count": 33,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th>Country</th>\n",
" <th>India</th>\n",
" <th>China</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>count</th>\n",
" <td>34.000000</td>\n",
" <td>34.000000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>mean</th>\n",
" <td>20350.117647</td>\n",
" <td>19410.647059</td>\n",
" </tr>\n",
" <tr>\n",
" <th>std</th>\n",
" <td>10007.342579</td>\n",
" <td>13568.230790</td>\n",
" </tr>\n",
" <tr>\n",
" <th>min</th>\n",
" <td>4211.000000</td>\n",
" <td>1527.000000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>25%</th>\n",
" <td>10637.750000</td>\n",
" <td>5512.750000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>50%</th>\n",
" <td>20235.000000</td>\n",
" <td>19945.000000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>75%</th>\n",
" <td>28699.500000</td>\n",
" <td>31568.500000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>max</th>\n",
" <td>36210.000000</td>\n",
" <td>42584.000000</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
"Country India China\n",
"count 34.000000 34.000000\n",
"mean 20350.117647 19410.647059\n",
"std 10007.342579 13568.230790\n",
"min 4211.000000 1527.000000\n",
"25% 10637.750000 5512.750000\n",
"50% 20235.000000 19945.000000\n",
"75% 28699.500000 31568.500000\n",
"max 36210.000000 42584.000000"
]
},
"execution_count": 33,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"### type your answer here\n",
"df_CI.describe()\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"df_CI.describe()\n",
"-->"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 2: Plot data."
]
},
{
"cell_type": "code",
"execution_count": 34,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/plain": [
"<matplotlib.axes._subplots.AxesSubplot at 0x7f1965088a20>"
]
},
"execution_count": 34,
"metadata": {},
"output_type": "execute_result"
},
{
"data": {
"image/png": "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\n",
"text/plain": [
"<Figure size 432x288 with 1 Axes>"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"### type your answer here\n",
"df_CI.plot(kind='box')\n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"df_CI.plot(kind='box', figsize=(10, 7))\n",
"-->\n",
"\n",
"<!--\n",
"plt.title('Box plots of Immigrants from China and India (1980 - 2013)')\n",
"plt.xlabel('Number of Immigrants')\n",
"-->\n",
"\n",
"<!--\n",
"plt.show()\n",
"-->"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"We can observe that, while both countries have around the same median immigrant population (~20,000), China's immigrant population range is more spread out than India's. The maximum population from India for any year (36,210) is around 15% lower than the maximum population from China (42,584).\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"If you prefer to create horizontal box plots, you can pass the `vert` parameter in the **plot** function and assign it to *False*. You can also specify a different color in case you are not a big fan of the default red color."
]
},
{
"cell_type": "code",
"execution_count": 35,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
"<Figure size 720x504 with 1 Axes>"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"# horizontal box plots\n",
"df_CI.plot(kind='box', figsize=(10, 7), color='blue', vert=False)\n",
"\n",
"plt.title('Box plots of Immigrants from China and India (1980 - 2013)')\n",
"plt.xlabel('Number of Immigrants')\n",
"\n",
"plt.show()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"**Subplots**\n",
"\n",
"Often times we might want to plot multiple plots within the same figure. For example, we might want to perform a side by side comparison of the box plot with the line plot of China and India's immigration.\n",
"\n",
"To visualize multiple plots together, we can create a **`figure`** (overall canvas) and divide it into **`subplots`**, each containing a plot. With **subplots**, we usually work with the **artist layer** instead of the **scripting layer**. \n",
"\n",
"Typical syntax is : <br>\n",
"```python\n",
" fig = plt.figure() # create figure\n",
" ax = fig.add_subplot(nrows, ncols, plot_number) # create subplots\n",
"```\n",
"Where\n",
"- `nrows` and `ncols` are used to notionally split the figure into (`nrows` \\* `ncols`) sub-axes, \n",
"- `plot_number` is used to identify the particular subplot that this function is to create within the notional grid. `plot_number` starts at 1, increments across rows first and has a maximum of `nrows` * `ncols` as shown below.\n",
"\n",
"<img src=\"https://s3-api.us-geo.objectstorage.softlayer.net/cf-courses-data/CognitiveClass/DV0101EN/labs/Images/Mod3Fig5Subplots_V2.png\" width=500 align=\"center\">"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"We can then specify which subplot to place each plot by passing in the `ax` paramemter in `plot()` method as follows:"
]
},
{
"cell_type": "code",
"execution_count": 36,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"image/png": "iVBORw0KGgoAAAANSUhEUgAABJ8AAAGHCAYAAAAeMPMgAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4xLjEsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy8QZhcZAAAgAElEQVR4nOzdeZgU1b3/8fd39oVlgAHZRFBAAUHQqEgQIQpuKK5NEjcS98Qbc2PiNT+zmERzvYnR5MZrNDGJiZpoi7sxKi6AigsqoMCIsik7DNsAw6x9fn+cGmx6umftnh7g83qefma66tSpU/vpb506Zc45REREREREREREUiEj3QUQEREREREREZH9l4JPIiIiIiIiIiKSMgo+iYiIiIiIiIhIyij4JCIiIiIiIiIiKaPgk4iIiIiIiIiIpIyCTyIiIiIiIiIikjIKPkmTmdl4M3Nm1jfdZYnHzLLM7C9mtjko5/h0lymWmfUPyjY23WVJhWAfWWhm1WY2M93laY6mbhszW2lmP2qrcqVCWx7LsfNK5rzNrG9wvLfLc9L+xszuM7M70l0OkbZkZjPN7P50lwPAzKaZWU26y5GImXUysyfNrCw4z/dPd5litfe6bGuZ2YVmtszMas3sgXSXpzmaum2CNBe3VblSoS2P5dh5JXPeZvYlM1tnZoXJyE8aZmYvmtl16S5Hayj41I6Y2QPBCbXus93M3jKzM9po/iuj5l1hZh+b2Y1m1uL9xMx+ZGYrk1jMhpwPfB04C+gFzElQpnRetFbhy/ZOmuZfj5mNTWIl8Q/AB8ChwHlJyC9pzOwEM3vCzDYE+/cyM3vIzI5uZlbHAnelooztSXA+ejkFWc/BHwNrk5DXfwMPOedW1w0ws9+a2TtmVp6ocmVmw83sX2ZWamY7zOyp2P3fzLoHwey1ZrbbzErM7D/i5DXNzJaYWWVwzrwoCctVV8YHg/NyhZmtCJatKCZdtpn9Kqj87TazN8zsmJg0V5nZK2a2JVGA1cy+b2YfBT8ad5rZPDO7LCbZz4FrzezQZCyjSHvQhHPdecD32qgs0XXAnWa2wMwub2We91vb3Qy6FjgB+DL+PL8qTnnSfRMumdegpDCzi83MJSGfTOAvQBjoB1zf2jyTyczOMLMXzN802h1cO+81s8HNzKoXMD0VZWxPLHWB70eBPknK6y7gV865XQBmlmdmfw3qEFVmtjTeRGZ2YrB824K6yd/NrFtMmkPNbLqZbTSzXUGeX42T141m9llQV5pnZpOSsWBBGR83s9XB/vqpmd1iZrkx6Tqa2Z+C/XqXmf3bzA6LSXOzmb1uXwTm6wVYzeyOoB6503wMYI6ZnRmT7MfAz8ysUzKWMR0UfGp/XsefVHsBo/E/5J+K3YlT6H+CeQ8B7gVuB25oo3m31iBgjXNujnNuvXOuKt0FiuWcqw3KVt2afMwsJ1llSrJBwAzn3Crn3JZ4CdJRdjP7Bv7YqgYuwu/fU4GVwO+ak5dzblPdRVaazzlXFRwDkdbkY2a98NvwjzGjMoF/APckmK4n8BqwBRgHjA2mednM8qOSPoAPNF4IDMVXsO4ys69F5XUO8Gf8ufIo4E/A383s9NYsW+BoYCdwRTD/a/CB9X/GpPs1cDlwdVDe5cGy9IxKUwC8CvyggfmtBG4EvgSMBB4E/hwsIwDOuTXAK8C3WrpQIvsa59wW51xZG87yOnw9bBTwb+B+M7uwDeffGoOARc65j4LzfG26CxQrideg9lgP6wV0AJ53zq1xzm2PTWBedlsXzMx+AjyLv0adBxwBfBOoAm5tTl7B9qtIeiEPEM653c65Da3Nx8y+hK93/C1qcCZ+m/4ReCTBdEcCM4B3geOA0/HnjqfMzKKSPgsUB+OHA08A/zCzMVF5fRf4GT4oMyrI91kzG9Ha5cMH0ZfhGzYMBW4Cvg38Nibdg8DJwAX4OqUBM2LqlLnAM8BtDcxvUZD/UcDxwGzg6egbis65d4E1wKUtXqp0c87p004++B87L8cM6wg44NyYYfcBm4AK4D1gUtT4EP7APy5q2KVB2lENzH8l8KOYYTOAt4L/xwdl6Rs1fjT+4NgNbMX/6OsRjJsWpI/+3BKMmwLMA8qBbfgTUENlM+D7+ItWFf5k8N2o8TNj5rOygbwccHHM9//A3wnYBXyOP4F0Bh4GdgTzPT9qmv7BdF8HXgyW42PgJPzdhOeDvBYDJ8aZbmzUsFHA28H2+SSY917bIpjmO8H63Q48Fgy/DSgJ5r8K/yO4c9R004Aa/An0gyDdXOCYmPJEf2YG44YFy7YtWJYS4JIE63R8nHymRQ0/E3gjWMbrgmnOAN4HKoGN+GBBYezxEGyb1fgf4vcD2fgf4p/h97k/AjkNbO/ewXzvTTC+S8y6COEveOXBdr8kJn3stlmJbxHyO3xAYwNwB5AZlWYifh/dEmy/WUQdn4nKBTyE3x93A0vwgWCLs46uCtZHGfA00D0mr7p1WB5s00uJOZYbOx8la17EnEfwx/af8Mf07mCd/xLIbWT9fBf4pIHx04CaOMOvwB/T2VHDugZl+kbUsG3Af8RM+z5wV9T3OcA/YtI8RnAMJfuDb90ZAToF3zsG+/ZVUWkygfUE59qY6ev28bFNnN+86OUNhn0DWJ+K5dNHn3R8Ys91ccbPBO6P/Y7/sbM+OK8/QNT1K0j3VWB+cIyuBO6MTRNnXnvVT4JhnwL/DP6vd16jgWspcAtxrs3BuCvw1/UKYDO+LtfQNSEbf0NyDb4ethj4etT4lcSpS8TJZ6/zEC2vT40PpjsDeAt//XgfX3cZhq9zlOPrl0PjTBddlz0F+ChYFx8G896zLaLKeFFUee6gCdevYBssxdd7Pw6mfQ04LKY80Z8HgnFjgTfx16wdwALg1ATrdVqcfMbzRT1wAv6cXgVMDqa5LFivlfjr9q1AVsy+/udg+Eb8dfE2fOOFn+DrO5uA2xrZr48JynNTgvFdYtbFRPz+WB6U79SY9PHq8d/CBwF24OvDN8ZM83X8UwfbgVLgX8DgRso9AB/wWBuU5SPq1wln0sj5INhPfhGsw534oMx/EqeO0tpzT1PmRcx5hCbUNxOU77fASw2MvwVYGmf4rcDHMcNGBdtxQvC9KPh+Vky6zcD1Ucu6BvhlTJq5BMdQsj/Betkc9X1wUM7o3+Fd8MfUtDjT1+3jCc+1Mem31i1v1LCfAW+nYvna4pP2AugTtTHq/9jLwTf1rgAOiRr+GP4ifyq+Bcfv8BeTI6LS1F0MOwUHxg5ifkjFmf9K6gefngHeC/7f64ABeuJ/gP4DH5Eei79ovx6Mz8dXVFYFaXvi78j0DMp7I/7EPgR/URjeQNm+HZwQr8JHx68J1svlwfiu+IrAiiD/7g3kFe+itR5/ER6Ir7iV4+84TguG/R5fYegWTNM/mG4ZcE6wjp/EX6BeBs4Nhj0eLH92zHR1la4CYB0+2DECH8ybE8w/Nvi0Gf/D/jCCCybwI+DEIN+T8RWbv0VNNw3/Y3V2kO4I4KWg3Fn4H6pnB/kfG6y7rsG0Hwbbdij+MbrTCSoscdZpTjCtC7ZVz2D7jw+GfRzMZwDQN1jWGnxrkiFB3p8DD8YcD9vxd1SGBNNX4Ct+fw/KNTnYL65tYHt/lyac6KO2zXJ8AGogfv+tAQYlOk6C71vxd0QG4Vvj1LB3IONcfAuawfhK8f34SkO3BsrTE/gvfAuYAcDF+IrEN+Kso38CRwJj8IGh6H1gSlCe7wXzvxxfYWxwnRA/+NTqeVH/PJKBr4gcH2yDs/HHxM8a2V5P4h+5SzR+GvGDT9cF6z46iFcA1AJ/jRr2HL6idxC+gvOVYP1Pitrnq4FLY/K/HL+fZjZU/pZ88HeJdxH8OMD/mHBAv5h0DxLnxzRNDD4F2+Q0/Hno7JhxQ4M8hiR7+fTRJx2f2HNdnPEzqf8DcBv++nVEcKxsiz5nBeefrcAl+OvnOPw19cFGyrJX/SQY9iEwPSrf6B+NDV5L8XWuh/H1irp6WD4+GFCDvzlwCL4OdwUNXxN+ja+H1F3L/h++fnFyML47/ibebKLqEnHy2es8RMvrU+OD6ebhz89D8UGoD4MynByskzeAd6LmXzdd3TWoT3Cuuz/I42R8EGvPtogq42r8tfhQ/HW50esX/gf4LuCFYL0fFZR5VjA+B19vclHbqDO+frYFH7QcFHzOJSoAF7Ne8/H1OBeUo2eQ97RgO80N1tOhwbY6E3/d+2Gwfqfi99lfxOzr2/FPRQzGX4Mcvh72q2DYZcGw0xvYd34brIOENwpjts0C/HE1CF/f2wYUJTpOgu8bgCvxdeTvEBXICNJ8A19nPAwf6HgGH9ht6Obl8GDbjAim+w+CQF4zzwfXB8t/WbDObgzStCT41Op5Uf880mh9M0H55gG3NjD+FuIHn+4A5scMOyLYZj+NGvYRPnjWGX+sfRVf5z8yGD8gmGZcTF6/iDffZHzwN5uXxOxXVcTU+fBPW9wfZ/q6fbyx3yRZ+OtHNXB0zLgzgv2wYyqWMdWftBdAn6iN4StANcEBvxN/sdgJhKLSDAx22jNipv0A+EvU93x8871wcHJ4qgnzX0nwozo4yM/ER25vD4btdcAEB/dqok7c+IvqnhMBPjiyMmY+ddHt/s1YN6vwzxRHD7sLWB71Pe5JLk5e8S5av4363j0Y9vuoYV2CYXV3i/oH36NbX9Vd9G+Is6xHxkxXV+m6MtjG0a2V6k7AscGnPzdh2c4NtllG8H1aMO3RUWlGB8MOD76Pjbc98BWOac3ch2PXbd0+E3un6EHg3ZhhU/D7/CFRx8PGmP3rX/g7VtF3FZ8mqJgnKNM9wPYmlL1u23wvalhWsH2ujnecRH1/JiavFwjuVCeYVwa+kndRM9fv7/CPNUafMzbFrI+bgHVR398AHo7J5w5aFnxq9bxowoUXf5fu00bWxXzgfxoYP434wacj8BWFXwB5+B9nfwjK9GJUuo74O54Of/GvBL4ZNb43MXe7guFnBsMTBsBb8sFXDlcBd0QN+3owr5yYtL/GP/qSaB+PG3zCV7R34q9Du4Er4qTpFORxZjKXTx990vWJPdfFGT+T+j8AP4xJcy9BK/Hg+0rgmpg044Jjp0sD89pzDcVff64Ihl0TDNvrvEbTrqX3E9MKCV9X2E7QirIJ66ggOAd+K2b4k8CrTV2XQZq9zkO0vD41Pvh+TlSaC4Nh58csqwM6xExXd026Ldhe0a2VT4vZFnVl/HET1tVe1y983bSGqGsC/kd0BMgLvl8MuJh86uqd45uxL++1bqP2GUdM0Ar/4zgcM+x6/Lk/J2pfjw0SLAI+ihm2gKhrU5xyPU/MMZMgXd22OS9qWN2NzVOjhsXWNR3wvzF5fQz8dwPzqmvx/OWmrt9guqeBP0V9nxm7bNQ/H6wmpnUYvs+qlgSfWj0vEtSPYqbZq76ZIM02Gr75ewvxg08nB+v+anyLym74c4kD7ovZ9rP5oh62najfv/iboI6YFmz4gOGu5mzXJm77IfhGF9dFDft/wNo4aR8D/tXAPh63DowPkO7EB4a3EuemPz4Y6oBhyV7Gtvioz6f25x18fxsj8RHonwN/M7NTg/FDg7+zY6abjW9RAYBzbjf+LsZ5QA/83Yqm+LGZ7cTfuX8C3+rklgRph+Gb/e3pW8k5twB/chiWYBrwd6VeBBaafyvK9WZ2cKLEQadqfam/zLOA/mZW0PAiNcmCun+cc5vwB/2HUcO24n+w9kg0Hb71FNHTRQ2Lna7OUKDERT2X75z7GH9Cj/Vu7AAzO8/MZpvvFHkn/g5nXSukPVnGlHNN8PegBGWqcwe+r4mZQQd7ze2Yu6GyDyP+9jS+2MfBr5vovrvW4+84VMYMS7R+CfJsjvl1/zjnavB30xpbV/Njvq+JnsbMBpjvPHqpmZXhL16d8Xec4xfaLMPMbjKz+eY7xt6Jb/EXO01JzPrYa9749Rnb+f4bjSxPIimZl5ldab6T8A3Bcv43DaybQD7+PNUswfF1Ef5u1S78xT0Pf6c7un+SW/iixd8x+P6Sfh+n88eEs4o3MOhcdWfUp19jGZlZD3yLxQ/xd6lbPP9GLMFfe47FL/+dcfqvqlvn+YgcuBKe882sO/78dWf0sY5vTQ3+JmJD7o+qh92Fb4F7X4K0Tb2WxpqBb+W7wsweMf9SguIG0g/E1y3izauh+l5ztLQ+lYx62Fy3d/9UbyVIG68e1pTr19qgbllnDX4bJay7BPXO+4EXgw6MbzKzwxOlb4K5Md8T7Tt5+FY+dRbEpFnP3uu3blhj9bDmXJOi62Hr8dfm1tbDRga/OVaY2Q58C0FouB5WYGa3m9ki851i78S3OomdpqHzQSd867pk1cOSPq9m1DdjtbQe9gq+Fdl/44Oda/D1jw0E9bCg76e78YHb8fh6ye+ARyzmpSqJZpNoRHA8RZ+bG2Vmg/D1sEecc3c3ZZqGytCA1/D1sNF80Y9o7O+vfboepuBT+7PbObc0+Mx3zv0Kf3G4uZHp4p3Y694kUkTDF4Vo/4ff6Q8F8p1zV7mGO/VLdGAlPOCCC/zp+Oa/c/H9mHxiZpMbKVtsns0NKjQkXgfgscMc9Y+Z6pjxiYY1dKw19eS0VyfXZnY8PrI+G39n72j8xQJ8JbFOJKZS1ZQy4Zz7Bb7Jbhj/mNXbZtasTiETlT2mHA0Nj7cNmrJdoi0BOsV7s0QCsR3VN5Z/U6Z5Dv/mmW/jLygjCVp1NZDnDfhAw+/x/R+MxFdEY6eJN+/YY6MlF8B4kj6voCPd/8M/rnEG/u72z/F3wxqyCX/nstmcc4855/riO2ctds59AzgY/9gHwQsevodv8faCc+5D59z/4pt/1wV/SvGVop4x2R+EbyGwNcHsf8IXNxhG0sgbl4L9dhb+Ecfz3N4vK1gX/I1XhvU0k/Md8S51zs1zzv0P/hHLn8Ykq1vnmxA5cDV0zq/7ez17H+tH4R8j+qiRvG8O0h+Mb5n0Qxfc7k6gJfWwnfiXC5yL72vyGmBpE37UxauHJev60tL6VCrqYYmWKbYe1tTrV7z9pbEy4Zy7En/zYwa+H6qFZnZ1Q9MkUJugLp+oXp2KetjAZnTSHu+FQS2uhwU3qV8Khn0T38l1Xeu6hsr0a3yrtJ/jH3MfiW/F1ZR6WF15463T1kjFvJpa34zVmnrY3fgWTwcHf2/FP3myLEgygeAt5s65WcFv4p/gfzf+Z5CmpXWgK9j73NygoIP02finL2KPv3VAsfk3TTanDHE553YF9bC5zrkb8ct7Y0yyfboepuDTvqEG3+QZfHNX8M23o50YNQ4zG4Z/Tvxq/N22Ryzm1ZAJbAl2+tWu8TeBLAJOiL6YmNlR+BYddWWpwj+3vhfnveuc+6Vzbhz+x9U34s3E+bfMrMZfeKONA1Y458qbsFzt1WJgiJl1rhsQ3NkqSjzJHmOBUufcj5xz7zjnPsG3EGuuugtZvO203Dl3j3PuAvyP5mtbkH88i6i/PU/CXzAXJ2kedR7DBwN+FG+kmXVJ8vxi8++Gv7N6u3PuRefcYvxdi8YCwuOAF5xzfw6CAUvxP1yaazG+w/losd+TpSXzGgfMc87d6Zx73zn3Kf7RgcZ8QCvvuDvnNjrntpvZKfjt8UQwqu58G3sOrCWo3AUt8ubi+96Ldhq+RWjctzwF81wa9alJVL4gCPY6fr2eF9PqDL7oZPjUqGky8J3ntvSuarQM/Btaog3Hr4d5SchfZL/j/FukVuEfbV8a59NYS4ENQbp1jQSdoGnX0kT1sFrn3OzgB90x+B9RX08wn6X4c028etii+sn3KYuBY2N+PJ7QxGlbev2KVQUQ5wcszrmFQf6n4zv/vqoF+ccTb98ZxxcdpyfTQ/jr6vfijUx1PQz/uFR34Gbn3GvOuRL8Y42N3cQeh+9K4NHgyY7l+JuyTRY82bCGNqiHtWJeLa1vtqoeFvwWXOf8G6S/Ggx+OvhbGPyNrUvtqYfhH5ddS/x6WMI6kPNvgtxzTm6ojGZ2LP43ahj/iGHsOflNfLD5K1HTFOH7gUtlPWwTX7Te26dkpbsAUk9O1CuyC/EH1KkEd5+dc8vM7DHgnuDux2f4gMCRBJUGM8vD36F/xjn3ZzN7At9M8w58M8dkuRt/Z+8BM/slPmByD/CGc+71IM0KoKeZnYDv2K8cH2U+GX8XYh3+BDcCf1FN5L+B35jZp/hnnr+CX+5vJ3F50uFh/B2Vv5vZj/FNKH+Dv/g3VulcAnQ3s8vxzTTH0rJXoH+G/5F9hpk9iq9g1uI7mHwcvw2L8CfzZAWGfg18YGZ34t9W1x9/x+Vh51xST6bOuTVmdh1wX3BBqOuMvyu+b4wJ1A/mJtNW/EXiSjNbhr/D8yv8Nm7IEuASM5vAF69VPZ7ELWoS+Q3wmJm9i79jNxbfiWEqtGReS4DLzWwKsBD/vPt5TZjX88A3zSzf+ceMATCzgfh+nPoF3+vuai0N7vZjZt/GP+K8LSjjXfjOy18L0pbgWwPcbWbfw1duJuC3QXQr1F8B04PlfQHf39N5wFlNKH+DzGwovrPdD/Gdp3azL95AvCn44VhmZvcCvzSzdfhj9Qf488h9UXnVdWLbOxg0MGhqvj54pIHgWHwS/6O5EH8Xfxr177iNx5/j2/LV8yKp1iHqXFGnwvnHdFviZuDPZrYNeArfUmQIvlPmlrRcSaQp19IVwIXBTckN+BfQnIZv4T4bf306Bt8CIe413jlXbmb/C/zCzDbh65QX4q+hE5O4POlwD74lxR/M7C78ubLudehNqYe15PoVa0Xw92wzewNfP+iJ7xf0Wfx5uTf+RvMHLcg/nv/Gv5L+JvyNl5H4x61/4/bu7qDVnHPvmdnP8deqg/EtxT7DL1MI/6hYKJnzjPEZvm77H2b2G/xxcjtN275TzOxxfD8838OXeUMz5/8b/LHzMf7t1mfjbxKlQkvm1dL65vP4N5HvJai/1HUBkhN1bl1ct2+Z2Q/wvwPrbqDdjn9rXV0waA7+3PRA8PuoDH9snUKwrzjnnJn9Gr9fleDf/j4N38r0ykbK3igzG4d/cmE6/ng5qK4eVld3cs59YmZP488fl+O7nvklfj0+GpVXP/zvjrrHrocGjzp/7pzbYmYH4X/DPY9vMVUEfA3/e/n8mKKNB55vws2J9sm1g46n9PEffEeNLupTjr8z8X2CDqSDdJ3wPyw24Q/a99j7FY9/wEfnozuxHouv/JzdwPxXEvO2u5jx44npJA3/CNFs/IVyG/7taD2ixmcHw7YE096Cj5LXHVyV+IvCr2n4jROG/1G1IliO5UR1ThmkuYWWdzge+3aZGmI628a3Vrki+L8/9Tt17EtM55B80VHiKQ1MNwp/gajEB+guwD+SdUNDZQyG/wJ/EdwVrNOvBWn7B+OnUf+1zPHKeSP+RFmLD+7lBdttRbDcG/En0YObuW7r7TNR46JfD70Jv99Gvy72AWI6LiV+x6n34n8MN7bdx+J/BGwM5rkc/xaVkYm2TTB8KVGvrSd+h+Oxb4ncq5z4u4sLgnW5BH8h2SvfOOXtjL/TUoZ/w9D/Bdt7ZSPrKF7HpdcH23c3PqBxWaLtkijvZM0rdp/AnyPuw58j6t6eeV1svnHKl4EPIn49ZvhM9j6P1n2i9/e/BPtcFT7IdBP131RyKD6Ivy5Ylo/x56CMmHTTgjyqgm1b7zhtyYf4r0iv+/SPSpeND4KtD/avN4EvNTGv6P36Eb6ooJcG+cSuW8OfE76WjGXUR5/28KF+3avu83EwfiZxXncek0e8l6ucg+87qDw4t80HftJIWeJe66PGT6P+Nb2xa2lXfP1ge5D/NPwNl1eD9BX4usdNNPBq9eBcczv+/F6FD1TFniMeoOUdjje3PjWe+nXSei9Q4YuXrAxsYLpT8MGjSnzAv67D8fMTlTFqnTR4/SJO3TRBOX+Lr89FgvXYCx8UWh2Uay3+5lnnpq7bRPtM1LjL8DdbqoLtehvB21Qb2NdfJuY19vibLwnfPhuV7ix8wGErX9SH7mlo2wTD96qT07R6/F7lxNetPw3mOw9fL6tX14/J42B8H7W7CN5iiL9RPrM55wN8feWX+GvrLnww4z8TbZdEeSdrXrH7BE2obyYoX8dgmjExw1fSeN2lbj+oO+aujJP/SPyjbpvwwb8FxHkDH/43zOdBXvOJ6py+NR8SXxtcTLqOfPEW63L88TCwiXlNC8Z3wbf6Wos/HtfjH7c9LSafDsG6OCEZy5iOjwULIiLthJkdgj9xn+2cezbNxRFpt8zsEvydyKOdLmYpZ2Yh4Mf4gG3cxwpFRPZ1QYuHWcAI51xjfXSJHLCCVknHOOfOSXdZDgRmdiMwwfnHcPdJeuxOJM3M7GL8HacV+DdL/ArfAuGldJZLZB/wEF88TramkbTSern4u44KPInIfsPMrsW3qliL76PxLuAdBZ5EGvVr4AdmVuh8302SWrtJbhc6bU4tn0TSzMyux/fp0gffZPNN/CN3+2RHciIiIiL7CjO7Hd9vat0bqmYA/+Wc25zWgomI7GcUfBIRERERERERkZTJSHcBRERERERERERk/6Xgk4iIiIiIiIiIpMyB2OG4njMUERHZ/1m6CyD1qA4mIiKy/4tbBzsQg0+sXbu23rDi4mJKS0vTUBpJBm2/fZu2375P23Dftr9tv969e6e7CJJAvDqYxLe/HZdtQeus+bTOmk/rrPm0zppvX11nDdXB9NidiIiIiIiIiIikjIJPIiIiIiIiIiKSMgo+iYiIiIiIiIhIyhyQfT6JiIiIiIiIiLSEc46KigoikQhmyX/HyYYNG6isrEx6vsngnCMjI4O8vLxmLbuCTyIiIiIiIiIiTVRRUUF2djZZWakJqWRlZZGZmZmSvJOhpqaGiooK8vPzmzyNHrsTEREREREREWmiSCSSssDTviArK4tIJNKsaRR8EhERERERERFpolQ8arevae46UPBJRERERERERCTFNm7cyLXXXsuYMWMYP348l1xyCcuWLUta/nPmzGHu3LlJyy+ZDtx2YiIiIiIiIiIibcA5x+WXX86FF17IH/7wBwAWLlxIaWkphx12WFLm8dZbb1FYWMixxx5bb1xNTU1aHxVU8ElEREREREREJIXefPNNsj7NEAwAACAASURBVLOzufTSS/cMO/LII3HO8Ytf/ILXXnsNM+M73/kO559/PnPmzOHee+/l73//OwA333wzI0aMYOrUqRx//PFceOGFzJgxg5qaGu677z5yc3N58MEHyczM5PHHH+fWW2/ln//8J0VFRSxcuJBhw4bx8ssv88wzz9CtWzcikQgnnngizz77LF27dk358iv4JCIiIiIiIiKSQkuWLGH48OH1hj///PMsWrSIGTNmsGXLFs444wzGjh3baH5du3blxRdf5IEHHuDee+/ljjvu4JJLLqGwsJBrrrkGgH/+858sX76cRx99lMzMTDp37swTTzzBlVdeyeuvv87QoUPbJPAE6vNJRERERERERFJg485qdlbWpLsY7dq7777LOeecQ2ZmJt27d2f06NHMmzev0elOP/10AEaMGMGqVasSpps8eTKZmZkATJ06lenTpwPwyCOPEAqFkrAETaPgk4iIiIiIiIgkVXVthBteWMndr69Id1HahcGDB/PRRx/VG+6ci5s+Kytrr3GVlZV7jc/NzQUgMzOT2trahPMtKCjY83+fPn3o3r07b7zxBvPmzeMrX/lKs5ahNRR8EhEREREREZGkem/tLsoqa/lg9fZ0F6VdGDt2LFVVVTz88MN7hs2fP5+ioiKeeeYZamtr2bx5M++88w5HH300ffr04ZNPPqGyspKysjLeeOONRudRWFjIzp07G0zzta99je985zucddZZe1pEtQUFn0REREREREQkqWat8EGnNdsr2LJbj96ZGffffz+zZ89mzJgxTJgwgd/85jecc845DBkyhIkTJxIKhbj55pvp0aMHffr04ayzzuKUU07huuuu48gjj2x0HhMnTuSFF15g4sSJvPPO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aWtsUobW2m+Bk/3xF/4PeMoYU5jsg7OLiIhIoEqBU5pLEBljzsRr/X0w3s3CQrzxPp1Gi210zeJv52hjTDrew3IexxteQERSiMZ8Eklx1trvgCdoNI6RtXYlXvLmNGNM2BhzFt6YQNvjcGPMvsaYDLyxn6Zbaxfh9fvfwRjzc2NMuv/a3RgzeCvjXwRMBW4wxmQZY3bGa9HzyHbGG28vA8ONMcf6T7I7ny0n+PKAamC1MaYH8NsY9rccKDTGdNwwwxhzmjGmi98EfkPLs0gM2xQRERFp6m688Td7g9dy2xhztP9ZHlALlOPd5JywuQ0ZY7KNMacYY/KttfVAFbpWEUlJSj6JtA9/ATo0mfcLvORGOd7A2VO3cx+P4rWyqsB7qt2pAH5rpUOBk/BaMS0D/or3xLytdTLQ11//WeAaa+0b2xlvXPljLJ0A/A2vjIfgDQJfu5nV/gzsivekl5eBZ2LY3xy8AUG/N8as9p8QOBb4wn8C3m3ASf7YVSIiIiLb6ma8J+6+ZYypwruG3N3/7EG867UleF31tub6chywwBhTiXeD8eetHrGIBM5x3c31dhERkdbgd30rBU611v4n6HhEREREREQSRWM+iYjEiTHmp8B0vEHJf4s33oGeOCciIiIiIu2Kut2JiMTPXniPJy4DjgKOtdauCzYkERERERGRxFK3OxERERERERERiRu1fBIRERERERERkbhR8klEREREREREROJGyScREREREREREYkbJZ9ERERERERERCRulHwSEREREREREZG4UfJJRERERERERETi5v8B05iHU5qLp7cAAAAASUVORK5CYII=\n",
"text/plain": [
"<Figure size 1440x432 with 2 Axes>"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"fig = plt.figure() # create figure\n",
"\n",
"ax0 = fig.add_subplot(1, 2, 1) # add subplot 1 (1 row, 2 columns, first plot)\n",
"ax1 = fig.add_subplot(1, 2, 2) # add subplot 2 (1 row, 2 columns, second plot). See tip below**\n",
"\n",
"# Subplot 1: Box plot\n",
"df_CI.plot(kind='box', color='blue', vert=False, figsize=(20, 6), ax=ax0) # add to subplot 1\n",
"ax0.set_title('Box Plots of Immigrants from China and India (1980 - 2013)')\n",
"ax0.set_xlabel('Number of Immigrants')\n",
"ax0.set_ylabel('Countries')\n",
"\n",
"# Subplot 2: Line plot\n",
"df_CI.plot(kind='line', figsize=(20, 6), ax=ax1) # add to subplot 2\n",
"ax1.set_title ('Line Plots of Immigrants from China and India (1980 - 2013)')\n",
"ax1.set_ylabel('Number of Immigrants')\n",
"ax1.set_xlabel('Years')\n",
"\n",
"plt.show()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"** * Tip regarding subplot convention **\n",
"\n",
"In the case when `nrows`, `ncols`, and `plot_number` are all less than 10, a convenience exists such that the a 3 digit number can be given instead, where the hundreds represent `nrows`, the tens represent `ncols` and the units represent `plot_number`. For instance,\n",
"```python\n",
" subplot(211) == subplot(2, 1, 1) \n",
"```\n",
"produces a subaxes in a figure which represents the top plot (i.e. the first) in a 2 rows by 1 column notional grid (no grid actually exists, but conceptually this is how the returned subplot has been positioned)."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Let's try something a little more advanced. \n",
"\n",
"Previously we identified the top 15 countries based on total immigration from 1980 - 2013.\n",
"\n",
"**Question:** Create a box plot to visualize the distribution of the top 15 countries (based on total immigration) grouped by the *decades* `1980s`, `1990s`, and `2000s`."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 1: Get the dataset. Get the top 15 countries based on Total immigrant population. Name the dataframe **df_top15**."
]
},
{
"cell_type": "code",
"execution_count": 37,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>Continent</th>\n",
" <th>Region</th>\n",
" <th>DevName</th>\n",
" <th>1980</th>\n",
" <th>1981</th>\n",
" <th>1982</th>\n",
" <th>1983</th>\n",
" <th>1984</th>\n",
" <th>1985</th>\n",
" <th>1986</th>\n",
" <th>...</th>\n",
" <th>2005</th>\n",
" <th>2006</th>\n",
" <th>2007</th>\n",
" <th>2008</th>\n",
" <th>2009</th>\n",
" <th>2010</th>\n",
" <th>2011</th>\n",
" <th>2012</th>\n",
" <th>2013</th>\n",
" <th>Total</th>\n",
" </tr>\n",
" <tr>\n",
" <th>Country</th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>India</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>8880</td>\n",
" <td>8670</td>\n",
" <td>8147</td>\n",
" <td>7338</td>\n",
" <td>5704</td>\n",
" <td>4211</td>\n",
" <td>7150</td>\n",
" <td>...</td>\n",
" <td>36210</td>\n",
" <td>33848</td>\n",
" <td>28742</td>\n",
" <td>28261</td>\n",
" <td>29456</td>\n",
" <td>34235</td>\n",
" <td>27509</td>\n",
" <td>30933</td>\n",
" <td>33087</td>\n",
" <td>691904</td>\n",
" </tr>\n",
" <tr>\n",
" <th>China</th>\n",
" <td>Asia</td>\n",
" <td>Eastern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>5123</td>\n",
" <td>6682</td>\n",
" <td>3308</td>\n",
" <td>1863</td>\n",
" <td>1527</td>\n",
" <td>1816</td>\n",
" <td>1960</td>\n",
" <td>...</td>\n",
" <td>42584</td>\n",
" <td>33518</td>\n",
" <td>27642</td>\n",
" <td>30037</td>\n",
" <td>29622</td>\n",
" <td>30391</td>\n",
" <td>28502</td>\n",
" <td>33024</td>\n",
" <td>34129</td>\n",
" <td>659962</td>\n",
" </tr>\n",
" <tr>\n",
" <th>United Kingdom of Great Britain and Northern Ireland</th>\n",
" <td>Europe</td>\n",
" <td>Northern Europe</td>\n",
" <td>Developed regions</td>\n",
" <td>22045</td>\n",
" <td>24796</td>\n",
" <td>20620</td>\n",
" <td>10015</td>\n",
" <td>10170</td>\n",
" <td>9564</td>\n",
" <td>9470</td>\n",
" <td>...</td>\n",
" <td>7258</td>\n",
" <td>7140</td>\n",
" <td>8216</td>\n",
" <td>8979</td>\n",
" <td>8876</td>\n",
" <td>8724</td>\n",
" <td>6204</td>\n",
" <td>6195</td>\n",
" <td>5827</td>\n",
" <td>551500</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Philippines</th>\n",
" <td>Asia</td>\n",
" <td>South-Eastern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>6051</td>\n",
" <td>5921</td>\n",
" <td>5249</td>\n",
" <td>4562</td>\n",
" <td>3801</td>\n",
" <td>3150</td>\n",
" <td>4166</td>\n",
" <td>...</td>\n",
" <td>18139</td>\n",
" <td>18400</td>\n",
" <td>19837</td>\n",
" <td>24887</td>\n",
" <td>28573</td>\n",
" <td>38617</td>\n",
" <td>36765</td>\n",
" <td>34315</td>\n",
" <td>29544</td>\n",
" <td>511391</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Pakistan</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>978</td>\n",
" <td>972</td>\n",
" <td>1201</td>\n",
" <td>900</td>\n",
" <td>668</td>\n",
" <td>514</td>\n",
" <td>691</td>\n",
" <td>...</td>\n",
" <td>14314</td>\n",
" <td>13127</td>\n",
" <td>10124</td>\n",
" <td>8994</td>\n",
" <td>7217</td>\n",
" <td>6811</td>\n",
" <td>7468</td>\n",
" <td>11227</td>\n",
" <td>12603</td>\n",
" <td>241600</td>\n",
" </tr>\n",
" <tr>\n",
" <th>United States of America</th>\n",
" <td>Northern America</td>\n",
" <td>Northern America</td>\n",
" <td>Developed regions</td>\n",
" <td>9378</td>\n",
" <td>10030</td>\n",
" <td>9074</td>\n",
" <td>7100</td>\n",
" <td>6661</td>\n",
" <td>6543</td>\n",
" <td>7074</td>\n",
" <td>...</td>\n",
" <td>8394</td>\n",
" <td>9613</td>\n",
" <td>9463</td>\n",
" <td>10190</td>\n",
" <td>8995</td>\n",
" <td>8142</td>\n",
" <td>7676</td>\n",
" <td>7891</td>\n",
" <td>8501</td>\n",
" <td>241122</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Iran (Islamic Republic of)</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>1172</td>\n",
" <td>1429</td>\n",
" <td>1822</td>\n",
" <td>1592</td>\n",
" <td>1977</td>\n",
" <td>1648</td>\n",
" <td>1794</td>\n",
" <td>...</td>\n",
" <td>5837</td>\n",
" <td>7480</td>\n",
" <td>6974</td>\n",
" <td>6475</td>\n",
" <td>6580</td>\n",
" <td>7477</td>\n",
" <td>7479</td>\n",
" <td>7534</td>\n",
" <td>11291</td>\n",
" <td>175923</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Sri Lanka</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>185</td>\n",
" <td>371</td>\n",
" <td>290</td>\n",
" <td>197</td>\n",
" <td>1086</td>\n",
" <td>845</td>\n",
" <td>1838</td>\n",
" <td>...</td>\n",
" <td>4930</td>\n",
" <td>4714</td>\n",
" <td>4123</td>\n",
" <td>4756</td>\n",
" <td>4547</td>\n",
" <td>4422</td>\n",
" <td>3309</td>\n",
" <td>3338</td>\n",
" <td>2394</td>\n",
" <td>148358</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Republic of Korea</th>\n",
" <td>Asia</td>\n",
" <td>Eastern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>1011</td>\n",
" <td>1456</td>\n",
" <td>1572</td>\n",
" <td>1081</td>\n",
" <td>847</td>\n",
" <td>962</td>\n",
" <td>1208</td>\n",
" <td>...</td>\n",
" <td>5832</td>\n",
" <td>6215</td>\n",
" <td>5920</td>\n",
" <td>7294</td>\n",
" <td>5874</td>\n",
" <td>5537</td>\n",
" <td>4588</td>\n",
" <td>5316</td>\n",
" <td>4509</td>\n",
" <td>142581</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Poland</th>\n",
" <td>Europe</td>\n",
" <td>Eastern Europe</td>\n",
" <td>Developed regions</td>\n",
" <td>863</td>\n",
" <td>2930</td>\n",
" <td>5881</td>\n",
" <td>4546</td>\n",
" <td>3588</td>\n",
" <td>2819</td>\n",
" <td>4808</td>\n",
" <td>...</td>\n",
" <td>1405</td>\n",
" <td>1263</td>\n",
" <td>1235</td>\n",
" <td>1267</td>\n",
" <td>1013</td>\n",
" <td>795</td>\n",
" <td>720</td>\n",
" <td>779</td>\n",
" <td>852</td>\n",
" <td>139241</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Lebanon</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>1409</td>\n",
" <td>1119</td>\n",
" <td>1159</td>\n",
" <td>789</td>\n",
" <td>1253</td>\n",
" <td>1683</td>\n",
" <td>2576</td>\n",
" <td>...</td>\n",
" <td>3709</td>\n",
" <td>3802</td>\n",
" <td>3467</td>\n",
" <td>3566</td>\n",
" <td>3077</td>\n",
" <td>3432</td>\n",
" <td>3072</td>\n",
" <td>1614</td>\n",
" <td>2172</td>\n",
" <td>115359</td>\n",
" </tr>\n",
" <tr>\n",
" <th>France</th>\n",
" <td>Europe</td>\n",
" <td>Western Europe</td>\n",
" <td>Developed regions</td>\n",
" <td>1729</td>\n",
" <td>2027</td>\n",
" <td>2219</td>\n",
" <td>1490</td>\n",
" <td>1169</td>\n",
" <td>1177</td>\n",
" <td>1298</td>\n",
" <td>...</td>\n",
" <td>4429</td>\n",
" <td>4002</td>\n",
" <td>4290</td>\n",
" <td>4532</td>\n",
" <td>5051</td>\n",
" <td>4646</td>\n",
" <td>4080</td>\n",
" <td>6280</td>\n",
" <td>5623</td>\n",
" <td>109091</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Jamaica</th>\n",
" <td>Latin America and the Caribbean</td>\n",
" <td>Caribbean</td>\n",
" <td>Developing regions</td>\n",
" <td>3198</td>\n",
" <td>2634</td>\n",
" <td>2661</td>\n",
" <td>2455</td>\n",
" <td>2508</td>\n",
" <td>2938</td>\n",
" <td>4649</td>\n",
" <td>...</td>\n",
" <td>1945</td>\n",
" <td>1722</td>\n",
" <td>2141</td>\n",
" <td>2334</td>\n",
" <td>2456</td>\n",
" <td>2321</td>\n",
" <td>2059</td>\n",
" <td>2182</td>\n",
" <td>2479</td>\n",
" <td>106431</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Viet Nam</th>\n",
" <td>Asia</td>\n",
" <td>South-Eastern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>1191</td>\n",
" <td>1829</td>\n",
" <td>2162</td>\n",
" <td>3404</td>\n",
" <td>7583</td>\n",
" <td>5907</td>\n",
" <td>2741</td>\n",
" <td>...</td>\n",
" <td>1852</td>\n",
" <td>3153</td>\n",
" <td>2574</td>\n",
" <td>1784</td>\n",
" <td>2171</td>\n",
" <td>1942</td>\n",
" <td>1723</td>\n",
" <td>1731</td>\n",
" <td>2112</td>\n",
" <td>97146</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Romania</th>\n",
" <td>Europe</td>\n",
" <td>Eastern Europe</td>\n",
" <td>Developed regions</td>\n",
" <td>375</td>\n",
" <td>438</td>\n",
" <td>583</td>\n",
" <td>543</td>\n",
" <td>524</td>\n",
" <td>604</td>\n",
" <td>656</td>\n",
" <td>...</td>\n",
" <td>5048</td>\n",
" <td>4468</td>\n",
" <td>3834</td>\n",
" <td>2837</td>\n",
" <td>2076</td>\n",
" <td>1922</td>\n",
" <td>1776</td>\n",
" <td>1588</td>\n",
" <td>1512</td>\n",
" <td>93585</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"<p>15 rows × 38 columns</p>\n",
"</div>"
],
"text/plain": [
" Continent \\\n",
"Country \n",
"India Asia \n",
"China Asia \n",
"United Kingdom of Great Britain and Northern Ir... Europe \n",
"Philippines Asia \n",
"Pakistan Asia \n",
"United States of America Northern America \n",
"Iran (Islamic Republic of) Asia \n",
"Sri Lanka Asia \n",
"Republic of Korea Asia \n",
"Poland Europe \n",
"Lebanon Asia \n",
"France Europe \n",
"Jamaica Latin America and the Caribbean \n",
"Viet Nam Asia \n",
"Romania Europe \n",
"\n",
" Region \\\n",
"Country \n",
"India Southern Asia \n",
"China Eastern Asia \n",
"United Kingdom of Great Britain and Northern Ir... Northern Europe \n",
"Philippines South-Eastern Asia \n",
"Pakistan Southern Asia \n",
"United States of America Northern America \n",
"Iran (Islamic Republic of) Southern Asia \n",
"Sri Lanka Southern Asia \n",
"Republic of Korea Eastern Asia \n",
"Poland Eastern Europe \n",
"Lebanon Western Asia \n",
"France Western Europe \n",
"Jamaica Caribbean \n",
"Viet Nam South-Eastern Asia \n",
"Romania Eastern Europe \n",
"\n",
" DevName 1980 \\\n",
"Country \n",
"India Developing regions 8880 \n",
"China Developing regions 5123 \n",
"United Kingdom of Great Britain and Northern Ir... Developed regions 22045 \n",
"Philippines Developing regions 6051 \n",
"Pakistan Developing regions 978 \n",
"United States of America Developed regions 9378 \n",
"Iran (Islamic Republic of) Developing regions 1172 \n",
"Sri Lanka Developing regions 185 \n",
"Republic of Korea Developing regions 1011 \n",
"Poland Developed regions 863 \n",
"Lebanon Developing regions 1409 \n",
"France Developed regions 1729 \n",
"Jamaica Developing regions 3198 \n",
"Viet Nam Developing regions 1191 \n",
"Romania Developed regions 375 \n",
"\n",
" 1981 1982 1983 \\\n",
"Country \n",
"India 8670 8147 7338 \n",
"China 6682 3308 1863 \n",
"United Kingdom of Great Britain and Northern Ir... 24796 20620 10015 \n",
"Philippines 5921 5249 4562 \n",
"Pakistan 972 1201 900 \n",
"United States of America 10030 9074 7100 \n",
"Iran (Islamic Republic of) 1429 1822 1592 \n",
"Sri Lanka 371 290 197 \n",
"Republic of Korea 1456 1572 1081 \n",
"Poland 2930 5881 4546 \n",
"Lebanon 1119 1159 789 \n",
"France 2027 2219 1490 \n",
"Jamaica 2634 2661 2455 \n",
"Viet Nam 1829 2162 3404 \n",
"Romania 438 583 543 \n",
"\n",
" 1984 1985 1986 ... \\\n",
"Country ... \n",
"India 5704 4211 7150 ... \n",
"China 1527 1816 1960 ... \n",
"United Kingdom of Great Britain and Northern Ir... 10170 9564 9470 ... \n",
"Philippines 3801 3150 4166 ... \n",
"Pakistan 668 514 691 ... \n",
"United States of America 6661 6543 7074 ... \n",
"Iran (Islamic Republic of) 1977 1648 1794 ... \n",
"Sri Lanka 1086 845 1838 ... \n",
"Republic of Korea 847 962 1208 ... \n",
"Poland 3588 2819 4808 ... \n",
"Lebanon 1253 1683 2576 ... \n",
"France 1169 1177 1298 ... \n",
"Jamaica 2508 2938 4649 ... \n",
"Viet Nam 7583 5907 2741 ... \n",
"Romania 524 604 656 ... \n",
"\n",
" 2005 2006 2007 \\\n",
"Country \n",
"India 36210 33848 28742 \n",
"China 42584 33518 27642 \n",
"United Kingdom of Great Britain and Northern Ir... 7258 7140 8216 \n",
"Philippines 18139 18400 19837 \n",
"Pakistan 14314 13127 10124 \n",
"United States of America 8394 9613 9463 \n",
"Iran (Islamic Republic of) 5837 7480 6974 \n",
"Sri Lanka 4930 4714 4123 \n",
"Republic of Korea 5832 6215 5920 \n",
"Poland 1405 1263 1235 \n",
"Lebanon 3709 3802 3467 \n",
"France 4429 4002 4290 \n",
"Jamaica 1945 1722 2141 \n",
"Viet Nam 1852 3153 2574 \n",
"Romania 5048 4468 3834 \n",
"\n",
" 2008 2009 2010 \\\n",
"Country \n",
"India 28261 29456 34235 \n",
"China 30037 29622 30391 \n",
"United Kingdom of Great Britain and Northern Ir... 8979 8876 8724 \n",
"Philippines 24887 28573 38617 \n",
"Pakistan 8994 7217 6811 \n",
"United States of America 10190 8995 8142 \n",
"Iran (Islamic Republic of) 6475 6580 7477 \n",
"Sri Lanka 4756 4547 4422 \n",
"Republic of Korea 7294 5874 5537 \n",
"Poland 1267 1013 795 \n",
"Lebanon 3566 3077 3432 \n",
"France 4532 5051 4646 \n",
"Jamaica 2334 2456 2321 \n",
"Viet Nam 1784 2171 1942 \n",
"Romania 2837 2076 1922 \n",
"\n",
" 2011 2012 2013 \\\n",
"Country \n",
"India 27509 30933 33087 \n",
"China 28502 33024 34129 \n",
"United Kingdom of Great Britain and Northern Ir... 6204 6195 5827 \n",
"Philippines 36765 34315 29544 \n",
"Pakistan 7468 11227 12603 \n",
"United States of America 7676 7891 8501 \n",
"Iran (Islamic Republic of) 7479 7534 11291 \n",
"Sri Lanka 3309 3338 2394 \n",
"Republic of Korea 4588 5316 4509 \n",
"Poland 720 779 852 \n",
"Lebanon 3072 1614 2172 \n",
"France 4080 6280 5623 \n",
"Jamaica 2059 2182 2479 \n",
"Viet Nam 1723 1731 2112 \n",
"Romania 1776 1588 1512 \n",
"\n",
" Total \n",
"Country \n",
"India 691904 \n",
"China 659962 \n",
"United Kingdom of Great Britain and Northern Ir... 551500 \n",
"Philippines 511391 \n",
"Pakistan 241600 \n",
"United States of America 241122 \n",
"Iran (Islamic Republic of) 175923 \n",
"Sri Lanka 148358 \n",
"Republic of Korea 142581 \n",
"Poland 139241 \n",
"Lebanon 115359 \n",
"France 109091 \n",
"Jamaica 106431 \n",
"Viet Nam 97146 \n",
"Romania 93585 \n",
"\n",
"[15 rows x 38 columns]"
]
},
"execution_count": 37,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"### type your answer here\n",
"df_top15 = df_can.sort_values(['Total'], ascending=False, axis=0).head(15)\n",
"df_top15\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"df_top15 = df_can.sort_values(['Total'], ascending=False, axis=0).head(15)\n",
"df_top15\n",
"-->"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 2: Create a new dataframe which contains the aggregate for each decade. One way to do that:\n",
" 1. Create a list of all years in decades 80's, 90's, and 00's.\n",
" 2. Slice the original dataframe df_can to create a series for each decade and sum across all years for each country.\n",
" 3. Merge the three series into a new data frame. Call your dataframe **new_df**."
]
},
{
"cell_type": "code",
"execution_count": 38,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>1980s</th>\n",
" <th>1990s</th>\n",
" <th>2000s</th>\n",
" </tr>\n",
" <tr>\n",
" <th>Country</th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>India</th>\n",
" <td>82154</td>\n",
" <td>180395</td>\n",
" <td>303591</td>\n",
" </tr>\n",
" <tr>\n",
" <th>China</th>\n",
" <td>32003</td>\n",
" <td>161528</td>\n",
" <td>340385</td>\n",
" </tr>\n",
" <tr>\n",
" <th>United Kingdom of Great Britain and Northern Ireland</th>\n",
" <td>179171</td>\n",
" <td>261966</td>\n",
" <td>83413</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Philippines</th>\n",
" <td>60764</td>\n",
" <td>138482</td>\n",
" <td>172904</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Pakistan</th>\n",
" <td>10591</td>\n",
" <td>65302</td>\n",
" <td>127598</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
" 1980s 1990s 2000s\n",
"Country \n",
"India 82154 180395 303591\n",
"China 32003 161528 340385\n",
"United Kingdom of Great Britain and Northern Ir... 179171 261966 83413\n",
"Philippines 60764 138482 172904\n",
"Pakistan 10591 65302 127598"
]
},
"execution_count": 38,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"### type your answer here\n",
"years_80s = list(map(str, range(1980, 1990))) \n",
"years_90s = list(map(str, range(1990, 2000))) \n",
"years_00s = list(map(str, range(2000, 2010))) \n",
"\n",
"df_80s = df_top15.loc[:, years_80s].sum(axis=1) \n",
"df_90s = df_top15.loc[:, years_90s].sum(axis=1) \n",
"df_00s = df_top15.loc[:, years_00s].sum(axis=1)\n",
"\n",
"\n",
"new_df = pd.DataFrame({'1980s': df_80s, '1990s': df_90s, '2000s':df_00s}) \n",
"new_df.head()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"\\\\ # create a list of all years in decades 80's, 90's, and 00's\n",
"years_80s = list(map(str, range(1980, 1990))) \n",
"years_90s = list(map(str, range(1990, 2000))) \n",
"years_00s = list(map(str, range(2000, 2010))) \n",
"-->\n",
"\n",
"<!--\n",
"\\\\ # slice the original dataframe df_can to create a series for each decade\n",
"df_80s = df_top15.loc[:, years_80s].sum(axis=1) \n",
"df_90s = df_top15.loc[:, years_90s].sum(axis=1) \n",
"df_00s = df_top15.loc[:, years_00s].sum(axis=1)\n",
"-->\n",
"\n",
"<!--\n",
"\\\\ # merge the three series into a new data frame\n",
"new_df = pd.DataFrame({'1980s': df_80s, '1990s': df_90s, '2000s':df_00s}) \n",
"-->\n",
"\n",
"<!--\n",
"\\\\ # display dataframe\n",
"new_df.head()\n",
"-->"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Let's learn more about the statistics associated with the dataframe using the `describe()` method."
]
},
{
"cell_type": "code",
"execution_count": 39,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>1980s</th>\n",
" <th>1990s</th>\n",
" <th>2000s</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>count</th>\n",
" <td>15.000000</td>\n",
" <td>15.000000</td>\n",
" <td>15.000000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>mean</th>\n",
" <td>44418.333333</td>\n",
" <td>85594.666667</td>\n",
" <td>97471.533333</td>\n",
" </tr>\n",
" <tr>\n",
" <th>std</th>\n",
" <td>44190.676455</td>\n",
" <td>68237.560246</td>\n",
" <td>100583.204205</td>\n",
" </tr>\n",
" <tr>\n",
" <th>min</th>\n",
" <td>7613.000000</td>\n",
" <td>30028.000000</td>\n",
" <td>13629.000000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>25%</th>\n",
" <td>16698.000000</td>\n",
" <td>39259.000000</td>\n",
" <td>36101.500000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>50%</th>\n",
" <td>30638.000000</td>\n",
" <td>56915.000000</td>\n",
" <td>65794.000000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>75%</th>\n",
" <td>59183.000000</td>\n",
" <td>104451.500000</td>\n",
" <td>105505.500000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>max</th>\n",
" <td>179171.000000</td>\n",
" <td>261966.000000</td>\n",
" <td>340385.000000</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
" 1980s 1990s 2000s\n",
"count 15.000000 15.000000 15.000000\n",
"mean 44418.333333 85594.666667 97471.533333\n",
"std 44190.676455 68237.560246 100583.204205\n",
"min 7613.000000 30028.000000 13629.000000\n",
"25% 16698.000000 39259.000000 36101.500000\n",
"50% 30638.000000 56915.000000 65794.000000\n",
"75% 59183.000000 104451.500000 105505.500000\n",
"max 179171.000000 261966.000000 340385.000000"
]
},
"execution_count": 39,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"### type your answer here\n",
"new_df.describe()\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"new_df.describe()\n",
"-->"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 3: Plot the box plots."
]
},
{
"cell_type": "code",
"execution_count": 40,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/plain": [
"<matplotlib.axes._subplots.AxesSubplot at 0x7f196510bfd0>"
]
},
"execution_count": 40,
"metadata": {},
"output_type": "execute_result"
},
{
"data": {
"image/png": "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\n",
"text/plain": [
"<Figure size 432x288 with 1 Axes>"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"### type your answer here\n",
"new_df.plot(kind='box')\n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"new_df.plot(kind='box', figsize=(10, 6))\n",
"-->\n",
"\n",
"<!--\n",
"plt.title('Immigration from top 15 countries for decades 80s, 90s and 2000s')\n",
"-->\n",
"\n",
"<!--\n",
"plt.show()\n",
"-->"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Note how the box plot differs from the summary table created. The box plot scans the data and identifies the outliers. In order to be an outlier, the data value must be:<br>\n",
"* larger than Q3 by at least 1.5 times the interquartile range (IQR), or,\n",
"* smaller than Q1 by at least 1.5 times the IQR.\n",
"\n",
"Let's look at decade 2000s as an example: <br>\n",
"* Q1 (25%) = 36,101.5 <br>\n",
"* Q3 (75%) = 105,505.5 <br>\n",
"* IQR = Q3 - Q1 = 69,404 <br>\n",
"\n",
"Using the definition of outlier, any value that is greater than Q3 by 1.5 times IQR will be flagged as outlier.\n",
"\n",
"Outlier > 105,505.5 + (1.5 * 69,404) <br>\n",
"Outlier > 209,611.5"
]
},
{
"cell_type": "code",
"execution_count": 41,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>1980s</th>\n",
" <th>1990s</th>\n",
" <th>2000s</th>\n",
" </tr>\n",
" <tr>\n",
" <th>Country</th>\n",
" <th></th>\n",
" <th></th>\n",
" <th></th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>India</th>\n",
" <td>82154</td>\n",
" <td>180395</td>\n",
" <td>303591</td>\n",
" </tr>\n",
" <tr>\n",
" <th>China</th>\n",
" <td>32003</td>\n",
" <td>161528</td>\n",
" <td>340385</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
" 1980s 1990s 2000s\n",
"Country \n",
"India 82154 180395 303591\n",
"China 32003 161528 340385"
]
},
"execution_count": 41,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# let's check how many entries fall above the outlier threshold \n",
"new_df[new_df['2000s']> 209611.5]"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"China and India are both considered as outliers since their population for the decade exceeds 209,611.5. \n",
"\n",
"The box plot is an advanced visualizaiton tool, and there are many options and customizations that exceed the scope of this lab. Please refer to [Matplotlib documentation](http://matplotlib.org/api/pyplot_api.html#matplotlib.pyplot.boxplot) on box plots for more information."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"# Scatter Plots <a id=\"10\"></a>\n",
"\n",
"A `scatter plot` (2D) is a useful method of comparing variables against each other. `Scatter` plots look similar to `line plots` in that they both map independent and dependent variables on a 2D graph. While the datapoints are connected together by a line in a line plot, they are not connected in a scatter plot. The data in a scatter plot is considered to express a trend. With further analysis using tools like regression, we can mathematically calculate this relationship and use it to predict trends outside the dataset.\n",
"\n",
"Let's start by exploring the following:\n",
"\n",
"Using a `scatter plot`, let's visualize the trend of total immigrantion to Canada (all countries combined) for the years 1980 - 2013."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 1: Get the dataset. Since we are expecting to use the relationship betewen `years` and `total population`, we will convert `years` to `int` type."
]
},
{
"cell_type": "code",
"execution_count": 42,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>year</th>\n",
" <th>total</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>0</th>\n",
" <td>1980</td>\n",
" <td>99137</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1</th>\n",
" <td>1981</td>\n",
" <td>110563</td>\n",
" </tr>\n",
" <tr>\n",
" <th>2</th>\n",
" <td>1982</td>\n",
" <td>104271</td>\n",
" </tr>\n",
" <tr>\n",
" <th>3</th>\n",
" <td>1983</td>\n",
" <td>75550</td>\n",
" </tr>\n",
" <tr>\n",
" <th>4</th>\n",
" <td>1984</td>\n",
" <td>73417</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
" year total\n",
"0 1980 99137\n",
"1 1981 110563\n",
"2 1982 104271\n",
"3 1983 75550\n",
"4 1984 73417"
]
},
"execution_count": 42,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# we can use the sum() method to get the total population per year\n",
"df_tot = pd.DataFrame(df_can[years].sum(axis=0))\n",
"\n",
"# change the years to type int (useful for regression later on)\n",
"df_tot.index = map(int, df_tot.index)\n",
"\n",
"# reset the index to put in back in as a column in the df_tot dataframe\n",
"df_tot.reset_index(inplace = True)\n",
"\n",
"# rename columns\n",
"df_tot.columns = ['year', 'total']\n",
"\n",
"# view the final dataframe\n",
"df_tot.head()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 2: Plot the data. In `Matplotlib`, we can create a `scatter` plot set by passing in `kind='scatter'` as plot argument. We will also need to pass in `x` and `y` keywords to specify the columns that go on the x- and the y-axis."
]
},
{
"cell_type": "code",
"execution_count": 43,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
"<Figure size 720x432 with 1 Axes>"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"df_tot.plot(kind='scatter', x='year', y='total', figsize=(10, 6), color='darkblue')\n",
"\n",
"plt.title('Total Immigration to Canada from 1980 - 2013')\n",
"plt.xlabel('Year')\n",
"plt.ylabel('Number of Immigrants')\n",
"\n",
"plt.show()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Notice how the scatter plot does not connect the datapoints together. We can clearly observe an upward trend in the data: as the years go by, the total number of immigrants increases. We can mathematically analyze this upward trend using a regression line (line of best fit). "
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"So let's try to plot a linear line of best fit, and use it to predict the number of immigrants in 2015.\n",
"\n",
"Step 1: Get the equation of line of best fit. We will use **Numpy**'s `polyfit()` method by passing in the following:\n",
"- `x`: x-coordinates of the data. \n",
"- `y`: y-coordinates of the data. \n",
"- `deg`: Degree of fitting polynomial. 1 = linear, 2 = quadratic, and so on."
]
},
{
"cell_type": "code",
"execution_count": 44,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/plain": [
"array([ 5.56709228e+03, -1.09261952e+07])"
]
},
"execution_count": 44,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"x = df_tot['year'] # year on x-axis\n",
"y = df_tot['total'] # total on y-axis\n",
"fit = np.polyfit(x, y, deg=1)\n",
"\n",
"fit"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"The output is an array with the polynomial coefficients, highest powers first. Since we are plotting a linear regression `y= a*x + b`, our output has 2 elements `[5.56709228e+03, -1.09261952e+07]` with the the slope in position 0 and intercept in position 1. \n",
"\n",
"Step 2: Plot the regression line on the `scatter plot`."
]
},
{
"cell_type": "code",
"execution_count": 45,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"image/png": "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1+nSrYiIiEgrpURPREREpJVSoiciIiLSSinRExEREWmllOiJiIiItFJK9ERERERaKSV6IiIiIq2UEj0RERGRVkqJnoiIiEgrpURPREREpJVSoiciIiLSSinRExEREWkE0atX0+6jjyIaQ0xEzy4iIiLSykT//DPJEyeSOG8e5fvtx4bFi8GYiMSiRE9ERESkAUStXUvK5MkkzpkDxlAwZAj5I0ZELMkDJXoiIiIiuyRq/XqSp0wh6dlnoaKCwgEDyB81ioo994x0aEr0REREpPlavTqPkSOXk5tbRocOsWRknET37smRDguAqOxskqdOJfHJJzFlZRRddhl5t9xCRffukQ5tCyV6IiIi0myNHLmczz7L2rI8YsQy5s/vF8GIwOTkkDx9OkmzZmEKCym65BLyRo+mYr/9IhpXTZToiYiISLOVnV28w+WmZDZvJmnmTJKnTycqL4+iCy8k77bbKO/ZM2Ix7YwSPREREWm2UlPjyczM32a5qZmCApJmzSL58ceJ2rSJonPO8RO8gw9u8ljqSomeiIiINFsZGScxYsSybfroNRVTVETi00+TPGUK0dnZFJ95JnljxlB2+OFNFsOuUqInIiIizVb37snMn9+PtLQ0srKydr5DQyguJmn2bJIzMojesIHivn3JHjOGst69m+b8DUiJnoiIiAhASQmJc+eSMmkS0b/+SsmJJ5Lz+OOUHn98pCOrNyV6IiIi0raVlZH4wgskP/ooMT//TMmxx5IzaRKlJ58c6ch2mRI9ERERaZvKy0l45RVSJkwgZvVqSo86io2PPELJqadG9G4WDUmJnoiIiLQtFRUkvP46yePHE/u//1F66KFsfOopSs46q9UkeFWU6ImIiEjbUFlJ/IIFpIwfT+zKlZQddBDZM2dSfM45rS7Bq6JET0RERFo3zyNu0SLajx1L7DffUHbAAWQ/9hjFF1wAUVGRjq5RKdETERGR1snziHvvPVLS02n3xReU77svOZMmUXTxxRAdHenomoQSPREREWldPI92S5fSfuxY2n32GeV7703O+PEUXXopxLSt1KdtPVsRERFp1dp9+CEpY8cS9+GHVHTtyqaHHqJwwABo1y7SoUWEEj0RERFp8WI//ZT26enEvf8+Fbvvzqa//Y3CK66AuLhIhxZRSvRERESkxYr98ktS0tOJX7yYirQ0cu++m4IhQyAhIdKh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\n",
"text/plain": [
"<Figure size 720x432 with 1 Axes>"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
},
{
"data": {
"text/plain": [
"'No. Immigrants = 5567 * Year + -10926195'"
]
},
"execution_count": 45,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_tot.plot(kind='scatter', x='year', y='total', figsize=(10, 6), color='darkblue')\n",
"\n",
"plt.title('Total Immigration to Canada from 1980 - 2013')\n",
"plt.xlabel('Year')\n",
"plt.ylabel('Number of Immigrants')\n",
"\n",
"# plot line of best fit\n",
"plt.plot(x, fit[0] * x + fit[1], color='red') # recall that x is the Years\n",
"plt.annotate('y={0:.0f} x + {1:.0f}'.format(fit[0], fit[1]), xy=(2000, 150000))\n",
"\n",
"plt.show()\n",
"\n",
"# print out the line of best fit\n",
"'No. Immigrants = {0:.0f} * Year + {1:.0f}'.format(fit[0], fit[1]) "
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Using the equation of line of best fit, we can estimate the number of immigrants in 2015:\n",
"```python\n",
"No. Immigrants = 5567 * Year - 10926195\n",
"No. Immigrants = 5567 * 2015 - 10926195\n",
"No. Immigrants = 291,310\n",
"```\n",
"When compared to the actuals from Citizenship and Immigration Canada's (CIC) [2016 Annual Report](http://www.cic.gc.ca/english/resources/publications/annual-report-2016/index.asp), we see that Canada accepted 271,845 immigrants in 2015. Our estimated value of 291,310 is within 7% of the actual number, which is pretty good considering our original data came from United Nations (and might differ slightly from CIC data).\n",
"\n",
"As a side note, we can observe that immigration took a dip around 1993 - 1997. Further analysis into the topic revealed that in 1993 Canada introcuded Bill C-86 which introduced revisions to the refugee determination system, mostly restrictive. Further amendments to the Immigration Regulations cancelled the sponsorship required for \"assisted relatives\" and reduced the points awarded to them, making it more difficult for family members (other than nuclear family) to immigrate to Canada. These restrictive measures had a direct impact on the immigration numbers for the next several years."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"**Question**: Create a scatter plot of the total immigration from Denmark, Norway, and Sweden to Canada from 1980 to 2013?"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 1: Get the data:\n",
" 1. Create a dataframe the consists of the numbers associated with Denmark, Norway, and Sweden only. Name it **df_countries**.\n",
" 2. Sum the immigration numbers across all three countries for each year and turn the result into a dataframe. Name this new dataframe **df_total**.\n",
" 3. Reset the index in place.\n",
" 4. Rename the columns to **year** and **total**.\n",
" 5. Display the resulting dataframe."
]
},
{
"cell_type": "code",
"execution_count": 47,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>year</th>\n",
" <th>total</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>0</th>\n",
" <td>1980</td>\n",
" <td>669</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1</th>\n",
" <td>1981</td>\n",
" <td>678</td>\n",
" </tr>\n",
" <tr>\n",
" <th>2</th>\n",
" <td>1982</td>\n",
" <td>627</td>\n",
" </tr>\n",
" <tr>\n",
" <th>3</th>\n",
" <td>1983</td>\n",
" <td>333</td>\n",
" </tr>\n",
" <tr>\n",
" <th>4</th>\n",
" <td>1984</td>\n",
" <td>252</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
" year total\n",
"0 1980 669\n",
"1 1981 678\n",
"2 1982 627\n",
"3 1983 333\n",
"4 1984 252"
]
},
"execution_count": 47,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"### type your answer here\n",
"df_countries = df_can.loc[['Denmark', 'Norway', 'Sweden'], years].transpose()\n",
"\n",
"df_total = pd.DataFrame(df_countries.sum(axis=1))\n",
"\n",
"df_total.reset_index(inplace=True)\n",
"\n",
"df_total.columns = ['year', 'total']\n",
"\n",
"df_total['year'] = df_total['year'].astype(int)\n",
"\n",
"df_total.head()\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"\\\\ # create df_countries dataframe\n",
"df_countries = df_can.loc[['Denmark', 'Norway', 'Sweden'], years].transpose()\n",
"-->\n",
"\n",
"<!--\n",
"\\\\ # create df_total by summing across three countries for each year\n",
"df_total = pd.DataFrame(df_countries.sum(axis=1))\n",
"-->\n",
"\n",
"<!--\n",
"\\\\ # reset index in place\n",
"df_total.reset_index(inplace=True)\n",
"-->\n",
"\n",
"<!--\n",
"\\\\ # rename columns\n",
"df_total.columns = ['year', 'total']\n",
"-->\n",
"\n",
"<!--\n",
"\\\\ # change column year from string to int to create scatter plot\n",
"df_total['year'] = df_total['year'].astype(int)\n",
"-->\n",
"\n",
"<!--\n",
"\\\\ # show resulting dataframe\n",
"df_total.head()\n",
"-->"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 2: Generate the scatter plot by plotting the total versus year in **df_total**."
]
},
{
"cell_type": "code",
"execution_count": 49,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/plain": [
"Text(0, 0.5, 'Number of Immigrants')"
]
},
"execution_count": 49,
"metadata": {},
"output_type": "execute_result"
},
{
"data": {
"image/png": "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\n",
"text/plain": [
"<Figure size 720x432 with 1 Axes>"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"### type your answer here\n",
"df_total.plot(kind='scatter', x='year', y='total', figsize=(10, 6), color='darkblue')\n",
"\n",
"plt.title('Total Immigration to Canada from 1980 - 2013')\n",
"plt.xlabel('Year')\n",
"plt.ylabel('Number of Immigrants')\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"\\\\ # generate scatter plot\n",
"df_total.plot(kind='scatter', x='year', y='total', figsize=(10, 6), color='darkblue')\n",
"-->\n",
"\n",
"<!--\n",
"\\\\ # add title and label to axes\n",
"plt.title('Immigration from Denmark, Norway, and Sweden to Canada from 1980 - 2013')\n",
"plt.xlabel('Year')\n",
"plt.ylabel('Number of Immigrants')\n",
"-->\n",
"\n",
"<!--\n",
"\\\\ # show plot\n",
"plt.show()\n",
"-->"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"# Bubble Plots <a id=\"12\"></a>\n",
"\n",
"A `bubble plot` is a variation of the `scatter plot` that displays three dimensions of data (x, y, z). The datapoints are replaced with bubbles, and the size of the bubble is determined by the third variable 'z', also known as the weight. In `maplotlib`, we can pass in an array or scalar to the keyword `s` to `plot()`, that contains the weight of each point.\n",
"\n",
"**Let's start by analyzing the effect of Argentina's great depression**.\n",
"\n",
"Argentina suffered a great depression from 1998 - 2002, which caused widespread unemployment, riots, the fall of the government, and a default on the country's foreign debt. In terms of income, over 50% of Argentines were poor, and seven out of ten Argentine children were poor at the depth of the crisis in 2002. \n",
"\n",
"Let's analyze the effect of this crisis, and compare Argentina's immigration to that of it's neighbour Brazil. Let's do that using a `bubble plot` of immigration from Brazil and Argentina for the years 1980 - 2013. We will set the weights for the bubble as the *normalized* value of the population for each year."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 1: Get the data for Brazil and Argentina. Like in the previous example, we will convert the `Years` to type int and bring it in the dataframe."
]
},
{
"cell_type": "code",
"execution_count": 50,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th>Country</th>\n",
" <th>Year</th>\n",
" <th>Afghanistan</th>\n",
" <th>Albania</th>\n",
" <th>Algeria</th>\n",
" <th>American Samoa</th>\n",
" <th>Andorra</th>\n",
" <th>Angola</th>\n",
" <th>Antigua and Barbuda</th>\n",
" <th>Argentina</th>\n",
" <th>Armenia</th>\n",
" <th>...</th>\n",
" <th>United States of America</th>\n",
" <th>Uruguay</th>\n",
" <th>Uzbekistan</th>\n",
" <th>Vanuatu</th>\n",
" <th>Venezuela (Bolivarian Republic of)</th>\n",
" <th>Viet Nam</th>\n",
" <th>Western Sahara</th>\n",
" <th>Yemen</th>\n",
" <th>Zambia</th>\n",
" <th>Zimbabwe</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>0</th>\n",
" <td>1980</td>\n",
" <td>16</td>\n",
" <td>1</td>\n",
" <td>80</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>1</td>\n",
" <td>0</td>\n",
" <td>368</td>\n",
" <td>0</td>\n",
" <td>...</td>\n",
" <td>9378</td>\n",
" <td>128</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>103</td>\n",
" <td>1191</td>\n",
" <td>0</td>\n",
" <td>1</td>\n",
" <td>11</td>\n",
" <td>72</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1</th>\n",
" <td>1981</td>\n",
" <td>39</td>\n",
" <td>0</td>\n",
" <td>67</td>\n",
" <td>1</td>\n",
" <td>0</td>\n",
" <td>3</td>\n",
" <td>0</td>\n",
" <td>426</td>\n",
" <td>0</td>\n",
" <td>...</td>\n",
" <td>10030</td>\n",
" <td>132</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>117</td>\n",
" <td>1829</td>\n",
" <td>0</td>\n",
" <td>2</td>\n",
" <td>17</td>\n",
" <td>114</td>\n",
" </tr>\n",
" <tr>\n",
" <th>2</th>\n",
" <td>1982</td>\n",
" <td>39</td>\n",
" <td>0</td>\n",
" <td>71</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>6</td>\n",
" <td>0</td>\n",
" <td>626</td>\n",
" <td>0</td>\n",
" <td>...</td>\n",
" <td>9074</td>\n",
" <td>146</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>174</td>\n",
" <td>2162</td>\n",
" <td>0</td>\n",
" <td>1</td>\n",
" <td>11</td>\n",
" <td>102</td>\n",
" </tr>\n",
" <tr>\n",
" <th>3</th>\n",
" <td>1983</td>\n",
" <td>47</td>\n",
" <td>0</td>\n",
" <td>69</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>6</td>\n",
" <td>0</td>\n",
" <td>241</td>\n",
" <td>0</td>\n",
" <td>...</td>\n",
" <td>7100</td>\n",
" <td>105</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>124</td>\n",
" <td>3404</td>\n",
" <td>0</td>\n",
" <td>6</td>\n",
" <td>7</td>\n",
" <td>44</td>\n",
" </tr>\n",
" <tr>\n",
" <th>4</th>\n",
" <td>1984</td>\n",
" <td>71</td>\n",
" <td>0</td>\n",
" <td>63</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>4</td>\n",
" <td>42</td>\n",
" <td>237</td>\n",
" <td>0</td>\n",
" <td>...</td>\n",
" <td>6661</td>\n",
" <td>90</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>142</td>\n",
" <td>7583</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>16</td>\n",
" <td>32</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"<p>5 rows × 196 columns</p>\n",
"</div>"
],
"text/plain": [
"Country Year Afghanistan Albania Algeria American Samoa Andorra Angola \\\n",
"0 1980 16 1 80 0 0 1 \n",
"1 1981 39 0 67 1 0 3 \n",
"2 1982 39 0 71 0 0 6 \n",
"3 1983 47 0 69 0 0 6 \n",
"4 1984 71 0 63 0 0 4 \n",
"\n",
"Country Antigua and Barbuda Argentina Armenia ... \\\n",
"0 0 368 0 ... \n",
"1 0 426 0 ... \n",
"2 0 626 0 ... \n",
"3 0 241 0 ... \n",
"4 42 237 0 ... \n",
"\n",
"Country United States of America Uruguay Uzbekistan Vanuatu \\\n",
"0 9378 128 0 0 \n",
"1 10030 132 0 0 \n",
"2 9074 146 0 0 \n",
"3 7100 105 0 0 \n",
"4 6661 90 0 0 \n",
"\n",
"Country Venezuela (Bolivarian Republic of) Viet Nam Western Sahara Yemen \\\n",
"0 103 1191 0 1 \n",
"1 117 1829 0 2 \n",
"2 174 2162 0 1 \n",
"3 124 3404 0 6 \n",
"4 142 7583 0 0 \n",
"\n",
"Country Zambia Zimbabwe \n",
"0 11 72 \n",
"1 17 114 \n",
"2 11 102 \n",
"3 7 44 \n",
"4 16 32 \n",
"\n",
"[5 rows x 196 columns]"
]
},
"execution_count": 50,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_can_t = df_can[years].transpose() # transposed dataframe\n",
"\n",
"# cast the Years (the index) to type int\n",
"df_can_t.index = map(int, df_can_t.index)\n",
"\n",
"# let's label the index. This will automatically be the column name when we reset the index\n",
"df_can_t.index.name = 'Year'\n",
"\n",
"# reset index to bring the Year in as a column\n",
"df_can_t.reset_index(inplace=True)\n",
"\n",
"# view the changes\n",
"df_can_t.head()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 2: Create the normalized weights. \n",
"\n",
"There are several methods of normalizations in statistics, each with its own use. In this case, we will use [feature scaling](https://en.wikipedia.org/wiki/Feature_scaling) to bring all values into the range [0,1]. The general formula is:\n",
"\n",
"<img src=\"https://s3-api.us-geo.objectstorage.softlayer.net/cf-courses-data/CognitiveClass/DV0101EN/labs/Images/Mod3Fig3FeatureScaling.png\" align=\"center\">\n",
"\n",
"where *`X`* is an original value, *`X'`* is the normalized value. The formula sets the max value in the dataset to 1, and sets the min value to 0. The rest of the datapoints are scaled to a value between 0-1 accordingly.\n"
]
},
{
"cell_type": "code",
"execution_count": 51,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [],
"source": [
"# normalize Brazil data\n",
"norm_brazil = (df_can_t['Brazil'] - df_can_t['Brazil'].min()) / (df_can_t['Brazil'].max() - df_can_t['Brazil'].min())\n",
"\n",
"# normalize Argentina data\n",
"norm_argentina = (df_can_t['Argentina'] - df_can_t['Argentina'].min()) / (df_can_t['Argentina'].max() - df_can_t['Argentina'].min())"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 3: Plot the data. \n",
"- To plot two different scatter plots in one plot, we can include the axes one plot into the other by passing it via the `ax` parameter. \n",
"- We will also pass in the weights using the `s` parameter. Given that the normalized weights are between 0-1, they won't be visible on the plot. Therefore we will:\n",
" - multiply weights by 2000 to scale it up on the graph, and,\n",
" - add 10 to compensate for the min value (which has a 0 weight and therefore scale with x2000)."
]
},
{
"cell_type": "code",
"execution_count": 52,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"editable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/plain": [
"<matplotlib.legend.Legend at 0x7f196542bb00>"
]
},
"execution_count": 52,
"metadata": {},
"output_type": "execute_result"
},
{
"data": {
"image/png": "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\n",
"text/plain": [
"<Figure size 1008x576 with 1 Axes>"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"# Brazil\n",
"ax0 = df_can_t.plot(kind='scatter',\n",
" x='Year',\n",
" y='Brazil',\n",
" figsize=(14, 8),\n",
" alpha=0.5, # transparency\n",
" color='green',\n",
" s=norm_brazil * 2000 + 10, # pass in weights \n",
" xlim=(1975, 2015)\n",
" )\n",
"\n",
"# Argentina\n",
"ax1 = df_can_t.plot(kind='scatter',\n",
" x='Year',\n",
" y='Argentina',\n",
" alpha=0.5,\n",
" color=\"blue\",\n",
" s=norm_argentina * 2000 + 10,\n",
" ax = ax0\n",
" )\n",
"\n",
"ax0.set_ylabel('Number of Immigrants')\n",
"ax0.set_title('Immigration from Brazil and Argentina from 1980 - 2013')\n",
"ax0.legend(['Brazil', 'Argentina'], loc='upper left', fontsize='x-large')"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"The size of the bubble corresponds to the magnitude of immigrating population for that year, compared to the 1980 - 2013 data. The larger the bubble, the more immigrants in that year.\n",
"\n",
"From the plot above, we can see a corresponding increase in immigration from Argentina during the 1998 - 2002 great depression. We can also observe a similar spike around 1985 to 1993. In fact, Argentina had suffered a great depression from 1974 - 1990, just before the onset of 1998 - 2002 great depression. \n",
"\n",
"On a similar note, Brazil suffered the *Samba Effect* where the Brazilian real (currency) dropped nearly 35% in 1999. There was a fear of a South American financial crisis as many South American countries were heavily dependent on industrial exports from Brazil. The Brazilian government subsequently adopted an austerity program, and the economy slowly recovered over the years, culminating in a surge in 2010. The immigration data reflect these events."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"**Question**: Previously in this lab, we created box plots to compare immigration from China and India to Canada. Create bubble plots of immigration from China and India to visualize any differences with time from 1980 to 2013. You can use **df_can_t** that we defined and used in the previous example."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 1: Normalize the data pertaining to China and India."
]
},
{
"cell_type": "code",
"execution_count": 53,
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [],
"source": [
"### type your answer here\n",
"\n",
"norm_china = (df_can_t['China'] - df_can_t['China'].min()) / (df_can_t['China'].max() - df_can_t['China'].min())\n",
"\n",
"# normalize Argentina data\n",
"norm_india = (df_can_t['India'] - df_can_t['India'].min()) / (df_can_t['India'].max() - df_can_t['India'].min())\n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"\\\\ # normalize China data\n",
"norm_china = (df_can_t['China'] - df_can_t['China'].min()) / (df_can_t['China'].max() - df_can_t['China'].min())\n",
"-->\n",
"\n",
"<!--\n",
"# normalize India data\n",
"norm_india = (df_can_t['India'] - df_can_t['India'].min()) / (df_can_t['India'].max() - df_can_t['India'].min())\n",
"-->"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 2: Generate the bubble plots."
]
},
{
"cell_type": "code",
"execution_count": 55,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/plain": [
"<matplotlib.legend.Legend at 0x7f1965e53550>"
]
},
"execution_count": 55,
"metadata": {},
"output_type": "execute_result"
},
{
"data": {
"image/png": "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IJ6Os611GwFfYFLKC/gCbGvZNmEzyV9zzTXcdtttI67zrW99i/PPP39CyhdCCCFE/hq6G6ZFABbwBajtqC10NYQoOAnAxuCVI6/gaGdSy3S0w+ajm8e1bXt7O1//+te58MILWbJkCevWreOqq67ioYceIp1O57SPm2++mccff3xc5QshhBBiYiXtJN3J7kJXI2ddia5Jv5cSYqqRNPQ50lqz49gOgmZwUssNmkG2tW5jY9XGMXV7bGpq4sorr8Q0TW677TZOP/10TNPk9ddf56677mL16tU57ScSiRCJTN1BvUIIIcSprDnaTMpJEWRy70/GK2knaYu1URGuKHRVhCgYaQHLUU+qh65EV0HK7k5005vqHdM2X/3qV0kmkzz99NNcddVVrFixgiVLllBdXc2vfvUrlixZMrDud77zHdavX8/atWu59dZbiUajA58N7oLY//6ZZ55h48aNLFu2jGuuuYaGhoaBdTo7O/nSl77Ee9/7XpYuXcqFF17ID3/4Q7TW4z8JQgghhDhBbUctQd/0CL7ATUlf31lf6GoIUVASgOWosbsRChQ/aK1p7GnMef2Ojg6ee+45brjhBkpKSk743LIswuEwAE8++SSdnZ08/PDD3HHHHTzzzDPceeedI+6/ubmZ++67jzvuuINHH32U7u5uvvKVrwx8nkwmWbVqFT/96U/57W9/y6233sq3vvUtampqcj4GIYQQQoyuJdqC5Zv647/6BXyBU2qaHSGGIl0Qc1TfWT9h836NJmSFqO+sZ82sNTmt39DQgOM4rFixYtR1q6qq+Id/+AcAli1bxuWXX84LL7wwYnKOZDLJ7bffzqxZswC45ZZbuOWWW4jH4wSDQSorK7nlllsG1l+4cCHbt2/nkUce4dprr83pGIQQQggxurST25juqUIpRUqnCl0NIQpKArAcRdNRDFWYBkNDGfSl+nJev7+rXy5jxtasOT6omzNnDi+++OKI28yePXsg+OrfRmtNW1sbVVVVOI7DnXfeyaOPPsqRI0dIJBKk02mqqqpyPgYhhBBCjM5h+iW0cJzpV2chvCRdEHNU6Iw9Yyl/8eLFGIbBnj17Rl3X7/cf914pNeofxqG2gXf/oN51113ccccd3HjjjfziF7/g2Wef5frrryeVkideQgghhJcUU3fy5eEU6oG2EFOF/AbkqNB/LMZSfllZGR/84Ae5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\n",
"text/plain": [
"<Figure size 1008x576 with 1 Axes>"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"### type your answer here\n",
"# Brazil\n",
"ax0 = df_can_t.plot(kind='scatter',\n",
" x='Year',\n",
" y='China',\n",
" figsize=(14, 8),\n",
" alpha=0.5, # transparency\n",
" color='green',\n",
" s=norm_china * 2000 + 10, # pass in weights \n",
" xlim=(1975, 2015)\n",
" )\n",
"\n",
"# Argentina\n",
"ax1 = df_can_t.plot(kind='scatter',\n",
" x='Year',\n",
" y='India',\n",
" alpha=0.5,\n",
" color=\"blue\",\n",
" s=norm_india * 2000 + 10,\n",
" ax = ax0\n",
" )\n",
"\n",
"ax0.set_ylabel('Number of Immigrants')\n",
"ax0.set_title('Immigration from China and India from 1980 - 2013')\n",
"ax0.legend(['China', 'India'], loc='upper left', fontsize='x-large')\n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"\\\\ # China\n",
"ax0 = df_can_t.plot(kind='scatter',\n",
" x='Year',\n",
" y='China',\n",
" figsize=(14, 8),\n",
" alpha=0.5, # transparency\n",
" color='green',\n",
" s=norm_china * 2000 + 10, # pass in weights \n",
" xlim=(1975, 2015)\n",
" )\n",
"-->\n",
"\n",
"<!--\n",
"\\\\ # India\n",
"ax1 = df_can_t.plot(kind='scatter',\n",
" x='Year',\n",
" y='India',\n",
" alpha=0.5,\n",
" color=\"blue\",\n",
" s=norm_india * 2000 + 10,\n",
" ax = ax0\n",
" )\n",
"-->\n",
"\n",
"<!--\n",
"ax0.set_ylabel('Number of Immigrants')\n",
"ax0.set_title('Immigration from China and India from 1980 - 2013')\n",
"ax0.legend(['China', 'India'], loc='upper left', fontsize='x-large')\n",
"-->"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"### Thank you for completing this lab!\n",
"\n",
"This notebook was created by [Jay Rajasekharan](https://www.linkedin.com/in/jayrajasekharan) with contributions from [Ehsan M. Kermani](https://www.linkedin.com/in/ehsanmkermani), and [Slobodan Markovic](https://www.linkedin.com/in/slobodan-markovic).\n",
"\n",
"This notebook was recently revamped by [Alex Aklson](https://www.linkedin.com/in/aklson/). I hope you found this lab session interesting. Feel free to contact me if you have any questions!"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"This notebook is part of a course on **edX** called *Visualizing Data with Python*. If you accessed this notebook outside the course, you can take this course online by clicking [here](http://cocl.us/DV0101EN_edX_LAB3)."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"editable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"<hr>\n",
"\n",
"Copyright &copy; 2019 [Cognitive Class](https://cognitiveclass.ai/?utm_source=bducopyrightlink&utm_medium=dswb&utm_campaign=bdu). This notebook and its source code are released under the terms of the [MIT License](https://bigdatauniversity.com/mit-license/)."
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python",
"language": "python",
"name": "conda-env-python-py"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.6.7"
},
"widgets": {
"state": {},
"version": "1.1.2"
}
},
"nbformat": 4,
"nbformat_minor": 4
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment