In weecology/portalr: Create Useful Summaries of the Portal Data

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/"
)

library(portalr)

portalr

Overview

The portalr package provides collection of basic functions to summarize the Portal project data on rodents, plants, ants, and weather at our long-term field site in the Chihuahuan Desert. The data begin in 1977 and are continuously updated today. There are functions to summarize rodent abundance, biomass, or energy and by site, plot, or treatment type. There are functions to summarize the weather data collected from our automated weather stations and plant data that is collected each summer and fall.

Installation

You can install portalr from CRAN with:

install.packages("portalr")

OR from github with:

# install.packages("remotes")
remotes::install_github("weecology/portalr")

Examples

1. Load all data tables from the PortalData GitHub repo:

data_tables <- load_rodent_data("repo")

1. Download and generate summaries of rodent abundance and biomass:

download_observations(".")

rodent_data <- abundance(".") # default grouping is by sampling period

rodent_biomass_by_plot <- biomass(".", level = "plot", type = "granivores", 
shape = "flat", time = "date")

1. Retrieve weather data:

weatherdata <- weather("Monthly", ".")

For more detailed info, checkout the vignettes associated with the package:

browseVignettes("portalr")

More Information

Portal Data Repo

The data repo contains useful details for issues with data collection, and background on why we handle them the way we do. Of course, it also contains the raw data, if you would like to create more complex data summaries than what is provided here.

The Portal Project

Find a list of previous publications using the Portal data at our website.

The Portal Blog

Follow our blog to get the latest news on what is happening with our project and at the site.

Citation

To cite portalr, please refer to either:

• JOSS publication:

Erica M. Christensen, Glenda M. Yenni, Hao Ye, Juniper L. Simonis, Ellen K. Bledsoe, Renata M. Diaz, Shawn D. Taylor, Ethan P. White, and S. K. Morgan Ernest. (2019). portalr: an R package for summarizing and using the Portal Project Data. Journal of Open Source Software, 4(33), 1098, https://doi.org/10.21105/joss.01098

• or use the most recent release on Zenodo.

Dataset Citation

To cite the Portal dataset, use:

get_dataset_citation()

weecology/portalr documentation built on Feb. 29, 2024, 3:34 a.m.