Generate Lefkovitch matrices

Owen Jones

2024-07-01

Introduction

Lefkovitch matrix population models (MPMs) were introduced by Leonard Lefkovitch in his 1965 paper titled “The Study of Population Growth in Organisms Grouped by Stages” published in Biometrics. This paper extended the concept of Leslie MPMs, which are structured by age, to stage-structured populations, providing a framework that has been widely used in ecology, evolution and conservation studies.

In a Lefkovitch MPM, the square matrix is used to model population growth across discrete projection intervals, typically representing years. Each matrix element represents either a transition probability between different stages or the fertility of a stage across the projection interval. The MPM can be divided into submatrices: one for survival/growth (the U matrix), one for sexual reproduction (the F matrix) and one for asexual reproduction (the C matrix), such that A = U + F + C. Occasionally, these reproduction matrices are lumped together as a reproduction matrix, R (i.e. R = F + C).

The elements of the U matrix represent survival or growth from stage-to-stage between time steps. Therefore the column sums of the U submatrix cannot exceed 1. The fertility elements, in the the F and C (or R) submatrices are do not have an upper bound and indicate the number of new individuals each stage can produce in each time interval.

Zero entries in the matrices indicating that those transitions do not occur.

To project population size and structure over time, the MPM is multiplied by a vector representing the current population structure (number of individuals in each stage). This results in a new vector showing the predicted population structure for the next time step. This process can be iterated to project population dynamics over multiple time steps.

Lefkovitch models are useful for studying population dynamics under different scenarios, such as changes in survival or fecundity rates, or different management strategies. They have broad applications in both theoretical and applied ecology.

Aims

The purpose of this vignette is to illustrate how to simulate stage-based (Lefkovitch) MPMs based on defined life history archetypes. There are several reasons why one would want to do this, including, but not limited to:

In the following sections, this document will:

  1. Explain how life cycles can be categorised into Archetypes.
  2. Show how to generate a random Lefkovitch MPM based on an archetype.
  3. Show how to rapidly produce sets of many random MPMs.
  4. Show how to constrain the MPMs by matrix properties.

Preparation

Before beginning, users will need to load the required packages.

library(mpmsim)
library(dplyr)
library(Rage)
library(ggplot2)
library(Rcompadre)

1. Life cycle archetypes and generating an MPM

In stage-based (Lefkovitch) matrix population models (MPMs), different life cycle types can be represented by various structural forms of the matrices. These life cycle types can be captured using different life history archetypes, which define the transitions between stages and the survival probabilities in the population.

The life history archetypes, based on Takada et al. (2018), are as follows:

In all these archetypes, fecundity is placed in the top row of the matrix. In Takada et al’s paper, fecundity was always placed in the top right of the MPM, meaning that only the “last” stage of the life cycle reproduced. This approach can be relaxed to allow reproduction from any stage.

2. Generate a random Lefkovitch MPM based on an archetype

In mpmsim the function rand_lefko_mpm can be used to generate a random MPM that conforms to one of the above four life cycle archetypes. The function allows for the generation of random MPMs based on these archetypes, with survival and growth (the U matrix) based on draws from a Dirichlet distribution to ensure biological plausibility. For flexibility, the function is quite flexible with fertility

The function is straightforward, in the following example, I create a three-stage MPM, based on Archetype 2. I set fecundity, arbitrarily to be 5. By default, if only a single value is given, this is placed in the top-right hand corner of the F matrix. Also, by default, all reproduction is assumed to be sexual.

rand_lefko_mpm(n_stages = 3, fecundity = 5, archetype = 2)
#> $mat_A
#>             [,1]       [,2]       [,3]
#> [1,] 0.005877166 0.10766181 5.72412770
#> [2,] 0.509913175 0.03602856 0.06736799
#> [3,] 0.287840153 0.74138349 0.19955576
#> 
#> $mat_U
#>             [,1]       [,2]       [,3]
#> [1,] 0.005877166 0.10766181 0.72412770
#> [2,] 0.509913175 0.03602856 0.06736799
#> [3,] 0.287840153 0.74138349 0.19955576
#> 
#> $mat_F
#>      [,1] [,2] [,3]
#> [1,]    0    0    5
#> [2,]    0    0    0
#> [3,]    0    0    0

To allow a random element to reproduction, users can provide fertility information as a list of two matrices of numeric values, both with the same dimension as n_stages, to provide lower and upper limits of mean fecundity for the entire matrix model. Fertility values are then drawn from a uniform distribution between the two values. Users should use 0 for both lower and upper limits in cases with no reproduction.

The following code provides an example:

lower_fert <- matrix(c(
  0, 0, 0,
  0, 0, 0,
  0, 0, 0
), nrow = 3, ncol = 3, byrow = TRUE)
upper_fert <- matrix(c(
  0, 4, 20,
  0, 0, 0,
  0, 0, 0
), nrow = 3, ncol = 3, byrow = TRUE)

