Assignment+3.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "---\n",
    "\n",
    "_You are currently looking at **version 1.5** of this notebook. To download notebooks and datafiles, as well as get help on Jupyter notebooks in the Coursera platform, visit the [Jupyter Notebook FAQ](https://www.coursera.org/learn/python-data-analysis/resources/0dhYG) course resource._\n",
    "\n",
    "---"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Assignment 3 - More Pandas\n",
    "This assignment requires more individual learning then the last one did - you are encouraged to check out the [pandas documentation](http://pandas.pydata.org/pandas-docs/stable/) to find functions or methods you might not have used yet, or ask questions on [Stack Overflow](http://stackoverflow.com/) and tag them as pandas and python related. And of course, the discussion forums are open for interaction with your peers and the course staff."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 1 (20%)\n",
    "Load the energy data from the file `Energy Indicators.xls`, which is a list of indicators of [energy supply and renewable electricity production](Energy%20Indicators.xls) from the [United Nations](http://unstats.un.org/unsd/environment/excel_file_tables/2013/Energy%20Indicators.xls) for the year 2013, and should be put into a DataFrame with the variable name of **energy**.\n",
    "\n",
    "Keep in mind that this is an Excel file, and not a comma separated values file. Also, make sure to exclude the footer and header information from the datafile. The first two columns are unneccessary, so you should get rid of them, and you should change the column labels so that the columns are:\n",
    "\n",
    "`['Country', 'Energy Supply', 'Energy Supply per Capita', '% Renewable']`\n",
    "\n",
    "Convert `Energy Supply` to gigajoules (there are 1,000,000 gigajoules in a petajoule). For all countries which have missing data (e.g. data with \"...\") make sure this is reflected as `np.NaN` values.\n",
    "\n",
    "Rename the following list of countries (for use in later questions):\n",
    "\n",
    "```\"Republic of Korea\": \"South Korea\",\n",
    "\"United States of America\": \"United States\",\n",
    "\"United Kingdom of Great Britain and Northern Ireland\": \"United Kingdom\",\n",
    "\"China, Hong Kong Special Administrative Region\": \"Hong Kong\"```\n",
    "\n",
    "There are also several countries with numbers and/or parenthesis in their name. Be sure to remove these, \n",
    "\n",
    "e.g. \n",
    "\n",
    "`'Bolivia (Plurinational State of)'` should be `'Bolivia'`, \n",
    "\n",
    "`'Switzerland17'` should be `'Switzerland'`.\n",
    "\n",
    "<br>\n",
    "\n",
    "Next, load the GDP data from the file `world_bank.csv`, which is a csv containing countries' GDP from 1960 to 2015 from [World Bank](http://data.worldbank.org/indicator/NY.GDP.MKTP.CD). Call this DataFrame **GDP**. \n",
    "\n",
    "Make sure to skip the header, and rename the following list of countries:\n",
    "\n",
    "```\"Korea, Rep.\": \"South Korea\", \n",
    "\"Iran, Islamic Rep.\": \"Iran\",\n",
    "\"Hong Kong SAR, China\": \"Hong Kong\"```\n",
    "\n",
    "<br>\n",
    "\n",
    "Finally, load the [Sciamgo Journal and Country Rank data for Energy Engineering and Power Technology](http://www.scimagojr.com/countryrank.php?category=2102) from the file `scimagojr-3.xlsx`, which ranks countries based on their journal contributions in the aforementioned area. Call this DataFrame **ScimEn**.\n",
    "\n",
    "Join the three datasets: GDP, Energy, and ScimEn into a new dataset (using the intersection of country names). Use only the last 10 years (2006-2015) of GDP data and only the top 15 countries by Scimagojr 'Rank' (Rank 1 through 15). \n",
    "\n",
    "The index of this DataFrame should be the name of the country, and the columns should be ['Rank', 'Documents', 'Citable documents', 'Citations', 'Self-citations',\n",
    "       'Citations per document', 'H index', 'Energy Supply',\n",
    "       'Energy Supply per Capita', '% Renewable', '2006', '2007', '2008',\n",
    "       '2009', '2010', '2011', '2012', '2013', '2014', '2015'].\n",
    "\n",
    "*This function should return a DataFrame with 20 columns and 15 entries.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "umich_part_id": "009",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>Rank</th>\n",
       "      <th>Documents</th>\n",
       "      <th>Citable documents</th>\n",
       "      <th>Citations</th>\n",
       "      <th>Self-citations</th>\n",
       "      <th>Citations per document</th>\n",
       "      <th>H index</th>\n",
       "      <th>Energy Supply</th>\n",
       "      <th>Energy Supply per Capita</th>\n",
       "      <th>% Renewable</th>\n",
       "      <th>2006</th>\n",
       "      <th>2007</th>\n",
       "      <th>2008</th>\n",
       "      <th>2009</th>\n",
       "      <th>2010</th>\n",
       "      <th>2011</th>\n",
       "      <th>2012</th>\n",
       "      <th>2013</th>\n",
       "      <th>2014</th>\n",
       "      <th>2015</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>China</th>\n",
       "      <td>1</td>\n",
       "      <td>127050</td>\n",
       "      <td>126767</td>\n",
       "      <td>597237</td>\n",
       "      <td>411683</td>\n",
       "      <td>4.70</td>\n",
       "      <td>138</td>\n",
       "      <td>1.271910e+11</td>\n",
       "      <td>93.0</td>\n",
       "      <td>19.754910</td>\n",
       "      <td>3.992331e+12</td>\n",
       "      <td>4.559041e+12</td>\n",
       "      <td>4.997775e+12</td>\n",
       "      <td>5.459247e+12</td>\n",
       "      <td>6.039659e+12</td>\n",
       "      <td>6.612490e+12</td>\n",
       "      <td>7.124978e+12</td>\n",
       "      <td>7.672448e+12</td>\n",
       "      <td>8.230121e+12</td>\n",
       "      <td>8.797999e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>United States</th>\n",
       "      <td>2</td>\n",
       "      <td>96661</td>\n",
       "      <td>94747</td>\n",
       "      <td>792274</td>\n",
       "      <td>265436</td>\n",
       "      <td>8.20</td>\n",
       "      <td>230</td>\n",
       "      <td>9.083800e+10</td>\n",
       "      <td>286.0</td>\n",
       "      <td>11.570980</td>\n",
       "      <td>1.479230e+13</td>\n",
       "      <td>1.505540e+13</td>\n",
       "      <td>1.501149e+13</td>\n",
       "      <td>1.459484e+13</td>\n",
       "      <td>1.496437e+13</td>\n",
       "      <td>1.520402e+13</td>\n",
       "      <td>1.554216e+13</td>\n",
       "      <td>1.577367e+13</td>\n",
       "      <td>1.615662e+13</td>\n",
       "      <td>1.654857e+13</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Japan</th>\n",
       "      <td>3</td>\n",
       "      <td>30504</td>\n",
       "      <td>30287</td>\n",
       "      <td>223024</td>\n",
       "      <td>61554</td>\n",
       "      <td>7.31</td>\n",
       "      <td>134</td>\n",
       "      <td>1.898400e+10</td>\n",
       "      <td>149.0</td>\n",
       "      <td>10.232820</td>\n",
       "      <td>5.496542e+12</td>\n",
       "      <td>5.617036e+12</td>\n",
       "      <td>5.558527e+12</td>\n",
       "      <td>5.251308e+12</td>\n",
       "      <td>5.498718e+12</td>\n",
       "      <td>5.473738e+12</td>\n",
       "      <td>5.569102e+12</td>\n",
       "      <td>5.644659e+12</td>\n",
       "      <td>5.642884e+12</td>\n",
       "      <td>5.669563e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>United Kingdom</th>\n",
       "      <td>4</td>\n",
       "      <td>20944</td>\n",
       "      <td>20357</td>\n",
       "      <td>206091</td>\n",
       "      <td>37874</td>\n",
       "      <td>9.84</td>\n",
       "      <td>139</td>\n",
       "      <td>7.920000e+09</td>\n",
       "      <td>124.0</td>\n",
       "      <td>10.600470</td>\n",
       "      <td>2.419631e+12</td>\n",
       "      <td>2.482203e+12</td>\n",
       "      <td>2.470614e+12</td>\n",
       "      <td>2.367048e+12</td>\n",
       "      <td>2.403504e+12</td>\n",
       "      <td>2.450911e+12</td>\n",
       "      <td>2.479809e+12</td>\n",
       "      <td>2.533370e+12</td>\n",
       "      <td>2.605643e+12</td>\n",
       "      <td>2.666333e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Russian Federation</th>\n",
       "      <td>5</td>\n",
       "      <td>18534</td>\n",
       "      <td>18301</td>\n",
       "      <td>34266</td>\n",
       "      <td>12422</td>\n",
       "      <td>1.85</td>\n",
       "      <td>57</td>\n",
       "      <td>3.070900e+10</td>\n",
       "      <td>214.0</td>\n",
       "      <td>17.288680</td>\n",
       "      <td>1.385793e+12</td>\n",
       "      <td>1.504071e+12</td>\n",
       "      <td>1.583004e+12</td>\n",
       "      <td>1.459199e+12</td>\n",
       "      <td>1.524917e+12</td>\n",
       "      <td>1.589943e+12</td>\n",
       "      <td>1.645876e+12</td>\n",
       "      <td>1.666934e+12</td>\n",
       "      <td>1.678709e+12</td>\n",
       "      <td>1.616149e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Canada</th>\n",
       "      <td>6</td>\n",
       "      <td>17899</td>\n",
       "      <td>17620</td>\n",
       "      <td>215003</td>\n",
       "      <td>40930</td>\n",
       "      <td>12.01</td>\n",
       "      <td>149</td>\n",
       "      <td>1.043100e+10</td>\n",
       "      <td>296.0</td>\n",
       "      <td>61.945430</td>\n",
       "      <td>1.564469e+12</td>\n",
       "      <td>1.596740e+12</td>\n",
       "      <td>1.612713e+12</td>\n",
       "      <td>1.565145e+12</td>\n",
       "      <td>1.613406e+12</td>\n",
       "      <td>1.664087e+12</td>\n",
       "      <td>1.693133e+12</td>\n",
       "      <td>1.730688e+12</td>\n",
       "      <td>1.773486e+12</td>\n",
       "      <td>1.792609e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Germany</th>\n",
       "      <td>7</td>\n",
       "      <td>17027</td>\n",
       "      <td>16831</td>\n",
       "      <td>140566</td>\n",
       "      <td>27426</td>\n",
       "      <td>8.26</td>\n",
       "      <td>126</td>\n",
       "      <td>1.326100e+10</td>\n",
       "      <td>165.0</td>\n",
       "      <td>17.901530</td>\n",
       "      <td>3.332891e+12</td>\n",
       "      <td>3.441561e+12</td>\n",
       "      <td>3.478809e+12</td>\n",
       "      <td>3.283340e+12</td>\n",
       "      <td>3.417298e+12</td>\n",
       "      <td>3.542371e+12</td>\n",
       "      <td>3.556724e+12</td>\n",
       "      <td>3.567317e+12</td>\n",
       "      <td>3.624386e+12</td>\n",
       "      <td>3.685556e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>India</th>\n",
       "      <td>8</td>\n",
       "      <td>15005</td>\n",
       "      <td>14841</td>\n",
       "      <td>128763</td>\n",
       "      <td>37209</td>\n",
       "      <td>8.58</td>\n",
       "      <td>115</td>\n",
       "      <td>3.319500e+10</td>\n",
       "      <td>26.0</td>\n",
       "      <td>14.969080</td>\n",
       "      <td>1.265894e+12</td>\n",
       "      <td>1.374865e+12</td>\n",
       "      <td>1.428361e+12</td>\n",
       "      <td>1.549483e+12</td>\n",
       "      <td>1.708459e+12</td>\n",
       "      <td>1.821872e+12</td>\n",
       "      <td>1.924235e+12</td>\n",
       "      <td>2.051982e+12</td>\n",
       "      <td>2.200617e+12</td>\n",
       "      <td>2.367206e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>France</th>\n",
       "      <td>9</td>\n",
       "      <td>13153</td>\n",
       "      <td>12973</td>\n",
       "      <td>130632</td>\n",
       "      <td>28601</td>\n",
       "      <td>9.93</td>\n",
       "      <td>114</td>\n",
       "      <td>1.059700e+10</td>\n",
       "      <td>166.0</td>\n",
       "      <td>17.020280</td>\n",
       "      <td>2.607840e+12</td>\n",
       "      <td>2.669424e+12</td>\n",
       "      <td>2.674637e+12</td>\n",
       "      <td>2.595967e+12</td>\n",
       "      <td>2.646995e+12</td>\n",
       "      <td>2.702032e+12</td>\n",
       "      <td>2.706968e+12</td>\n",
       "      <td>2.722567e+12</td>\n",
       "      <td>2.729632e+12</td>\n",
       "      <td>2.761185e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>South Korea</th>\n",
       "      <td>10</td>\n",
       "      <td>11983</td>\n",
       "      <td>11923</td>\n",
       "      <td>114675</td>\n",
       "      <td>22595</td>\n",
       "      <td>9.57</td>\n",
       "      <td>104</td>\n",
       "      <td>1.100700e+10</td>\n",
       "      <td>221.0</td>\n",
       "      <td>2.279353</td>\n",
       "      <td>9.410199e+11</td>\n",
       "      <td>9.924316e+11</td>\n",
       "      <td>1.020510e+12</td>\n",
       "      <td>1.027730e+12</td>\n",
       "      <td>1.094499e+12</td>\n",
       "      <td>1.134796e+12</td>\n",
       "      <td>1.160809e+12</td>\n",
       "      <td>1.194429e+12</td>\n",
       "      <td>1.234340e+12</td>\n",
       "      <td>1.266580e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Italy</th>\n",
       "      <td>11</td>\n",
       "      <td>10964</td>\n",
       "      <td>10794</td>\n",
       "      <td>111850</td>\n",
       "      <td>26661</td>\n",
       "      <td>10.20</td>\n",
       "      <td>106</td>\n",
       "      <td>6.530000e+09</td>\n",
       "      <td>109.0</td>\n",
       "      <td>33.667230</td>\n",
       "      <td>2.202170e+12</td>\n",
       "      <td>2.234627e+12</td>\n",
       "      <td>2.211154e+12</td>\n",
       "      <td>2.089938e+12</td>\n",
       "      <td>2.125185e+12</td>\n",
       "      <td>2.137439e+12</td>\n",
       "      <td>2.077184e+12</td>\n",
       "      <td>2.040871e+12</td>\n",
       "      <td>2.033868e+12</td>\n",
       "      <td>2.049316e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Spain</th>\n",
       "      <td>12</td>\n",
       "      <td>9428</td>\n",
       "      <td>9330</td>\n",
       "      <td>123336</td>\n",
       "      <td>23964</td>\n",
       "      <td>13.08</td>\n",
       "      <td>115</td>\n",
       "      <td>4.923000e+09</td>\n",
       "      <td>106.0</td>\n",
       "      <td>37.968590</td>\n",
       "      <td>1.414823e+12</td>\n",
       "      <td>1.468146e+12</td>\n",
       "      <td>1.484530e+12</td>\n",
       "      <td>1.431475e+12</td>\n",
       "      <td>1.431673e+12</td>\n",
       "      <td>1.417355e+12</td>\n",
       "      <td>1.380216e+12</td>\n",
       "      <td>1.357139e+12</td>\n",
       "      <td>1.375605e+12</td>\n",
       "      <td>1.419821e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Iran</th>\n",
       "      <td>13</td>\n",
       "      <td>8896</td>\n",
       "      <td>8819</td>\n",
       "      <td>57470</td>\n",
       "      <td>19125</td>\n",
       "      <td>6.46</td>\n",
       "      <td>72</td>\n",
       "      <td>9.172000e+09</td>\n",
       "      <td>119.0</td>\n",
       "      <td>5.707721</td>\n",
       "      <td>3.895523e+11</td>\n",
       "      <td>4.250646e+11</td>\n",
       "      <td>4.289909e+11</td>\n",
       "      <td>4.389208e+11</td>\n",
       "      <td>4.677902e+11</td>\n",
       "      <td>4.853309e+11</td>\n",
       "      <td>4.532569e+11</td>\n",
       "      <td>4.445926e+11</td>\n",
       "      <td>4.639027e+11</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Australia</th>\n",
       "      <td>14</td>\n",
       "      <td>8831</td>\n",
       "      <td>8725</td>\n",
       "      <td>90765</td>\n",
       "      <td>15606</td>\n",
       "      <td>10.28</td>\n",
       "      <td>107</td>\n",
       "      <td>5.386000e+09</td>\n",
       "      <td>231.0</td>\n",
       "      <td>11.810810</td>\n",
       "      <td>1.021939e+12</td>\n",
       "      <td>1.060340e+12</td>\n",
       "      <td>1.099644e+12</td>\n",
       "      <td>1.119654e+12</td>\n",
       "      <td>1.142251e+12</td>\n",
       "      <td>1.169431e+12</td>\n",
       "      <td>1.211913e+12</td>\n",
       "      <td>1.241484e+12</td>\n",
       "      <td>1.272520e+12</td>\n",
       "      <td>1.301251e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Brazil</th>\n",
       "      <td>15</td>\n",
       "      <td>8668</td>\n",
       "      <td>8596</td>\n",
       "      <td>60702</td>\n",
       "      <td>14396</td>\n",
       "      <td>7.00</td>\n",
       "      <td>86</td>\n",
       "      <td>1.214900e+10</td>\n",
       "      <td>59.0</td>\n",
       "      <td>69.648030</td>\n",
       "      <td>1.845080e+12</td>\n",
       "      <td>1.957118e+12</td>\n",
       "      <td>2.056809e+12</td>\n",
       "      <td>2.054215e+12</td>\n",
       "      <td>2.208872e+12</td>\n",
       "      <td>2.295245e+12</td>\n",
       "      <td>2.339209e+12</td>\n",
       "      <td>2.409740e+12</td>\n",
       "      <td>2.412231e+12</td>\n",
       "      <td>2.319423e+12</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "                    Rank  Documents  Citable documents  Citations  \\\n",
       "China                  1     127050             126767     597237   \n",
       "United States          2      96661              94747     792274   \n",
       "Japan                  3      30504              30287     223024   \n",
       "United Kingdom         4      20944              20357     206091   \n",
       "Russian Federation     5      18534              18301      34266   \n",
       "Canada                 6      17899              17620     215003   \n",
       "Germany                7      17027              16831     140566   \n",
       "India                  8      15005              14841     128763   \n",
       "France                 9      13153              12973     130632   \n",
       "South Korea           10      11983              11923     114675   \n",
       "Italy                 11      10964              10794     111850   \n",
       "Spain                 12       9428               9330     123336   \n",
       "Iran                  13       8896               8819      57470   \n",
       "Australia             14       8831               8725      90765   \n",
       "Brazil                15       8668               8596      60702   \n",
       "\n",
       "                    Self-citations  Citations per document  H index  \\\n",
       "China                       411683                    4.70      138   \n",
       "United States               265436                    8.20      230   \n",
       "Japan                        61554                    7.31      134   \n",
       "United Kingdom               37874                    9.84      139   \n",
       "Russian Federation           12422                    1.85       57   \n",
       "Canada                       40930                   12.01      149   \n",
       "Germany                      27426                    8.26      126   \n",
       "India                        37209                    8.58      115   \n",
       "France                       28601                    9.93      114   \n",
       "South Korea                  22595                    9.57      104   \n",
       "Italy                        26661                   10.20      106   \n",
       "Spain                        23964                   13.08      115   \n",
       "Iran                         19125                    6.46       72   \n",
       "Australia                    15606                   10.28      107   \n",
       "Brazil                       14396                    7.00       86   \n",
       "\n",
       "                    Energy Supply  Energy Supply per Capita  % Renewable  \\\n",
       "China                1.271910e+11                      93.0    19.754910   \n",
       "United States        9.083800e+10                     286.0    11.570980   \n",
       "Japan                1.898400e+10                     149.0    10.232820   \n",
       "United Kingdom       7.920000e+09                     124.0    10.600470   \n",
       "Russian Federation   3.070900e+10                     214.0    17.288680   \n",
       "Canada               1.043100e+10                     296.0    61.945430   \n",
       "Germany              1.326100e+10                     165.0    17.901530   \n",
       "India                3.319500e+10                      26.0    14.969080   \n",
       "France               1.059700e+10                     166.0    17.020280   \n",
       "South Korea          1.100700e+10                     221.0     2.279353   \n",
       "Italy                6.530000e+09                     109.0    33.667230   \n",
       "Spain                4.923000e+09                     106.0    37.968590   \n",
       "Iran                 9.172000e+09                     119.0     5.707721   \n",
       "Australia            5.386000e+09                     231.0    11.810810   \n",
       "Brazil               1.214900e+10                      59.0    69.648030   \n",
       "\n",
       "                            2006          2007          2008          2009  \\\n",
       "China               3.992331e+12  4.559041e+12  4.997775e+12  5.459247e+12   \n",
       "United States       1.479230e+13  1.505540e+13  1.501149e+13  1.459484e+13   \n",
       "Japan               5.496542e+12  5.617036e+12  5.558527e+12  5.251308e+12   \n",
       "United Kingdom      2.419631e+12  2.482203e+12  2.470614e+12  2.367048e+12   \n",
       "Russian Federation  1.385793e+12  1.504071e+12  1.583004e+12  1.459199e+12   \n",
       "Canada              1.564469e+12  1.596740e+12  1.612713e+12  1.565145e+12   \n",
       "Germany             3.332891e+12  3.441561e+12  3.478809e+12  3.283340e+12   \n",
       "India               1.265894e+12  1.374865e+12  1.428361e+12  1.549483e+12   \n",
       "France              2.607840e+12  2.669424e+12  2.674637e+12  2.595967e+12   \n",
       "South Korea         9.410199e+11  9.924316e+11  1.020510e+12  1.027730e+12   \n",
       "Italy               2.202170e+12  2.234627e+12  2.211154e+12  2.089938e+12   \n",
       "Spain               1.414823e+12  1.468146e+12  1.484530e+12  1.431475e+12   \n",
       "Iran                3.895523e+11  4.250646e+11  4.289909e+11  4.389208e+11   \n",
       "Australia           1.021939e+12  1.060340e+12  1.099644e+12  1.119654e+12   \n",
       "Brazil              1.845080e+12  1.957118e+12  2.056809e+12  2.054215e+12   \n",
       "\n",
       "                            2010          2011          2012          2013  \\\n",
       "China               6.039659e+12  6.612490e+12  7.124978e+12  7.672448e+12   \n",
       "United States       1.496437e+13  1.520402e+13  1.554216e+13  1.577367e+13   \n",
       "Japan               5.498718e+12  5.473738e+12  5.569102e+12  5.644659e+12   \n",
       "United Kingdom      2.403504e+12  2.450911e+12  2.479809e+12  2.533370e+12   \n",
       "Russian Federation  1.524917e+12  1.589943e+12  1.645876e+12  1.666934e+12   \n",
       "Canada              1.613406e+12  1.664087e+12  1.693133e+12  1.730688e+12   \n",
       "Germany             3.417298e+12  3.542371e+12  3.556724e+12  3.567317e+12   \n",
       "India               1.708459e+12  1.821872e+12  1.924235e+12  2.051982e+12   \n",
       "France              2.646995e+12  2.702032e+12  2.706968e+12  2.722567e+12   \n",
       "South Korea         1.094499e+12  1.134796e+12  1.160809e+12  1.194429e+12   \n",
       "Italy               2.125185e+12  2.137439e+12  2.077184e+12  2.040871e+12   \n",
       "Spain               1.431673e+12  1.417355e+12  1.380216e+12  1.357139e+12   \n",
       "Iran                4.677902e+11  4.853309e+11  4.532569e+11  4.445926e+11   \n",
       "Australia           1.142251e+12  1.169431e+12  1.211913e+12  1.241484e+12   \n",
       "Brazil              2.208872e+12  2.295245e+12  2.339209e+12  2.409740e+12   \n",
       "\n",
       "                            2014          2015  \n",
       "China               8.230121e+12  8.797999e+12  \n",
       "United States       1.615662e+13  1.654857e+13  \n",
       "Japan               5.642884e+12  5.669563e+12  \n",
       "United Kingdom      2.605643e+12  2.666333e+12  \n",
       "Russian Federation  1.678709e+12  1.616149e+12  \n",
       "Canada              1.773486e+12  1.792609e+12  \n",
       "Germany             3.624386e+12  3.685556e+12  \n",
       "India               2.200617e+12  2.367206e+12  \n",
       "France              2.729632e+12  2.761185e+12  \n",
       "South Korea         1.234340e+12  1.266580e+12  \n",
       "Italy               2.033868e+12  2.049316e+12  \n",
       "Spain               1.375605e+12  1.419821e+12  \n",
       "Iran                4.639027e+11           NaN  \n",
       "Australia           1.272520e+12  1.301251e+12  \n",
       "Brazil              2.412231e+12  2.319423e+12  "
      ]
     },
     "execution_count": 1,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "import pandas as pd\n",
    "import numpy as np\n",
    "energy = pd.read_excel('Energy Indicators.xls', skiprows=18, skipfooter=38,\n",
    "                           usecols=[2,3,4,5],names=['Country', 'Energy Supply', 'Energy Supply per Capita', '% Renewable']\n",
    "                           )\n",
    "energy['Country'] =energy['Country'].str.replace('\\d+', '')\n",
    "energy['Country'] =energy['Country'].str.replace(r\"\\(.*\\)\",\"\").str.rstrip()\n",
    "energy=energy.replace('...',np.NaN).set_index('Country')\n",
    "energy=energy.rename({\"Republic of Korea\": \"South Korea\", \"United States of America\": \"United States\",\n",
    "                          \"United Kingdom of Great Britain and Northern Ireland\": \"United Kingdom\",\n",
    "                        \"China, Hong Kong Special Administrative Region\": \"Hong Kong\"})\n",
    "energy['Energy Supply'] = energy['Energy Supply']*1000000\n",
    "    \n",
    "GDP = pd.read_csv('world_bank.csv', skiprows=4).set_index('Country Name')\n",
    "GDP = GDP.rename({\"Korea, Rep.\": \"South Korea\", \"Iran, Islamic Rep.\": \"Iran\",\n",
    "                      \"Hong Kong SAR, China\": \"Hong Kong\"})[GDP.columns[-10:]]\n",
    "ScimEn = pd.read_excel('scimagojr-3.xlsx').set_index('Country')\n",
    "\n",
    "def answer_one():\n",
    "    res = pd.merge(pd.merge(ScimEn,energy,how='inner',left_index=True,right_index=True),GDP,\n",
    "                   how='inner',left_index=True,right_index=True).sort_values('Rank')\n",
    "    return res[:15]\n",
    "answer_one()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 2 (6.6%)\n",
    "The previous question joined three datasets then reduced this to just the top 15 entries. When you joined the datasets, but before you reduced this to the top 15 items, how many entries did you lose?\n",
    "\n",
    "*This function should return a single number.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<svg width=\"800\" height=\"300\">\n",
       "  <circle cx=\"150\" cy=\"180\" r=\"80\" fill-opacity=\"0.2\" stroke=\"black\" stroke-width=\"2\" fill=\"blue\" />\n",
       "  <circle cx=\"200\" cy=\"100\" r=\"80\" fill-opacity=\"0.2\" stroke=\"black\" stroke-width=\"2\" fill=\"red\" />\n",
       "  <circle cx=\"100\" cy=\"100\" r=\"80\" fill-opacity=\"0.2\" stroke=\"black\" stroke-width=\"2\" fill=\"green\" />\n",
       "  <line x1=\"150\" y1=\"125\" x2=\"300\" y2=\"150\" stroke=\"black\" stroke-width=\"2\" fill=\"black\" stroke-dasharray=\"5,3\"/>\n",
       "  <text  x=\"300\" y=\"165\" font-family=\"Verdana\" font-size=\"35\">Everything but this!</text>\n",
       "</svg>"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "%%HTML\n",
    "<svg width=\"800\" height=\"300\">\n",
    "  <circle cx=\"150\" cy=\"180\" r=\"80\" fill-opacity=\"0.2\" stroke=\"black\" stroke-width=\"2\" fill=\"blue\" />\n",
    "  <circle cx=\"200\" cy=\"100\" r=\"80\" fill-opacity=\"0.2\" stroke=\"black\" stroke-width=\"2\" fill=\"red\" />\n",
    "  <circle cx=\"100\" cy=\"100\" r=\"80\" fill-opacity=\"0.2\" stroke=\"black\" stroke-width=\"2\" fill=\"green\" />\n",
    "  <line x1=\"150\" y1=\"125\" x2=\"300\" y2=\"150\" stroke=\"black\" stroke-width=\"2\" fill=\"black\" stroke-dasharray=\"5,3\"/>\n",
    "  <text  x=\"300\" y=\"165\" font-family=\"Verdana\" font-size=\"35\">Everything but this!</text>\n",
    "</svg>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "umich_part_id": "010",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "156"
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_two():\n",
    "    return (len(pd.merge(pd.merge(ScimEn,energy,how='outer',left_index=True,right_index=True),GDP,\n",
    "                   how='outer',left_index=True,right_index=True))\n",
    "            -len(pd.merge(pd.merge(ScimEn,energy,how='inner',left_index=True,right_index=True),GDP,\n",
    "                   how='inner',left_index=True,right_index=True))-1)\n",
    "answer_two()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Answer the following questions in the context of only the top 15 countries by Scimagojr Rank (aka the DataFrame returned by `answer_one()`)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 3 (6.6%)\n",
    "What is the average GDP over the last 10 years for each country? (exclude missing values from this calculation.)\n",
    "\n",
    "*This function should return a Series named `avgGDP` with 15 countries and their average GDP sorted in descending order.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "scrolled": true,
    "umich_part_id": "011",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "United States         1.536434e+13\n",
       "China                 6.348609e+12\n",
       "Japan                 5.542208e+12\n",
       "Germany               3.493025e+12\n",
       "France                2.681725e+12\n",
       "United Kingdom        2.487907e+12\n",
       "Brazil                2.189794e+12\n",
       "Italy                 2.120175e+12\n",
       "India                 1.769297e+12\n",
       "Canada                1.660647e+12\n",
       "Russian Federation    1.565459e+12\n",
       "Spain                 1.418078e+12\n",
       "Australia             1.164043e+12\n",
       "South Korea           1.106715e+12\n",
       "Iran                  4.441558e+11\n",
       "dtype: float64"
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_three():\n",
    "    Top15 = answer_one()\n",
    "    avgGDP = Top15[Top15.columns[-10:]].apply(np.mean,axis=1).sort_values(ascending=False)\n",
    "    return avgGDP\n",
    "\n",
    "answer_three()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 4 (6.6%)\n",
    "By how much had the GDP changed over the 10 year span for the country with the 6th largest average GDP?\n",
    "\n",
    "*This function should return a single number.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {
    "scrolled": true,
    "umich_part_id": "012",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "246702696075.3999"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_four():\n",
    "    Top15 = answer_one()\n",
    "    cty = answer_three().index[5]\n",
    "    return Top15.loc[cty]['2015']-Top15.loc[cty]['2006']\n",
    "\n",
    "answer_four()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 5 (6.6%)\n",
    "What is the mean `Energy Supply per Capita`?\n",
    "\n",
    "*This function should return a single number.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {
    "umich_part_id": "013",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "157.6"
      ]
     },
     "execution_count": 6,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_five():\n",
    "    Top15 = answer_one()\n",
    "    return Top15['Energy Supply per Capita'].mean()\n",
    "\n",
    "answer_five()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 6 (6.6%)\n",
    "What country has the maximum % Renewable and what is the percentage?\n",
    "\n",
    "*This function should return a tuple with the name of the country and the percentage.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {
    "umich_part_id": "014",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "('Brazil', 69.648030000000006)"
      ]
     },
     "execution_count": 7,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_six():\n",
    "    Top15 = answer_one()\n",
    "    return Top15['% Renewable'].argmax(),Top15['% Renewable'].max()\n",
    "\n",
    "answer_six()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 7 (6.6%)\n",
    "Create a new column that is the ratio of Self-Citations to Total Citations. \n",
    "What is the maximum value for this new column, and what country has the highest ratio?\n",
    "\n",
    "*This function should return a tuple with the name of the country and the ratio.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {
    "umich_part_id": "015",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "('China', 0.68931261793894216)"
      ]
     },
     "execution_count": 8,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_seven():\n",
    "    Top15 = answer_one()\n",
    "    Top15['Ratio'] = Top15['Self-citations'] / Top15['Citations']\n",
    "    return Top15['Ratio'].argmax(), Top15['Ratio'].max()\n",
    "\n",
    "answer_seven()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 8 (6.6%)\n",
    "\n",
    "Create a column that estimates the population using Energy Supply and Energy Supply per capita. \n",
    "What is the third most populous country according to this estimate?\n",
    "\n",
    "*This function should return a single string value.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "umich_part_id": "016",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'United States'"
      ]
     },
     "execution_count": 9,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_eight():\n",
    "    Top15 = answer_one()\n",
    "    Top15['Pop'] = Top15['Energy Supply'] / Top15['Energy Supply per Capita']\n",
    "    return Top15.nlargest(3,'Pop').index[2]\n",
    "\n",
    "answer_eight()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 9 (6.6%)\n",
    "Create a column that estimates the number of citable documents per person. \n",
    "What is the correlation between the number of citable documents per capita and the energy supply per capita? Use the `.corr()` method, (Pearson's correlation).\n",
    "\n",
    "*This function should return a single number.*\n",
    "\n",
    "*(Optional: Use the built-in function `plot9()` to visualize the relationship between Energy Supply per Capita vs. Citable docs per Capita)*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {
    "umich_part_id": "017",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.79400104354429435"
      ]
     },
     "execution_count": 10,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_nine():\n",
    "    Top15 = answer_one()\n",
    "    Top15['PopEst'] = Top15['Energy Supply'] / Top15['Energy Supply per Capita']\n",
    "    Top15['Citable docs per Capita'] = Top15['Citable documents'] / Top15['PopEst']\n",
    "    return Top15.corr().loc['Citable docs per Capita','Energy Supply per Capita']\n",
    "\n",
    "answer_nine()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "def plot9():\n",
    "    import matplotlib as plt\n",
    "    %matplotlib inline\n",
    "    \n",
    "    Top15 = answer_one()\n",
    "    Top15['PopEst'] = Top15['Energy Supply'] / Top15['Energy Supply per Capita']\n",
    "    Top15['Citable docs per Capita'] = Top15['Citable documents'] / Top15['PopEst']\n",
    "    Top15.plot(x='Citable docs per Capita', y='Energy Supply per Capita', kind='scatter', xlim=[0, 0.0006])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\nA9ieEcL9fYpOAAAAAElFTkSuQmCC\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7fd27b6c4048>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plot9() # Be sure to comment out plot9() before submitting the assignment!"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 10 (6.6%)\n",
    "Create a new column with a 1 if the country's % Renewable value is at or above the median for all countries in the top 15, and a 0 if the country's % Renewable value is below the median.\n",
    "\n",
    "*This function should return a series named `HighRenew` whose index is the country name sorted in ascending order of rank.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {
    "umich_part_id": "018",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "China                 1\n",
       "United States         0\n",
       "Japan                 0\n",
       "United Kingdom        0\n",
       "Russian Federation    1\n",
       "Canada                1\n",
       "Germany               1\n",
       "India                 0\n",
       "France                1\n",
       "South Korea           0\n",
       "Italy                 1\n",
       "Spain                 1\n",
       "Iran                  0\n",
       "Australia             0\n",
       "Brazil                1\n",
       "Name: % Renewable, dtype: int64"
      ]
     },
     "execution_count": 13,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_ten():\n",
    "    Top15 = answer_one()\n",
    "    med = Top15['% Renewable'].median()\n",
    "    HighRenew = (Top15['% Renewable'] >= med).astype(int)\n",
    "    return HighRenew\n",
    "\n",
    "answer_ten()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 11 (6.6%)\n",
    "Use the following dictionary to group the Countries by Continent, then create a dateframe that displays the sample size (the number of countries in each continent bin), and the sum, mean, and std deviation for the estimated population of each country.\n",
    "\n",
    "```python\n",
    "ContinentDict  = {'China':'Asia', \n",
    "                  'United States':'North America', \n",
    "                  'Japan':'Asia', \n",
    "                  'United Kingdom':'Europe', \n",
    "                  'Russian Federation':'Europe', \n",
    "                  'Canada':'North America', \n",
    "                  'Germany':'Europe', \n",
    "                  'India':'Asia',\n",
    "                  'France':'Europe', \n",
    "                  'South Korea':'Asia', \n",
    "                  'Italy':'Europe', \n",
    "                  'Spain':'Europe', \n",
    "                  'Iran':'Asia',\n",
    "                  'Australia':'Australia', \n",
    "                  'Brazil':'South America'}\n",
    "```\n",
    "\n",
    "*This function should return a DataFrame with index named Continent `['Asia', 'Australia', 'Europe', 'North America', 'South America']` and columns `['size', 'sum', 'mean', 'std']`*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {
    "umich_part_id": "019",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>size</th>\n",
       "      <th>sum</th>\n",
       "      <th>mean</th>\n",
       "      <th>std</th>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Continent</th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>Asia</th>\n",
       "      <td>5.0</td>\n",
       "      <td>2.898666e+09</td>\n",
       "      <td>5.797333e+08</td>\n",
       "      <td>6.790979e+08</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Australia</th>\n",
       "      <td>1.0</td>\n",
       "      <td>2.331602e+07</td>\n",
       "      <td>2.331602e+07</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Europe</th>\n",
       "      <td>6.0</td>\n",
       "      <td>4.579297e+08</td>\n",
       "      <td>7.632161e+07</td>\n",
       "      <td>3.464767e+07</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>North America</th>\n",
       "      <td>2.0</td>\n",
       "      <td>3.528552e+08</td>\n",
       "      <td>1.764276e+08</td>\n",
       "      <td>1.996696e+08</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>South America</th>\n",
       "      <td>1.0</td>\n",
       "      <td>2.059153e+08</td>\n",
       "      <td>2.059153e+08</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "               size           sum          mean           std\n",
       "Continent                                                    \n",
       "Asia            5.0  2.898666e+09  5.797333e+08  6.790979e+08\n",
       "Australia       1.0  2.331602e+07  2.331602e+07           NaN\n",
       "Europe          6.0  4.579297e+08  7.632161e+07  3.464767e+07\n",
       "North America   2.0  3.528552e+08  1.764276e+08  1.996696e+08\n",
       "South America   1.0  2.059153e+08  2.059153e+08           NaN"
      ]
     },
     "execution_count": 14,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_eleven():\n",
    "    Top15 = answer_one()\n",
    "    Top15['PopEst'] = Top15['Energy Supply'] / Top15['Energy Supply per Capita']\n",
    "    Top15['Continent'] = pd.Series({'China':'Asia', \n",
    "                  'United States':'North America', \n",
    "                  'Japan':'Asia', \n",
    "                  'United Kingdom':'Europe', \n",
    "                  'Russian Federation':'Europe', \n",
    "                  'Canada':'North America', \n",
    "                  'Germany':'Europe', \n",
    "                  'India':'Asia',\n",
    "                  'France':'Europe', \n",
    "                  'South Korea':'Asia', \n",
    "                  'Italy':'Europe', \n",
    "                  'Spain':'Europe', \n",
    "                  'Iran':'Asia',\n",
    "                  'Australia':'Australia', \n",
    "                  'Brazil':'South America'})\n",
    "    \n",
    "    return Top15.groupby('Continent')['PopEst'].agg({'size':np.size, 'sum':np.sum, 'mean':np.mean, 'std':np.std})\n",
    "\n",
    "answer_eleven()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 12 (6.6%)\n",
    "Cut % Renewable into 5 bins. Group Top15 by the Continent, as well as these new % Renewable bins. How many countries are in each of these groups?\n",
    "\n",
    "*This function should return a __Series__ with a MultiIndex of `Continent`, then the bins for `% Renewable`. Do not include groups with no countries.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {
    "scrolled": true
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Continent      Bins for % Renewable\n",
       "Asia           (2.212, 15.753]         4\n",
       "               (15.753, 29.227]        1\n",
       "Australia      (2.212, 15.753]         1\n",
       "Europe         (2.212, 15.753]         1\n",
       "               (15.753, 29.227]        3\n",
       "               (29.227, 42.701]        2\n",
       "North America  (2.212, 15.753]         1\n",
       "               (56.174, 69.648]        1\n",
       "South America  (56.174, 69.648]        1\n",
       "Name: Rank, dtype: int64"
      ]
     },
     "execution_count": 15,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_twelve():\n",
    "    Top15 = answer_one()\n",
    "    Top15['Continent'] = pd.Series({'China':'Asia', \n",
    "                  'United States':'North America', \n",
    "                  'Japan':'Asia', \n",
    "                  'United Kingdom':'Europe', \n",
    "                  'Russian Federation':'Europe', \n",
    "                  'Canada':'North America', \n",
    "                  'Germany':'Europe', \n",
    "                  'India':'Asia',\n",
    "                  'France':'Europe', \n",
    "                  'South Korea':'Asia', \n",
    "                  'Italy':'Europe', \n",
    "                  'Spain':'Europe', \n",
    "                  'Iran':'Asia',\n",
    "                  'Australia':'Australia', \n",
    "                  'Brazil':'South America'})\n",
    "    Top15['Bins for % Renewable'] = pd.cut(Top15['% Renewable'],5)\n",
    "    return Top15.groupby(['Continent','Bins for % Renewable'])['Rank'].agg(np.size).dropna()\n",
    "    \n",
    "answer_twelve()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 13 (6.6%)\n",
    "Convert the Population Estimate series to a string with thousands separator (using commas). Do not round the results.\n",
    "\n",
    "e.g. 317615384.61538464 -> 317,615,384.61538464\n",
    "\n",
    "*This function should return a Series `PopEst` whose index is the country name and whose values are the population estimate string.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {
    "scrolled": true,
    "umich_part_id": "020",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "China                 1,367,645,161.2903225\n",
       "United States          317,615,384.61538464\n",
       "Japan                  127,409,395.97315437\n",
       "United Kingdom         63,870,967.741935484\n",
       "Russian Federation            143,500,000.0\n",
       "Canada                  35,239,864.86486486\n",
       "Germany                 80,369,696.96969697\n",
       "India                 1,276,730,769.2307692\n",
       "France                  63,837,349.39759036\n",
       "South Korea            49,805,429.864253394\n",
       "Italy                  59,908,256.880733944\n",
       "Spain                    46,443,396.2264151\n",
       "Iran                    77,075,630.25210084\n",
       "Australia              23,316,017.316017315\n",
       "Brazil                 205,915,254.23728815\n",
       "dtype: object"
      ]
     },
     "execution_count": 16,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_thirteen():\n",
    "    Top15 = answer_one()\n",
    "    PopEst = (Top15['Energy Supply'] / Top15['Energy Supply per Capita']).map('{:,}'.format)\n",
    "    return PopEst\n",
    "\n",
    "answer_thirteen()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Optional\n",
    "\n",
    "Use the built in function `plot_optional()` to see an example visualization."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {
    "collapsed": true,
    "scrolled": true
   },
   "outputs": [],
   "source": [
    "def plot_optional():\n",
    "    import matplotlib as plt\n",
    "    %matplotlib inline\n",
    "    Top15 = answer_one()\n",
    "    ax = Top15.plot(x='Rank', y='% Renewable', kind='scatter', \n",
    "                    c=['#e41a1c','#377eb8','#e41a1c','#4daf4a','#4daf4a','#377eb8','#4daf4a','#e41a1c',\n",
    "                       '#4daf4a','#e41a1c','#4daf4a','#4daf4a','#e41a1c','#dede00','#ff7f00'], \n",
    "                    xticks=range(1,16), s=6*Top15['2014']/10**10, alpha=.75, figsize=[16,6]);\n",
    "\n",
    "    for i, txt in enumerate(Top15.index):\n",
    "        ax.annotate(txt, [Top15['Rank'][i], Top15['% Renewable'][i]], ha='center')\n",
    "\n",
    "    print(\"This is an example of a visualization that can be created to help understand the data. \\\n",
    "This is a bubble chart showing % Renewable vs. Rank. The size of the bubble corresponds to the countries' \\\n",
    "2014 GDP, and the color corresponds to the continent.\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "This is an example of a visualization that can be created to help understand the data. This is a bubble chart showing % Renewable vs. Rank. The size of the bubble corresponds to the countries' 2014 GDP, and the color corresponds to the continent.\n"
     ]
    },
    {
     "data": {
      "image/png": "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\nQOS8gDp1hGoAAAAASUVORK5CYII=\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7fd2493a6278>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plot_optional() # Be sure to comment out plot_optional() before submitting the assignment!"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "anaconda-cloud": {},
  "coursera": {
   "course_slug": "python-data-analysis",
   "graded_item_id": "zAr06",
   "launcher_item_id": "KSSjT",
   "part_id": "SL3fU"
  },
  "kernelspec": {
   "display_name": "Python [default]",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.6.5"
  },
  "umich": {
   "id": "Assignment 3",
   "version": "1.5"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}