entropy_d: Calculate Demetrius' entropy from trajectories of...

In Rage: Life History Metrics from Matrix Population Models

Calculate Demetrius' entropy from trajectories of age-specific survivorship and fecundity

Description

This function calculates Demetrius' entropy from vectors of age-specific survivorship (lx) and fecundity (mx).

Usage

entropy_d(lx, mx, ...)

Arguments

lx	Either a survivorship trajectory (a vector of monotonically-declining values in the interval [0,1]), or submatrix U from a matrix population model.
mx	Either an age-specific fecundity trajectory (a vector of non-negative values), or submatrix U from a matrix population model.
...	Additional variables passed to 'mpm_to_lx' and 'mpm_to_mx' if the data are supplied as matrices.

Value

Demetrius' entropy.

Warning

Note that this function may produce unexpected results if used on partial survivorship and fecundity trajectories. In addition, it is sensitive to the length of the these vectors. We direct users to the functions 'shape_surv' and 'shape_rep' which are relatively robust to these issues.

Author(s)

Roberto Salguero-Gomez <[e-mail]>

Patrick Barks <[e-mail]>

References

Demetrius, L., & Gundlach, V. M. 2014. Directionality theory and the entropic principle of natural selection. Entropy 16: 5428-5522.

See Also

Other life history traits: entropy_k(), gen_time(), life_expect_mean(), longevity(), net_repro_rate(), repro_maturity, shape_rep(), shape_surv()

Examples

data(mpm1)

# derive trajectories of lx and mx, starting from stage 2
lx <- mpm_to_lx(mpm1$matU, start = 2)
mx <- mpm_to_mx(mpm1$matU, mpm1$matF, start = 2)

# calculate Demetrius' entropy
entropy_d(lx, mx)

# calculate Demetrius' entropy directly from MPM
entropy_d(lx = mpm1$matU, mx = mpm1$matF, start = 2)

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