rand_lefko_mpm(
  n_stages = 3, fecundity = list(lower_fert, upper_fert),
  archetype = 2
)
#> $mat_A
#>           [,1]      [,2]       [,3]
#> [1,] 0.0873477 2.6402006 15.2043937
#> [2,] 0.4082913 0.1851252  0.5516964
#> [3,] 0.3924441 0.1736190  0.1107596
#> 
#> $mat_U
#>           [,1]      [,2]      [,3]
#> [1,] 0.0873477 0.5799473 0.3249008
#> [2,] 0.4082913 0.1851252 0.5516964
#> [3,] 0.3924441 0.1736190 0.1107596
#> 
#> $mat_F
#>      [,1]     [,2]     [,3]
#> [1,]    0 2.060253 14.87949
#> [2,]    0 0.000000  0.00000
#> [3,]    0 0.000000  0.00000

3. Generate sets of Lefkovitch matrices

It is sometimes desirable to create large numbers of MPMs with particular properties in order to test hypotheses. For stage-based (Lefkovitch) MPMs, this can be implemented using the function rand_lefko_set. This function acts as a wrapper for the previously described function and generates a set of Lefkovitch MPMs based on a defined life cycle archetype and specified fertility. For example, users may wish to generate MPMs for different life history archetypes to explore how life cycle structure may influence population dynamics. By specifying the number of stages, fecundity values, and archetypes, users can produce MPMs that are tailored to their specific research needs. This capability is useful for exploring the effects of life history traits on population dynamics, testing ecological and evolutionary hypotheses, and for teaching purposes.

The function returns either a list or a CompadreDB object depending on the output argument. If the output is set as a CompadreDB object, the archetype of the MPM is included as a column of metadata.

The following code shows how users can generate 100 matrices in a CompadreDB object.

myMatrices <- rand_lefko_set(
  n = 100, n_stages = 3, fecundity = 12,
  archetype = 4, output = "Type1"
)

After producing the output as a CompadreDB object, the matrices can be accessed using functions from the RCompadre R package. For example, to get the A matrix, or the U/F submatrices users can use the matA, matU or matF functions. The following code illustrates how to rapidly calculate population growth rate for all of the matrices.

# Obtain the matrices
x <- matA(myMatrices)

# Calculate lambda for each matrix
lambdaVals <- sapply(x, popdemo::eigs, what = "lambda")
summary(lambdaVals)
#>    Min. 1st Qu.  Median    Mean 3rd Qu.    Max. 
#>  0.7378  1.1395  1.4965  1.4653  1.7106  2.1926

Users can examine the vignettes for the Rcompadre and Rage packages for additional insight into other potential operations with the compadreDB object.

4. Constraining the output matrices

Critically, users can impose constraints on the “acceptable” properties of these randomly generated MPMs. For example, for some analyses it may be desirable to only obtain MPMs where the population growth rate is close to 1.

This is handled by the constraint argument, which takes a data frame specifying the criteria for acceptable MPMs. The data frame must have four columns: fun, arg, lower, and upper. The fun column contains the name of the function that calculates the metric to be constrained (e.g., eigs, from the popdemo package). The arg column specifies any additional argument that the function requires (e.g. what = "lambda" for the eigs function), using NA if no additional argument is needed. The lower and upper columns set the bounds of the acceptable range for the metric.

Here’s an example of how to use the constraint argument to ensure that the generated MPMs have a population growth rate (lambda) between 0.9 and 1.1.

library(popdemo)

constrain_df <- data.frame(
  fun = "eigs", arg = "lambda", lower = 0.9, upper = 1.1
)

myMatrices <- rand_lefko_set(
  n = 100, n_stages = 3, fecundity = 12, constraint = constrain_df,
  archetype = 4, output = "Type1"
)

We can check that it has worked by examining the matrices.

# Obtain the matrices
x <- matA(myMatrices)

# Calculate lambda for each matrix
lambdaVals <- sapply(x, popdemo::eigs, what = "lambda")
summary(lambdaVals)
#>    Min. 1st Qu.  Median    Mean 3rd Qu.    Max. 
#>  0.9019  0.9612  1.0148  1.0115  1.0635  1.0984

Conclusion

Conclusion

This vignette has provided a comprehensive guide to generating Lefkovitch matrix population models (MPMs) based on life history archetypes. By using the rand_lefko_mpm and rand_lefko_set functions, users can create single MPMs or large sets of MPMs tailored to specific research needs. The ability to impose constraints on these models allows for precise control over their properties, ensuring that generated MPMs meet defined criteria, such as specific population growth rates.

The flexibility and power of these functions facilitate the exploration of population dynamics under various scenarios, aiding in hypothesis testing in studies of population biology and life history theory. Additionally, tight integration with the Rcompadre package facilitates the use of generated models, enhancing their utility in both theoretical and applied ecological research.

By following the steps and examples provided, users can effectively simulate and manipulate stage-based MPMs, contributing valuable insights to the fields of ecology, evolution, and conservation biology.