trps trps website

Lifecycle: stableCRAN statustrps status badgeR-CMD-checkCodecov test coverage

Bayesian trophic position models using stan (pronounced trips) by leveraging {brms}. Equations for trophic position models are derived from Post (2002), Vander Zanden and Vadeboncoeur (2002), and Heuvel et al. (2024) and are to be used with stable isotope data.

Trophic Models in {trps}

Currently {trps} supports the following models:

  1. One Source Model - one_source_model()

  2. Two Source Model - two_source_model()

  3. Two Source Model - \(\alpha\) corrected (\(\alpha_r\)) - two_source_model_ar()

  4. Two Source Model - \(\alpha\) corrected (\(\alpha_r\)) - carbon mixing model - two_source_model_arc()

Installation

You can install the R-Universe version of {trps} using the following:

install.packages("trps", 
                  repos = c("https://benjaminhlina.r-universe.dev",
                            "https://cloud.r-project.org"))

You can install the development version of {trps} using the following:

devtools::install_github("benjaminhlina/trps")

To view the overall progress of the package please see news.

Vignettes

Introduction

I highly suggest going through the vignettes as they will walk you through how to use each trophic position model using {trps} and {brms}. The first vignette to walk through is getting started with trps. This vignette will introduce you to {trps} and how to estimate trophic position using a one source model. You can access the vignette by visiting the get started page on the website or by using the following code.

vignette("trps")

Please go through getting started with trps prior to walking through the other vignettes.

Supplementary Vignettes

  1. The next vignette will walk you through how to apply {trps} with iterative processes. This vignette is titled Estimate Trophic Position - One Source Model - Multiple Groups.

  2. The third vignette to walk through is Estimating Trophic Postion - Two Source Model. which will demonstrate how to estimate trophic position using a two source model.

  3. The last vignette to walk through is Estimating Trophic Postion - Two Source Model - ar. This vignette will guide you through estimating trophic position using a two source model using an equation based on Heuvel et al. (2024) that corrects (i.e., scales) \(\alpha\) (\(\alpha_r\)).

Citations

To cite this package please cite the following publications