# 6.3. Population Simulation Example: One simulation¶

Note

This is based one one of the 100 recipes of the IPython Cookbook, the definitive guide to high-performance scientific computing and data science in Python.

The goal of this section is to present a fairly intuitive example of how numpy arrays function to improve the efficiency of numerical calculations. The example involes a simulation of something called a Markov process and does not require very much mathematical background.

We consider a population with a maximum of individuals and equal probabilities of birth and death for any given individual:

import numpy as np
P = 100  # maximum population size
a = .005  # birth rate
b = .005  # death rate


We simulate fluctuation in the population size over T moments in time with a Markov chain of length T. Each state in the chain represents a population size at a moment in time. We represent this with a numpy vector x. The vector x will contain the entire history of population sizes. We first set the population size at time to .

T = 1000
x = np.zeros(T)
x[0] = 25
x[:20]

array([ 25.,   0.,   0.,   0.,   0.,   0.,   0.,   0.,   0.,   0.,   0.,
0.,   0.,   0.,   0.,   0.,   0.,   0.,   0.,   0.])


We now simulate our chain. At each time step , there is a new birth with probability , and independently, there is a new death with probability . These probabilities are proportional to the size of the population at that time. If the population size reaches or , the evolution stops.

for t in range(T - 1):
if 0 < x[t] < P-1:
# Is there a birth?
birth = np.random.rand() <= a*x[t]
# Is there a death?
death = np.random.rand() <= b*x[t]
# We update the population size.
x[t+1] = x[t] + 1*birth - 1*death
# The evolution stops if we reach $0$ or $N$.
else:
x[t+1] = x[t]

x[:25]

array([ 25.,  25.,  25.,  25.,  26.,  27.,  27.,  28.,  28.,  29.,  30.,
30.,  30.,  31.,  31.,  31.,  31.,  31.,  31.,  31.,  32.,  32.,
32.,  32.,  32.])

x[-25:]

array([  8.,   8.,   8.,   8.,   8.,   8.,   8.,   9.,   9.,   9.,   9.,
9.,   9.,   9.,   9.,   9.,   9.,   9.,   9.,   9.,   9.,  10.,
10.,  10.,  10.])

x[t]

10.0


We plot the evolution of the population size.

plt.figure(figsize=(6,3));
plt.plot(x);


We see that, at every time, the population size can stay stable, increase by 1, or decrease by 1. This is a very jagged plot with day by day discrete variation (+ or - 1). The associated notebook shows how to smooth the plot using rolling means, but even the smoothed plots misses some very important properties of this trivial Markov model, as we will see in the next section.

# 6.4. Population Simulation Example: Using numpy for multiple simulations¶

Now, we now show how to simulate many independent trials of the same Markov chain. The vector x will now contain the population size of 100 independent trials at a particular time. To initialize x, the population sizes are set to random numbers between and the maximum population size .

We could run the previous simulation with a loop, but it would be very slow (two nested for loops). Instead, we vectorize the simulation by considering all independent trials at once. As before, we need to loop over moments in time, but at each time step, we update 100 trials simultaneously with vectorized operations.

We initialize the ntrials=100 different trials with a vector of size 100 with a randomly chosen initial population size for each trial.

ntrials, P  = 100, 100
x = np.random.randint(size=ntrials,
low=0, high=P)
x

array([42, 12, 43, 41, 98, 11, 10, 21, 61, 12, 18, 10, 30, 31, 66,  7, 92,
74, 89, 27, 62, 22, 22, 64, 93, 53, 14,  4, 79, 63, 29, 12, 98, 33,
47,  5, 30, 99, 49, 35,  2, 52, 93, 41, 14, 29, 93, 78, 43, 27, 91,
71, 43, 69, 75, 17, 61, 32, 71, 10, 72, 47, 40, 16,  1, 30, 86, 66,
6, 56, 29, 14, 58, 69, 48, 53, 98, 79, 56, 95, 77, 10, 81,  9, 32,
87, 14, 24, 44, 40, 12,  7, 45, 65, 17,  3, 17, 79,  7, 86])


Call this our trial vector. As a illustration of what’s to come, lets’s test to see that each trial in the trial vector has a population size eligible for growth > 0 and < P - 1. Notice how the Boolean test is vectorized: It applies to each element of the trial vector and the result is a vector of Booleans.

upd = (0 < x) & (x < P - 1)

array([ True,  True,  True,  True,  True,  True,  True,  True,  True,
True,  True,  True,  True,  True,  True,  True,  True,  True,
True,  True,  True,  True,  True,  True,  True,  True,  True,
True,  True,  True,  True,  True,  True,  True,  True,  True,
True,  True,  True,  True,  True,  True,  True,  True,  True,
True,  True,  True,  True,  True,  True,  True,  True,  True,
True,  True,  True,  True,  True,  True,  True,  True,  True,
True,  True,  True,  True,  True,  True,  True,  True,  True,
True,  True,  True,  True,  True, False,  True,  True,  True,
True,  True,  True,  True,  True,  True,  True,  True,  True,
True,  True,  True,  True,  True,  True,  True,  True,  True,  True], dtype=bool)


