Skip to content

Instantly share code, notes, and snippets.

@grahamhindle

grahamhindle/DV0101EN-Exercise-Introduction-to-Matplotlib-and-Line-Plots-py.ipynb

Created November 9, 2019 17:53
Show Gist options
  • Save grahamhindle/3f05b3415ae9af5788e6b14ff840b54a to your computer and use it in GitHub Desktop.
Save grahamhindle/3f05b3415ae9af5788e6b14ff840b54a 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-Exercise-Introduction-to-Matplotlib-and-Line-Plots-py.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>"
]
},
{
"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 [**Python Basics for Data Science**](https://www.edx.org/course/python-basics-for-data-science-2) and [**Analyzing Data with Python**](https://www.edx.org/course/data-analysis-with-python).\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 [**Analyzing Data with Python**](https://www.edx.org/course/data-analysis-with-python).\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/coursera/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": 20,
"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": "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": 21,
"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": 22,
"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": 22,
"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": 23,
"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": 23,
"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": 24,
"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": 25,
"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": 25,
"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": 26,
"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": 26,
"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": 27,
"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": 28,
"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": 29,
"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": 29,
"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": 30,
"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": 30,
"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": 31,
"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": 31,
"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": 32,
"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": 33,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [
{
"data": {
"text/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": 33,
"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": 34,
"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": 34,
"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": 35,
"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": 35,
"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": 36,
"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>...</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>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": 36,
"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": 37,
"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": 38,
"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": 38,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"df_can.head(3)"
]
},
{
"cell_type": "code",
"execution_count": 39,
"metadata": {
"button": false,
"deletable": true,
"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>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",
"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",
"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",
"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": 39,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# optional: to remove the name of the index\n",
"df_can.index.name = None\n",
"df_can.head(3)"
]
},
{
"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": 40,
"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": 41,
"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": 42,
"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",
"1985 198\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, 1985]])\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": 43,
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n",
"<class 'str'>\n"
]
},
{
"data": {
"text/plain": [
"[None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None,\n",
" None]"
]
},
"execution_count": 43,
"metadata": {},
"output_type": "execute_result"
}
],
"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": 44,
"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": 44,
"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": 45,
"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": 46,
"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": 46,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# 2. pass this condition into the dataFrame\n",
"df_can[condition]"
]
},
{
"cell_type": "code",
"execution_count": 47,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"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": 47,
"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": 48,
"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": 48,
"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": 49,
"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": 50,
"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": 51,
"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": 52,
"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": 52,
"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": 53,
"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 0x7f53a3aab940>"
]
},
"execution_count": 53,
"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": 54,
"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": 55,
"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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\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": 56,
"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": "iVBORw0KGgoAAAANSUhEUgAAAZUAAAEaCAYAAADZvco2AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4xLjEsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy8QZhcZAAAgAElEQVR4nOzdd3hUVfrA8e+dSSa9TBohoZOEJBAI0gJiQlOkqIhtQVFYUNRFRVd3UVTW39oLKtUu66qrIIJKB0NRAhjAUENCCC2QnkkvM5k5vz/GjIS0mWQCAc7neXhg7tx7zzk3Yd6595zzHkUIIZAkSZIkO1Bd7gpIkiRJVw8ZVCRJkiS7kUFFkiRJshsZVCRJkiS7kUFFkiRJshsZVCRJkiS7kUFFapZhw4YxY8aMy1qHbdu2oSgKGRkZl6S85557jnbt2qEoCsuWLbskZdrLv/71L0JCQhrd51Jfz9YydepURo0adVnKupRlt1UyqFyhLvcv7/fff8/8+fMvWXkODg51PsiHDBlCZmYmQUFBrV7+nj17eO211/joo4/IzMzknnvuafUyrVVdXc3ChQsZOHAgHh4eeHl50bdvX1555RV0Op3V57mU1/NyUxSFL7/80u7nff/991mxYoXdz3slcbjcFZCuTD4+Pi0+h8FgwMHBAUVRmnW8RqMhMDCwxfWwxvHjx1GpVNx2220N7tPS9jSHwWBg/Pjx7Nq1ixdffJG4uDj8/f05evQoS5cuxc3NjdmzZ1t1rkt5Pa9WXl5el7sKl528U7lK1Ny5LFy4kA4dOuDu7s6MGTMwGAx88MEHdO7cGa1Wy0MPPYRer7ccN2zYMKZPn87zzz9PQEAA3t7ezJ07F5PJxP/93//Rrl07/P39mTt3bq3yLn78VVFRwUMPPYSXlxdarZZHH32UZ599ttYjlwvr2KVLF5ycnCgrK2Pz5s0MGzYMHx8fvLy8iIuL47fffrMc16VLF4xGI9OmTUNRFMuHdn2Pa3bv3k1sbCwuLi5otVomT55MTk6O5f2ax0A//PAD4eHhuLm5MXz4cE6cONHotZ0yZQomk6lW+Q21x2AwMGfOHIKDg9FoNERGRvL111/XOqeiKCxcuJB77rkHNzc3OnXqxHfffUdRURH33nsvHh4edOvWjZUrVzb6c1+wYAGbN29m48aNPP300wwYMIAuXbowduxYfvrpJx544IFa+zfW7ouvZ83rzZs3Exsbi6urK5GRkWzcuLHWOefOnUtERASurq507NiRhx9+mKKiokbr3dTPvOYaLVmyhClTpuDh4UHHjh158803a+2j0+ks17Bdu3Y8//zzNCdJiL3KuvgJwv79+xkzZgwBAQG4u7szYMAANmzYYHP9rihCuiI98MADYuTIkbVee3p6ivvvv18cPXpU/PDDD8LJyUmMGTNGTJkyRRw5ckT89NNPwtnZWSxZssRyXFxcnPD09BT/+Mc/REpKivj0008FIMaMGSOeeeYZkZKSIpYtWyYAsW7dulrHTZ8+3fL6scceEwEBAeKHH34Qx44dE3PmzBGenp6ie/futero4eEhJkyYIH7//Xdx8OBBYTAYxPfffy+WL18uUlJSxOHDh8X06dOFVqsVeXl5QgghcnJyhFqtFu+9957IzMwUmZmZQgghtm7dKgBx9uxZIYQQmZmZwsPDQ0yaNEkcPHhQ/PLLLyIqKkoMHTrUUod58+YJV1dXMXr0aLF3716RlJQkoqOjRWxsbIPXurCwULz33ntCrVbXKr+h9jz99NPCx8fH0qZXXnlFKIoitmzZYjknINq1ayeWLVsmjh8/Lh555BHh4uIibr75ZvH555+L48ePi1mzZglXV1fLdahPnz59av0eNMSadl98PWte9+7dW6xfv16kpqaKKVOmCC8vL6HT6SzH/fvf/xY7duwQJ0+eFFu2bBE9evQQ999/f6P1aepnXnONAgICxEcffSTS0tLE+++/LwARHx9v2WfChAmie/fu4ueffxaHDx8W9957r/Dw8GjymgDiv//9r93Luvj/5datW8WyZcvEkSNHREpKipg7d65wdHQUKSkpjdbvSiaDyhWqvqDi7+8vqqqqLNvGjh0rfH19RWVlpWXbrbfeKu644w7L67i4ONGnT59a546MjBS9evWqta13797i73//e63jaoJKaWmp0Gg04pNPPql1zKBBg+oEFS8vL1FSUtJo24xGo/D29hZffvmlZZtarRaff/55rf0u/hB8/vnnRXBwcK1rkJSUJACxfft2IYT5w1WtVoucnBzLPv/73/+EoiiioqKiwTp9/vnnQq1W19pWX3vKysqERqMRixcvrrXvhAkTxPDhwy2vAfHEE09YXufk5AhAzJo1y7KtoKBAAOKnn35qsF4uLi7isccea/D9Gta0u6GgsnLlSssxmZmZAhAbNmxosKzvv/9eaDQaYTQam6xXjfp+5kCdtvXo0UPMmTNHCCHE8ePHBSA2bdpkeb+qqkoEBQU1K6jYo6yL/1/Wp3fv3uLll19udJ8rmXz8dRWJiIhAo9FYXgcGBtKjRw+cnJxqbbvwcRBAnz59ar0ODAykd+/edbZdfFyNtLQ09Ho9MTExtbYPHjy43jq6u7vX2nby5EmmTJlCSEgInp6eeHp6UlRUxOnTpxtpbV1HjhwhJiam1jXo06cPXl5eHDlyxLItKCgIf39/y+vg4GCEEA22rzEXt6fmWsTGxtbaLy4urlYdaupWw9/fH7VaXeu6a7VaNBpNo/USQljdh9PcdkdHR1v+HRgYiFqtJjs727Lt+++/JzY2lqCgINzd3bn33nvR6/VkZWU1eE5rf+YXll1T55qyjx49CpgHGNTQaDQMGDCg0fZY0057lZWbm8ujjz5KeHg43t7euLu7c+TIEZt/t68ksqP+KuLo6FjrtaIo9W4zmUx2Oe5i1ny4ubm51dk2fvx4/Pz8WLx4MR07dkSj0TB06NBafT/WaqgOF26/MOhc+F5T7atPfe2prx71ffhffI3r29bUde/Ro0edYNWQ5rb74uMuPGbPnj3cddddPPvss7z11ltotVp2797NAw880OjPz9qfeX11rilb2DnBemuUNXXqVM6cOcObb75J165dcXFx4S9/+UuzfrevFPJORWqxkJAQNBoNu3btqrV99+7dTR6bn5/P0aNHmTNnDqNHjyYyMhJnZ+c63541Gg1Go7HRc/Xs2ZNdu3bV+g974MABioqK6Nmzpw0tar6QkBCcnJzYvn17re07duxolTrcd999xMfH17n2NWwZUtwcv/76K35+frz88ssMGjSIsLCwJue5WPszb0rN9UxISLBs0+v1JCYm2t6QViprx44dPProo9x6661ERUXRvn170tPT7V6/tkQGFanF3NzcmDlzJs8//zxr1qwhNTWVuXPnkpyc3OTdi1arxd/fn48//pjU1FR27drFpEmTcHFxqbVf165d2bp1K+fPnycvL6/ec82aNYvi4mKmTp3K4cOH+fXXX5kyZQpDhw7lhhtusFt7G+Pq6srjjz/OCy+8wIoVKzh+/DivvvoqP/zwA88995zdy3viiScYOXIko0eP5u2332bv3r2c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zquq07zdJi2qqNQnKSmJHTt2ALB9+3bn+mCXX345QUFB3H///UybNo1x48YRFhZW72rHFovFK7H/XGNzOW3x4sX87ne/4/3336934U1vaCiXjh07smPHDurq6sjPz+fo0aMUFhZelO3SUC6n+Uq75Ofnc+zYMbp27UppaalzzbyoqCjKysqAs1cBj46OxmKx+Fy7XEgup/lCu7iSR0O83SYt6p5KfX7zm9+wdOlS3n//fZKTkzGZHClnZWWh6zpLliyhsrKSOXPm0K9fP5/5pVufxuYSHx/P9OnTiY6OpqqqigULFpCRkeH8q8ebGspl1KhRZGdnM2vWLGJjY+nRowd+fn4XZbs0lAvgM+1is9lYsGAB99577zmvbhv6+ftSu1xoLuAb7eJqHg3xdpu0+KLSrl07Zs+eDTi6KXbt2gXAl19+Sf/+/TGZTERGRtKjRw+OHDlCr169zlrtODo62iux/1xjc4mPj3fGHhwczBVXXEFWVpZPFJWGcvHz8+Pee+91vm/27Nm0bduW0NDQi65dGsoF8Il2qa2tZcGCBVx55ZUMHToUcHTTFRcXExUVRXFxMREREcDZq4BbLBaio6PrXR3cG+3ijlzA++3SmDwa4u02afHdX6WlpYBju+GVK1dy9dVXA469CPbt24dSCpvNxuHDh2nXrh1RUVEEBwdz6NAhlFJkZGSQnJzszRScGptLXV2d81K5traWnTt3nneRzebSUC7V1dXYbDYA9u7di5+fH+3bt78o26WhXHyhXZRSvPrqq7Rr147rr7/e+XxycjKbNm0CYNOmTQwePNj5/NatW6mpqSE/P5+cnBy6du3qE+3irly83S6NzaMh3m6TFjWjfuHChRw4cIDy8nIiIyO5/fbbsdlsrF27FoAhQ4Zw5513omkaNpuNxYsXk52djVKKUaNGccMNNwBw5MgRFi9ejN1up3///kyaNKnZh666IxebzcbcuXOpq6vDMAz69evHPffcg643798SjcklPz+f+fPno+s60dHRTJ06ldjYWODia5eGcvGFdjl48CBz5szhkksucf4M77jjDrp160ZaWhqFhYXExMQwc+ZM5/25lStXsnHjRufw6AEDBgDebxd35eLtdmlKHg8++CBWq5Xa2lpCQ0OZPXs27du392qbtKiiIoQQwrtafPeXEEKI5iNFRQghhNtIURFCCOE2UlSEEEK4jRQVIYQQbiNFRQghhNtIURHCA1566SUWL158xnMHDhxg0qRJFBcXeykqITxPiooQHjBx4kR2797N3r17AbDb7SxZsoS7777buTigOxiG4bbPEsIdWvzaX0J4Q3h4OJMmTWLJkiUsWLCAlStXEh8fT2pqKoZhsHr1ajZu3IjVaqVfv35MmTKFsLAwDMMgLS2NgwcPUlNTQ8eOHZkyZQrt27cHHFdAISEh5OXlcfDgQWbNmoXNZmP58uUUFRUREhLC9ddff8YyH0I0J5lRL4QHLViwgNraWr777juef/55YmJi+Oijj8jMzHTu4PfGG29QW1vLww8/jGEYZGRkMHToUPz8/Fi2bBmHDx/m2WefBRxFZffu3TzxxBPO9aqmTp3K448/To8ePaioqCA/P9+5L4cQzU26v4TwoMmTJ7Nv3z5uvfVWYmJiAFi/fj133HEH0dHRBAQEcNttt7Ft2zYMw0DXdVJTUwkODna+dvToUefClACDBw+me/fu6LqOv78/JpOJ7OxsqqqqCAsLk4IivEq6v4TwoDZt2hAREeHsvgLHXuTPPffcGQv8aZpGWVkZERERvPPOO2zfvp3y8nLne8rLywkKCgJwFqfTHnvsMVauXMny5cvp0KEDd911F926dWuG7IQ4mxQVIZqZ2Wxm+vTp9f7i37hxI7t372bOnDnExsZSXl7OlClTzrnxUrdu3fj9739PbW0tn332GQsXLmTRokWeTEGIBkn3lxDN7Oqrr+bdd991bi1cWlrq3I64qqoKk8lEeHg41dXV/Otf/zrnZ9ntdr788kusVismk4ng4OBm39pAiJ+SKxUhmtnpkVlPP/00JSUlREZGMnz4cJKTkxk1ahR79+7lgQceIDw8nNtuu43169ef8/M2bdrEG2+8gWEYJCYm8vDDDzdHGkLUS0Z/CSGEcBu5ThZCCOE2UlSEEEK4jRQVIYQQbiNFRQghhNtIURFCCOE2UlSEEEK4jRQVIYQQbiNFRQghhNv8P5kwHtmGmyMGAAAAAElFTkSuQmCC\n",
"text/plain": [
"<Figure size 432x288 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"### type your answer here\n",
"df_CI = df_can.loc[['China','India'], years] # passing in years 1980 - 2013 to exclude the 'total' column\n",
"df_CI = df_CI.transpose()\n",
"df_CI.index = df_CI.index.map(int)\n",
"df_CI.plot(kind='line')\n",
"\n",
"plt.title('Immigration 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": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"df_CI = df_can.loc[['India', 'China'], years]\n",
"df_CI.head()\n",
"-->"
]
},
{
"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": "code",
"execution_count": 57,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
},
"scrolled": true
},
"outputs": [],
"source": [
"### type your answer here\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"df_CI.plot(kind='line')\n",
"-->"
]
},
{
"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": 58,
"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>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>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",
" <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",
" </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",
"China 5123 6682 3308 1863 1527 1816 1960 2643 2758 4323 ... \n",
"India 8880 8670 8147 7338 5704 4211 7150 10189 11522 10343 ... \n",
"\n",
" 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 \n",
"China 36619 42584 33518 27642 30037 29622 30391 28502 33024 34129 \n",
"India 28235 36210 33848 28742 28261 29456 34235 27509 30933 33087 \n",
"\n",
"[2 rows x 34 columns]"
]
},
"execution_count": 58,
"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": 59,
"metadata": {
"button": false,
"collapsed": false,
"deletable": true,
"jupyter": {
"outputs_hidden": false
},
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"outputs": [],
"source": [
"### type your answer here\n",
"\n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"df_CI.index = df_CI.index.map(int) # let's change the index values of df_CI to type integer for plotting\n",
"df_CI.plot(kind='line')\n",
"-->\n",
"\n",
"<!--\n",
"plt.title('Immigrants from China and India')\n",
"plt.ylabel('Number of Immigrants')\n",
"plt.xlabel('Years')\n",
"-->\n",
"\n",
"<!--\n",
"plt.show()\n",
"--> "
]
},
{
"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": 76,
"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_can.sort_values(by='Total',ascending=False,axis = 0, inplace=True)\n",
"df_top5 = df_can.head(5)\n",
"df_top5 = df_top5[years].transpose() \n",
"df_top5.plot(kind='line')\n",
"\n",
"plt.title('Immigration from top 5 countries to Canada')\n",
"plt.ylabel('Number of immigrants')\n",
"plt.xlabel('Years')\n",
"plt.show()\n"
]
},
{
"cell_type": "markdown",
"metadata": {
"button": false,
"deletable": true,
"new_sheet": false,
"run_control": {
"read_only": false
}
},
"source": [
"Double-click __here__ for the solution.\n",
"<!-- The correct answer is:\n",
"\\\\ # Step 1: Get the dataset. Recall that we created a Total column that calculates the cumulative immigration by country. \\\\ We will sort on this column to get our top 5 countries using pandas sort_values() method.\n",
"\\\\ inplace = True paramemter saves the changes to the original df_can dataframe\n",
"df_can.sort_values(by='Total', ascending=False, axis=0, inplace=True)\n",
"-->\n",
"\n",
"<!--\n",
"# get the top 5 entries\n",
"df_top5 = df_can.head(5)\n",
"-->\n",
"\n",
"<!--\n",
"# transpose the dataframe\n",
"df_top5 = df_top5[years].transpose() \n",
"-->\n",
"\n",
"<!--\n",
"print(df_top5)\n",
"-->\n",
"\n",
"<!--\n",
"\\\\ # Step 2: Plot the dataframe. To make the plot more readeable, we will change the size using the `figsize` parameter.\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",
"-->"
]
},
{
"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 **edX** called *Visualizing Data with Python*. If you accessed this notebook outside the course, you can take this course online by clicking [here](http://cocl.us/DV0101EN_edX_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