README

RavenR

RavenR is an R package for handling Raven hydrologic modelling framework inputs, outputs, and diagnostics.

Installation

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")

The developmental version can be installed from the dev branch with:

if (!require(devtools)) install.packages("devtools")
library(devtools)
devtools::install_github("rchlumsk/RavenR", ref="dev")

Tutorials and Quick Start Guide

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

citation("RavenR")

To cite RavenR in publications, use:

Robert Chlumsky, James Craig, Leland Scantlebury, Simon Lin, Sarah Grass, Genevieve Brown and Rezgar Arabzadeh (2022). RavenR: Raven Hydrological Modelling Framework R Support and Analysis. R package version 2.1.7. 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 = {2022},
note = {R package version 2.1.7},
url = {https://github.com/rchlumsk/RavenR},
}

RavenR Wishlist

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.

Version Update Notes

2.1.7

Minor updates and bug fixes, including:

• added new functions including rvn_rvp_fill_template for filling in rvp template files, rvn_met_recordplot to show station record lenghts;
• added function for plotting subbasin network with interactive visNetwork library
• updated rvn_run with additional options, including adding rvi commands to the file before execution;
  
• added new model templates from Raven Manual v3.5 to rvn_rvi_write_template;
• enhancements to rvn_rvh_read for splitting subbasin and HRU information in separate files, other minor improvements; and
• bug fix in rvn_rvt_write for writing initial start date with correct month code;

2.1.4

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_download and rvn_run to enable downloading and running Raven.exe within R;
  
• rvn_rvi_write_template to write model rvi files from templates in the Raven manual;
• rvn_budyko_plot to generate a budyko curve from model precip, AET, and PET;
• updates to rvi mapping, including improvements to add functionality from ggrepel library in spacing labels, and addition of the DiagrammeR library to support rvn_rvi_process_diagrammer;
• rvn_budyko_plot to 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_interpolate for performing inverse distance weighting interpolation to fill missing data values in meteorological data (works immediately with weathercan downloads).

2.0.0

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.

See Also

• 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.