leslie_collapse: Aggregate a Leslie matrix

In jonesor/Rage: Life History Metrics from Matrix Population Models

Aggregate a Leslie matrix

Description

Takes a Leslie matrix and aggregates it to a desired dimension m using least squares weights equal to the stable age distribution. The output includes the aggregated matrix, the weight matrix, the original (or expanded) Leslie matrix raised to the k power, the partitioning matrix, the size of the original (or expanded) Leslie matrix, the size of the aggregated matrix, the quotient of the original size divided by the aggregated size, and the effectiveness of aggregation.

Usage

leslie_collapse(A, m)

Arguments

A	a Leslie matrix
m	the dimensionality of the desired aggregated matrix

Value

a list including the following elements:

B	The aggregated matrix
W	The weight matrix
Ak	The original (or expanded) Leslie matrix raised to the k power
S	The partitioning matrix
n	The size of the original (or expanded) Leslie matrix
m	The size of the aggregated matrix
k	The quotient of the original size divided by the aggregated size
EFF	The effectiveness of aggregation

Author(s)

Richard A. Hinrichsen <[e-mail]>

References

Hinrichsen, R. A. (2023). Aggregation of Leslie matrix models with application to ten diverse animal species. Population Ecology, 1–21. <doi:10.1002/1438-390X.12149>

See Also

Other transformation: is_leslie_matrix(), mpm_collapse(), mpm_rearrange(), mpm_split(), mpm_standardize(), name_stages(), repro_stages(), standard_stages()

Examples

data(leslie_mpm1)
A <- leslie_mpm1$matU + leslie_mpm1$matF
leslie_collapse(A, 4)

jonesor/Rage documentation built on April 3, 2024, 7:47 a.m.