ch02_Toolbox.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Chapter 2: Toolbox for Data Scientists"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In this notebook we will learn the basis of the Pandas library for data scientists. \n",
    "\n",
    "Let us begin by importing those packages that we will need for our program. In the first cell we put the code to import the `pandas` library as `pd`. This is for convenience; every time we need to use some functionality from the pandas library, we will write `pd` instead of `pandas`. We will also import the two core libraries mentioned also in the book chapter `numpy` library as `np` and `matplotlib.pyplot` library as `plt`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "import pandas as pd\n",
    "import numpy as np\n",
    "import matplotlib.pylab as plt\n",
    "%matplotlib inline\n",
    "plt.style.use('seaborn-whitegrid')\n",
    "plt.rc('text', usetex=True)\n",
    "plt.rc('font', family='times')\n",
    "plt.rc('xtick', labelsize=10)\n",
    "plt.rc('ytick', labelsize=10)\n",
    "plt.rc('font', size=12)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### DataFrames \n",
    "\n",
    "The key data structure in Pandas is the **DataFrame** object. A DataFrame is basically a tabular data structure, with rows and columns. Rows have a specific index to access them, which can be any name or value. In Pandas, the columns are called **Series**, a special type of data, which in essence consists of a list of several values, where each value has an index. \n",
    "Therefore, the DataFrame data structure can be seen as a spreadsheet, but it is much more flexible. \n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Creating a new DataFrame from the scratch\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "To understand how it works, let us see how to create a DataFrame from a common Python dictionary of lists.\n",
    "\n",
    "\n",
    "In this example, we use the pandas `DataFrame` object constructor with a dictionary of lists as argument.\n",
    "The value of each entry in the dictionary is the name of the column, and the lists are their values. \n",
    "The DataFrame columns can be arranged at construction time by entering a keyword \\emph{columns} with a list of the names of the columns ordered as we want. If the column keyword is not present in the constructor, the columns will be arranged in alphabetical order."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>year</th>\n",
       "      <th>team</th>\n",
       "      <th>wins</th>\n",
       "      <th>draws</th>\n",
       "      <th>losses</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>2010</td>\n",
       "      <td>FCBarcelona</td>\n",
       "      <td>30</td>\n",
       "      <td>6</td>\n",
       "      <td>2</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>2011</td>\n",
       "      <td>FCBarcelona</td>\n",
       "      <td>28</td>\n",
       "      <td>7</td>\n",
       "      <td>3</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>2012</td>\n",
       "      <td>FCBarcelona</td>\n",
       "      <td>32</td>\n",
       "      <td>4</td>\n",
       "      <td>2</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>2010</td>\n",
       "      <td>RMadrid</td>\n",
       "      <td>29</td>\n",
       "      <td>5</td>\n",
       "      <td>4</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>2011</td>\n",
       "      <td>RMadrid</td>\n",
       "      <td>32</td>\n",
       "      <td>4</td>\n",
       "      <td>2</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>5</th>\n",
       "      <td>2012</td>\n",
       "      <td>RMadrid</td>\n",
       "      <td>26</td>\n",
       "      <td>7</td>\n",
       "      <td>5</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>6</th>\n",
       "      <td>2010</td>\n",
       "      <td>ValenciaCF</td>\n",
       "      <td>21</td>\n",
       "      <td>8</td>\n",
       "      <td>9</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>7</th>\n",
       "      <td>2011</td>\n",
       "      <td>ValenciaCF</td>\n",
       "      <td>17</td>\n",
       "      <td>10</td>\n",
       "      <td>11</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>8</th>\n",
       "      <td>2012</td>\n",
       "      <td>ValenciaCF</td>\n",
       "      <td>19</td>\n",
       "      <td>8</td>\n",
       "      <td>11</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   year         team  wins  draws  losses\n",
       "0  2010  FCBarcelona    30      6       2\n",
       "1  2011  FCBarcelona    28      7       3\n",
       "2  2012  FCBarcelona    32      4       2\n",
       "3  2010      RMadrid    29      5       4\n",
       "4  2011      RMadrid    32      4       2\n",
       "5  2012      RMadrid    26      7       5\n",
       "6  2010   ValenciaCF    21      8       9\n",
       "7  2011   ValenciaCF    17     10      11\n",
       "8  2012   ValenciaCF    19      8      11"
      ]
     },
     "execution_count": 9,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "data = {'year': [2010, 2011, 2012, 2010, 2011, 2012, 2010, 2011, 2012],\n",
    "        'team': ['FCBarcelona', 'FCBarcelona', 'FCBarcelona', 'RMadrid', 'RMadrid', 'RMadrid', 'ValenciaCF',\n",
    "                 'ValenciaCF', 'ValenciaCF'],\n",
    "        'wins':   [30, 28, 32, 29, 32, 26, 21, 17, 19],\n",
    "        'draws':  [6, 7, 4, 5, 4, 7, 8, 10, 8],\n",
    "        'losses': [2, 3, 2, 4, 2, 5, 9, 11, 11]\n",
    "        }\n",
    "football = pd.DataFrame(\n",
    "    data, columns=['year', 'team', 'wins', 'draws', 'losses'])\n",
    "football"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The result is a table where each entry in the dictionary is a column. The index of each row is created automatically taking the position of its elements inside the entry lists, starting from 0.\n",
    "Although it is very easy to create DataFrames from scratch, most of the time what we will need to do is import chunks of data into a DataFrame structure, we will see how to do this in later examples."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Open government data analysis example using Pandas\n",
    "\n",
    "To illustrate how we can use Pandas in a simple real problem, we will start doing some basic analysis of government data. For the sake of transparency, data produced by government entities must be open, meaning that they can be freely used, reused and distributed by anyone. An example of this is the Eurostat, which is the home of European Commission data. Eurostat’s main role is to process and publish comparable statistical information at the European level. The data in Eurostat are provided by each member state and it is free to reuse them, both for noncommercial and commercial purposes (with some minor exceptions).  \n",
    "\n",
    "\n",
    "Since the amount of data in the Eurostat database is huge, in our first study we are only going to focus on data relative to indicators of educational funding by the member states. Thus, the first thing to do is to retrieve such data from Eurostat. Since open data have to be delivered in a plain text format, CSV (or any other delimiter-separated value) formats are commonly used to store tabular data. In a delimiter-separated value file, each line is a data record and each record consists of one or more fields, separated by the delimiter character (usually a comma). Therefore, the data we will use can be found already downloaded and preprocessed as a CSV file *educ_figdp_1_Data.csv* which can be download from the book's Github webpage. Of course, it can also be downloaded as unprocessed tabular data from the Eurostat database site [Eurostat database site]( http://ec.europa.eu/eurostat/data/database) \n",
    "following the path:  `Tables by themes > Population and social conditions > \n",
    "Education and training > Education > Indicators on education finance > Public expenditure on education` "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Reading tabular data\n",
    "\n",
    "Let us start reading the data we downloaded.\n",
    "The way to read CSV (or any other separated value, providing the separator character) files in Pandas is by calling the `read_csv` method. Besides the name of the file, we add the *na_values* key argument to this method along with the character that represents \"non available data\" in the file. Normally, CSV files have a header with the names of the columns. If this is the case,  we can use the *usecols* parameter to select which columns in the file will be used.\n",
    "\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>2000</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>2001</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>2002</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.00</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>2003</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.03</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>2004</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>4.95</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>5</th>\n",
       "      <td>2005</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>4.92</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>6</th>\n",
       "      <td>2006</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>4.91</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>7</th>\n",
       "      <td>2007</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>4.92</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>8</th>\n",
       "      <td>2008</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.04</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>9</th>\n",
       "      <td>2009</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.38</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>10</th>\n",
       "      <td>2010</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.41</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>11</th>\n",
       "      <td>2011</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.25</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>12</th>\n",
       "      <td>2000</td>\n",
       "      <td>European Union (27 countries)</td>\n",
       "      <td>4.91</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>13</th>\n",
       "      <td>2001</td>\n",
       "      <td>European Union (27 countries)</td>\n",
       "      <td>4.99</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>14</th>\n",
       "      <td>2002</td>\n",
       "      <td>European Union (27 countries)</td>\n",
       "      <td>5.00</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>15</th>\n",
       "      <td>2003</td>\n",
       "      <td>European Union (27 countries)</td>\n",
       "      <td>5.04</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>16</th>\n",
       "      <td>2004</td>\n",
       "      <td>European Union (27 countries)</td>\n",
       "      <td>4.95</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>17</th>\n",
       "      <td>2005</td>\n",
       "      <td>European Union (27 countries)</td>\n",
       "      <td>4.92</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>18</th>\n",
       "      <td>2006</td>\n",
       "      <td>European Union (27 countries)</td>\n",
       "      <td>4.91</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>19</th>\n",
       "      <td>2007</td>\n",
       "      <td>European Union (27 countries)</td>\n",
       "      <td>4.93</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>20</th>\n",
       "      <td>2008</td>\n",
       "      <td>European Union (27 countries)</td>\n",
       "      <td>5.04</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>21</th>\n",
       "      <td>2009</td>\n",
       "      <td>European Union (27 countries)</td>\n",
       "      <td>5.38</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>22</th>\n",
       "      <td>2010</td>\n",
       "      <td>European Union (27 countries)</td>\n",
       "      <td>5.41</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>23</th>\n",
       "      <td>2011</td>\n",
       "      <td>European Union (27 countries)</td>\n",
       "      <td>5.25</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>24</th>\n",
       "      <td>2000</td>\n",
       "      <td>European Union (25 countries)</td>\n",
       "      <td>4.94</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>25</th>\n",
       "      <td>2001</td>\n",
       "      <td>European Union (25 countries)</td>\n",
       "      <td>5.02</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>26</th>\n",
       "      <td>2002</td>\n",
       "      <td>European Union (25 countries)</td>\n",
       "      <td>5.03</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>27</th>\n",
       "      <td>2003</td>\n",
       "      <td>European Union (25 countries)</td>\n",
       "      <td>5.06</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>28</th>\n",
       "      <td>2004</td>\n",
       "      <td>European Union (25 countries)</td>\n",
       "      <td>4.98</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>29</th>\n",
       "      <td>2005</td>\n",
       "      <td>European Union (25 countries)</td>\n",
       "      <td>4.95</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>...</th>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "      <td>...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>354</th>\n",
       "      <td>2006</td>\n",
       "      <td>Slovenia</td>\n",
       "      <td>5.72</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>355</th>\n",
       "      <td>2007</td>\n",
       "      <td>Slovenia</td>\n",
       "      <td>5.15</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>356</th>\n",
       "      <td>2008</td>\n",
       "      <td>Slovenia</td>\n",
       "      <td>5.20</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>357</th>\n",
       "      <td>2009</td>\n",
       "      <td>Slovenia</td>\n",
       "      <td>5.69</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>358</th>\n",
       "      <td>2010</td>\n",
       "      <td>Slovenia</td>\n",
       "      <td>5.68</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>359</th>\n",
       "      <td>2011</td>\n",
       "      <td>Slovenia</td>\n",
       "      <td>5.68</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>360</th>\n",
       "      <td>2000</td>\n",
       "      <td>Slovakia</td>\n",
       "      <td>3.92</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>361</th>\n",
       "      <td>2001</td>\n",
       "      <td>Slovakia</td>\n",
       "      <td>3.99</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>362</th>\n",
       "      <td>2002</td>\n",
       "      <td>Slovakia</td>\n",
       "      <td>4.31</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>363</th>\n",
       "      <td>2003</td>\n",
       "      <td>Slovakia</td>\n",
       "      <td>4.30</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>364</th>\n",
       "      <td>2004</td>\n",
       "      <td>Slovakia</td>\n",
       "      <td>4.19</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>365</th>\n",
       "      <td>2005</td>\n",
       "      <td>Slovakia</td>\n",
       "      <td>3.85</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>366</th>\n",
       "      <td>2006</td>\n",
       "      <td>Slovakia</td>\n",
       "      <td>3.80</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>367</th>\n",
       "      <td>2007</td>\n",
       "      <td>Slovakia</td>\n",
       "      <td>3.62</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>368</th>\n",
       "      <td>2008</td>\n",
       "      <td>Slovakia</td>\n",
       "      <td>3.61</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>369</th>\n",
       "      <td>2009</td>\n",
       "      <td>Slovakia</td>\n",
       "      <td>4.09</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>370</th>\n",
       "      <td>2010</td>\n",
       "      <td>Slovakia</td>\n",
       "      <td>4.22</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>371</th>\n",
       "      <td>2011</td>\n",
       "      <td>Slovakia</td>\n",
       "      <td>4.06</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>372</th>\n",
       "      <td>2000</td>\n",
       "      <td>Finland</td>\n",
       "      <td>5.89</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>373</th>\n",
       "      <td>2001</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.06</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>374</th>\n",
       "      <td>2002</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.22</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>375</th>\n",
       "      <td>2003</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.43</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>376</th>\n",
       "      <td>2004</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.42</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>377</th>\n",
       "      <td>2005</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.30</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>378</th>\n",
       "      <td>2006</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.18</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>379</th>\n",
       "      <td>2007</td>\n",
       "      <td>Finland</td>\n",
       "      <td>5.90</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>380</th>\n",
       "      <td>2008</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.10</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>381</th>\n",
       "      <td>2009</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.81</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>382</th>\n",
       "      <td>2010</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.85</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>383</th>\n",
       "      <td>2011</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.76</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "<p>384 rows × 3 columns</p>\n",
       "</div>"
      ],
      "text/plain": [
       "     TIME                            GEO  Value\n",
       "0    2000  European Union (28 countries)    NaN\n",
       "1    2001  European Union (28 countries)    NaN\n",
       "2    2002  European Union (28 countries)   5.00\n",
       "3    2003  European Union (28 countries)   5.03\n",
       "4    2004  European Union (28 countries)   4.95\n",
       "5    2005  European Union (28 countries)   4.92\n",
       "6    2006  European Union (28 countries)   4.91\n",
       "7    2007  European Union (28 countries)   4.92\n",
       "8    2008  European Union (28 countries)   5.04\n",
       "9    2009  European Union (28 countries)   5.38\n",
       "10   2010  European Union (28 countries)   5.41\n",
       "11   2011  European Union (28 countries)   5.25\n",
       "12   2000  European Union (27 countries)   4.91\n",
       "13   2001  European Union (27 countries)   4.99\n",
       "14   2002  European Union (27 countries)   5.00\n",
       "15   2003  European Union (27 countries)   5.04\n",
       "16   2004  European Union (27 countries)   4.95\n",
       "17   2005  European Union (27 countries)   4.92\n",
       "18   2006  European Union (27 countries)   4.91\n",
       "19   2007  European Union (27 countries)   4.93\n",
       "20   2008  European Union (27 countries)   5.04\n",
       "21   2009  European Union (27 countries)   5.38\n",
       "22   2010  European Union (27 countries)   5.41\n",
       "23   2011  European Union (27 countries)   5.25\n",
       "24   2000  European Union (25 countries)   4.94\n",
       "25   2001  European Union (25 countries)   5.02\n",
       "26   2002  European Union (25 countries)   5.03\n",
       "27   2003  European Union (25 countries)   5.06\n",
       "28   2004  European Union (25 countries)   4.98\n",
       "29   2005  European Union (25 countries)   4.95\n",
       "..    ...                            ...    ...\n",
       "354  2006                       Slovenia   5.72\n",
       "355  2007                       Slovenia   5.15\n",
       "356  2008                       Slovenia   5.20\n",
       "357  2009                       Slovenia   5.69\n",
       "358  2010                       Slovenia   5.68\n",
       "359  2011                       Slovenia   5.68\n",
       "360  2000                       Slovakia   3.92\n",
       "361  2001                       Slovakia   3.99\n",
       "362  2002                       Slovakia   4.31\n",
       "363  2003                       Slovakia   4.30\n",
       "364  2004                       Slovakia   4.19\n",
       "365  2005                       Slovakia   3.85\n",
       "366  2006                       Slovakia   3.80\n",
       "367  2007                       Slovakia   3.62\n",
       "368  2008                       Slovakia   3.61\n",
       "369  2009                       Slovakia   4.09\n",
       "370  2010                       Slovakia   4.22\n",
       "371  2011                       Slovakia   4.06\n",
       "372  2000                        Finland   5.89\n",
       "373  2001                        Finland   6.06\n",
       "374  2002                        Finland   6.22\n",
       "375  2003                        Finland   6.43\n",
       "376  2004                        Finland   6.42\n",
       "377  2005                        Finland   6.30\n",
       "378  2006                        Finland   6.18\n",
       "379  2007                        Finland   5.90\n",
       "380  2008                        Finland   6.10\n",
       "381  2009                        Finland   6.81\n",
       "382  2010                        Finland   6.85\n",
       "383  2011                        Finland   6.76\n",
       "\n",
       "[384 rows x 3 columns]"
      ]
     },
     "execution_count": 10,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu = pd.read_csv('files/ch02/educ_figdp_1_Data.csv',\n",
    "                  na_values=':', usecols=['TIME', 'GEO', 'Value'])\n",
    "edu"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In this case, the DataFrame resulting from reading our data is stored in **edu**. The output of the execution shows that the `edu` DataFrame size is 384 rows $\\times$ 3 columns. Since the DataFrame is too large to be fully displayed, three dots appear in the middle of each row.\n",
    "\n",
    "\n",
    "Beside this, Pandas also has functions for reading files with formats such as Excel, HDF5, tabulated files or even the content from the clipboard (`read_excel(), read\\_hdf(), read\\_table(), read\\_clipboard()`). Whichever function we use, the result of reading a file is stored as a DataFrame structure. \n",
    "\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Viewing Data\n",
    "\n",
    "To see how the data looks, we can use the `head()` method, which shows just the first five rows. if we put a number as an argument to this method, this will be the number of the first rows that are listed."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>2000</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>2001</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>2002</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.00</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>2003</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.03</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>2004</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>4.95</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   TIME                            GEO  Value\n",
       "0  2000  European Union (28 countries)    NaN\n",
       "1  2001  European Union (28 countries)    NaN\n",
       "2  2002  European Union (28 countries)   5.00\n",
       "3  2003  European Union (28 countries)   5.03\n",
       "4  2004  European Union (28 countries)   4.95"
      ]
     },
     "execution_count": 11,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Similarly, it exists the **tail()** method, which returns the last five rows by default."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>379</th>\n",
       "      <td>2007</td>\n",
       "      <td>Finland</td>\n",
       "      <td>5.90</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>380</th>\n",
       "      <td>2008</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.10</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>381</th>\n",
       "      <td>2009</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.81</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>382</th>\n",
       "      <td>2010</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.85</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>383</th>\n",
       "      <td>2011</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.76</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "     TIME      GEO  Value\n",
       "379  2007  Finland   5.90\n",
       "380  2008  Finland   6.10\n",
       "381  2009  Finland   6.81\n",
       "382  2010  Finland   6.85\n",
       "383  2011  Finland   6.76"
      ]
     },
     "execution_count": 12,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu.tail()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If we want to know the names of the columns or the names of the indexes, we can use the DataFrame attributes **columns** and **index** respectively. The names of the columns or indexes can be changed by assigning a new list of the same length to these attributes. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Index([u'TIME', u'GEO', u'Value'], dtype='object')"
      ]
     },
     "execution_count": 13,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu.columns "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "RangeIndex(start=0, stop=384, step=1)"
      ]
     },
     "execution_count": 14,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu.index"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The values of any DataFrame can be retrieved as a Python array by calling its **values ** attribute."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "array([[2000, 'European Union (28 countries)', nan],\n",
       "       [2001, 'European Union (28 countries)', nan],\n",
       "       [2002, 'European Union (28 countries)', 5.0],\n",
       "       ..., \n",
       "       [2009, 'Finland', 6.81],\n",
       "       [2010, 'Finland', 6.85],\n",
       "       [2011, 'Finland', 6.76]], dtype=object)"
      ]
     },
     "execution_count": 15,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu.values"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If we just want quick statistical information on all the numeric columns in a data frame, we can use the function **describe()**. The result shows the count, the mean, the standard deviation, the minimum and maximum, and the percentiles, by default, the 25th, 50th, and 75th, for all the values in each column or series.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>count</th>\n",
       "      <td>384.000000</td>\n",
       "      <td>361.000000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>mean</th>\n",
       "      <td>2005.500000</td>\n",
       "      <td>5.203989</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>std</th>\n",
       "      <td>3.456556</td>\n",
       "      <td>1.021694</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>min</th>\n",
       "      <td>2000.000000</td>\n",
       "      <td>2.880000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>25%</th>\n",
       "      <td>2002.750000</td>\n",
       "      <td>4.620000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>50%</th>\n",
       "      <td>2005.500000</td>\n",
       "      <td>5.060000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>75%</th>\n",
       "      <td>2008.250000</td>\n",
       "      <td>5.660000</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>max</th>\n",
       "      <td>2011.000000</td>\n",
       "      <td>8.810000</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "              TIME       Value\n",
       "count   384.000000  361.000000\n",
       "mean   2005.500000    5.203989\n",
       "std       3.456556    1.021694\n",
       "min    2000.000000    2.880000\n",
       "25%    2002.750000    4.620000\n",
       "50%    2005.500000    5.060000\n",
       "75%    2008.250000    5.660000\n",
       "max    2011.000000    8.810000"
      ]
     },
     "execution_count": 16,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu.describe()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Selection\n",
    "\n",
    "If we want to select a subset of data from a DataFrame, it is necessary to indicate this subset using square brackets **[]** after the DataFrame. The subset can be specified in several ways. If we want to select only one column from a DataFrame, we only need to put its name between the square brackets. The result will be a Series data structure, not a DataFrame, because only one column is retrieved.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0       NaN\n",
       "1       NaN\n",
       "2      5.00\n",
       "3      5.03\n",
       "4      4.95\n",
       "5      4.92\n",
       "6      4.91\n",
       "7      4.92\n",
       "8      5.04\n",
       "9      5.38\n",
       "10     5.41\n",
       "11     5.25\n",
       "12     4.91\n",
       "13     4.99\n",
       "14     5.00\n",
       "15     5.04\n",
       "16     4.95\n",
       "17     4.92\n",
       "18     4.91\n",
       "19     4.93\n",
       "20     5.04\n",
       "21     5.38\n",
       "22     5.41\n",
       "23     5.25\n",
       "24     4.94\n",
       "25     5.02\n",
       "26     5.03\n",
       "27     5.06\n",
       "28     4.98\n",
       "29     4.95\n",
       "       ... \n",
       "354    5.72\n",
       "355    5.15\n",
       "356    5.20\n",
       "357    5.69\n",
       "358    5.68\n",
       "359    5.68\n",
       "360    3.92\n",
       "361    3.99\n",
       "362    4.31\n",
       "363    4.30\n",
       "364    4.19\n",
       "365    3.85\n",
       "366    3.80\n",
       "367    3.62\n",
       "368    3.61\n",
       "369    4.09\n",
       "370    4.22\n",
       "371    4.06\n",
       "372    5.89\n",
       "373    6.06\n",
       "374    6.22\n",
       "375    6.43\n",
       "376    6.42\n",
       "377    6.30\n",
       "378    6.18\n",
       "379    5.90\n",
       "380    6.10\n",
       "381    6.81\n",
       "382    6.85\n",
       "383    6.76\n",
       "Name: Value, dtype: float64"
      ]
     },
     "execution_count": 17,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu['Value']"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If we want to select a subset of rows from a DataFrame, we can do so by indicating a range of rows separated by **:** inside the square brackets. This is commonly known as a *slice* of rows.\n",
    "\n",
    "Next instruction returns the slice of rows from the 10th to the 13th position. Note that the slice does not use the index labels as references, but the position. In this case, the labels of the rows simply coincide with the position of the rows."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>10</th>\n",
       "      <td>2010</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.41</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>11</th>\n",
       "      <td>2011</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.25</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>12</th>\n",
       "      <td>2000</td>\n",
       "      <td>European Union (27 countries)</td>\n",
       "      <td>4.91</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>13</th>\n",
       "      <td>2001</td>\n",
       "      <td>European Union (27 countries)</td>\n",
       "      <td>4.99</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "    TIME                            GEO  Value\n",
       "10  2010  European Union (28 countries)   5.41\n",
       "11  2011  European Union (28 countries)   5.25\n",
       "12  2000  European Union (27 countries)   4.91\n",
       "13  2001  European Union (27 countries)   4.99"
      ]
     },
     "execution_count": 11,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu[10:14]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    " If we want to select a subset of columns and rows using the labels as our references instead of the positions, we can use **ix** indexing:\n",
    "\n",
    "Next instruction  will return all the rows between the indexes specified in the slice before the comma, and the columns specified as a list after the comma. In this case, **ix** references the index labels, which means that  **ix** does not return the 90th to 94th rows, but it returns all the rows between the row labeled 90 and the row labeled 94; thus if the index 100 is placed between the rows labeled as 90 and 94, this row would also be returned."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>90</th>\n",
       "      <td>2006</td>\n",
       "      <td>Belgium</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>91</th>\n",
       "      <td>2007</td>\n",
       "      <td>Belgium</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>92</th>\n",
       "      <td>2008</td>\n",
       "      <td>Belgium</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>93</th>\n",
       "      <td>2009</td>\n",
       "      <td>Belgium</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>94</th>\n",
       "      <td>2010</td>\n",
       "      <td>Belgium</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "    TIME      GEO\n",
       "90  2006  Belgium\n",
       "91  2007  Belgium\n",
       "92  2008  Belgium\n",
       "93  2009  Belgium\n",
       "94  2010  Belgium"
      ]
     },
     "execution_count": 18,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu.ix[90:94, ['TIME', 'GEO']]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Filtering Data"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Another way to select a subset of data is by applying Boolean indexing. This indexing is commonly known as a *filter*. For instance, if we want to filter those values less than or equal to 6.5, we can do it like this: "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>286</th>\n",
       "      <td>2010</td>\n",
       "      <td>Malta</td>\n",
       "      <td>6.74</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>287</th>\n",
       "      <td>2011</td>\n",
       "      <td>Malta</td>\n",
       "      <td>7.96</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>381</th>\n",
       "      <td>2009</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.81</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>382</th>\n",
       "      <td>2010</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.85</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>383</th>\n",
       "      <td>2011</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.76</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "     TIME      GEO  Value\n",
       "286  2010    Malta   6.74\n",
       "287  2011    Malta   7.96\n",
       "381  2009  Finland   6.81\n",
       "382  2010  Finland   6.85\n",
       "383  2011  Finland   6.76"
      ]
     },
     "execution_count": 19,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu[edu['Value'] > 6.5].tail()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Boolean indexing uses the result of a Boolean operation over the data, returning a mask with True or False for each row. The rows marked True in the mask will be selected. In the previous example, the Boolean operation `edu['Value'] > 6.5` produces a Boolean mask. When an element in the *'Value'* column is greater than 6.5, the corresponding value in the mask is set to True, otherwise it is set to False. Then, when this mask is applied as an index in `edu[edu['Value'] > 6.5]`, the result is a filtered DataFrame containing only rows with values higher than 6.5. Of course, any of the usual Boolean operators can be used for filtering: < (less than), <= (less than or equal to), > (greater than), >= (greater than or equal to), =  (equal to), !=(not equal to)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Filtering Missing Values"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Pandas uses the special value **NaN** (not a number) to represent missing values. In Python, `NaN` is a special floating-point value returned by certain operations when one of their results ends in an undefined value. A subtle feature of `NaN` values is that two `NaN` are never equal. Because of this, the only safe way to tell whether or not a value is missing in a DataFrame is by using the `isnull()` function. Indeed, this function can be used to filter rows with missing values:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>2000</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>2001</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>36</th>\n",
       "      <td>2000</td>\n",
       "      <td>Euro area (18 countries)</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>37</th>\n",
       "      <td>2001</td>\n",
       "      <td>Euro area (18 countries)</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>48</th>\n",
       "      <td>2000</td>\n",
       "      <td>Euro area (17 countries)</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "    TIME                            GEO  Value\n",
       "0   2000  European Union (28 countries)    NaN\n",
       "1   2001  European Union (28 countries)    NaN\n",
       "36  2000       Euro area (18 countries)    NaN\n",
       "37  2001       Euro area (18 countries)    NaN\n",
       "48  2000       Euro area (17 countries)    NaN"
      ]
     },
     "execution_count": 20,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu[edu['Value'].isnull()].head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Manipulating Data"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Once we know how to select the desired data, the next thing we need to know is how to manipulate data. \n",
    "One of the most straightforward things we can do is to operate with columns or rows  using aggregation functions. The following list shows the most common aggregation functions.\n",
    "\n",
    "| Function  | Description | \n",
    "|-----------|-------------|\n",
    "| count()   |Number of non-null observations|  \n",
    "| sum()     |Sum of values|\n",
    "| mean()    |Mean of values            | \n",
    "| median()  |Arithmetic median of values             |\n",
    "| min()     |Minimum|\n",
    "| max()     |Maximum|\n",
    "| prod()    |Product of values|\n",
    "| std()     |Unbiased standard deviation|\n",
    "| var()     | Unbiased variance|\n",
    "\n",
    "The result of all these functions applied to a row or column is always a number. Meanwhile, if a function is applied to a DataFrame or a selection of rows and columns, then you can specify if the function should be applied to the rows for each column  (putting the **axis=0** keyword on the invocation of the function), or it should be applied on the columns for each row (putting the **axis=1** keyword on the invocation of the function)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "TIME      2011\n",
       "GEO      Spain\n",
       "Value     8.81\n",
       "dtype: object"
      ]
     },
     "execution_count": 22,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu.max(axis=0)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "\n",
    "Note that these are functions specific to Pandas, not the generic Python functions. There are differences in their implementation. In Python ,`NaN` values propagate through all operations without raising an exception. In contrast, Pandas operations exclude `NaN` values representing missing data. For example, the pandas **max** function excludes `NaN`  values, thus they are interpreted as missing values, while the standard Python **max** function will take the mathematical interpretation of `NaN` and return it as the maximum:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Pandas max function: 8.81\n",
      "Python max function: nan\n"
     ]
    }
   ],
   "source": [
    "print 'Pandas max function:', edu['Value'].max()\n",
    "print 'Python max function:', max(edu['Value'])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Beside these aggregation functions, we can apply operations over all the values in rows, columns or a selection of both. The rule of thumb is that an operation between columns means that it is applied to each row in that column and an operation between rows means that it is applied to each column in that row. For example we can apply any binary arithmetical operation (+,-,*,/) to an entire row:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 25,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0       NaN\n",
       "1       NaN\n",
       "2    0.0500\n",
       "3    0.0503\n",
       "4    0.0495\n",
       "Name: Value, dtype: float64"
      ]
     },
     "execution_count": 25,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "s = edu['Value'] / 100\n",
    "s.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "However, we can apply any function to a DataFrame or Series just putting its name as argument  of the **apply** method. For example, in the following code, we apply the  **sqrt** function from the *numpy* library to perform the square root of each value in the *'Value'* column."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0         NaN\n",
       "1         NaN\n",
       "2    2.236068\n",
       "3    2.242766\n",
       "4    2.224860\n",
       "Name: Value, dtype: float64"
      ]
     },
     "execution_count": 28,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "s = edu['Value'].apply(np.sqrt)\n",
    "s.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If we need to design a specific function to apply it, we can write an in-line function, commonly known as a $\\lambda$-function. A $\\lambda$-function is a function without a name. It is only necessary to specify the parameters it receives, between the **lambda**  keyword and the **:**. In the next example, only one parameter is needed, which will be the value of each element in the *'Value'* column. The value the function returns will be the square of that value."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 40,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0        NaN\n",
       "1        NaN\n",
       "2    25.0000\n",
       "3    25.3009\n",
       "4    24.5025\n",
       "Name: Value, dtype: float64"
      ]
     },
     "execution_count": 40,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "s = edu['Value'].apply(lambda d: d**2)\n",
    "s.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Another basic manipulation operation is to set new values in our DataFrame. This can be done directly using the assign operator **=** over a DataFrame. For example, to add a new column to a DataFrame, we can assign a Series to a selection of a column that does not exist. This will produce a new column in the DataFrame after all the others. You must be aware that if a column with the same name already exists, the previous values will be overwritten. In the following example, we assign the Series that results from dividing the 'Value' column by the maximum value in the same column to a new column named 'ValueNorm'."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 41,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "      <th>Value</th>\n",
       "      <th>ValueNorm</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>378</th>\n",
       "      <td>2006</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.18</td>\n",
       "      <td>0.701476</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>379</th>\n",
       "      <td>2007</td>\n",
       "      <td>Finland</td>\n",
       "      <td>5.90</td>\n",
       "      <td>0.669694</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>380</th>\n",
       "      <td>2008</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.10</td>\n",
       "      <td>0.692395</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>381</th>\n",
       "      <td>2009</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.81</td>\n",
       "      <td>0.772985</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>382</th>\n",
       "      <td>2010</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.85</td>\n",
       "      <td>0.777526</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "     TIME      GEO  Value  ValueNorm\n",
       "378  2006  Finland   6.18   0.701476\n",
       "379  2007  Finland   5.90   0.669694\n",
       "380  2008  Finland   6.10   0.692395\n",
       "381  2009  Finland   6.81   0.772985\n",
       "382  2010  Finland   6.85   0.777526"
      ]
     },
     "execution_count": 41,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu['ValueNorm'] = edu['Value'] / edu['Value'].max()\n",
    "edu.tail()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now, if we  want to remove this column from the DataFrame, we can use the **drop** function; this removes the indicated rows if **axis=0**,  or the indicated columns if **axis=1**. In Pandas, all the functions that change the contents of a DataFrame, such as the drop function, will normally return a copy of the modified data, instead of overwriting the DataFrame. Therefore, the original DataFrame is kept. If you do not want to keep the old values, you can set the keyword **inplace** to `True`. By default, this keyword is set to `False`, meaning that a copy of the data is returned. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 42,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>2000</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>2001</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>2002</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.00</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>2003</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.03</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>2004</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>4.95</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   TIME                            GEO  Value\n",
       "0  2000  European Union (28 countries)    NaN\n",
       "1  2001  European Union (28 countries)    NaN\n",
       "2  2002  European Union (28 countries)   5.00\n",
       "3  2003  European Union (28 countries)   5.03\n",
       "4  2004  European Union (28 countries)   4.95"
      ]
     },
     "execution_count": 42,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu.drop('ValueNorm', axis=1, inplace=True)\n",
    "edu.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Instead, if what we want to do is to insert a new row at the bottom of the DataFrame, we can use the Pandas **append** function. This functions receives as argument the new row, which is represented as a dictionary where the keys are the name of the columns and the values the associated value. You must be aware to setting  the **ignore_index** flag in the **append** method  to `True`, otherwise the index 0 is given to this new row, what will produce an error if it already exists:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 43,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>379</th>\n",
       "      <td>2007</td>\n",
       "      <td>Finland</td>\n",
       "      <td>5.90</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>380</th>\n",
       "      <td>2008</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.10</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>381</th>\n",
       "      <td>2009</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.81</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>382</th>\n",
       "      <td>2010</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.85</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>383</th>\n",
       "      <td>2000</td>\n",
       "      <td>a</td>\n",
       "      <td>5.00</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "     TIME      GEO  Value\n",
       "379  2007  Finland   5.90\n",
       "380  2008  Finland   6.10\n",
       "381  2009  Finland   6.81\n",
       "382  2010  Finland   6.85\n",
       "383  2000        a   5.00"
      ]
     },
     "execution_count": 43,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu = edu.append({'TIME': 2000, 'Value': 5.00, 'GEO': 'a'}, ignore_index=True)\n",
    "edu.tail()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Finally, if we want to remove this row, we need to use the **drop** function again. Now we have to set the axis to 0, and specify the index of the row we want to remove. Since we want to remove the last row, we can use the max function over the indexes to determine which row is."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 44,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>378</th>\n",
       "      <td>2006</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.18</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>379</th>\n",
       "      <td>2007</td>\n",
       "      <td>Finland</td>\n",
       "      <td>5.90</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>380</th>\n",
       "      <td>2008</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.10</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>381</th>\n",
       "      <td>2009</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.81</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>382</th>\n",
       "      <td>2010</td>\n",
       "      <td>Finland</td>\n",
       "      <td>6.85</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "     TIME      GEO  Value\n",
       "378  2006  Finland   6.18\n",
       "379  2007  Finland   5.90\n",
       "380  2008  Finland   6.10\n",
       "381  2009  Finland   6.81\n",
       "382  2010  Finland   6.85"
      ]
     },
     "execution_count": 44,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu.drop(max(edu.index), axis=0, inplace=True)\n",
    "edu.tail()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    " The**drop()** function is also used to remove missing values by applying it over the result of the **isnull()** function. This has a similar effect to filtering the `NaN` values, as we explained above, but here the difference is that a copy of the DataFrame without the `NaN` values is returned, instead of a view. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 36,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>2002</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.00</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>2003</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.03</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>2004</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>4.95</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>5</th>\n",
       "      <td>2005</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>4.92</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>6</th>\n",
       "      <td>2006</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>4.91</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   TIME                            GEO  Value\n",
       "2  2002  European Union (28 countries)   5.00\n",
       "3  2003  European Union (28 countries)   5.03\n",
       "4  2004  European Union (28 countries)   4.95\n",
       "5  2005  European Union (28 countries)   4.92\n",
       "6  2006  European Union (28 countries)   4.91"
      ]
     },
     "execution_count": 36,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "eduDrop = edu.drop(edu['Value'].isnull(), axis=0)\n",
    "eduDrop.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "To remove `NaN` values, instead of the generic drop function, we can use the specific **dropna()** function. If we want to erase any row that contains an `NaN` value, we have to set the **how** keyword to *any*. To restrict it to a subset of columns, we can specify it using the **subset** keyword. As we can see below, the result will we the same as using the **drop** function:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 37,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>2002</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.00</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>2003</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.03</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>2004</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>4.95</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>5</th>\n",
       "      <td>2005</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>4.92</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>6</th>\n",
       "      <td>2006</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>4.91</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   TIME                            GEO  Value\n",
       "2  2002  European Union (28 countries)   5.00\n",
       "3  2003  European Union (28 countries)   5.03\n",
       "4  2004  European Union (28 countries)   4.95\n",
       "5  2005  European Union (28 countries)   4.92\n",
       "6  2006  European Union (28 countries)   4.91"
      ]
     },
     "execution_count": 37,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "eduDrop = edu.dropna(how='any', subset=['Value'], axis=0)\n",
    "eduDrop.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If, instead of removing the rows containing `NaN`, we want to fill them with another value, then we can use the **fillna()** method, specifying which value has to be used. If we want to fill only some specific columns, we have to put as argument to the **fillna()** function a dictionary with the name of the columns as the key and which character to be used for filling as the value."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 26,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>2000</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>0.00</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>2001</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>0.00</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>2002</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.00</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>2003</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.03</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>2004</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>4.95</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   TIME                            GEO  Value\n",
       "0  2000  European Union (28 countries)   0.00\n",
       "1  2001  European Union (28 countries)   0.00\n",
       "2  2002  European Union (28 countries)   5.00\n",
       "3  2003  European Union (28 countries)   5.03\n",
       "4  2004  European Union (28 countries)   4.95"
      ]
     },
     "execution_count": 26,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "eduFilled = edu.fillna(value={'Value': 0})\n",
    "eduFilled.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Sorting"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Another important functionality we will need when inspecting our data is to sort by columns. We can sort a DataFrame using any column, using the **sort** function.  If we want to see the first five rows of data sorted in descending order  (i.e., from the largest to the smallest values) and using the *'Value'* column, then we just need to do this:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 27,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>130</th>\n",
       "      <td>2010</td>\n",
       "      <td>Denmark</td>\n",
       "      <td>8.81</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>131</th>\n",
       "      <td>2011</td>\n",
       "      <td>Denmark</td>\n",
       "      <td>8.75</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>129</th>\n",
       "      <td>2009</td>\n",
       "      <td>Denmark</td>\n",
       "      <td>8.74</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>121</th>\n",
       "      <td>2001</td>\n",
       "      <td>Denmark</td>\n",
       "      <td>8.44</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>122</th>\n",
       "      <td>2002</td>\n",
       "      <td>Denmark</td>\n",
       "      <td>8.44</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "     TIME      GEO  Value\n",
       "130  2010  Denmark   8.81\n",
       "131  2011  Denmark   8.75\n",
       "129  2009  Denmark   8.74\n",
       "121  2001  Denmark   8.44\n",
       "122  2002  Denmark   8.44"
      ]
     },
     "execution_count": 27,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu.sort_values(by='Value', ascending=False, inplace=True)\n",
    "edu.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Note that the **inplace** keyword means that the DataFrame will be overwritten, and hence no new DataFrame is returned. If instead of **ascending = False** we use **ascending = True**, the values are sorted in ascending order (i.e. from the smallest to the largest values).\n",
    "\n",
    "If we want to return to the original order, we can sort by an index using the **sort_index** function and specifying **axis=0**:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>TIME</th>\n",
       "      <th>GEO</th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>2000</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>2001</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>2002</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.00</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>2003</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>5.03</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>2004</td>\n",
       "      <td>European Union (28 countries)</td>\n",
       "      <td>4.95</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   TIME                            GEO  Value\n",
       "0  2000  European Union (28 countries)    NaN\n",
       "1  2001  European Union (28 countries)    NaN\n",
       "2  2002  European Union (28 countries)   5.00\n",
       "3  2003  European Union (28 countries)   5.03\n",
       "4  2004  European Union (28 countries)   4.95"
      ]
     },
     "execution_count": 28,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "edu.sort_index(axis=0, ascending=True, inplace=True)\n",
    "edu.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Grouping Data"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Another very useful way to inspect data is to group it according to some criteria. For instance, in our example it would be nice to group all the data by country, regardless of the year. Pandas has the **groupby** function that allows us to do just that. The value returned by this function is a special grouped DataFrame. To have a proper DataFrame as a result, it is necessary to apply an aggregation function. Thus, this function will be applied to all the values in the same group.\n",
    "\n",
    "\n",
    "For example, in our case, if we want a DataFrame showing the mean of the values for each country over all the years, we can obtain it by grouping according to country and using the mean function as the aggregation method for each group. The result would be  a DataFrame with countries as indexes and the mean values as the column:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 29,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>Value</th>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>GEO</th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>Austria</th>\n",
       "      <td>5.618333</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Belgium</th>\n",
       "      <td>6.189091</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Bulgaria</th>\n",
       "      <td>4.093333</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Cyprus</th>\n",
       "      <td>7.023333</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Czech Republic</th>\n",
       "      <td>4.168333</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "                   Value\n",
       "GEO                     \n",
       "Austria         5.618333\n",
       "Belgium         6.189091\n",
       "Bulgaria        4.093333\n",
       "Cyprus          7.023333\n",
       "Czech Republic  4.168333"
      ]
     },
     "execution_count": 29,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "group = edu[['GEO', 'Value']].groupby('GEO').mean()\n",
    "group.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Rearranging Data\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Up until now, our indexes have been just a numeration of rows without much meaning.  We can transform the arrangement of our data, redistributing the indexes and columns for better manipulation of our data, which normally leads to better performance. We can rearrange our data using the **pivot_table** function. Here, we can specify which columns will be the new indexes, the new values and the new columns. \n",
    "\n",
    "For example, imagine that we want to transform our DataFrame to a spreadsheet-like structure with the country names as the index, while the columns will be the years starting from 2006 and the values will be the previous *'Value'* column. To do this, first we need to filter out the data and then pivot it in this way:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 38,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th>TIME</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",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>GEO</th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>Austria</th>\n",
       "      <td>5.40</td>\n",
       "      <td>5.33</td>\n",
       "      <td>5.47</td>\n",
       "      <td>5.98</td>\n",
       "      <td>5.91</td>\n",
       "      <td>5.80</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Belgium</th>\n",
       "      <td>5.98</td>\n",
       "      <td>6.00</td>\n",
       "      <td>6.43</td>\n",
       "      <td>6.57</td>\n",
       "      <td>6.58</td>\n",
       "      <td>6.55</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Bulgaria</th>\n",
       "      <td>4.04</td>\n",
       "      <td>3.88</td>\n",
       "      <td>4.44</td>\n",
       "      <td>4.58</td>\n",
       "      <td>4.10</td>\n",
       "      <td>3.82</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Cyprus</th>\n",
       "      <td>7.02</td>\n",
       "      <td>6.95</td>\n",
       "      <td>7.45</td>\n",
       "      <td>7.98</td>\n",
       "      <td>7.92</td>\n",
       "      <td>7.87</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Czech Republic</th>\n",
       "      <td>4.42</td>\n",
       "      <td>4.05</td>\n",
       "      <td>3.92</td>\n",
       "      <td>4.36</td>\n",
       "      <td>4.25</td>\n",
       "      <td>4.51</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "TIME            2006  2007  2008  2009  2010  2011\n",
       "GEO                                               \n",
       "Austria         5.40  5.33  5.47  5.98  5.91  5.80\n",
       "Belgium         5.98  6.00  6.43  6.57  6.58  6.55\n",
       "Bulgaria        4.04  3.88  4.44  4.58  4.10  3.82\n",
       "Cyprus          7.02  6.95  7.45  7.98  7.92  7.87\n",
       "Czech Republic  4.42  4.05  3.92  4.36  4.25  4.51"
      ]
     },
     "execution_count": 38,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "filtered_data = edu[edu['TIME'] > 2005]\n",
    "pivedu = pd.pivot_table(filtered_data, values='Value',\n",
    "                        index=['GEO'], columns=['TIME'])\n",
    "pivedu.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now we can use the new index to select specific rows by label, using the **ix** operator:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 31,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th>TIME</th>\n",
       "      <th>2006</th>\n",
       "      <th>2011</th>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>GEO</th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>Spain</th>\n",
       "      <td>4.26</td>\n",
       "      <td>4.82</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Portugal</th>\n",
       "      <td>5.07</td>\n",
       "      <td>5.27</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "TIME      2006  2011\n",
       "GEO                 \n",
       "Spain     4.26  4.82\n",
       "Portugal  5.07  5.27"
      ]
     },
     "execution_count": 31,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "pivedu.ix[['Spain', 'Portugal'], [2006, 2011]]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Pivot also offers the option of providing an argument **aggr_function** that allows us to perform an aggregation function between the values if there is more than one value for the given row and column after the transformation. As usual, you can design any custom function you want, just giving its name or using a $\\lambda$-function."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Ranking Data"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Another useful visualization feature is to rank data. For example, we would like to know how  each country is ranked by year. To see this, we will use the pandas **rank** function. But first, we need to clean up our previous pivoted table a bit so that it only has real countries with real data. To do this, first we drop the Euro area entries and shorten the Germany name entry, using the **rename** function and then we drop all the rows containing any NaN, using the **dropna** function.\n",
    "\n",
    "Now we can perform the ranking using the **rank** function. Note here that the parameter `ascending=False` makes the ranking go from the highest values to the lowest values. The Pandas rank function supports different tie-breaking methods, specified with the **method** parameter. In our case, we use the  **first** method, in which ranks are assigned in the order they appear in the array, avoiding gaps between ranking."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 32,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th>TIME</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",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>GEO</th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>Austria</th>\n",
       "      <td>10.0</td>\n",
       "      <td>7.0</td>\n",
       "      <td>11.0</td>\n",
       "      <td>7.0</td>\n",
       "      <td>8.0</td>\n",
       "      <td>8.0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Belgium</th>\n",
       "      <td>5.0</td>\n",
       "      <td>4.0</td>\n",
       "      <td>3.0</td>\n",
       "      <td>4.0</td>\n",
       "      <td>5.0</td>\n",
       "      <td>5.0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Bulgaria</th>\n",
       "      <td>21.0</td>\n",
       "      <td>21.0</td>\n",
       "      <td>20.0</td>\n",
       "      <td>20.0</td>\n",
       "      <td>22.0</td>\n",
       "      <td>22.0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Cyprus</th>\n",
       "      <td>2.0</td>\n",
       "      <td>2.0</td>\n",
       "      <td>2.0</td>\n",
       "      <td>2.0</td>\n",
       "      <td>2.0</td>\n",
       "      <td>3.0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Czech Republic</th>\n",
       "      <td>19.0</td>\n",
       "      <td>20.0</td>\n",
       "      <td>21.0</td>\n",
       "      <td>21.0</td>\n",
       "      <td>20.0</td>\n",
       "      <td>19.0</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "TIME            2006  2007  2008  2009  2010  2011\n",
       "GEO                                               \n",
       "Austria         10.0   7.0  11.0   7.0   8.0   8.0\n",
       "Belgium          5.0   4.0   3.0   4.0   5.0   5.0\n",
       "Bulgaria        21.0  21.0  20.0  20.0  22.0  22.0\n",
       "Cyprus           2.0   2.0   2.0   2.0   2.0   3.0\n",
       "Czech Republic  19.0  20.0  21.0  21.0  20.0  19.0"
      ]
     },
     "execution_count": 32,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "pivedu = pivedu.drop(['Euro area (13 countries)',\n",
    "                      'Euro area (15 countries)',\n",
    "                      'Euro area (17 countries)',\n",
    "                      'Euro area (18 countries)',\n",
    "                      'European Union (25 countries)',\n",
    "                      'European Union (27 countries)',\n",
    "                      'European Union (28 countries)'\n",
    "                      ], axis=0)\n",
    "pivedu = pivedu.rename(\n",
    "    index={'Germany (until 1990 former territory of the FRG)': 'Germany'})\n",
    "pivedu = pivedu.dropna()\n",
    "pivedu.rank(ascending=False, method='first').head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If we want to make a global ranking taking into account all the years, we can sum up all the columns and rank the result. Then we can sort the resulting values to retrieve the top 5 countries for the last 6 years, in this way: "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 33,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "GEO\n",
       "Denmark    1.0\n",
       "Cyprus     2.0\n",
       "Finland    3.0\n",
       "Malta      4.0\n",
       "Belgium    5.0\n",
       "dtype: float64"
      ]
     },
     "execution_count": 33,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "totalSum = pivedu.sum(axis=1)\n",
    "totalSum.rank(ascending=False, method='dense').sort_values().head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Plotting"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    " Pandas DataFrames and Series can be plotted using the **plot** function, which uses the library for graphics *Matplotlib*.  \n",
    " \n",
    "For example, if we want to plot the accumulated values for each country over the last 6 years, we can take the  Series obtained in the previous example and plot it directly by calling the **plot** function: \n",
    "\n",
    "\n",
    "Note that if we want the bars ordered from the highest to the lowest value, we need to sort the values in the Series first. The parameter  **kind** used in the **plot** function defines which kind of graphic will be used. In our case, a bar graph. The parameter **style** refers to the style properties of the graphic, in our case, the color of bars is set to **b** (blue). The alpha channel can be modified adding a keyword parameter **alpha**  with a percentage, producing a more translucent plot. Finally, using the **title** keyword the name of the graphic can be set."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 34,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\n8cRJbk9PjyQpl8spHA6ru7u75RsFAAAA7MdTLQZx5swZ9ff368yZMy3bkNrocM3Nmzdb9tzY2/bj\nD3+x/frajm8D++x/B2F/Hz58aHsTjDuI++xXTzzxzCtjY2NaXFyUJKXTac3MzBjvwVsqldTZ2Wk0\nZr1cLuf2H/ZaqVRSJpNx66uz2axu3bplJHY7MHmsbRkbG9OpU6d09+5dOY6jaDT6yCRRr7TL+8vk\n33S77LNJtvb54cOHOnTokOdxtmun19jUOWx4eFhXrlyxdr6sJZxLS0saGxszEtPWPsfjca2trenW\nrVsqFArK5XLG9nk7W/lQq+M+1YpnXvjkk080Pz+vQqEgx3GMfRibTgSavWHz+bzu3bvnWex68Xhc\nAwMD2tjYUDgctlZb7eWJul2OtfR/Vyb6+voUiUSMfED39/fr1KlTSiQSunfvnhKJhOcxa2y9v2wm\nIe3yN3Xz5s2WXmVrxtY+j46OWktCTO5vO5zDLl68qHA4rPn5eT333HOKxWJGzl/xeFzLy8vq6OiQ\n4ziqVCrGEj5b+xyNRjU7OytpqzT02rVrnsessXXu9Dpu2yS53//+97WxsaFCoaDr169rZWXFSFzT\nicChQ4c0MTEhSbpx44ab9Kytrenzn/+8p7HrDQwMaHx8XKlUSuPj45qfnzcSN51OK5lMKhAIyHEc\nlUolz0bs2+VYx+NxhUIhVatVnTlzRvPz88a+xF27dk1f/vKXVSqVVK1WjcSU7L2/bCaaJve5q6tL\n4XD4kfsdx3HfZybYep1tJSGm97cdzmHRaFTBYFDlcllLS0u6f/++otGozp496+kxL5VK+uCDD9zb\nuVzOs1jb2drnjY0NzczMKBqNanV11eg529a50+u4T1WT2ypdXV3q7u5Wd3e3jh8/rtHRUd29e1dd\nXV2anJw0th31iUClUvE01ltvvaWenh719PQoEAgoFoupv79f4+PjO35oeWVzc1NTU1MKhUJKJBLG\nVq67ceOGrl+/rlu3bunWrVueJnvtcqyPHDmi6elpRaNRSfL8PVZz9uxZ9fX1aWFhQcvLy258E2y9\nv2pJyLFjx9wREVNM7vPs7Kzu3bv3yH8ffPCBrl+/7lnc7Wy9ztFoVKFQSOVyWX/7t3+rubk5LS4u\nel5LaXp/2+Ec9uqrr+r8+fM6duyYPvjgA125ckVjY2Oam5vzNG5vb68++ugj97bJhM/WPs/Ozqq3\nt1f3799XX1+f3n77bU/j1bN17vQ6rtWa3Nq3YWmrHVlHR4e7ZHAmk9HIyIjn21CtVpXNZjUyMqJU\nKqVAIGDsksjk5KQCgYAikYiKxaIkGX1TF4tFRSIRpdNp9fX1uZ0zvJRIJPS1r33NHYUwVVdm81jH\n43EFAgGVy2W3z/TCwoKR2PVM1yHben+VSiV3ZCCXyxmtmbSxz9uZrqWzsc8nTpxQR0eHLly40DBq\nPTMzoytXrnga29ZrbOsclkgkND093XBfLpfT3Nyc3n33Xc/idnV1KRAIKBQKuVcoTM3TMbnPzerL\nTZYe2Tp3eh23bSaejY6O6vXXX9fw8LDV7TB5KVmSlpeXlc/nFY1GFYvFjMWt/yBMpVLq7e01kgAl\nEgn3y0QwGDR64rJ1rKWtMo18Pq8jR454+iXKZg1fu5ysTSYh7bDPpmvp2mGf4/G4Ll265A6KSP5P\nQiS75zDTE8DS6XTDPpoa+NqJl6/z0NCQ/vmf/1mHDh1qKEMyndhL9r7AeRm3bZLcWr1NJBJRZ2en\nsZNH7U1VLpfdb40mJyRJdmaPLi4uNsSampoyMiowOjqq733ve+6H0/YTmddsHGuTM2YnJyd3rOHL\n5/MqFoueXoaydbK2mYS0wwfU+fPnNTAwoNXVVYXDYYXDYU+/qLfDPpscFGmH/a1n+hy20wQwrz4j\nbf4t71XnbuJ13v556PXVN1vH22hcp00cPXrU6erqco4ePer+24SlpSX33+Vy2Ukmk0biOo7jXL58\n2Tl+/LgzNDTknDx50jlx4oTnMefm5pyTJ0+6x7irq8s5ceKEMzk56Xlsx3GceDzurK+vu7czmYyR\nuDaOdc3295SXx7pSqbj/jsfjDY8lEgnP4m7313/91w3bks1mPYt18uRJp1qtOo6zdR45ceKEc+LE\nCef48ePGziOO03gucRxv97le7f1V+7/J1/nv//7vG26b2udsNutks1mnWCw6juM46XTaSFxbr7Hj\n2DuHnTt3ruG2X/+Wt7+29Uy+zvW8fl/bOt4m47ZNd4XZ2dlHLk2YUB8zFAq5tU4m2Jg9Oj09rdde\ne025XM7KpZ+lpSUtLS253RUCgYCRb8g2Z+qanDFbf/m2NkmmvobPlPfee0+/9Vu/5Y60eTka8d57\n77n/3n4eMfk61+LWRtoKhYKREqDa6zwwMKBEIqFcLmes5Oof//Ef9aUvfUldXV2SvH2d6507d849\nh0hSIBAwcuXP1mss2TuH1SaA1V5jL89fNv+Wm11RjEQinsXdPoJc+1x0DHRKqT/ek5OT+vrXv+5+\nhnh5vE0CgHgMAAAanElEQVS+zm2T5G5/g/X29hqJWytudxxH4XDY6KVzkyePeqFQ6JEE11R5iK0v\nM7aOtbS1z7Wa3L6+Pn31q181ErfWVSGfz2tgYMDoe/vSpUuS/q/229T7y2YSYquv5+DgoDo7O92a\nthdffNHzmDXT09P65JNPtLi4qFAopNOnTxtp5WXrPGKzd6utc1gymVQqlTI+AWz7+crLRHM7k3Xu\n29/L9Ux+STc5MFFve8uwVq8i2DY1ubYaEf/N3/xNw7cXk0zPHt3rG6Pp2jLJ3EQ/mzN1a2zUA9uK\nW//lUZKxEXuT9YPbnT9/vqF9l6luFlNTU3rxxRcVDAbV39+vdDqtTCaj8fFxz+OXSiV1dHToxo0b\nunbtmgYGBox2iKnfDhMdJWy9xpK9c5itCWA2F3YxXee+nY3VxmzNi/J6tdu2Gcm11Yh4+7cXk0yP\nRrTDN8b6iX6SjJ08bI38SPZGf2yOOtk63jbLUmyNtDmOo3//939XuVxWqVRSKpXSrVu3dO3aNc8T\nsNHRUbd/609+8hNjgwW2EiDbV4Rsl/RJ5q6yHpSFXeplMhlNTk4qFAopEAjo7bff9n0JkNer3bZN\nkmvrTWXrsqpk/uRhq+aoXv2JulKpKJ1OG4lr60Qt2Uu8bCZ89R9ItRZ1JthMQpLJpJLJpMLhsNGR\ntueff9798pJKpVQulxUMBo0sFhCLxR7pJ2qCrQTI1qV7yd45zNYXCls5gWSvzv3OnTv68MMPFQwG\nValUND8/byzJtfUlyuvVbtsmybX1pjp37lzDbVPfXiS7l2NsxbY10c/msbaVeNlM+DKZjJt4jY+P\na2pqysjJ2laiKdn7kPjFL36hmZkZlctlOY4jx3GUy+XcqyVeOnv2rPtvk/22bSVANq8I2TqH2fpC\nYXNC5fT0dEPvVlN17pFIxL0aEgqFjJZRmvwSVSu9qamNHtfub+U5u21qciU7jYhtNpy2WfdjK/ZO\nE/1MxLV5rG3V0tmIm0gklMlkVCwW3ZNYKBRSf3+/kVpN2w3kb9686U4wNLlIQCaTUSgUUmdnpwqF\nglZXV3XkyBHPt8FWv23bK9vVmKydtHUOq32RqP9CYercaWtxApOLJdVKfqStq5ulUkk9PT0qlUrG\n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\nRK5CYII=\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7fe3d9d9aed0>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "fig = plt.figure(figsize=(12, 5))\n",
    "totalSum = pivedu.sum(axis=1).sort_values(ascending=False)\n",
    "totalSum.plot(kind='bar', style='b', alpha=0.4,\n",
    "              title='Total Values for Country')\n",
    "plt.savefig('Totalvalue_Country.png', dpi=300, bbox_inches='tight')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "It is also possible to plot a DataFrame directly. In this case, each column is treated as a separated Series. For example, instead of printing the accumulated value over the years, we can plot the value for each year.\n",
    "\n",
    "\n",
    "In this case, we have used a horizontal bar diagram (`kind='barh'`) stacking all the years in the same country bar. This can be done by setting the parameter **stacked** to `True`. The number of default colors in a plot is only 5, thus if you have more than 5 Series to show, you need to specify more colors or otherwise the same set of colors will be used again. We can set a new set of colors using the keyword **color** with a list of colors. Basic colors have a single-character code assigned to each, for example, 'b' is for blue, 'r' for red, 'g' for green, 'y' for yellow, 'm' for magenta and 'c' for cyan. When several Series are shown in a plot, a legend is created for identifying each one. The name for each Series is the name of the column in the DataFrame. By default, the legend goes inside the plot area. If we want to change this, we can use the **legend** function of the axis object (this is the object returned when the plot function is called). By using the **loc** keyword, we can set the relative position of the legend with respect to the plot. It can be a combination of right or left and upper, lower or center. With**bbox_to_anchor** we can set an absolute position with respect to the plot, allowing us to put the legend outside the graph."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 35,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7fe3d9db5a50>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "my_colors = ['b', 'r', 'g', 'y', 'm', 'c']\n",
    "ax = pivedu.plot(kind='barh', stacked=True, color=my_colors, figsize=(12, 6))\n",
    "ax.legend(loc='center left', bbox_to_anchor=(1, 0.5))\n",
    "plt.savefig('Value_Time_Country.png', dpi=300, bbox_inches='tight')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Further Reading\n",
    "Pandas has much more functionalities. Check out the (very readable) pandas docs if you want to learn more:\n",
    "\n",
    "http://pandas.pydata.org/pandas-docs/stable/"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 2",
   "language": "python",
   "name": "python2"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 2
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython2",
   "version": "2.7.11"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 0
}