{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Modeling and Simulation in Python\n", "\n", "Chapter 8\n", "\n", "Copyright 2017 Allen Downey\n", "\n", "License: [Creative Commons Attribution 4.0 International](https://creativecommons.org/licenses/by/4.0)\n" ] }, { "cell_type": "code", "execution_count": 1, "metadata": { "collapsed": true }, "outputs": [], "source": [ "# Configure Jupyter so figures appear in the notebook\n", "%matplotlib inline\n", "\n", "# Configure Jupyter to display the assigned value after an assignment\n", "%config InteractiveShell.ast_node_interactivity='last_expr_or_assign'\n", "\n", "# import functions from the modsim.py module\n", "from modsim import *\n", "\n", "from pandas import read_html" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Functions from the previous chapter" ] }, { "cell_type": "code", "execution_count": 2, "metadata": { "collapsed": true }, "outputs": [], "source": [ "def plot_results(census, un, timeseries, title):\n", " \"\"\"Plot the estimates and the model.\n", " \n", " census: TimeSeries of population estimates\n", " un: TimeSeries of population estimates\n", " timeseries: TimeSeries of simulation results\n", " title: string\n", " \"\"\"\n", " plot(census, ':', label='US Census')\n", " plot(un, '--', label='UN DESA')\n", " plot(timeseries, color='gray', label='model')\n", " \n", " decorate(xlabel='Year', \n", " ylabel='World population (billion)',\n", " title=title)" ] }, { "cell_type": "code", "execution_count": 3, "metadata": { "collapsed": true }, "outputs": [], "source": [ "def run_simulation(system, update_func):\n", " \"\"\"Simulate the system using any update function.\n", " \n", " system: System object\n", " update_func: function that computes the population next year\n", " \n", " returns: TimeSeries\n", " \"\"\"\n", " results = TimeSeries()\n", " results[system.t_0] = system.p_0\n", " \n", " for t in linrange(system.t_0, system.t_end):\n", " results[t+1] = update_func(results[t], t, system)\n", " \n", " return results" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Reading the data" ] }, { "cell_type": "code", "execution_count": 4, "metadata": { "collapsed": true }, "outputs": [], "source": [ "filename = 'data/World_population_estimates.html'\n", "tables = read_html(filename, header=0, index_col=0, decimal='M')\n", "table2 = tables[2]\n", "table2.columns = ['census', 'prb', 'un', 'maddison', \n", " 'hyde', 'tanton', 'biraben', 'mj', \n", " 'thomlinson', 'durand', 'clark']" ] }, { "cell_type": "code", "execution_count": 5, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "un = table2.un / 1e9\n", "census = table2.census / 1e9\n", "plot(census, ':', label='US Census')\n", "plot(un, '--', label='UN DESA')\n", " \n", "decorate(xlabel='Year', \n", " ylabel='World population (billion)',\n", " title='Estimated world population')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Running the quadratic model" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Here's the update function for the quadratic growth model with parameters `alpha` and `beta`." ] }, { "cell_type": "code", "execution_count": 6, "metadata": { "collapsed": true }, "outputs": [], "source": [ "def update_func_quad(pop, t, system):\n", " \"\"\"Update population based on a quadratic model.\n", " \n", " pop: current population in billions\n", " t: what year it is\n", " system: system object with model parameters\n", " \"\"\"\n", " net_growth = system.alpha * pop + system.beta * pop**2\n", " return pop + net_growth" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Extract the starting time and population." ] }, { "cell_type": "code", "execution_count": 7, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "2.557628654" ] }, "execution_count": 7, "metadata": {}, "output_type": "execute_result" } ], "source": [ "t_0 = get_first_label(census)\n", "t_end = get_last_label(census)\n", "p_0 = get_first_value(census)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Initialize the system object." ] }, { "cell_type": "code", "execution_count": 8, "metadata": { "scrolled": true }, "outputs": [ { "data": { "text/html": [ "
\n", "\n", "\n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", "
values
t_01950.000000
t_end2016.000000
p_02.557629
alpha0.025000
beta-0.001800
\n", "
" ], "text/plain": [ "t_0 1950.000000\n", "t_end 2016.000000\n", "p_0 2.557629\n", "alpha 0.025000\n", "beta -0.001800\n", "dtype: float64" ] }, "execution_count": 8, "metadata": {}, "output_type": "execute_result" } ], "source": [ "system = System(t_0=t_0, \n", " t_end=t_end,\n", " p_0=p_0,\n", " alpha=0.025,\n", " beta=-0.0018)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Run the model and plot results." ] }, { "cell_type": "code", "execution_count": 9, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "results = run_simulation(system, update_func_quad)\n", "plot_results(census, un, results, 'Quadratic model')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Generating projections" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "To generate projections, all we have to do is change `t_end`" ] }, { "cell_type": "code", "execution_count": 10, "metadata": { "scrolled": false }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Saving figure to file figs/chap04-fig01.pdf\n" ] }, { "data": { "image/png": "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k5v7ZteCggIuv/xyTjzxRN5//33uvfdeFi1axEsvvVRn+SeeeIJLL72Ud999lx49enD77bd75t18881MmDCB999/n9dee40zzzzT5xhffvllNmzYwLPPPssHH3zAbbfdRmxsrM+vPxq+1qC+Av4kIpOpO6LuGXb5L90L2gnmqBhjHgUePdr1dAUuVy2H1nzGul37qa51ERERTv9BwznplJnahFd1OCs27mXFpr0ATB7Vh8mj654B+CYjl7WZeQAcO64vadK7zvwvVuewccdBAGamD2D0kLrDyHyyLJutOQUAzJmSinNgot9i/9nPfsZnn33GueeeS//+/UlPT+ekk05izpzGfttbsrOz+fnPf97sel999VWmT5/OFVdcAUBqaioLFizgySef5PLLL/csd/HFFzNr1iwArr76ai666CLKy8uJiopiz549zJ49mwEDrEv5w4cP93m/9u7dy+jRoxk3bhyAZx3twdcE5U4Wv7Ifjc0D6wbeo05QynclmavYmLmN4kqrxV5kr34cO2MGUVFRAY5Mqa4lLCyMxx57jOzsbL777jtWrFjBDTfcwGmnncbf/va3I15vZmYmS5YsIS3tp4EjampqPK103dyn8wCSkpIAyM/Pp2/fvlxyySVcccUVHHvssRx77LGcdtppJCb6lpzPPvtsLrvsMjZv3sxxxx3HqaeeyqhRo1p+oR/4eqOutk8OQmX7d7H2u6/ZW1oDDgiL78n4ydN9/uAppXwTGxtLcXHDqwxFRUUNGiGlpqaSmprKRRddxH//+18WLlzIdddd12jNIzU1lZ07dza77dLSUs4880x++9vfNrucd0td99kTdxJbuHAhZ555JkuXLuW9997jscce46233mLAgAE4HA5cLleddXn3BjFu3DgWL17M0qVL+frrr7nwwgu58cYbufTSS5uNxx+07XEHVVNewpoP32XTvhLCw0LolpDAoNFpDByoYzupjmvy6Ian9bwdN74fx43v1+T8mekDmJne9CmoU6amcsrU1FbHlZqa2uDaUnFxMdnZ2QwaNKjJ1w0ZYg0GWlpa2ng8p5zCCy+8wHXXXddgVOuioiLi4uIYMWIEK1asIDW19XF7czqdOJ1OfvOb33D66afz+eefc9lll9GjRw8OHDjgWS4/P7/ONEBCQgLnnHMO55xzDs899xz/+c9/NEGppm378gO27DsE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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "system.t_end = 2250\n", "results = run_simulation(system, update_func_quad)\n", "plot_results(census, un, results, 'World population projection')\n", "savefig('figs/chap04-fig01.pdf')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The population in the model converges on the equilibrium population, `-alpha/beta`" ] }, { "cell_type": "code", "execution_count": 11, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "13.856665141368708" ] }, "execution_count": 11, "metadata": {}, "output_type": "execute_result" } ], "source": [ "results[system.t_end]" ] }, { "cell_type": "code", "execution_count": 12, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "13.88888888888889" ] }, "execution_count": 12, "metadata": {}, "output_type": "execute_result" } ], "source": [ "-system.alpha / system.beta" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "**Exercise:** What happens if we start with an initial population above the carrying capacity, like 20 billion? Run the model with initial populations between 1 and 20 billion, and plot the results on the same axes." ] }, { "cell_type": "code", "execution_count": 13, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "# Solution\n", "\n", "p0_array = linspace(1, 25, 11)\n", "\n", "for system.p_0 in p0_array:\n", " results = run_simulation(system, update_func_quad)\n", " plot(results)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Comparing projections" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can compare the projection from our model with projections produced by people who know what they are doing." ] }, { "cell_type": "code", "execution_count": 14, "metadata": {}, "outputs": [ { "data": { "text/html": [ "
\n", "\n", "\n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", "
United States Census Bureau (2015)[28]Population Reference Bureau (1973-2015)[15]United Nations Department of Economic and Social Affairs (2015)[16]
Year
20167.334772e+09NaN7.432663e+09
20177.412779e+09NaNNaN
20187.490428e+09NaNNaN
20197.567403e+09NaNNaN
20207.643402e+09NaN7.758157e+09
\n", "
" ], "text/plain": [ " United States Census Bureau (2015)[28] \\\n", "Year \n", "2016 7.334772e+09 \n", "2017 7.412779e+09 \n", "2018 7.490428e+09 \n", "2019 7.567403e+09 \n", "2020 7.643402e+09 \n", "\n", " Population Reference Bureau (1973-2015)[15] \\\n", "Year \n", "2016 NaN \n", "2017 NaN \n", "2018 NaN \n", "2019 NaN \n", "2020 NaN \n", "\n", " United Nations Department of Economic and Social Affairs (2015)[16] \n", "Year \n", "2016 7.432663e+09 \n", "2017 NaN \n", "2018 NaN \n", "2019 NaN \n", "2020 7.758157e+09 " ] }, "execution_count": 14, "metadata": {}, "output_type": "execute_result" } ], "source": [ "table3 = tables[3]\n", "table3.head()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "`NaN` is a special value that represents missing data, in this case because some agencies did not publish projections for some years." ] }, { "cell_type": "code", "execution_count": 15, "metadata": { "collapsed": true }, "outputs": [], "source": [ "table3.columns = ['census', 'prb', 'un']" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "This function plots projections from the UN DESA and U.S. Census. It uses `dropna` to remove the `NaN` values from each series before plotting it." ] }, { "cell_type": "code", "execution_count": 16, "metadata": { "collapsed": true }, "outputs": [], "source": [ "def plot_projections(table):\n", " \"\"\"Plot world population projections.\n", " \n", " table: DataFrame with columns 'un' and 'census'\n", " \"\"\"\n", " census_proj = table.census / 1e9\n", " un_proj = table.un / 1e9\n", " \n", " plot(census_proj.dropna(), 'b:', label='US Census')\n", " plot(un_proj.dropna(), 'g--', label='UN DESA')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Run the model until 2100, which is as far as the other projections go." ] }, { "cell_type": "code", "execution_count": 17, "metadata": {}, "outputs": [ { "data": { "text/html": [ "
\n", "\n", "\n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", "
values
t_01950.000000
t_end2100.000000
p_02.557629
alpha0.025000
beta-0.001800
\n", "
" ], "text/plain": [ "t_0 1950.000000\n", "t_end 2100.000000\n", "p_0 2.557629\n", "alpha 0.025000\n", "beta -0.001800\n", "dtype: float64" ] }, "execution_count": 17, "metadata": {}, "output_type": "execute_result" } ], "source": [ "system = System(t_0=t_0, \n", " t_end=2100,\n", " p_0=p_0,\n", " alpha=0.025,\n", " beta=-0.0018)" ] }, { "cell_type": "code", "execution_count": 18, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Saving figure to file figs/chap04-fig02.pdf\n" ] }, { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "results = run_simulation(system, update_func_quad)\n", "\n", "plot_results(census, un, results, 'World population projections')\n", "plot_projections(table3)\n", "savefig('figs/chap04-fig02.pdf')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "People who know what they are doing expect the growth rate to decline more sharply than our model projects." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Exercises\n", "\n", "**Optional exercise:** The net growth rate of world population has been declining for several decades. That observation suggests one more way to generate projections, by extrapolating observed changes in growth rate.\n", "\n", "The `modsim` library provides a function, `compute_rel_diff`, that computes relative differences of the elements in a sequence. It is a wrapper for the NumPy function `ediff1d`:" ] }, { "cell_type": "code", "execution_count": 19, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "\u001b[0;32mdef\u001b[0m \u001b[0mcompute_rel_diff\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mseq\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\n", "\u001b[0;34m\u001b[0m \u001b[0mxs\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mnp\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0masarray\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mseq\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\n", "\u001b[0;34m\u001b[0m \u001b[0mdiff\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mnp\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mediff1d\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mxs\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mnp\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mnan\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\n", "\u001b[0;34m\u001b[0m \u001b[0;32mreturn\u001b[0m \u001b[0mdiff\u001b[0m \u001b[0;34m/\u001b[0m \u001b[0mseq\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "%psource compute_rel_diff" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Here's how we can use it to compute the relative differences in the `census` and `un` estimates:" ] }, { "cell_type": "code", "execution_count": 20, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "alpha_census = compute_rel_diff(census)\n", "plot(alpha_census)\n", "\n", "alpha_un = compute_rel_diff(un)\n", "plot(alpha_un)\n", "\n", "decorate(xlabel='Year', label='Net growth rate')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Other than a bump around 1990, net growth rate has been declining roughly linearly since 1965. As an exercise, you can use this data to make a projection of world population until 2100.\n", "\n", "1. Define a function, `alpha_func`, that takes `t` as a parameter and returns an estimate of the net growth rate at time `t`, based on a linear function `alpha = intercept + slope * t`. Choose values of `slope` and `intercept` to fit the observed net growth rates since 1965.\n", "\n", "2. Call your function with a range of `ts` from 1960 to 2020 and plot the results.\n", "\n", "3. Create a `System` object that includes `alpha_func` as a system variable.\n", "\n", "4. Define an update function that uses `alpha_func` to compute the net growth rate at the given time `t`.\n", "\n", "5. Test your update function with `t_0 = 1960` and `p_0 = census[t_0]`.\n", "\n", "6. Run a simulation from 1960 to 2100 with your update function, and plot the results.\n", "\n", "7. Compare your projections with those from the US Census and UN." ] }, { "cell_type": "code", "execution_count": 21, "metadata": {}, "outputs": [], "source": [ "# Solution\n", "\n", "def alpha_func(t):\n", " intercept = 0.02\n", " slope = -0.00021\n", " return intercept + slope * (t - 1970)" ] }, { "cell_type": "code", "execution_count": 22, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "# Solution\n", "\n", "ts = linrange(1960, 2020)\n", "alpha_model = TimeSeries(alpha_func(ts), ts)\n", "plot(alpha_model, color='gray', label='model')\n", "plot(alpha_census)\n", "plot(alpha_un)\n", "\n", "decorate(xlabel='Year', label='Net growth rate')" ] }, { "cell_type": "code", "execution_count": 23, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "3.043001508" ] }, "execution_count": 23, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# Solution\n", "\n", "t_0 = 1960\n", "t_end = 2100\n", "p_0 = census[t_0]" ] }, { "cell_type": "code", "execution_count": 24, "metadata": {}, "outputs": [ { "data": { "text/html": [ "
\n", "\n", "\n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", "
values
t_01960
t_end2100
p_03.043
alpha_func<function alpha_func at 0x7fecd5c80d90>
\n", "
" ], "text/plain": [ "t_0 1960\n", "t_end 2100\n", "p_0 3.043\n", "alpha_func \n", "dtype: object" ] }, "execution_count": 24, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# Solution\n", "\n", "system = System(t_0=t_0, \n", " t_end=t_end,\n", " p_0=p_0,\n", " alpha_func=alpha_func)" ] }, { "cell_type": "code", "execution_count": 25, "metadata": {}, "outputs": [], "source": [ "# Solution\n", "\n", "def update_func_alpha(pop, t, system):\n", " \"\"\"Update population based on a quadratic model.\n", " \n", " pop: current population in billions\n", " t: what year it is\n", " system: system object with model parameters\n", " \"\"\"\n", " net_growth = system.alpha_func(t) * pop\n", " return pop + net_growth" ] }, { "cell_type": "code", "execution_count": 26, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "3.1102518413268" ] }, "execution_count": 26, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# Solution\n", "\n", "update_func_alpha(p_0, t_0, system)" ] }, { "cell_type": "code", "execution_count": 27, "metadata": {}, "outputs": [], "source": [ "# Solution\n", "\n", "results = run_simulation(system, update_func_alpha);" ] }, { "cell_type": "code", "execution_count": 28, "metadata": {}, "outputs": [ { "data": { "image/png": "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667z7f+b3/yGu+++m8zMTB588EHuueceXnvtNQC+//3vs27dOh599FHsdjt79uzx+3W9+OKLHDx4kOeff57o6GhKS0sJDJzY7eSKMpye8US9e516NA+7qvcPeYzJaCIhLI6ksHiSwuIxB5j7bDcajdNinrrhalC/BH4MvCGldA2y/VUAIUQWsBm4AXh4xCMcRTsKatlxqBaAFXOSWDG370KHW/dXs6+oAYAzFqSwWCT02f7h7koKSpsAWL80jblZsX22/3N7BUcqWwA4b2U6uTOjRyz2Cy64gPfee48vfelLzJgxg6VLl3LOOedw3nnnDXlMRUUFX/7yl4c978svv8yaNWu4/vrrAUhPT+fWW2/l6aef7pOgrrrqKjZs2ADATTfdxJVXXondbic4OJhjx46xceNG0tLSAJg1a5bfr6u2tpa5c+eyYMECAN85FGUysTvtVFvrqGo7RrW1lvNyziLOEuPbHhYYSmRwBG12veUixBxMUlgCSeF6QooNicZonA4paHjDJaj5UsoTjuKSUpYCNwsh1KCUMWQymXjqqaeoqKhg27Zt7Nixg9tvv50LL7yQX/7yl6d83qKiIj744AMWL17sK3O7B46Z6GnOA4iPjwegubmZlJQUrr76aq6//nrOOOMMzjjjDC688EKio/1LzpdeeinXXnsthYWFrF27lvPPP9/vGqKijBeP5qHe1khFWzVVbcdo6mzps726vbZPggJYkjIPTdNICosnPChMjesbxJAJyp/k1G9/7fTDUQBCQ0Ox2QaOZ7BarYSFhfUpS09PJz09nSuvvJK//e1vbN68mdtuu23Qmkd6ejplZWXDXruzs5NLLrmEb3/728PuZzId/9Xp+cPqSWKbN2/mkksu4aOPPuKtt97iqaee4vXXXyctLQ2DweBr8ujRezaIBQsWsGXLFj766CM+/fRTvvrVr3LHHXfwjW98Y9h4FGWsOd1OqtprqWit4mhrNXaXY8h9j1nrWZjU94PWrNjM0Q5x0vO7F58QIhvYACTSb5kOKeXPRziuMbFi7sBmvd7WLkxl7cLUIbevX5rG+qVDN0F9YVU6X1iVftJxpaenc+jQoT5lNpuNiooKMjIyhjwuKysL0JPMoPF84Qu88MIL3HbbbcTG9m2OtFqthIeHk5eXx44dO0hPP/m4e8vNzSU3N5cbbriBiy66iPfff59rr72W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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "# Solution\n", "\n", "plot_results(census, un, results, 'World population projections')\n", "plot_projections(table3)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "**Related viewing:** You might be interested in this [video by Hans Rosling about the demographic changes we expect in this century](https://www.youtube.com/watch?v=ezVk1ahRF78)." ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [] } ], "metadata": { "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.6.6" } }, "nbformat": 4, "nbformat_minor": 2 }