Rpadrino is a package for interacting with the PADRINO Integral Projection Model database. Currently, an alpha release of PADRINO exists as a set of version controlled csv files hosted in a GitHub repository. The longer term plan is to migrate it to a set of static, version-controlled tables that are hosted on Zenodo (or similar). For now, you can access it by installing the
Rpadrino R package from this repository (see below for instructions).
Or the development version (may not be stable!):
The goal of this package is basic data management, exploration, and porting PADRINO’s internal syntax to
ipmr’s syntax. One can combine models from here with their own models for synthesis work, using the
proto_ipm as a common data structure to power the analysis. It is not intended to provide a complete analysis toolbox - that will come in a separate package designed to work with
The data included in this package are quality checked (see below) and ready for use. This is not the complete database - that can be downloaded using the
pdb_download function. See the table below for information on the number of models in each.
|Data Source||# of Species||# of Publications||# of IPM id’s|
|Full PADRINO Database||56||40||280|
|Kingdom||# of Species||# of Publications||# of IPM id’s|
Above are the current number of unique species, unique publications, and unique
ipm_ids that are in PADRINO and
Rpadrino’s internal dataset. Table 2 provides a breakdown of how these are distributed amongst taxonomic kingdoms in the full database (i.e. not the internal data set). All of the models included in both the internal data set and full database have been quality checked for accuracy. Quality checked means that for deterministic models, the asymptotic per-capita growth rate (λ) is within ± 0.03 of the published point estimate value. For stochastic models, we check for approximately the same stochastic population growth rate (λs), but do not try to replicate the analysis, as this usually requires too many computing resources to be feasible.
A small-ish copy of the Padrino Database is included as a package data set. You can download the full database as well. You can access it with the following code:
library(Rpadrino) data("pdb") # Internal copy, contains a subset of plant species in PADRINO # Downloads the complete database. The models contained in here have # been tested for accuracy/reasonable results. pdb <- pdb_download(save = FALSE)
The next step is to identify the models we are interested in building. There are accessor functions that allow you to extract metadata columns from the
pdb object, which may be helpful in this step. See
?pdb_species_accepted for a list of those. Additionally, the shiny_pdb allows for interactive exploration and subsetting of data.
Once, we’ve identified the model(s) we want, we can build a list of
proto_ipm’s. This is an intermediate step between the database representation and a set of kernels. Once we have the list of
proto_ipm’s, we can build an actual model. Below, we extract a specific study, and construct an IPM from the database object.
# We can construct a single IPM at a time, or make a list of many IPMs proto_list <- pdb_make_proto_ipm(pdb, ipm_id = c("aaa310", "ddddd7", "aaaa17"), det_stoch = "det")
Once the list of
proto_ipm’s is generated, you can either append your own IPMs to it, or you can go ahead to the next chunk. Note that
pdb_make_ipm will almost always work, but there may still be bugs lurking!
Functions are documented in the Functions tab and longer form documentation and examples are in the Vignettes tab.
Please note that the Rpadrino project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.