Rage: gen_time – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

gen_time

Calculate generation time from a matrix population model

Description

Calculate generation time from a matrix population model. Generation time is defined here as the time required for a population to increase by a factor of R0 (the net reproductive rate, see ). For more details please refer to section 5.3.5 of Caswell (2001).

Usage

gen_time(matU, matR)

Arguments

`matU`	The survival component of a matrix population model (i.e. a square projection matrix reflecting survival-related transitions; e.g. progression, stasis, and retrogression).
`matR`	The reproductive component of a matrix population model (i.e. a square projection matrix only reflecting transitions due to reproduction; either sexual, clonal, or both).

Details

There are multiple definitions of generation time. Here we use log(R0) / log(lambda), where R0 is the net reproductive rate (the per-generation population growth rate; Caswell 2001, Sec. 5.3.4), and lambda is the population growth rate per unit time (the dominant eigenvalue of matU + matR).

Value

Returns generation time. If matU is singular (often indicating infinite life expectancy), returns NA.

Author(s)

Patrick Barks <patrick.barks@gmail.com>

References

Caswell, H. 2001. Matrix Population Models: Construction, Analysis, and Interpretation. Sinauer Associates; 2nd edition. ISBN: 978-0878930968

Examples

data(mpm1)

# calculate generation time
gen_time(matU = mpm1$matU, matR = mpm1$matF)

Rage

Life History Metrics from Matrix Population Models

v1.0.0

GPL-3

Authors

Patrick Barks [aut] (<https://orcid.org/0000-0002-5947-8151>), Danny Buss [ctb], Pol Capdevila [aut] (<https://orcid.org/0000-0002-2842-4302>), Hal Caswell [aut] (<https://orcid.org/0000-0003-4394-6894>), Judy P. Che-Castaldo [aut] (<https://orcid.org/0000-0002-9118-9202>), John Jackson [aut] (<https://orcid.org/0000-0002-4563-2840>), Tamora James [aut] (<https://orcid.org/0000-0003-1363-4742>), Owen Jones [aut, cre] (<https://orcid.org/0000-0001-5720-4686>), Sam Levin [aut] (<https://orcid.org/0000-0002-3289-9925>), William K. Petry [aut] (<https://orcid.org/0000-0002-5230-5987>), Roberto Salguero-Gomez [aut] (<https://orcid.org/0000-0002-6085-4433>), Caroline Schuette [ctb] (<https://orcid.org/0000-0002-2063-8736>), Iain Stott [aut] (<https://orcid.org/0000-0003-2724-7436>), Chelsea C. Thomas [aut] (<https://orcid.org/0000-0002-8155-9353>)

Initial release