Skip to content

Instantly share code, notes, and snippets.

@rezapci

rezapci/DV0101EN-1-1-1-Introduction-to-Matplotlib-and-Line-Plots-py-v2.0.ipynb

Created July 28, 2019 21:56
Show Gist options
  • Save rezapci/8384e6da468ce243bdac671f62b87b7d to your computer and use it in GitHub Desktop.
Save rezapci/8384e6da468ce243bdac671f62b87b7d to your computer and use it in GitHub Desktop.
Download ZIP
Created on Cognitive Class Labs
Display the source blob
Display the rendered blob
Raw
DV0101EN-1-1-1-Introduction-to-Matplotlib-and-Line-Plots-py-v2.0.ipynb
{
"cells": [
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": 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>Introduction to Matplotlib and Line Plots</font></h1>\n",
"\n",
"| Name | Description | Date \n",
"| :- |-------------: | :-:\n",
"|Reza Hashemi| Microsoft Principles of Machine Learning: Python Edition. | On 29th of july 2019"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"## Introduction\n",
"\n",
"The aim of these labs is to introduce you to data visualization with Python as concrete and as consistent as possible. \n",
"Speaking of consistency, because there is no *best* data visualization library avaiblable for Python - up to creating these labs - we have to introduce different libraries and show their benefits when we are discussing new visualization concepts. Doing so, we hope to make students well-rounded with visualization libraries and concepts so that they are able to judge and decide on the best visualitzation technique and tool for a given problem _and_ audience.\n",
"\n",
"Please make sure that you have completed the prerequisites for this course, namely <a href='http://cocl.us/PY0101EN_DV0101EN_LAB1_Coursera'>**Python for Data Science**</a> and <a href='http://cocl.us/DA0101EN_DV0101EN_LAB1_Coursera'>**Data Analysis with Python**</a>, which are part of this specialization. \n",
"\n",
"**Note**: The majority of the plots and visualizations will be generated using data stored in *pandas* dataframes. Therefore, in this lab, we provide a brief crash course on *pandas*. However, if you are interested in learning more about the *pandas* library, detailed description and explanation of how to use it and how to clean, munge, and process data stored in a *pandas* dataframe are provided in our course <a href='http://cocl.us/DA0101EN_DV0101EN_LAB1_Coursera'>**Data Analysis with Python**</a>, which is also part of this specialization. \n",
"\n",
"------------"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": 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 *pandas*](#0)<br>\n",
"1.1 [The Dataset: Immigration to Canada from 1980 to 2013](#2)<br>\n",
"1.2 [*pandas* Basics](#4) <br>\n",
"1.3 [*pandas* Intermediate: Indexing and Selection](#6) <br>\n",
"2. [Visualizing Data using Matplotlib](#8) <br>\n",
"2.1 [Matplotlib: Standard Python Visualization Library](#10) <br>\n",
"3. [Line Plots](#12)\n",
"</div>\n",
"<hr>"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"# Exploring Datasets with *pandas* <a id=\"0\"></a>\n",
"\n",
"*pandas* is an essential data analysis toolkit for Python. From their [website](http://pandas.pydata.org/):\n",
">*pandas* is a Python package providing fast, flexible, and expressive data structures designed to make working with “relational” or “labeled” data both easy and intuitive. It aims to be the fundamental high-level building block for doing practical, **real world** data analysis in Python.\n",
"\n",
"The course heavily relies on *pandas* for data wrangling, analysis, and visualization. We encourage you to spend some time and familizare yourself with the *pandas* API Reference: http://pandas.pydata.org/pandas-docs/stable/api.html."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"## The Dataset: Immigration to Canada from 1980 to 2013 <a id=\"2\"></a>"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Dataset Source: [International migration flows to and from selected countries - The 2015 revision](http://www.un.org/en/development/desa/population/migration/data/empirical2/migrationflows.shtml).\n",
"\n",
"The dataset contains annual data on the flows of international immigrants 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. The current version presents data pertaining to 45 countries.\n",
"\n",
"In this lab, we will focus on the Canadian immigration data.\n",
"\n",
"<img src = \"https://s3-api.us-geo.objectstorage.softlayer.net/cf-courses-data/CognitiveClass/DV0101EN/labs/Images/Mod1Fig1-Dataset.png\" align=\"center\" width=900>\n",
"\n",
"For sake of simplicity, Canada's immigration data has been extracted and uploaded to one of IBM servers. You can fetch the data from [here](https://ibm.box.com/shared/static/lw190pt9zpy5bd1ptyg2aw15awomz9pu.xlsx).\n",
"\n",
"---"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"## *pandas* Basics<a id=\"4\"></a>"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"The first thing we'll do is import two key data analysis modules: *pandas* and **Numpy**."
]
},
{
"cell_type": "code",
"execution_count": 3,
"metadata": {
"button": false,
"deletable": true,
"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,
"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": "code",
"execution_count": 9,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Collecting xlrd\n",
"\u001b[?25l Downloading https://files.pythonhosted.org/packages/b0/16/63576a1a001752e34bf8ea62e367997530dc553b689356b9879339cf45a4/xlrd-1.2.0-py2.py3-none-any.whl (103kB)\n",
"\u001b[K |████████████████████████████████| 112kB 818kB/s eta 0:00:01\n",
"\u001b[?25hInstalling collected packages: xlrd\n",
"Successfully installed xlrd-1.2.0\n",
"xlrd installed!\n"
]
}
],
"source": [
"!pip install xlrd\n",
"print('xlrd installed!')"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Now we are ready to read in our data."
]
},
{
"cell_type": "code",
"execution_count": 65,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Data read into a pandas dataframe!\n"
]
}
],
"source": [
"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",
"print ('Data read into a pandas dataframe!')"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Let's view the top 5 rows of the dataset using the `head()` function."
]
},
{
"cell_type": "code",
"execution_count": 66,
"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></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": 66,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_can.head()\n",
"# tip: You can specify the number of rows you'd like to see as follows: df_can.head(10) "
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"We can also veiw the bottom 5 rows of the dataset using the `tail()` function."
]
},
{
"cell_type": "code",
"execution_count": 67,
"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></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>190</th>\n",
" <td>Immigrants</td>\n",
" <td>Foreigners</td>\n",
" <td>Viet Nam</td>\n",
" <td>935</td>\n",
" <td>Asia</td>\n",
" <td>920</td>\n",
" <td>South-Eastern Asia</td>\n",
" <td>902</td>\n",
" <td>Developing regions</td>\n",
" <td>1191</td>\n",
" <td>...</td>\n",
" <td>1816</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",
" </tr>\n",
" <tr>\n",
" <th>191</th>\n",
" <td>Immigrants</td>\n",
" <td>Foreigners</td>\n",
" <td>Western Sahara</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>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>192</th>\n",
" <td>Immigrants</td>\n",
" <td>Foreigners</td>\n",
" <td>Yemen</td>\n",
" <td>935</td>\n",
" <td>Asia</td>\n",
" <td>922</td>\n",
" <td>Western Asia</td>\n",
" <td>902</td>\n",
" <td>Developing regions</td>\n",
" <td>1</td>\n",
" <td>...</td>\n",
" <td>124</td>\n",
" <td>161</td>\n",
" <td>140</td>\n",
" <td>122</td>\n",
" <td>133</td>\n",
" <td>128</td>\n",
" <td>211</td>\n",
" <td>160</td>\n",
" <td>174</td>\n",
" <td>217</td>\n",
" </tr>\n",
" <tr>\n",
" <th>193</th>\n",
" <td>Immigrants</td>\n",
" <td>Foreigners</td>\n",
" <td>Zambia</td>\n",
" <td>903</td>\n",
" <td>Africa</td>\n",
" <td>910</td>\n",
" <td>Eastern Africa</td>\n",
" <td>902</td>\n",
" <td>Developing regions</td>\n",
" <td>11</td>\n",
" <td>...</td>\n",
" <td>56</td>\n",
" <td>91</td>\n",
" <td>77</td>\n",
" <td>71</td>\n",
" <td>64</td>\n",
" <td>60</td>\n",
" <td>102</td>\n",
" <td>69</td>\n",
" <td>46</td>\n",
" <td>59</td>\n",
" </tr>\n",
" <tr>\n",
" <th>194</th>\n",
" <td>Immigrants</td>\n",
" <td>Foreigners</td>\n",
" <td>Zimbabwe</td>\n",
" <td>903</td>\n",
" <td>Africa</td>\n",
" <td>910</td>\n",
" <td>Eastern Africa</td>\n",
" <td>902</td>\n",
" <td>Developing regions</td>\n",
" <td>72</td>\n",
" <td>...</td>\n",
" <td>1450</td>\n",
" <td>615</td>\n",
" <td>454</td>\n",
" <td>663</td>\n",
" <td>611</td>\n",
" <td>508</td>\n",
" <td>494</td>\n",
" <td>434</td>\n",
" <td>437</td>\n",
" <td>407</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",
"190 Immigrants Foreigners Viet Nam 935 Asia 920 \n",
"191 Immigrants Foreigners Western Sahara 903 Africa 912 \n",
"192 Immigrants Foreigners Yemen 935 Asia 922 \n",
"193 Immigrants Foreigners Zambia 903 Africa 910 \n",
"194 Immigrants Foreigners Zimbabwe 903 Africa 910 \n",
"\n",
" RegName DEV DevName 1980 ... 2004 2005 2006 \\\n",
"190 South-Eastern Asia 902 Developing regions 1191 ... 1816 1852 3153 \n",
"191 Northern Africa 902 Developing regions 0 ... 0 0 1 \n",
"192 Western Asia 902 Developing regions 1 ... 124 161 140 \n",
"193 Eastern Africa 902 Developing regions 11 ... 56 91 77 \n",
"194 Eastern Africa 902 Developing regions 72 ... 1450 615 454 \n",
"\n",
" 2007 2008 2009 2010 2011 2012 2013 \n",
"190 2574 1784 2171 1942 1723 1731 2112 \n",
"191 0 0 0 0 0 0 0 \n",
"192 122 133 128 211 160 174 217 \n",
"193 71 64 60 102 69 46 59 \n",
"194 663 611 508 494 434 437 407 \n",
"\n",
"[5 rows x 43 columns]"
]
},
"execution_count": 67,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_can.tail()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"When analyzing a dataset, it's always a good idea to start by getting basic information about your dataframe. We can do this by using the `info()` method."
]
},
{
"cell_type": "code",
"execution_count": 68,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"<class 'pandas.core.frame.DataFrame'>\n",
"RangeIndex: 195 entries, 0 to 194\n",
"Data columns (total 43 columns):\n",
"Type 195 non-null object\n",
"Coverage 195 non-null object\n",
"OdName 195 non-null object\n",
"AREA 195 non-null int64\n",
"AreaName 195 non-null object\n",
"REG 195 non-null int64\n",
"RegName 195 non-null object\n",
"DEV 195 non-null int64\n",
"DevName 195 non-null object\n",
"1980 195 non-null int64\n",
"1981 195 non-null int64\n",
"1982 195 non-null int64\n",
"1983 195 non-null int64\n",
"1984 195 non-null int64\n",
"1985 195 non-null int64\n",
"1986 195 non-null int64\n",
"1987 195 non-null int64\n",
"1988 195 non-null int64\n",
"1989 195 non-null int64\n",
"1990 195 non-null int64\n",
"1991 195 non-null int64\n",
"1992 195 non-null int64\n",
"1993 195 non-null int64\n",
"1994 195 non-null int64\n",
"1995 195 non-null int64\n",
"1996 195 non-null int64\n",
"1997 195 non-null int64\n",
"1998 195 non-null int64\n",
"1999 195 non-null int64\n",
"2000 195 non-null int64\n",
"2001 195 non-null int64\n",
"2002 195 non-null int64\n",
"2003 195 non-null int64\n",
"2004 195 non-null int64\n",
"2005 195 non-null int64\n",
"2006 195 non-null int64\n",
"2007 195 non-null int64\n",
"2008 195 non-null int64\n",
"2009 195 non-null int64\n",
"2010 195 non-null int64\n",
"2011 195 non-null int64\n",
"2012 195 non-null int64\n",
"2013 195 non-null int64\n",
"dtypes: int64(37), object(6)\n",
"memory usage: 65.6+ KB\n"
]
}
],
"source": [
"df_can.info()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"To get the list of column headers we can call upon the dataframe's `.columns` parameter."
]
},
{
"cell_type": "code",
"execution_count": 69,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/plain": [
"array(['Type', 'Coverage', 'OdName', 'AREA', 'AreaName', 'REG', 'RegName',\n",
" 'DEV', 'DevName', 1980, 1981, 1982, 1983, 1984, 1985, 1986, 1987,\n",
" 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998,\n",
" 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,\n",
" 2010, 2011, 2012, 2013], dtype=object)"
]
},
"execution_count": 69,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_can.columns.values "
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Similarly, to get the list of indicies we use the `.index` parameter."
]
},
{
"cell_type": "code",
"execution_count": 70,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"data": {
"text/plain": [
"array([ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12,\n",
" 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25,\n",
" 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38,\n",
" 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51,\n",
" 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64,\n",
" 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77,\n",
" 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90,\n",
" 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103,\n",
" 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116,\n",
" 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129,\n",
" 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142,\n",
" 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155,\n",
" 156, 157, 158, 159, 160, 161, 162, 163, 164, 165, 166, 167, 168,\n",
" 169, 170, 171, 172, 173, 174, 175, 176, 177, 178, 179, 180, 181,\n",
" 182, 183, 184, 185, 186, 187, 188, 189, 190, 191, 192, 193, 194])"
]
},
"execution_count": 70,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_can.index.values"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Note: The default type of index and columns is NOT list."
]
},
{
"cell_type": "code",
"execution_count": 71,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"<class 'pandas.core.indexes.base.Index'>\n",
"<class 'pandas.core.indexes.range.RangeIndex'>\n"
]
}
],
"source": [
"print(type(df_can.columns))\n",
"print(type(df_can.index))"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"To get the index and columns as lists, we can use the `tolist()` method."
]
},
{
"cell_type": "code",
"execution_count": 72,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"<class 'list'>\n",
"<class 'list'>\n"
]
}
],
"source": [
"df_can.columns.tolist()\n",
"df_can.index.tolist()\n",
"\n",
"print (type(df_can.columns.tolist()))\n",
"print (type(df_can.index.tolist()))"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"To view the dimensions of the dataframe, we use the `.shape` parameter."
]
},
{
"cell_type": "code",
"execution_count": 73,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/plain": [
"(195, 43)"
]
},
"execution_count": 73,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# size of dataframe (rows, columns)\n",
"df_can.shape "
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Note: The main types stored in *pandas* objects are *float*, *int*, *bool*, *datetime64[ns]* and *datetime64[ns, tz] (in >= 0.17.0)*, *timedelta[ns]*, *category (in >= 0.15.0)*, and *object* (string). In addition these dtypes have item sizes, e.g. int64 and int32. "
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Let's clean the data set to remove a few unnecessary columns. We can use *pandas* `drop()` method as follows:"
]
},
{
"cell_type": "code",
"execution_count": 74,
"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></th>\n",
" <th>OdName</th>\n",
" <th>AreaName</th>\n",
" <th>RegName</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>...</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>Afghanistan</td>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>16</td>\n",
" <td>39</td>\n",
" <td>39</td>\n",
" <td>47</td>\n",
" <td>71</td>\n",
" <td>340</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>Albania</td>\n",
" <td>Europe</td>\n",
" <td>Southern Europe</td>\n",
" <td>Developed regions</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>...</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",
" </tbody>\n",
"</table>\n",
"<p>2 rows × 38 columns</p>\n",
"</div>"
],
"text/plain": [
" OdName AreaName RegName DevName 1980 1981 \\\n",
"0 Afghanistan Asia Southern Asia Developing regions 16 39 \n",
"1 Albania Europe Southern Europe Developed regions 1 0 \n",
"\n",
" 1982 1983 1984 1985 ... 2004 2005 2006 2007 2008 2009 2010 \\\n",
"0 39 47 71 340 ... 2978 3436 3009 2652 2111 1746 1758 \n",
"1 0 0 0 0 ... 1450 1223 856 702 560 716 561 \n",
"\n",
" 2011 2012 2013 \n",
"0 2203 2635 2004 \n",
"1 539 620 603 \n",
"\n",
"[2 rows x 38 columns]"
]
},
"execution_count": 74,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# in pandas axis=0 represents rows (default) and axis=1 represents columns.\n",
"df_can.drop(['AREA','REG','DEV','Type','Coverage'], axis=1, inplace=True)\n",
"df_can.head(2)"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Let's rename the columns so that they make sense. We can use `rename()` method by passing in a dictionary of old and new names as follows:"
]
},
{
"cell_type": "code",
"execution_count": 75,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/plain": [
"Index([ 'Country', 'Continent', 'Region', 'DevName', 1980,\n",
" 1981, 1982, 1983, 1984, 1985,\n",
" 1986, 1987, 1988, 1989, 1990,\n",
" 1991, 1992, 1993, 1994, 1995,\n",
" 1996, 1997, 1998, 1999, 2000,\n",
" 2001, 2002, 2003, 2004, 2005,\n",
" 2006, 2007, 2008, 2009, 2010,\n",
" 2011, 2012, 2013],\n",
" dtype='object')"
]
},
"execution_count": 75,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_can.rename(columns={'OdName':'Country', 'AreaName':'Continent', 'RegName':'Region'}, inplace=True)\n",
"df_can.columns"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"We will also add a 'Total' column that sums up the total immigrants by country over the entire period 1980 - 2013, as follows:"
]
},
{
"cell_type": "code",
"execution_count": 76,
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [],
"source": [
"df_can['Total'] = df_can.sum(axis=1)"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"We can check to see how many null objects we have in the dataset as follows:"
]
},
{
"cell_type": "code",
"execution_count": 77,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"data": {
"text/plain": [
"Country 0\n",
"Continent 0\n",
"Region 0\n",
"DevName 0\n",
"1980 0\n",
"1981 0\n",
"1982 0\n",
"1983 0\n",
"1984 0\n",
"1985 0\n",
"1986 0\n",
"1987 0\n",
"1988 0\n",
"1989 0\n",
"1990 0\n",
"1991 0\n",
"1992 0\n",
"1993 0\n",
"1994 0\n",
"1995 0\n",
"1996 0\n",
"1997 0\n",
"1998 0\n",
"1999 0\n",
"2000 0\n",
"2001 0\n",
"2002 0\n",
"2003 0\n",
"2004 0\n",
"2005 0\n",
"2006 0\n",
"2007 0\n",
"2008 0\n",
"2009 0\n",
"2010 0\n",
"2011 0\n",
"2012 0\n",
"2013 0\n",
"Total 0\n",
"dtype: int64"
]
},
"execution_count": 77,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_can.isnull().sum()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Finally, let's view a quick summary of each column in our dataframe using the `describe()` method."
]
},
{
"cell_type": "code",
"execution_count": 78,
"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></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",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>count</th>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>...</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" <td>195.000000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>mean</th>\n",
" <td>508.394872</td>\n",
" <td>566.989744</td>\n",
" <td>534.723077</td>\n",
" <td>387.435897</td>\n",
" <td>376.497436</td>\n",
" <td>358.861538</td>\n",
" <td>441.271795</td>\n",
" <td>691.133333</td>\n",
" <td>714.389744</td>\n",
" <td>843.241026</td>\n",
" <td>...</td>\n",
" <td>1320.292308</td>\n",
" <td>1266.958974</td>\n",
" <td>1191.820513</td>\n",
" <td>1246.394872</td>\n",
" <td>1275.733333</td>\n",
" <td>1420.287179</td>\n",
" <td>1262.533333</td>\n",
" <td>1313.958974</td>\n",
" <td>1320.702564</td>\n",
" <td>32867.451282</td>\n",
" </tr>\n",
" <tr>\n",
" <th>std</th>\n",
" <td>1949.588546</td>\n",
" <td>2152.643752</td>\n",
" <td>1866.997511</td>\n",
" <td>1204.333597</td>\n",
" <td>1198.246371</td>\n",
" <td>1079.309600</td>\n",
" <td>1225.576630</td>\n",
" <td>2109.205607</td>\n",
" <td>2443.606788</td>\n",
" <td>2555.048874</td>\n",
" <td>...</td>\n",
" <td>4425.957828</td>\n",
" <td>3926.717747</td>\n",
" <td>3443.542409</td>\n",
" <td>3694.573544</td>\n",
" <td>3829.630424</td>\n",
" <td>4462.946328</td>\n",
" <td>4030.084313</td>\n",
" <td>4247.555161</td>\n",
" <td>4237.951988</td>\n",
" <td>91785.498686</td>\n",
" </tr>\n",
" <tr>\n",
" <th>min</th>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>...</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>1.000000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>25%</th>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.000000</td>\n",
" <td>0.500000</td>\n",
" <td>0.500000</td>\n",
" <td>1.000000</td>\n",
" <td>1.000000</td>\n",
" <td>...</td>\n",
" <td>28.500000</td>\n",
" <td>25.000000</td>\n",
" <td>31.000000</td>\n",
" <td>31.000000</td>\n",
" <td>36.000000</td>\n",
" <td>40.500000</td>\n",
" <td>37.500000</td>\n",
" <td>42.500000</td>\n",
" <td>45.000000</td>\n",
" <td>952.000000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>50%</th>\n",
" <td>13.000000</td>\n",
" <td>10.000000</td>\n",
" <td>11.000000</td>\n",
" <td>12.000000</td>\n",
" <td>13.000000</td>\n",
" <td>17.000000</td>\n",
" <td>18.000000</td>\n",
" <td>26.000000</td>\n",
" <td>34.000000</td>\n",
" <td>44.000000</td>\n",
" <td>...</td>\n",
" <td>210.000000</td>\n",
" <td>218.000000</td>\n",
" <td>198.000000</td>\n",
" <td>205.000000</td>\n",
" <td>214.000000</td>\n",
" <td>211.000000</td>\n",
" <td>179.000000</td>\n",
" <td>233.000000</td>\n",
" <td>213.000000</td>\n",
" <td>5018.000000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>75%</th>\n",
" <td>251.500000</td>\n",
" <td>295.500000</td>\n",
" <td>275.000000</td>\n",
" <td>173.000000</td>\n",
" <td>181.000000</td>\n",
" <td>197.000000</td>\n",
" <td>254.000000</td>\n",
" <td>434.000000</td>\n",
" <td>409.000000</td>\n",
" <td>508.500000</td>\n",
" <td>...</td>\n",
" <td>832.000000</td>\n",
" <td>842.000000</td>\n",
" <td>899.000000</td>\n",
" <td>934.500000</td>\n",
" <td>888.000000</td>\n",
" <td>932.000000</td>\n",
" <td>772.000000</td>\n",
" <td>783.000000</td>\n",
" <td>796.000000</td>\n",
" <td>22239.500000</td>\n",
" </tr>\n",
" <tr>\n",
" <th>max</th>\n",
" <td>22045.000000</td>\n",
" <td>24796.000000</td>\n",
" <td>20620.000000</td>\n",
" <td>10015.000000</td>\n",
" <td>10170.000000</td>\n",
" <td>9564.000000</td>\n",
" <td>9470.000000</td>\n",
" <td>21337.000000</td>\n",
" <td>27359.000000</td>\n",
" <td>23795.000000</td>\n",
" <td>...</td>\n",
" <td>42584.000000</td>\n",
" <td>33848.000000</td>\n",
" <td>28742.000000</td>\n",
" <td>30037.000000</td>\n",
" <td>29622.000000</td>\n",
" <td>38617.000000</td>\n",
" <td>36765.000000</td>\n",
" <td>34315.000000</td>\n",
" <td>34129.000000</td>\n",
" <td>691904.000000</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"<p>8 rows × 35 columns</p>\n",
"</div>"
],
"text/plain": [
" 1980 1981 1982 1983 1984 \\\n",
"count 195.000000 195.000000 195.000000 195.000000 195.000000 \n",
"mean 508.394872 566.989744 534.723077 387.435897 376.497436 \n",
"std 1949.588546 2152.643752 1866.997511 1204.333597 1198.246371 \n",
"min 0.000000 0.000000 0.000000 0.000000 0.000000 \n",
"25% 0.000000 0.000000 0.000000 0.000000 0.000000 \n",
"50% 13.000000 10.000000 11.000000 12.000000 13.000000 \n",
"75% 251.500000 295.500000 275.000000 173.000000 181.000000 \n",
"max 22045.000000 24796.000000 20620.000000 10015.000000 10170.000000 \n",
"\n",
" 1985 1986 1987 1988 1989 \\\n",
"count 195.000000 195.000000 195.000000 195.000000 195.000000 \n",
"mean 358.861538 441.271795 691.133333 714.389744 843.241026 \n",
"std 1079.309600 1225.576630 2109.205607 2443.606788 2555.048874 \n",
"min 0.000000 0.000000 0.000000 0.000000 0.000000 \n",
"25% 0.000000 0.500000 0.500000 1.000000 1.000000 \n",
"50% 17.000000 18.000000 26.000000 34.000000 44.000000 \n",
"75% 197.000000 254.000000 434.000000 409.000000 508.500000 \n",
"max 9564.000000 9470.000000 21337.000000 27359.000000 23795.000000 \n",
"\n",
" ... 2005 2006 2007 2008 \\\n",
"count ... 195.000000 195.000000 195.000000 195.000000 \n",
"mean ... 1320.292308 1266.958974 1191.820513 1246.394872 \n",
"std ... 4425.957828 3926.717747 3443.542409 3694.573544 \n",
"min ... 0.000000 0.000000 0.000000 0.000000 \n",
"25% ... 28.500000 25.000000 31.000000 31.000000 \n",
"50% ... 210.000000 218.000000 198.000000 205.000000 \n",
"75% ... 832.000000 842.000000 899.000000 934.500000 \n",
"max ... 42584.000000 33848.000000 28742.000000 30037.000000 \n",
"\n",
" 2009 2010 2011 2012 2013 \\\n",
"count 195.000000 195.000000 195.000000 195.000000 195.000000 \n",
"mean 1275.733333 1420.287179 1262.533333 1313.958974 1320.702564 \n",
"std 3829.630424 4462.946328 4030.084313 4247.555161 4237.951988 \n",
"min 0.000000 0.000000 0.000000 0.000000 0.000000 \n",
"25% 36.000000 40.500000 37.500000 42.500000 45.000000 \n",
"50% 214.000000 211.000000 179.000000 233.000000 213.000000 \n",
"75% 888.000000 932.000000 772.000000 783.000000 796.000000 \n",
"max 29622.000000 38617.000000 36765.000000 34315.000000 34129.000000 \n",
"\n",
" Total \n",
"count 195.000000 \n",
"mean 32867.451282 \n",
"std 91785.498686 \n",
"min 1.000000 \n",
"25% 952.000000 \n",
"50% 5018.000000 \n",
"75% 22239.500000 \n",
"max 691904.000000 \n",
"\n",
"[8 rows x 35 columns]"
]
},
"execution_count": 78,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_can.describe()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"---\n",
"## *pandas* Intermediate: Indexing and Selection (slicing)<a id=\"6\"></a>\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"### Select Column\n",
"**There are two ways to filter on a column name:**\n",
"\n",
"Method 1: Quick and easy, but only works if the column name does NOT have spaces or special characters.\n",
"```python\n",
" df.column_name \n",
" (returns series)\n",
"```\n",
"\n",
"Method 2: More robust, and can filter on multiple columns.\n",
"\n",
"```python\n",
" df['column'] \n",
" (returns series)\n",
"```\n",
"\n",
"```python \n",
" df[['column 1', 'column 2']] \n",
" (returns dataframe)\n",
"```\n",
"---"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Example: Let's try filtering on the list of countries ('Country')."
]
},
{
"cell_type": "code",
"execution_count": 79,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"data": {
"text/plain": [
"0 Afghanistan\n",
"1 Albania\n",
"2 Algeria\n",
"3 American Samoa\n",
"4 Andorra\n",
" ... \n",
"190 Viet Nam\n",
"191 Western Sahara\n",
"192 Yemen\n",
"193 Zambia\n",
"194 Zimbabwe\n",
"Name: Country, Length: 195, dtype: object"
]
},
"execution_count": 79,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_can.Country # returns a series"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Let's try filtering on the list of countries ('OdName') and the data for years: 1980 - 1985."
]
},
{
"cell_type": "code",
"execution_count": 80,
"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></th>\n",
" <th>Country</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",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>0</th>\n",
" <td>Afghanistan</td>\n",
" <td>16</td>\n",
" <td>39</td>\n",
" <td>39</td>\n",
" <td>47</td>\n",
" <td>71</td>\n",
" <td>340</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1</th>\n",
" <td>Albania</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",
" </tr>\n",
" <tr>\n",
" <th>2</th>\n",
" <td>Algeria</td>\n",
" <td>80</td>\n",
" <td>67</td>\n",
" <td>71</td>\n",
" <td>69</td>\n",
" <td>63</td>\n",
" <td>44</td>\n",
" </tr>\n",
" <tr>\n",
" <th>3</th>\n",
" <td>American Samoa</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",
" </tr>\n",
" <tr>\n",
" <th>4</th>\n",
" <td>Andorra</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>5</th>\n",
" <td>Angola</td>\n",
" <td>1</td>\n",
" <td>3</td>\n",
" <td>6</td>\n",
" <td>6</td>\n",
" <td>4</td>\n",
" <td>3</td>\n",
" </tr>\n",
" <tr>\n",
" <th>6</th>\n",
" <td>Antigua and Barbuda</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>42</td>\n",
" <td>52</td>\n",
" </tr>\n",
" <tr>\n",
" <th>7</th>\n",
" <td>Argentina</td>\n",
" <td>368</td>\n",
" <td>426</td>\n",
" <td>626</td>\n",
" <td>241</td>\n",
" <td>237</td>\n",
" <td>196</td>\n",
" </tr>\n",
" <tr>\n",
" <th>8</th>\n",
" <td>Armenia</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>9</th>\n",
" <td>Australia</td>\n",
" <td>702</td>\n",
" <td>639</td>\n",
" <td>484</td>\n",
" <td>317</td>\n",
" <td>317</td>\n",
" <td>319</td>\n",
" </tr>\n",
" <tr>\n",
" <th>10</th>\n",
" <td>Austria</td>\n",
" <td>234</td>\n",
" <td>238</td>\n",
" <td>201</td>\n",
" <td>117</td>\n",
" <td>127</td>\n",
" <td>165</td>\n",
" </tr>\n",
" <tr>\n",
" <th>11</th>\n",
" <td>Azerbaijan</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>12</th>\n",
" <td>Bahamas</td>\n",
" <td>26</td>\n",
" <td>23</td>\n",
" <td>38</td>\n",
" <td>12</td>\n",
" <td>21</td>\n",
" <td>28</td>\n",
" </tr>\n",
" <tr>\n",
" <th>13</th>\n",
" <td>Bahrain</td>\n",
" <td>0</td>\n",
" <td>2</td>\n",
" <td>1</td>\n",
" <td>1</td>\n",
" <td>1</td>\n",
" <td>3</td>\n",
" </tr>\n",
" <tr>\n",
" <th>14</th>\n",
" <td>Bangladesh</td>\n",
" <td>83</td>\n",
" <td>84</td>\n",
" <td>86</td>\n",
" <td>81</td>\n",
" <td>98</td>\n",
" <td>92</td>\n",
" </tr>\n",
" <tr>\n",
" <th>15</th>\n",
" <td>Barbados</td>\n",
" <td>372</td>\n",
" <td>376</td>\n",
" <td>299</td>\n",
" <td>244</td>\n",
" <td>265</td>\n",
" <td>285</td>\n",
" </tr>\n",
" <tr>\n",
" <th>16</th>\n",
" <td>Belarus</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>17</th>\n",
" <td>Belgium</td>\n",
" <td>511</td>\n",
" <td>540</td>\n",
" <td>519</td>\n",
" <td>297</td>\n",
" <td>183</td>\n",
" <td>181</td>\n",
" </tr>\n",
" <tr>\n",
" <th>18</th>\n",
" <td>Belize</td>\n",
" <td>16</td>\n",
" <td>27</td>\n",
" <td>13</td>\n",
" <td>21</td>\n",
" <td>37</td>\n",
" <td>26</td>\n",
" </tr>\n",
" <tr>\n",
" <th>19</th>\n",
" <td>Benin</td>\n",
" <td>2</td>\n",
" <td>5</td>\n",
" <td>4</td>\n",
" <td>3</td>\n",
" <td>4</td>\n",
" <td>3</td>\n",
" </tr>\n",
" <tr>\n",
" <th>20</th>\n",
" <td>Bhutan</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>1</td>\n",
" <td>0</td>\n",
" </tr>\n",
" <tr>\n",
" <th>21</th>\n",
" <td>Bolivia (Plurinational State of)</td>\n",
" <td>44</td>\n",
" <td>52</td>\n",
" <td>42</td>\n",
" <td>49</td>\n",
" <td>38</td>\n",
" <td>44</td>\n",
" </tr>\n",
" <tr>\n",
" <th>22</th>\n",
" <td>Bosnia and Herzegovina</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>23</th>\n",
" <td>Botswana</td>\n",
" <td>10</td>\n",
" <td>1</td>\n",
" <td>3</td>\n",
" <td>3</td>\n",
" <td>7</td>\n",
" <td>4</td>\n",
" </tr>\n",
" <tr>\n",
" <th>24</th>\n",
" <td>Brazil</td>\n",
" <td>211</td>\n",
" <td>220</td>\n",
" <td>192</td>\n",
" <td>139</td>\n",
" <td>145</td>\n",
" <td>130</td>\n",
" </tr>\n",
" <tr>\n",
" <th>25</th>\n",
" <td>Brunei Darussalam</td>\n",
" <td>79</td>\n",
" <td>6</td>\n",
" <td>8</td>\n",
" <td>2</td>\n",
" <td>2</td>\n",
" <td>4</td>\n",
" </tr>\n",
" <tr>\n",
" <th>26</th>\n",
" <td>Bulgaria</td>\n",
" <td>24</td>\n",
" <td>20</td>\n",
" <td>12</td>\n",
" <td>33</td>\n",
" <td>11</td>\n",
" <td>24</td>\n",
" </tr>\n",
" <tr>\n",
" <th>27</th>\n",
" <td>Burkina Faso</td>\n",
" <td>2</td>\n",
" <td>1</td>\n",
" <td>3</td>\n",
" <td>2</td>\n",
" <td>3</td>\n",
" <td>2</td>\n",
" </tr>\n",
" <tr>\n",
" <th>28</th>\n",
" <td>Burundi</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>1</td>\n",
" <td>2</td>\n",
" </tr>\n",
" <tr>\n",
" <th>29</th>\n",
" <td>Cabo Verde</td>\n",
" <td>1</td>\n",
" <td>1</td>\n",
" <td>2</td>\n",
" <td>0</td>\n",
" <td>11</td>\n",
" <td>1</td>\n",
" </tr>\n",
" <tr>\n",
" <th>...</th>\n",
" <td>...</td>\n",
" <td>...</td>\n",
" <td>...</td>\n",
" <td>...</td>\n",
" <td>...</td>\n",
" <td>...</td>\n",
" <td>...</td>\n",
" </tr>\n",
" <tr>\n",
" <th>165</th>\n",
" <td>Suriname</td>\n",
" <td>15</td>\n",
" <td>10</td>\n",
" <td>21</td>\n",
" <td>12</td>\n",
" <td>5</td>\n",
" <td>16</td>\n",
" </tr>\n",
" <tr>\n",
" <th>166</th>\n",
" <td>Swaziland</td>\n",
" <td>4</td>\n",
" <td>1</td>\n",
" <td>1</td>\n",
" <td>0</td>\n",
" <td>10</td>\n",
" <td>7</td>\n",
" </tr>\n",
" <tr>\n",
" <th>167</th>\n",
" <td>Sweden</td>\n",
" <td>281</td>\n",
" <td>308</td>\n",
" <td>222</td>\n",
" <td>176</td>\n",
" <td>128</td>\n",
" <td>158</td>\n",
" </tr>\n",
" <tr>\n",
" <th>168</th>\n",
" <td>Switzerland</td>\n",
" <td>806</td>\n",
" <td>811</td>\n",
" <td>634</td>\n",
" <td>370</td>\n",
" <td>326</td>\n",
" <td>314</td>\n",
" </tr>\n",
" <tr>\n",
" <th>169</th>\n",
" <td>Syrian Arab Republic</td>\n",
" <td>315</td>\n",
" <td>419</td>\n",
" <td>409</td>\n",
" <td>269</td>\n",
" <td>264</td>\n",
" <td>385</td>\n",
" </tr>\n",
" <tr>\n",
" <th>170</th>\n",
" <td>Tajikistan</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>171</th>\n",
" <td>Thailand</td>\n",
" <td>56</td>\n",
" <td>53</td>\n",
" <td>113</td>\n",
" <td>65</td>\n",
" <td>82</td>\n",
" <td>66</td>\n",
" </tr>\n",
" <tr>\n",
" <th>172</th>\n",
" <td>The former Yugoslav Republic of Macedonia</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>173</th>\n",
" <td>Togo</td>\n",
" <td>5</td>\n",
" <td>5</td>\n",
" <td>2</td>\n",
" <td>3</td>\n",
" <td>6</td>\n",
" <td>5</td>\n",
" </tr>\n",
" <tr>\n",
" <th>174</th>\n",
" <td>Tonga</td>\n",
" <td>2</td>\n",
" <td>4</td>\n",
" <td>7</td>\n",
" <td>1</td>\n",
" <td>2</td>\n",
" <td>5</td>\n",
" </tr>\n",
" <tr>\n",
" <th>175</th>\n",
" <td>Trinidad and Tobago</td>\n",
" <td>958</td>\n",
" <td>947</td>\n",
" <td>972</td>\n",
" <td>766</td>\n",
" <td>606</td>\n",
" <td>699</td>\n",
" </tr>\n",
" <tr>\n",
" <th>176</th>\n",
" <td>Tunisia</td>\n",
" <td>58</td>\n",
" <td>51</td>\n",
" <td>55</td>\n",
" <td>46</td>\n",
" <td>51</td>\n",
" <td>57</td>\n",
" </tr>\n",
" <tr>\n",
" <th>177</th>\n",
" <td>Turkey</td>\n",
" <td>481</td>\n",
" <td>874</td>\n",
" <td>706</td>\n",
" <td>280</td>\n",
" <td>338</td>\n",
" <td>202</td>\n",
" </tr>\n",
" <tr>\n",
" <th>178</th>\n",
" <td>Turkmenistan</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>179</th>\n",
" <td>Tuvalu</td>\n",
" <td>0</td>\n",
" <td>1</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>1</td>\n",
" <td>0</td>\n",
" </tr>\n",
" <tr>\n",
" <th>180</th>\n",
" <td>Uganda</td>\n",
" <td>13</td>\n",
" <td>16</td>\n",
" <td>17</td>\n",
" <td>38</td>\n",
" <td>32</td>\n",
" <td>29</td>\n",
" </tr>\n",
" <tr>\n",
" <th>181</th>\n",
" <td>Ukraine</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>182</th>\n",
" <td>United Arab Emirates</td>\n",
" <td>0</td>\n",
" <td>2</td>\n",
" <td>2</td>\n",
" <td>1</td>\n",
" <td>2</td>\n",
" <td>0</td>\n",
" </tr>\n",
" <tr>\n",
" <th>183</th>\n",
" <td>United Kingdom of Great Britain and Northern I...</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",
" </tr>\n",
" <tr>\n",
" <th>184</th>\n",
" <td>United Republic of Tanzania</td>\n",
" <td>635</td>\n",
" <td>832</td>\n",
" <td>621</td>\n",
" <td>474</td>\n",
" <td>473</td>\n",
" <td>460</td>\n",
" </tr>\n",
" <tr>\n",
" <th>185</th>\n",
" <td>United States of America</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",
" </tr>\n",
" <tr>\n",
" <th>186</th>\n",
" <td>Uruguay</td>\n",
" <td>128</td>\n",
" <td>132</td>\n",
" <td>146</td>\n",
" <td>105</td>\n",
" <td>90</td>\n",
" <td>92</td>\n",
" </tr>\n",
" <tr>\n",
" <th>187</th>\n",
" <td>Uzbekistan</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>188</th>\n",
" <td>Vanuatu</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>189</th>\n",
" <td>Venezuela (Bolivarian Republic of)</td>\n",
" <td>103</td>\n",
" <td>117</td>\n",
" <td>174</td>\n",
" <td>124</td>\n",
" <td>142</td>\n",
" <td>165</td>\n",
" </tr>\n",
" <tr>\n",
" <th>190</th>\n",
" <td>Viet Nam</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",
" </tr>\n",
" <tr>\n",
" <th>191</th>\n",
" <td>Western Sahara</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>192</th>\n",
" <td>Yemen</td>\n",
" <td>1</td>\n",
" <td>2</td>\n",
" <td>1</td>\n",
" <td>6</td>\n",
" <td>0</td>\n",
" <td>18</td>\n",
" </tr>\n",
" <tr>\n",
" <th>193</th>\n",
" <td>Zambia</td>\n",
" <td>11</td>\n",
" <td>17</td>\n",
" <td>11</td>\n",
" <td>7</td>\n",
" <td>16</td>\n",
" <td>9</td>\n",
" </tr>\n",
" <tr>\n",
" <th>194</th>\n",
" <td>Zimbabwe</td>\n",
" <td>72</td>\n",
" <td>114</td>\n",
" <td>102</td>\n",
" <td>44</td>\n",
" <td>32</td>\n",
" <td>29</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"<p>195 rows × 7 columns</p>\n",
"</div>"
],
"text/plain": [
" Country 1980 1981 1982 1983 1984 1985\n",
"0 Afghanistan 16 39 39 47 71 340\n",
"1 Albania 1 0 0 0 0 0\n",
"2 Algeria 80 67 71 69 63 44\n",
"3 American Samoa 0 1 0 0 0 0\n",
"4 Andorra 0 0 0 0 0 0\n",
".. ... ... ... ... ... ... ...\n",
"190 Viet Nam 1191 1829 2162 3404 7583 5907\n",
"191 Western Sahara 0 0 0 0 0 0\n",
"192 Yemen 1 2 1 6 0 18\n",
"193 Zambia 11 17 11 7 16 9\n",
"194 Zimbabwe 72 114 102 44 32 29\n",
"\n",
"[195 rows x 7 columns]"
]
},
"execution_count": 80,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_can[['Country', 1980, 1981, 1982, 1983, 1984, 1985]] # returns a dataframe\n",
"# notice that 'Country' is string, and the years are integers. \n",
"# for the sake of consistency, we will convert all column names to string later on."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"### Select Row\n",
"\n",
"There are main 3 ways to select rows:\n",
"\n",
"```python\n",
" df.loc[label] \n",
" #filters by the labels of the index/column\n",
" df.iloc[index] \n",
" #filters by the positions of the index/column\n",
"```"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Before we proceed, notice that the defaul index of the dataset is a numeric range from 0 to 194. This makes it very difficult to do a query by a specific country. For example to search for data on Japan, we need to know the corressponding index value.\n",
"\n",
"This can be fixed very easily by setting the 'Country' column as the index using `set_index()` method."
]
},
{
"cell_type": "code",
"execution_count": 81,
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [],
"source": [
"df_can.set_index('Country', inplace=True)\n",
"# tip: The opposite of set is reset. So to reset the index, we can use df_can.reset_index()"
]
},
{
"cell_type": "code",
"execution_count": 82,
"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></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>Afghanistan</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>16</td>\n",
" <td>39</td>\n",
" <td>39</td>\n",
" <td>47</td>\n",
" <td>71</td>\n",
" <td>340</td>\n",
" <td>496</td>\n",
" <td>...</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",
" <td>58639</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Albania</th>\n",
" <td>Europe</td>\n",
" <td>Southern Europe</td>\n",
" <td>Developed regions</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>1</td>\n",
" <td>...</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",
" <td>15699</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Algeria</th>\n",
" <td>Africa</td>\n",
" <td>Northern Africa</td>\n",
" <td>Developing regions</td>\n",
" <td>80</td>\n",
" <td>67</td>\n",
" <td>71</td>\n",
" <td>69</td>\n",
" <td>63</td>\n",
" <td>44</td>\n",
" <td>69</td>\n",
" <td>...</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",
" <td>69439</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"<p>3 rows × 38 columns</p>\n",
"</div>"
],
"text/plain": [
" Continent Region DevName 1980 1981 1982 \\\n",
"Country \n",
"Afghanistan Asia Southern Asia Developing regions 16 39 39 \n",
"Albania Europe Southern Europe Developed regions 1 0 0 \n",
"Algeria Africa Northern Africa Developing regions 80 67 71 \n",
"\n",
" 1983 1984 1985 1986 ... 2005 2006 2007 2008 2009 2010 \\\n",
"Country ... \n",
"Afghanistan 47 71 340 496 ... 3436 3009 2652 2111 1746 1758 \n",
"Albania 0 0 0 1 ... 1223 856 702 560 716 561 \n",
"Algeria 69 63 44 69 ... 3626 4807 3623 4005 5393 4752 \n",
"\n",
" 2011 2012 2013 Total \n",
"Country \n",
"Afghanistan 2203 2635 2004 58639 \n",
"Albania 539 620 603 15699 \n",
"Algeria 4325 3774 4331 69439 \n",
"\n",
"[3 rows x 38 columns]"
]
},
"execution_count": 82,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_can.head(3)"
]
},
{
"cell_type": "code",
"execution_count": 83,
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [],
"source": [
"# optional: to remove the name of the index\n",
"df_can.index.name = None"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Example: Let's view the number of immigrants from Japan (row 87) for the following scenarios:\n",
" 1. The full row data (all columns)\n",
" 2. For year 2013\n",
" 3. For years 1980 to 1985"
]
},
{
"cell_type": "code",
"execution_count": 84,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Continent Asia\n",
"Region Eastern Asia\n",
"DevName Developed regions\n",
"1980 701\n",
"1981 756\n",
"1982 598\n",
"1983 309\n",
"1984 246\n",
"1985 198\n",
"1986 248\n",
"1987 422\n",
"1988 324\n",
"1989 494\n",
"1990 379\n",
"1991 506\n",
"1992 605\n",
"1993 907\n",
"1994 956\n",
"1995 826\n",
"1996 994\n",
"1997 924\n",
"1998 897\n",
"1999 1083\n",
"2000 1010\n",
"2001 1092\n",
"2002 806\n",
"2003 817\n",
"2004 973\n",
"2005 1067\n",
"2006 1212\n",
"2007 1250\n",
"2008 1284\n",
"2009 1194\n",
"2010 1168\n",
"2011 1265\n",
"2012 1214\n",
"2013 982\n",
"Total 27707\n",
"Name: Japan, dtype: object\n",
"Continent Asia\n",
"Region Eastern Asia\n",
"DevName Developed regions\n",
"1980 701\n",
"1981 756\n",
"1982 598\n",
"1983 309\n",
"1984 246\n",
"1985 198\n",
"1986 248\n",
"1987 422\n",
"1988 324\n",
"1989 494\n",
"1990 379\n",
"1991 506\n",
"1992 605\n",
"1993 907\n",
"1994 956\n",
"1995 826\n",
"1996 994\n",
"1997 924\n",
"1998 897\n",
"1999 1083\n",
"2000 1010\n",
"2001 1092\n",
"2002 806\n",
"2003 817\n",
"2004 973\n",
"2005 1067\n",
"2006 1212\n",
"2007 1250\n",
"2008 1284\n",
"2009 1194\n",
"2010 1168\n",
"2011 1265\n",
"2012 1214\n",
"2013 982\n",
"Total 27707\n",
"Name: Japan, dtype: object\n",
"Continent Asia\n",
"Region Eastern Asia\n",
"DevName Developed regions\n",
"1980 701\n",
"1981 756\n",
"1982 598\n",
"1983 309\n",
"1984 246\n",
"1985 198\n",
"1986 248\n",
"1987 422\n",
"1988 324\n",
"1989 494\n",
"1990 379\n",
"1991 506\n",
"1992 605\n",
"1993 907\n",
"1994 956\n",
"1995 826\n",
"1996 994\n",
"1997 924\n",
"1998 897\n",
"1999 1083\n",
"2000 1010\n",
"2001 1092\n",
"2002 806\n",
"2003 817\n",
"2004 973\n",
"2005 1067\n",
"2006 1212\n",
"2007 1250\n",
"2008 1284\n",
"2009 1194\n",
"2010 1168\n",
"2011 1265\n",
"2012 1214\n",
"2013 982\n",
"Total 27707\n",
"Name: Japan, dtype: object\n"
]
}
],
"source": [
"# 1. the full row data (all columns)\n",
"print(df_can.loc['Japan'])\n",
"\n",
"# alternate methods\n",
"print(df_can.iloc[87])\n",
"print(df_can[df_can.index == 'Japan'].T.squeeze())"
]
},
{
"cell_type": "code",
"execution_count": 85,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"982\n",
"982\n"
]
}
],
"source": [
"# 2. for year 2013\n",
"print(df_can.loc['Japan', 2013])\n",
"\n",
"# alternate method\n",
"print(df_can.iloc[87, 36]) # year 2013 is the last column, with a positional index of 36"
]
},
{
"cell_type": "code",
"execution_count": 86,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"1980 701\n",
"1981 756\n",
"1982 598\n",
"1983 309\n",
"1984 246\n",
"1984 246\n",
"Name: Japan, dtype: object\n",
"1980 701\n",
"1981 756\n",
"1982 598\n",
"1983 309\n",
"1984 246\n",
"1985 198\n",
"Name: Japan, dtype: object\n"
]
}
],
"source": [
"# 3. for years 1980 to 1985\n",
"print(df_can.loc['Japan', [1980, 1981, 1982, 1983, 1984, 1984]])\n",
"print(df_can.iloc[87, [3, 4, 5, 6, 7, 8]])"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Column names that are integers (such as the years) might introduce some confusion. For example, when we are referencing the year 2013, one might confuse that when the 2013th positional index. \n",
"\n",
"To avoid this ambuigity, let's convert the column names into strings: '1980' to '2013'."
]
},
{
"cell_type": "code",
"execution_count": 87,
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [],
"source": [
"df_can.columns = list(map(str, df_can.columns))\n",
"# [print (type(x)) for x in df_can.columns.values] #<-- uncomment to check type of column headers"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Since we converted the years to string, let's declare a variable that will allow us to easily call upon the full range of years:"
]
},
{
"cell_type": "code",
"execution_count": 88,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/plain": [
"['1980',\n",
" '1981',\n",
" '1982',\n",
" '1983',\n",
" '1984',\n",
" '1985',\n",
" '1986',\n",
" '1987',\n",
" '1988',\n",
" '1989',\n",
" '1990',\n",
" '1991',\n",
" '1992',\n",
" '1993',\n",
" '1994',\n",
" '1995',\n",
" '1996',\n",
" '1997',\n",
" '1998',\n",
" '1999',\n",
" '2000',\n",
" '2001',\n",
" '2002',\n",
" '2003',\n",
" '2004',\n",
" '2005',\n",
" '2006',\n",
" '2007',\n",
" '2008',\n",
" '2009',\n",
" '2010',\n",
" '2011',\n",
" '2012',\n",
" '2013']"
]
},
"execution_count": 88,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# useful for plotting later on\n",
"years = list(map(str, range(1980, 2014)))\n",
"years"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"### Filtering based on a criteria\n",
"To filter the dataframe based on a condition, we simply pass the condition as a boolean vector. \n",
"\n",
"For example, Let's filter the dataframe to show the data on Asian countries (AreaName = Asia)."
]
},
{
"cell_type": "code",
"execution_count": 89,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Afghanistan True\n",
"Albania False\n",
"Algeria False\n",
"American Samoa False\n",
"Andorra False\n",
" ... \n",
"Viet Nam True\n",
"Western Sahara False\n",
"Yemen True\n",
"Zambia False\n",
"Zimbabwe False\n",
"Name: Continent, Length: 195, dtype: bool\n"
]
}
],
"source": [
"# 1. create the condition boolean series\n",
"condition = df_can['Continent'] == 'Asia'\n",
"print(condition)"
]
},
{
"cell_type": "code",
"execution_count": 90,
"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></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",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>Afghanistan</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>16</td>\n",
" <td>39</td>\n",
" <td>39</td>\n",
" <td>47</td>\n",
" <td>71</td>\n",
" <td>340</td>\n",
" <td>496</td>\n",
" <td>...</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",
" <td>58639</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Armenia</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</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",
" <td>...</td>\n",
" <td>224</td>\n",
" <td>218</td>\n",
" <td>198</td>\n",
" <td>205</td>\n",
" <td>267</td>\n",
" <td>252</td>\n",
" <td>236</td>\n",
" <td>258</td>\n",
" <td>207</td>\n",
" <td>3310</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Azerbaijan</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</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",
" <td>...</td>\n",
" <td>359</td>\n",
" <td>236</td>\n",
" <td>203</td>\n",
" <td>125</td>\n",
" <td>165</td>\n",
" <td>209</td>\n",
" <td>138</td>\n",
" <td>161</td>\n",
" <td>57</td>\n",
" <td>2649</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Bahrain</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>0</td>\n",
" <td>2</td>\n",
" <td>1</td>\n",
" <td>1</td>\n",
" <td>1</td>\n",
" <td>3</td>\n",
" <td>0</td>\n",
" <td>...</td>\n",
" <td>12</td>\n",
" <td>12</td>\n",
" <td>22</td>\n",
" <td>9</td>\n",
" <td>35</td>\n",
" <td>28</td>\n",
" <td>21</td>\n",
" <td>39</td>\n",
" <td>32</td>\n",
" <td>475</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Bangladesh</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>83</td>\n",
" <td>84</td>\n",
" <td>86</td>\n",
" <td>81</td>\n",
" <td>98</td>\n",
" <td>92</td>\n",
" <td>486</td>\n",
" <td>...</td>\n",
" <td>4171</td>\n",
" <td>4014</td>\n",
" <td>2897</td>\n",
" <td>2939</td>\n",
" <td>2104</td>\n",
" <td>4721</td>\n",
" <td>2694</td>\n",
" <td>2640</td>\n",
" <td>3789</td>\n",
" <td>65568</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Bhutan</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>1</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>...</td>\n",
" <td>5</td>\n",
" <td>10</td>\n",
" <td>7</td>\n",
" <td>36</td>\n",
" <td>865</td>\n",
" <td>1464</td>\n",
" <td>1879</td>\n",
" <td>1075</td>\n",
" <td>487</td>\n",
" <td>5876</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Brunei Darussalam</th>\n",
" <td>Asia</td>\n",
" <td>South-Eastern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>79</td>\n",
" <td>6</td>\n",
" <td>8</td>\n",
" <td>2</td>\n",
" <td>2</td>\n",
" <td>4</td>\n",
" <td>12</td>\n",
" <td>...</td>\n",
" <td>4</td>\n",
" <td>5</td>\n",
" <td>11</td>\n",
" <td>10</td>\n",
" <td>5</td>\n",
" <td>12</td>\n",
" <td>6</td>\n",
" <td>3</td>\n",
" <td>6</td>\n",
" <td>600</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Cambodia</th>\n",
" <td>Asia</td>\n",
" <td>South-Eastern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>12</td>\n",
" <td>19</td>\n",
" <td>26</td>\n",
" <td>33</td>\n",
" <td>10</td>\n",
" <td>7</td>\n",
" <td>8</td>\n",
" <td>...</td>\n",
" <td>370</td>\n",
" <td>529</td>\n",
" <td>460</td>\n",
" <td>354</td>\n",
" <td>203</td>\n",
" <td>200</td>\n",
" <td>196</td>\n",
" <td>233</td>\n",
" <td>288</td>\n",
" <td>6538</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>China, Hong Kong Special Administrative Region</th>\n",
" <td>Asia</td>\n",
" <td>Eastern Asia</td>\n",
" <td>Developing regions</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",
" <td>...</td>\n",
" <td>729</td>\n",
" <td>712</td>\n",
" <td>674</td>\n",
" <td>897</td>\n",
" <td>657</td>\n",
" <td>623</td>\n",
" <td>591</td>\n",
" <td>728</td>\n",
" <td>774</td>\n",
" <td>9327</td>\n",
" </tr>\n",
" <tr>\n",
" <th>China, Macao Special Administrative Region</th>\n",
" <td>Asia</td>\n",
" <td>Eastern Asia</td>\n",
" <td>Developing regions</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",
" <td>...</td>\n",
" <td>21</td>\n",
" <td>32</td>\n",
" <td>16</td>\n",
" <td>12</td>\n",
" <td>21</td>\n",
" <td>21</td>\n",
" <td>13</td>\n",
" <td>33</td>\n",
" <td>29</td>\n",
" <td>284</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Cyprus</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>132</td>\n",
" <td>128</td>\n",
" <td>84</td>\n",
" <td>46</td>\n",
" <td>46</td>\n",
" <td>43</td>\n",
" <td>48</td>\n",
" <td>...</td>\n",
" <td>7</td>\n",
" <td>9</td>\n",
" <td>4</td>\n",
" <td>7</td>\n",
" <td>6</td>\n",
" <td>18</td>\n",
" <td>6</td>\n",
" <td>12</td>\n",
" <td>16</td>\n",
" <td>1126</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Democratic People's Republic of Korea</th>\n",
" <td>Asia</td>\n",
" <td>Eastern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>1</td>\n",
" <td>1</td>\n",
" <td>3</td>\n",
" <td>1</td>\n",
" <td>4</td>\n",
" <td>3</td>\n",
" <td>0</td>\n",
" <td>...</td>\n",
" <td>14</td>\n",
" <td>10</td>\n",
" <td>7</td>\n",
" <td>19</td>\n",
" <td>11</td>\n",
" <td>45</td>\n",
" <td>97</td>\n",
" <td>66</td>\n",
" <td>17</td>\n",
" <td>388</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Georgia</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</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",
" <td>...</td>\n",
" <td>114</td>\n",
" <td>125</td>\n",
" <td>132</td>\n",
" <td>112</td>\n",
" <td>128</td>\n",
" <td>126</td>\n",
" <td>139</td>\n",
" <td>147</td>\n",
" <td>125</td>\n",
" <td>2068</td>\n",
" </tr>\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>Indonesia</th>\n",
" <td>Asia</td>\n",
" <td>South-Eastern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>186</td>\n",
" <td>178</td>\n",
" <td>252</td>\n",
" <td>115</td>\n",
" <td>123</td>\n",
" <td>100</td>\n",
" <td>127</td>\n",
" <td>...</td>\n",
" <td>632</td>\n",
" <td>613</td>\n",
" <td>657</td>\n",
" <td>661</td>\n",
" <td>504</td>\n",
" <td>712</td>\n",
" <td>390</td>\n",
" <td>395</td>\n",
" <td>387</td>\n",
" <td>13150</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>Iraq</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>262</td>\n",
" <td>245</td>\n",
" <td>260</td>\n",
" <td>380</td>\n",
" <td>428</td>\n",
" <td>231</td>\n",
" <td>265</td>\n",
" <td>...</td>\n",
" <td>2226</td>\n",
" <td>1788</td>\n",
" <td>2406</td>\n",
" <td>3543</td>\n",
" <td>5450</td>\n",
" <td>5941</td>\n",
" <td>6196</td>\n",
" <td>4041</td>\n",
" <td>4918</td>\n",
" <td>69789</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Israel</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>1403</td>\n",
" <td>1711</td>\n",
" <td>1334</td>\n",
" <td>541</td>\n",
" <td>446</td>\n",
" <td>680</td>\n",
" <td>1212</td>\n",
" <td>...</td>\n",
" <td>2446</td>\n",
" <td>2625</td>\n",
" <td>2401</td>\n",
" <td>2562</td>\n",
" <td>2316</td>\n",
" <td>2755</td>\n",
" <td>1970</td>\n",
" <td>2134</td>\n",
" <td>1945</td>\n",
" <td>66508</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Japan</th>\n",
" <td>Asia</td>\n",
" <td>Eastern Asia</td>\n",
" <td>Developed regions</td>\n",
" <td>701</td>\n",
" <td>756</td>\n",
" <td>598</td>\n",
" <td>309</td>\n",
" <td>246</td>\n",
" <td>198</td>\n",
" <td>248</td>\n",
" <td>...</td>\n",
" <td>1067</td>\n",
" <td>1212</td>\n",
" <td>1250</td>\n",
" <td>1284</td>\n",
" <td>1194</td>\n",
" <td>1168</td>\n",
" <td>1265</td>\n",
" <td>1214</td>\n",
" <td>982</td>\n",
" <td>27707</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Jordan</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>177</td>\n",
" <td>160</td>\n",
" <td>155</td>\n",
" <td>113</td>\n",
" <td>102</td>\n",
" <td>179</td>\n",
" <td>181</td>\n",
" <td>...</td>\n",
" <td>1940</td>\n",
" <td>1827</td>\n",
" <td>1421</td>\n",
" <td>1581</td>\n",
" <td>1235</td>\n",
" <td>1831</td>\n",
" <td>1635</td>\n",
" <td>1206</td>\n",
" <td>1255</td>\n",
" <td>35406</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Kazakhstan</th>\n",
" <td>Asia</td>\n",
" <td>Central Asia</td>\n",
" <td>Developing regions</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",
" <td>...</td>\n",
" <td>506</td>\n",
" <td>408</td>\n",
" <td>436</td>\n",
" <td>394</td>\n",
" <td>431</td>\n",
" <td>377</td>\n",
" <td>381</td>\n",
" <td>462</td>\n",
" <td>348</td>\n",
" <td>8490</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Kuwait</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>1</td>\n",
" <td>0</td>\n",
" <td>8</td>\n",
" <td>2</td>\n",
" <td>1</td>\n",
" <td>4</td>\n",
" <td>4</td>\n",
" <td>...</td>\n",
" <td>66</td>\n",
" <td>35</td>\n",
" <td>62</td>\n",
" <td>53</td>\n",
" <td>68</td>\n",
" <td>67</td>\n",
" <td>58</td>\n",
" <td>73</td>\n",
" <td>48</td>\n",
" <td>2025</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Kyrgyzstan</th>\n",
" <td>Asia</td>\n",
" <td>Central Asia</td>\n",
" <td>Developing regions</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",
" <td>...</td>\n",
" <td>173</td>\n",
" <td>161</td>\n",
" <td>135</td>\n",
" <td>168</td>\n",
" <td>173</td>\n",
" <td>157</td>\n",
" <td>159</td>\n",
" <td>278</td>\n",
" <td>123</td>\n",
" <td>2353</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Lao People's Democratic Republic</th>\n",
" <td>Asia</td>\n",
" <td>South-Eastern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>11</td>\n",
" <td>6</td>\n",
" <td>16</td>\n",
" <td>16</td>\n",
" <td>7</td>\n",
" <td>17</td>\n",
" <td>21</td>\n",
" <td>...</td>\n",
" <td>42</td>\n",
" <td>74</td>\n",
" <td>53</td>\n",
" <td>32</td>\n",
" <td>39</td>\n",
" <td>54</td>\n",
" <td>22</td>\n",
" <td>25</td>\n",
" <td>15</td>\n",
" <td>1089</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>Malaysia</th>\n",
" <td>Asia</td>\n",
" <td>South-Eastern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>786</td>\n",
" <td>816</td>\n",
" <td>813</td>\n",
" <td>448</td>\n",
" <td>384</td>\n",
" <td>374</td>\n",
" <td>425</td>\n",
" <td>...</td>\n",
" <td>593</td>\n",
" <td>580</td>\n",
" <td>600</td>\n",
" <td>658</td>\n",
" <td>640</td>\n",
" <td>802</td>\n",
" <td>409</td>\n",
" <td>358</td>\n",
" <td>204</td>\n",
" <td>24417</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Maldives</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>0</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>...</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>2</td>\n",
" <td>1</td>\n",
" <td>7</td>\n",
" <td>4</td>\n",
" <td>3</td>\n",
" <td>1</td>\n",
" <td>1</td>\n",
" <td>30</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Mongolia</th>\n",
" <td>Asia</td>\n",
" <td>Eastern Asia</td>\n",
" <td>Developing regions</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",
" <td>...</td>\n",
" <td>59</td>\n",
" <td>64</td>\n",
" <td>82</td>\n",
" <td>59</td>\n",
" <td>118</td>\n",
" <td>169</td>\n",
" <td>103</td>\n",
" <td>68</td>\n",
" <td>99</td>\n",
" <td>952</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Myanmar</th>\n",
" <td>Asia</td>\n",
" <td>South-Eastern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>80</td>\n",
" <td>62</td>\n",
" <td>46</td>\n",
" <td>31</td>\n",
" <td>41</td>\n",
" <td>23</td>\n",
" <td>18</td>\n",
" <td>...</td>\n",
" <td>210</td>\n",
" <td>953</td>\n",
" <td>1887</td>\n",
" <td>975</td>\n",
" <td>1153</td>\n",
" <td>556</td>\n",
" <td>368</td>\n",
" <td>193</td>\n",
" <td>262</td>\n",
" <td>9245</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Nepal</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>1</td>\n",
" <td>1</td>\n",
" <td>6</td>\n",
" <td>1</td>\n",
" <td>2</td>\n",
" <td>4</td>\n",
" <td>13</td>\n",
" <td>...</td>\n",
" <td>607</td>\n",
" <td>540</td>\n",
" <td>511</td>\n",
" <td>581</td>\n",
" <td>561</td>\n",
" <td>1392</td>\n",
" <td>1129</td>\n",
" <td>1185</td>\n",
" <td>1308</td>\n",
" <td>10222</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Oman</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>8</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>...</td>\n",
" <td>14</td>\n",
" <td>18</td>\n",
" <td>16</td>\n",
" <td>10</td>\n",
" <td>7</td>\n",
" <td>14</td>\n",
" <td>10</td>\n",
" <td>13</td>\n",
" <td>11</td>\n",
" <td>224</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>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>Qatar</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</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>1</td>\n",
" <td>...</td>\n",
" <td>11</td>\n",
" <td>2</td>\n",
" <td>5</td>\n",
" <td>9</td>\n",
" <td>6</td>\n",
" <td>18</td>\n",
" <td>3</td>\n",
" <td>14</td>\n",
" <td>6</td>\n",
" <td>157</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>Saudi Arabia</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>1</td>\n",
" <td>4</td>\n",
" <td>1</td>\n",
" <td>2</td>\n",
" <td>5</td>\n",
" <td>...</td>\n",
" <td>198</td>\n",
" <td>252</td>\n",
" <td>188</td>\n",
" <td>249</td>\n",
" <td>246</td>\n",
" <td>330</td>\n",
" <td>278</td>\n",
" <td>286</td>\n",
" <td>267</td>\n",
" <td>3425</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Singapore</th>\n",
" <td>Asia</td>\n",
" <td>South-Eastern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>241</td>\n",
" <td>301</td>\n",
" <td>337</td>\n",
" <td>169</td>\n",
" <td>128</td>\n",
" <td>139</td>\n",
" <td>205</td>\n",
" <td>...</td>\n",
" <td>392</td>\n",
" <td>298</td>\n",
" <td>690</td>\n",
" <td>734</td>\n",
" <td>366</td>\n",
" <td>805</td>\n",
" <td>219</td>\n",
" <td>146</td>\n",
" <td>141</td>\n",
" <td>14579</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>State of Palestine</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</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",
" <td>...</td>\n",
" <td>453</td>\n",
" <td>627</td>\n",
" <td>441</td>\n",
" <td>481</td>\n",
" <td>400</td>\n",
" <td>654</td>\n",
" <td>555</td>\n",
" <td>533</td>\n",
" <td>462</td>\n",
" <td>6512</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Syrian Arab Republic</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>315</td>\n",
" <td>419</td>\n",
" <td>409</td>\n",
" <td>269</td>\n",
" <td>264</td>\n",
" <td>385</td>\n",
" <td>493</td>\n",
" <td>...</td>\n",
" <td>1458</td>\n",
" <td>1145</td>\n",
" <td>1056</td>\n",
" <td>919</td>\n",
" <td>917</td>\n",
" <td>1039</td>\n",
" <td>1005</td>\n",
" <td>650</td>\n",
" <td>1009</td>\n",
" <td>31485</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Tajikistan</th>\n",
" <td>Asia</td>\n",
" <td>Central Asia</td>\n",
" <td>Developing regions</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",
" <td>...</td>\n",
" <td>85</td>\n",
" <td>46</td>\n",
" <td>44</td>\n",
" <td>15</td>\n",
" <td>50</td>\n",
" <td>52</td>\n",
" <td>47</td>\n",
" <td>34</td>\n",
" <td>39</td>\n",
" <td>503</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Thailand</th>\n",
" <td>Asia</td>\n",
" <td>South-Eastern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>56</td>\n",
" <td>53</td>\n",
" <td>113</td>\n",
" <td>65</td>\n",
" <td>82</td>\n",
" <td>66</td>\n",
" <td>78</td>\n",
" <td>...</td>\n",
" <td>575</td>\n",
" <td>500</td>\n",
" <td>487</td>\n",
" <td>519</td>\n",
" <td>512</td>\n",
" <td>499</td>\n",
" <td>396</td>\n",
" <td>296</td>\n",
" <td>400</td>\n",
" <td>9174</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Turkey</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>481</td>\n",
" <td>874</td>\n",
" <td>706</td>\n",
" <td>280</td>\n",
" <td>338</td>\n",
" <td>202</td>\n",
" <td>257</td>\n",
" <td>...</td>\n",
" <td>2065</td>\n",
" <td>1638</td>\n",
" <td>1463</td>\n",
" <td>1122</td>\n",
" <td>1238</td>\n",
" <td>1492</td>\n",
" <td>1257</td>\n",
" <td>1068</td>\n",
" <td>729</td>\n",
" <td>31781</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Turkmenistan</th>\n",
" <td>Asia</td>\n",
" <td>Central Asia</td>\n",
" <td>Developing regions</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",
" <td>...</td>\n",
" <td>40</td>\n",
" <td>26</td>\n",
" <td>37</td>\n",
" <td>13</td>\n",
" <td>20</td>\n",
" <td>30</td>\n",
" <td>20</td>\n",
" <td>20</td>\n",
" <td>14</td>\n",
" <td>310</td>\n",
" </tr>\n",
" <tr>\n",
" <th>United Arab Emirates</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>0</td>\n",
" <td>2</td>\n",
" <td>2</td>\n",
" <td>1</td>\n",
" <td>2</td>\n",
" <td>0</td>\n",
" <td>5</td>\n",
" <td>...</td>\n",
" <td>31</td>\n",
" <td>42</td>\n",
" <td>37</td>\n",
" <td>33</td>\n",
" <td>37</td>\n",
" <td>86</td>\n",
" <td>60</td>\n",
" <td>54</td>\n",
" <td>46</td>\n",
" <td>836</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Uzbekistan</th>\n",
" <td>Asia</td>\n",
" <td>Central Asia</td>\n",
" <td>Developing regions</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",
" <td>...</td>\n",
" <td>330</td>\n",
" <td>262</td>\n",
" <td>284</td>\n",
" <td>215</td>\n",
" <td>288</td>\n",
" <td>289</td>\n",
" <td>162</td>\n",
" <td>235</td>\n",
" <td>167</td>\n",
" <td>3368</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>Yemen</th>\n",
" <td>Asia</td>\n",
" <td>Western Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>1</td>\n",
" <td>2</td>\n",
" <td>1</td>\n",
" <td>6</td>\n",
" <td>0</td>\n",
" <td>18</td>\n",
" <td>7</td>\n",
" <td>...</td>\n",
" <td>161</td>\n",
" <td>140</td>\n",
" <td>122</td>\n",
" <td>133</td>\n",
" <td>128</td>\n",
" <td>211</td>\n",
" <td>160</td>\n",
" <td>174</td>\n",
" <td>217</td>\n",
" <td>2985</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"<p>49 rows × 38 columns</p>\n",
"</div>"
],
"text/plain": [
" Continent Region \\\n",
"Afghanistan Asia Southern Asia \n",
"Armenia Asia Western Asia \n",
"Azerbaijan Asia Western Asia \n",
"Bahrain Asia Western Asia \n",
"Bangladesh Asia Southern Asia \n",
"Bhutan Asia Southern Asia \n",
"Brunei Darussalam Asia South-Eastern Asia \n",
"Cambodia Asia South-Eastern Asia \n",
"China Asia Eastern Asia \n",
"China, Hong Kong Special Administrative Region Asia Eastern Asia \n",
"China, Macao Special Administrative Region Asia Eastern Asia \n",
"Cyprus Asia Western Asia \n",
"Democratic People's Republic of Korea Asia Eastern Asia \n",
"Georgia Asia Western Asia \n",
"India Asia Southern Asia \n",
"Indonesia Asia South-Eastern Asia \n",
"Iran (Islamic Republic of) Asia Southern Asia \n",
"Iraq Asia Western Asia \n",
"Israel Asia Western Asia \n",
"Japan Asia Eastern Asia \n",
"Jordan Asia Western Asia \n",
"Kazakhstan Asia Central Asia \n",
"Kuwait Asia Western Asia \n",
"Kyrgyzstan Asia Central Asia \n",
"Lao People's Democratic Republic Asia South-Eastern Asia \n",
"Lebanon Asia Western Asia \n",
"Malaysia Asia South-Eastern Asia \n",
"Maldives Asia Southern Asia \n",
"Mongolia Asia Eastern Asia \n",
"Myanmar Asia South-Eastern Asia \n",
"Nepal Asia Southern Asia \n",
"Oman Asia Western Asia \n",
"Pakistan Asia Southern Asia \n",
"Philippines Asia South-Eastern Asia \n",
"Qatar Asia Western Asia \n",
"Republic of Korea Asia Eastern Asia \n",
"Saudi Arabia Asia Western Asia \n",
"Singapore Asia South-Eastern Asia \n",
"Sri Lanka Asia Southern Asia \n",
"State of Palestine Asia Western Asia \n",
"Syrian Arab Republic Asia Western Asia \n",
"Tajikistan Asia Central Asia \n",
"Thailand Asia South-Eastern Asia \n",
"Turkey Asia Western Asia \n",
"Turkmenistan Asia Central Asia \n",
"United Arab Emirates Asia Western Asia \n",
"Uzbekistan Asia Central Asia \n",
"Viet Nam Asia South-Eastern Asia \n",
"Yemen Asia Western Asia \n",
"\n",
" DevName 1980 \\\n",
"Afghanistan Developing regions 16 \n",
"Armenia Developing regions 0 \n",
"Azerbaijan Developing regions 0 \n",
"Bahrain Developing regions 0 \n",
"Bangladesh Developing regions 83 \n",
"Bhutan Developing regions 0 \n",
"Brunei Darussalam Developing regions 79 \n",
"Cambodia Developing regions 12 \n",
"China Developing regions 5123 \n",
"China, Hong Kong Special Administrative Region Developing regions 0 \n",
"China, Macao Special Administrative Region Developing regions 0 \n",
"Cyprus Developing regions 132 \n",
"Democratic People's Republic of Korea Developing regions 1 \n",
"Georgia Developing regions 0 \n",
"India Developing regions 8880 \n",
"Indonesia Developing regions 186 \n",
"Iran (Islamic Republic of) Developing regions 1172 \n",
"Iraq Developing regions 262 \n",
"Israel Developing regions 1403 \n",
"Japan Developed regions 701 \n",
"Jordan Developing regions 177 \n",
"Kazakhstan Developing regions 0 \n",
"Kuwait Developing regions 1 \n",
"Kyrgyzstan Developing regions 0 \n",
"Lao People's Democratic Republic Developing regions 11 \n",
"Lebanon Developing regions 1409 \n",
"Malaysia Developing regions 786 \n",
"Maldives Developing regions 0 \n",
"Mongolia Developing regions 0 \n",
"Myanmar Developing regions 80 \n",
"Nepal Developing regions 1 \n",
"Oman Developing regions 0 \n",
"Pakistan Developing regions 978 \n",
"Philippines Developing regions 6051 \n",
"Qatar Developing regions 0 \n",
"Republic of Korea Developing regions 1011 \n",
"Saudi Arabia Developing regions 0 \n",
"Singapore Developing regions 241 \n",
"Sri Lanka Developing regions 185 \n",
"State of Palestine Developing regions 0 \n",
"Syrian Arab Republic Developing regions 315 \n",
"Tajikistan Developing regions 0 \n",
"Thailand Developing regions 56 \n",
"Turkey Developing regions 481 \n",
"Turkmenistan Developing regions 0 \n",
"United Arab Emirates Developing regions 0 \n",
"Uzbekistan Developing regions 0 \n",
"Viet Nam Developing regions 1191 \n",
"Yemen Developing regions 1 \n",
"\n",
" 1981 1982 1983 1984 1985 \\\n",
"Afghanistan 39 39 47 71 340 \n",
"Armenia 0 0 0 0 0 \n",
"Azerbaijan 0 0 0 0 0 \n",
"Bahrain 2 1 1 1 3 \n",
"Bangladesh 84 86 81 98 92 \n",
"Bhutan 0 0 0 1 0 \n",
"Brunei Darussalam 6 8 2 2 4 \n",
"Cambodia 19 26 33 10 7 \n",
"China 6682 3308 1863 1527 1816 \n",
"China, Hong Kong Special Administrative Region 0 0 0 0 0 \n",
"China, Macao Special Administrative Region 0 0 0 0 0 \n",
"Cyprus 128 84 46 46 43 \n",
"Democratic People's Republic of Korea 1 3 1 4 3 \n",
"Georgia 0 0 0 0 0 \n",
"India 8670 8147 7338 5704 4211 \n",
"Indonesia 178 252 115 123 100 \n",
"Iran (Islamic Republic of) 1429 1822 1592 1977 1648 \n",
"Iraq 245 260 380 428 231 \n",
"Israel 1711 1334 541 446 680 \n",
"Japan 756 598 309 246 198 \n",
"Jordan 160 155 113 102 179 \n",
"Kazakhstan 0 0 0 0 0 \n",
"Kuwait 0 8 2 1 4 \n",
"Kyrgyzstan 0 0 0 0 0 \n",
"Lao People's Democratic Republic 6 16 16 7 17 \n",
"Lebanon 1119 1159 789 1253 1683 \n",
"Malaysia 816 813 448 384 374 \n",
"Maldives 0 0 1 0 0 \n",
"Mongolia 0 0 0 0 0 \n",
"Myanmar 62 46 31 41 23 \n",
"Nepal 1 6 1 2 4 \n",
"Oman 0 0 8 0 0 \n",
"Pakistan 972 1201 900 668 514 \n",
"Philippines 5921 5249 4562 3801 3150 \n",
"Qatar 0 0 0 0 0 \n",
"Republic of Korea 1456 1572 1081 847 962 \n",
"Saudi Arabia 0 1 4 1 2 \n",
"Singapore 301 337 169 128 139 \n",
"Sri Lanka 371 290 197 1086 845 \n",
"State of Palestine 0 0 0 0 0 \n",
"Syrian Arab Republic 419 409 269 264 385 \n",
"Tajikistan 0 0 0 0 0 \n",
"Thailand 53 113 65 82 66 \n",
"Turkey 874 706 280 338 202 \n",
"Turkmenistan 0 0 0 0 0 \n",
"United Arab Emirates 2 2 1 2 0 \n",
"Uzbekistan 0 0 0 0 0 \n",
"Viet Nam 1829 2162 3404 7583 5907 \n",
"Yemen 2 1 6 0 18 \n",
"\n",
" 1986 ... 2005 2006 \\\n",
"Afghanistan 496 ... 3436 3009 \n",
"Armenia 0 ... 224 218 \n",
"Azerbaijan 0 ... 359 236 \n",
"Bahrain 0 ... 12 12 \n",
"Bangladesh 486 ... 4171 4014 \n",
"Bhutan 0 ... 5 10 \n",
"Brunei Darussalam 12 ... 4 5 \n",
"Cambodia 8 ... 370 529 \n",
"China 1960 ... 42584 33518 \n",
"China, Hong Kong Special Administrative Region 0 ... 729 712 \n",
"China, Macao Special Administrative Region 0 ... 21 32 \n",
"Cyprus 48 ... 7 9 \n",
"Democratic People's Republic of Korea 0 ... 14 10 \n",
"Georgia 0 ... 114 125 \n",
"India 7150 ... 36210 33848 \n",
"Indonesia 127 ... 632 613 \n",
"Iran (Islamic Republic of) 1794 ... 5837 7480 \n",
"Iraq 265 ... 2226 1788 \n",
"Israel 1212 ... 2446 2625 \n",
"Japan 248 ... 1067 1212 \n",
"Jordan 181 ... 1940 1827 \n",
"Kazakhstan 0 ... 506 408 \n",
"Kuwait 4 ... 66 35 \n",
"Kyrgyzstan 0 ... 173 161 \n",
"Lao People's Democratic Republic 21 ... 42 74 \n",
"Lebanon 2576 ... 3709 3802 \n",
"Malaysia 425 ... 593 580 \n",
"Maldives 0 ... 0 0 \n",
"Mongolia 0 ... 59 64 \n",
"Myanmar 18 ... 210 953 \n",
"Nepal 13 ... 607 540 \n",
"Oman 0 ... 14 18 \n",
"Pakistan 691 ... 14314 13127 \n",
"Philippines 4166 ... 18139 18400 \n",
"Qatar 1 ... 11 2 \n",
"Republic of Korea 1208 ... 5832 6215 \n",
"Saudi Arabia 5 ... 198 252 \n",
"Singapore 205 ... 392 298 \n",
"Sri Lanka 1838 ... 4930 4714 \n",
"State of Palestine 0 ... 453 627 \n",
"Syrian Arab Republic 493 ... 1458 1145 \n",
"Tajikistan 0 ... 85 46 \n",
"Thailand 78 ... 575 500 \n",
"Turkey 257 ... 2065 1638 \n",
"Turkmenistan 0 ... 40 26 \n",
"United Arab Emirates 5 ... 31 42 \n",
"Uzbekistan 0 ... 330 262 \n",
"Viet Nam 2741 ... 1852 3153 \n",
"Yemen 7 ... 161 140 \n",
"\n",
" 2007 2008 2009 2010 \\\n",
"Afghanistan 2652 2111 1746 1758 \n",
"Armenia 198 205 267 252 \n",
"Azerbaijan 203 125 165 209 \n",
"Bahrain 22 9 35 28 \n",
"Bangladesh 2897 2939 2104 4721 \n",
"Bhutan 7 36 865 1464 \n",
"Brunei Darussalam 11 10 5 12 \n",
"Cambodia 460 354 203 200 \n",
"China 27642 30037 29622 30391 \n",
"China, Hong Kong Special Administrative Region 674 897 657 623 \n",
"China, Macao Special Administrative Region 16 12 21 21 \n",
"Cyprus 4 7 6 18 \n",
"Democratic People's Republic of Korea 7 19 11 45 \n",
"Georgia 132 112 128 126 \n",
"India 28742 28261 29456 34235 \n",
"Indonesia 657 661 504 712 \n",
"Iran (Islamic Republic of) 6974 6475 6580 7477 \n",
"Iraq 2406 3543 5450 5941 \n",
"Israel 2401 2562 2316 2755 \n",
"Japan 1250 1284 1194 1168 \n",
"Jordan 1421 1581 1235 1831 \n",
"Kazakhstan 436 394 431 377 \n",
"Kuwait 62 53 68 67 \n",
"Kyrgyzstan 135 168 173 157 \n",
"Lao People's Democratic Republic 53 32 39 54 \n",
"Lebanon 3467 3566 3077 3432 \n",
"Malaysia 600 658 640 802 \n",
"Maldives 2 1 7 4 \n",
"Mongolia 82 59 118 169 \n",
"Myanmar 1887 975 1153 556 \n",
"Nepal 511 581 561 1392 \n",
"Oman 16 10 7 14 \n",
"Pakistan 10124 8994 7217 6811 \n",
"Philippines 19837 24887 28573 38617 \n",
"Qatar 5 9 6 18 \n",
"Republic of Korea 5920 7294 5874 5537 \n",
"Saudi Arabia 188 249 246 330 \n",
"Singapore 690 734 366 805 \n",
"Sri Lanka 4123 4756 4547 4422 \n",
"State of Palestine 441 481 400 654 \n",
"Syrian Arab Republic 1056 919 917 1039 \n",
"Tajikistan 44 15 50 52 \n",
"Thailand 487 519 512 499 \n",
"Turkey 1463 1122 1238 1492 \n",
"Turkmenistan 37 13 20 30 \n",
"United Arab Emirates 37 33 37 86 \n",
"Uzbekistan 284 215 288 289 \n",
"Viet Nam 2574 1784 2171 1942 \n",
"Yemen 122 133 128 211 \n",
"\n",
" 2011 2012 2013 Total \n",
"Afghanistan 2203 2635 2004 58639 \n",
"Armenia 236 258 207 3310 \n",
"Azerbaijan 138 161 57 2649 \n",
"Bahrain 21 39 32 475 \n",
"Bangladesh 2694 2640 3789 65568 \n",
"Bhutan 1879 1075 487 5876 \n",
"Brunei Darussalam 6 3 6 600 \n",
"Cambodia 196 233 288 6538 \n",
"China 28502 33024 34129 659962 \n",
"China, Hong Kong Special Administrative Region 591 728 774 9327 \n",
"China, Macao Special Administrative Region 13 33 29 284 \n",
"Cyprus 6 12 16 1126 \n",
"Democratic People's Republic of Korea 97 66 17 388 \n",
"Georgia 139 147 125 2068 \n",
"India 27509 30933 33087 691904 \n",
"Indonesia 390 395 387 13150 \n",
"Iran (Islamic Republic of) 7479 7534 11291 175923 \n",
"Iraq 6196 4041 4918 69789 \n",
"Israel 1970 2134 1945 66508 \n",
"Japan 1265 1214 982 27707 \n",
"Jordan 1635 1206 1255 35406 \n",
"Kazakhstan 381 462 348 8490 \n",
"Kuwait 58 73 48 2025 \n",
"Kyrgyzstan 159 278 123 2353 \n",
"Lao People's Democratic Republic 22 25 15 1089 \n",
"Lebanon 3072 1614 2172 115359 \n",
"Malaysia 409 358 204 24417 \n",
"Maldives 3 1 1 30 \n",
"Mongolia 103 68 99 952 \n",
"Myanmar 368 193 262 9245 \n",
"Nepal 1129 1185 1308 10222 \n",
"Oman 10 13 11 224 \n",
"Pakistan 7468 11227 12603 241600 \n",
"Philippines 36765 34315 29544 511391 \n",
"Qatar 3 14 6 157 \n",
"Republic of Korea 4588 5316 4509 142581 \n",
"Saudi Arabia 278 286 267 3425 \n",
"Singapore 219 146 141 14579 \n",
"Sri Lanka 3309 3338 2394 148358 \n",
"State of Palestine 555 533 462 6512 \n",
"Syrian Arab Republic 1005 650 1009 31485 \n",
"Tajikistan 47 34 39 503 \n",
"Thailand 396 296 400 9174 \n",
"Turkey 1257 1068 729 31781 \n",
"Turkmenistan 20 20 14 310 \n",
"United Arab Emirates 60 54 46 836 \n",
"Uzbekistan 162 235 167 3368 \n",
"Viet Nam 1723 1731 2112 97146 \n",
"Yemen 160 174 217 2985 \n",
"\n",
"[49 rows x 38 columns]"
]
},
"execution_count": 90,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# 2. pass this condition into the dataFrame\n",
"df_can[condition]"
]
},
{
"cell_type": "code",
"execution_count": 91,
"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></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",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>Afghanistan</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>16</td>\n",
" <td>39</td>\n",
" <td>39</td>\n",
" <td>47</td>\n",
" <td>71</td>\n",
" <td>340</td>\n",
" <td>496</td>\n",
" <td>...</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",
" <td>58639</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Bangladesh</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>83</td>\n",
" <td>84</td>\n",
" <td>86</td>\n",
" <td>81</td>\n",
" <td>98</td>\n",
" <td>92</td>\n",
" <td>486</td>\n",
" <td>...</td>\n",
" <td>4171</td>\n",
" <td>4014</td>\n",
" <td>2897</td>\n",
" <td>2939</td>\n",
" <td>2104</td>\n",
" <td>4721</td>\n",
" <td>2694</td>\n",
" <td>2640</td>\n",
" <td>3789</td>\n",
" <td>65568</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Bhutan</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>1</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>...</td>\n",
" <td>5</td>\n",
" <td>10</td>\n",
" <td>7</td>\n",
" <td>36</td>\n",
" <td>865</td>\n",
" <td>1464</td>\n",
" <td>1879</td>\n",
" <td>1075</td>\n",
" <td>487</td>\n",
" <td>5876</td>\n",
" </tr>\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>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>Maldives</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>0</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>...</td>\n",
" <td>0</td>\n",
" <td>0</td>\n",
" <td>2</td>\n",
" <td>1</td>\n",
" <td>7</td>\n",
" <td>4</td>\n",
" <td>3</td>\n",
" <td>1</td>\n",
" <td>1</td>\n",
" <td>30</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Nepal</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>1</td>\n",
" <td>1</td>\n",
" <td>6</td>\n",
" <td>1</td>\n",
" <td>2</td>\n",
" <td>4</td>\n",
" <td>13</td>\n",
" <td>...</td>\n",
" <td>607</td>\n",
" <td>540</td>\n",
" <td>511</td>\n",
" <td>581</td>\n",
" <td>561</td>\n",
" <td>1392</td>\n",
" <td>1129</td>\n",
" <td>1185</td>\n",
" <td>1308</td>\n",
" <td>10222</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>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",
" </tbody>\n",
"</table>\n",
"<p>9 rows × 38 columns</p>\n",
"</div>"
],
"text/plain": [
" Continent Region DevName 1980 \\\n",
"Afghanistan Asia Southern Asia Developing regions 16 \n",
"Bangladesh Asia Southern Asia Developing regions 83 \n",
"Bhutan Asia Southern Asia Developing regions 0 \n",
"India Asia Southern Asia Developing regions 8880 \n",
"Iran (Islamic Republic of) Asia Southern Asia Developing regions 1172 \n",
"Maldives Asia Southern Asia Developing regions 0 \n",
"Nepal Asia Southern Asia Developing regions 1 \n",
"Pakistan Asia Southern Asia Developing regions 978 \n",
"Sri Lanka Asia Southern Asia Developing regions 185 \n",
"\n",
" 1981 1982 1983 1984 1985 1986 ... 2005 \\\n",
"Afghanistan 39 39 47 71 340 496 ... 3436 \n",
"Bangladesh 84 86 81 98 92 486 ... 4171 \n",
"Bhutan 0 0 0 1 0 0 ... 5 \n",
"India 8670 8147 7338 5704 4211 7150 ... 36210 \n",
"Iran (Islamic Republic of) 1429 1822 1592 1977 1648 1794 ... 5837 \n",
"Maldives 0 0 1 0 0 0 ... 0 \n",
"Nepal 1 6 1 2 4 13 ... 607 \n",
"Pakistan 972 1201 900 668 514 691 ... 14314 \n",
"Sri Lanka 371 290 197 1086 845 1838 ... 4930 \n",
"\n",
" 2006 2007 2008 2009 2010 2011 2012 \\\n",
"Afghanistan 3009 2652 2111 1746 1758 2203 2635 \n",
"Bangladesh 4014 2897 2939 2104 4721 2694 2640 \n",
"Bhutan 10 7 36 865 1464 1879 1075 \n",
"India 33848 28742 28261 29456 34235 27509 30933 \n",
"Iran (Islamic Republic of) 7480 6974 6475 6580 7477 7479 7534 \n",
"Maldives 0 2 1 7 4 3 1 \n",
"Nepal 540 511 581 561 1392 1129 1185 \n",
"Pakistan 13127 10124 8994 7217 6811 7468 11227 \n",
"Sri Lanka 4714 4123 4756 4547 4422 3309 3338 \n",
"\n",
" 2013 Total \n",
"Afghanistan 2004 58639 \n",
"Bangladesh 3789 65568 \n",
"Bhutan 487 5876 \n",
"India 33087 691904 \n",
"Iran (Islamic Republic of) 11291 175923 \n",
"Maldives 1 30 \n",
"Nepal 1308 10222 \n",
"Pakistan 12603 241600 \n",
"Sri Lanka 2394 148358 \n",
"\n",
"[9 rows x 38 columns]"
]
},
"execution_count": 91,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# we can pass mutliple criteria in the same line. \n",
"# let's filter for AreaNAme = Asia and RegName = Southern Asia\n",
"\n",
"df_can[(df_can['Continent']=='Asia') & (df_can['Region']=='Southern Asia')]\n",
"\n",
"# note: When using 'and' and 'or' operators, pandas requires we use '&' and '|' instead of 'and' and 'or'\n",
"# don't forget to enclose the two conditions in parentheses"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Before we proceed: let's review the changes we have made to our dataframe."
]
},
{
"cell_type": "code",
"execution_count": 92,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"data dimensions: (195, 38)\n",
"Index(['Continent', 'Region', 'DevName', '1980', '1981', '1982', '1983',\n",
" '1984', '1985', '1986', '1987', '1988', '1989', '1990', '1991', '1992',\n",
" '1993', '1994', '1995', '1996', '1997', '1998', '1999', '2000', '2001',\n",
" '2002', '2003', '2004', '2005', '2006', '2007', '2008', '2009', '2010',\n",
" '2011', '2012', '2013', 'Total'],\n",
" dtype='object')\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>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",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>Afghanistan</th>\n",
" <td>Asia</td>\n",
" <td>Southern Asia</td>\n",
" <td>Developing regions</td>\n",
" <td>16</td>\n",
" <td>39</td>\n",
" <td>39</td>\n",
" <td>47</td>\n",
" <td>71</td>\n",
" <td>340</td>\n",
" <td>496</td>\n",
" <td>...</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",
" <td>58639</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Albania</th>\n",
" <td>Europe</td>\n",
" <td>Southern Europe</td>\n",
" <td>Developed regions</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>1</td>\n",
" <td>...</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",
" <td>15699</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"<p>2 rows × 38 columns</p>\n",
"</div>"
],
"text/plain": [
" Continent Region DevName 1980 1981 1982 \\\n",
"Afghanistan Asia Southern Asia Developing regions 16 39 39 \n",
"Albania Europe Southern Europe Developed regions 1 0 0 \n",
"\n",
" 1983 1984 1985 1986 ... 2005 2006 2007 2008 2009 2010 \\\n",
"Afghanistan 47 71 340 496 ... 3436 3009 2652 2111 1746 1758 \n",
"Albania 0 0 0 1 ... 1223 856 702 560 716 561 \n",
"\n",
" 2011 2012 2013 Total \n",
"Afghanistan 2203 2635 2004 58639 \n",
"Albania 539 620 603 15699 \n",
"\n",
"[2 rows x 38 columns]"
]
},
"execution_count": 92,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"print('data dimensions:', df_can.shape)\n",
"print(df_can.columns)\n",
"df_can.head(2)"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"---\n",
"# Visualizing Data using Matplotlib<a id=\"8\"></a>"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"## Matplotlib: Standard Python Visualization Library<a id=\"10\"></a>\n",
"\n",
"The primary plotting library we will explore in the course is [Matplotlib](http://matplotlib.org/). As mentioned on their website: \n",
">Matplotlib is a Python 2D plotting library which produces publication quality figures in a variety of hardcopy formats and interactive environments across platforms. Matplotlib can be used in Python scripts, the Python and IPython shell, the jupyter notebook, web application servers, and four graphical user interface toolkits.\n",
"\n",
"If you are aspiring to create impactful visualization with python, Matplotlib is an essential tool to have at your disposal."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"### Matplotlib.Pyplot\n",
"\n",
"One of the core aspects of Matplotlib is `matplotlib.pyplot`. It is Matplotlib's scripting layer which we studied in details in the videos about Matplotlib. Recall that it is a collection of command style functions that make Matplotlib work like MATLAB. Each `pyplot` function makes some change to a figure: e.g., creates a figure, creates a plotting area in a figure, plots some lines in a plotting area, decorates the plot with labels, etc. In this lab, we will work with the scripting layer to learn how to generate line plots. In future labs, we will get to work with the Artist layer as well to experiment first hand how it differs from the scripting layer. \n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Let's start by importing `Matplotlib` and `Matplotlib.pyplot` as follows:"
]
},
{
"cell_type": "code",
"execution_count": 93,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [],
"source": [
"# we are using the inline backend\n",
"%matplotlib inline \n",
"\n",
"import matplotlib as mpl\n",
"import matplotlib.pyplot as plt"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"*optional: check if Matplotlib is loaded."
]
},
{
"cell_type": "code",
"execution_count": 94,
"metadata": {
"button": false,
"collapsed": false,
"deletable": 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": [
"print ('Matplotlib version: ', mpl.__version__) # >= 2.0.0"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"*optional: apply a style to Matplotlib."
]
},
{
"cell_type": "code",
"execution_count": 95,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"['Solarize_Light2', '_classic_test', 'bmh', 'classic', 'dark_background', 'fast', 'fivethirtyeight', 'ggplot', 'grayscale', 'seaborn-bright', 'seaborn-colorblind', 'seaborn-dark-palette', 'seaborn-dark', 'seaborn-darkgrid', 'seaborn-deep', 'seaborn-muted', 'seaborn-notebook', 'seaborn-paper', 'seaborn-pastel', 'seaborn-poster', 'seaborn-talk', 'seaborn-ticks', 'seaborn-white', 'seaborn-whitegrid', 'seaborn', 'tableau-colorblind10']\n"
]
}
],
"source": [
"print(plt.style.available)\n",
"mpl.style.use(['ggplot']) # optional: for ggplot-like style"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"### Plotting in *pandas*\n",
"\n",
"Fortunately, pandas has a built-in implementation of Matplotlib that we can use. Plotting in *pandas* is as simple as appending a `.plot()` method to a series or dataframe.\n",
"\n",
"Documentation:\n",
"- [Plotting with Series](http://pandas.pydata.org/pandas-docs/stable/api.html#plotting)<br>\n",
"- [Plotting with Dataframes](http://pandas.pydata.org/pandas-docs/stable/api.html#api-dataframe-plotting)"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"# Line Pots (Series/Dataframe) <a id=\"12\"></a>"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"**What is a line plot and why use it?**\n",
"\n",
"A line chart or line plot is a type of plot which displays information as a series of data points called 'markers' connected by straight line segments. It is a basic type of chart common in many fields.\n",
"Use line plot when you have a continuous data set. These are best suited for trend-based visualizations of data over a period of time."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"**Let's start with a case study:**\n",
"\n",
"In 2010, Haiti suffered a catastrophic magnitude 7.0 earthquake. The quake caused widespread devastation and loss of life and aout three million people were affected by this natural disaster. As part of Canada's humanitarian effort, the Government of Canada stepped up its effort in accepting refugees from Haiti. We can quickly visualize this effort using a `Line` plot:\n",
"\n",
"**Question:** Plot a line graph of immigration from Haiti using `df.plot()`.\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"First, we will extract the data series for Haiti."
]
},
{
"cell_type": "code",
"execution_count": 96,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"text/plain": [
"1980 1666\n",
"1981 3692\n",
"1982 3498\n",
"1983 2860\n",
"1984 1418\n",
"Name: Haiti, dtype: object"
]
},
"execution_count": 96,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"haiti = df_can.loc['Haiti', years] # passing in years 1980 - 2013 to exclude the 'total' column\n",
"haiti.head()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Next, we will plot a line plot by appending `.plot()` to the `haiti` dataframe."
]
},
{
"cell_type": "code",
"execution_count": 97,
"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 0x7f2bfd1ddfd0>"
]
},
"execution_count": 97,
"metadata": {},
"output_type": "execute_result"
},
{
"data": {
"image/png": "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\n",
"text/plain": [
"<Figure size 432x288 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"haiti.plot()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"*pandas* automatically populated the x-axis with the index values (years), and the y-axis with the column values (population). However, notice how the years were not displayed because they are of type *string*. Therefore, let's change the type of the index values to *integer* for plotting.\n",
"\n",
"Also, let's label the x and y axis using `plt.title()`, `plt.ylabel()`, and `plt.xlabel()` as follows:"
]
},
{
"cell_type": "code",
"execution_count": 98,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"data": {
"image/png": "iVBORw0KGgoAAAANSUhEUgAAAY4AAAEaCAYAAAAG87ApAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4xLjEsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy8QZhcZAAAgAElEQVR4nOzdeXxU1fn48c+52VkSshKysAZEFgkaZBEJIK0VqVpsRS0qEZSfu2JbraiUKooLoPgFtUBxoda1xLpVBRTUiMYFFDd2MEDIMkkg6yS55/fHTUZCEjKTzJIJz/v1yovkzl3OnZA8uec85zxKa60RQgghnGT4ugFCCCH8iwQOIYQQLpHAIYQQwiUSOIQQQrhEAocQQgiXSOAQQgjhEgkcwm+NHz+eWbNm+bQNH374IUopcnJyvHK9u+66i+7du6OU4plnnvHKNb2td+/e3H///SfcZ+/evSil+Pjjj73UKnEsJfM4RGvNmDGDnJwc1q1b55Pr22w2AgMDCQ8P98r1AgMDWblyJTNmzHBss9vt2Gw24uLiMAzP/h322WefMWrUKDIzMxk5ciQRERGEhYV59JrOeOaZZ5g1axY1NTWNXhs/fjwpKSmsXLnS6fPl5+fTqVMnOnfuDEBKSgrTp0/nb3/7m2Of2tpa8vPziY6OJigoqM33IFwT6OsGCNFaUVFRbT5HdXU1gYGBKKVadXxwcDDx8fFtboczduzYgWEYXHjhhc3u09b7aQ9iY2Nb3CcgIMBr77toTLqqhNvMmDGDSZMm8cQTT5CUlESXLl2YNWsW1dXVPPXUU/Tq1YvIyEiuvfZa7Ha747jx48czc+ZM7r77buLi4ujWrRtz587FNE3+/ve/0717d2JjY5k7d26D6x3fVVVRUcG1115LREQEkZGRXH/99fz1r38lJSWlyTb27t2bkJAQysrKeP/99xk/fjxRUVFERESQnp7O559/7jiud+/e1NbWkpGRgVLK8Yu5qa6qzZs3M27cOMLCwoiMjOTyyy8nLy/P8frf/vY3UlJSeP311xk4cCCdO3dmwoQJ7Nq164Tv7RVXXIFpmg2u39z9VFdXc+edd5KYmEhwcDCDBg3ihRdeaHBOpRRPPPEE06ZNo3PnzvTs2ZNXX32VkpIS/vjHP9K1a1f69u3La6+95tT33xktvc/QsKtq/Pjx7Nq1i/nz5zvue+/evdJV5WMSOIRbZWdn88UXX/D+++/zwgsvsGbNGi688EKysrJ45513eP7553n++edZtWpVg+NeffVVqqur+fjjj1m8eDEPPPAAU6ZMobS0lI8++ohHH32UBx54gHfeeafZa99xxx28/vrrPP/882zevJmIiAiWL1/eaL/PP/+cDRs2kJmZydatWwkNDaW0tJQbbriBzZs3k5WVRf/+/fnNb35DYWGh474CAgJ47LHHOHToEIcOHWqyDbm5ufz6178mKSmJzz//nDfeeINt27Zx8cUXN9jv0KFDPPnkk/zrX/8iKyuL4uJirr766mbv7fHHH+exxx4jICCg0fWbup+77rqLFStW8Nhjj7Ft2zamT5/O9OnTWb9+fYPzLliwgMmTJ7N161amTJnClVdeyaWXXsqvfvUrvv76a84//3yuvPJKx/vQVi29z8f7z3/+Q+/evbn99tsd952cnOyWtog20EK00lVXXaXPOeecBl/Hxsbqqqoqx7bJkyfr6OhoXVlZ6dh2wQUX6IsvvtjxdXp6uh42bFiDcw8aNEgPGTKkwbbTTjtN33777Q2OmzlzptZa69LSUh0cHKxXrlzZ4JiRI0fqfv36NWhjRESEPnr06Anvrba2Vnfr1k2vWbPGsS0gIECvXr26wX4ffPCBBvTPP/+stdb67rvv1omJiQ3egy1btmhAb9y4UWut9bx583RAQIDOy8tz7PPvf/9bK6V0RUVFs21avXq1DggIaLCtqfspKyvTwcHBetmyZQ32veiii/SECRMcXwP6lltucXydl5enAX3jjTc6ttlsNg3oN95444TtAnTnzp0bfRiG4fgeNaWp97lXr176vvvuc3zdr18/PW/evAbH7dmzRwP6o48+avbcwnPkiUO41amnnkpwcLDj6/j4eE455RRCQkIabDu26wZg2LBhDb6Oj4/ntNNOa7Tt+OPq7dy5E7vdzqhRoxpsHz16dJNt7NKlS4Nte/bs4YorriAlJYXw8HDCw8MpKSlh3759J7jbxr777jtGjRrV4D0YNmwYERERfPfdd45tCQkJDfryExMT0Vo3e38ncvz91L8X48aNa7Bfenp6gzbUt61ebGwsAQEBDd73yMhIgoODW2xXQEAAW7ZsafSRlpbWYD93vc/Ct2RwXLjV8RkuSqkmt5mm6ZbjjufMoHB9ts6xpkyZ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\n",
"text/plain": [
"<Figure size 432x288 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"haiti.index = haiti.index.map(int) # let's change the index values of Haiti to type integer for plotting\n",
"haiti.plot(kind='line')\n",
"\n",
"plt.title('Immigration from Haiti')\n",
"plt.ylabel('Number of immigrants')\n",
"plt.xlabel('Years')\n",
"\n",
"plt.show() # need this line to show the updates made to the figure"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"We can clearly notice how number of immigrants from Haiti spiked up from 2010 as Canada stepped up its efforts to accept refugees from Haiti. Let's annotate this spike in the plot by using the `plt.text()` method."
]
},
{
"cell_type": "code",
"execution_count": 99,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"data": {
"image/png": "iVBORw0KGgoAAAANSUhEUgAAAY4AAAEaCAYAAAAG87ApAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4xLjEsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy8QZhcZAAAgAElEQVR4nOzdeVxU5f7A8c8zbOICDgyKLK5ApqJYaG6JC2WaLbds3yQtb3var9XKa5u2qGlh3atmt72stF2TMNDIokXN8qYoLqisAygIDDLP748DkyPbDMzC0PN+vXgJZ845z/eMyneeXUgpJYqiKIpiI527A1AURVE8i0ociqIoil1U4lAURVHsohKHoiiKYheVOBRFURS7qMShKIqi2EUlDsVjjRs3jpkzZ7o1hm+//RYhBDk5OS4p75FHHqF79+4IIXj99dddUqar9e7dm6eeeqrJc/bv348Qgi1btrgoKuVUQs3jUFpq+vTp5OTkkJKS4pbyjUYj3t7eBAQEuKQ8b29vVq5cyfTp0y3HTCYTRqORbt26odM593PYDz/8wIgRI1i3bh3nnHMOgYGB+Pv7O7VMW7z++uvMnDmTkydP1ntt3LhxREVFsXLlSpvvV1BQQMeOHenUqRMAUVFRXH/99fzrX/+ynFNTU0NBQQHBwcH4+Pi0+hkU+3i7OwBFaamgoKBW36O6uhpvb2+EEC263tfXl9DQ0FbHYYs9e/ag0+m45JJLGj2ntc/TFoSEhDR7jpeXl8ved6U+1VSlOMz06dNJTEzkpZdeIiIigs6dOzNz5kyqq6t59dVX6dWrF3q9nltvvRWTyWS5bty4ccyYMYNHH32Ubt260bVrV+bOnYvZbOaJJ56ge/fuhISEMHfuXKvyTm+qqqio4NZbbyUwMBC9Xs/tt9/Oww8/TFRUVIMx9u7dGz8/P8rLy9m4cSPjxo0jKCiIwMBAEhIS+PHHHy3X9e7dm5qaGpKSkhBCWH4xN9RUtXXrVsaOHYu/vz96vZ5rr72W/Px8y+v/+te/iIqK4pNPPqF///506tSJ8ePHs3fv3ibf2xtuuAGz2WxVfmPPU11dzUMPPUR4eDi+vr4MGDCAd955x+qeQgheeuklrrrqKjp16kTPnj358MMPKS0t5brrrqNLly707duXjz76yKa/f1s09z6DdVPVuHHj2Lt3L/Pnz7c89/79+1VTlZupxKE4VGZmJj/99BMbN27knXfe4a233uKSSy4hIyODr776ijfffJM333yTVatWWV334YcfUl1dzZYtW1i8eDHPPPMMU6dOpaysjM2bN/PCCy/wzDPP8NVXXzVa9oMPPsgnn3zCm2++ydatWwkMDGT58uX1zvvxxx9JTU1l3bp1bN++nQ4dOlBWVsYdd9zB1q1bycjIIDo6mgsuuICioiLLc3l5efHiiy9y9OhRjh492mAMubm5nH/++URERPDjjz/y2WefsXPnTi6//HKr844ePcorr7zC22+/TUZGBiUlJdx8882NPtvSpUt58cUX8fLyqld+Q8/zyCOPsGLFCl588UV27tzJ9ddfz/XXX88333xjdd+nn36aKVOmsH37dqZOncqNN97I1VdfzXnnncevv/7KhRdeyI033mh5H1qruff5dB9//DG9e/fmvvvuszx3ZGSkQ2JRWkEqSgvddNNNcuLEiVY/h4SEyKqqKsuxKVOmyODgYFlZWWk5dvHFF8vLL7/c8nNCQoIcMmSI1b0HDBggBw0aZHVs8ODB8r777rO6bsaMGVJKKcvKyqSvr69cuXKl1TXnnHOO7Nevn1WMgYGB8vjx400+W01Njezatat86623LMe8vLzk6tWrrc7btGmTBOShQ4eklFI++uijMjw83Oo92LZtmwRkWlqalFLKefPmSS8vL5mfn285591335VCCFlRUdFoTKtXr5ZeXl5Wxxp6nvLycunr6yuTk5Otzr300kvl+PHjLT8D8p577rH8nJ+fLwF55513Wo4ZjUYJyM8++6zJuADZqVOnel86nc7yd9SQht7nXr16ySeffNLyc79+/eS8efOsrsvOzpaA3Lx5c6P3VpxH1TgUhzrzzDPx9fW1/BwaGsoZZ5yBn5+f1bFTm24AhgwZYvVzaGgogwcPrnfs9OvqZGVlYTKZGDFihNXxkSNHNhhj586drY5lZ2dzww03EBUVRUBAAAEBAZSWlnLgwIEmnra+33//nREjRli9B0OGDCEwMJDff//dciwsLMyqLT88PBwpZaPP15TTn6fuvRg7dqzVeQkJCVYx1MVWJyQkBC8vL6v3Xa/X4+vr22xcXl5ebNu2rd5XfHy81XmOep8V91Kd44pDnT7CRQjR4DGz2eyQ605nS6dw3WidU02dOhWDwUBycjKRkZH4+voyZswYq74YWzUWw6nHT00sp77W3PM1pKHnaSgOKWW9Yw2NSGrJ+w5Y9SXVOX3UlyPfZ8V9VOJQ2oWoqCh8fX35/vvvGTBggOX41q1bm722qKiIP/74gy+//JJJkyYBkJOTU+9Ttq+vLzU1NU3ea+DAgaxevRqTyWRJDtu3b6e0tJSBAwfa+1gtEhUVhZ+fH2lpaVZlpqenuyyGhtj6Pp/OlvddcS2VOJR2oVOnTsyaNYtHH32U7t27ExMTw3//+1927drV7PBOvV5PSEgIK1asoF+/fhQVFfHAAw/U+7Tcp08fNm3axOTJk/H19cVgMNS715133snSpUuZPn06jzzyCCUlJdx+++2MGTOGc88916HP3JiOHTty991389hjjxESEkJcXBxr1qzhk08+YePGjS6JoSG2vs+n69OnD9999x0HDx6kY8eODhmGrbSO6uNQ2o1nn32Wiy66iGuvvZbhw4dTXFzM9OnT6dChQ5PX6XQ61qxZw969exk8eDDTp0/n3nvvpUePHlbnLVq0iJ9//pk+ffo0moy6d+/O119/TU5ODsOGDWPq1KkMGjTIoUNabfH0009zyy23cO+99zJw4EDeeust3nrrLSZOnOjSOE5l6/t8uvnz51NaWsoZZ5xBSEgIBw8edFHESmPUzHGlXZswYQJ6vd7lv7gVpT1TTVVKu/Hbb7/xyy+/MHLkSEwmE2+++SabNm3iyy+/dHdoitKuqMShtBtCCF555RXuvvtuzGYz/fv3Z+3atUyePNndoSlKu6KaqhRFURS7qM5xRVEUxS4qcSiKoih2+dv0cRw5csTdIbSawWCgsLDQ3WE4hHqWtqm9PEt7eQ5w77OEhYU1eFzVOBRFURS7qMShKIqi2EUlDkVRFMUuKnEoiqIodlGJQ1EURbGLShyKoiiKXVTiUBRFUeyiEoeiKIqHkwW5yF++d1l5KnEoiqJ4OPn1WsyvLkTmH3VJeSpxKIqieDh5NAekRKZ95ZLyVOJQFEXxdHmHAZBbNiKrqpxenEociqIoHkxWnoASI8TGw4ly5I9pTi9TJQ5FURRPlqct4KobkwgRvZGpX+DsbZZU4lAURfFgMldrpqJ7BGL8hZCTDVm7nFqmShyKoiieLPcwCB1064E4JwE6dkJu+sKpRarEoSiK4snyDoOhG8LHB+HXATE6EflLBrLE6LQiVeJQFEXxYDLvMHT/a8MlMW4y1NQg0zc4rUyVOBRFUTyUlBLyjiC6h1uOiW5hMOhsZPoG5MmTTilXJQ5FURRPVVwEVZUQGm51WDfhQig1In/d6pRiVeJQFEXxVLUT/06tcQAw8CwICUVu+twpxarEoSiKxaFDh5g2bRoJCQmMHz+elStXWl4rLi7m6quvZvTo0Vx99dWUlJQAYDQamTZtGtHR0cydO9fqfjt27GDixImMHj2axx57rMH5Be+//z6xsbGcd955lq/du3fbFfeyZcusnmHo0KF2Xd8S55xzDkaj8zqgbWEZihsaYXVc6HSIcVNgzx/IQ9kOL1clDkVRLLy9vZk3bx5paWl89tlnvP7665Zf4snJyYwZM4bvvvuOMWPGkJycDECHDh144IEHeOyxx+rd7+GHH+bZZ59ly5YtZGdns2nTpgbLvfjii9m4caPlKyYmxqZ4pZSYzWZeeumlFj6xh8s7DH7+0DWo3ktidCL4+jplaK5KHIqiWPTo0YPY2FgAOnfuTHR0NLm5uQBs2LCBK664AoArrriC9evXA9CxY0eGDx+On5+f1b3y8vI4fvw48fHxCCGYNm2a5RpblJeXc+WVVzJp0iQmTpzIhg3aKKFDhw6RkJDAww8/zKRJk7jvvvuorKzkvPPO48477wSgpqaG+++/n/Hjx3PNNddQUVEBaDWgxMRELrroIp588kkmTJgAaLWeU2tLN954IxkZGQA89NBDTJ48mfHjx/PCCy/Ui7OiooLrrruOt99+G4CPPvqICy+8kPPOO48HHniAmpoam5/ZXjI3B7qHIYSo95ro1BlxzjjkD98iy8scWq5KHIqiNOjQoUPs3LnT0uxTWFhI9+7dAejevTtFRUVNXp+bm0uPHj0sP/fo0cOShE736aefWjVVVVRU4Ofnx6pVq9iwYQNr1qzhiSeesDR17d27l2nTpvH111+zZMkSOnTowMaNG3n55ZcByMrK4qabbmLTpk0EBATw5ZdfAjBnzhyefPJJPvvsM5vfhwcffJCvvvqKlJQUtm7dyh9//GF5rby8nOnTp3PppZdy3XXXsWfPHj799FPWrVvHxo0b8fLy4uOPP7a5LLvlHkac1jF+KjFuCphMyIxvHFqst0Pv1oTy8nJeffVVDh06hBCC2267jbCwMJYsWUJBQQEhISHMnj2bzp07A7B27VpSU1PR6XQkJSURFxcHwL59+0hOTsZkMjF06FCSkpIazLaKorRceXk5t9xyC/Pnz6dLly4tukdD/RmN/V+9+OKLefrpp62OVVdXs3DhQn744QeEEOTm5lJQUABAREQEZ599dqNl9+7dm0GDBgEwePBgDh06xLFjxygtLWXkyJEAXH755Y02nZ3qs88+4+2336ampoa8vDz27NnDgAEDAEhKSuL222/nsssuA2DLli389ttvTJkyBYDKykoMBkOzZbSENFWBsQBGTWz0HNGzL0QNQG76AjnxIoTOMXUFl9U4Vq9eTVxcHC+++CLPP/884eHhrFu3jtjYWJYtW0ZsbCzr1q0DICcnh4yMDBYvXszcuXNZtWoVZrMZgBUrVjBr1iyWLVtGbm4u27Ztc9UjKMrfQnV1Nbfccgv/+Mc/LL8AAQwGA3l5eYDWDBUcHNzkfXr06MHRo39tLHT06FFLjcUWH3/8MUVFRXz11Vds3LgRg8FAVe2S4R07dmzy2lObzby8vKipqUFK2Wji8vb2tvyOASzlHDx4kH//+9+8//77pKSkMHHiRCorKy3nDRs2jE2bNlmSpJSSK664wtJXs3nzZu677z6bn9ku+UdBynpDcU8nxk+Bglz4/VeHFe2SxHHixAl27dplaU/09vamU6dOZGZmkpCQAEBCQgKZmZkAZGZmMmrUKHx8fOjWrRuhoaFkZWVRXFxMRUUFMTExCCEYO3as5RpFUVpPSsl9991HVFQUs2bNsnrt/PPPZ82aNQCsWbOGSZMmNXmv7t2707lzZ37++WeklHz44YfNXnOq48ePYzAY8PHx4bvvviMnJ6fRc318fKiurm7yfoGBgQQEBPDjjz8CWqtGncjISH7//XfMZjOHDx+2fCA9fvw4/v7+BAQEUFBQUK+Gcv/996PX63n44YcBGDNmDJ9//jmFhYWANhKtqbhbpXZV3HpDcU8jzhoJgXrMDuwkd0lTVX5+PgEBASxfvpwDBw7Qt29fpk+fTmlpKXq9HgC9Xs+xY8cAbXhfdHS05fqgoCCMRiNeXl5Wn3KCg4MbHQ6XkpJCSkoKAAsXLnRaddGVvL2928VzgHqWtmrr1q189NFHDBo0iMmTJwPwxBNPMHnyZB5//HGuvfZaPvjgAyIjI3n33XcJCtJG88TExHDs2DFMJhMbN27kiy++4Mwzz+SVV15h5syZVFRUMGnSJK688sp6n/q7dOnC559/zi+//GI5tmzZMmbOnMlll13GRRddxJAhQzjjjDMsvy+8vLys3vOZM2cyadIkhg4dyvz58xFCWF7v2LEjUkoMBgOvvfYat956Kx07duS8886z3Gfy5Mm8//77nH/++QwcOJCzzjqLwMBAEhISiI+PJzExkT59+jB69Gi6dOmCwWDAy8uLoKAgkpOTufXWW1m0aBELFizgqaee4oYbbsBsNuPj48PSpUtb9e+jsX9f5ceLKQOCB8Si82+6BlZ2wT8o/2A1Xasr8e4R0eS5thDS2Qu3o3VkzZ07lyeffJLo6GhWr16Nv78/69ev5/XXX7ecl5SUxOrVq1m5ciUxMTGMHTsWgFdeeYWhQ4diMBh49913LcP+du3axSeffMJDDz3UbAxHjhxxyrO5ksFgsHyS8XTqWdqm9vIstjzHoUOHuOmmm0hNTXVRVC3T2LOYX1uC3LUDr+dXN3sPWVKE+aGZiIkXobviZpvLDgsLa/C4S5qqgoODCQ4OttQiRowYQXZ2NoGBgRQXFwNalS4gIMBy/qkjNoxGI0FBQfWOFxUVWT7xKIqi/J3I3MPN9m/UEV2DEWeNctjWsi5JHF27diU4ONjyqf+3334jIiKC+Ph40tK0bQ7T0tIYNmwYAPHx8WRkZFBdXU1+fj5Hjx4lKioKvV6Pv78/u3fvRkpJeno68fHxrngERVHamcjIyDZf22iMtrhh00NxTyfGTXHY1rIuG4578803s2zZMk6ePEm3bt24/fbbkVKyZMkSUlNTMRgMzJkzB9D+QkeOHMmcOXPQ6XTMmDEDXe0wspkzZ7J8+XJMJhNxcXEuWVpAURSlTTleCifKoZmOcSvRA/7aWnbMea2axuCSPo62QPVxtC3qWdqm9vIs7eU5oOFnkbt/x/z8w+jumYcY1Ph8ltOZUz9HvvsfdM/8BxES2uz5bu3jUBRFURxH5tXtM25HjQMQPftp3+S2boiwShyKoiieJvcwePtAcIh919X2icijKnEoiqL8rdRtFyt0XnZdJzoHQJdAVeNQFEX528m13mfcLqHh2qq6raASh6IoigeRJ09CYW6zS400RoRGaImnFVTiUBRF8SSFeVBTY/Pkv3pCI+B4KbLsWItDUIlDURTFkzS2z7iNRN1aVa2odbQocZhMJk6ePNniQhVFUZSWaWyfcZvVJhzLkN4WsClxvPHGG2RlZQHwyy+/kJSUxPTp0/npp59aXLCiKIrSAnmHoUsgolPnll1v6Abe3tCKIbk2JY4tW7YQGRkJwIcffshdd93FAw88wLvvvtvighVFURT7afuMt7B/A7QhvN1bN7LKprWqqqqq8PPz4/jx4+Tl5TFixAiAdjOlX1EUxWPkHkYMGd66e4SGQ86BFl9uU+IICwtj8+bN5ObmMnjwYACOHTuGr69viwtWFEVR7CNPlGkLHLZ0RFUtERqB/HUr8mQ1wtvH7uttaqqaMWMGGzZs4Pfff+eqq64CYPv27ZYkoiiKorhAbutGVFmERoDZrO1F3gI21TgMBgNPPfWU1bFzzz2X2NjYFhWqKIqi2M8yoqqViUP0iECC1kHeI9Lu622qcdxzzz0NHp89e7bdBSqKoigtlHcEdDoI6d66+9QNyW1hB7lNiaOhLTtOnDhh2VxJURRFcT6ZlwOG0Bb1S5xKdPCHrsEtngTYZFPVbbfdBmgT/uq+r1NWVsbo0aNbVKiiKIrSAnbsM96sHhEtrnE0mTjuuusupJQsWLCAu+66y+q1rl27Nro7lKIoiuJY0myG/KOIgY7ZLluEhiO3piGltHsb2SYTx4ABAwBYtWoVfn5+LY9QURRFaR1jAVSbWt0xbhEaARXlcKwEAvV2XWrTqCovLy9SUlLYv38/lZWVVq/deeeddhWoKIqitEDdUFwHNVWJ0NqRVbk5zkkcL7/8MgcOHODss88mMDCwBSEqiqIorWFZlNBRfRy1iyTKozmIM+ybWmFT4ti+fTsvv/wynTp1sj84RVEUpfVyD4N/J+jS1TH30weDX4cWbSNr03hag8FAdXW13TdXFEVRHEPmaSOq7O3IbowQAkJbNrLKphrH2LFjef7555k8eTJdu1pnu0GDBtldqKIoimKn3MOIMxz7+1Z0D0fu3WX3dTYljvXr1wPUW0ZdCMHLL79sd6GKoiiK7WRVJRQXOm5EVZ0e4ZCZjqyqQtgxctamxJGcnNziuBRFUZRWyjsCOG5EVR0RGqGtDJJ/BCL72HydWjNEURSljXP4iKo6dSOr7OznsKnGceLECdasWcMff/zB8ePHrdaueuWVV+wqUFEURbFT7mEQAro5eLWO7mHafe3cRtamGsfKlSvJzs5m2rRplJWVcfPNN2MwGLjwwgtbFKuiKIpih9zDEBSC8HXsCh7CxxcM3e0ekmtTjWPHjh0sWbKELl26oNPpGDZsGP369ePZZ59l6tSpNhV0xx130KFDB3Q6HV5eXixcuJCysjKWLFlCQUEBISEhzJ49m86dtQ3Y165dS2pqKjqdjqSkJOLi4gDYt28fycnJmEwmhg4dSlJSksOGpymKorRFMu+w4zvG67RgSK7Ny6p37NgRgA4dOlBeXk7Xrl3JzbVv96h58+bx/PPPs3DhQgDWrVtHbGwsy5YtIzY2lnXr1gGQk5NDRkYGixcvZu7cuaxatQqz2QzAihUrmDVrFsuWLSM3N5dt27bZFYOiKIonkVJqQ3Ed3b9RS4SGQ95hbRFFG9mUOHr16sUff/wBQP/+/Vm1ahUrV66kR48eLYu0VmZmJgkJCQAkJCSQmZlpOT5q1Ch8fHzo1q0boaGhZGVlUVxcTEVFBTExMQghGDt2rOUaRVGU9shcXAhVFY7vGK8TGg4mkzbc10Y2NVXNmjXL0iF+8803884771BeXm73AodPP/00AOeddx6JiYmUlpai12uLa+n1eo4dOwaA0WgkOjracl1QUBBGoxEvLy+Cg4Mtx4ODgzEajQ2WlZKSQkpKCgALFy7EYDDYFWtb5O3t3S6eA9SztFXt5Vnay3MA1PyhtaoExgzAzwnPZDpjIMVAwIlj+J0xwKZrmk0cZrOZb7/9lssuuwyAgIAA/vnPf9od3JNPPklQUBClpaU89dRTTe7l0dCOg00db0hiYiKJiYmWnwsLbc+mbZXBYGgXzwHqWdqq9vIs7eU5ADoezAbgWIfOCCc8k/TvAkDp7l3oIqOsXmvs93SzTVU6nY4NGzbg5eXVquCCgoIACAwMZNiwYWRlZREYGEhxcTEAxcXFBAQEAFpNoqioyHKt0WgkKCio3vGioiLLfRVFUdqjmiMHwddXW5TQGboEQsfOdo2ssqmPIyEhgY0bN7Y4rsrKSioqKizf79ixg549exIfH09aWhoAaWlpDBs2DID4+HgyMjKorq4mPz+fo0ePEhUVhV6vx9/fn927dyOlJD09nfj4+BbHpSiK0tadPHIQuoUjdM6Zry2E0LaRtWMuh019HFlZWaxfv55PP/2U4OBgq+Gv8+fPb/b60tJSXnjhBQBqamoYM2YMcXFx9OvXjyVLlpCamorBYGDOnDkAREZGMnLkSObMmYNOp2PGjBnoat+0mTNnsnz5ckwmE3FxcQwd6phtFBVFUdqimsMHERG2LwfSEiI0HLnzV9vPlzZ0HHz77beNvjZu3DibC3OnI0eOuDuEVmtP7bbqWdqm9vIs7eU5ZHU15juvQEy5At0l1zmtHPP6j5Af/Rfd0ncRHf/ad6mxPg6bahyekhwURVHalYKjYDY7b/JfLcs2snmHoU9Ms+fblDhSU1MbPO7j40NwcDDR0dH4+PjYE6eiKIrSHAfvM96o2vvLozkIRyWO9PR0du/eTWBgoGVkU2lpKf369SM/Px+ABx54gH79+rUickVRFOVUllVxnVzjwBAKXl42j6yyKXFEREQwfPhwpkyZYjm2fv16Dh8+zBNPPMHHH3/Ma6+9ZpngpyiKojhA7mF0egPCv6NTixHe3hDS469E1Qybxnd99913XHDBBVbHzj//fLZs2YIQgosvvpicHPv3rVUURVEaJ4vy8ereuqWdbBYaYfPy6jYljsDAQH7++WerY7/88otlwl51dTXe3jZVXhRFURRblRaj07tm6RTRIxzyjyJrapo916bf9klJSSxevJiePXta+jgOHjxomXexZ8+eejUSRVEUpZVKjeiCXLTmVmgE1JyEwjxtg6cm2JQ4hgwZwksvvcS2bdswGo0MHTqUs846iy5dulheHzJkSOsDVxRFUQCQVZVQcQIvFyUOy5Dc3BzHJA7QFjccO3ZsK0NTFEVRbFKqrfztqqYqy5Dc3BzEkOFNntpo4nj66aeZO3cuAI8//niju+zZsuSIoiiKYqeS2sThqhpHx84Q0NWmDvJGE0fdBksAEyZMcExkiqIoik1kbeJwVVMVYPM2so0mjjFjxli+V0uOKIqiuFhdjUMfDJUmlxQpQiOQP3/X7Hk293Hs2rWL7OxsKisrrY7XbfCkKIqiOFBpMfj4Ijp1gcqi5s93hB7hUH4cefwYoktAo6fZlDhee+01vv/+e/r374+vr6/leGP9HoqiKEorlRiha5BLf89ajazq0vg2sjYljs2bN7No0SK1256iKIqLyFIjBOpdW2hohFZ2bg4iuvHEYdPMcYPBoFa/VRRFcaVSIyLQxR/Wg0LAx7fZxQ5tqnH885//5N///jejR48mMDDQ6rUBAxrPSoqiKEoLlRhh4FkuLVLodNA9vNltZG1KHPv27ePXX39l165dVn0cAK+88krLo1QURVHqkZUVUFkBXV3fPSBCw5EHspo8x6bE8e677/Lggw8yePBghwSmKIqiNKG0WPvT1U1VoPVz/JyBrG58CLBNfRx+fn6qSUpRFMVVaudwCDfUOAgNB2mG/KONnmJT4rjqqqt4/fXXKSkpwWw2W30piqIojiVLaudtuKOpqoc2sqqpDnKbmqrq+jE2btxY77X333+/BaEpiqIojapd4NDlw3HBsk2tzG18N0CbEsfLL7/smIAURVGU5pUWg68v+HdyedHCr4M2LLe1NY6QkBCHBaUoiqI0o8QIga6dNW4lNKLJIbk2JY4TJ07w5Zdfsn///nprVT366KOtC1BRFEWxImsTh7uIHv9inecAACAASURBVBHILSmNvm5T4li8eDFms5nhw4fXm8ehKIqiOFhpMSKyj/vK7x4OVRWNvmxT4tizZw+rVq3C29vmxXQVRVGUlioxQuzZbitehIZrix02wqbhuP379+fw4cZ72BVFURTHkJUntE/77hhRVadPNLr7FzT6sk1ViNtvv50FCxYQFRVF165drV6bNm1a6wJUFEVR/lJSO2vcHZP/aokOHSFmYKOv27zkSFFRESEhIVRU/NXuZW+Pv9ls5qGHHiIoKIiHHnqIsrIylixZQkFBASEhIcyePZvOnTsDsHbtWlJTU9HpdCQlJREXFwdo62YlJydjMpkYOnQoSUlJal8QRVHaj9o5HC5fGdcONiWOjIwMli5dil7fuqrTl19+SXh4uCX5rFu3jtjYWC699FLWrVvHunXruP7668nJySEjI4PFixdTXFzMk08+ydKlS9HpdKxYsYJZs2YRHR3NggUL2LZtG0OHDm1VXIqiKG1F3V7j7qxxNMemPo7u3bvj5eXVqoKKior45ZdfmDhxouVYZmYmCQkJACQkJJCZmWk5PmrUKHx8fOjWrRuhoaFkZWVRXFxMRUUFMTExCCEYO3as5RpFUZR2wTJrvO0mDptqHOeeey7PPfccF1xwQb0+jkGDBtlU0Ouvv871119v1dRVWlpqqcXo9XqOHTsGgNFoJDo62nJeUFAQRqMRLy8vgoODLceDg4MxGo0NlpeSkkJKijYOeeHChRgMBpvibMu8vb3bxXOAepa2qr08iyc/x/GqCk74dcAQ2RMhRJt8FpsSx4YNGwCtr+NUQgibliP5+eefCQwMpG/fvvz+++/Nni9lwwPBGjvekMTERBITEy0/FxYW2nxtW2UwGNrFc4B6lraqvTyLJz+H+ehhCNRTVKQtdOjOZwkLC2vwuE2JIzk5uVWF//nnn/z000/8+uuvmEwmKioqWLZsGYGBgRQXF6PX6ykuLiYgIADQahJ1bxpoNZCgoKB6x4uKitQ+6IqitCtu2WvcTjb1cbTWtddey6uvvkpycjL33nsvgwYN4u677yY+Pp60tDQA0tLSGDZsGADx8fFkZGRQXV1Nfn4+R48eJSoqCr1ej7+/P7t370ZKSXp6OvHx8a54BEVRFNcoKUZ0DW7+PDdqssbx+OOPNzvUdf78+S0u/NJLL2XJkiWkpqZiMBiYM2cOAJGRkYwcOZI5c+ag0+mYMWMGOp2W42bOnMny5csxmUzExcWpEVWKorQbUkqtczxwmLtDaZKQTXQcfPvtt83eYNy4cQ4Mx3mOHDni7hBazZPbbU+nnqVtai/P4qnPIStOYL77asS06egmXQZ4YB+HpyQFRVGUdsEDhuKCi/o4FEVRFBu4c69xO6jEoSiK0kZYZo2rGoeiKIpik1L3L3Boi0YTx9y5cy3fr1mzxiXBKIqi/K2VGMGvA3Twd3ckTWo0cRw5cgSTyQTA559/7rKA3MX84WrMn72HPHnS3aEoivJ3VTv5r62v+N3oqKphw4Zxzz330K1bN0wmE/PmzWvwvNbM42grpLkGmfIp1NQgf/8F3cz7EIbu7g5LcQL5289w5mCEt4+7Q1GUemSpsc03U0ETieP222/nf//7H/n5+WRlZTF+/HhXxuVaxUVQUwNnjYRd2zE/cQ/ihjvQDTvX3ZEpDiT378G8bD4i6V7EqAnuDkdR6isxInpFuTuKZjU5j6N///7079+fkydPtu85HYV5AOgSJsO0JMwrFyH/8zzm339FXHMrwq+DmwNUHEHu/VP75vB+t8ahKA2RUmp9HEM8uMZxqgkTJrBz507S09MtixKOHTvW5iXV2zpZkKt9ExKKCAlFd/8C5GfvIb9ag9y7C90t/4fo2c+9QSqtl60lDnn4gJsDUZQGVJwAU1WbH4oLNg7H/eabb3jxxRfp2rUrw4cPR6/Xs3TpUst+Fx6vIA90OtBra94Lb290/7ge3ZwnobIC84L7Mad8Ytey7krbI7P3aN8cPujeQBSlIR4yFBdsrHF8+umnPProo/Tu3dtybNSoUSxatMhqzwuPVZgLQSEIb+u3Q/QfjO7xZZj/uwz5/irkH9vRTb8bEdC1kRspbZUsPw75R6BLIJQUIcvLEJ06uzssRflLibZlRFufNQ421jiOHz9ORESE1bGwsDDKysqcEpSryYJcCAlt8DXRJQDdHXMR19xq6TiXu5vfjEppY2prG2Jkbaf4EVXrUNoWaVmnqm3vxQE2Jo7+/fvzxhtvUFVVBUBlZSVvvvkmMTExTg3OZQrzmhx+K4RAN2EqurkvgK8f5lWLkeYaFwaotJbM3g1CIEZpe96rfg6lzfGgpiqbEsctt9zCgQMHmD59OrfccgtJSUkcOHCAW2+91dnxOZ2srIDjpWDDvA0R0Qfd5dPBWAA7fnJ+cIrDyOzdEBoBYZHg3xGOqMShtDElRvDzR3To6O5ImmVTH4der2f+/PkUFRVZRlUFB7ftHapsVjsUt7GmqnrizoGuwZg3fYFX3DnOi0txGCklZO9GDB6mzcgN64lUHeRKW1PS9reMrWPXIofBwcFERUW1n6QBWsc4IAy2JQ7h5YVImAR/bEPmHnZmZIqjFOZB2THoozWtivBecOSAGiWntCmeMmsc1Oq4SEuNw/YlRsS5k8DLG/ntl06KSnEkmb0bAFGbOAjrBWXH4ViJG6NSlNOUGD1iRBWoxKHN4ejgD5262HyJCNQjzh6FzEjV+kiUti17D/j4QngvAER4T+246iBX2oi/9hpvJ01VZrOZnTt3crKdrhorC3LBEGr3apRi/BSoKEf+kOakyBRHkdl/Qs++f83TqU0gUnWQK21FxQkwmdpPU5VOp+O5557D29umfnTPU5hnVzOVRb8zIbIPctMXqq28DZMnT8LBfYg+Z1iOiS6B2kRA1UGutBUestd4HZuaqs4880x2797t7FhcTkqpzeGwdUTVKYQQiPEXas0de/5wQnSKQxw+ANUm6BNtfTy8l5rLobQdHrLXeB2bqhEhISEsWLCA+Ph4goODrZp1rrrqKqcF53SlxdovlRbuvSGGJyA/XI389ktEzEAHB6c4Qr2O8VoivBdySwrSbEboVFef4l6estd4HZsSh8lkYtiwYQAYjUanBuRSdg7FPZ3w80OMSkRu+hzpQSMi/layd0PngPofDsJ6QlWFNplTbdqluFtdU1VXz+gctylx3H777c6Owy1kgf1DcU8nxk9GpnyCTN+AuPgaB0WmOIrM3g19YuoNfhDhvZCg9XOoxKG4W4kROnjGrHGwYzhuTk4OH374IatWrQK0PckPHPDwNuKCXBACgru1+BaiWxgMOguZvkHtV97GyIoTkJtTr5kK0GocqJFVShtRYvSYZiqwMXF8//33zJs3D6PRSHp6OgAVFRW88cYbTg3O6QrzoGswwse3VbfRjbtQq2pu2+qYuBTH2L8HpGwwcQj/jhAUouZyKG2CLC32mKG4YGPi+OCDD3jssce49dZb0dV2JPbq1Yv9+/c7Mzank4W5YGh5bcMi9iwwdMe86YvW30txmLqO8XojquqE91JrViltQ6kR0d5qHKWlpfTq1cvqmBDC7klzbU5BXos7xk8ldF6IcZNh9+/InP2tj0txCJm9B7qFIRpZFUCE9YTcQ8gatUS+4j6WvcY9pGMcbOwc79u3L+np6SQkJFiOfffdd0RFRdlUiMlkYt68eZw8eZKamhpGjBjBlVdeSVlZGUuWLKGgoICQkBBmz55N587armxr164lNTUVnU5HUlIScXFxAOzbt4/k5GRMJhNDhw4lKSmpRQlMVpu0HbdaMIejIWJ0IvKTd7Shude3z8EEnsSyIm7/2MZPCu8FJ09C/lHoEdH4eYriTBXl2rSA9lbjSEpK4r333mPevHlUVVXx9NNP8/7773PTTTfZVIiPjw/z5s3j+eef57nnnmPbtm3s3r2bdevWERsby7Jly4iNjWXdunWA1hGfkZHB4sWLmTt3LqtWrcJsNgOwYsUKZs2axbJly8jNzWXbtm0te/KifO3PVoyoOpXoHIAYdi5y67fIE+UOuafSCsVFWr9TQx3jtSxrVqkOcsWd6uZwtLc+jvDwcF588UUmTZrE1Vdfzbhx41i0aBE9evSwqRAhBB06dACgpqaGmpoahBBkZmZaajEJCQlkZmYCkJmZyahRo/Dx8aFbt26EhoaSlZVFcXExFRUVxMRowyvHjh1rucZutUNxHdFUVUdMuBCqKpHfpzrsnkoLNTLxz0poBAidmkGuuFfdrHEPqnHYvACVn58f/fv3x2g0EhQUZEkEtjKbzTz44IPk5uYyadIkoqOjKS0tRa/X2vX0ej3Hjh0DtEmG0dF/dWgGBQVhNBrx8vKy2gskODi40QmJKSkppKSkALBw4UIMBoPV6ycqyjgOBMWciVeQoYE7tIDBgDFmIObNGwi+crrD+4C8vb3rPYencvazHM87xAlvbwxx8Qhfv0bPK+wRgXdhLl1bEYv6e2l7POk5KmqqOQbo+/TDu4GY2+Kz2JQ4CgsLWbZsGXv27KFTp06Ul5cTFRXF3XffTUhIiE0F6XQ6nn/+ecrLy3nhhRc4eLDx0SyNLRpoz2KCiYmJJCYmWj3Dqcz7s8DHF2ONRJz2WmuYx5yPfG0JhZu/QQyIc9h9AQwGQ73n8FTOfpaaP3ZARB+Kjh0Hjjd+Xmg4Ndl7WhWL+ntpezzpOcw52u/CYjMN/i5y57OEhYU1eNympqrk5GT69u3L6tWrWblyJatXr6Zfv34kJyfbHUinTp0YMGAA27ZtIzAwkOJibYP24uJiAgICAK0mUVRUZLmmrpZz+vGioiKCglpWvZMFeWDo7vBagYgfDV0CMW9Smzy5izTXwP4sRGPDcE8hwnpB3lFtsISiuENp3axxf3dHYjObEse+ffu4/vrrLc1THTp04Prrr2ffvn02FXLs2DHKy7UOY5PJxG+//UZ4eDjx8fGkpWn7WaSlpVnWw4qPjycjI4Pq6mry8/M5evQoUVFR6PV6/P392b17N1JK0tPTiY+Pt/uhgdrl1B3Xv1FH+PgixpwH239EFhU4/P6KDY7maOtQnbKUemNEeE+QZu0aRXEDWVLkUR3jYGNTVXR0NFlZWfTv399ybO/evcTENNHxeIri4mKSk5Mxm81IKRk5ciRnn302MTExLFmyhNTUVAwGA3PmzAEgMjKSkSNHMmfOHHQ6HTNmzLBMPJw5cybLly/HZDIRFxfH0KFD7X3m2uXUc522oq1ImIxc/zEy7SvEZTc6pQylcXLfnwA21ThO3dRJ9OzrzLAUpWGlxR41FBeaSBzvv/++5fvu3buzYMECzjrrLEtz0a+//sqYMWNsKqRXr14899xz9Y536dKFxx9/vMFrLrvsMi677LJ6x/v168eiRYtsKrdRZcehssJhQ3FPJ4JDYHA8cuu3oBJHq7Ro2fP9e6BjJ+jWcPuslZAe4O2tNnVS3KfEiOjXv/nz2pBG/0cWFRVZvqqrqznnnHPw8fHh2LFj+Pj4MHz4cEwmD20XbuVy6rYQMYOguBB5vNRpZbR35k1fYH5wBtJoX5Of3LcbekfblHCEtzeERqghuYpbWGaNt5caR3tdSh1AFtYtp+7ExBHZR1u2+1A2OHh01d+BLC5CfvRfqKrE/O4KvO54xLbrqirhyAHEkGk2lyXCeiH37mppqIrScifK4WR1++zjAKiqqiI3N5fKykqr42ec0XwHZJtToNU4nLoPQ0QfAOShbIcPy/07kB+uhpoaxLgpyG+/RG7biogb0fyFB/aC2dz0xL/ThfeEH9OQFSe0VXMVxVU8cNY42Jg40tLSeO211/D29sbX13oJ8ldeecUpgTlVYR50CUT42TeJ0R6iSwB0DYacbKeV0V7JP3cif0xHTL0aceGVyD2/Y373P+j6D2l2yKLc38yKuA2wbOp05CB4WFuz4uFKtekFItBzFjgEGxPHW2+9xX333cfgwYOdHY9LyIJcpzZTWUT2QR5SicMesqYG87v/huBuiAsuR3h7o7v+dszPPoj89B3ElTOavsG+3dq1AXb8R7Rs6nTQ4zopFc8mS7R5bJ5W47BpuIq3tzcDBgxwdiyuU5Dr1I7xOiKyD+TmqMlldpDffgmHD6C7cgbCT1sqRESdiRg7CfnNZ8iDTc8dkvv32NdMBdoOkH4d1KZOiuvV7TXuYZ3jNiWOq666ijfeeMOylpQnkydPQnGh04biWonoAzU1cOSQ88tqB+SxYuQnb8OAoTDUuj9DXHYTdOqC+a3l2szwRq6nKN+uZipAG30V1lONrFJcr8QI/h2d2mzuDDY1VYWFhfHBBx+wYcOGeq+dOt/DIxQXgtnskqaqupFVMicb0auf08vzdPLjN8BkQnfNLfWWghGdOiOunIFctRiZtgExfkr9G2Tv0c61Ycb46URYT+SOFq60rCgtJD1wKC7YmDheeuklxo4dy6hRo+p1jnucgro5HC6ocXQLBV8/bUiu0iS593/I775BTLoMEdrwpkrinARkxjfItW8gh45AnNYuLPftBp0OerYgSYf3gu9SkMdKEAFdW/IIimK/UqPH9W+AjU1VZWVlXHXVVfTs2ZPQ0FCrL08jC+uG4rqgxqHzgojeqoO8GdJcg/nd/0DXIMTUKxs9TwiB7rrboLoa+cGq+vfZvxvCe1n6Ruzx16ZOaga54kIlRo8bUQU2Jo5x48aRnp7u7FhcozAPvLxB75osLyL6QE62XUvC/93ILRvhQBZiWhKiQ9PzKET3MMSFVyAzNyN3/vLXPcxmyG5Bx3idsNo1q9TSI4qLSCk9tsZhU1NVVlYW69ev5+OPP6ZrV+tq/Pz5850SmNMU5GnDNXVerikvsg+krwdjgTZ6R7Eiy44hP34TYgYiho+16Rox6XLkD2mY334F3b9e1moY+Ue0vZtbmjgC9dCpi9pGVnGdE2XanvftNXFMnDiRiRMnOjsWl5AFuc6dMX4aq6VHVOKoR37yNlSUo7vmVpv3RhE+PtrcjhfmIr94H3HZjVr/Bs1sFdvUPYWAcDWySmkdaSyEgECEt0/zJ5d45lBcsDFxjBs3zslhuFBhHqJ3lOvKC+8FQmhLj8Sd47pyPYA8sBeZth4xYarWpGcHcUYsYuQE5NdrkeeMg/27wc8fejTcsW7TPcN6IX/4Fimlwzf4Uto/WVWJed4diMHDELf8X/MXeOBe43VsShypqamNvjZhwgSHBeNs8kQ5lB93zazxWqKDP4T0QKqlR6xIs1mbId45AHHxNS26h7jiZuSOTMxvLYdqE/SOal0TZHhPqDihDdkOsm1L5L8jlVgbsWs7VFYgf0xHDju32Q+KstQz16kCGxPH5s2brX4uKSkhNzeX/v37e1TioHZVXFfMGrcS2RuamfH8d1OZtgH2/g8x/R5Ex84tuofoEoCYNh3535e0nyfV37/FrvuF1a5ZdfigShyNkNXVmJ+ardX4rr7F/r1S2jG5IxM6+ENwN63/LWZg0/+223tT1bx58+odS01N5fDhww4PyKnqhuK6Ytb4KURkX+TPGWr11VryRDllbyRD3zMQI8e36l5idCIy4xvY8weibws7xuuE161ZdQARe3br7tVe/bENjhxEHjmobYY2/S7XDTRpw6TZjNyRiRh4FuKCyzA/cz/yw9cRN97Z+EUlRvDv1KLh4+5m87Lqpxs3bhwzZszghhtucGQ8TiULavfhcGHnOGhDciVAzn6Ibkdrfp3G/N4KZOZmkFLbx9ss//peyr++zDVgNqO789FWf2IVQqC76W7kureg/5DW3atTF63ZQHWQN0r+tAU6dkJMuAj5+XvaXhI3z9Y2xPo7O7hX2wJ2yHBE72jE+ZcgN6zVmqzObPjfpSwt9shmKrAxcZjNZqufTSYT6enpdOrUySlBOU1hLnTs3OKmkRaLrN2bIycb0U4Thzyag0z9HKIHIsIiQQgQur/+1AlAaD/rBAFDhlHWyzGDFET3MMSsBxxyL8J6qbkcjZDV1cjtPyCGjkR3ybWY/fyQH/0XebIa3a332zaSqJ2S2zNB6BCDtJqquPha5K9bMb+ZjG7esobXovLQORxgY+K45pr6nZdBQUHMmjXL4QE5kyzMc2nHuIU+WJsj0I5nkMsv14CPL7p/PojoEtjs+R0MBsoKC10QmX1EeE/kt18hzTWqCeZ0f2yDihOI+DEA6C64HLOPL/K9FZiXL0B320MIHw9fkqiF5I4fod8Z2j48gPD1Q3fTXZiffwS57m3EVQ1sB1Bi9NgPkjYljpdfftnqZz8/PwICApwSkFMV5CEieru8WCFEu96bQ+YfRf6Yhph4kU1Jo00L76WN0CrIg+5h7o6mTalrpuLMv/bl0U28CLO3D/Kt5Zhffgrd7XM9ss2+NWRxERzch7jsRqvjImYQYtxk5DefIuNHW+31Ypk17oEd42DjkiMhISFWX56YNKS5BorcVOOgdumRwweQNQ0vCe7J5Fcfgs4Lcf4/3B1Kq4napUdUP4c1SzNV3Ih6TVK6hAsQ0++BXdsxL5uPrKxwU5TuUbeqshg8vN5r4rKbQB+M+b8vIaur/3qh/LjHzhqHZmoczS0nIoTg8ccfd2hATlNi1P6iXNwxbhHZR/skm38EekS6JwYnkEX5yO9TEWMvqLdarUcK0/5u5JEDiLNGujmYNuS0ZqrT6UZPxOztjXxtCeYX56G7ex6io4f1gbaQ3JGp/V4Jq///Wvh31FY5WPYE8ss1iEuu1V7w4KG40EziOPfccxs8bjQa+eqrr6iqqnJKUE5RN4fDxUNx61j25jiUjWhPiWP9R4BAXNC6ORRthfDroNVKVQe5lYaaqU6nOycB6e2DecXzmBc/hm72fG2kWjsmq6pg13bEuec3OilSxMYjRoxDfrUGefZIrfWhbta4h37YarKpasKECVZfw4YNIycnh88++4zhw4ezdOlSV8XZan8NxXXTUvA9IrRVedtRP4csLkJu2YgYPRHRnibMqd0ArTTVTHU6cfYodLc9DIf3Y170KPJ4qYuidJP/bYdqE2LIsCZPE1fNhI6dMb/+ErKmRhuKCx7bVGVTH8eJEyd47733uPvuuyktLeXZZ59l1qxZBAcHOzs+xynM1YaFuukXnPD2gR6R7WrpEfn1WjCbERdc7u5QHEqE94L8I9Zt0n9nzTRTnU4MGY7uzscg9zDm5x5GFhU4OUD3kTsytTXSogc1eZ7oHIC4ZhYcyEKmfAolRdoLHrgXBzSTOEwmE2vXruWuu+7i8OHDPPHEE9x1110euYETBbkQZHDrRCUR2bvN1Dik2Yz567UtnrMgj5Ug09cjzhmHcNOAA6cJ66ntFZ/nYSsjOIktzVSnEwOHorv3X1BajPnZB7WZ5u2MlFJLHAOHInyan8Mi4kdD3AjkJ28j9/yuTaT09cwRaE0mjjvuuIPPP/+ciy++mEmTJlFaWsrOnTutvjyFLMxzX8d4nci+UFqMPFbs3jgAufET5JrVmBc/qr039l7/9TqoPomYcoUTonMvEV67qdOeP/72G3DZ00x1OhEzCN39z4C5Rqt57P2fk6J0k4N7tbkYzTRT1dF2sJwF3j7w+68e2zEOzXSO1+0v/vXXXzf4uhCi3hyPNqswDxEb79YQRETv2r059sNA91VR5aFs5No34YxYOJSNeem/0D30nM0dmbLsGPLbLxHDxiBCw50crRuEhkPHzsh3XkWmfIIYOlIbYdU7+u+3qJ+dzVSnE5F90D34LOYX52kd5v98qN2sA6bNFheW2eK2EF2DEVferC3M6aH9G9BM4khOTnZIIYWFhSQnJ1NSUoIQgsTERKZMmUJZWRlLliyhoKCAkJAQZs+eTefO2nIga9euJTU1FZ1OR1JSEnFxcQDs27eP5ORkTCYTQ4cOJSkpybYlnkuL20CN45SlRwYOdUsI0lSFecUL0LkLulkPwtFDmJc8pk3emvOkTTN/ZcqnUFWJmNL4/uCeTHj7oHvqFeSvW5G/fo9M+RS54WPoGow4qzaJRA1AeLX/meUtaaY6nQgJRffgQsxL52NOfgox/R50I8Y5Lkg3kTsytYU6A7o2f/IpxOhEyNoFPfs6KTLnc8nHJy8vL2644QaWLFnC008/zYYNG8jJyWHdunXExsaybNkyYmNjWbduHQA5OTlkZGSwePFi5s6dy6pVqyzrZa1YsYJZs2axbNkycnNz2bZtm+2BuLktXnQOAL0BDrqvn0N+/AYcPYRu+j3asuQxA9HNmANZuzCvXKzt3d3U9SfKtDWpzhqFqF1Ntj0SXQLRjZ2E1z3/Qrf4DcSM2dAnGrnla8wvzMX8fzdhfuNl5G8/I00eNCzdDq1ppjqdCNCj+79nIGoActVizCmfOChK95AlRXAgCzHYtmaqUwkh0E2/G92EqU6IzDVckjj0ej19+2rZ1d/fn/DwcIxGI5mZmSQkJACQkJBAZqY2AzMzM5NRo0bh4+NDt27dCA0NJSsri+LiYioqKoiJiUEIwdixYy3X2EK4u8YB2tIjbhpZJXf+gvzmM21pkEFnWY6L+DGIK26GXzKQa15r+h6pn0PFCXQXts/aRkNEx87oRozH6/ZH0C1+S2tuGRCHzNyMedl88q87j5pn/g/zeysw/5iOLMxrH30jrWymOp3w74junnlw1ijk+6swf/xfj32f5I6fAFqUONoDlw8xys/PJzs7m6ioKEpLS9HrtbZ+vV7PsWPHAG2CYXR0tOWaoKAgjEYjXl5eVkOAg4ODMRqNDZaTkpJCSkoKAAsXLtTOP2MAOjcPfyuLGUD5zl8IDuhi94gKb29vDAZDi8o1lxZT9MZLeEX2IfiWOfXWE5LXzKCsoowTn3+Af2RvOl18df17VJRT+M3n+MaPRn9W/eUV7NGaZ3G78AiYdDGy2oRpx0+c3LWDqv/9RvWWjfDNZ0hApw/GO2YgPmcMwidmID5RZza8Qmobc+rfS+nOTKo6dcEwZoJNo4ZsJR95QnEsaAAAFX1JREFUluP/WUTFVx/hZ6oi4LYHEF6O/VXk7H9fxf/bzsmQUAxDznb6boht8f+KSxNHZWUlixYtYvr06XTs2PiGRo19CrHn00liYiKJiYl/HfDzp8h0EuHmFVllcHcw11D4268IO5cVNxgMFLYgfikl5uUL4Hgpursep+j4cTh+vP55F10DR3Ioe/0lTvh2qPdJ07z+I2TZMU6e/48WxXGqlj5Lm9MrBsPZo6goLERXUwOH9yP3/onc9ydV+/5H1Q/p2nk6HeKcBMT0u9v0qrt1fy+yuhrzD+mIoSMpKnX8JD45LQnh24HKz9+jsqgA3S3/59Chqc789yVNVZi3/4gYnUhRUZFTyjiVO/+vhIU1vNCnyxLHyZMnWbRoEeeeey7nnKPtxRsYGEhxcTF6vZ7i4mLL4onBwcFWfyFGo5GgoKB6x4uKiggKsnFkQkj3trFPcqTWZCcPZdudOFpKbtkI27YirkhC1HbQN0TovNDNmI15STHmVUvQBegRMQO1e1RVaUNwBwxF9GnlTnvtlPDygp79ED37wfgpAMjjxyD7T+RvPyG//UrbD+bqW9wcqQ0c3Ex1OiEE4pJrMXcJ0JZlX/YEurse94yVdf+3A0ymBhc1/LtwSR+HlJJXX32V8PBwpk79q0MoPj6etLQ0ANLS0hg2bJjleEZGBtXV1eTn53P06FGioqLQ6/X4+/uze/dupJSkp6cTH2/jEFt3LTVyupBQ8OvgsomAMu8I8r0V0H8wIvGSZs8Xvn7o7pgLhm6Yk59GHj2k3Wfzeq3GMvUqZ4fcroguAYjBw9Bddxsi8WLkN59h/uZzd4fVLEeMprKFbsJUxM2zYfdOzMuf8YjZ+nJ7pvZ/+IxYd4fiNi6pcfz555+kp6fTs2dP7r//fkDbHOrSSy9lyZIlpKamYjAYmDNnDgCRkZGMHDmSOXPmoNPpmDFjBrra8fMzZ85k+fLlmEwm4uLiGDrUtmGtbaJjHLR5ABG9XdJBLk+exLxqMXh7o0u61+Y5CKJzALq752Fe+ADmpfPR/d/TyPVr4YxYj914pi0QVyRpHefvr0QauiGGtM1PrKfu9OeKXf10I8ZhPlmN/O9LmP/9rDb4oI1uRWuZLT4gzqH9Pp5GSE8d1mCnnLf+02aGv5nfWo78cTO6pe/Y1Xxmb1un+ZO3kZ+/j7j1AXTD7G9ykPv3YH5hLui8oKJcm+fRyP7J9mo3fRzY9yyyqhLz849oQ6IfWOCy5kpbGQwGCr75CvPLT2pLo7twsp550xfId/6tjfK75b5W9QU569+XPLgX85OzEdPvRjc6sfkLHKAt9nH8babBtqn1lCL7QkU5FOU7rQiZtQv5xRrEyPEtShoAonc0ulkPQFUF9OsP/Z3bbPF3IPw6oLvrMegcgPmlp5DGtrcAoKuaqU6nG38hYloS8qctyNdfanZOkTtYZou3k9nvLfW3SRxtpo8D/tq+1kn9HLLihNZEFWTQVuRsBREbj+7h59Hd9nDbGFzQDohAPbq754GpUtvgp+KEu0OykNUmh036awndpH8gLr4W+X2qtuRLG2sQkTsytaVnAjxzVVtH+Rsljm7ujuAvEb1BCKftQS7fWwFFBehmzkH4Nz7s2VaidzTCQ5d/bqtEeE90/3wIcnMwv/os8uRJd4cEgGlbplNHU9lCTL0KccHlyLT1yA9eazPJQ5YYYf+eNts35Up/m8RhyxpMriL8OkC3MKd0kMsdmciMbxCTpyGiVEd2WyYGxCGuuw3++BX57r/bxC/Iyoxv3NJMdSohBOKyGxETpiJTPuH/27vz+KiqLIHjv/uqErOHbARMooCEABqFMSwuLHHEnkG05aNgAy4EaEWQKIgYuyMwOky7TAztfJIBlXb8gGLbGGinWwcHRBZZOkgUWSUJOEQkIRskJEVSeXf+KKhGMUglRV4lOd8/i9Tznjomp959996j17xj2VjOp7/u3LvFz+ebSxc6ARXfA/1toVevqc84MN9dCt0TUHfJstn2wBh2B+aJ4+iPV0FMN0ubYunGRs78bbNl01TnU0rB/dOgsQH90fuY/v6WH3Ojd+dDZLRrxqCTk8JhlYSe8MXn6LrTqKBgr1xS/+WPUFGG8fS/Wf6LLy6duucBKC9Ff/A2OqYb6sZbrBnIvi/RdacxLJymOp8yDHjgMWg4g16zAtP/CoxRF+5F0mYTnKqGynKoqkBXnaDWZkN3jYNrklABrZ+u1Y0NsO9L1M3/KM/6kMJhGZXQ09Wbo+QInN2d3Rr6u2/R/7vG1f+7z8XbWArfogwD0p5AV5W7dux3iUJd07fNx6F3bnH1ZLFwmurHlGGDtCdde0veX4ZZeQJsNqgsR1eVu4rFyUpXx8bznP77BSChJyqxv2sPUu/+LXted+BraDgj01RnSeGwyrmjR0oOu4/1aCltmpgrciEwCHVvmjdGJ9qY8vPHmPFbzN/NxcxZhPHcYlRE1M+/0Ut0zSn0VzsIuGkkjT52t6psNoxfP4W5xOnqBWO3u9oTRES7fncioiAiBhUZ7X49KjaWivyt6MJ9rk6Om9ei1/+364Jdu7ue//Xu5yrQEdEQEHjROwm9+2/gfwX07by7xc8nhcMqXSIhJNQrS3L15+ugcL/rAL3QMC8MTlhBhYZhzHoOc9FTmK+/gvHUv7bJDmq9/yvMP2RDQwOBo36JLx76oex+rqNw6mohMPhnT0EwgoJR1w50N0zTzkb4v+KzhWS/63nF1vW4lyPY7BAS5vqdDAlz9c4JDYOQcAgJQ3+54+xucd9ZZGMlKRwWUUpBQq9WL8nVNSfRH7wNif1RN93mpdEJq6juCagHZ6LfzEKvWY667/LdQWpnI/rP77q6G8ZeiTHrOfz7JoOP7uhXSsEltje+4L12P1e3vl5JcMdY1wq249+hjxyCmmqoPQW1Neiak1B7Cv3dEddrp2vh7Go3dePNXoymfZPCYSEV3wO94SN0U1OL25DqP70FjjqMSTM6Xz/sDsoYMgKzcD967Wp0736oAUO9/t/QpcdcLYS/LUQN/wVq/NR20S/EW5RS0D0e1T3+oj+nzSY4fRocdda3nvYh8pfGSgm9wNkIpd+16O364NfobZ+i7hjbodu4dkZq/FS4ujfmH36PPnHca9fVWmN+vh7zhSfhxHGMxzIwHpzZqYqGJ5Rhc51wHNNNVlOdRwqHhVRCD4AWTVfpxkbMFf8J0bGoO2XPRkej/Pwwpj8DSmEuedG1HLSVdF0t+vVX0P/1e+iRiLHgNdQ/yPSL8JwUDit1i3c9lGtJ4fhkNRwvwZj4aPtofiM8pqJjMabMdj3Ufe+NVl1LH9qH+S9PoAu2ocY+iDHnedcqJCFaQJ5xWEjZ/eDKBI+PHtFl36P/+j7ceDMq+RIbWYl2Sd0wCPXP96I//gCzd3+Mm1I9er92NqL/+ifX/y/RXTGeeUk6OIpWk8JhMRXf09VWtKIMFfXzBzFqrTHfWQI2G8b97aAFqWg19csHXH3MV+Sir7rmkp5nadNE529G//kdOHEcddNtqImPeGUXtRAyVWUxNXAo1J7CzJhG0yu/wdz8CbrudLM/r3d+DvsKUPc80KYbxIR1XBvg5kJAIOaS36EdFz+GXe8rwFw0B/1mFlwRgPHEAowpT0rREF7TaToAHjt2zOohNEufOI7e8Rl622dQdgz8/FE3DEYNTYVrB7o3gUUGBnBi5v0QHonxm39v8RJeX9BZOwC2hj74NWbWc6iUW1C/nnvBKh/9bSHmB2/D/q8gqivqnkmowSM8WqbdUfLSUeIA3+wAKFNVPkDFdEON+RX6zvvh8Dfo7Z+5phl2boHQcNSgYaihqdQWbIVT1RgzM9t10RAto5KSUfdMQq9e7trwmXoncPaZ15oV6PzNEBKKun8qasToTt0TW1xeUjh8iFLKvbtVj58Ke3eht21Ab1qL/vQv1AMq9U5Uz0Srhyosov7pXldb4D8uQ0d1Re/Zhd70P2CzoUaPR/1irNdOWxaiOVI4fJSy2+GGwagbBrvW33+xlYDS7zgz2tqeBMJayjAwps7GfGE25n+8AIaBGnYHasyvUF0irR6e6CSkcLQDKigENewOwjrQvK1oORUcijHzt+jNn6BuuxPV7eLHZgjhbVI4hGiHVEJP1MRHrR6G6KRkOa4QQgiPSOEQQgjhESkcQgghPCKFQwghhEekcAghhPCIFA4hhBAekcIhhBDCI1I4hBBCeKTTnI4rhBDCOzrFHUdGRobVQ/CKjhIHSCy+qqPE0lHiAN+MpVMUDiGEEN4jhUMIIYRHbAsXLlxo9SDaQq9evawegld0lDhAYvFVHSWWjhIH+F4s8nBcCCGER2SqSgghhEekcAghhPBIu2zklJuby65duwgPDycrKwuAI0eO8MYbb+BwOIiJiSE9PZ2goCCcTidLlizh8OHDmKbJ8OHDGTt2LADFxcXk5OTQ0NDAwIEDSUtLc/X9boexLFy4kKqqKvz9/QHIzMwkPDzcp2N5/fXXKSoqwjAMJk+ezLXXXgtYnxdvxeELOSkvLycnJ4fq6mqUUtx+++2MHj2a2tpasrOzOXHiBDExMcyePZuQkBAAVq9ezaeffophGKSlpTFgwADA2rx4Mw6r8+JpLDU1Nbz66qsUFhYycuRIpk6d6r6WZTnR7dDevXt1UVGRnjNnjvu1jIwMvXfvXq211uvXr9crV67UWmu9efNmnZ2drbXW2uFw6BkzZujS0lL3ew4ePKhN09SLFi3Su3btauNIvBfLggULdGFhYRuP/oc8ieXjjz/WOTk5Wmutq6ur9bx583RTU5P7PVbmxVtx+EJOKisrdVFRkdZa67q6Op2enq6PHj2qly9frlevXq211nr16tV6+fLlWmutjx49qufOnasbGhp0aWmpfvzxx30iL96Mw+q8eBpLfX293r9/v167dq1+8803f3Atq3LSLqeq+vfv7/5Wcc6xY8fo168fANdffz07duxw/5vD4aCpqYmGhgbsdjtBQUFUVVVRX19Pnz59UEoxfPhw8vPz2zQO8E4svsKTWEpKSrjuuusACA8PJzg4mOLiYp/Iizfi8BURERHuFTmBgYHExcVRWVlJfn4+I0aMAGDEiBHuzzg/P5+bb74ZPz8/unbtSrdu3SgsLLQ8L96Kwxd4GktAQAB9+/Z13yGdY2VO2mXh+CkJCQns3LkTgO3bt1NRUQHA0KFDCQgI4JFHHmHGjBncddddhISEUFlZSVRUlPv9UVFRVFZWWjL2H/M0lnNyc3N5+umnWbVqFdpHFss1F0uPHj3YuXMnTU1NlJWVUVxcTHl5uc/mxdM4zvGlnJSVlXH48GF69+7NyZMniYiIAFx/yE6dOgVwwecfGRlJZWWlT+WlNXGc4yt5uZRYmmNlTtrlM46f8thjj/HWW2+xatUqUlJSsNtdoRUWFmIYBkuXLuX06dPMnz+f5ORky3+JL8bTWGJjY0lPTycyMpL6+nqysrLYtGmT+9uLlZqLJTU1lZKSEjIyMoiJiSEpKQmbzeazefE0DsCncuJwOMjKymLy5MkXvUtt7vP3lby0Ng7wnbxcaizNsTInHaZwxMXFkZmZCbimFXbt2gXAli1bGDBgAHa7nfDwcJKSkigqKqJfv37ub40AFRUVREZGWjL2H/M0ltjYWPfYAwMDufXWWyksLPSJwtFcLDabjcmTJ7t/LjMzk+7duxMcHOyTefE0DsBncuJ0OsnKymLYsGEMGTIEcE2rVVVVERERQVVVFWFhYYDrW+v5n39lZSWRkZEXvG5FXrwRB/hGXjyJpTlW5qTDTFWdPHkSANM0ycvLY9SoUQBER0ezZ88etNY4HA4OHTpEXFwcERERBAYG8s0336C1ZtOmTaSkpFgZgpunsTQ1Nblva51OJ1988QUJCQmWjf98zcVy5swZHA4HALt378ZmsxEfH++zefE0Dl/JidaaJUuWEBcXx5gxY9yvp6SksHHjRgA2btzIoEGD3K9v3bqVxsZGysrK+P777+ndu7flefFWHL6QF09jaY6VOWmXO8cXL17Mvn37qKmpITw8nPHjx+NwOFi7di0AgwcPZuLEiSilcDgc5ObmUlJSgtaa1NRU7r77bgCKiorIzc2loaGBAQMGMGXKlDZfjuuNWBwOBwsWLKCpqQnTNElOTubhhx/GMNr2e4EnsZSVlbFo0SIMwyAyMpLp06cTExMDWJ8Xb8ThKzk5cOAA8+fP56qrrnJ/hhMmTCAxMZHs7GzKy8uJjo5mzpw57udleXl5bNiwwb28eODAgYC1efFWHL6Ql5bEMnPmTOrq6nA6nQQHB5OZmUl8fLxlOWmXhUMIIYR1OsxUlRBCiLYhhUMIIYRHpHAIIYTwiBQOIYQQHpHCIYQQwiNSOIQQQnhECocQLfTaa6+Rm5v7g9f27dvHlClTqKqqsmhUQlx+UjiEaKG0tDQKCgrYvXs3AA0NDSxdupSHHnrIfVidN5im6bVrCeENHeasKiHaWmhoKFOmTGHp0qVkZWWRl5dHbGwsI0eOxDRN1qxZw4YNG6irqyM5OZlp06YREhKCaZpkZ2dz4MABGhsb6dGjB9OmTSM+Ph5w3ckEBQVRWlrKgQMHyMjIwOFwsGLFCioqKggKCmLMmDE/OK5CiLYkO8eFaKWsrCycTicHDx7k5ZdfJjo6mg8//JD8/Hx3F7dly5bhdDqZNWsWpmmyadMmhgwZgs1mY/ny5Rw6dIgXX3wRcBWOgoICnn32Wff5StOnT2fevHkkJSVRW1tLWVmZu6eDEG1NpqqEaKWpU6eyZ88e7rvvPqKjowFYt24dEyZMIDIyEn9/f8aNG8e2bdswTRPDMBg5ciSBgYHufysuLnYflggwaNAg+vTpg2EY+Pn5YbfbKSkpob6+npCQECkawlIyVSVEK3Xp0oWwsDD3VBO4+kq/9NJLPzhwTinFqVOnCAsL491332X79u3U1NS4f6ampoaAgAAAdwE6Z+7cueTl5bFixQquvvpqJk2aRGJiYhtEJ8SFpHAIcRlERUWRnp7+k3/cN2zYQEFBAfPnzycmJoaamhqmTZt20cY8iYmJPPPMMzidTj766CMWL15MTk7O5QxBiGbJVJUQl8GoUaNYuXKlu43syZMn3a1n6+vrsdvthIaGcubMGd57772LXquhoYEtW7ZQV1eH3W4nMDCwzY9nF+J8cschxGVwbsXT888/T3V1NeHh4dxyyy2kpKSQmprK7t27efTRRwkNDWXcuHGsW7fuotfbuHEjy5YtwzRNrrzySmbNmtUWYQjxk2RVlRBCCI/I/a4QQgiPSOEQQgjhESkcQgghPCKFQwghhEekcAghhPCIFA4hhBAekcIhhBDCI1I4hBBCeOT/AdkpSb4+GNbRAAAAAElFTkSuQmCC\n",
"text/plain": [
"<Figure size 432x288 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"haiti.plot(kind='line')\n",
"\n",
"plt.title('Immigration from Haiti')\n",
"plt.ylabel('Number of Immigrants')\n",
"plt.xlabel('Years')\n",
"\n",
"# annotate the 2010 Earthquake. \n",
"# syntax: plt.text(x, y, label)\n",
"plt.text(2000, 6000, '2010 Earthquake') # see note below\n",
"\n",
"plt.show() "
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"With just a few lines of code, you were able to quickly identify and visualize the spike in immigration!\n",
"\n",
"Quick note on x and y values in `plt.text(x, y, label)`:\n",
" \n",
" Since the x-axis (years) is type 'integer', we specified x as a year. The y axis (number of immigrants) is type 'integer', so we can just specify the value y = 6000.\n",
" \n",
"```python\n",
" plt.text(2000, 6000, '2010 Earthquake') # years stored as type int\n",
"```\n",
" If the years were stored as type 'string', we would need to specify x as the index position of the year. Eg 20th index is year 2000 since it is the 20th year with a base year of 1980.\n",
"```python\n",
" plt.text(20, 6000, '2010 Earthquake') # years stored as type int\n",
"```\n",
" We will cover advanced annotation methods in later modules."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"We can easily add more countries to line plot to make meaningful comparisons immigration from different countries. \n",
"\n",
"**Question:** Let's compare the number of immigrants from India and China from 1980 to 2013.\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 1: Get the data set for China and India, and display dataframe."
]
},
{
"cell_type": "code",
"execution_count": 100,
"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>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>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>India</th>\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>10189</td>\n",
" <td>11522</td>\n",
" <td>10343</td>\n",
" <td>...</td>\n",
" <td>28235</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",
" </tr>\n",
" <tr>\n",
" <th>China</th>\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>2643</td>\n",
" <td>2758</td>\n",
" <td>4323</td>\n",
" <td>...</td>\n",
" <td>36619</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",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"<p>2 rows × 34 columns</p>\n",
"</div>"
],
"text/plain": [
" 1980 1981 1982 1983 1984 1985 1986 1987 1988 1989 ... \\\n",
"India 8880 8670 8147 7338 5704 4211 7150 10189 11522 10343 ... \n",
"China 5123 6682 3308 1863 1527 1816 1960 2643 2758 4323 ... \n",
"\n",
" 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 \n",
"India 28235 36210 33848 28742 28261 29456 34235 27509 30933 33087 \n",
"China 36619 42584 33518 27642 30037 29622 30391 28502 33024 34129 \n",
"\n",
"[2 rows x 34 columns]"
]
},
"execution_count": 100,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"### \n",
"df_CI = df_can.loc[['India', 'China'], years]\n",
"df_CI.head()"
]
},
{
"cell_type": "code",
"execution_count": 101,
"metadata": {},
"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>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>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>India</th>\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>10189</td>\n",
" <td>11522</td>\n",
" <td>10343</td>\n",
" <td>...</td>\n",
" <td>28235</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",
" </tr>\n",
" <tr>\n",
" <th>China</th>\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>2643</td>\n",
" <td>2758</td>\n",
" <td>4323</td>\n",
" <td>...</td>\n",
" <td>36619</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",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"<p>2 rows × 34 columns</p>\n",
"</div>"
],
"text/plain": [
" 1980 1981 1982 1983 1984 1985 1986 1987 1988 1989 ... \\\n",
"India 8880 8670 8147 7338 5704 4211 7150 10189 11522 10343 ... \n",
"China 5123 6682 3308 1863 1527 1816 1960 2643 2758 4323 ... \n",
"\n",
" 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 \n",
"India 28235 36210 33848 28742 28261 29456 34235 27509 30933 33087 \n",
"China 36619 42584 33518 27642 30037 29622 30391 28502 33024 34129 \n",
"\n",
"[2 rows x 34 columns]"
]
},
"execution_count": 101,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_CI = df_can.loc[['India', 'China'], years]\n",
"df_CI.head()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Step 2: Plot graph. We will explicitly specify line plot by passing in `kind` parameter to `plot()`."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"That doesn't look right...\n",
"\n",
"Recall that *pandas* plots the indices on the x-axis and the columns as individual lines on the y-axis. Since `df_CI` is a dataframe with the `country` as the index and `years` as the columns, we must first transpose the dataframe using `transpose()` method to swap the row and columns."
]
},
{
"cell_type": "code",
"execution_count": 102,
"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></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": [
" India China\n",
"1980 8880 5123\n",
"1981 8670 6682\n",
"1982 8147 3308\n",
"1983 7338 1863\n",
"1984 5704 1527"
]
},
"execution_count": 102,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_CI = df_CI.transpose()\n",
"df_CI.head()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"*pandas* will auomatically graph the two countries on the same graph. Go ahead and plot the new transposed dataframe. Make sure to add a title to the plot and label the axes."
]
},
{
"cell_type": "code",
"execution_count": 103,
"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 432x288 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"### type your answer here\n",
"df_CI.index = df_CI.index.map(int)\n",
"df_CI.plot(kind='line')\n",
"plt.title('Immigrants from China and India')\n",
"plt.ylabel('Number of Immigrants')\n",
"plt.xlabel('Years')\n",
"plt.show()"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"From the above plot, we can observe that the China and India have very similar immigration trends through the years. "
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"*Note*: How come we didn't need to transpose Haiti's dataframe before plotting (like we did for df_CI)?\n",
"\n",
"That's because `haiti` is a series as opposed to a dataframe, and has the years as its indices as shown below. \n",
"```python\n",
"print(type(haiti))\n",
"print(haiti.head(5))\n",
"```\n",
">class 'pandas.core.series.Series' <br>\n",
">1980 1666 <br>\n",
">1981 3692 <br>\n",
">1982 3498 <br>\n",
">1983 2860 <br>\n",
">1984 1418 <br>\n",
">Name: Haiti, dtype: int64 <br>"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Line plot is a handy tool to display several dependent variables against one independent variable. However, it is recommended that no more than 5-10 lines on a single graph; any more than that and it becomes difficult to interpret."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"**Question:** Compare the trend of top 5 countries that contributed the most to immigration to Canada."
]
},
{
"cell_type": "code",
"execution_count": 104,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
" India China United Kingdom of Great Britain and Northern Ireland \\\n",
"1980 8880 5123 22045 \n",
"1981 8670 6682 24796 \n",
"1982 8147 3308 20620 \n",
"1983 7338 1863 10015 \n",
"1984 5704 1527 10170 \n",
"1985 4211 1816 9564 \n",
"1986 7150 1960 9470 \n",
"1987 10189 2643 21337 \n",
"1988 11522 2758 27359 \n",
"1989 10343 4323 23795 \n",
"1990 12041 8076 31668 \n",
"1991 13734 14255 23380 \n",
"1992 13673 10846 34123 \n",
"1993 21496 9817 33720 \n",
"1994 18620 13128 39231 \n",
"1995 18489 14398 30145 \n",
"1996 23859 19415 29322 \n",
"1997 22268 20475 22965 \n",
"1998 17241 21049 10367 \n",
"1999 18974 30069 7045 \n",
"2000 28572 35529 8840 \n",
"2001 31223 36434 11728 \n",
"2002 31889 31961 8046 \n",
"2003 27155 36439 6797 \n",
"2004 28235 36619 7533 \n",
"2005 36210 42584 7258 \n",
"2006 33848 33518 7140 \n",
"2007 28742 27642 8216 \n",
"2008 28261 30037 8979 \n",
"2009 29456 29622 8876 \n",
"2010 34235 30391 8724 \n",
"2011 27509 28502 6204 \n",
"2012 30933 33024 6195 \n",
"2013 33087 34129 5827 \n",
"\n",
" Philippines Pakistan \n",
"1980 6051 978 \n",
"1981 5921 972 \n",
"1982 5249 1201 \n",
"1983 4562 900 \n",
"1984 3801 668 \n",
"1985 3150 514 \n",
"1986 4166 691 \n",
"1987 7360 1072 \n",
"1988 8639 1334 \n",
"1989 11865 2261 \n",
"1990 12509 2470 \n",
"1991 12718 3079 \n",
"1992 13670 4071 \n",
"1993 20479 4777 \n",
"1994 19532 4666 \n",
"1995 15864 4994 \n",
"1996 13692 9125 \n",
"1997 11549 13073 \n",
"1998 8735 9068 \n",
"1999 9734 9979 \n",
"2000 10763 15400 \n",
"2001 13836 16708 \n",
"2002 11707 15110 \n",
"2003 12758 13205 \n",
"2004 14004 13399 \n",
"2005 18139 14314 \n",
"2006 18400 13127 \n",
"2007 19837 10124 \n",
"2008 24887 8994 \n",
"2009 28573 7217 \n",
"2010 38617 6811 \n",
"2011 36765 7468 \n",
"2012 34315 11227 \n",
"2013 29544 12603 \n"
]
},
{
"data": {
"image/png": "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li3DwsLCLO5z584xffp0dDod9erVY+7cuRw/fpwlS5ag0Wg4dOgQq1evNm1/9epVTp06xeLFi01fil1cXHjttdcATK9LDw8Pzp8/z59//snvv//O0qVLTQn+p59+ikajYfr06Zw+fRqdTke/fv146623+P7770lISOC5557DycnJrO77ZWZmYmNjY0rYGjduzPjx49mzZw8ffPABs2fP5v3332fTpk3odDqCg4Np2rQpixYtYsyYMcTFxZGdnc3YsWN56aWXgLstGlu2bCEjI4OXXnoJf39/jh07hqenJ0uXLs2X4G3fvp2FCxeSk5ODk5MTixYtws3Njblz5xIbG8v169eJjY3llVdeYezYsQAsWLCA1atX4+XlhYuLC61atSrw+F544QVWrlzJP/7xD5yczO+Cfvvtt6xYsQKAYcOGMW7cOKKjoxkxYgQdO3bk+PHjtGjRwuy433nnHQwGA9OmTct3TFevXmXGjBkkJydjY2PDF198gY+PD5MnT6ZmzZqcO3eOli1bYm9vX+hxFSQ6OpqXXnqJTp06cfz4cZYuXUpkZCRz5swhJyeHevXqMX/+fOzszJ/TUtBrI+/6PPfcc+zYsQO9Xs+3336Lj4/PA71XhRCiNOLScjgel8GwVq5oi5gOvSCuthbUdbTkRHwGzzZ3KacIhaiaKuwWanJyMidOnKBHjx6mZUePHqVr164AdO3a1dQ17ejRo3Tq1AkLCwvc3d3x9PTk8uXLpKSkkJWVRZMmTVCpVHTp0sW0z7FjxwgMDAQwdUN72C8c505kErb7Tpn+O3fi4We70ev1bNq0iQ8//JB58+aZratTpw4jRoxg3Lhx7Nixg4CAAD744APGjRvH5s2b+e6770xf3ObPn4+/vz/bt2+nZ8+epmSrIGPGjOGjjz7C39+/0G0SEhJYt24dP/zwA59++ilwN4GOiYlh165dzJkzh+PHjwOg0+mYNm0ay5YtY+3atSQmJprKmTt3Lr6+vuzcuZPp06czadIk07pr167x448/snTpUv75z3/SqVMndu3ahbW1Nbt27coX0+TJk5kxYwY7d+6kWbNmzJs3jx49epjO0f3JTEREBM2bNy+ydeHUqVO88847/Pnnn1y6dIn169ezbt06duzYgUajYc2aNQC88847bNmyhZ07d3Lo0CEuXLjA2LFj8fDwYNWqVYUmUq+//jpB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Jc/zlE6n5bquotGoBgcHlUwmddttt8myLN17773q6OiY1+eByeaitig9s6lrT0+PPv/5z0uSampqVFFRoe7ubnq2RM1FbVF66urq8h9Qj0Qiam5u1sDAgDo6OnTfffdJku677758D3Z0dGjjxo0KhUK64YYbdOONN6qzs5O+LTFzVVeUltnWNRwO6/bbb8/PKl5Dv84sUGFqKkuXLtWpU6ckSW+++ab6+/slSV/84hcVDof1/e9/X48++qgeeOABVVZWamBgQA0NDfn7NzQ0aGBgoChjx8xmW9tr2tvb9ZOf/EQvv/yyDOuvlJzp6rp8+XKdOnVKnuepr69P3d3disfj9OwCMtvaXkPPlqa+vj5duHBBK1eu1OXLl1VXVycp9wLuypUrkjSpP+vr6zUwMEDflrD/pK7X0LOl59+p63To15kF6jNTU/nhD3+o559/Xi+//LJaWlrkurmn3NnZKdu2dfDgQV29elV79+7V2rVrafoFZLa1bWpq0q5du1RfX69kMqnW1ladPHky/+4MSsN0dd28ebN6enq0e/duNTY2avXq1XIch55dQGZbW0n0bIlKpVJqbW3Vtm3bZpz5n64/6dvS9J/WVaJnS9G/W9fp0K8zC3yYam5u1p49eyTlTjE5ffq0JOn111/XunXr5LquampqtHr1anV1dWnNmjX5d0slqb+/X/X19UUZO2Y229o2NTXlaxmJRPTlL39ZnZ2d/CNfYqarq+M42rZtW/64PXv26KabblJFRQU9u0DMtraS6NkSlM1m1draqnvuuUd33323pNzpmYODg6qrq9Pg4KCqq6sl5d7BHt+fAwMDqq+vn7Sfvi2+uairRM+WmtnUdTr068wCf5rf5cuXJUm+7+vIkSO6//77JUmxWEzvvPOOjDFKpVI6f/68mpubVVdXp0gkog8//FDGGJ08eVItLS3FfAqYxmxr63lefio7m83qrbfe0tKlS4s2fkxturqOjo4qlUpJks6ePSvHcbRkyRJ6dgGZbW3p2dJjjNFzzz2n5uZmbd26Nb+/paVFJ06ckCSdOHFCd911V37/G2+8oUwmo76+Pl28eFErV66kb0vMXNWVni0ts63rdOjXmQXqS3ufffZZvffee0okEqqpqdG3vvUtpVIpvfbaa5KkL3zhC/r2t78ty7KUSqXU3t6unp4eGWO0efNmfe1rX5MkdXV1qb29Xel0WuvWrdOOHTtY/rHI5qK2qVRKTz/9tDzPk+/7Wrt2rb73ve/JtgP/nkLJmk1d+/r6tH//ftm2rfr6ej3yyCNqbGyURM+WormoLT1bes6dO6e9e/dq2bJl+R576KGHtGrVKrW1tSkejysWi+mJJ57If1b1yJEjOn78eH7Z+/Xr10uib0vJXNWVni0thdT1Rz/6kUZGRpTNZlVRUaE9e/ZoyZIl9OsMAhWmAAAAAGC+8FYBAAAAABSAMAUAAAAABSBMAQAAAEABCFMAAAAAUADCFAAAAAAUgDAFAAAAAAUgTAEAAuM3v/mN2tvbJ+x77733tGPHDg0ODhZpVACAoCJMAQACY/v27Tpz5ozOnj0rSUqn0zp48KC++93vqq6ubs5+j+/7c/ZYAICFyy32AAAAmCtVVVXasWOHDh48qNbWVh05ckRNTU3atGmTfN/XH//4Rx0/flwjIyNau3atdu7cqcrKSvm+r7a2Np07d06ZTEbLly/Xzp07tWTJEkm5Ga9oNKre3l6dO3dOu3fvViqV0gsvvKD+/n5Fo1Ft3bpVW7duLfJfAAAwnyxjjCn2IAAAmEutra3KZrP64IMP9Ktf/UqxWEyvvPKKOjo69Pjjj6uyslKHDh1SNpvVY489Jt/3dfLkSd19991yHEeHDx/W+fPn9cwzz0jKhakzZ87oZz/7mVauXCnP8/TII4/oqaee0urVqzU8PKy+vj6tWLGiyM8cADCfOM0PABA4Dz/8sN555x1985vfVCwWkyQdO3ZMDz30kOrr61VWVqYHH3xQf//73+X7vmzb1qZNmxSJRPK3dXd3K5VK5R/zrrvu0m233SbbthUKheS6rnp6epRMJlVZWUmQAoBFiNP8AACBU1tbq+rq6vxpepIUj8f1y1/+UpZl5fdZlqUrV66ourpaL774ot58800lEon8MYlEQuFwWJLyoeyaJ598UkeOHNELL7ygW265Rd/5zne0atWqeXh2AIBSQZgCACwKDQ0N2rVr15SB5/jx4zpz5oz27t2rxsZGJRIJ7dy5UzOdCb9q1Sr99Kc/VTab1auvvqpnn31WBw4c+CyfAgCgxHCaHwBgUbj//vv10ksvKR6PS5IuX76sU6dOSZKSyaRc11VVVZVGR0f1hz/8YcbHSqfTev311zUyMiLXdRWJRGTb/C8VABYbZqYAAIvCtZX2fvGLX2hoaEg1NTX60pe+pJaWFm3evFlnz57VD37wA1VVVenBBx/UsWPHZny8EydO6NChQ/J9XzfffLMee+yx+XgaAIASwmp+AAAAAFAAzkkAAAAAgAIQpgAAAACgAIQpAAAAACgAYQoAAAAACkCYAgAAAIACEKYAAAAAoACEKQAAAAAoAGEKAAAAAApAmAIAAACAAvw/O2ySEyz83EUAAAAASUVORK5CYII=\n",
"text/plain": [
"<Figure size 1008x576 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"### type your answer here\n",
"\n",
"df_can.sort_values(by='Total', ascending=False, axis=0, inplace=True)\n",
"\n",
"# get the top 5 entries\n",
"df_top5 = df_can.head(5)\n",
"\n",
"# transpose the dataframe\n",
"df_top5 = df_top5[years].transpose() \n",
"\n",
"\n",
"print(df_top5)\n",
"\n",
"\n",
"\n",
"df_top5.index = df_top5.index.map(int) # let's change the index values of df_top5 to type integer for plotting\n",
"df_top5.plot(kind='line', figsize=(14, 8)) # pass a tuple (x, y) size\n",
"\n",
"\n",
"\n",
"plt.title('Immigration Trend of Top 5 Countries')\n",
"plt.ylabel('Number of Immigrants')\n",
"plt.xlabel('Years')\n",
"\n",
"\n",
"\n",
"plt.show()\n",
"\n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"### Other Plots\n",
"\n",
"Congratulations! you have learned how to wrangle data with python and create a line plot with Matplotlib. There are many other plotting styles available other than the default Line plot, all of which can be accessed by passing `kind` keyword to `plot()`. The full list of available plots are as follows:\n",
"\n",
"* `bar` for vertical bar plots\n",
"* `barh` for horizontal bar plots\n",
"* `hist` for histogram\n",
"* `box` for boxplot\n",
"* `kde` or `density` for density plots\n",
"* `area` for area plots\n",
"* `pie` for pie plots\n",
"* `scatter` for scatter plots\n",
"* `hexbin` for hexbin plot"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"### Thank you for completing this lab!\n",
"\n",
"This notebook was originally 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 revised 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,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"This notebook is part of a course on **Coursera** called *Data Visualization with Python*. If you accessed this notebook outside the course, you can take this course online by clicking [here](http://cocl.us/DV0101EN_Coursera_Week1_LAB1)."
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": 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