Rcompadre and Rage - two R packages to facilitate the use of the COMPADRE and COMADRE databases and calculation of life history traits from matrix population models

Summary

1. Matrix population models (MPMs) are an important tool for biologists seeking to understand the causes and consequences of variation in vital rates (e.g., survival, reproduction) across life cycles. Empirical MPMs describe the age- or stage-structured demography of organisms and usually represent the life history of a population during a particular time frame at a specific geographic location.

2. The COMPADRE Plant Matrix Database and COMADRE Animal Matrix Database are the most extensive resources for MPM data, collectively containing >12,000 individual projection matrices for >1,100 species globally. Although these databases represent an unparalleled resource for researchers, land managers, and educators, the current computational tools available to answer questions with MPMs impose significant barriers to potential COM(P)ADRE database users by requiring advanced knowledge to handle diverse data structures and program custom analysis functions.

3. To close this knowledge gap, we present two interrelated R packages designed to (i) facilitate the use of these databases by providing functions to acquire, quality control, and manage both the MPM data contained in COMPADRE and COMADRE, and a user’s own MPM data (Rcompadre), and (ii) present a range of functions to calculate life history traits from MPMs in support of ecological and evolutionary analyses (Rage). We provide examples to illustrate the use of both.

4. Rcompadre and Rage will facilitate demographic analyses using MPM data and contribute to the improved replicability of studies using these data. We hope that this new functionality will allow researchers, land managers, and educators to unlock the potential behind the thousands of MPMs and ancillary metadata stored in the COMPADRE and COMADRE matrix databases, and in their own MPM data.