stable_stage: Stable stage distribution of an MPM

In BruceKendall/mpmtools: Tools for Building and Analyzing Matrix Population Models

Description

Calculates w_1, the eigenvector associated with the dominant eigenvector, which can be interpreted as the stable age/stage/size distribution. The vector is scaled to sum to one. Allows stage-for-age Leslie matrices to be reported by stage for ease of visualization.

Usage

stable_stage(A, collapse = FALSE, stages = NULL)

Arguments

A	Square matrix representing a matrix population model
collapse	Should classes in the matrix be collapsed into a smaller number of stage classes?
stages	A vector with length equal to the rank of A giving the stage name for each matrix class. If A is a Leslie matrix created using make_stage4age_matrix, then this can be left unspecified.

Value

A vector of the stable stage distribution

Examples

# Reproduce the model in Crowder et al:
A1 <- make_stage4age_matrix(loggerhead[[2]], approx_method = "AAS")
stable_stage(A1)

# Now do the Leslie matrix version of the same data
A2 <- make_stage4age_matrix(loggerhead[[2]])
stable_stage(A2) # Age structure
stable_stage(A2, collapse = TRUE) # Stage structure

BruceKendall/mpmtools documentation built on May 21, 2019, 1:42 a.m.