RavenR is an R package for handling Raven hydrologic modelling framework
inputs, outputs, and diagnostics.
The CRAN version of the package may also installed with:
install.packages("RavenR")You can also install the latest RavenR version from github with:
if (!require(devtools)) install.packages("devtools")
library(devtools)
devtools::install_github("rchlumsk/RavenR")Please see the package vignette for an overview of the RavenR package.
Sample data is included in the package, so you need only
to install the RavenR library and follow along in the guide documents to
get started.
The RavenR vignette can be accessed with the browseVignettes function.
browseVignettes("RavenR")citation("RavenR")
To cite RavenR in publications, use:
Robert Chlumsky, James Craig, Leland Scantlebury, Simon Lin, Sarah Grass, Genevieve Brown and Rezgar Arabzadeh (2021). RavenR: Raven Hydrological Modelling Framework R Support and Analysis. R package version 2.1.4. https://github.com/rchlumsk/RavenR
A BibTeX entry for LaTeX users is:
@Manual{RavenRPackage,
title = {RavenR: Raven Hydrological Modelling Framework R Support and Analysis},
author = {Robert Chlumsky and James Craig and Leland Scantlebury and Simon Lin and Sarah Grass and Genevieve Brown and Rezgar Arabzadeh},
year = {2021},
note = {R package version 2.1.4},
url = {https://github.com/rchlumsk/RavenR},
}
Any issues or feature requests can be submitted on the Github Issues page as an issue, or discussed more openly on the new Github Discussions page.
Updates to a number of functions and new features implemented, including:
- removal of all dependencies on spatial packages (e.g. sf, raster), and removal of the netcdf-related functions;
rvn_downloadandrvn_runto enable downloading and running Raven.exe within R;rvn_rvi_write_templateto write model rvi files from templates in the Raven manual;rvn_budyko_plotto generate a budyko curve from model precip, AET, and PET;- updates to rvi mapping, including improvements to add functionality from
ggrepellibrary in spacing labels, and addition of theDiagrammeRlibrary to supportrvn_rvi_process_diagrammer; rvn_budyko_plotto generate a budyko curve from model precip, AET, and PET;- updates to handling rvt reading and writing, which is now generic for all rvt types; and
rvn_met_interpolatefor performing inverse distance weighting interpolation to fill missing data values in meteorological data (works immediately withweathercandownloads).
Major updates to the package, including core package styling such as function case, naming conventions, and use of ggplot2 libraries for plotting. Some of these include:
- all core RavenR functions have an ‘rvn_’ prefix to specify the package origin;
- functions and input/output variables now use an underscore naming convention, rather than periods or camelCase;
- ggplot2 is now the default plotting library for plotting functions, and some plotting arguments have been reduced, as ggplot objects may be modified in post-production by the user;
- many new functions added;
- new sample data sets and examples, including tidying of all function examples and addition of netcdf files to test netcdf-related functions; and
- multiple bug fixes and improvements to handling rvi, rvh, and writing rvt files.
-
RavenR.extras: Additional RavenR utilities.
-
Raven Hydrologic Modelling Framework: Robust and flexible Hydrologic Modelling Framework developd by Dr. James R. Craig at the University of Waterloo.
