Skip to contents

CEMPRA

The Cumulative Effects Model for Prioritizing Recovery Actions (CEMPRA) is a cumulative effects modelling framework. The CEMPRA tool uses a series of standardized stressor-response functions to link environmental attributes to the system capacity and productivity of a target species/system. This framework design is as generalizable, simple, and versatile as possible so that users can apply the model to various geographic regions, contexts, systems, and species. As the name suggests, the CEMPRA tool helps prioritize recovery actions for data-limited species and species-at-risk, with the flexibility to accommodate both data-rich and data-poor study systems. The CEMPRA tool is accessible as an open-source R package (https://github.com/essatech/CEMPRA) and R Shiny interactive web application (https://github.com/essatech/CEMPRAShiny).

Project Components

Shiny App Tutorial Video access the tool

Tutorial Video

Package Contributors:

This is a broad collaboration between Fisheries and Oceans Canada (DFO), B.C. Ministry of Environment and Climate Change Strategy (ECCS), Alberta Environment and Parks (AEP), and Simon Fraser University (SFU).

Contributors include: - Matthew Bayly: MJBA, Core application development. - Alexandra Tekatch: ESSA, Core application development. - Jordan Rosenfeld: Project design and coordination; ECCS Aquatic Ecologist - Lauren Jarvis: Collaborator; AEP Research Scientist - Andrew Paul: Collaborator; AEP Research Scientist - Eva Enders: Project Lead; DFO Research Scientist - Kyle Wilson: Population model development. - Isuru Dharmasena: Core Shiny app development (https://github.com/julianheavyside) from ESSA Technologies Ltd: R package and Shiny app development support. - Alejandra Urcelay - Pedro Gonzalez - Marc Porter - Julian Heavyside

Installation

The easiest way to install the CEMPRA package is from within the RStudio IDE using remotes::install_github(). At this time the package has not been published to CRAN so the default install.packages() will not work. Instead use remotes (or devtools) to install the packge directly from GitHub:

# You may need to install remotes
library(remotes)
remotes::install_github("essatech/CEMPRA")

Usage

There are several vignettes available that provide detailed guidance for CEMPRA usage and common workflows. See articles availabe in the guidance document CEMPRA project page:

Code of Conduct

Please note that the CEMPRA package is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

Contributing

If you want to contribute to the project you can use the git “fork and pull request” workflow.

Rebuilding R-package locally

Helpful commands to run to reploy package locally

# Build and test package
library(testthat)
library(devtools)
rm(list = ls())      # Clear memory
devtools::load_all() # Load functions
devtools::document() # Update documentation
devtools::test()     # Run tests
devtools::check()    # Operating system test

Re-install R-package locally

Helpful commands to install package from source

remove.packages("CEMPRA") # Remove local installation
install.packages(getwd(), repos = NULL, type = "source")
# library(CEMPRA)
# ?SystemCapacity