TrenchR: an R package for transparent environmental and ecological biophysics
Author: TrEnCh project, Buckley Lab, Department of Biology, University of Washington
Description
The TrenchR package aids in Translating Environmental Change into organismal responses. The package facilitates microclimate modeling to translate weather station data into the environmental conditions experienced by organisms and biophysical modeling to predict organismal body temperatures given the environmental conditions. The package aims to introduce and enable microclimate and biophysical modeling to improve ecological and evolutionary forecasting and includes tutorials and well as a series of educational modules introducing microclimate and biophysical modeling. The package focuses on transparent and modular functions but also includes some biophysical models for particular organisms. The package complements and integrates with the NicheMapR package, which contains more complex functions that are generally not intended for modular use.
Installation
You can install the TrenchR package from CRAN:
install.packages("TrenchR") The latest version of the package can be installed from the github repository:
install.packages("devtools")
devtools::install_github("trenchproject/TrenchR")Using the package
The package encompasses simple functions that can be combined to estimate environmental conditions and their impacts on organisms. Many of the functions are adapted from biophysical ecology texts including the following:
- Gates DM. 1980. Biophysical Ecology.
- Campbell GS and Norman JM. 2000. An introduction to environmental biophysics.
Package Vignettes
We introduce functions in categorically grouped tutorials. A good place to start is the Allometry and conversions tutorial, which provides tools for preparing data such as estimating additional dimensions of organisms from measured dimensions.
vignette("AllometryAndConversionsTutorial.Rmd", package = "TrenchR")
The Estimating microclimates tutorial provides resources for estimating the environmental conditions experienced by organisms. This includes estimating solar radiation and its components, diurnal variation in temperature and radiation, temperature and wind speed profiles, and soil temperatures and profiles.
vignette("MicroclimateTutorial", package = "TrenchR")
Finally, the core biophysical modeling functions are described in a tutorial on Using energy balances to estimate body temperatures. Components of an energy budget can be estimated using individual functions and then operative environmental temperatures, Te, can be solved for using either a generic energy balance or taxa specific biophysical models.
vignette("TeTutorial", package = "TrenchR")
Future Directions
We welcome code contributions, fixes, and comments. Code (scripts and functions) will be accepted in any programming language and thorough commenting will be appreciated. We would also appreciate your including a header that describes the intent, input, and output of your scripts and functions.
Citation
If you use this package, We would appreciate a citation. You can see an up to date citation information with citation("TrenchR"). You can cite either the package or the accompanying journal article.
Developer notes
Please see the Contributor Notes and Code of Conduct.
We use Rdpack to facilitate package documentation with BibTeX citations. See the documentation workflow document for more details about building package manual components.