leslie_collapse: Aggregate a Leslie matrix

View source: R/leslie_collapse.R

leslie_collapseR Documentation

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 <rich@hinrichsenenvironmental.com>

References

Hinrichsen, R. A. (2023). Aggregation of Leslie matrix models with application to ten diverse animal species. Population Ecology, 1–21. https://doi.org/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)


Rage documentation built on Sept. 30, 2023, 1:06 a.m.