airGRteaching.Rd 5.35 KB
Newer Older
1
2
3
4
5
6
7
8
9
\name{airGRteaching}
\alias{airGRteaching}
\docType{package}
\encoding{UTF-8}

\title{Tools to Simplify the Use of the airGR Hydrological Package for Education (Including a Shiny Application)}

\description{
airGRteaching is an add-on package to the airGR package that simplifies its use and is teaching-oriented.
10
It allows to use with very low programming skills the rainfall-runoff models (GR4H, 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.
11
\cr\cr
12

13
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. 
14
15

The package is mostly based on three families of functions: \cr
16
17
18
- the functions that allow to complete very simply a hydrological modelling exercise; \cr
- plotting functions to help students to explore observed data and to interpret the results of calibration and simulation of the GR models; \cr
- a function which runs a shiny graphical interface that allows for displaying in real-time model parameters impacts on hydrographs.
19
\cr\cr
20
21


22
23
24
25
26
27
28
# --- Modelling Functions
Three functions allow to complete very simply a hydrological modelling exercise:
- preparation of data: \code{\link{ObsGR}()}; \cr
- calibration of the models: \code{\link{CalGR}()}; \cr
- simulation with the models: \code{\link{SimGR}()}); \cr


29
30
# --- Plotting Functions

31
airGRteaching provides two types of plotting functions that allow to produce static (\code{plot}()) or dynamic (\code{\link{dyplot}()}) graphics (mouse events and interactive graphics).
32
33
34
35
36
37
The devices allow to explore observed data and to interpret the results of calibration and simulation of the GR models.
\cr\cr


# --- Shiny interface

38
39
40
41
The package also provides the \code{\link{ShinyGR}()}) function, which allows to run a Shiny interface. Thus its is possible to run: \cr
- interactive flow simulation with parameters modifications; \cr
- automatic calibration; \cr
- internal variables evolution, \cr
42
43
44
- time period selection.
\cr\cr

45
46
47

# --- Models

48
The six hydrological models and the snow melt and accumulation module available in airGR are implemented in airGRteaching. \cr
49
50
51
52
53
54
These models can be called within airGRteaching using the following functions: \cr 
- \code{GR4H}: four-parameter hourly lumped hydrological model (Mathevet, 2005) \cr
- \code{GR4J}*: four-parameter daily lumped hydrological model (Perrin et al., 2003) \cr
- \code{GR5J}*: five-parameter daily lumped hydrological model (Le Moine, 2008) \cr
- \code{GR6J}*: six-parameter daily lumped hydrological model (Pushpalatha et al., 2011) \cr
- \code{GR2M}: two-parameter monthly lumped hydrological model (Mouelhi, 2003 ; Mouelhi et al., 2006a) \cr
55
56
57
- \code{GR1A}: one-parameter annual lumped hydrological model (Mouelhi, 2003 ; Mouelhi et al., 2006b) \cr
- \code{CemaNeige}: two-parameter degree-day snow melt and accumulation daily model (alone or combined with GR4J, GR5J or GR6J) (Valéry et al., 2014) \cr
*: available in the shiny interface.
58
\cr\cr
59
60
61
62


# --- References

63
- Coron, L., G. Thirel, O. Delaigue, C. Perrin and V. Andréassian (2017), The Suite of Lumped GR Hydrological Models in an R Package. Environmental Modelling and Software, 94, 166–171. doi: 10.1016/j.envsoft.2017.05.002. \cr
64
65
66
67
68
69
70
- Le Moine, N. (2008), Le bassin versant de surface vu par le souterrain : une voie d'amélioration des performances et du réalisme des modèles pluie-débit ?, PhD thesis (in French), UPMC - Cemagref Antony, Paris, France, 324 pp. \cr
- Mathevet, T. (2005), Quels modèles pluie-débit globaux pour le pas de temps horaire ? Développement empirique et comparaison de modèles sur un large échantillon de bassins versants, PhD thesis (in French), ENGREF - Cemagref Antony, Paris, France, 463 pp. \cr
- Mouelhi S. (2003), Vers une chaîne cohérente de modèles pluie-débit conceptuels globaux aux pas de temps pluriannuel, annuel, mensuel et journalier, PhD thesis (in French), ENGREF - Cemagref Antony, Paris, France, 323 pp. \cr
- Mouelhi, S., C. Michel, C. Perrin and V. Andréassian (2006a), Stepwise development of a two-parameter monthly water balance model, Journal of Hydrology, 318(1-4), 200-214, doi:10.1016/j.jhydrol.2005.06.014. \cr
- Mouelhi, S., C. Michel, C. Perrin. & V. Andreassian (2006b), Linking stream flow to rainfall at the annual time step: the Manabe bucket model revisited, Journal of Hydrology, 328, 283-296, doi:10.1016/j.jhydrol.2005.12.022. \cr
- Perrin, C., C. Michel and V. Andréassian (2003), Improvement of a parsimonious model for streamflow simulation, Journal of Hydrology, 279(1-4), 275-289, doi:10.1016/S0022-1694(03)00225-7. \cr
- Pushpalatha, R., C. Perrin, N. Le Moine, T. Mathevet and V. Andréassian (2011), A downward structural sensitivity analysis of hydrological models to improve low-flow simulation, Journal of Hydrology, 411(1-2), 66-76, doi:10.1016/j.jhydrol.2011.09.034. \cr
71
- Valéry, A., V. Andréassian and C. Perrin (2014), "As simple as possible but not simpler": What is useful in a temperature-based snow-accounting routine? Part 2 - Sensitivity analysis of the Cemaneige snow accounting routine on 380 catchments, Journal of Hydrology, 517(0): 1176-1187, doi:10.1016/j.jhydrol.2014.04.058. \cr
72
73
74

}

75
\keyword{hydrology, model, efficiency criterion, calibration, GR4J, airGR, student, teaching, shiny}