Note there is one False result, because the 38th element of x was 99. We can use such a Boolean vector to do a selective update that changes (adds 1 to) only those trials in x that are eligible for change.

x[upd] += np.ones(len(x[upd]))

array([43, 13, 44, 42, 99, 12, 11, 22, 62, 13, 19, 11, 31, 32, 67,  8, 93,
75, 90, 28, 63, 23, 23, 65, 94, 54, 15,  5, 80, 64, 30, 13, 99, 34,
48,  6, 31, 99, 50, 36,  3, 53, 94, 42, 15, 30, 94, 79, 44, 28, 92,
72, 44, 70, 76, 18, 62, 33, 72, 11, 73, 48, 41, 17,  2, 31, 87, 67,
7, 57, 30, 15, 59, 70, 49, 54, 99, 80, 57, 96, 78, 11, 82, 10, 33,
88, 15, 25, 45, 41, 13,  8, 46, 66, 18,  4, 18, 80,  8, 87])


Note that every cell except the cell with value 99 has been updated. WE will use a slight variation on this idea in the code below.

The simulation function will work as follows. We create a vector of size ntrials, with each cell containing a randomly chosen number between 0 and 1. The probability of at least one birth is a*x, and for each trial, we we generate a birth only if the randomly chosen number is less than a*x. Again, we do this in one line, with a vectorized Boolean test on a vector of randomly chosen numbers.

Z = (np.random.rand(ntrials) <= a*x)
Z

array([False, False, False, False, False, False, False, False, False,
False, False, False, False, False, False, False, False,  True,
True, False,  True, False, False, False, False, False, False,
False,  True, False, False, False,  True, False, False, False,
True,  True,  True, False, False, False, False,  True, False,
False, False, False, False, False, False, False, False, False,
False, False, False, False,  True, False, False, False, False,
False, False, False,  True,  True,  True, False, False,  True,
False, False, False, False,  True, False, False,  True,  True,
False,  True, False, False,  True, False, False,  True,  True,
False, False, False,  True, False, False, False, False, False,  True], dtype=bool)


Call Z the decision vector.. It will be convenient to swith from Booleans to 1’s and 0s, Again we can do this a single vectorized operation on the decision vector Z.

1 * Z

array([0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 0, 1, 0, 0,
0, 0, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0, 1, 1, 1, 0, 0, 0, 0, 1, 0, 0,
0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1,
0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 1, 1, 0, 1, 0, 0, 1, 0, 0, 1, 1, 0, 0,
0, 1, 0, 0, 0, 0, 0, 1])


So if we add such a decision vector to the cells of the current population vector eigible for update, we simulate a birth wherever there is a 1; if we subtract it, we simulate a death. Next define a simulation function to use such randomly generated decision vectors to simulate births and deaths. At every time step, we find the births and death for each trial by generating a random decision vector, and we update the population sizes with vectorized addition and subtraction.

def simulate(x, T):
"""Run the simulation."""
for _ in range(T - 1):
# Which trials to update?
upd = (0 < x) & (x < N-1)
# In which trials do births occur?
birth = 1*(np.random.rand(ntrials) <= a*x)
# In which trials do deaths occur?
death = 1*(np.random.rand(ntrials) <= b*x)
# We update the population size for all trials.
x[upd] += birth[upd] - death[upd]


Now, we will look at the histograms of the population size at different times. These histograms represent the probability distribution of the Markov chain, estimated with independent trials. This kind of simulation of a sequence of trials according to a given probability distribution is called a Monte Carlo simulation.

We are interested in seeing the distribution of population sizes over all the simulations, so we draw histograms showing the number of simulations exhibiting various population sizes. This means dividing the possible population size (0-100) into bins. We choose 25 bins.

bins = np.linspace(0, N, 25);

N,len(bins),bins

(100, 25, array([   0.        ,    4.16666667,    8.33333333,   12.5       ,
16.66666667,   20.83333333,   25.        ,   29.16666667,
33.33333333,   37.5       ,   41.66666667,   45.83333333,
50.        ,   54.16666667,   58.33333333,   62.5       ,
66.66666667,   70.83333333,   75.        ,   79.16666667,
83.33333333,   87.5       ,   91.66666667,   95.83333333,  100.        ]))


We will also try running our 100 simulations for histories of different lengths, short, medium, and long, to probe what the long term outcomes of our Markov model are.

plt.figure(figsize=(12,3));
T_list = [10, 1000, 10000]
for i, T in enumerate(T_list):
plt.subplot(1, len(T_list), i + 1);
simulate(x, T)
plt.hist(x, bins=bins);
plt.xlabel("Population size");
if i == 0:
plt.ylabel("Histogram");
plt.title("{0:d} time steps".format(T));


Now we can see a key property that was completely obscured in the single simulation plot. Whereas, initially, the population sizes look equally distributed between and , they appear to converge to or after a sufficiently long time. This is because the states and are absorbing: once reached, the chain cannot leave those states. Furthermore, these states can be reached from any other state.

You’ll find all the explanations, figures, references, and much more in the book:

IPython Cookbook, by Cyrille Rossant, Packt Publishing, 2014 (500 pages).