'airGRteaching' is an add-on package to the airGR package that simplifies its use and is teaching-oriented. It allows to use with very low programming skills the rainfall-runoff models (GR4H, GR5H, GR4J, GR5J, GR6J, GR2M, GR1A) and a snow melt and accumulation model (CemaNeige). This package also provides graphical devices to help students to explore data and modelling results.
The 'airGRteaching' package has been designed to fulfil a major requirement: facilitating the use of the airGR functionalities by students. The names of the functions and their arguments were chosen to this end.
The package is mostly based on three families of functions:
This package brings into R the hydrological modelling tools developed at INRAE-Antony (Catchment Hydrology research group of the HYCAR Research Unit, France).
To install the version of the package that is on the CRAN, you just have to use the following command line:
install.packages("airGRteaching")
To use the development version of the package that is on GitLab, you have first install the 'remotes' package. Then you can install the 'airGRteaching' package in the R environment:
install.packages("remotes")
remotes::install_gitlab(repo = "HYCAR-Hydro/airgrteaching",
host = "https://gitlab.irstea.fr",
dependencies = TRUE,
build_vignettes = TRUE)
Three functions allow to complete very simply a hydrological modelling exercise:
PrepGR()
;CalGR()
;SimGR()
.'airGRteaching' provides two types of plotting functions that allow to produce static (plot()
) or dynamic (dyplot()
) graphics (incl. mouse events and interactive graphics).
The devices allow to explore observed data and to interpret the results of calibration and simulation of the GR models.
The package also provides the ShinyGR()
function, which allows to launch a Shiny interface. Thus its is possible to perform:
A demonstrator of the graphical user interface is available for free online on the Sunshine platform.
The six hydrological models and the snow melt and accumulation model already available in airGR are available in 'airGRteaching'. These models can be called in 'airGRteaching' using the following model names (*: available in the Shiny interface):
GR4H
: four-parameter hourly lumped hydrological model (Mathevet, 2005)GR5H
: five-parameter hourly lumped hydrological model (Ficchi, 2017; Ficchi et al., 2019)GR4J
*: four-parameter daily lumped hydrological model (Perrin et al., 2003)GR5J
*: five-parameter daily lumped hydrological model (Le Moine, 2008)GR6J
*: six-parameter daily lumped hydrological model (Pushpalatha et al., 2011)GR2M
*: two-parameter monthly lumped hydrological model (Mouelhi, 2003; Mouelhi et al., 2006a)GR1A
: one-parameter annual lumped hydrological model (Mouelhi, 2003; Mouelhi et al., 2006b)CemaNeige
: two-parameter degree-day snow melt and accumulation daily model (combined with GR4H, GR5H, GR4J, GR5J or GR6J) (Valéry et al., 2014)For more information and to get started with the package, you can refer to the vignette (vignette("get_started", package = "airGRteaching")
) and go on the 'airGRteaching' website.
Any scripts or data that you put into this service are public.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.