Package Package airGR airGR License License GPL 2 GPL 2

1 What is the airGR package?

1.1 Presentation

airGR logo

airGR is a package which brings into the R software the hydrological modelling tools used and developed at the Catchment Hydrology Research Group of Irstea (France), including the GR rainfall-runoff models and a snowmelt and accumulation model, CemaNeige. Each model core is coded in Fortran to ensure low computational time. The other package functions (i.e. mainly the calibration algorithm and the efficiency criteria calculation) are coded in R.

The airGR package has been designed to fulfill two major requirements: to facilitate the use by non-expert users and to allow flexibility regarding the addition of external criteria, models or calibration algorithms. The names of the functions and their arguments were chosen to this end. airGR also contains basics plotting facilities.

1.2 The airGR hydrological models

Six hydrological models and one snowmelt and accumulation model are implemented in airGR. The snow model can be used alone or together with the daily hydrological models.

The models can be called within airGR using the following functions:

  • RunModel_GR4H(): four-parameter hourly lumped hydrological model (Mathevet 2005)
  • RunModel_GR4J(): four-parameter daily lumped hydrological model (Perrin, Michel, and Andréassian 2003)
  • RunModel_GR5J(): five-parameter daily lumped hydrological model (Le Moine 2008)
  • RunModel_GR6J(): six-parameter daily lumped hydrological model (Pushpalatha et al. 2011)
  • RunModel_GR2M(): two-parameter monthly lumped hydrological model (Mouelhi 2003; Mouelhi et al. 2006a)
  • RunModel_GR1A(): one-parameter yearly lumped hydrological model (Mouelhi 2003; Mouelhi et al. 2006b)
  • RunModel_CemaNeige(): two-parameter degree-day snowmelt and accumulation model (Valéry, Andréassian, and Perrin 2014)
  • RunModel_CemaNeigeGR4J(): combined use of GR4J and CemaNeige
  • RunModel_CemaNeigeGR5J(): combined use of GR5J and CemaNeige
  • RunModel_CemaNeigeGR6J(): combined use of GR6J and CemaNeige

The GRP forecasting model and the Otamin predictive uncertainty tool are not available in airGR.

2 Installation

You can install the package with the following command:

If you use RStudio, you can use the Packages interface :

You can download the airGR source, Windows binaries or Mac OS X binaries on the CRAN.

3 Misc

3.1 How to cite the packages

To cite the package in your scientific document, please use the references returned by the citation() function:


To cite airGR in publications use these two references:

  Coron, L., Thirel, G., Delaigue, O., Perrin, C. and Andréassian, V. (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.

  Coron, L., Delaigue, O., Thirel, G., Perrin, C. and Michel, C. (2019). airGR: Suite of GR
  Hydrological Models for Precipitation-Runoff Modelling. R package version 1.3.2.23. URL:
  https://CRAN.R-project.org/package=airGR.

To see these entries in BibTeX format, use 'print(<citation>, bibtex=TRUE)', 'toBibtex(.)', or set
'options(citation.bibtex.max=999)'.

To retrieve a “.bib” format for LaTeX documents, you can use the following command:

@Article{,
  title = {The Suite of Lumped {GR} Hydrological Models in an {R} package},
  author = {L. Coron and G. Thirel and O. Delaigue and C. Perrin and V. Andréassian},
  journal = {Environmental Modelling and Software},
  year = {2017},
  pages = {166-171},
  volume = {94},
  doi = {10.1016/j.envsoft.2017.05.002},
}

@Manual{,
  title = {{airGR}: Suite of {GR} Hydrological Models for Precipitation-Runoff Modelling},
  author = {L. Coron and O. Delaigue and G. Thirel and C. Perrin and C. Michel},
  journal = {R News},
  year = {2019},
  note = {R package version 1.3.2.23},
  url = {https://CRAN.R-project.org/package=airGR},
}

3.2 Known places where airGR is used