lessons/python/python1-master.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Scientific Programming I\n",
    "\n",
    "### Justin Kitzes  \n",
    "\n",
    "Thanks to Greg Wilson and Matt Davis for ideas."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 1. Individual things\n",
    "\n",
    "The most basic component of any programming language are \"things\", also called variables or\n",
    "in some languages such as Python, objects.\n",
    "\n",
    "The most common basic \"things\" in Python are integers, floats, strings, booleans, and\n",
    "some special objects of various types. We'll meet many of these as we go through the lesson."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "__TIP:__ To run the code in a cell quickly, press Ctrl+Enter. To run the code in a cell and then proceed to the next cell, press Ctrl+Shift. The Help menu above lists more shortcuts under the Keyboard Shortcuts menu item. You can also use the buttons under the menu to delete cells (use the Cut button), create new ones, move cells, etc."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "2"
      ]
     },
     "execution_count": 1,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# A thing\n",
    "2"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "2\n",
      "hello\n"
     ]
    }
   ],
   "source": [
    "# Use print to show multiple things in the same cell\n",
    "print(2)\n",
    "print('hello')  # Both single and double quotes are fine"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "2 hello True\n"
     ]
    }
   ],
   "source": [
    "# Things can be stored as variables\n",
    "a = 2\n",
    "b = 'hello'\n",
    "c = True  # This is case sensitive\n",
    "print(a, b, c)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<class 'int'>\n",
      "<class 'str'>\n",
      "<class 'str'>\n"
     ]
    }
   ],
   "source": [
    "# We can use type to determine what kind of thing we have\n",
    "print(type(a))\n",
    "print(type(b))\n",
    "print(type(b))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 2. Commands that operate on things\n",
    "\n",
    "While things are great, things by themselves aren't that much use to us. Right away, we'd like to start doing stuff, that is peforming operations, with various things. There are three common means of performing an operation on a thing."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 2.1 Use an operator\n",
    "\n",
    "All of the basic math operators work like you think they should for numbers. They can also\n",
    "do some useful operations on other things, like strings. There are also boolean operators that\n",
    "compare quantities and give back a `bool` variable as a result."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "5\n",
      "6\n",
      "8\n"
     ]
    }
   ],
   "source": [
    "# Standard math operators work as expected on numbers\n",
    "a = 2\n",
    "b = 3\n",
    "print(a + b)\n",
    "print(a * b)\n",
    "print(a ** b)  # You don't want ^"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "helloworld\n",
      "hellohellohello\n"
     ]
    }
   ],
   "source": [
    "# There are also operators for strings\n",
    "print('hello' + 'world')\n",
    "print('hello' * 3)\n",
    "#print('hello' / 3)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "False\n",
      "True\n",
      "True\n",
      "False\n"
     ]
    }
   ],
   "source": [
    "# Boolean operators compare two things\n",
    "a = (1 > 3)\n",
    "b = (3 == 3)\n",
    "print(a)\n",
    "print(b)\n",
    "print(a or b)\n",
    "print(a and b)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 2.2 Use a function\n",
    "\n",
    "These will be very familiar to anyone who has programmed in any language, and work like you\n",
    "would expect."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<class 'int'>\n",
      "<class 'str'>\n",
      "5\n",
      "3\n"
     ]
    }
   ],
   "source": [
    "# There are thousands of functions that operate on things\n",
    "print(type(3))  # We've already met print and type\n",
    "print(type('hello'))\n",
    "print(len('hello'))\n",
    "print(round(3.3))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "__TIP:__ To find out what a function does, you can type it's name and then a question mark to\n",
    "get a pop up help window. The window will describe the function and also tell you what input parameters it takes. Parameters in square brackets are optional."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "3.14"
      ]
     },
     "execution_count": 9,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "#round?\n",
    "round(3.14159, 2)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "__TIP:__ Many useful functions are not built in to core Python, but are found in external scientific packages. These need to be imported into your Python notebook (or program) before they can be used. In addition to functions, these external packages also often include new types of things, such as numeric arrays and data tables. We'll meet several of the most important scientific packages in the next lesson. When these packages are imported into Python, we usually refer to them as modules."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.5424361633616448"
      ]
     },
     "execution_count": 10,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "# Import the random module and use a function from it\n",
    "# After importing a module, use a '.' to look inside of it\n",
    "import random as rnd\n",
    "rnd.random()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 2.3 Use a method\n",
    "\n",
    "Before we get any farther into the Python language, we have to say a word about \"objects\". We\n",
    "will not be teaching object oriented programming in this workshop, but you will encounter objects throughout Python (in fact, even seemingly simple things like ints and strings are actually objects in Python).\n",
    "\n",
    "In the simplest terms, you can think of an object as a small bundled \"thing\" that contains within itself both data and functions that operate on that data. For example, strings in Python are objects that contain a set of characters and also various functions that operate on the set of characters. When bundled in an object, these functions are called \"methods\". The reason to bundle a function up as a method, instead of making it free floating, is that it makes it clear what kind of variable the function can operate on.\n",
    "\n",
    "Instead of the \"normal\" `function(arguments)` syntax, methods are called using the\n",
    "syntax `variable.method(arguments)`. Think of the '.' as short for \"look inside\"."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {
    "collapsed": false
   },
   "outputs": [],
   "source": [
    "# A string is an object\n",
    "a = 'hello, world'"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Hello, world\n",
      "heXXo, worXd\n"
     ]
    }
   ],
   "source": [
    "# Strings have many methods\n",
    "print(a.capitalize())\n",
    "print(a.replace('l', 'X'))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### EXERCISE 1 - Introducing logistic growth\n",
    "\n",
    "Throughout this lesson, we will successively build towards a program that will calculate the logistic growth of a population of bacteria in a petri dish (or bears in the woods, if you prefer). Logistic growth produces a classic S shaped curve in which a population initially grows very fast, then slows down over time until it reaches a steady state value known as the carrying capacity.\n",
    "\n",
    "For example, when there are only few bears in the woods and lost of food, they reproduce very fast. As the woods get full of bears and food gets harder to find, growth slows until the number of bears just balances with the amount of food (and hunters) in the woods, at which point the population stops growing.\n",
    "\n",
    "A commonly used discrete time equation for logistic population growth is\n",
    "\n",
    "$$ n_{t+1} = n_{t} + r n_{t} (1 - n_{t} / K) $$\n",
    "\n",
    "where $n_t$ is the population size at time $t$, $r$ is the maximum net per capita growth rate, and $K$ is the carrying capacity of the dish/woods.\n",
    "\n",
    "To get started, write Python expressions that do the following:\n",
    "\n",
    "1. Create variables for `r`, `K`, and `n0` (the population at time $t = 0$), setting these equal to 0.3, 100, and 10, respectively.\n",
    "1. Create the variable `n1` and calculate it's value. Do the same for `n2`.\n",
    "1. Check the type of `n2` - what is it?\n",
    "\n",
    "__Bonus__\n",
    "\n",
    "1. Figure out how to test whether `n2` is an integer (a mathematical integer, not necessarily\n",
    "whether it is an integer type) (HINT: look at the methods of `n2` by typing `n2.` and pressing\n",
    "tab.)\n",
    "1. Modify your calculations for `n1` and `n2` so that these values are rounded to the nearest\n",
    "integer. When you do so, you might notice that your answer to Bonus #1 above stops working --- why?"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "10 12.7 16.02613\n",
      "<class 'float'>\n",
      "n2 is an integer:  False\n"
     ]
    }
   ],
   "source": [
    "r = 0.3\n",
    "K = 100\n",
    "n0 = 10\n",
    "\n",
    "n1 = n0 + r*n0*(1 - n0/K) # round()\n",
    "n2 = n1 + r*n1*(1 - n1/K) # round()\n",
    "\n",
    "print(n0, n1, n2)\n",
    "print(type(n2))\n",
    "\n",
    "print('n2 is an integer: ', n2.is_integer())"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 3. Collections of things\n",
    "\n",
    "Once the number of variables that you are interested in starts getting large, working with them all individually starts to get unwieldy. To help stay organized, we can use collections of things.\n",
    "\n",
    "There are many types of collections in Python, including lists, tuples, dictionaries, and numpy arrays. Here we'll look just at the most flexible and simplest container, the list. Lists are declared using square brackets []. You can get individual elements out of a list using the syntax `a[idx]`."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "['hi', 'hello', 'yo']\n",
      "<class 'list'>\n"
     ]
    }
   ],
   "source": [
    "# Lists are created with square bracket syntax\n",
    "a = ['hi', 'hello', 'yo']\n",
    "print(a)\n",
    "print(type(a))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "hi\n",
      "hello\n"
     ]
    }
   ],
   "source": [
    "# Lists (and all collections) are also indexed with square brackets\n",
    "# NOTE: The first index is zero, not one\n",
    "print(a[0])\n",
    "print(a[1])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "['hi', 'hello']\n"
     ]
    }
   ],
   "source": [
    "# Lists can be sliced by putting a colon between indexes\n",
    "# NOTE: The end value is not inclusive\n",
    "print(a[0:2])\n",
    "\n",
    "# Think of this behavior as counting the \"walls\" between items"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "['hi', 'hello']\n",
      "['yo']\n",
      "['hi', 'hello', 'yo']\n",
      "['hi', 'hello']\n"
     ]
    }
   ],
   "source": [
    "# You can leave off the start or end if desired\n",
    "print(a[:2])\n",
    "print(a[2:])\n",
    "print(a[:])\n",
    "print(a[:-1])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "['hi', 'hello', 'yo', 'hiya']\n",
      "['hi', 'hello', 'yo', 'hiya', [1, 2]]\n",
      "['hi', 'hello', 'yo', 'hiya']\n"
     ]
    }
   ],
   "source": [
    "# Lists are objects, like everything else, and have methods such as append\n",
    "a.append('hiya')\n",
    "print(a)\n",
    "\n",
    "a.append([1,2])\n",
    "print(a)\n",
    "\n",
    "a.pop()\n",
    "print(a)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### EXERCISE 2 - Storing population size in a list\n",
    "\n",
    "Copy your code from Exercise 1 into the box below, and do the following:\n",
    "\n",
    "1. Modify your code so that the values of `n0`, `n1`, and `n2` are stored in a list and not as\n",
    "separate individual variables. HINT: You can start off by declaring an empty list using the syntax\n",
    "`n = []`, and then append each new calculated value of `nt` to the list.\n",
    "1. Get the first and last values in the list, calculate their ratio, and print out \"Grew by a factor of \"\n",
    "followed by the result.\n",
    "\n",
    "__Bonus__\n",
    "\n",
    "1. Extract the last value in two different ways: first, by using the index for\n",
    "the last item in the list, and second, presuming that you do not know how long the list is."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "[10, 13, 16]\n",
      "Grew by a factor of  1.6\n"
     ]
    }
   ],
   "source": [
    "######################################\n",
    "# This code deletes our old variables\n",
    "try: del n0, n1, n2, r, K\n",
    "except: pass\n",
    "######################################\n",
    "\n",
    "r = 0.3\n",
    "K = 100\n",
    "n = []\n",
    "n.append(10)  # Append n0 in the first location\n",
    "\n",
    "n.append(round(n[0] + r*n[0]*(1 - n[0]/K)))  # Append n1\n",
    "n.append(round(n[1] + r*n[1]*(1 - n[1]/K)))  # Append n2\n",
    "\n",
    "print(n)\n",
    "\n",
    "print(\"Grew by a factor of \", n[2]/n[0])  # or n[-1]/n[0]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 4. Repeating yourself\n",
    "\n",
    "So far, everything that we've done could, in principle, be done by hand calculation. In this section and the next, we really start to take advantage of the power of programming languages to do things for us automatically.\n",
    "\n",
    "We start here with ways to repeat yourself. The two most common ways of doing this are known as for loops and while loops. For loops in Python are useful when you want to cycle over all of the items in a collection, such as a list, and while loops are useful when you want to cycle for an indefinite amount of time until some condition is met."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "hi!\n",
      "hello!\n",
      "bye!\n"
     ]
    }
   ],
   "source": [
    "# A basic for loop - pay attention to the white space!\n",
    "wordlist = ['hi', 'hello', 'bye']\n",
    "for word in wordlist:\n",
    "    print(word + '!')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Sum is 85\n"
     ]
    }
   ],
   "source": [
    "# Sum all of the values in a collection using a for loop\n",
    "numlist = [1, 4, 77, 3]\n",
    "total = 0\n",
    "\n",
    "for num in numlist:\n",
    "    total = total + num\n",
    "    \n",
    "print(\"Sum is\", total)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "['hi', 'hello', 'bye']\n",
      "3\n",
      "0 hi\n",
      "1 hello\n",
      "2 bye\n"
     ]
    }
   ],
   "source": [
    "# Sometimes we want to loop over the indexes of a collection, not just the items\n",
    "print(wordlist)\n",
    "\n",
    "length = len(wordlist)\n",
    "print(length)\n",
    "\n",
    "for i in range(length):\n",
    "    print(i, wordlist[i])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "1 2\n",
      "2 4\n",
      "3 8\n",
      "4 16\n",
      "5 32\n",
      "6 64\n",
      "7 128\n",
      "Reached a product of 128 at step number 7\n"
     ]
    }
   ],
   "source": [
    "# While loops are useful when you don't know how many steps you will need,\n",
    "# and want to stop once a certain condition is met.\n",
    "stp = 0\n",
    "prd = 1\n",
    "while prd < 100:\n",
    "    stp = stp + 1\n",
    "    prd = prd * 2\n",
    "    print(stp, prd)\n",
    "    \n",
    "print('Reached a product of', prd, 'at step number', stp)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "__TIP:__ Once we start really generating useful and large collections of data, it becomes unwieldy to inspect our results manually. The code below shows how to make a very simple plot. We'll do more plotting later."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 24,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Populating the interactive namespace from numpy and matplotlib\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "[<matplotlib.lines.Line2D at 0x106a23358>]"
      ]
     },
     "execution_count": 24,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\nrGQHqN2dAtefL5upvJquk3lR7O4UuP582Uzl7Vq5ZG53p+ZZP2+eqbw6k/kC7O7URqyfN89U3r6V\nSebeu1NbsX7eHFN5PSbzLdjdqe1YP2+Oqbwbg0/m3rtTO2H9vB5TeX0m8w14707tlPXzekzl3Rls\nMre7U1VZP6/GVN4Mbxs3w3t3qi6/v2Xn/A6WZjiZT9ndqaZYP1+cqbw51syn7O5UU6yfL85aefcG\nlczt7lTTrJ9vz1TerJVP5nZ3ahlcf749U3k/DCKZ292pZbN+vjFTefNWNpnb3ak2WD/fmKm8P4pO\n5nZ3qk3Wzx/LVL4crSbziHhiRNwREXdHxGcjYq3Kceqwu1Nts37+WKbyfqmczCPixMx8ICJ2Af8d\nuCwz75jZvrRkbnenumT93FS+TK3XzDPzgenD44BjgYerHmsnvHenumb93FTeR3WS+ROAO4FnAu/I\nzH8/t73xZG53p/pilevnpvLlqprMK0+Hmfkw8JyIOAm4NSJOz8zPze6ztrb2yOPRaMRoNKr6dsCj\n3Z0f+YgTubo1Wz9fte9vMZU3azweMx6Pax+nkdUsEfFbwAOZuW/mtUaTud2d6qNVq5+bypev7dUs\nT4mI3dPHJwAvBu6pcqxF2N2pvlq1+rmpvL8qJfOIeDZwHXAMk38Q3p+Zb57bp5Fkbnen+m5V6uem\n8nYM8itwDx2C886DW26Bc89taGDSEqzC95/7feXtGNxkbnenSjPk+rmpvD2D+m6W9e7Oq692Ilc5\nhlw/t1bef71L5uvdnS972aRVXyrJEOvnpvJ2DaLM4r07NQRDq59bK29X8ZO53Z0akqHUz03l7Su+\nZu69OzUkQ6mfWysvRy+Sud2dGqLS6+em8m4Um8zt7tRQlf7956bysnSazO3u1CoosX5uKu9Occnc\ne3dqVZRYPzeVl6eTZG53p1ZNSfVzU3m3iknmdndqFZVUPzeVl6nVZG53p1Zd3+vnpvLu9b5pyO5O\nCR58EM4+G1772snE3jd2e3av15O53Z3So/paPzeV90Ova+Z2d0qP6mv93Fp52areaWgP8F+BpwIJ\nvDsz3z63T2am3Z3SJvpUPzeV90erZZaIOAU4JTPvjognAZ8GXpmZ98zsk3/4h8kVV8AnPgF79uz4\nbaRB61P93Fp5f3RaM4+IDwL7M/NPZ17Lpz417e6UttCH+rmpvF86q5lHxKnAGcAd89vs7pS21of6\nubXyYaj1ceS0xHITcFlm/sP89o9+dI2PfnTyeDQaMRqN6rydNEgXXggf/zi87nXt188PH4YDB2D/\n/vbeU481Ho8Zj8e1j1O5zBIRxwL/DTiQmW/dYHutGzpLq6Sr+rm18v5p+wPQAK4D/ndm/uom+ziZ\nSzvQdv3cWnk/tV0zPwd4DfAvIuKu6c9LKx5LEu3Xz62VD0sv7jQk6VFtrD83lfdXrztAJS2uje8/\nN5UPj8lc6qFl1s9N5f1mMpcGZJn1c1P5MJnMpR5run5uKu8/k7k0QE3Xz03lw2Uyl3quqfq5qbwM\nJnNpoJqqn5vKh81kLhWiTv3cVF4Ok7k0cHXq56by4TOZSwWpUj83lZfFZC6tgCr1c1P5ajCZSwVa\ntH5uKi+PyVxaIYvWz03lq8NkLhVqu/q5qbxMJnNpxWxXPzeVr5Y6t427Bjgf+EZmPnuD7SZzqQUb\n1c9N5eXqIplfC6zs3YWauAFrnw35/IZ2bvP18/F4POhUPrTr15TKk3lm3g78nwbHUpSh/w815PMb\n2rkdfzzceCO86U1w6BDcfPOYAwfavTF0m4Z2/Zqyq+sBSKpvtn5+3HHDTeXanB+ASgNx4YVw/vlw\n773DTeXaXK2liRFxKvDHm30AWn1YkrS6qnwAurQyS5XBSJKqqVxmiYj3AX8BnBYR90XEJc0NS5K0\nE0vrAJUktaf2B6AR8dKI+EJE/M+I2LvJPm+fbv/LiDij7nu2abvzi4hRRNwfEXdNf67sYpxVRMQ1\nEXE0Ij6zxT5FXrvtzq3k6wYQEXsi4mMR8bmI+GxE/LtN9iv1+m17fiVfw4h4YkTcERF3T89vbZP9\nFr9+mVn5BzgGOAKcChwL3A08a26f84Dbpo+fB3yyznu2+bPg+Y2AD3U91orn9wLgDOAzm2wv+dpt\nd27FXrfp+E8BnjN9/CTgrwf2d2+R8yv9Gp44/e8u4JPA8+pcv7rJ/EzgSGZ+OTO/C9wAvGJun5cD\n1wFk5h3A7oh4Ws33bcsi5wdQ5Ie9uX3jV7HXboFzg0KvG0Bm/m1m3j19/A/APcAPze1W8vVb5Pyg\n7Gv4wPThcUzC4sNzu+zo+tWdzH8YuG/m+Venr223z9Nrvm9bFjm/BM6e/hp0W0T8RGujW76Sr912\nBnPdpkuEzwDumNs0iOu3xfkVfQ0j4gkRcTdwFDiYmZ+a22VH16/u0sRFPz2d/9ezlE9dFxnnncCe\nzHwgIn4W+CBw2nKH1apSr912BnHdIuJJwE3AZdME+7hd5p4Xdf22Ob+ir2FmPgw8JyJOAm6NiNMz\n83Nzuy18/eom868Be2ae72Hyr8dW+zx9+loJtj2/zPz2+q9LmXkAODYiTm5viEtV8rXb0hCuW0Qc\nC9wMXJ+ZH9xgl6Kv33bnN4RrCJCZ9wMf4/FfXLij61d3Mj8E/JOIODUijgNeDXxobp8PARcDRMTz\ngW9m5tGa79uWbc8vIp4WMfni0Yg4k8lyz79vf6hLUfK121Lp12069j8APp+Zb91kt2Kv3yLnV/I1\njIinRMTu6eMTgBcz+Vxg1o6uX60yS2Z+LyLeCHyYycqPP8jMeyLi3063/15m3hYR50XEEeA7QDHN\nRYucH3Ah8EsR8T3gAeAXOhvwDk0bv14IPCUi7gOuZvJBTPHXbrtzo+DrNnUO8BrgryLirulrVwA/\nAuVfPxY4P8q+hj8IXBcRxzAJ1e+fXq/Kc6dNQ5I0AH5roiQNgJO5JA2Ak7kkDYCTuSQNgJO5JA2A\nk7kkDYCTuSQNgJO5JA3A/wfFXse/OqaV/QAAAABJRU5ErkJggg==\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x10439fc50>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Jupyter notebook command to load plotting functions\n",
    "%pylab inline\n",
    "\n",
    "# Make some data and plot it\n",
    "y = [2,7,1,10]\n",
    "plot(y)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### EXERCISE 3 - Using loops to repeat calculations\n",
    "\n",
    "Let's get smart about calculating our population size. Copy your code from Exercise 2 into the box below, and do the following:\n",
    "\n",
    "1. Write a for loop to calculate and store the values of `nt` for 100 time steps. HINT: Use the `range` function to pick the number of time steps. For each step, append the new population value to a list called `n`. What indexing strategy can you use to get the last value of the list each time around the for loop?\n",
    "1. Plot the population sizes in the list `n`.\n",
    "1. Play around with the values of `r` and `K` and see how it changes the plot. What happens if you set `r` to 1.9 or 3, or values in between?\n",
    "\n",
    "__Bonus__\n",
    "\n",
    "1. Modify your code to use a while loop that will stop your calculation after the population size exceeds 80. HINT: Start a step counter `i` at 1, and check that the population size is less than 80 each time around the loop. Increment the step counter within the loop so that you have a record of what step the calculation stopped at."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 25,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[<matplotlib.lines.Line2D at 0x106acbd68>]"
      ]
     },
     "execution_count": 25,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAXsAAAEACAYAAABS29YJAAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAGQ5JREFUeJzt3X+QVfV9//HnywWNiAKrdQGBoDSI2ohixB/fZrx1wBDH\nEBq/X41pM9Rf7aRWHSffTLCTb2a/M0kmptWkGetkYpN0p2P8iqYa/NbY3RBujYKKAZQfoVTKWhF3\nSUTQYL4R5f394xzcZV2W5dy799x7z+sxs7PnnnvPuW/OyIuPnx/nKCIwM7PmdlTeBZiZ2chz2JuZ\nFYDD3sysABz2ZmYF4LA3MysAh72ZWQEMGfaSvi+pV9L6fvtaJXVJ2iKpU9L4fu/dLuk/JG2WdNlI\nFm5mZsN3uJb9D4AFA/YtAboiYiawPH2NpDOBq4Ez02PukeT/czAzqwNDhnFE/Bx4fcDuhUBHut0B\nLEq3PwncHxH7IqIbeBGYW71Szcwsqywt77aI6E23e4G2dHsysL3f57YDp1RQm5mZVUlF3SyR3Gth\nqPst+F4MZmZ1YFSGY3olTYyIHkmTgJ3p/leAqf0+NyXddxBJ/gfAzCyDiFDWY7OE/TJgMXBH+vuR\nfvt/KOkuku6bDwHPDnYC33wt0d7eTnt7OwA/+Qls3ZpvPXl67LF2Lr+8Pe8y6oKvRR9fiz4335w5\n54HDhL2k+4FLgJMkvQx8Gfg6sFTS9UA3cBVARGyStBTYBLwD/GU41Q9r71645RZ48kmYPz/vavLz\n61/D5s15V1EffC36+FpUz5BhHxHXHOKteYf4/NeAr1VaVFHs3Alz58JHPgK/+AWMHZt3Rflpb09+\nzNeiP1+LPn//95Udn6UbxyoUAd/7Htx3X4lvfxsWL867ovyVSqW8S6gbvhZ9fC2qR7XuaZFU6N6d\nN96Av/gL2LgRHngAzjgj74rMrBFIqmiA1itca2jNGjjvPBg3Dp55xkFvZrXjsK+BCPj2t+FjH4Ov\nfAW+8x049ti8qzKzInGf/QjbtQuuuw62b4enn4YZM/KuyMyKyC37EbRyJcyZA9Onw1NPOejNLD9u\n2Y+A/fvhb/4G7roL7r0XFi7MuyIzKzqHfZXt3QtXXglvvgmrV8O0aXlXZGbmsK+6L34xmW3z6KMw\nenTe1ZiZJRz2VbR8Ofz4x/DCCw56M6svHqCtkjfegOuvT/roJ0zIuxozs4N5BW2V/PmfJ/Pp7703\n70rMrBlVuoLW3ThV0NUFnZ1J942ZWT1yN04VfPnL8Ld/CyeckHclZmaDc9hXaOXK5FbFf/zHeVdi\nZnZoDvsK3Xkn3HYbtLTkXYmZ2aFlDntJt0paL2mDpFvTfa2SuiRtkdQpaXz1Sq0/W7fCE0/Atdfm\nXYmZ2dAyhb2kPwBuAM4HZgNXSJoBLAG6ImImsDx93bS++U248UY47ri8KzEzG1qmqZeS/juwICJu\nSF9/CXgbuA64JCJ6JU0EyhExa8CxTTH1cteu5MZmGzfC5Ml5V2NmzS6vh5dsAD6adtuMAS4HpgBt\nEdGbfqYXaMtaWL37zndg0SIHvZk1hkzz7CNis6Q7gE5gL7AOeHfAZ0LSoE349n5PEC6VSg33nMnf\n/Q7uvhv+9V/zrsTMmlW5XKZcLlftfFVZQSvpq8B24FagFBE9kiYBK5qxG+cf/xHuv99hb2a1k9sz\naCWdnP6eBnwK+CGwDFicfmQx8EjW89eriGS65ec/n3clZmbDV8ntEh6SdCKwD/jLiNgj6evAUknX\nA93AVVWosa50doIE8+fnXYmZ2fD5RmhH6LLL4DOfgT/7s7wrMbMiqbQbx2F/BF54AT7+cfjP/4Rj\njsm7GjMrktz67Ivorrvgr/7KQW9mjcct+2Hq6YEzz4QXX4TW1ryrMbOiccu+Rh54AD7xCQe9mTUm\nh/0wLV0KV1+ddxVmZtm4G2cYXn4ZzjkHXn0Vjj4672rMrIjcjVMDDz6Y3AfHQW9mjcphPwxLl8JV\nTbc8zMyKxN04h9HdDeefDzt2wOjReVdjZkXlbpwR9uCDyfNlHfRm1sgc9ofhLhwzawYO+yFs3Qov\nvQQNdrt9M7P3cdgP4aGH4FOfglGV3BvUzKwOOOyH8PjjyapZM7NG59k4h7B3L0ycmCykGjs272rM\nrOg8G2eEPPEEzJnjoDez5lDJYwlvk7RB0npJP5R0jKRWSV2StkjqlDS+msXWUmenn0ZlZs0jU9hL\nOgW4GTgvIj4MtACfBpYAXRExE1ievm5IXV0OezNrHpV044wCxkgaBYwBdgALgY70/Q5gUWXl5WPH\njuTnIx/JuxIzs+rIFPYR8QpwJ/BfJCG/OyK6gLaI6E0/1gu0VaXKGvvpT+HSS6GlJe9KzMyqI9MM\nckkTSFrx04E9wIOS/rT/ZyIiJA067aa9vf297VKpRKnOVi25C8fM8lYulymXy1U7X6apl5L+B/Cx\niLghff1Z4ELgUuCPIqJH0iRgRUTMGnBsXU+9jIDJk+Gpp+C00/KuxswskdfUy5eACyUdK0nAPGAT\n8CiwOP3MYuCRrIXlZcMGGDPGQW9mzSVTN05EPCvpIWAN8E76+7vA8cBSSdcD3UDD3ULMUy7NrBl5\nBe0ACxbAjTfClVfmXYmZWZ9Ku3Ec9v288w60tsK2bXDiiXlXY2bWx7dLqKL162HKFAe9mTUfh30/\nq1bBRRflXYWZWfU57PtZuRIuvjjvKszMqs9h34/D3syalcM+1dMDu3fD6afnXYmZWfU57FOrVsGF\nF8JRviJm1oQcbalVq9yFY2bNy2GfWrnSM3HMrHl5URXw9tswYULSb3/88XlXY2b2fl5UVQVr18LM\nmQ56M2teDnvchWNmzc9hjwdnzaz5FT7sI5IHlTjszayZFT7sX345udvlqafmXYmZ2cgpfNivXg1z\n54Iyj3GbmdW/TGEv6XRJa/v97JF0i6RWSV2StkjqlDS+2gVX29q1MGdO3lWYmY2sTGEfEf8eEedG\nxLnAecBbwMPAEqArImYCy9PXdc1hb2ZFUI1unHnAixHxMrAQ6Ej3dwCLqnD+EbVmDZx7bt5VmJmN\nrGqE/aeB+9PttojoTbd7gbYqnH/EvPpqsnp26tS8KzEzG1mjKjlY0tHAJ4AvDnwvIkLSoPdFaG9v\nf2+7VCpRKpUqKSOztWuTVr0HZ82s3pTLZcrlctXOV9G9cSR9EvhcRCxIX28GShHRI2kSsCIiZg04\npm7ujfPVr8KePfCNb+RdiZnZ0PK+N8419HXhACwDFqfbi4FHKjz/iDrQsjcza3aZW/aSjgNeAk6N\niDfTfa3AUmAa0A1cFRG7BxxXNy37006Dxx6DWbMO/1kzszxV2rIv7C2OX38dpk1LHkXY0pJ3NWZm\nQ8u7G6dhrVsHZ5/toDezYihs2Lu/3syKpNBh75WzZlYUhQ17r5w1syIp5ADtW2/BiScmc+yPPjrX\nUszMhsUDtBm88AKccYaD3syKo5Bh78FZMysah72ZWQEUMuzXrPFMHDMrlsIN0O7bB+PGwc6dMHZs\nbmWYmR0RD9AeoU2bktskOOjNrEgKF/ZeTGVmRVTIsPfgrJkVTeHC3oOzZlZEhRqg3b8fxo+H7m5o\nbc2lBDOzTHIboJU0XtJDkn4paZOkCyS1SuqStEVSp6TxWc8/ErZuhQkTHPRmVjyVdOP8HfBYRJwB\nnA1sBpYAXRExE1ievq4b7sIxs6LKFPaSxgEfjYjvA0TEOxGxB1gIdKQf6wAWVaXKKvHgrJkVVdaW\n/anAryT9QNIaSfemz6Rti4je9DO9QFtVqqwS39bYzIoqa9iPAuYA90TEHGAvA7ps0lHY/B82m4rw\nHHszK65RGY/bDmyPiNXp64eA24EeSRMjokfSJGDnYAe3t7e/t10qlSiVShnLGL5XXgEJJk8e8a8y\nM6tYuVymXC5X7XyZp15KegK4ISK2SGoHxqRvvRYRd0haAoyPiCUDjstl6uWyZXDPPfD44zX/ajOz\nilU69TJryx7gZuA+SUcDW4FrgRZgqaTrgW7gqgrOX1UenDWzIssc9hHxPHD+IG/Ny17OyFm7Fj7z\nmbyrMDPLR2Ful+CZOGZWZIUI+9deSx4uPmNG3pWYmeWjEGG/di3Mng1HFeJPa2b2foWIP98mwcyK\nrhBh75k4ZlZ0hQh7D86aWdE1/f3sf/MbOPnkZIB29Oiafa2ZWVX5geOH8fzzcNZZDnozK7amD3sP\nzpqZFSDsPThrZuawNzMrhKYeoP3d75IHjO/aBcceW5OvNDMbER6gHcLGjcktEhz0ZlZ0TR32nl9v\nZpZo6rD3YwjNzBJNH/Zu2ZuZVfZYwm7gDeBdYF9EzJXUCjwAfJD0SVURsXvAcTUZoH33XRg3DrZv\nTwZpzcwaWZ4DtAGUIuLciJib7lsCdEXETGB5+joXW7ZAW5uD3swMKu/GGfivzEKgI93uABZVeP7M\n3IVjZtan0pb9TyU9J+nGdF9bRPSm271AW0XVVcC3STAz61NJ2P+3iDgX+Dhwk6SP9n8z7Ziv7Yqt\nftyyNzPrMyrrgRHxavr7V5IeBuYCvZImRkSPpEnAzsGObW9vf2+7VCpRKpWylnGI2hz2ZtbYyuUy\n5XK5aufLNBtH0higJSLelHQc0An8b2Ae8FpE3CFpCTA+IpYMOHbEZ+N0d8PFF8OOHSP6NWZmNVPp\nbJysLfs24GFJB85xX0R0SnoOWCrpetKpl1kLq4Rb9WZmB8sU9hGxDThnkP27SFr3uXLYm5kdrClX\n0HomjpnZwZoy7N2yNzM7WNOFfW8vvPUWTJ+edyVmZvWj6cL+QKtemceszcyaT9OGvZmZ9Wm6sPfg\nrJnZ+zVd2Ltlb2b2fk31wPE9e2DyZHjjDWhpGZGvMDPLhR843s+6dXD22Q56M7OBmirs3YVjZjY4\nh72ZWQE0Vdh7Jo6Z2eCaZoD2t7+F1lbYvRuOOabqpzczy5UHaFPr18PppzvozcwG0zRh7/56M7ND\na6qwd3+9mdngKgp7SS2S1kp6NH3dKqlL0hZJnZLGV6fMw1uzxi17M7NDqbRlfyuwCTgw4roE6IqI\nmcDy9PWI27cPNmyA2bNr8W1mZo0nc9hLmgJcDvwDcGCEeCHQkW53AIsqqm6YNm+GqVPh+ONr8W1m\nZo2nkpb9N4EvAPv77WuLiN50u5fkweQjzoOzZmZDy/TAcUlXADsjYq2k0mCfiYiQNOiE+vb29ve2\nS6USpdKgpxg2D86aWbMpl8uUy+WqnS/ToipJXwM+C7wDfAA4Afhn4HygFBE9kiYBKyJi1oBjq76o\n6pJL4Etfgvnzq3paM7O6UemiqopX0Eq6BPifEfEJSd8AXouIOyQtAcZHxJIBn69q2O/fDxMmwNat\ncNJJVTutmVldqZcVtAfS++vAfElbgEvT1yNq2zYYN85Bb2Y2lEx99v1FxL8B/5Zu7wLmVXrOI+H5\n9WZmh9fwK2g9OGtmdngNH/Zu2ZuZHV5Dh32E59ibmQ1HQ4d9dzccdRRMmZJ3JWZm9a2hw37VKrj4\nYlDmyUhmZsXQ0GG/cmUS9mZmNrSGDvtVq+Cii/Kuwsys/jXsM2j37oWTT4bXXoMPfKAKhZmZ1bF6\nWUFbc6tXw9lnO+jNzIajYcPe/fVmZsPXsGHv/nozs+FryD77iOTGZ+vXw+TJVSrMzKyOFbLPfsuW\n5BGEDnozs+FpyLB3F46Z2ZFpyLD34KyZ2ZFpyLB3y97M7MhkCntJH5D0jKR1kjZIak/3t0rqkrRF\nUqek8VWtFtizJ3k61ezZ1T6zmVnzyhT2EfH/gD+KiHOAc4AFki4AlgBdETETWJ6+rqpnnoHzzoPR\no6t9ZjOz5pW5Gyci3ko3jwZGkzyHdiHQke7vABZVVN0g3F9vZnbkMoe9pKMkrQN6gc6IeBZoi4je\n9CO9QFsVajyIw97M7MhlfuB4ROwHzpE0DnhY0h8MeD8kDbp6qr29/b3tUqlEqVQa1ne++27SjXPf\nfVmrNjNrDOVymXK5XLXzVWUFraT/BbwF3AiUIqJH0iRgRUTMGvDZzCto16+HK69MFlWZmRVJLito\nJZ10YKaNpGOB+cAvgWXA4vRji4FHshY2GHfhmJllk7UbZxLQIamF5B+MByLiMUlPA0slXQ90A1dV\np8yE59ebmWXTUDdCmzkTfvQj+PCHq1yUmVmdq7Qbp2HC/te/hhkzYNcuaGkZgcLMzOpYYe56uWoV\nXHCBg97MLIuGCXsPzpqZZdcwYe/BWTOz7Bqiz37fPpgwAbZvh/FVv7WamVn9K0Sf/fPPw/TpDnoz\ns6waIuxXrXJ/vZlZJRoi7J96ymFvZlaJuu+z378fJk6E556DadNGsDAzszrW9H32zz+fDM466M3M\nsqv7sO/shPnz867CzKyx1X3Yd3U57M3MKlXXffa//S2cfDK88gqccMIIF2ZmVseaus/+5z+H2bMd\n9GZmlarrsHcXjplZdTjszcwKIOtjCadKWiFpo6QNkm5J97dK6pK0RVLngUcXZtHbC93dMHdu1jOY\nmdkBWVv2+4DbIuIs4ELgJklnAEuAroiYCSxPX2eyfDmUSjAq64MTzczsPZnCPiJ6ImJduv0bkoeN\nnwIsBDrSj3UAi7IW5i4cM7PqqbjPXtJ04FzgGaAtInrTt3qBtiznjEjC/rLLKq3OzMwAKuokkTQW\n+BFwa0S8KfVNAY2IkDTohPr29vb3tkulEqVS6aD3f/ELGDMGfv/3K6nOzKxxlctlyuVy1c6XeVGV\npNHA/wV+EhHfSvdtBkoR0SNpErAiImYNOO6wi6q+8AU45hj4ylcylWZm1nRyWVSlpAn/PWDTgaBP\nLQMWp9uLgUeO9NwRsHQpXH11lsrMzGwwmVr2kv4QeAJ4AThwgtuBZ4GlwDSgG7gqInYPOHbIlv3T\nT8O118KmTaDM/4aZmTWXSlv2mfrsI+JJDv1/BfOyFgN9rXoHvZlZ9dTVjdD274cPfhAefxzOOqum\nZZmZ1bWmuhHaqlUwbpyD3sys2uoq7D0wa2Y2MuqmG+fdd2HqVPjZz2DWrEEONDMrsKbpxnnySfi9\n33PQm5mNhLoJ+7vvhuuuy7sKM7PmVBfdONu2wfnnJ7+PP76m5ZiZNYSm6Mb51rfghhsc9GZmIyX3\nlv3rr8OMGbB+PZxySk1LMTNrGA3fsv/ud+GKKxz0ZmYjKdeW/dtvw2mnwb/8C8yeXdMyzMwaSkO3\n7B94IJlq6aA3MxtZuYV9BNx5J3z+83lVYGZWHLmF/fLlsG8fLFiQVwVmZsWRW9gfaNX7VsZmZiMv\nc9hL+r6kXknr++1rldQlaYukTknjBzt2wwZYtw7+5E+yfruZmR2JSlr2PwAGdsIsAboiYiawPH39\nPnfdBTfdlDxntsiq+TDhRudr0cfXoo+vRfVkDvuI+Dnw+oDdC4GOdLsDWDTYsQ8/DJ/7XNZvbh7+\nD7mPr0UfX4s+vhbVU+0++7aI6E23e4G2wT50zTVw4olV/mYzMzukERugTVdODbpi67bbRupbzcxs\nMBWtoJU0HXg0Ij6cvt4MlCKiR9IkYEVEzBpwTG2X7JqZNYlKVtCOqmYhwDJgMXBH+vuRgR+opFgz\nM8smc8te0v3AJcBJJP3zXwZ+DCwFpgHdwFURsbsqlZqZWWY1vxGamZnVXk1X0EpaIGmzpP+Q9MVa\nfnfeJE2VtELSRkkbJN2S7h/WQrRmJKlF0lpJj6avC3ktJI2X9JCkX0raJOmCAl+L29K/H+sl/VDS\nMUW5Fke6UFXS7WmWbpZ02eHOX7Owl9QC3E2yEOtM4BpJZ9Tq++vAPuC2iDgLuBC4Kf3zD2shWpO6\nFdhE36ytol6LvwMei4gzgLOBzRTwWkg6BbgZOC+d9NECfJriXIthL1SVdCZwNUmWLgDukTRkntey\nZT8XeDEiuiNiH/B/gE/W8PtzFRE9EbEu3f4N8EvgFIa5EK3ZSJoCXA78A3Bg0L5w10LSOOCjEfF9\ngIh4JyL2UMBrkRoFjJE0ChgD7KAg1+IIF6p+Erg/IvZFRDfwIknGHlItw/4U4OV+r7en+wonnbJ6\nLvAMw1yI1oS+CXwB2N9vXxGvxanAryT9QNIaSfdKOo4CXouIeAW4E/gvkpDfHRFdFPBa9HOoP/tk\nkgw94LB5Wsuw90gwIGks8CPg1oh4s/97Qy1EayaSrgB2RsRa+lr1BynKtSBpyc4B7omIOcBeBnRT\nFOVaSJpA0pKdThJmYyX9af/PFOVaDGYYf/Yhr0stw/4VYGq/11M5+F+mpidpNEnQ/1NEHFiD0Ctp\nYvr+JGBnXvXV0MXAQknbgPuBSyX9E8W8FtuB7RGxOn39EEn49xTwWswDtkXEaxHxDvDPwEUU81oc\ncKi/EwPzdEq675BqGfbPAR+SNF3S0SSDC8tq+P25kiTge8CmiPhWv7cOLESDQyxEazYR8dcRMTUi\nTiUZgPtZRHyWYl6LHuBlSTPTXfOAjcCjFOxaAC8BF0o6Nv37Mo9kAL+I1+KAQ/2dWAZ8WtLRkk4F\nPgQ8O+SZIqJmP8DHgX8nGUy4vZbfnfcP8Ick/dPrgLXpzwKgFfgpsAXoBMbnXWuNr8slwLJ0u5DX\nApgNrAaeJ2nNjivwtWgnmbywnmRAcnRRrgXJ/+XuAN4mGd+8dqg/O/DXaZZuBj52uPN7UZWZWQHk\n9lhCMzOrHYe9mVkBOOzNzArAYW9mVgAOezOzAnDYm5kVgMPezKwAHPZmZgXw/wHlfZ+uJUH4bAAA\nAABJRU5ErkJggg==\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x1069e0860>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "r = 0.3\n",
    "K = 100\n",
    "n0 = 10\n",
    "\n",
    "n = []\n",
    "n.append(n0)\n",
    "\n",
    "for i in range(100):\n",
    "    n.append(round(n[-1] + r*n[-1]*(1 - n[-1]/K)))\n",
    "    \n",
    "plot(n)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 26,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "1 13\n",
      "2 16\n",
      "3 20\n",
      "4 25\n",
      "5 31\n",
      "6 37\n",
      "7 44\n",
      "8 51\n",
      "9 58\n",
      "10 65\n",
      "11 72\n",
      "12 78\n",
      "13 83\n",
      "Ended with a population size of 83 at step 13\n",
      "Population sizes to this step were [10, 13, 16, 20, 25, 31, 37, 44, 51, 58, 65, 72, 78, 83]\n"
     ]
    }
   ],
   "source": [
    "r = 0.3\n",
    "K = 100\n",
    "n = []\n",
    "n.append(10)\n",
    "\n",
    "i = 1\n",
    "while n[-1] < 80:\n",
    "    n.append(round(n[i-1] + r*n[i-1]*(1 - n[i-1]/K)))\n",
    "    print(i, n[i])\n",
    "    i = i + 1\n",
    "    \n",
    "print('Ended with a population size of', n[i-1], 'at step', i-1)\n",
    "print('Population sizes to this step were', n[0:i])"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 5. Making choices\n",
    "\n",
    "Often we want to check if a condition is True and take one action if it is, and another action if the condition is False. We can achieve this in Python with an if statement.\n",
    "\n",
    "__TIP:__ You can use any expression that returns a boolean value (True or False) in an if statement. Common boolean operators are ==, !=, <, <=, >, >=."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 27,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "x is positive\n"
     ]
    }
   ],
   "source": [
    "# A simple if statement\n",
    "x = 3\n",
    "if x > 0:\n",
    "    print('x is positive')\n",
    "elif x < 0:\n",
    "    print('x is negative')\n",
    "else:\n",
    "    print('x is zero')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "# If statements can also use boolean variables\n",
    "x = -1\n",
    "test = (x > 0)\n",
    "if test:\n",
    "    print('Test was true')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### EXERCISE 4 - Adding some randomness to the model\n",
    "\n",
    "Let's introduce some element of randomness into our population growth model. We'll model a simple \"catastrophe\" process, in which a catastrophe happens in 10% of the time steps that reduces the population back down to the initial size. Copy your code from Exercise 4 into the box below, and do the following:\n",
    "\n",
    "1. Inside your for loop, add a variable called `cata`, for catastrophe, that will be True if a catastrophe has occurred, and False if it hasn't. A simple way to do this is to generate a pseudorandom number between 0 and 1 using `rnd.random()`. Check whether this number is less than 0.1 - this check will be True 10% of the time.\n",
    "1. Using your boolean variable `cata`, add an if statement to your for loop that checks whether `cata` is true in each time step. If it is true, set the population back to the initial size. Otherwise, perform the usual logistic growth calculation.\n",
    "1. Plot your results. Run the cell again to see a different random population growth path.\n",
    "\n",
    "__Bonus__\n",
    "\n",
    "1. Count the number of time steps in your list `n` in which the population was above 50."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 29,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[<matplotlib.lines.Line2D at 0x106d08828>]"
      ]
     },
     "execution_count": 29,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x106a646a0>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "r = 0.3\n",
    "K = 100\n",
    "n0 = 10\n",
    "\n",
    "n = []\n",
    "n.append(n0)\n",
    "\n",
    "for i in range(100):\n",
    "    cata = (rnd.random() < 0.1)  # Random catastrophe 10% of time\n",
    "    if cata:\n",
    "        n.append(n0)\n",
    "    else:\n",
    "        n.append(round(n[-1] + r*n[-1]*(1 - n[-1]/K)))\n",
    "    \n",
    "plot(n)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 30,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Population was above 50 in 41 out of 100 steps\n"
     ]
    }
   ],
   "source": [
    "above = 0\n",
    "for pop in n:\n",
    "    if pop > 50:\n",
    "        above += 1\n",
    "    \n",
    "print('Population was above 50 in', above, 'out of 100 steps')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 6. Creating chunks with functions and modules\n",
    "\n",
    "One way to write a program is to simply string together commands, like the ones above, in one long file, and then to run that file to generate your results. This may work, but it can be cognitively difficult to follow the logic of programs written in this style. Also, it does not allow you to reuse your code easily - for example, what if we wanted to run our logistic growth model for several different choices of initial parameters?\n",
    "\n",
    "The most important ways to \"chunk\" code into more manageable pieces is to create functions and then to gather these functions into your own modules, and eventually packages. Below we will discuss how to create functions and modules. A third common type of \"chunk\" in Python is classes, but we will not be covering object-oriented programming in this workshop."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 31,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "# It's very easy to write your own functions\n",
    "def multiply(x, y):\n",
    "    return x*y"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 32,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<class 'function'>\n",
      "12\n"
     ]
    }
   ],
   "source": [
    "# Once a function is \"run\" and saved in memory, it's available just like any other function\n",
    "print(type(multiply))\n",
    "print(multiply(4, 3))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 33,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "# It's useful to include docstrings to describe what your function does\n",
    "def say_hello(time, people):\n",
    "    return 'Good ' + time + ', ' + people"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 34,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'Good afternoon, friends'"
      ]
     },
     "execution_count": 34,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "say_hello('afternoon', 'friends')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 35,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "# All arguments must be present, or the function will return an error\n",
    "#say_hello('afternoon')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 36,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "# Keyword arguments can be used to make some arguments optional by giving them a default value\n",
    "# All mandatory arguments must come first, in order\n",
    "def say_hello(time, people='friends'):\n",
    "    return 'Good ' + time + ', ' + people"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 37,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'Good afternoon, friends'"
      ]
     },
     "execution_count": 37,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "say_hello('afternoon')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 38,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'Good afternoon, students'"
      ]
     },
     "execution_count": 38,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "say_hello('afternoon', 'students')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### EXERCISE 6 - Creating a logistic growth function\n",
    "\n",
    "Finally, let's turn our logistic growth model into a function that we can use over and over again. Copy your code from Exercise 5 into the box below, and do the following:\n",
    "\n",
    "1. Turn your code into a function called `logistic_growth` that takes four arguments: `r`, `K`, `n0`, and `p` (the probability of a catastrophe). Make `p` a keyword argument with a default value of 0.1. Have your function return the `n` list of population sizes.\n",
    "1. In a subsequent cell, call your function with different values of the parameters to make sure it works. Store the returned value of `n` and make a plot from it.\n",
    "\n",
    "__Bonus__\n",
    "\n",
    "1. Refactor your function by pulling out the line that actually performs the calculation of the new population given the old population. Make this line another function called `grow_one_step` that takes in the old population, `r`, and `K`, and returns the new population. Have your `logistic_growth` function use the `grow_one_step` function to calculate the new population in each time step."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 39,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "def logistic_growth(r, K, n0, p=0.1):\n",
    "\n",
    "    n = []\n",
    "    n.append(n0)\n",
    "\n",
    "    for i in range(100):\n",
    "        cata = (rnd.random() < p)  # Random catastrophe 10% of time\n",
    "        if cata:\n",
    "            n.append(n0)\n",
    "        else:\n",
    "            n.append(round(n[-1] + r*n[-1]*(1 - n[-1]/K)))\n",
    "            #n.append(grow_one_step(n[-1], r, K))\n",
    "    \n",
    "    return n\n",
    "\n",
    "def grow_one_step(nold, r, K):\n",
    "    return round(nold + r*nold*(1 - nold/K))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 40,
   "metadata": {
    "collapsed": false
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "[<matplotlib.lines.Line2D at 0x106dde160>]"
      ]
     },
     "execution_count": 40,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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\nZCWl70R2RkNm6oZd58RTqtnrOQNMtCwVUSrGuSoUXkEivGSODWHC5+ehtRXmNxVF4sCO8Ox3nIwz\nn5ynKQO7917s+F1lnr2eI+R8l3FyOZie5mxzWutvNKres68SsrczJRrVNOvVrVXz1LdCqPPk4nGm\npLvds6BYs08mYWBAG9RSswJuqILyufJ1PYYw4cYNVUoicaBG9mHgxNMvkGiNEok6m66U7FVr9kHl\njDDIfnYWOjqY2pxlqHWoOCOYD/sK+fZ1VJmMY+fZL+cSDLYOWksOKgxJp2Fxkdh6n+thUUr2TmGX\nAYmw6sk+YGhpEWpkrx6JYy8x3eIudE+ljKNUs1ck4xSKQagqnJCPgVcRfRSmjGPX1a3slqsiGXbh\n/jrZ2+q5KsZ8ehr6+4lPRz159soqVdkMQuGcD4DSIfJVwMRknLeyW96NMfRVf5lYDd7HAmrFS9Rj\n+dQrzLa2u/quygXaC0LG0SND9CeZgJ79dsg473jgHfz47I8d23H07KWDZ6tizD1G4kAFPfsqlXEO\nTx9m7P4x78aEuaHKxM5qxI4j+62pMyy3u4v9VUH2Uspzm0uqTcYhPLIP2t/tisY5tXCK5c1lx3ac\nNPvlnAPZKSb7qpNxFOjZYZD96YXTrua3DFaafU3GqV7UzU6x7lBoXIcKsi8qzaZiUU5PGVCtnn0+\nCVphgVaVZ7++Dhsb0O2Uq9QeTlMQT8XJ5DKO7TiFXq7gEJaniuzzu2e3xbO3kXFUhF4qIfuSCXc7\nv0Uo2bEej8PAYI5kKslgm6Is7DWyV4+WpRnkwKir76og+6IQNBUTurgYOGUAhET2ht2zykMvdWIJ\nGKpo19XNzCbz6/Nkc/Y263HWdjJOSjqE5akYc4+7Z6Eynr2eC2qwNRgRhuHZx1fijvNbhulp6O3V\nio2jDXtb/zxtDW001TV5a8ulndWIHUf23alFGkacwy5BDdkX6XoKvbmgCMuzzw0NMr06rXk8KkMv\nVfXbpqvJVa1ujlM+pPl5aGnR7rlWx1gRldXsq0nGmV2bpaupi/pofaDmwyD7RCrhPd+Vye7ZSIdC\nvR5qZB8G+ldT9FxukoTcBBER8e4FlKAoGZTCCzwoii4cITR3NWg0QDzOUlczHY0dNEQb1Hr2qvpt\nMwXxlTiA45w7kWs0CqkKyThbfUNW+5rMD1sBGSdoAjQdoXj2KR+efUk/43HINCvcPQs7gux33A7a\n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\nQmCC\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x106a16e48>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "a1 = logistic_growth(0.3, 100, 10)\n",
    "a2 = logistic_growth(0.3, 100, 10)\n",
    "a3 = logistic_growth(0.3, 100, 10)\n",
    "\n",
    "plot(a1)\n",
    "plot(a2)\n",
    "plot(a3)"
   ]
  }
 ],
 "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.4.3"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 0
}