DV0101EN-Exercise-Pie-Charts-Box-Plots-Scatter-Plots-and-Bubble-Plots-py.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "<a href=\"https://cognitiveclass.ai\"><img src = \"https://ibm.box.com/shared/static/9gegpsmnsoo25ikkbl4qzlvlyjbgxs5x.png\" width = 400> </a>\n",
    "\n",
    "<h1 align=center><font size = 5>Pie Charts, Box Plots, Scatter Plots, and Bubble Plots</font></h1>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "## Introduction\n",
    "\n",
    "In this lab session, we continue exploring the Matplotlib library. More specificatlly, we will learn how to create pie charts, box plots, scatter plots, and bubble charts."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "## Table of Contents\n",
    "\n",
    "<div class=\"alert alert-block alert-info\" style=\"margin-top: 20px\">\n",
    "\n",
    "1. [Exploring Datasets with *p*andas](#0)<br>\n",
    "2. [Downloading and Prepping Data](#2)<br>\n",
    "3. [Visualizing Data using Matplotlib](#4) <br>\n",
    "4. [Pie Charts](#6) <br>\n",
    "5. [Box Plots](#8) <br>\n",
    "6. [Scatter Plots](#10) <br>\n",
    "7. [Bubble Plots](#12) <br> \n",
    "</div>\n",
    "<hr>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "# Exploring Datasets with *pandas* and Matplotlib<a id=\"0\"></a>\n",
    "\n",
    "Toolkits: The course heavily relies on [*pandas*](http://pandas.pydata.org/) and [**Numpy**](http://www.numpy.org/) for data wrangling, analysis, and visualization. The primary plotting library we will explore in the course is [Matplotlib](http://matplotlib.org/).\n",
    "\n",
    "Dataset: Immigration to Canada from 1980 to 2013 - [International migration flows to and from selected countries - The 2015 revision](http://www.un.org/en/development/desa/population/migration/data/empirical2/migrationflows.shtml) from United Nation's website.\n",
    "\n",
    "The dataset contains annual data on the flows of international migrants as recorded by the countries of destination. The data presents both inflows and outflows according to the place of birth, citizenship or place of previous / next residence both for foreigners and nationals. In this lab, we will focus on the Canadian Immigration data."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "# Downloading and Prepping Data <a id=\"2\"></a>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Import primary modules."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [],
   "source": [
    "import numpy as np  # useful for many scientific computing in Python\n",
    "import pandas as pd # primary data structure library"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "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,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Download the dataset and read it into a *pandas* dataframe."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Data downloaded and read into a 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",
    "\n",
    "print('Data downloaded and read into a dataframe!')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Let's take a look at the first five items in our dataset."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "button": false,
    "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",
       "      <td>0</td>\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",
       "      <td>1</td>\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",
       "      <td>2</td>\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",
       "      <td>3</td>\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",
       "      <td>4</td>\n",
       "      <td>Immigrants</td>\n",
       "      <td>Foreigners</td>\n",
       "      <td>Andorra</td>\n",
       "      <td>908</td>\n",
       "      <td>Europe</td>\n",
       "      <td>925</td>\n",
       "      <td>Southern Europe</td>\n",
       "      <td>901</td>\n",
       "      <td>Developed regions</td>\n",
       "      <td>0</td>\n",
       "      <td>...</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>1</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>1</td>\n",
       "      <td>1</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "<p>5 rows × 43 columns</p>\n",
       "</div>"
      ],
      "text/plain": [
       "         Type    Coverage          OdName  AREA AreaName   REG  \\\n",
       "0  Immigrants  Foreigners     Afghanistan   935     Asia  5501   \n",
       "1  Immigrants  Foreigners         Albania   908   Europe   925   \n",
       "2  Immigrants  Foreigners         Algeria   903   Africa   912   \n",
       "3  Immigrants  Foreigners  American Samoa   909  Oceania   957   \n",
       "4  Immigrants  Foreigners         Andorra   908   Europe   925   \n",
       "\n",
       "           RegName  DEV             DevName  1980  ...  2004  2005  2006  \\\n",
       "0    Southern Asia  902  Developing regions    16  ...  2978  3436  3009   \n",
       "1  Southern Europe  901   Developed regions     1  ...  1450  1223   856   \n",
       "2  Northern Africa  902  Developing regions    80  ...  3616  3626  4807   \n",
       "3        Polynesia  902  Developing regions     0  ...     0     0     1   \n",
       "4  Southern Europe  901   Developed regions     0  ...     0     0     1   \n",
       "\n",
       "   2007  2008  2009  2010  2011  2012  2013  \n",
       "0  2652  2111  1746  1758  2203  2635  2004  \n",
       "1   702   560   716   561   539   620   603  \n",
       "2  3623  4005  5393  4752  4325  3774  4331  \n",
       "3     0     0     0     0     0     0     0  \n",
       "4     1     0     0     0     0     1     1  \n",
       "\n",
       "[5 rows x 43 columns]"
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "df_can.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Let's find out how many entries there are in our dataset."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "(195, 43)\n"
     ]
    }
   ],
   "source": [
    "# print the dimensions of the dataframe\n",
    "print(df_can.shape)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Clean up data. We will make some modifications to the original dataset to make it easier to create our visualizations. Refer to *Introduction to Matplotlib and Line Plots* and *Area Plots, Histograms, and Bar Plots* for a detailed description of this preprocessing."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "data dimensions: (195, 38)\n"
     ]
    }
   ],
   "source": [
    "# clean up the dataset to remove unnecessary columns (eg. REG) \n",
    "df_can.drop(['AREA', 'REG', 'DEV', 'Type', 'Coverage'], axis=1, inplace=True)\n",
    "\n",
    "# let's rename the columns so that they make sense\n",
    "df_can.rename(columns={'OdName':'Country', 'AreaName':'Continent','RegName':'Region'}, inplace=True)\n",
    "\n",
    "# for sake of consistency, let's also make all column labels of type string\n",
    "df_can.columns = list(map(str, df_can.columns))\n",
    "\n",
    "# set the country name as index - useful for quickly looking up countries using .loc method\n",
    "df_can.set_index('Country', inplace=True)\n",
    "\n",
    "# add total column\n",
    "df_can['Total'] = df_can.sum(axis=1)\n",
    "\n",
    "# years that we will be using in this lesson - useful for plotting later on\n",
    "years = list(map(str, range(1980, 2014)))\n",
    "print('data dimensions:', df_can.shape)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "# Visualizing Data using Matplotlib<a id=\"4\"></a>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Import `Matplotlib`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Matplotlib version:  3.1.1\n"
     ]
    }
   ],
   "source": [
    "%matplotlib inline\n",
    "\n",
    "import matplotlib as mpl\n",
    "import matplotlib.pyplot as plt\n",
    "\n",
    "mpl.style.use('ggplot') # optional: for ggplot-like style\n",
    "\n",
    "# check for latest version of Matplotlib\n",
    "print('Matplotlib version: ', mpl.__version__) # >= 2.0.0"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "# Pie Charts <a id=\"6\"></a>\n",
    "\n",
    "A `pie chart` is a circualr graphic that displays numeric proportions by dividing a circle (or pie) into proportional slices. You are most likely already familiar with pie charts as it is widely used in business and media. We can create pie charts in Matplotlib by passing in the `kind=pie` keyword.\n",
    "\n",
    "Let's use a pie chart to explore the proportion (percentage) of new immigrants grouped by continents for the entire time period from 1980 to 2013. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 1: Gather data. \n",
    "\n",
    "We will use *pandas* `groupby` method to summarize the immigration data by `Continent`. The general process of `groupby` involves the following steps:\n",
    "\n",
    "1. **Split:** Splitting the data into groups based on some criteria.\n",
    "2. **Apply:** Applying a function to each group independently:\n",
    "       .sum()\n",
    "       .count()\n",
    "       .mean() \n",
    "       .std() \n",
    "       .aggregate()\n",
    "       .apply()\n",
    "       .etc..\n",
    "3. **Combine:** Combining the results into a data structure."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "<img src=\"https://s3-api.us-geo.objectstorage.softlayer.net/cf-courses-data/CognitiveClass/DV0101EN/labs/Images/Mod3Fig4SplitApplyCombine.png\" height=400 align=\"center\">"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    },
    "scrolled": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<class 'pandas.core.groupby.generic.DataFrameGroupBy'>\n"
     ]
    },
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>1980</th>\n",
       "      <th>1981</th>\n",
       "      <th>1982</th>\n",
       "      <th>1983</th>\n",
       "      <th>1984</th>\n",
       "      <th>1985</th>\n",
       "      <th>1986</th>\n",
       "      <th>1987</th>\n",
       "      <th>1988</th>\n",
       "      <th>1989</th>\n",
       "      <th>...</th>\n",
       "      <th>2005</th>\n",
       "      <th>2006</th>\n",
       "      <th>2007</th>\n",
       "      <th>2008</th>\n",
       "      <th>2009</th>\n",
       "      <th>2010</th>\n",
       "      <th>2011</th>\n",
       "      <th>2012</th>\n",
       "      <th>2013</th>\n",
       "      <th>Total</th>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Continent</th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <td>Africa</td>\n",
       "      <td>3951</td>\n",
       "      <td>4363</td>\n",
       "      <td>3819</td>\n",
       "      <td>2671</td>\n",
       "      <td>2639</td>\n",
       "      <td>2650</td>\n",
       "      <td>3782</td>\n",
       "      <td>7494</td>\n",
       "      <td>7552</td>\n",
       "      <td>9894</td>\n",
       "      <td>...</td>\n",
       "      <td>27523</td>\n",
       "      <td>29188</td>\n",
       "      <td>28284</td>\n",
       "      <td>29890</td>\n",
       "      <td>34534</td>\n",
       "      <td>40892</td>\n",
       "      <td>35441</td>\n",
       "      <td>38083</td>\n",
       "      <td>38543</td>\n",
       "      <td>618948</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>Asia</td>\n",
       "      <td>31025</td>\n",
       "      <td>34314</td>\n",
       "      <td>30214</td>\n",
       "      <td>24696</td>\n",
       "      <td>27274</td>\n",
       "      <td>23850</td>\n",
       "      <td>28739</td>\n",
       "      <td>43203</td>\n",
       "      <td>47454</td>\n",
       "      <td>60256</td>\n",
       "      <td>...</td>\n",
       "      <td>159253</td>\n",
       "      <td>149054</td>\n",
       "      <td>133459</td>\n",
       "      <td>139894</td>\n",
       "      <td>141434</td>\n",
       "      <td>163845</td>\n",
       "      <td>146894</td>\n",
       "      <td>152218</td>\n",
       "      <td>155075</td>\n",
       "      <td>3317794</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>Europe</td>\n",
       "      <td>39760</td>\n",
       "      <td>44802</td>\n",
       "      <td>42720</td>\n",
       "      <td>24638</td>\n",
       "      <td>22287</td>\n",
       "      <td>20844</td>\n",
       "      <td>24370</td>\n",
       "      <td>46698</td>\n",
       "      <td>54726</td>\n",
       "      <td>60893</td>\n",
       "      <td>...</td>\n",
       "      <td>35955</td>\n",
       "      <td>33053</td>\n",
       "      <td>33495</td>\n",
       "      <td>34692</td>\n",
       "      <td>35078</td>\n",
       "      <td>33425</td>\n",
       "      <td>26778</td>\n",
       "      <td>29177</td>\n",
       "      <td>28691</td>\n",
       "      <td>1410947</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>Latin America and the Caribbean</td>\n",
       "      <td>13081</td>\n",
       "      <td>15215</td>\n",
       "      <td>16769</td>\n",
       "      <td>15427</td>\n",
       "      <td>13678</td>\n",
       "      <td>15171</td>\n",
       "      <td>21179</td>\n",
       "      <td>28471</td>\n",
       "      <td>21924</td>\n",
       "      <td>25060</td>\n",
       "      <td>...</td>\n",
       "      <td>24747</td>\n",
       "      <td>24676</td>\n",
       "      <td>26011</td>\n",
       "      <td>26547</td>\n",
       "      <td>26867</td>\n",
       "      <td>28818</td>\n",
       "      <td>27856</td>\n",
       "      <td>27173</td>\n",
       "      <td>24950</td>\n",
       "      <td>765148</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>Northern America</td>\n",
       "      <td>9378</td>\n",
       "      <td>10030</td>\n",
       "      <td>9074</td>\n",
       "      <td>7100</td>\n",
       "      <td>6661</td>\n",
       "      <td>6543</td>\n",
       "      <td>7074</td>\n",
       "      <td>7705</td>\n",
       "      <td>6469</td>\n",
       "      <td>6790</td>\n",
       "      <td>...</td>\n",
       "      <td>8394</td>\n",
       "      <td>9613</td>\n",
       "      <td>9463</td>\n",
       "      <td>10190</td>\n",
       "      <td>8995</td>\n",
       "      <td>8142</td>\n",
       "      <td>7677</td>\n",
       "      <td>7892</td>\n",
       "      <td>8503</td>\n",
       "      <td>241142</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "<p>5 rows × 35 columns</p>\n",
       "</div>"
      ],
      "text/plain": [
       "                                  1980   1981   1982   1983   1984   1985  \\\n",
       "Continent                                                                   \n",
       "Africa                            3951   4363   3819   2671   2639   2650   \n",
       "Asia                             31025  34314  30214  24696  27274  23850   \n",
       "Europe                           39760  44802  42720  24638  22287  20844   \n",
       "Latin America and the Caribbean  13081  15215  16769  15427  13678  15171   \n",
       "Northern America                  9378  10030   9074   7100   6661   6543   \n",
       "\n",
       "                                  1986   1987   1988   1989  ...    2005  \\\n",
       "Continent                                                    ...           \n",
       "Africa                            3782   7494   7552   9894  ...   27523   \n",
       "Asia                             28739  43203  47454  60256  ...  159253   \n",
       "Europe                           24370  46698  54726  60893  ...   35955   \n",
       "Latin America and the Caribbean  21179  28471  21924  25060  ...   24747   \n",
       "Northern America                  7074   7705   6469   6790  ...    8394   \n",
       "\n",
       "                                   2006    2007    2008    2009    2010  \\\n",
       "Continent                                                                 \n",
       "Africa                            29188   28284   29890   34534   40892   \n",
       "Asia                             149054  133459  139894  141434  163845   \n",
       "Europe                            33053   33495   34692   35078   33425   \n",
       "Latin America and the Caribbean   24676   26011   26547   26867   28818   \n",
       "Northern America                   9613    9463   10190    8995    8142   \n",
       "\n",
       "                                   2011    2012    2013    Total  \n",
       "Continent                                                         \n",
       "Africa                            35441   38083   38543   618948  \n",
       "Asia                             146894  152218  155075  3317794  \n",
       "Europe                            26778   29177   28691  1410947  \n",
       "Latin America and the Caribbean   27856   27173   24950   765148  \n",
       "Northern America                   7677    7892    8503   241142  \n",
       "\n",
       "[5 rows x 35 columns]"
      ]
     },
     "execution_count": 7,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# group countries by continents and apply sum() function \n",
    "df_continents = df_can.groupby('Continent', axis=0).sum()\n",
    "\n",
    "# note: the output of the groupby method is a `groupby' object. \n",
    "# we can not use it further until we apply a function (eg .sum())\n",
    "print(type(df_can.groupby('Continent', axis=0)))\n",
    "\n",
    "df_continents.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 2: Plot the data. We will pass in `kind = 'pie'` keyword, along with the following additional parameters:\n",
    "- `autopct` -  is a string or function used to label the wedges with their numeric value. The label will be placed inside the wedge. If it is a format string, the label will be `fmt%pct`.\n",
    "- `startangle` - rotates the start of the pie chart by angle degrees counterclockwise from the x-axis.\n",
    "- `shadow` - Draws a shadow beneath the pie (to give a 3D feel)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 360x432 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# autopct create %, start angle represent starting point\n",
    "df_continents['Total'].plot(kind='pie',\n",
    "                            figsize=(5, 6),\n",
    "                            autopct='%1.1f%%', # add in percentages\n",
    "                            startangle=90,     # start angle 90° (Africa)\n",
    "                            shadow=True,       # add shadow      \n",
    "                            )\n",
    "\n",
    "plt.title('Immigration to Canada by Continent [1980 - 2013]')\n",
    "plt.axis('equal') # Sets the pie chart to look like a circle.\n",
    "\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "The above visual is not very clear, the numbers and text overlap in some instances. Let's make a few modifications to improve the visuals:\n",
    "\n",
    "* Remove the text labels on the pie chart by passing in `legend` and add it as a seperate legend using `plt.legend()`.\n",
    "* Push out the percentages to sit just outside the pie chart by passing in `pctdistance` parameter.\n",
    "* Pass in a custom set of colors for continents by passing in `colors` parameter.\n",
    "* **Explode** the pie chart to emphasize the lowest three continents (Africa, North America, and Latin America and Carribbean) by pasing in `explode` parameter.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "data": {
      "image/png": "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QsrNhZYYzCnFflmhjRz6CrRBWTYC2A0tAfsdwHy93A/Qumo+Au2z8D60RzK8enWtxZoH7TP1K7T3//5rXN8+9tcAPAdtMJWd0I7Nc9AG1rgWV30mr3H9zgDi9KketK6xcdAGMCngAm30xz3QBhVxAXCbfm9mwf4sgHaR4f+gfVZ/gPa9v1PpzyrUP88DoXVjXAfts3AY2jDx13P/lqNx0FoLP4H2HSmYltrFmQ6t26QztPtbo6F153UcdfYzaMfhVb3OgmPUWX89W6/nB2i9A76D1u0xvIT7HomoGpCy+ZtFRFQxRCQGQLJSqiwSIqrmROQtAAOUUu2MjqU6EW2Y/QeVUs1LKktlS0SaQruIFK63AhNRFcdBPYio0hKRdtBafbZAuwL9ELQb+iOMjIsqP/1eunbQWgifMzic6uomfTTHGUqpfxkdTE0gIrHQWvWJqBphCxkRVVoi0hZaV5820LpYJwCYrpT6ztDAqNITkQ3Qnm/1DYBH9e5tVEb0+6gK7qVKVkpdNDKemkJEGkJ7vAIAnFRKFdt9m4iqBiZkREREREREBuGgHkRERERERAZhQkZERERERGQQJmREREREREQGYUJGRERERERkECZkREREREREBmFCRkREREREZBAmZERERERERAZhQkZERERERGQQJmREREREREQGYUJGRERERERkECZkREREREREBmFCRkREREREZBAmZERERERERAZhQkZERERERGQQJmREREREREQGYUJGRERERERkECZkREREREREBmFCRkREREREZBAmZERERERERAZhQkZERERERGQQJmREREREREQGYUJGRERERERkECZkREREREREBmFCRkREREREZBAmZERERERERAZhQkZERERERGQQJmREREREREQGYUJGRERERERkECZkREREREREBmFCRkREREREZBAmZERERERERAZhQkZERERERGQQJmREREREREQGYUJGRERERERkECZkRERU5YlIfxHZLyKHRGRSIa83EZF1IrJLRDaISEN9eSsR2S4iO0UkTF/mJCJrRcS9oveDiIhqHiZkRERUpYmIGcAsAAMABAO4X0SCHYq9A+ArpVR7ANMAvKEvfwLAJAD3AHhBXzYGwAKlVGZ5x05ERMSEjIiIqrouAA4ppY4opXIBLAJwt0OZYADr9N/X271uBeAGwB2AVUR8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OXLkmSFDhqSsXbu2VlGtXY5cXFwUAJjNZuTn5191ZXvHjh1up06dchkxYkRLQEum6tevn1OQkDk7O1/pj28yma7UZzKZkJ+fLzabDZ6ennmxsbHxhW3f3d291PdjrV27ttaWLVtqrV69OsHT09MWGRnZKjs7+28tpVlZWTJt2rQmq1atim/atKl16tSp9XNycq6UKWp/C7moXyKz2axMJq3qgv0FAKUUVq9evc/Dw6PIexWaN2+etXPnTvehQ4dednxt+vTpDbp27Zq2aNGiw4cPH3YeNmzYle5CxR0vx30omC9suVJKmjZtmrVmzZoEx3omTpzYbM6cOYc6deqUNW/ePP+tW7fWKnjN/v1Wirdi1HRv/tDuBZ/aljdNJimxx4LJyXTzbWNaxm/+aP8JANkAkHAEl3+IxY//uB13lXuw1cjlLC0hMzubyy0hSz6efig/15bXoE3HqjDc/bWyAPgoKs7aEcCYSR0spbqASUREV2OXRTvp6enmBg0aWAHgm2++uTKKoqenZ356evp13zgfHR3t9/jjjyft2LFj944dO3bv3r1714ULF5yPHDlSqivaPj4+tnr16uUuWrTIF9BaYrZv3+5W0nqdO3dOmz17diAA5OXl4fLly6aUlBSzl5dXvqenp23Pnj2ue/fuvaprYVZWlgkAAgMD81JTU01r1qzxLWlbXbp0SV+yZIkfAPz555+uhw8fLvRKv7u7e35aWlqJn7tbb701ddasWbUL5rdt23bV/o4ZM+bc999/7//LL79c2Yf58+f7nTp1yiktLc1cr169XABYsGBBgOO6Rfntt9+8Lly4YM7IyJD169f7hIWFpQPAuXPnnDdt2uQBAMuWLfPr3LlzenBwcPbly5edCpbn5ubKzp07XQEgMzPTVL9+fWtubq6sWLHCr7Tbp5pj1OvNZPrytv/zq+v8dmmSsQI+jd3vbdjZzxV2f78/X4K4oyexv1wCraYuZaaVe0J2fPuFkwDg1zCoOiZkBf4PwIaoOGs9owMhIqqqamxCpg9W0b5gevfdd+s888wzSWPHjg3q379/K19f37yCshEREZdjYmJ8evToEbx+/XrPa93WTz/95HfXXXf9rRWnd+/eyYsXLy71ifrs2bOPfPPNNwHh4eHB3bp1C1m1apVPSetERUUd/+2332p17949uE+fPsG7d+92i4yMTMnPz5fw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\n",
      "text/plain": [
       "<Figure size 1080x432 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "colors_list = ['gold', 'yellowgreen', 'lightcoral', 'lightskyblue', 'lightgreen', 'pink']\n",
    "explode_list = [0.1, 0, 0, 0, 0.1, 0.1] # ratio for each continent with which to offset each wedge.\n",
    "\n",
    "df_continents['Total'].plot(kind='pie',\n",
    "                            figsize=(15, 6),\n",
    "                            autopct='%1.1f%%', \n",
    "                            startangle=90,    \n",
    "                            shadow=True,       \n",
    "                            labels=None,         # turn off labels on pie chart\n",
    "                            pctdistance=1.12,    # the ratio between the center of each pie slice and the start of the text generated by autopct \n",
    "                            colors=colors_list,  # add custom colors\n",
    "                            explode=explode_list # 'explode' lowest 3 continents\n",
    "                            )\n",
    "\n",
    "# scale the title up by 12% to match pctdistance\n",
    "plt.title('Immigration to Canada by Continent [1980 - 2013]', y=1.12) \n",
    "\n",
    "plt.axis('equal') \n",
    "\n",
    "# add legend\n",
    "plt.legend(labels=df_continents.index, loc='upper left') \n",
    "\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "**Question:** Using a pie chart, explore the proportion (percentage) of new immigrants grouped by continents in the year 2013.\n",
    "\n",
    "**Note**: You might need to play with the explore values in order to fix any overlapping slice values."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "data": {
      "image/png": "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kZMwISMiIiIiInISJmREREREREROwoSMiIiIiIjISZiQEREREREROQkTMiIiIiIiIidhQkZEREREROQkTMiIiIiIiIichAkZERERERGRkzAhIyIiIiIichImZERERERERE7ChIyIiIiIiMhJmJARERERERE5CRMyIiIiIiIiJ2FCRkRERERE5CRMyIiIiIiIiJyECRkREREREZGTMCEjIiIiIiJyEiZkRERERERETsKEjIiIiIiIyEmYkBERERERETkJEzIiIiIiIiInYUJGRERERETkJEzIiIiIiIiInIQJGRER1QtCiH5CiKNCiBNCCIOD56cLIf6wLseEEFnW9W2FEHuFEPuFEFHWdRohxAYhhGdtHwcREbkWIaV0dgxERES3RAihBnAMQG8AqQB+B/BXKWVSGe1fAXC3lPJZIcTHANYBOAMgQUo5yPp8jpRyQa0cABERuSxWyIiIqD6IBHBCSnlKSlkCYBGAh2/S/q8AfrD+bATgAcATgFEI4QdgIIBvazBeIiIiAIDG2QEQERFVg1AAKTaPUwHc66ihEKIFgFYANlpXzYKSfLkBeAHAvwBMkRxCQkREtYAVMiIiqg+Eg3VlJVRPAlgqpTQDgJTynJQyVkoZBaAAQBMAR4QQC4UQi4UQbWomZCIiIiZkRERUP6QCaGbzuCmAtDLaPok/hyvamwLgbQCjAXwHYKJ1ISIiqhFMyIiIqD74HcCdQohWQggdlKRrlX0jIURbAP4Adjh47n4A56WUx6FcT2YBYLb+TEREVCN4DRkREd32pJQmIcTLAH4GoAYwT0p5WAgxGcAeKWVpcvZXAIvsrw8TQggAEwA8YV31JZQKmQbAi7VxDERE5Jo47T0REREREZGTcMgiERERERGRkzAhIyIiIiIichKnXEO2d+9elU6nG6dWq9uDSSGRLYvZbE4uKSn5MDw83OLsYIiIiIioZjklIdPpdON8fHye0Gq1/MBJZMdoNHbKyckBgARnx0JERERENcsp1Sm1Wt2eyRiRY1qt1mKtHhMRERFRPees4YIcpkh0c/w/QkREROQCXPpD33//+1+/0NDQ8EOHDrmXrhs3blzT++67r8O4ceOa2rdfvny579SpUxvVbpREROQMQgh3IcRuIcR+IcRhIcQ7DtqMFEIcFEL8IYTYJoTQW9d3F0IcEEL8LoRobV3nJ4T42XrPMyIiIgB15MbQ5hEPhVdnf+qvVu2tSLuVK1cGdOrUKW/p0qUBHTt2TAOAFStWBB88ePAPd3f3627QZjQa8eijj2YDyK7OWImIqM4qBtBLSpknhNAC2CaEWCel3GnT5nsp5RwAEEI8BOBjAP0AvA5gEICWUG4s/TqAtwG8b39TaiIicm11IiFzhpycHNWBAwe8Fy1adPTZZ59tPWnSpLQnnniidVFRkapPnz7tR44ceWHTpk2+vr6+puTkZE+9Xl/Qrl27wgMHDnjNmDHjXFpammbs2LEtzp8/7wYAU6ZMORsTE5M/ePDgsPT0dF1JSYnqmWeeSR85cuRlZx8rERFVnjVxyrM+1FoXadcmx+ahl83zRgAeADwBGIUQYQBCpZRbajRoIiK67bhsQrZixQq/qKiobL1eX+zj42PevXu355IlS06EhYXdnZiYmAQAmzZt8j1z5oz7ypUrj2k0GsydOzewdPvx48c3j4yMzB07duxJk8mE3NxcNQDMmjXrTFBQkDk/P1/06dNHP2jQoMzg4GCzs46TiIiqTgihBrAXQGsAs6SUuxy0eQnAWAA6AL2sq6cC+BJAIYChAP4NpUJGRER0HZe9hmzVqlUBf/nLXzIBIC4u7urSpUsDHLWLi4vL1GhuzFv37t3bYNSoUZcAQKPRwN/f3wwAM2fODImOjtb369evfUZGhvbo0aPuN2xMRES3BSmlWUp5F4CmACKFEB0dtJklpQwDMB7ABOu6P6SU3aSUPQHcASANgBBCLBZC/EcIEVKLh0FERHWYS1bILl26pN63b5/Pm2++6fHWW2/BYrEIADIhISHVvq2np2eFp+ffsGFDgx07djRYt27dEW9vb0t8fHzboqIil016iYjqkunrH/gAgAWACUAJgCIAZ1/r/euS8raVUmYJITZDuT7sUBnNFgGYbbvCOoHHBACDAcwEMBHKdWWjAbxVleMgIqL6xSUTsqVLl/r379//yueff362dF1cXFzbLVu2eFe0j4iIiNzPP/88eOzYsRkmkwl5eXmq7OxstY+Pj9nb29ty6NAh98OHD3vVzBEQEVEVjHOwbisAhwmZECIYgNGajHkAeBDAB3Zt7pRSHrc+jAdw3K6bYQDWSCkzhRCeUBJCC5Rry4iIiFxzyOLq1asD4+LiMm3X9enTJ3PZsmUOhy06kpCQcG7Xrl0NevTooe/Vq5f+4MGDHvHx8dlms1lER0frp06d2qRDhw751R89ERFVVMeoYM+OUcENOkYFl/WF281+TzcGsEkIcQDA7wDWSylXCyEmW2dUBICXrVPi/wHlOrJhpRtbE7BhAD63rvoYwDIo15ddV0kjIiLXJZwx+25SUtJCPz+/9rW+Y6LbRFZWVrJerx/q7DiIbncdo4LfhzIaRD43ubOjCtmy13r/+lgth0VERHSNSw5ZJCIil2GEcr1YWTiSgYiInMolhywSERFZMSEjIiKnYkJGRESuLK/8JkRERDWHCRkREbkyVsiIiMipmJAREZErY0JGREROxYSMiIhcGRMyIiJyKpdOyP773//6hYaGhh86dMj9Zu0GDRrU+urVq+raiouIiGoNEzIiInKqOjHt/cPfHQmvzv5WDmm3t0LtVq4M6NSpU97SpUsDOnbsmFZWu2XLlp2ovuiIiG4khJgHYACADCllR+u6SQBGALhkbfamlHKtg237AZgBQA3gayllgnX9dwA6AVgtpXzTuu5tAAeklCtr9ohuG0zIiIjIqVy2QpaTk6M6cOCA98cff3zmp59+8geA1NRUbf/+/dvGxMTou3fv3mHTpk3eANC1a9dO6enpGgAYPHhwWGxsbPv77ruvw5w5c4KceQxEVK98A6Cfg/XTpZR3WRdHyZgawCwA/QHoAfxVCKEXQnQGACllZwDRQghfIURjAJFMxq7DhIyIiJyqTlTInGHFihV+UVFR2Xq9vtjHx8e8e/duz8TExAbdu3fPnjBhwkWTyYT8/PwbEtZZs2adCQoKMufn54s+ffroBw0alBkcHGx2xjEQUf0hpUwUQrSswqaRAE5IKU8BgBBiEYCHAfwPgIcQQgVAB8AMYDKAf1VLwPUHEzIiInIql03IVq1aFTB8+PAMAIiLi7u6dOnSgH79+mWNHz++pclkUg0YMCAzIiKi0H67mTNnhvz6669+AJCRkaE9evSoe3BwMP+gE1FNeVkI8QyAPQBel1Jm2j0fCiDF5nEqgHullMlCiHMA9gFYCKA1ACGl/L/aCPo2kg8ApsRhqwE0BJANIMvu33QAp63LWU3MAqNzQiUiovrIJROyS5cuqfft2+fz5ptverz11luwWCwCgExISEhdvnz50TVr1viOGTOm1XPPPZf+97///Urpdhs2bGiwY8eOBuvWrTvi7e1tiY+Pb1tUVOSywz6JqMbNBvAuAGn9dxqAZ+3aCAfbSQCQUo651kiIHwG8IIR4C0AXAOullF/VRNDVJSU+wg9AUwD+AHwdLH4AvKH8LVNDGYY/vdmaPdsqsZvSL9Q6AmhRgfZmU+Kw8wBOQUnQjgJIsi6nNTELLJXYNxERkWsmZEuXLvXv37//lc8///xs6bq4uLi2mzZt8o6JickbOXLk5YKCAtXBgwc9AVxLyLKzs9U+Pj5mb29vy6FDh9wPHz7s5ZQDICKXIKVML/1ZCPEVgNUOmqUCaGbzuCmA6yYpEkI8DKXC5gWgo5TyCSFEohDiOyllQfVHXjEp8RENAHQAEAaguYPFpwrdLq1M44P/Tes4YFIzj2VTejZQqxzltjdQ28QXa/dcoSlx2BEoydlhALsB7NTELOAoCiIiKpNLJmSrV68OfPHFFy/YruvTp0/muHHjWrm7u1s0Go308PAwz5w587Rtm/j4+OzvvvsuODo6Wt+8efOiDh068I8sEdUYIURjKWXp76pHABxy0Ox3AHcKIVoBOA/gSQBP2fShBfAqlBkc74S1egalmqQDUOMJWUp8hMq6785QZn3sbF1awnGFr9Zkpxb1ABAlpfSphlA8ANxtXUqZTInD9gHYal22aWIWXHG0MRERuaY6kZBVdJr66rJmzZqj9uvGjBmTMWbMmAxH7fft23ew9Ofly5cfr8nYiMg1CSF+gFJxCRJCpAKYCCBWCHEXlCTqDIAXrG2bQJnePk5KaRJCvAzgZyjVm3lSysM2Xb8EYIGUskAIcUDZXBwEsFZKmVUTx5ISH+EL4D4AMQCiAXSFkqzUOcZ8c65KJaRGraqpv4caKBOvRAJ4HYA0JQ57SxOzYGoN7Y+IiG4zdSIhIyJydVLKvzpYPbeMtmkA4mwerwVww5T41uc+sflZAnC0n1uSEh8Rgj+Tr2go1a86f32ttEizxSQt/g10ulrcrYDjSicREbkoJmRERFRpKfERXQE8BGAglArYbcdilkYAaOCprc2EzAxgSy3uj4iI6jgmZEREVK6U+Ag3AA9AScAGQJk85LYmrQmZt4dGW4u73aeJWZBTi/sjIqI6jgkZERE5lBIfoQHQD8BQAPFQZmmsNywmJSHz8qjVCtnGWtwXERHdBpiQERHRdVLiI+4G8AyU2RobOjmcGlM6ZNHLvVYrZJtqcV9ERHQbYEJGRERIiY9oDOBpKNWwTk4Op1aUVsg83NS1VSEzAqjMTauJiMgFuGxC1qxZs/BWrVoVlj7u37//1X/+858XnRkTEVFtS4mPiAIwBsCjcLG/CRaTNAGAp1utVch28ybRRERkr0788f1xcVZ4dfY3cLBfufc10+l0lsTExKSq9G80GqHV1uYIFyKi6pMSH6EF8DiUG0ZHOjkcpymtkLnXXoWM148REdEN6kRCVpd07dq107p165JDQkJMO3fu9Hz33XebrVmz5uikSZOaZGRkaM+fP6/z9/c3zZ49+8zo0aNbJCcne6rVakyYMCGld+/euXPnzg385Zdf/EpKSlRpaWlucXFxVyZOnHgBABYsWBDw7bffhhiNRtGxY8f8Tz/99KxGw5eAiGpHSnxEEJSbS48C0MTJ4Tid2WgxAYC7Tl1b37AxISMiohu4bDZQUlKiiomJ0Zc+Hjly5IWnnnoq82bbJCUlea5Zs+aIl5eX/Pe//x0CANu2bUs6dOiQ+9NPP33njh07DlnbeW3cuPGwp6enpU+fPvq+fftme3l5WVavXh2wbt26IzqdTr7yyivNFy5cGPj3v//9Ss0eKRG5upT4iCYAxkspRwghPJwdT11ROmTRXVcrFbIiADtqYT9ERHSbcdmErCpDFnv27Jnl5eUlAWDPnj3ezz77bAYAdOzYsahRo0YlycnJ7gAQGRmZExwcbAaABx54IPO3337z1mg08siRI54PPvhgewAoLi5WBQYGmqr3qIiI/pQSHxEKwCClHC6EcBdCODukOsVstBQDgJtWVRsVst80MQuKa2E/FSKEeBXACAACwFdSyk/snn8DwBDrQw2A9gCCAagBrADgB2CClPJ/1vYrAbwopUyrnSMgIqo/XDYhK4tarZYWiwUAUFRUpLJ9ztPT01L6s5SyzD7sP/QIISClFAMHDrzy/vvvn6/WgImI7KTERwQD+KeU8kUmYmWzmGQJALjVToWszkx3L4ToCCUZiwRQAuAnIcQaKeXx0jZSyo8AfGRtPxDAa1LKq0KI0QAWAFgE4CcA/7M+v4/JGBFR1ajKb+JaGjduXLJnzx5PAPjxxx/9y2oXGRmZt2zZsgAASEpKcktPT9fp9foiANi1a5fP5cuX1fn5+WLTpk1+UVFReT179szZsGGD/4ULFzQAcPnyZfWpU6dq82akRFTPpcRHNEiJj3hXSnkKwGtCCHdnx1SXWYyyGAB0WlVt/C7eaDAYwg0GwyCDwVDm35Za0h7ATillgZTSBGALgEdu0v6vAH6w/mwE4AHADYBFCKGBMkvnRzUYLxFRveayFTL7a8i6d++ePXXq1POvvfZa2vjx41vOmjXL2Llz5zKnJx41alTG6NGjW/To0UOvVqvx4YcfnnF3d5cA0KVLl7wXXnihVWpqqntcXNyVbt26FQDAmDFjzg8ePLiNlBJqtVq+99575+64446Smj9aIqrPUuIjBIBnpJQJQohGrIhVTOmQRZ2mxif1yAPwO4DPoEyqYjYYDHsBrAfwM4DtCQkJlptsX90OAZgihGcoV1EAACAASURBVAgEUAggDsAeRw2FEJ4A+gF42brqe+vyDIDxUCaI+VZKWVDTQRMR1Vd1IiGryDT11S0lJcXhPnv27Jm3e/fuQ/brJ02adN1QDA8PD/nVV1+dcdRHYGCgacaMGefs1z/11FOZ5U0cQkRUGSnxEREWKWeqhLiXiVjlXKuQaWq2QmaRcrvu/m+NWGvoZV2lhjJcMBLAWwAuGAyGZQAWQ0nOyh4TXw2klMlCiA+gJIR5APYDKOua5oEAtkspr1q3zQYQDwBCCH8oSdmjQoivAPgDmCal5OQlRESVwCGLRES3oZT4iIbn4sLnSil3q4S419nx3I7MRksJAGhreFKP5Vsz3CIjI98GcGcZTRpDqUBtBXDOYDB8bDAYavQ1lVLOlVJ2lVLGALgK4HgZTZ/En8MV7f0LwBQoQxr3AngWwPvVHSsRUX1XJypk9clzzz13BQCnsieiGpESH6EG8IpFyskqIRo4O57bmanYmpDVcIVse1LW8dDQ0Lsr2LwpgNcAvGYwGM4CWAJgcUJCQrWOJBFCNJRSZgghmgN4FECUgza+AO4H8LSD5+4E0ERKuUUIcReUoY8SAK9bJCKqJCZkRES3iZT4iHZmKReohYhUcXjiLTMXW4wAoFXXXIWsqMRStH7vlQs9ojveU4XNWwB4A8AbBoMhGcBMAN8mJCTkVUNoy6zXkBkBvCSlzBRCjAQAKeUca5tHAPwipXR0PfUUKMMtAaWC9j8Ar0KpmhERUSUwISMiquNS4iPUZin/IYDJaiE4O2s1+bNCVnPn9OSFgvNmC6SPj0+rW+yqPYBZAN43GAzzAcxKSEg4UdXOpJTRDtbNsXv8DYBvytj+CZufMwDcV9VYiIhcHRMyIqI6LCU+ol2JxfKDTqW6y9mx1DemIqVCpqnBCtmBU3lnAgIC/HQ6nW81dekLZZr5Vw0GwzooMzf+XNMTgRARUc1hQkZEVAdZq2JvCOAdnapW7pPlcoxFZqVCpq6587v1YObxpk2b3Wp1zBEBZbr6OADHDAbDTADfJCQk5NbAvoiIqAa57CyLYWFhFb3AGhs2bGiQmJjoVfr4888/D54/f35gZfc5bdq0hi1btuyamZmpruy2FbV8+XLfqVOnNqqp/isqPj6+7c6dOz3t13/88ccN8/Lyrr3vKvM6OPLbb7959u/fv+29997bsVu3bh1GjhzZwrb/8qSkpGiHDBlyBwDMnTs38NVXX21u3+bkyZO67t27d7iVOIkqIyU+okmxxfKbWoipKg5RrDHGfCUh02hEjVTICorN+ZsPZKYHBgbWREJmqw2ATwGkGgyGiQaDgZO9EBHdRupEhezTTz8Nr87+Ro8eXa2zUW3btq2Bl5eXOSYmJh8ARo0adakq/axduzawXbt2+cuXL/ezzsZYrYxGIx599NFsANnV3Xd1+c9//hMyZMiQq97e3rd8E9S0tDTNSy+9FPbpp5+eio6OzrdYLFiyZIl/Tk6OqiL9G41GNGvWzPjdd9+dutVYiKrLiX5d+6oElripVD7OjqW+MxaYjSqVEGpVzSRkx1MLzksJNGjQoKYTslI+ACYBeMVgMHwAYGZCQkJhLe2biIiqqE4kZHXFihUrfGfOnNnYZDKpfH19TXPmzDlVWFioWrp0abBKpZI//vhj4DvvvHNuy5YtPl5eXuY33ngjPT4+vm2nTp3yfv/9d5/c3Fz1Bx98cKZnz543zIB17Ngxt4KCAtV7772X8tlnnzUuTcjmzp0b+Msvv/hZLBZx6tQpj2HDhl00Go2qVatWBWq1WsuiRYuOBwUFmY8dO+Y2fvz45pmZmRp3d3fLv//977MdO3YsGjFiREtfX19TcnKyp16vL2jXrl3hgQMHvGbMmHEuLS1NM3bs2Bbnz593A4ApU6acjYmJyR88eHBYenq6rqSkRPXMM8+kjxw58rJ9vJMnT268efNmv+LiYlWXLl3yZs6ceValUqGs483Pzxcvvvhiq9OnT7u3bNmyqKio6IYp4D755JOGV65c0Q4aNKiNr6+vac2aNccAYMKECaFbtmzxdXNzs3z77bcnmjRpYrp48aJm7NixLS5evKgDgIkTJ567//77r5vpa86cOQ0HDhx4JTo6Oh8AVCoVnnzyyUxAqZxNmjSpeXFxscrNzc0yffr00x06dCieO3du4MaNG31LSkpUhYWFqhkzZpx55pln7ty+ffthALh48aL2kUceuTMtLc0tLi7uysSJEy8AgNlsxvDhw1sePXrUs3nz5kVffPHFGW9vb8uuXbs833nnnWYFBQUqPz8/08yZM880bdrUOGfOnKAlS5YEG41G0axZs+Ivv/zytLe3t2XEiBEtvby8zElJSV5XrlzRvvHGG6mlMZNrS4mPUGUZTdN8NepXBe/wXOOkRVrMRmn29dbqaup0Hzide7phw4ZBWq3Wu0Z2ULZAAB9CmTp/CoCvEhISSmo5BiIiqiCXHbLoSExMTN769euPbNmyJSk+Pv7q9OnTG4WFhZU89thjl4YOHZqemJiY5CjZMpvN4tdff02eMGFCyvTp05s46nvJkiUBcXFxV2NjY/POnTvnfuHChWvJ8KlTpzy+/vrrU2vWrEn+7LPPQj08PCxbtmxJ6tKlS/63334bCACvv/56i/fff//c5s2bk99+++1Ug8FwbWjdmTNn3FeuXHnso48+SrXd5/jx45tHRkbmbt26NWnTpk1JnTp1KgKAWbNmndm8eXPy+vXrkxYuXBhy6dKlG4ZQjho1KmPjxo3J27dvP1xUVKRauXLltQvSHR3vnDlzGrq7u1u2bt2a9Nprr104duyYl32fY8aMyQgMDDQuW7bsWGkyVlRUpAoPD8/bunVrUnh4eN68efOCAcBgMDR7/vnn0zdu3Jg8d+7ckwaDoaV9f8ePH/fo0qVLgaPzrdfri9asWXNky5YtSWPHjj0/ZcqUpqXPHTp0yHv27NmnV69efcx+u6SkJK8vv/zy1MaNGw//8ssvAaXDLlNSUtyHDh16aevWrUleXl6W2bNnB5eUlIi33367+bx5805u3rw5+Yknnrg8efLkUAAYNGhQ5saNG5O3bt2aFBYWVjh37tyg0n1cunRJu27duiPz588/Pm3atFBH8ZNrOdG/a0iO0bTHT6sZw2SsdljMsgQAfDy1NTahx8Y/Mo83adKkZU31XwGNoUyVf8xgMDxrMBhqbLg8ERFVHStkNs6dO6d79tlnm165ckVrNBpVTZo0Ka7IdgMGDMgEgIiIiPx3333X4fUe69atC/j6669PqNVq9OrVK3Pp0qX+r7zyyiXrdrm+vr4WX19fi5eXl3nAgAFZANCuXbuC5ORkz5ycHNWhQ4e8X3jhhbDS/oxG47UPbXFxcZkazY0v5d69ext89dVXpwFAo9HA39/fDAAzZ84M+fXXX/0AICMjQ3v06FH34ODg66pPv/76a4Mvv/yyUXFxsSonJ0dz5513FsI6FNLR8e7evdv7ueeeywCArl27FoaFhTlMlOxptVr58MMPZwNAly5d8hMTE32s/fmcOnXKo7Rdfn6+Ojs7W+Xr61uhoY5ZWVnqkSNHtkpJSXEXQkiTyXTtfEVGRuYEBQWZHW0XGRmZExwcbAaABx54IPO3337zfvjhh7OCg4NLSit0jz322JW5c+c2TEpKyj59+rTHE0880QYALBYLAgMDjQBw4MABj48++ig0Ly9PXVhYqO7Wrdu1YaR9+/bNUqvV6Ny5c1FmZmaNfRik20NSn7sf1KnEUh+tprpm4aMKkGZpBABvD22NXKOXW2jK3ZmcfaVXr4BeNdF/JbUAMBfAeIPB8K+EhITFzg6IiIj+xITMxoQJE5o/99xzFx999NHsDRs2NCir2mXPzc1NAoBarYbZbL7h2+19+/Z5nD9/3m3IkCFtACWZatKkSXFpQqbT6a5NV6xSqa71p1KpYDabhcVigbe3tykxMTHJ0f49PT0rfD3Whg0bGuzYsaPBunXrjnh7e1vi4+PbFhUVXVcpLSwsFJMnT26xZs2apJYtWxonTZrUpLi4+Fqbso63Kl/sq9VqqVIpXZceLwBIKbFu3bpkLy+vMqdybt26deH+/fs9Bw0alGX/3JQpU0K7deuWu2jRopMnT57UPf74421Ln7vZ+bI/htLHjtZLKUXLli0L169ff8S+n3HjxrX68ssvT4SHhxfOnTs3cOfOndcusrd9vaXkTNWubM8Dnf8R7Kb9QCUERyvUMotZmgDAy0NTI1+KHEstSAWABg0atKyJ/quoDYBFBoPhRQAvJSQkHHZ2QERExCGL18nLy1OHhoYaAWDx4sXXZlH09vY25+XlVXmox9KlSwOef/75tH379h3ct2/fwYMHDx64fPmy7tSpUxX6ZtbPz8/SuHHjkkWLFvkDSiVm7969HuVtFxERkfv5558HA4DJZEJWVpYqOztb7ePjY/b29rYcOnTI/fDhwzcMLSwsLFQBQHBwsCknJ0e1fv16//L2FRkZmbds2bIAAPjjjz/cT548ecMMiwDg6elpzs3NLfd9d++99+bMmjWrYenjPXv23HC8L774YsaPP/4YuH379mvHsGDBgoDz589rcnNz1Y0bNy4BgIULFwbZb1uWXbt2+Vy+fFmdn58vNm3a5BcVFZUHABkZGbqtW7d6AcCKFSsCIiIi8vR6fVFWVpamdH1JSYnYv3+/OwAUFBSomjRpYiwpKRGrVq0KqOj+yTXMvPsOsbNXpx9C3HUfMRlzDotJqZB5uWtqpEK2/2Tu6caNG4doNBqHvwud7H4AfxgMhmmckZGIyPlc9oOAdbKKzqXLtGnTQkaPHp02atSosH79+rX19/c3lbaNi4vL2rhxo19MTIx+06ZNlb44++effw546KGHrqvi9OzZM3PJkiUV/qD++eefn1q8eHFQdHS0vnv37h3WrFnjV942CQkJ53bt2tWgR48e+l69eukPHjzoER8fn202m0V0dLR+6tSpTTp06JBvv11AQID50UcfvRQbG9vh6aefbq3X629oY2/kyJEZBQUF6ujoaP1nn33WqH379g63efzxxy8//fTTd8bHx7e5WX8ffPBBysGDB72io6P1UVFRHebPnx9s36ZJkyamTz/99NS7777b9N577+0YFRXVYdeuXQ18fX0tL7300sVp06Y17du3bzuz2eHoRIe6dOmS98ILL7Tq1atXhwcffDCzW7duBQDQvHnzokWLFgVGR0frs7OzNSNHjrzk5uYmZ8+effL9999vGh0drY+NjdXv2LHDGwBefvnltAEDBrR/5JFH2rRq1aqowgFQvbfp/g7e9wZ4/x7q4faks2NxZaUJmad7zVTINuy7erxx48a1NbtiVWgAjAVwxGAwPObsYIiIXJlwxpCppKSkhX5+fu1rfcdEt4msrKxkvV4/1NlxUPXaENOhVUM3baK/TtO0/NZURU81W7Pnh9IHHaOC3wEgAeC5yZ0nlq7Pyyg+s+vzswsevb9522f6ta7W5Dgr35gVNfr3GQ888MCTfn5+bcvfok5YBWBUQkLCeWcHQkTkaly2QkZEVJt+jtbHNPPQ/cFkrG6wGJUKmbuu+itkR1MKUoUQoo5dP1aehwAkGQyGUQaDgTN9EhHVIiZkREQ1bHlU28dbe7v/4qlR82bPdYTZZDEBgLtOXe3XkP1xIvdkaGhoY7Va7VbdfdcwHwCzAGwyGAy8JQcRUS1hQkZEVIMWRt75yl1+Xv/RqVS324fzeu3PCpmq2itkP++5crJRo0Z1+fqx8twPYL/BYBjo7ECIiFwBEzIiohrQO8RPzItoPalHkM/HWpWqRmbyo6qzGJUbQ1d3hexKjvFqckp+rr+/f8vq7NcJAgGsMhgMnxoMBn6ZQERUg5iQERFVs94hfuLp5sEf9mroO0EjBO/3WAeZTZYSANBpqzchO5KSn6pWq1VeXl7Nq7NfJ3oFwE6DwXDTmXGJiKjqmJAREVWj3iF+4m8tgmfGBvu8rhaiyvcvpJpVWiFz01bvkMV9J3KON23aNFStrv5r05zoLgD7DAbD35wdCBFRfeSyCVloaGj4G2+8cW22s48++ihk0qRJTSrTx4YNGxokJiZeuynxiBEjWpbevLk2DB48OKx3797tanIf//rXv5r89NNPvHEoUQX0DvFTDWsRPCc6yOdFlRCcqa4OM5tkMQDotNU3nFRKKdfuunwqJCTkdr5+rCxeAOYbDIb/8GbSRETVq04MpWl44p/h1dlfRuupe8tro9Vq5caNG/3T09MvhoSEmMprb89oNGLbtm0NvLy8zDExMeXeOLk8FosFUkqo1RX7Qv3q1avqo0ePenl4eJhPnDiha926dcmtxmDPZDJh8uTJadXdL1F91DvETz0oNGBGdJDPcMFkrM6zGC3FAKDVqKutQnYp23j5THpRQZsufvUxISs1BMA9BoMhPiEh4YSzgyEiqg9ctkKmVqvloEGDLn322Wch9s+dOnVKN3DgwDbR0dH6gQMHtjl9+rQOUCpg//jHP5rGx8e3GTZsWNjSpUuDFy5cGBITE6PftGmTNwDs3LnTu0+fPu3Cw8M72VbLPvzww5BevXq1j46O1k+cOLEJAJw8eVIXFRXV4ZVXXmnes2dP/dmzZ3VhYWF3T5gwITQ6Olr/4IMPtktLS3OYNC9dutQ/Ojo6q1+/fleXLFkSULp+xIgRLV9++eXm8fHxbcLDwzv9+uuv3s8//3zLqKioDiNGjGhZ2m7t2rU+vXv3bhcbG9t+yJAhd+Tk5KgAoGvXrp0mT57cuG/fvm0XL17sb1v127Fjh2efPn3aRUdH6x944IH22dnZqpMnT+r69evXNjY2tn1sbGx724ohkavoHeKn6RPi91G/Rv4vqIRw2d+rtxNziZKQ6TTVVyFLOpuXqtFo1F5eXvX9XnNtoFxXFu3sQIiI6gOX/uAwatSojLVr1wZkZmZeV5YaP35880ceeeTK1q1bkx566KErBoOhWelzZ86ccV+5cuWx77///uRjjz12aejQoemJiYlJPXv2zAOAS5cuadetW3dk/vz5x6dNmxYKKMnPmTNn3Dds2JC8efPmpMOHD3tu3LjRGwBSUlLcBw8efGXLli1Jd9xxR0lRUZEqPDw8b+vWrUnh4eF58+bNC3YU++rVqwMeffTRq48//vjVdevWBdg+l5OTo/nxxx+PvfnmmykjR46888UXX0zftm3b4ePHj3vs2bPHIz09XfPZZ581Xr58+bHNmzcnd+rUqeCTTz65lpi6ublZfv7556NDhgzJLF1XXFwsXn755bB33nnn3NatW5OWLVt21NPT0xISEmJasWLFsc2bNyfPnj371MSJE+vLhexEFdI7xE/VI7DBpEGhAS+pOYHHbcNcokx7r9VU3zVk+07kHm/WrFkzlUrlCu+DQAAbDAbD084OhIjoducKfzTK5OfnZxkwYMCVmTNnNnR3d7eUrj906JDXd999dxIAhg0bdvXjjz++9m1nXFxcpkZT9mnr27dvllqtRufOnYsyMzO1ALB582afnTt3+sTGxuoBoLCwUHXixAn3Fi1alISEhJT06NHj2pBHrVYrH3744WwA6NKlS35iYuINN5JNS0vTpKamut1///15KpUKarVa/vHHH+533XVXEQA8+OCDWSqVCp07dy7w9/c33n333YUAEBYWVnjmzBm31NRU3ZkzZ9zj4+PbAYDRaBSdO3fOK+3/8ccfz7TfZ1JSkntQUJAxKiqqoPTcAUBeXp4YPXp0i2PHjnmoVCqkpqZyemRyGb1D/ESEv/cbTzUPHsup7W8vpmJllkWtRlTL62aRUq7eeel0izZdo6qjv9uEDsBCg8FwZ0JCwkRnB0NEdLty6YQMAEaPHp3ep08f/cMPP3y5rDa2l4N4enpaymoHADqdTpb+LKW89u+IESMuvPjii9ft4+TJkzrbRBBQhlKqVErhUqVSwWw233AtypIlSwJyc3PVERERnQCgoKBAvWzZsoC77rorzTYGlUoFrVZ7LR6VSgWTySTUarWMjIzMWbBgwWlHx+Dl5XXDMVqPRdqvnzFjRkhQUJDxq6++Om2xWHDHHXdU6/WARHVZJx/PF4a1CH7TXa3ycHYsVDmmYrNSIVNXT4Us/WpJ+oWrJUWdfX3r8/VjZfmXwWBoDeDZhISEYmcHQ0R0u3HpIYsAEBQUZO7du3fmihUrgkrXderUKf/777/3B4CFCxcG2FaPbHl7e5vz8vLKnYWjZ8+eOUuXLg0qvU7r3Llz2gsXLlQ5GV6zZk3AvHnzju/bt+/gvn37Dq5evTrpp59+Cih/S0VUVFT+/v37vY8cOeIGAHl5eaqkpKSbVrY6dOhQdPnyZd2OHTs8ASA7O1tlNBqRm5urbtiwoVGtVmPBggWBFstN81WiemNYi4aD/t6y4XteGvUNVWyq+0xFSoVMU03XkB0+m5ei0+m0Xl5eodXR323oKShDGIPKbUlERNdx+YQMAF599dWLOTk51xKkqVOnnlu6dGlQdHS0/n//+1/g1KlTUxxtFxcXl7Vx40Y/20k9ymiXM2DAgKtxcXHtevTooX/uuefCcnNzq3R/opMnT+rS09N13bt3vzbMsXXr1iVeXl7m7du3V2hCjUaNGpk+/PDDM6NGjbojOjpa379//3ZHjhxxv9k2bm5ucubMmSfffvvt5tHR0fpBgwa1KSwsVA0fPjxj5cqVgQ8++GC7U6dOudtX/Ijqo/6N/GOfvyPkAz+dJtDZsVDVGAvNSkKmFtVSIfv9WM7x5s2bNxeuPalLD/Am0kRElSZKh9XVpqSkpIV+fn7ta33HRLeJrKysZL1eP9TZcdCNeof4hb8U1mhWuL/3vc6OhRx6qtmaPT+UPugYFfwOrMOtn5vc+dp1Tts/OfVhUZapcOl7sW9qbnHYosUiLTGv7/mgTYeImCZNmnS/lb7qiYsAeiUkJCQ7OxAiotuBK3+TR0RUKb1D/Jo+0iRgEpOx25+xwFIiBKBW3XqF7Pzl4gtXcowlfn71+v5jldEIwCaDwcAvXomIKoAJGRFRBfQO8fOO9PeeFNfYv5+zY6FbI6W0mEss5gaeWm113MP70Nm8VA8PDzcPD4/G1RBefRECJSnTOzsQIqK6jgkZEVE5eof4aVp6uhmGtWw4mPcau/1Js3IPsgae2mqZ0GP3kexjzZo1aymqI7urX5iUERFVABMyIqKb6B3iJ9xU4m8vhjX6m4daVebkPXT7sJQmZB7aWx6uaDJL09rdl88FBwe3vOXA6qeGUJKyDs4OhIiormJCRkR0c32fvyPk+WA3ratOZ17vWExKQublobnlClnKpaILOQVmk69r3n+sohoC2MikjIjIMSZkRERl6B3i17F3Q9/hd/l63ePsWKj6lFbIvNw1t1whO3g675y3t7enu7t7yK1HVq+VVso6OjsQIqK6xqUTsrNnz2oHDx4cFhkZ2TEiIqLja6+91qy4uLjGrwFISUnRDhky5I6a3g8RVV3vED9fAE919PUM5aVB9cK1ez+WVsg83W+9Qrbrz+vHbrUrVxAMYL3BYGjp7ECIiOqSOnFx+uLDQ8Ors7/BHRbuLa+NxWLBs88+2/qvf/1rxvDhw0+aTCa89NJLLd5+++3QDz/8MLU647HXrFkz43fffXeqJvdBRFXXO8RPDWAEANP04xd+fjQ0IK1viN8ArUpVLZNAkFPckJB5uKlvqUJmNFmM636/fD4ism3fWw3OhTQCsM5gMHRPSEi46uxgiIjqApetkK1fv76BTqezDB8+/AoAaDQafPDBBymrVq0Kys3NVY0bN65pjx499NHR0foZM2Y0BIBdu3Z5xsXFtY2NjW3/l7/85c7U1FQtAMyZMyeoV69e7aOjo/VPPfVUWF5engoARowY0XLMmDHN+vTp0y48PLzTokWL/AHg5MmTuu7du3co/blfv35tY2Nj28fGxrZPTEz0cs4ZISIbDwMIAmABgOXnrx6cdixtzpViY5pzw6JbcO3vncUkTQDg4aa+pQT7THrR+cJii9nHx4fXj1VOOwCrDAaDu7MDISKqC1w2IUtOTvbQ6/UFtuv8/PwsISEhJV9//XVQamqq26ZNm5K2bt2aNGTIkCslJSXi7bffbj5v3ryTmzdvTn7iiScuT548ORQABg0alLlx48bkrVu3JoWFhRXOnTs3qLTPS5cuadetW3dk/vz5x6dNm3bDpAAhISGmFStWHNu8eXPy7NmzT02cOLF5zR89EZUjHYCwLgCAY3lFmW8dOjd3f1b+b1JK50VGVXWtQmY2WowA4K67tQrZwdO553x8fLzd3d2Dym9NdroDYt4X05Nc9nMIEVGpOjFk0RmklBBC3PCpSkqJ33//vcHQoUMvaa0zIgcFBZn/+OMP99OnT3s88cQTbQBlyGNgYKARAA4cOODx0Ucfhebl5akLCwvV3bp1yy7tr2/fvllqtRqdO3cuyszMvOGPv9FoFKNHj25x7NgxD5VKhdTUVLcaO2giqpD16Vnbe4f4nQAwHIAXgBIAKJHSMuPEhfW9G/qefiQ08C/uahUr2rePP4csGpUKmbvu1ipkO5KyjzVr1ozVsaq51Mi/dxcAUwGMd3YwRETO5LLfTLVv377w8OHD132YysrKUmVkZOgcJWtSStGyZcvCxMTEpMTExKRt27YlrVy58jgAjBs3rtWUKVPObdu2LWnUqFFpJSUl186rTqeTNn3cEMeMGTNCgoKCjFu2bEn69ddfk4xGo8u+JkR1yfr0rHQAHwA4DMDzuucysk9MSU6dk1ZYwmtBbx+2QxZLAMDtFhKyYqOl+Kc9V9ICAwOZkFWa6kTTwEeKPXSN9ADGfTE9aZizIyIiciaX/fDfp0+f3KKiItX8+fMDAcBkMuGf//xns4EDB16Ojo7OWbhwYbDRaAQAXL58Wa3X64uysrI0W7du9QKAkpISsX//fncAKCgoUDVp0sRYUlIiVq1aFVCZOHJzc9UNGzY0qtVqX3HrMwAAIABJREFULFiwINBisVTzkRJRVa1PzzKtT8/6DsAPAHSw+Z15vqgk7+3D5xb+diVng0VK/set+8zXfjBalIRMW/Uhi6cuFKaazFL6+Pi0rIbYXEZhgelKaMAjTbWaBk1tVn/5xfSkHk4LiojIyVw2IVOpVJg/f/6JtWvX+kdGRnbs1q1bRzc3N8u77757fsSIEZcaN25cEhMT0yE6Olr//fffB7i5ucnZs2effP/995tGR0frY2Nj9Tt27PAGgJdffjltwIAB7R955JE2rVq1KqpMHMOHD89YuXJl4IMPPtju1KlT7u7u7vxgR1THrE/P+j8ACQCyAVybiEAC+Pp0xvavTqfPyzOZs5wVH1XItSEKFpMsBgCdtuqzZh48nXvW39/f183Nzb86gnMFhfkio23zof46rZf9ZB46AMu/mJ7U0glhERE5nXDGxelJSUkL/fz82tf6joluE1lZWcl6vX6os+Og6/UO8VMBGAigO4DrJwXSqt1ebt14wB1e7rzxrXM91WzNnh9KH3SMCn4HSjLm+dzkzm8AQOrurJ+Prs3Y+d6Iuwd2vMO/a1V28vLMI19kmEIbtWnT5uHqCbv+klLCWORzqW3LR4LLaXoAwL0vvKav1BebRES3O5etkBERVdb69CzL+vSslQC+gvL789rESFlGc/F7yanLfr6YucpkUe5zRXWT2Wi5pQpZYYm5cOMfVy/y+rHyWSwWs8rcPLMCyRgAdAbwUU3HRERU1zAhIyKqpPXpWcehzA53HoCH7XOLU6/83ycn0r7MLDGlOyU4Ksu14SBmozKph1ajqtI1ZCfOF6ZKCfD6sZszmcyFXtq7C1qG9qzMsM6Xv5ieFF9jQRER1UFMyIiIqmB9elYhgDkAfoaSlF27Z1lSTuHltw6d/epQdsFuZ8VHN/hzUo8SZVIPnaZqFbIDp3LPBAUFBWi1Wp/qCq6+KSkx5gQ3eACNgro0qMLm87+YntSo2oMiIqqjnJWQceIKopvj/5E67J6PNobc89HGsVn/WC7Wp2dtBDADgAnK5AQAgCKLNH98PG3df1MvLyo2WwqdFiyVMl37oVi5MbSmihWyzQcyj4eGhnK4YhmKCk1XWgQP8vDzae5RfmuHggEs+GJ6kii3JRFRPeCUhMxsNifzfltEjhmNRpXZbE52dhx0U/MBTAPwyz0fbWy8Pj0rDco9y47C7p5l6y5mHU04en5OelHJWSfESX+6dl2fqUipkGnVla+Q5RWa87YdyroU8P/t3Xl83HWBP/7Xe47MZHJOczVt0gsKJRxiywCGQw2gKCqIGkTB293vd4/v/tyv/bm7nrt+110d/VZXV6nAKiKrzCLCQgEZGK4SoKmlpe30vtKk6eSayTH3fD7v7x+fmTSmTTNJM3lPZl7Ph30k85nrFa1JXn1fixaxkJ1BNIy+1c2fdNrt1bM+UiDtPQD+di4yERHlO8v0D5l7iUTieyMjIzCbzReB0yaJJtI1TduTSCS+pzoInc7Z0uo8/7P/5y4A70tfugHADpfb95nOQOgpAA/c1FDtAnA7jAKgA8CxSHzkq7u6HvizVQ3XX+Esf6dJCP7L//w7NUIW02a9huxAT7gb4PqxM4lHHf0tqz5aP4cv+Z2NG/wv/PmXWrbN4WsSEeUdJYVs3bp1OowzfYiIFgRnS+t5pYtXfkvq+h3C9Cf/jlQH4EmX2/dDAH/XGQh13tRQfQDAnwFwAogDgA7Iew4HXrq2JnLk4821H3FYzFx/NL9OFbKoZkxZNIsZj5DtODx2ZPHixfUWi6VsLsMtZFJKHakloTUrbspmJ8WZKAHwm40b/Gv//Est4Tl+bSKivMHRKSKiaThbWu0Qpk/VX3v7u4TpjKMqAsCXAHS43L7V3kAoBGNK41ZM2oVx8+Bo1zf9x392LBLfm/vkNMF4IUtGjSmLlllMWfS9OXSwsbFxxRzmWtA0TYvbTZeMrWq6aVGO3uICGGs0iYgKFgsZEdH07qq7+gNXWyucTdM8bh2AbS63725vIKR5A6HfwVhvZk7/AQAMJlKxf/Qff/j5vtAmTcrUVC9Gc+pUIYtoSSEAi1nMaMriSCQ10rl/ZIjrxwyJRGp0Udm7tCX163I92vv5jRv8H8nxexARKcNCRkR0Fs6W1itsNUvWVa5e+64sn1IO4Fcut+9Bl9tX7g2E9sKYot0PwD7xgQ91DWz9ycHee4eTqf65TU1nkAIAKaVMxfVUeanFOtOlfPuOh7uFEKK8vHxFLgIuJLFYcqip9lbboqqVjukfPSd+snGDn9N8iaggsZAREU3B2dJaCuDWhus+eqMwW2Y6ve0uAG+63L513kAoDODHAF7ApF0YdwxH+r62q+vevaNRblyQW0kAkJpxKHSFo2TGG3psPzR6aMmSJYstFot9+kcXrmhE7z9v6SeqykprZnWO2ywtBvCteXw/IqJ5w0JGRDS1jy96+w2Xljjrz5/l88+Hsa7sb0NffhTeQOgPAH4CQAIYLwRhTU9+b1/PE4/1DP5XQtdjc5CbTqcBgK4ZxazCMeOCjT9sHTy4ePHiFXOca0GJRWx9a5Z/qq7EUmqe/tFz7q83bvBfrOB9iYhyioWMiOgMnC2taywVznXVF19z0zm+VAmMDT42udy+Om8g1AVjCuNhTNrw4797g/7v7eu5pz+e7D7H96TTpQBAT8kkAJTZLTMaIQuOJoO7j4VHnE5nUa4fk1LqWrxu8KKVd9SbTMp+dbDAGGkmIiooLGRERJM4W1qtAO5ouPYjrSZryVytkXkfjDPLbvAGQnFvIHQ/gMdhrCsbX8x0OBwf/uqurl9sC469IqWUc/TelJ6yqGu6UchKZzZCtud4uNtkMpnKy8uX5yJcPtM0LVEiLho9f9n7alRnAfDujRv8d6gOQUQ0l1jIiIhOd3tZ85pme8Pyy+f4dRsBPOty+/7F5fZZvIFQB4DvA4gCsGUelJJS/8mhk74Hu/ofjGr62BxnKEZmGP8dQ08Zu1o6bDMbIdt+cPTQ0qVLl5jN5vlcN6VcMpkKV5dek2xquLJKdZYJvr9xg5/nwBFRwWAhIyKawNnS2gxgXY3r5jYx0234smMC8HcAXnG5fSu8gdAAADeA7Zg0hfHF/pEj/+g//rPuSPxADnIUExNOFbIkAJTaZjZC9nTnwKHFixcX1XTFeCwZXOL8gKXWeUG+lZ8mAF9XHYKIaK6wkBERpTlbWgWAO6ovua6ppKo21798Xw1gu8vta0+fWfYwgF/DWCczvmFCXzwZ+ab/+H++3D/8B01KLceZCtXEEbJ0ITNnPUI2MJwYOHgiOuZ0OlfkJl7+iUa0/lVL7qwsL6u3Tf9oJb60cYP/AtUhiIjmAgsZEdEp64TJ3FB9yTXvmaf3qwLwsMvtu9fl9jm8gdBOAN8FMIQJZ5ZJAL881v/6PYdO3j+a1IbmKVshMQOIAICe1FMAUGrLfuqh/1i422w2m8vKypblKF9eiUYsfRcuu7u2xOpQsZNitkoA/JvqEEREc4GFjIgIgLOl1QLg/bVX3XKxpbR8vjcv+AKArS637zJvIDQK4IcAXsakM8v+GAr3fn1318aDY9Ed85xvoRsvZFp6hMxWkn0h23Zw5GBzc3OTyWSy5ChfXpBSylTMOdCy8hP1ZrMlF9N159p7N27w36Y6BBHRuWIhIyIy3GRxVFZXnH/5uxS9/0UA3nC5fX/pDYSkNxB6CsDP0veNT68bSWmJ7+zteWxTb/D3SV1PKEm68Ahkpiwm04XMmt2URSml3PTGwOGGhoaCXj+m63rSop83vHr5B2tVZ5mhf964wb8QyiMR0ZRYyIio6DlbWh0Arq29+pYrTJaS0mmfkDt2AD9xuX2/d7l9i7yB0BEYZ5Z1YdKGH7/rGXzrB/tPbByMJ0+oCLrASAAJANBTMg4ANqspqxGyQDDR1z0Qj1ZXVxdsIUulUpGKkivjy5ZcW606yyy0APiw6hBEROeChYyICLjdUlZV4mi68ErVQdJug7Hhx3XeQCgG4OcANmHSmWX7x2JDX93Vdf+OUPg1Hll2VjrS55BpSWNUMdsRMv+xcLfVarU4HI6lOcynTDyeDDVUvc9cX9NSrjrLOfiq6gBEROeChYyIipqzpbUOwGU1V9x8hclsyacd5ZoBvOBy+74V+vKjJm8g9DKADTBGesZHdxJS6j862Pvsw90DD8U0PawqbJ47bYSsJMsRsq0HRg4sW7ZsmclkyucNLmYlGtEGVjbcUV5Z3phPf+9nY+3GDf6bVYcgIpotFjIiKna3mUvL9bJlF16lOsgZmAF8E4DP5fY1eQOhAIxdGHdj0hTGZwPDB/95T/c9vdHEYQU5853EqRGyOABYLaZpR8h0Xeqb3hg4Wl9fX3DTFaNhU9+Fy+6qsdnKC2Wjkq+pDkBENFssZERUtJwtrYsArK654r3rFK8dm871AHa43L5bvYFQyhsIPQTgYQA2TPg+3hNLjH1td9eDHYMjz+lS6qrC5iEd6REyLZH9CNmJoXigL5SIV1VVFUwhk1IiEa3sb1l1V73ZbC2kzTCu2bjB/07VIYiIZoOFjIiK2W0mW2mqfPnFraqDZGERgMdcbt9PXG6f3RsIbYOx4ccwjGIGwBgKuu9I36v3Hgn8x1hKCynKmm90ABoAaAk9CQBW8/QjZLuPjh232+0lDoejMcf55oWu6ymTtjx44Yrb6lRnyZHT1pIJIf5DCNEnhNg14drHhBC7hRC6EOKKqV7sTM9NX/+uEOItIcSvJly7WwjxN3P1hRBRcWEhI6Ki5GxprQZwYe0V711rspY4pn1C/vhLGNvjX+QNhIZhrCt7HZPOLHtjaKznm7u77jkSju1WETLPpHa91i8BQIsbm3pYLdOPkHXuH9nf3Ny8XAix4H9WplJatMy6Nrpi6bucqrPk0E0bN/gnb8zzSwCT15ftAnA7jLP+zua05wohqgC0SikvA2AWQlwqhCgF8BkAP51dbCIqdgv+hwwR0Sx9CCZTsmzFJe9QHWQWLoNxkPQXvIGQ7g2EHgdwL4zv6eNrgoJJLf7tPd2PPBsI/XdKN87fKlKpzCfJ2HghO+sImaZJbdPrA111dXULfrpiIp4cqa+8EYtrL6tQnWUe/MkomZTyZQBDk67tkVLum+6FzvRcGKOtJUIIAWMdZxLAegD/JmVR/3+MiM4BCxkRFR1nS2sFgBbnpdevNpfYK1XnmSUHgHtdbt/DLrevyhsIHYAxhfEEJm348dvjA2/+8OCJnwcTqYCKoHlg/BflVFwzpixOM0LWPRDrDYVTyYV+/lgsmhpcXv/R0qqK5nxeIzmXPrhxg//SXL24lHIUwO8AvAngCIwpwy4p5eO5ek8iKnwsZERUjD4IIFVx3uUu1UHmQDuAN11u39XeQCgC4GcAnsWkUuYfiQ58ddexe3cPR7aoCKmYlvkkFTVGyCxmcdZCtvPo2HGHw1Fqt9sbch0uV6Jh9K1u/qTTbq/K6sy1AiEAfCWXbyCl/J6U8nIp5f8G8G0A3xBCfEEI4RFCcLdHIpoxFjIiKirOltYSAC2lS86rLqmqXdCjHxOsBPCKy+37u9CXH4U3EHoewL/BKCLjxSOmS+0HB048/Uj3wG/jmh5VFVaB8RGyZNQYIbNMs6nHlr3j68cW5E6E8UhZf8uqT9VbzLZi/Dn/0Y0b/DW5fhMhxNvTn+4H8CkpZTuAS4QQq3P93kRUWIrxGzURFbdrAFicl1xbCKNjE1kA/AuAZ11uX6M3EOqBcWbZPkwaLXvqZGjfv+7ruScQSxxTkFOFU2vIIloCAMxmMWUhS2p68qktA8cX4voxXdc1JJcOrln5kULdSTEbNgB3z8P7fBvANwBYYZwZCBhrzBbSJkFElAdYyIioaDhbWgWAq0w2h2ZvWPE21Xly5EYYZ5a9zxsIJbyB0AMAHgFgx4Tv+cci8ZGv7e56YMvQ6Iu6lFJV2HmSAgAppUzF9FRZqcViOsvI17FA7EQ4pmkL7fwxTdNiDvPbwiubbsj56NAC8EUAEEL8BsBrAC4UQnQLIT4vhPiwEKIbwDsAbBJC/CH92CVCiKcyL3Cm50647zYAnVLKE1LKEIDXhBA7Yfw12zFvXyURFQTL9A8hIioYqwDULLr83WtMFqtt2kcvXHUANrncvg0A/r4zEOq8qaH6IIxfUp0A4gCgSch7DgdeurY2cuTjTbUfcVjMC3WDk+loACA1Y+pipcN61vVju46OdVVUVJTZ7fYFM8qUSKRG6yrbzIuqVhTq/4Yz1bJxg79VSnnnFPf/fvIFKeUJAO+fcHuq50JK+RiAxybc/jKAL88+LhEVM46QEVExuRFApHz5xVMeBltABIC/BdDhcvvO9wZCQQA/ALAVk6ZUbR4Y7fqW//g9XZH4XgU550MSAHTN2Ja8wmE96/qx1/zD+5ubmxfM6Fgsmhpsrr3NtqhqBafK/akvqg5ARJQNFjIiKgrOltZyACsdS1fXWsoqF6vOM4/WAdjmcvvu8gZCmjcQ+h2AX8CYIZFZ94KBRCr6Lf/xh319w09pUqamerEFKvWBa5pFppCVlVqmHCFLpPTEM50DJ2pra1fMW7pzEA3L/tVNn3Q6ShdNe9B1EfrYxg3+MtUhiIimw0JGRMXiRgBa5QVXXKI6iAIVAB50uX2/crl95d5AaA+MDUD6YawtG/frrv7Ofz/Ye99wMjWgImiOJAGYZSpdyOyWKUfIjvRGexIpqVdWVub9CFksYutbs+LuOoulKHdSzEYZgA+rDkFENB1+EyeigpfezONSAMnSxStzdmjsAnA3jNGytd5AKAzgxwBewKRdGLcPRwJf29X1872j0W0qQs4xM4AYAKue0pMA4LBPPUK288jYserq6kqbzbZovgLOlJRS1xP1gxetvKPeZOKP8WncpToAEdF0+J2ciIrBMgBV5SsvXWK2O5yqwyi2GsBrLrfvS+kzy/4A4N8BSBjbdwMAwpqe/N6+nicePzH0SELX46rCzgELgCiAEi09QlZqM085QrZ5d2h/U1NT3o6OaZqWKBEXjZ7XfDN3UszOjRs3+ItpijIRLUAsZERUDN4JIFJx/tuLeXRsohIA/xfAky63r84bCHUB+FcAhzFpw4/HTwztdu87cc9APNmtIOdcMAOIALDq6ULmsJ15hCyW0KLPbRs8WVNTk5eFLJlMjVWXXptsariySnWWBcQMYMrdEomI8gELGREVNGdLqwnAeRAmaa9fdrHqPHnm/TDOLLvBGwjFvYHQ/TC28rbB2KURAHAoHAv9w66uX2wLjm2WC+/MsvERMj1lbFZiLzGfsZAdOhHt0XTIysrKFfOYLyvxWDK4ZNEHrLXO1dykYuY+oToAEdHZsJARUaFbDaCscvXa5eYSe4XqMHmoEcCzLrfvOy63z+INhDpgbI8fhVHMAAApKfWfHDr5/K+7+h+MavqYqrCzYEF6hExL6plCdsYpi28dGTtaU1PjLCkpyasRqGhE71+15M7Kckd9IZ+dl0vrNm7w16sOQUQ0FRYyIip01wIIl6+4eI3qIHnMBODvAbzscvtWeAOhAQDfB7Adk6YwvtA/cuSf/Md/1h2NH1CQczYyUxZL9aRMAIBtihGyl98KHli6dGleTVeMhS19a5bfXVtidZinfzRNQQB4j+oQRERTYSEjooLlbGm1AFgOQNpqlpyvOs8C8A4A211u38e8gVDKGwg9DOBBGJt9jBeCQDwZ+ebu4//5cv/IHzQpNVVhZyAJwKGn0oXMajpthCwS18Iv7Qz25cv6MSmlTMUXDVy06hP1JpNZTP8MmsbNqgMQEU2FhYyICtlFAErt9cucZnsZd6XLThUAj8vtu9fl9jm8gdBOGBt+DGHCFEYJ4JfH+l6/59DJ+0eT2pCirNkQABIAHHrK2C2yxHr6CNmB7kiPlEBFRcWKec53Gl3Xk1Z5/vDqZR+oVZ2lgLxn4wY/iy0R5SUWMiIqZC4A4YpVb+Po2Mx9AcBWl9t3qTcQGgXwIwCvYtIUxj+Gwr1f39218eBY9C0VIbMgYIyQlWpJmS5kp4+Q7Tg8eqS+vr7WarWWz3fAiVLJVKTCdnW8ufGaapU5ClAdgHWqQxARnQkLGREVpPRh0E0AYG9YzkI2OxcB2OJy+/7CGwjp3kDoSQD3wCg5lsyDRlJa4jt7e37/VG/w90ndmBaYR8ZHyLSkngCAEovptBEy3/ahA0uWLFE6XTEeT4YWO99nrl+0RmkpLGCctkhEeYmFjIgKVR2AKmG1mUuqavNiXdACZQfw7y6371GX2+f0BkKHAfwLgC4ApRMf+EjP4Fs/2N+zcSiR7FURdAoajEJWqqdHyKyWPx0hG42kRt/YOzK4aNEiZX9PohFtYGXDHeUVZY3cSTF3WMiIKC+xkBFRoXIBiFWed/lyYbaccZtzmpEPwziz7DpvIBQDcC+Ap2AUtvG1OfvHYkNf3dV1/1uh8Gt5cmRZCkYps6QSZx4h29cd6QbUrR+LRsx9Fy67q8ZmK7dM/2g6B1dv3ODnVFAiyjssZERUqFYDSDqaVp+nOkgBaQbwgsvt+2boy4+avIHQSwA2wBiBGi85cV1qPzzY++zD3QMPxTQ9oipsJs6u1/olAIsWMwrZ5BGyHYdHDzc2NjZYLJbSM75CjkgpkYxV9res/GS92WzlhhO5ZwZwo+oQRESTsZARUcFxtrSWAKgHgJLqhmWK4xQaM4BvAfC53L4mbyAUAPA9ALsxaQrjs4Hhg9/Z2/2z3ljiyPzHHBdLf7Sk4noSAKyTRsi8fxw82NjYOK/TFXVdT5m0FcELlt9WN5/vS5y2SET5h4WMiArRBQBKhKXEbCmrbFQdpkBdD+PMsg95A6GkNxB6CMDDMEbKxn+2dEcTY1/f1fVgx+DI87qUuoKcpwpZTEsAgMV8qpCFxpKhHYfHQvO5fiyV0qLl1iuiK5a+0zlf70nj3qs6ABHRZCxkRFSI1gIIly1bs1iYzOZpH02zVQPgcZfb92OX22fzBkLbAHwXwDAmnFmmA/K+I32b7zsS+EU4pYXmOWOmkFmTMWOEzGIR41MW9x6PdAshRHl5+fL5CJOIJ4frK28SDbWXVMzH+9FpmjZu8PMfaYgor7CQEVEhqgcgSxtXNasOUiT+Csb2+Gu8gdAwjHVlr2PSmWWvD411f2N31z1HwrHd85gtmv5oTkWNETLrhBGy7YdGDi1dunSJ2WzO+e6G0WhqcHn9Rx1VFU32XL8XndXlqgMQEU3EQkZEBcXZ0moBsAgAbM7FTYrjFJPLAPzR5fZ9Pn1m2eMA7oPxc2Z898BgUot/e0/3I88GQk+kdJmch1ynRsgiWhIAzOZTI2TPdA4eWrx48Ypch4iG0Xdh892L7PYq7vip3ttVByAimoiFjIgKzRKkp8tZK2tYyOaXA8B9Lrfvty63r9IbCO0H8K8AemFsjz/ut8cHtv3o4ImfhxKpQI4zZUbILMmonnTYLRaTEAIABkcSg/u6I6NOpzOn68fi0fL+llWf4k6K+YMjZESUV1jIiKjQXAIgVuJsKDfbSqtUhylSd8DY8OMqbyAUAfBTAF5M2oVx90h04Ku7u+7bPRLpzGGW8UIGAJUO6/gI1Z6ucLfZbDaVl5fnZCdOXdc1JJuG1qy4nTsp5hcWMiLKKyxkRFRolgFIOpouWKo6SJFbCWCzy+37u9CXH4U3EHoewL/BOKR5fA1XVNNTP9h/4qnfdQ8+HNf06FQvdg4y56BZAKDcYRl/720HRw82NTU1mUymOZ9GqKW0mMNyeXhlU9uiuX5tOmfnb9zgL1cdgogoI6tC1t7ebmpvb6+dcPvS9vb2W9vb2xfnLhoR0azUA4DNubhedRCCBcC/AHjW5fYt9gZCPTB2YdyHSaNlm04G9353X889fbFk1xxn6JiQBaU2SyUASCnl01sGDjc0NMz5dMVEIjVSU9GmN9ZdXjnXr01zQgB4m+oQREQZ0xay9vb2VgD9AALt7e33tLe33w3jrJnvA9jX3t5+TY4zEhFlxdnSWgmgAgCslYs4TSx/3Ahgh8vtu9kbCCW8gdADAH4HY63f+Lqqo5H4yFd3H/tl59DYS7qUci7eeNdr/WMfuKbZjHQhK7NbLADQF0oOHA3EItXV1Svm4n0yYtHUYHPth+3OyuWO6R9NCnHaIhHljWxGyNwAPgfgNgBfBJDweDwtHo9nNYDvAPg/OcxHRDQTy5D+Bd/iqOIIWX6pB/CUy+37vsvts3oDoS0AvgcgjAlnlmkS8meHT774wLH+ByIpbWSO3nt8mmJ1eUkMAPzHxo5brVZLWVnZnB2NEI3IvtVNn3Q6Sp0l0z+aFGMhI6K8kU0hu8jj8TwO4EkAKQC/n3DfjwBcmotgRESzcD6AKIRJmEvLalSHodMIAP8bQIfL7TvfGwgFAfwAwB8x6cyyVwZGjn3Lf/yerkh83xy8rxXGzztRW2ULA8C2g6MHmpubm00m05wcHB6P2PvXLL+73mKxcW32wsBCRkR5I5sfHDoAeDweCWCvx+NJTLhPg/GDjogoH9QD0Ox1TVXCZLZM+2hS5QoA21xu313eQEjzBkKPAPgljGmF4wVpIJGKfst//Lcv9A0/pUmZOof3y4xYlZ3fVNmrSyk3vdF/tL6+/pzXj0kpdT3RMLhmZXudycQutoBcsnGDn98jiCgvZPPTY297e/tqAPB4PJMXwV4J4MicpyIimp1qALDVLuXoWP6rAPCgy+17wOX2lXsDIT+MDUD6MWnDjwe7+jv//WDvfcPJ1MAs38sKo+hpyxeXh08OJQK9Q4nYua4f0zQtbhMtY+c1v5d/3xYeO4ydQImIlMumkN0KYKpdr1IA/tfcxSEimh1nS6sAUAkAJVV1/AV54fgUjNGytd5AKAzgxwB8mDSFcftwJPC1XV0/3zca3TaL9yiBMV1ysC+UbNx9dOy4zWYrcTgcsz4aIZlMjTkd12tLG1zcSXHhWqI6ABERkN516mw8Hs+rr0mzAAAgAElEQVTgWe57Y27jEBHNWgWMzSFSlvJqp+owNCOrAbzmcvu+0hkI/RDAH25qqN4DY0MpK4AkAIQ1PfndfT1P3Lpk0eH3La7+YInJZDvLa05kT3/sORlMfGDrgZEDzc3Ny4QQs5pjGIslh5bV3VpW5qjN9v0pPzWqDkBEBJzjwdDt7e2W9vb2/5irMERE56Ae6fVHZpujQnEWmrkSABtcbt+TLrevzhsIdcGYwngYk0bLHj8xtNu978Q9A/Fkd5av7YBRyrbHk7pz0xsDx2a7fiwa0fvPW/KJKpaxgsARMiLKC+e6AtkM4NNzEYSI6BytABADAJOttFxtFDoHt8A4s6zNGwjFvYHQ/QAeh1Goxs8sOxSOhf5hV9cv3gyObc7iyDIHgGT/mOX47qNjkcGRZKKqqmrGhSwWtvatWX53bYm1dE52ZiTlOEJGRHlh2imL7e3tvrPczR9KRJQv6gEkAMBcYucI2cLWCMDrcvv+FcA3OwOhV29qqN4H4AsAqgDEASAlpf7jQyefb6urOnLX8robMfUv2KUA+oYiluUvvRXsKy0ttZeWli7ONoyUUmrx2sGLVt3Cs+0KC0fIiCgvZDNCdhWMBdYPneHPb3IXjYhoRsantZmsNo6QLXwmAP8A4GWX27fcGwgNAPg+gB2YNIXR1z98GMDbADw9xWuVwdgR+O37uiOBZcuWLRdCiCke+yd0XU9a5erh1ctvqZ3tF0J5iyNkRJQXsjmDYzuM88cemXxHe3u7DcBP5zwVEdHMlQKAubS8RJgtJdM9mBaMdwDY7nL7vthpnFf225saqv0A7oBxFqYOAM2btvYfv+WKWwCcaUOXEgBbAXwYgKytrc1qumIymQo7HdfIukUXVs/FF0J5h4WMiPJCNoXshwCGprgvCeCzcxeHiGjWSgGgpLqe0xULTzWA/3K5ffcC+JvOQOitmxqqj8CYwtiA9NrB5k1bJc7886qrJ2Q9CaOsRbNZPxaPJ0NLa26xV5Qttk/3WFqwOGWRiPKCyGIxNBFR3nO2tH4TgKi84Irl9dfc9hnVeShn/ADu6FzftuumhmoTgPcDuM4bCH3lbE9avXr1WgB3lpeXy/e85z3rzzZjMRrR+s9r+pjTZi3P5h8taWEr+/MvtURUhyCi4pb1D5v29vYLAFwM46yfUQC7PR7P/lwFIyLKlrOl1QxjhCxmLi13TPd4WtBaAHS63L6/7QyEfgbgyZsaql/I4nlvAxBubm5uOWsZC5v7Llx+Z53ZbM1qjRkteEsAHFQdgoiKWza7LC4D8DCMH2aHAAwDqARwXnt7+w4AH/d4PF05TUlEdHblSO/6arKUWBVnodyzA/ipy+27EcAXOgOhYBbPaQSAqdaPSSmRijv7W1Z9iDspFpdGsJARkWLZ7LL4CwCvAKj1eDyXejyeaz0ez2Uwtph+BcAvc5iPiCgb44VMWKwsZMXjdhhnll17tgetXr26AunNPiorK08rZLqup8z6qtAFyz9Ul5uYlMcqVQcgIsp22/uveTyeP5lj7fF4wgC+kb6fiEglB9KHBptYyIpNM4AXXW7fN1xu31Q/0y4GIKuqqirsdnvNxDtSqVS03HpFdPmS67iTYnGyqQ5ARJRNITsO4ANT3Pd+AJyuSESqlcLYAh3CzEJWhMwA/hGAz+X2LT3D/RcDiDQ1Na2YeDERTw43VL1XNNRewp05ixcLGREpl82mHn8F4Hft7e1/C+NAzswassth/JD7SO7iERFlpRTp86g4ZbGovRPGFMbPda5v++8J109bPxaNpgZWNX6sym6r5N+X4sYzC4lIuWlHyDwez/MAzgPwAIxzx+oBpNK3V3s8Hl9OExIRTW/CCJmFv2AXtxoAj7vcvh+73D7b6tWrqwFUAafWj0XDou/C5rtrWMYIHCEjojyQ7bb3ZQAGAPx08lb37e3td3o8nt/MeTIiouydGiFjISPDXwG4ruSSNndil09ftGhRdUlJSXUiWt7fsup27qS4QMk0QOrGJ8ZH4x5k/pO+nrkhxy9KSAlI2O0VAQnoYWgp1V8TEVE2297fDMAD4AiA1e3t7b8E8Ncej0dLP2QjABYyIlLJjswI2dkOmaJi87bSqz/6H6byRc8sHdsvkWwaunBFW053UpRGP9CR6Q6TC4OUuoScUBxwWmEYv515kfFrQPq6cTXzAunH6qduQwJSQkJH+raE1CGFcR3QIQFA6OnHGdcACYhTzwN0QEgAUkDo0nicFGL8evqjkAKQ0vhovI9Ifw5T+mPmmtCNDXiEDggpMteEkJAmCQFdwCSFEBLCJEXmtYQJxv+3M39On+EjJn08Gy1am/6s4u9n9b80EdHcyWaE7J8B3OnxeDa1t7c3APg1gMfb29tv93g8CWT3rY+IKJdsSI+QSV3XFWehPCJM5hL7ZTd9aCj4tuF9JeXxvSPHetMFQoyXCgGTUXbExOunioKAUQ4mPm9CYdAhTFIYYPxMNJ85DObpJ+ZMmgkREamWTSE73+PxbAIAj8cTaG9vfx+MUvZUe3v7h3KajogoO6e+l0ldO8vjqEiFnfVV4Ry+PqsPERHNVjbb3gfb29ubMzc8Hk8KwJ0wtrt/DlP9SyAR0fyR459whIyIiIgWkGwK2XMAPjvxgsfjkR6P53MA3oKxdoOISKXxEiZ1jpARUdaiqgMQEWVTyP4CwPfPdIfH4/kfAFbMZSAiolk4VcKkxhEyIsrWmOoARETTriFLb9yROMv9XXOaiIho5lIw/oFJ5wgZEc0ACxkRKZfNCBkRUb5LIb2vgtQ1FjIiytao6gBERCxkRFQIksgUsmRiyhF9IqJJOEJGRMqxkBFRIchMWUQqNpbL3c2JqLCwkBGRcixkRFQIxg+p16JjEcVZiGjhYCEjIuVYyIioEAwjvUlRKjLCQkZE2eIaMiJSjoWMiApBEJlCNhZiISOibMQ617eFVIcgImIhI6JCEEH6LLLkyBALGRFlo0d1ACIigIWMiApDBIAOAFJL6noqGVech4jyX7fqAEREAAsZERWGKNIjZAAgUwnutEhE0+EIGRHlBRYyIlrwgv4OHcZOiwAALR4dVhiHiBYGjpARUV5gISOiQhHLfJKKjAypDEJECwJHyIgoL7CQEVGhOFXIwsNBlUGIaEHgCBkR5QUWMiIqFOPnCSVHBjlCRkTTOa46ABERwEJGRIUjhPT3tPjQSRYyIprOXtUBiIgAFjIiKhzHAdgBINbXxUJGRGfT1bm+bXT6hxER5R4LGREVim4AZgDQ45GknoyPKc5DRPlrt+oAREQZLGREVCiGMOEsMi06xlEyIpoKCxkR5Q0WMiIqCEF/RxTGAdEAgOTo0EmFcYgov7GQEVHeYCEjokIyPk0xPnTyhMogRJTXWMiIKG+wkBFRIRnJfBI9eaRXZRAiylsSgF91CCKiDBYyIiokPQAsABA5cahfalpScR4iyj+HO9e3hVWHICLKYCEjokLiB1AKANA1mYqMBNTGIaI81KE6ABHRRCxkRFRIegCkMjeSI4NcR0ZEk7GQEVFeYSEjooIR9HfEAYQyt+NDJ7mOjIgme1V1ACKiiVjIiKjQDGY+ifYe6lEZhIjyzjC4wyIR5RkWMiIqNCeQ2dij50C/noyPTfN4Iioer3eub9NVhyAimoiFjIgKzamNPQAkQn1HFGYhovzC9WNElHdYyIio0HQDSGRuRANdLGRElMH1Y0SUd1jIiKigBP0dCQD9mdtjR3YeVhiHiPJHDMBrqkMQEU3GQkZEhagLgBkA4gPdw1osElSch4jUe6FzfVtEdQgioslYyIioEP0RgCNzIx48yVEyItqkOgAR0ZmwkBFRIeqCMT0JABA7eZTryIjoKdUBiIjOhIWMiApO0N+hATiZuT1ycNshKXVudU1UvPZ0rm/jP8wQUV5iISOiQnUU6fPIUmOhWHJk8JjaOESkEKcrElHeYiEjokK1FYA9cyPae2SvwixEpBYLGRHlLRYyIipUJwGMZG6M7N+6V0qpMA4RKRICsFl1CCKiqbCQEVFBCvo7JIBjAAQAxAdPjKTGQt1qUxGRAr/rXN+WUh2CiGgqLGREVMheA1CWuRHpPbRbYRYiUuMh1QGIiM6GhYyICtkhAOMHwQ7veWM3py0SFZVuAC+qDkFEdDYsZERUsNLb33chPW0xMdQ7mhod6lKbiojm0W8617fxX2GIKK+xkBFRoXsVgCNzY+zYnjcVZiGi+fVr1QGIiKbDQkZEhW4/JkxbDO58abeupeIK8xDR/NjVub7tLdUhiIimw0JGRAUtPW3xCNLf7/R4NBkLHNupNhURzQNu5kFECwILGREVg+cwYdri8N4t2xRmIaLcSwL4leoQRETZYCEjomLQA6A/cyN8bHdvKjx8UmEeIsqtRzvXt51QHYKIKBssZERU8NKHRP8RgD1zbaxrzx/VJSKiHPux6gBERNliISOiYrEZgJ65EXzr5Z1S05IK8xBRbrzZub7tVdUhiIiyxUJGREUh6O+IATiM9JlkWmQkHg0c3aE2FRHlAEfHiGhBYSEjomLiw4TNPYa2+zqklDw0lqhwDAD4jeoQREQzwUJGRMXkCIBQ5kYscCwYHzyxR2EeIppb93Wub4upDkFENBMsZERUNNKbe7yKCZt7BHe+vFldIiKaK1LKJICfqs5BRDRTLGREVGw2A4hnboSP7u5NDA8cUZiHiOaAEOLBzvVtx1XnICKaKRYyIioqQX9HCsBWALbMteE9r3NHNqIFTEqpAfiO6hxERLPBQkZExeg5TNgCf3jP64dS4REeFE20QAkhftu5vu2Q6hxERLPBQkZERSfo74gC2AXAkrk2vG/Ly+oSEdFspUfHvq06BxHRbLGQEVGx2gTAmrkR3PHinuRYsEdhHiKaBSHEf3aub9unOgcR0WyxkBFRUQr6O0YA7MeE74PBHS89py4REc2UlDIF4J9U5yAiOhcsZERUzB7DhM09RvZvPZoI9h1UmIeIZkAI8cvO9W38/ywRLWgsZERUtIL+jkEAuzFhLdngtmefk1KqC0VEWZFSjgL4muocRETnioWMiIrdo5jwvTDctTcQ7+/eqTAPEWVBCPGdzvVtAdU5iIjOFQsZERW1oL9jDMa5ZCWZawOdT/ukrmvqUhHR2UgpjwDYoDoHEdFcYCEjIjJ2XBwvYLG+rlCke/8bCvMQ0VkIIb7cub4trjoHEdFcYCEjoqIX9HfEAbwCwJ65Ftj86ItaPDqsLhURnYmU8qXO9W2Pqs5BRDRXWMiIiAw+AJHMDT0eSQZ3vvK0wjxENImUUhdC/I3qHEREc4mFjIgIQNDfkQLwJABH5lpo58v74kO9PHCWKH9s7FzftkN1CCKiucRCRkR0ypsAjmPC98a+Vx97WmqppLpIRAQAUtdPCCG+ojoHEdFcYyEjIkoL+jskgF8DsGauxQd6hkeP7HxJXSoiAgBhMn2+c33bqOocRERzjYWMiGiCoL8jCGAzAFvmWn/Hf7+Wioz2qUtFVNyklnqoc33bM6pzEBHlAgsZEdHpngEQztyQWlLvf+PJx6Su6wozERUlqWmDwmz5a9U5iIhyhYWMiGiSoL9DA+DBhA0+wkd3944d2fmislBExcokvtC5vi2oOgYRUa6wkBERnUHQ37EfwF5MWE8W2Pzo5uTo0HF1qYiKi9RSj279/298THUOIqJcYiEjIprafwJIjd/SNRl4+ZFHdS2VUBeJqDjoWqpPmC1/pjoHEVGusZAREU0h6O+IwShl41MXY31doeE9r/PAaKIcMg6ANn2kc33boOosRES5xkJGRHQWQX/HPgBbMWHXxcHOZ7bHB0/sUZeKqLDpidh3tn7lxs2qcxARzQcWMiKi6T0KYBSAyFzofeG3T2jx6LC6SESFSYuFt5htpd9UnYOIaL6wkBERTSPo70gB+AUAe+ZaanQo2t/xuEfqWmrqZxLRTOipxLDZXvbBzvVtPGKCiIoGCxkRURaC/o5eAM9jQikbO7rrRMj/2iZ1qYgKh5RSSk1r71zfxkPYiaiosJAREWXPC6AbgCVzYbDzme2RE4e2qotEVBi0WNi97Wu3PKs6BxHRfGMhIyLKUtDfIQHcD2Mr/FPryZ779dPJ0WC3smBEC1xyLPTcm9/40FdU5yAiUoGFjIhoBoL+jiiAezBh10WpJfXe53/9sJ6Mj6lLRrQwpSIjh4UQH1Sdg4hIFRYyIqIZCvo7TsLYebE0cy0RDIz1v/6kR+qapi4Z0cKiJWLDqfDIu9/81odjqrMQEanCQkZENAtBf8cWAH/EhE0+Rg++eXxox4uPSimlumREC4PUUolkqP8DO7/3qS7VWYiIVGIhIyKavUcABACYMxeC21/wj+zf+gd1kYjyn5RSxgZ6/mqn+9M8/JmIih4LGRHRLAX9HTqAnwPQMGGTj/6Ox98Id+3tUBaMKM/F+4//267vf/Ze1TmIiPIBCxkR0TkI+jvCAH4CwDrxeu/zD3ljfcd3qklFlL+igWOene7P/H+qcxAR5QsWMiKicxT0dwwA2IgJ68kAiZ5n/uOxRKj/sKpcRPkmevLo8z1P3ftx1TmIiPIJCxkR0RwI+juOAXgIE3ZelFpS73nm/oeTY6ET6pIR5YdoX9eWvs2Pvj99nh8REaWxkBERzZGgv2MngCcwoZRp0bFEz9P3PZgKD59Ul4xIrdhAz86B1598V98bTyZUZyEiyjcsZEREcyjo79gM4FVMKGWpsVCs+6n7fpUKjwTUJSNSIx4M7A/uePG6k688ElWdhYgoH7GQERHNvScAbAdgy1xIjQWjPc/cz1JGRSUeDBwM7Xzl2u5n7h9WnYWIKF8Jnl9KRDT3nC2tAsAnAFwKIJa5bil3li59/xfutpZVNSoLRzQPYv3de/pff+LdJ1/+L/4jBBHRWbCQERHlSLqU3QWgBUA8c93sqLQ13fLFu63lzqXKwhHlUKT38I6TL/z2fYNvPterOgsRUb5jISMiyqEJpexiTBgpM5eWlyy9+XPtJdX15ykLR5QD4a69b/Q+/+vbg/4O7i5KRJQFFjIiohxLl7I7AbwNwPjGBsJkMS25+bMfLG1YfrmycERzaPTwWy8GXvJ8LH02HxERZYGFjIhoHqRLWTuAt2PCSBkALH73x99dvuKS65UEI5oDUko5sn/r0/0dj38i6O/gBh5ERDPAQkZENE/SpewWANdhwkgZANRe+f61VS1X3yKEibvf0oKia6nE0Lbnfxva9cpfBv0dY6rzEBEtNCxkRETzzNnSeg2AD2FSKau++JrVNetu+pgwW6xqkhHNjBaLhPpe/f394a49Xw/6O3jOGBHRLLCQEREp4GxpvQjApzFp+mLZ8osb66+57Q6zrbRKTTKi7CRGBrtPPv+f/54IBf5v0N+RUJ2HiGihYiEjIlLE2dK6FMBfANAA6Jnr1soaR+MNd32kpLpulbJwRGcRPXlkZ+/zD31XT8R+E/R36NM/g4iIpsJCRkSkkLOltQrA/wJgA5Aav8NkFovf9fG2smVrrhVCqIpH9Cek1OXogW0v9b362LeC/o6XVOchIioELGRERIo5W1rtAL4AoAmTpjA6L7t+jfPytttMZotNSTiiND0RG+vf8tTjowe2fTvo79inOg8RUaFgISMiygPpHRg/BOAaAJGJ95U2rqppuP5jd1gcFXVKwlHRS4T6jvT6fuNJDve7g/6OQdV5iIgKCQsZEVEecba0XgrgEwASAMa/QZtsDmtj2503ly5euVZZOCo6Uur66KEdm/s2//53kPrPg/6O2PTPIiKimWAhIyLKM86WVieA/wmgHEYxG1d9yXUXLLr8XR8yWW1lSsJR0dDikVD/a088OXZk528APB30d/AXBiKiHGAhIyLKQ86WViuAuwFciEnnlVkrax2L33XHB201jWuUhKOCFw0cfevkCw8/o0VH7wv6Ow6ozkNEVMhYyIiI8lR6Xdk1AG4BkMSErfEBoOaKmy+varn6Zm74QXNFi0eHh7Y99+zw3jdeAvDLoL8jrDoTEVGhYyEjIspzzpbWagCfA1CPSbsw2mqbqhqu/+htJVW1K1Rko8IgpUT0xKEtgZf/61UtFt4EwMcpikRE84OFjIhoAUiPlr0HQBuMUvYn37xr1r3nsqqLrnoP15bRTGmx8ODAlqefGT20fReAXwX9HSdUZyIiKiYsZEREC4izpXUxgM8CqAQQn3if2VFpa7ju9htKG8+7QvA0aZqG1HU9fHxvR98rv3tDT8Z9AJ4J+jv0aZ9IRERzioWMiGiBcba0mgHcCuAqnGG0rGz5xY21V958i7XcuVRFPsp/8aGT+/tff+LFWODYAQAPBP0d/aozEREVKxYyIqIFytnSWg/gLgANmLQTIyBQe9X711VesO4Gk6WkVEE8ykOpyEjf0I4Xnx3Zu6UHgBdcK0ZEpBwLGRHRApZeW3YVjJ0YTTB2YxxndlTa6q66pbWs+cJ3CLPFqiIjqacnE5GRg9teGNjy1B7oeheAB4P+jpDqXERExEJGRFQQnC2tdgAfAXA5gAgmTWO0VtWV1V11y/WljavWCZPJrCIjzT+pa6lIz4EtfR2Pb9EiowMAHgv6O3arzkVERKewkBERFRBnS2sTgDsB1MEoZn/CXtdcXXPl+95tr2u+lBt/FC6pacnIiYNbBzqf2ZIc7h8D8AKAF7hpBxFR/mEhIyIqMOlpjG+DMY2xEqetLwMcTRfUL3r7De+01Sy5iMWscEgtlYj0HOwc6Hz69eTIoA5gO4DfB/0dp/0dICKi/MBCRkRUoJwtrSYA7wBwI4BSTDpUGgDsDcudiy5ve0fp4hVvFyazZb4z0tzQtVQi0r1/y0DnM6+lRocEgKMAPNw9kYgo/7GQEREVOGdLqwXAuwC8E4AFk84vAwBrZY1j0dobXWVNF15pspY45jkizZIWj4TCx/dtHdr2/LZUOGQCcBjGOrFe1dmIiCg7LGREREXC2dJqA/BeAOsA2HCGETNTid2yaO2Nl1esvPRqs72sZr4z0vSklEgODxweObhtS2jXqwcg9VIAh2BMTQyozkdERDPDQkZEVGTSI2bXALgWQDWA8OmPEqi8YN3yitVr19prll4kzGZuma+YrqUSsZNHtwd3vrwl2ns4BMAO4ACMEbE+xfGIiGiWWMiIiIrUhM0/bgSwGEYxO+2HgtlRYXNeev0lZcsuWmstr14yzzGLmpRSJkcGj0W6970V3PnKbi06ZoZx1pwfwDNBf8eQ4ohERHSOWMiIiAjOltYVAN4PYDkADUDiTI9zNF9YX7Xm6rWlDcsuNllt5fMYsaikwiMnIycO7gz5X9uZGOodA+AAMAjgNQAdQX9H8uyvQERECwULGRERjXO2tJbD2PzjcgBOTDFqBmESlee/fVn5yktb7HVNLaYSO8vZOdJikWA0cGTX8N7Ot6InDg4AKAFgBnAEgBfA4aC/gz+0iYgKDAsZERGdJj2dcQWAGwCshLE74xRnWQmUr7p0afmKS9bY65svtJRW1M1XzoVM6rqeHB3qivV1HRg7svNApOdAP4wCZgfQD2AngM1Bf8eo0qBERJRTLGRERHRW6d0Zr4KxO2MjAB1n2KExw16/rLp8xSWr7PXNK0qq6lZy9OwUPREbiw+dPBA5cfDAyIE/HtYio3EAAkAZgBCA/QBe4PlhRETFg4WMiIiylp7SeDWAS2BsBGICEDnbc0qXnFdbtuyiFfa65pUlVXUriumcMy0WHkwMDxyPD/Qcj/QcOB7pOdifngFqgXFY9yiMs8NeAtDFKYlERMWHhYyIiGbF2dLqAPB2GDs1LoUx1S4MYwRtCgKljStrShtXNdqcixutVTWNlrKqxSZLSel8ZM4lXUvFU+Hhk4lg3/FYX9fxsWO7j6dGhyZO88x8jX0w1oW9DqCXJYyIqLixkBER0TlLn222AsBaAE0A6mBsSjFNQTPYapuqHEvOa7TVNDZayp215tJyp9nmcJosVnsuc8+GnkrGtVh4IBUZGUyODPUnhnoD0cDRvvhAz/Ckh9pg/HcwBuAEgB0A3gr6O846okhERMWFhYyIiOacs6W1BMZmIGthjJ7VwignMUyxpf6ZWMqq7LbaJmdJdb3TWrnIaXFUVpttpWXCanOYLCWlJovVISzWUmEym881s5RSSi0V15PxMT0eHdHikVEtFh7RoqOjqfDwaHI0OBIfOjmcHO4/w0Ha4+vAdADDMEbBDgPYBaA/6O+YtpQSEVFxYiEjIqKcSxe0BgAXAVgGYBGAahijSEmcZZOQbJhsDqu1wumwOCpLhdliFiazgMlkEsJkEiazCSaTEMJkghBCTyWSeiKW0BOxpB6PJrR4NKHFxhJ6IpbK8u3MMM4F02GsnwvBKGA7ARwK+jvOVNiIiIjOiIWMiIiUcLa0mgHUA7gAxoHU5QAq0n9KYGx8kYJR1uZzhEng1HRDCeOg7CiMka9hAAMwdkM8AWCEa8CIiOhcsJAREVFeSZ+B5oBxMPVSAM0wyprtDH+sMHZ6NMEoTyL9Mqb0x8xtCaPU6ZNuJ2GUviiM9W5RGGu++gCchDH6NRL0d0xxBhsREdG5YSEjIqIFK72ZSClOFTOBUwVt4p8UjLVryfTHBACNo1tERKQaCxkREREREZEipukfQkREhUgIUS2EeEQIsVcIsUcI8Q4hxCIhhFcIcSD90XmG510uhHhNCLFbCPGWEOKOCfc9lL72nQnXvi6EuHW+vi4iIqKFhIWMiKh4/QjAM1LKNTAOd94D4O8APC+lXA3g+fTtySIAPiWlvBjAzQB+mC53lwGAlPIyANcJIaqEEI0ArpRSPj4PXw8REdGCw0JGRFSEhBCVAK4HcD8ASCkTUsoQgFsBPJB+2AMAbpv8XCnlfinlgfTnJ2BsgFEHY31WqRDCBGOHQg3APwH4Rm6/GiIiooWLhYyIqDitAtAP4BdCiDeFEPcJIcoANEgpewEg/bH+bC8ihLgSRvk6JKXcA6ALwDayi/MAAAGWSURBVDYAHgDnw1ir/GYOvw4iIqIFjZt6EBEVISHEFQBeB3CNlPINIcSPAIwA+GspZfWExwWllKetI0vf1wjgRQCfllK+fob7nwDw5wA+C2NKpFdKee+cfzFEREQLGEfIiIiKUzeAbinlG+nbjwBYCyCQLlqZwtV3pienpzxuAvC1KcrYrQC2AigDcImUsh3A3UIIx5x/JURERAsYCxkRURGSUp4EcFwIcWH60g0A/AD+G8Cn09c+DeC0zTiEECUAfg/gV1LK/zrD/VYAfwPADeOA58xUjMzaMiIiIkqzqA5ARETK/DWAh9IF6zCMqYUmAB4hxOdhrAf7GDA+xfF/SCm/AKAdxoYgNUKIz6Rf6zNSyu3pz/8SwANSyogQ4i3j6WIngKfSG4cQERFRGteQERERERERKcIpi0RERERERIqwkBERERERESnCQkZERERERKQICxkREREREZEiLGRERERERESKsJAREREREREpwkJGRERERESkCAsZERERERGRIixkREREREREirCQERERERERKfL/ACLZF1jAvlL0AAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<Figure size 1080x432 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "### type your answer here\n",
    "\n",
    "explode_list = [0.1, 0, 0, 0, 0.1, 0.2] # ratio for each continent with which to offset each wedge\n",
    "\n",
    "df_continents['2013'].plot(kind='pie',\n",
    "                            figsize=(15, 6),\n",
    "                            autopct='%1.1f%%', \n",
    "                            startangle=90,    \n",
    "                            shadow=True,       \n",
    "                            labels=None,                 # turn off labels on pie chart\n",
    "                            pctdistance=1.12,            # the ratio between the pie center and start of text label\n",
    "                            explode=explode_list         # 'explode' lowest 3 continents\n",
    "                            )\n",
    "\n",
    " # scale the title up by 12% to match pctdistance\n",
    "plt.title('Immigration to Canada by Continent in 2013', y=1.12) \n",
    "plt.axis('equal') \n",
    "\n",
    "\n",
    " # add legend\n",
    "plt.legend(labels=df_continents.index, loc='upper left') \n",
    "\n",
    "# show plot\n",
    "plt.show()\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Double-click __here__ for the solution.\n",
    "<!-- The correct answer is:\n",
    "explode_list = [0.1, 0, 0, 0, 0.1, 0.2] # ratio for each continent with which to offset each wedge.\n",
    "-->\n",
    "\n",
    "<!--\n",
    "df_continents['2013'].plot(kind='pie',\n",
    "                            figsize=(15, 6),\n",
    "                            autopct='%1.1f%%', \n",
    "                            startangle=90,    \n",
    "                            shadow=True,       \n",
    "                            labels=None,                 # turn off labels on pie chart\n",
    "                            pctdistance=1.12,            # the ratio between the pie center and start of text label\n",
    "                            explode=explode_list         # 'explode' lowest 3 continents\n",
    "                            )\n",
    "-->\n",
    "\n",
    "<!--\n",
    "\\\\ # scale the title up by 12% to match pctdistance\n",
    "plt.title('Immigration to Canada by Continent in 2013', y=1.12) \n",
    "plt.axis('equal') \n",
    "-->\n",
    "\n",
    "<!--\n",
    "\\\\ # add legend\n",
    "plt.legend(labels=df_continents.index, loc='upper left') \n",
    "-->\n",
    "\n",
    "<!--\n",
    "\\\\ # show plot\n",
    "plt.show()\n",
    "-->"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "# Box Plots <a id=\"8\"></a>\n",
    "\n",
    "A `box plot` is a way of statistically representing the *distribution* of the data through five main dimensions: \n",
    "\n",
    "- **Minimun:** Smallest number in the dataset.\n",
    "- **First quartile:** Middle number between the `minimum` and the `median`.\n",
    "- **Second quartile (Median):** Middle number of the (sorted) dataset.\n",
    "- **Third quartile:** Middle number between `median` and `maximum`.\n",
    "- **Maximum:** Highest number in the dataset."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "<img src=\"https://s3-api.us-geo.objectstorage.softlayer.net/cf-courses-data/CognitiveClass/DV0101EN/labs/Images/boxplot_complete.png\" width=440, align=\"center\">"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "To make a `box plot`, we can use `kind=box` in `plot` method invoked on a *pandas* series or dataframe.\n",
    "\n",
    "Let's plot the box plot for the Japanese immigrants between 1980 - 2013."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 1: Get the dataset. Even though we are extracting the data for just one country, we will obtain it as a dataframe. This will help us with calling the `dataframe.describe()` method to view the percentiles."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th>Country</th>\n",
       "      <th>Japan</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <td>1980</td>\n",
       "      <td>701</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>1981</td>\n",
       "      <td>756</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>1982</td>\n",
       "      <td>598</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>1983</td>\n",
       "      <td>309</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <td>1984</td>\n",
       "      <td>246</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "Country  Japan\n",
       "1980       701\n",
       "1981       756\n",
       "1982       598\n",
       "1983       309\n",
       "1984       246"
      ]
     },
     "execution_count": 15,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# to get a dataframe, place extra square brackets around 'Japan'.\n",
    "df_japan = df_can.loc[['Japan'], years].transpose()\n",
    "df_japan.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 2: Plot by passing in `kind='box'`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [],
   "source": [
    "df_japan.plot(kind='box', figsize=(8, 6))\n",
    "\n",
    "plt.title('Box plot of Japanese Immigrants from 1980 - 2013')\n",
    "plt.ylabel('Number of Immigrants')\n",
    "\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "We can immediately make a few key observations from the plot above:\n",
    "1. The minimum number of immigrants is around 200 (min), maximum number is around 1300 (max), and  median number of immigrants is around 900 (median).\n",
    "2. 25% of the years for period 1980 - 2013 had an annual immigrant count of ~500 or fewer (First quartile).\n",
    "2. 75% of the years for period 1980 - 2013 had an annual immigrant count of ~1100 or fewer (Third quartile).\n",
    "\n",
    "We can view the actual numbers by calling the `describe()` method on the dataframe."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [],
   "source": [
    "df_japan.describe()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "One of the key benefits of box plots is comparing the distribution of multiple datasets. In one of the previous labs, we observed that China and India had very similar immigration trends. Let's analyize these two countries further using box plots.\n",
    "\n",
    "**Question:** Compare the distribution of the number of new immigrants from India and China for the period 1980 - 2013."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 1: Get the dataset for China and India and call the dataframe **df_CI**."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": 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,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Double-click __here__ for the solution.\n",
    "<!-- The correct answer is:\n",
    "df_CI= df_can.loc[['China', 'India'], years].transpose()\n",
    "df_CI.head()\n",
    "-->"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Let's view the percentages associated with both countries using the `describe()` method."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": 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,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Double-click __here__ for the solution.\n",
    "<!-- The correct answer is:\n",
    "df_CI.describe()\n",
    "-->"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 2: Plot data."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": 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,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Double-click __here__ for the solution.\n",
    "<!-- The correct answer is:\n",
    "df_CI.plot(kind='box', figsize=(10, 7))\n",
    "-->\n",
    "\n",
    "<!--\n",
    "plt.title('Box plots of Immigrants from China and India (1980 - 2013)')\n",
    "plt.xlabel('Number of Immigrants')\n",
    "-->\n",
    "\n",
    "<!--\n",
    "plt.show()\n",
    "-->"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "We can observe that, while both countries have around the same median immigrant population (~20,000),  China's immigrant population range is more spread out than India's. The maximum population from India for any year (36,210) is around 15% lower than the maximum population from China (42,584).\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "If you prefer to create horizontal box plots, you can pass the `vert` parameter in the **plot** function and assign it to *False*. You can also specify a different color in case you are not a big fan of the default red color."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [],
   "source": [
    "# horizontal box plots\n",
    "df_CI.plot(kind='box', figsize=(10, 7), color='blue', vert=False)\n",
    "\n",
    "plt.title('Box plots of Immigrants from China and India (1980 - 2013)')\n",
    "plt.xlabel('Number of Immigrants')\n",
    "\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "**Subplots**\n",
    "\n",
    "Often times we might want to plot multiple plots within the same figure. For example, we might want to perform a side by side comparison of the box plot with the line plot of China and India's immigration.\n",
    "\n",
    "To visualize multiple plots together, we can create a **`figure`** (overall canvas) and divide it into **`subplots`**, each containing a plot. With **subplots**, we usually work with the **artist layer** instead of the **scripting layer**. \n",
    "\n",
    "Typical syntax is : <br>\n",
    "```python\n",
    "    fig = plt.figure() # create figure\n",
    "    ax = fig.add_subplot(nrows, ncols, plot_number) # create subplots\n",
    "```\n",
    "Where\n",
    "- `nrows` and `ncols` are used to notionally split the figure into (`nrows` \\* `ncols`) sub-axes,  \n",
    "- `plot_number` is used to identify the particular subplot that this function is to create within the notional grid. `plot_number` starts at 1, increments across rows first and has a maximum of `nrows` * `ncols` as shown below.\n",
    "\n",
    "<img src=\"https://s3-api.us-geo.objectstorage.softlayer.net/cf-courses-data/CognitiveClass/DV0101EN/labs/Images/Mod3Fig5Subplots_V2.png\" width=500 align=\"center\">"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "We can then specify which subplot to place each plot by passing in the `ax` paramemter in `plot()` method as follows:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [],
   "source": [
    "fig = plt.figure() # create figure\n",
    "\n",
    "ax0 = fig.add_subplot(1, 2, 1) # add subplot 1 (1 row, 2 columns, first plot)\n",
    "ax1 = fig.add_subplot(1, 2, 2) # add subplot 2 (1 row, 2 columns, second plot). See tip below**\n",
    "\n",
    "# Subplot 1: Box plot\n",
    "df_CI.plot(kind='box', color='blue', vert=False, figsize=(20, 6), ax=ax0) # add to subplot 1\n",
    "ax0.set_title('Box Plots of Immigrants from China and India (1980 - 2013)')\n",
    "ax0.set_xlabel('Number of Immigrants')\n",
    "ax0.set_ylabel('Countries')\n",
    "\n",
    "# Subplot 2: Line plot\n",
    "df_CI.plot(kind='line', figsize=(20, 6), ax=ax1) # add to subplot 2\n",
    "ax1.set_title ('Line Plots of Immigrants from China and India (1980 - 2013)')\n",
    "ax1.set_ylabel('Number of Immigrants')\n",
    "ax1.set_xlabel('Years')\n",
    "\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "** * Tip regarding subplot convention **\n",
    "\n",
    "In the case when `nrows`, `ncols`, and `plot_number` are all less than 10, a convenience exists such that the a 3 digit number can be given instead, where the hundreds represent `nrows`, the tens represent `ncols` and the units represent `plot_number`. For instance,\n",
    "```python\n",
    "   subplot(211) == subplot(2, 1, 1) \n",
    "```\n",
    "produces a subaxes in a figure which represents the top plot (i.e. the first) in a 2 rows by 1 column notional grid (no grid actually exists, but conceptually this is how the returned subplot has been positioned)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Let's try something a little more advanced. \n",
    "\n",
    "Previously we identified the top 15 countries based on total immigration from 1980 - 2013.\n",
    "\n",
    "**Question:** Create a box plot to visualize the distribution of the top 15 countries (based on total immigration) grouped by the *decades* `1980s`, `1990s`, and `2000s`."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 1: Get the dataset. Get the top 15 countries based on Total immigrant population. Name the dataframe **df_top15**."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    },
    "scrolled": true
   },
   "outputs": [],
   "source": [
    "### type your answer here\n",
    "\n",
    "\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Double-click __here__ for the solution.\n",
    "<!-- The correct answer is:\n",
    "df_top15 = df_can.sort_values(['Total'], ascending=False, axis=0).head(15)\n",
    "df_top15\n",
    "-->"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 2: Create a new dataframe which contains the aggregate for each decade. One way to do that:\n",
    "   1. Create a list of all years in decades 80's, 90's, and 00's.\n",
    "   2. Slice the original dataframe df_can to create a series for each decade and sum across all years for each country.\n",
    "   3. Merge the three series into a new data frame. Call your dataframe **new_df**."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    },
    "scrolled": true
   },
   "outputs": [],
   "source": [
    "### type your answer here\n",
    "\n",
    "\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Double-click __here__ for the solution.\n",
    "<!-- The correct answer is:\n",
    "\\\\ # create a list of all years in decades 80's, 90's, and 00's\n",
    "years_80s = list(map(str, range(1980, 1990))) \n",
    "years_90s = list(map(str, range(1990, 2000))) \n",
    "years_00s = list(map(str, range(2000, 2010))) \n",
    "-->\n",
    "\n",
    "<!--\n",
    "\\\\ # slice the original dataframe df_can to create a series for each decade\n",
    "df_80s = df_top15.loc[:, years_80s].sum(axis=1) \n",
    "df_90s = df_top15.loc[:, years_90s].sum(axis=1) \n",
    "df_00s = df_top15.loc[:, years_00s].sum(axis=1)\n",
    "-->\n",
    "\n",
    "<!--\n",
    "\\\\ # merge the three series into a new data frame\n",
    "new_df = pd.DataFrame({'1980s': df_80s, '1990s': df_90s, '2000s':df_00s}) \n",
    "-->\n",
    "\n",
    "<!--\n",
    "\\\\ # display dataframe\n",
    "new_df.head()\n",
    "-->"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Let's learn more about the statistics associated with the dataframe using the `describe()` method."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": 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,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Double-click __here__ for the solution.\n",
    "<!-- The correct answer is:\n",
    "new_df.describe()\n",
    "-->"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 3: Plot the box plots."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    },
    "scrolled": false
   },
   "outputs": [],
   "source": [
    "### type your answer here\n",
    "\n",
    "\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Double-click __here__ for the solution.\n",
    "<!-- The correct answer is:\n",
    "new_df.plot(kind='box', figsize=(10, 6))\n",
    "-->\n",
    "\n",
    "<!--\n",
    "plt.title('Immigration from top 15 countries for decades 80s, 90s and 2000s')\n",
    "-->\n",
    "\n",
    "<!--\n",
    "plt.show()\n",
    "-->"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Note how the box plot differs from the summary table created. The box plot scans the data and identifies the outliers. In order to be an outlier, the data value must be:<br>\n",
    "* larger than Q3 by at least 1.5 times the interquartile range (IQR), or,\n",
    "* smaller than Q1 by at least 1.5 times the IQR.\n",
    "\n",
    "Let's look at decade 2000s as an example: <br>\n",
    "* Q1 (25%) = 36,101.5 <br>\n",
    "* Q3 (75%) = 105,505.5 <br>\n",
    "* IQR = Q3 - Q1 = 69,404 <br>\n",
    "\n",
    "Using the definition of outlier, any value that is greater than Q3 by 1.5 times IQR will be flagged as outlier.\n",
    "\n",
    "Outlier > 105,505.5 + (1.5 * 69,404) <br>\n",
    "Outlier > 209,611.5"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    },
    "scrolled": true
   },
   "outputs": [],
   "source": [
    "# let's check how many entries fall above the outlier threshold \n",
    "new_df[new_df['2000s']> 209611.5]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "China and India are both considered as outliers since their population for the decade exceeds 209,611.5. \n",
    "\n",
    "The box plot is an advanced visualizaiton tool, and there are many options and customizations that exceed the scope of this lab. Please refer to [Matplotlib documentation](http://matplotlib.org/api/pyplot_api.html#matplotlib.pyplot.boxplot) on box plots for more information."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "# Scatter Plots <a id=\"10\"></a>\n",
    "\n",
    "A `scatter plot` (2D) is a useful method of comparing variables against each other. `Scatter` plots look similar to `line plots` in that they both map independent and dependent variables on a 2D graph. While the datapoints are connected together by a line in a line plot, they are not connected in a scatter plot. The data in a scatter plot is considered to express a trend. With further analysis using tools like regression, we can mathematically calculate this relationship and use it to predict trends outside the dataset.\n",
    "\n",
    "Let's start by exploring the following:\n",
    "\n",
    "Using a `scatter plot`, let's visualize the trend of total immigrantion to Canada (all countries combined) for the years 1980 - 2013."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 1: Get the dataset. Since we are expecting to use the relationship betewen `years` and `total population`, we will convert `years` to `int` type."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [],
   "source": [
    "# we can use the sum() method to get the total population per year\n",
    "df_tot = pd.DataFrame(df_can[years].sum(axis=0))\n",
    "\n",
    "# change the years to type int (useful for regression later on)\n",
    "df_tot.index = map(int, df_tot.index)\n",
    "\n",
    "# reset the index to put in back in as a column in the df_tot dataframe\n",
    "df_tot.reset_index(inplace = True)\n",
    "\n",
    "# rename columns\n",
    "df_tot.columns = ['year', 'total']\n",
    "\n",
    "# view the final dataframe\n",
    "df_tot.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 2: Plot the data. In `Matplotlib`, we can create a `scatter` plot set by passing in `kind='scatter'` as plot argument. We will also need to pass in `x` and `y` keywords to specify the columns that go on the x- and the y-axis."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [],
   "source": [
    "df_tot.plot(kind='scatter', x='year', y='total', figsize=(10, 6), color='darkblue')\n",
    "\n",
    "plt.title('Total Immigration to Canada from 1980 - 2013')\n",
    "plt.xlabel('Year')\n",
    "plt.ylabel('Number of Immigrants')\n",
    "\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Notice how the scatter plot does not connect the datapoints together. We can clearly observe an upward trend in the data: as the years go by, the total number of immigrants increases. We can mathematically analyze this upward trend using a regression line (line of best fit). "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "So let's try to plot a linear line of best fit, and use it to  predict the number of immigrants in 2015.\n",
    "\n",
    "Step 1: Get the equation of line of best fit. We will use **Numpy**'s `polyfit()` method by passing in the following:\n",
    "- `x`: x-coordinates of the data. \n",
    "- `y`: y-coordinates of the data. \n",
    "- `deg`: Degree of fitting polynomial. 1 = linear, 2 = quadratic, and so on."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [],
   "source": [
    "x = df_tot['year']      # year on x-axis\n",
    "y = df_tot['total']     # total on y-axis\n",
    "fit = np.polyfit(x, y, deg=1)\n",
    "\n",
    "fit"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "The output is an array with the polynomial coefficients, highest powers first. Since we are plotting a linear regression `y= a*x + b`, our output has 2 elements `[5.56709228e+03, -1.09261952e+07]` with the the slope in position 0 and intercept in position 1. \n",
    "\n",
    "Step 2: Plot the regression line on the `scatter plot`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    },
    "scrolled": false
   },
   "outputs": [],
   "source": [
    "df_tot.plot(kind='scatter', x='year', y='total', figsize=(10, 6), color='darkblue')\n",
    "\n",
    "plt.title('Total Immigration to Canada from 1980 - 2013')\n",
    "plt.xlabel('Year')\n",
    "plt.ylabel('Number of Immigrants')\n",
    "\n",
    "# plot line of best fit\n",
    "plt.plot(x, fit[0] * x + fit[1], color='red') # recall that x is the Years\n",
    "plt.annotate('y={0:.0f} x + {1:.0f}'.format(fit[0], fit[1]), xy=(2000, 150000))\n",
    "\n",
    "plt.show()\n",
    "\n",
    "# print out the line of best fit\n",
    "'No. Immigrants = {0:.0f} * Year + {1:.0f}'.format(fit[0], fit[1]) "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Using the equation of line of best fit, we can estimate the number of immigrants in 2015:\n",
    "```python\n",
    "No. Immigrants = 5567 * Year - 10926195\n",
    "No. Immigrants = 5567 * 2015 - 10926195\n",
    "No. Immigrants = 291,310\n",
    "```\n",
    "When compared to the actuals from Citizenship and Immigration Canada's (CIC) [2016 Annual Report](http://www.cic.gc.ca/english/resources/publications/annual-report-2016/index.asp), we see that Canada accepted 271,845 immigrants in 2015. Our estimated value of 291,310 is within 7% of the actual number, which is pretty good considering our original data came from United Nations (and might differ slightly from CIC data).\n",
    "\n",
    "As a side note, we can observe that immigration took a dip around 1993 - 1997. Further analysis into the topic revealed that in 1993 Canada introcuded Bill C-86 which introduced revisions to the refugee determination system, mostly restrictive. Further amendments to the Immigration Regulations cancelled the sponsorship required for \"assisted relatives\" and reduced the points awarded to them, making it more difficult for family members (other than nuclear family) to immigrate to Canada. These restrictive measures had a direct impact on the immigration numbers for the next several years."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "**Question**: Create a scatter plot of the total immigration from Denmark, Norway, and Sweden to Canada from 1980 to 2013?"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 1: Get the data:\n",
    "   1. Create a dataframe the consists of the numbers associated with Denmark, Norway, and Sweden only. Name it **df_countries**.\n",
    "   2. Sum the immigration numbers across all three countries for each year and turn the result into a dataframe. Name this new dataframe **df_total**.\n",
    "   3. Reset the index in place.\n",
    "   4. Rename the columns to **year** and **total**.\n",
    "   5. Display the resulting dataframe."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    },
    "scrolled": true
   },
   "outputs": [],
   "source": [
    "### type your answer here\n",
    "\n",
    "\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Double-click __here__ for the solution.\n",
    "<!-- The correct answer is:\n",
    "\\\\ # create df_countries dataframe\n",
    "df_countries = df_can.loc[['Denmark', 'Norway', 'Sweden'], years].transpose()\n",
    "-->\n",
    "\n",
    "<!--\n",
    "\\\\ # create df_total by summing across three countries for each year\n",
    "df_total = pd.DataFrame(df_countries.sum(axis=1))\n",
    "-->\n",
    "\n",
    "<!--\n",
    "\\\\ # reset index in place\n",
    "df_total.reset_index(inplace=True)\n",
    "-->\n",
    "\n",
    "<!--\n",
    "\\\\ # rename columns\n",
    "df_total.columns = ['year', 'total']\n",
    "-->\n",
    "\n",
    "<!--\n",
    "\\\\ # change column year from string to int to create scatter plot\n",
    "df_total['year'] = df_total['year'].astype(int)\n",
    "-->\n",
    "\n",
    "<!--\n",
    "\\\\ # show resulting dataframe\n",
    "df_total.head()\n",
    "-->"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 2: Generate the scatter plot by plotting the total versus year in **df_total**."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": 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,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Double-click __here__ for the solution.\n",
    "<!-- The correct answer is:\n",
    "\\\\ # generate scatter plot\n",
    "df_total.plot(kind='scatter', x='year', y='total', figsize=(10, 6), color='darkblue')\n",
    "-->\n",
    "\n",
    "<!--\n",
    "\\\\ # add title and label to axes\n",
    "plt.title('Immigration from Denmark, Norway, and Sweden to Canada from 1980 - 2013')\n",
    "plt.xlabel('Year')\n",
    "plt.ylabel('Number of Immigrants')\n",
    "-->\n",
    "\n",
    "<!--\n",
    "\\\\ # show plot\n",
    "plt.show()\n",
    "-->"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "# Bubble Plots <a id=\"12\"></a>\n",
    "\n",
    "A `bubble plot` is a variation of the `scatter plot` that displays three dimensions of data (x, y, z). The datapoints are replaced with bubbles, and the size of the bubble is determined by the third variable 'z', also known as the weight. In `maplotlib`, we can pass in an array or scalar to the keyword `s` to `plot()`, that contains the weight of each point.\n",
    "\n",
    "**Let's start by analyzing the effect of Argentina's great depression**.\n",
    "\n",
    "Argentina suffered a great depression from 1998 - 2002, which caused widespread unemployment, riots, the fall of the government, and a default on the country's foreign debt. In terms of income, over 50% of Argentines were poor, and seven out of ten Argentine children were poor at the depth of the crisis in 2002. \n",
    "\n",
    "Let's analyze the effect of this crisis, and compare Argentina's immigration to that of it's neighbour Brazil. Let's do that using a `bubble plot` of immigration from Brazil and Argentina for the years 1980 - 2013. We will set the weights for the bubble as the *normalized* value of the population for each year."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 1: Get the data for Brazil and Argentina. Like in the previous example, we will convert the `Years` to type int and bring it in the dataframe."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    },
    "scrolled": true
   },
   "outputs": [],
   "source": [
    "df_can_t = df_can[years].transpose() # transposed dataframe\n",
    "\n",
    "# cast the Years (the index) to type int\n",
    "df_can_t.index = map(int, df_can_t.index)\n",
    "\n",
    "# let's label the index. This will automatically be the column name when we reset the index\n",
    "df_can_t.index.name = 'Year'\n",
    "\n",
    "# reset index to bring the Year in as a column\n",
    "df_can_t.reset_index(inplace=True)\n",
    "\n",
    "# view the changes\n",
    "df_can_t.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 2: Create the normalized weights. \n",
    "\n",
    "There are several methods of normalizations in statistics, each with its own use. In this case, we will use [feature scaling](https://en.wikipedia.org/wiki/Feature_scaling) to bring all values into the range [0,1]. The general formula is:\n",
    "\n",
    "<img src=\"https://s3-api.us-geo.objectstorage.softlayer.net/cf-courses-data/CognitiveClass/DV0101EN/labs/Images/Mod3Fig3FeatureScaling.png\" align=\"center\">\n",
    "\n",
    "where *`X`* is an original value, *`X'`* is the normalized value. The formula sets the max value in the dataset to 1, and sets the min value to 0. The rest of the datapoints are scaled to a value between 0-1 accordingly.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    },
    "scrolled": true
   },
   "outputs": [],
   "source": [
    "# normalize Brazil data\n",
    "norm_brazil = (df_can_t['Brazil'] - df_can_t['Brazil'].min()) / (df_can_t['Brazil'].max() - df_can_t['Brazil'].min())\n",
    "\n",
    "# normalize Argentina data\n",
    "norm_argentina = (df_can_t['Argentina'] - df_can_t['Argentina'].min()) / (df_can_t['Argentina'].max() - df_can_t['Argentina'].min())"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 3: Plot the data. \n",
    "- To plot two different scatter plots in one plot, we can include the axes one plot into the other by passing it via the `ax` parameter. \n",
    "- We will also pass in the weights using the `s` parameter. Given that the normalized weights are between 0-1, they won't be visible on the plot. Therefore we will:\n",
    "    - multiply weights by 2000 to scale it up on the graph, and,\n",
    "    - add 10 to compensate for the min value (which has a 0 weight and therefore scale with x2000)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [],
   "source": [
    "# Brazil\n",
    "ax0 = df_can_t.plot(kind='scatter',\n",
    "                    x='Year',\n",
    "                    y='Brazil',\n",
    "                    figsize=(14, 8),\n",
    "                    alpha=0.5,                  # transparency\n",
    "                    color='green',\n",
    "                    s=norm_brazil * 2000 + 10,  # pass in weights \n",
    "                    xlim=(1975, 2015)\n",
    "                   )\n",
    "\n",
    "# Argentina\n",
    "ax1 = df_can_t.plot(kind='scatter',\n",
    "                    x='Year',\n",
    "                    y='Argentina',\n",
    "                    alpha=0.5,\n",
    "                    color=\"blue\",\n",
    "                    s=norm_argentina * 2000 + 10,\n",
    "                    ax = ax0\n",
    "                   )\n",
    "\n",
    "ax0.set_ylabel('Number of Immigrants')\n",
    "ax0.set_title('Immigration from Brazil and Argentina from 1980 - 2013')\n",
    "ax0.legend(['Brazil', 'Argentina'], loc='upper left', fontsize='x-large')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "The size of the bubble corresponds to the magnitude of immigrating population for that year, compared to the 1980 - 2013 data. The larger the bubble, the more immigrants in that year.\n",
    "\n",
    "From the plot above, we can see a corresponding increase in immigration from Argentina during the 1998 - 2002 great depression. We can also observe a similar spike around 1985 to 1993. In fact, Argentina had suffered a great depression from 1974 - 1990, just before the onset of 1998 - 2002 great depression. \n",
    "\n",
    "On a similar note, Brazil suffered the *Samba Effect* where the Brazilian real (currency) dropped nearly 35% in 1999. There was a fear of a South American financial crisis as many South American countries were heavily dependent on industrial exports from Brazil. The Brazilian government subsequently adopted an austerity program, and the economy slowly recovered over the years, culminating in a surge in 2010. The immigration data reflect these events."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "**Question**: Previously in this lab, we created box plots to compare immigration from China and India to Canada. Create bubble plots of immigration from China and India to visualize any differences with time from 1980 to 2013. You can use **df_can_t** that we defined and used in the previous example."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 1: Normalize the data pertaining to China and India."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": false,
    "collapsed": true,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "outputs": [],
   "source": [
    "### type your answer here\n",
    "\n",
    "\n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Double-click __here__ for the solution.\n",
    "<!-- The correct answer is:\n",
    "\\\\ # normalize China data\n",
    "norm_china = (df_can_t['China'] - df_can_t['China'].min()) / (df_can_t['China'].max() - df_can_t['China'].min())\n",
    "-->\n",
    "\n",
    "<!--\n",
    "# normalize India data\n",
    "norm_india = (df_can_t['India'] - df_can_t['India'].min()) / (df_can_t['India'].max() - df_can_t['India'].min())\n",
    "-->"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Step 2: Generate the bubble plots."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "button": 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,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "Double-click __here__ for the solution.\n",
    "<!-- The correct answer is:\n",
    "\\\\ # China\n",
    "ax0 = df_can_t.plot(kind='scatter',\n",
    "                    x='Year',\n",
    "                    y='China',\n",
    "                    figsize=(14, 8),\n",
    "                    alpha=0.5,                  # transparency\n",
    "                    color='green',\n",
    "                    s=norm_china * 2000 + 10,  # pass in weights \n",
    "                    xlim=(1975, 2015)\n",
    "                   )\n",
    "-->\n",
    "\n",
    "<!--\n",
    "\\\\ # India\n",
    "ax1 = df_can_t.plot(kind='scatter',\n",
    "                    x='Year',\n",
    "                    y='India',\n",
    "                    alpha=0.5,\n",
    "                    color=\"blue\",\n",
    "                    s=norm_india * 2000 + 10,\n",
    "                    ax = ax0\n",
    "                   )\n",
    "-->\n",
    "\n",
    "<!--\n",
    "ax0.set_ylabel('Number of Immigrants')\n",
    "ax0.set_title('Immigration from China and India from 1980 - 2013')\n",
    "ax0.legend(['China', 'India'], loc='upper left', fontsize='x-large')\n",
    "-->"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "### Thank you for completing this lab!\n",
    "\n",
    "This notebook was created by [Jay Rajasekharan](https://www.linkedin.com/in/jayrajasekharan) with contributions from [Ehsan M. Kermani](https://www.linkedin.com/in/ehsanmkermani), and [Slobodan Markovic](https://www.linkedin.com/in/slobodan-markovic).\n",
    "\n",
    "This notebook was recently revamped by [Alex Aklson](https://www.linkedin.com/in/aklson/). I hope you found this lab session interesting. Feel free to contact me if you have any questions!"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "new_sheet": false,
    "run_control": {
     "read_only": false
    }
   },
   "source": [
    "This notebook is part of the free course on **Cognitive Class** called *Data Visualization with Python*. If you accessed this notebook outside the course, you can take this free self-paced course online by clicking [here](https://cocl.us/DV0101EN_Lab3)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "button": false,
    "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 3",
   "language": "python",
   "name": "python3"
  },
  "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.7.4"
  },
  "widgets": {
   "state": {},
   "version": "1.1.2"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}