Modeling and Simulation in Python

Rabbit example

Copyright 2017 Allen Downey

License: Creative Commons Attribution 4.0 International


In [1]:
%matplotlib inline

from modsim import *

Rabbit Redux

This notebook starts with a version of the rabbit population growth model and walks through some steps for extending it.

In the original model, we treat all rabbits as adults; that is, we assume that a rabbit is able to breed in the season after it is born. In this notebook, we extend the model to include both juvenile and adult rabbits.

As an example, let's assume that rabbits take 3 seasons to mature. We could model that process explicitly by counting the number of rabbits that are 1, 2, or 3 seasons old. As an alternative, we can model just two stages, juvenile and adult. In the simpler model, the maturation rate is 1/3 of the juveniles per season.

To implement this model, make these changes in the System object:

  1. Before you make any changes, run all cells and confirm your understand them.

  2. Then, add a second initial populations: juvenile_pop0, with value 0.

  3. Add an additional variable, mature_rate, with the value 0.33.


In [2]:
system = System(t0 = 0, 
                t_end = 10,
                adult_pop0 = 10,
                birth_rate = 0.9,
                death_rate = 0.5)

system


Out[2]:
value
t0 0.0
t_end 10.0
adult_pop0 10.0
birth_rate 0.9
death_rate 0.5

Now update run_simulation with the following changes:

  1. Add a second TimeSeries, named juveniles, to keep track of the juvenile population, and initialize it with juvenile_pop0.

  2. Inside the for loop, compute the number of juveniles that mature during each time step.

  3. Also inside the for loop, add a line that stores the number of juveniles in the new TimeSeries. For simplicity, let's assume that only adult rabbits die.

  4. During each time step, subtract the number of maturations from the juvenile population and add it to the adult population.

  5. After the for loop, store the juveniles TimeSeries as a variable in System.


In [3]:
def run_simulation(system):
    """Runs a proportional growth model.
    
    Adds TimeSeries to `system` as `results`.
    
    system: System object with t0, t_end, p0,
            birth_rate and death_rate
    """
    adults = TimeSeries()
    adults[system.t0] = system.adult_pop0
    
    for t in linrange(system.t0, system.t_end):
        births = system.birth_rate * adults[t]
        deaths = system.death_rate * adults[t]
        
        adults[t+1] = adults[t] + births - deaths
        
    system.adults = adults

Test your changes in run_simulation:


In [4]:
run_simulation(system)
system.adults


Out[4]:
value
0 10.000000
1 14.000000
2 19.600000
3 27.440000
4 38.416000
5 53.782400
6 75.295360
7 105.413504
8 147.578906
9 206.610468
10 289.254655
11 404.956517

Next, update plot_results to plot both the adult and juvenile TimeSeries.


In [5]:
def plot_results(system, title=None):
    """Plot the estimates and the model.
    
    system: System object with `results`
    """
    newfig()
    plot(system.adults, 'bo-', label='adults')
    decorate(xlabel='Season', 
             ylabel='Rabbit population',
             title=title)

And test your updated version of plot_results.


In [6]:
plot_results(system, title='Proportional growth model')


This notebook demonstrates the steps we recommend for starting your project:

  1. Start with one of the examples from the book, either by copying a notebook or pasting code into a new notebook. Get the code working before you make any changes.

  2. Make one small change, and run the code again.

  3. Repeat step 2 until you have a basic implementation of your model.

If you start with working code that you understand and make small changes, you can avoid spending a lot of time debugging.

One you have a basic model working, you can think about what metrics to measure, what parameters to sweep, and how to use the model to predict, explain, or design.

Bonus question

Suppose you only have room for 30 adult rabbits. Whenever the adult population exceeds 30, you take any excess rabbits to market (as pets for kind children, of course). Modify run_simulation to model this strategy. What effect does it have on the behavior of the system? You might have to run for more than 10 seasons to see what happens.


In [ ]: