airGR.Rd 7.13 KB
 Delaigue Olivier committed Oct 28, 2015 1 2 3 4 \name{airGR} \alias{airGR} \docType{package} \encoding{UTF-8}  unknown committed Jan 23, 2017 5 \title{Suite of GR Hydrological Models for Precipitation-Runoff Modelling}  Delaigue Olivier committed Oct 28, 2015 6 \description{  Delaigue Olivier committed Apr 01, 2019 7 This package brings into R the hydrological modelling tools used at IRSTEA-Antony (HYCAR Research Unit, France), including rainfall-runoff models (\strong{GR4H}, \strong{GR4J}, \strong{GR5J}, \strong{GR6J}, \strong{GR2M}, \strong{GR1A}) and a snow accumulation and melt model (\strong{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 computation of the efficiency criteria) are coded in R. \cr\cr  Delaigue Olivier committed Apr 14, 2016 8   Delaigue Olivier committed Oct 28, 2015 9   Delaigue Olivier committed Apr 01, 2019 10 ## ---- Functions and objects  Delaigue Olivier committed Oct 28, 2015 11 12 13 14 15 16 17 18  The airGR package has been designed to fulfil two major requirements: facilitate the use by non-expert users and 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. The package is mostly based on three families of functions: \cr - the functions belonging to the \code{\link{RunModel}} family require three arguments: \emph{InputsModel}, \emph{RunOptions} and \emph{Param}; please refer to help pages \code{\link{CreateInputsModel}} and \code{\link{CreateRunOptions}} for further details and examples; \cr - the functions belonging to the \code{\link{ErrorCrit}} family require two arguments: \emph{InputsCrit} and \emph{OutputsModel}; please refer to help pages \code{\link{CreateInputsCrit}} and \code{\link{RunModel}} for further details and examples; \cr - the functions belonging to the \code{\link{Calibration}} family require four arguments: \emph{InputsModel}, \emph{RunOptions}, \emph{InputsCrit} and \emph{CalibOptions}; please refer to help pages \code{\link{CreateInputsModel}}, \code{\link{CreateRunOptions}}, \code{\link{CreateInputsCrit}} and \code{\link{CreateCalibOptions}} for further details and examples.  Delaigue Olivier committed Apr 01, 2019 19 In order to limit the risk of mis-use and increase the flexibility of these main functions, we imposed the structure of their arguments and defined their class. Most users will not need to worry about these imposed structures since functions are provided to prepare these arguments for them: \code{\link{CreateInputsModel}}, \code{\link{CreateRunOptions}}, \code{\link{CreateInputsCrit}}, \code{\link{CreateCalibOptions}}. However, advanced users wishing to supplement the package with their own models will need to comply with these imposed structures and refer to the package source codes to get all the specification requirements. \cr\cr  Delaigue Olivier committed Oct 28, 2015 20   Delaigue Olivier committed Apr 14, 2016 21   Delaigue Olivier committed Apr 01, 2019 22 ## ---- Models  Delaigue Olivier committed Oct 28, 2015 23   unknown committed Sep 05, 2017 24 Six hydrological models and one snow melt and accumulation model are implemented in airGR. The snow model can also be used alone or with the daily hydrological models, and each hydrological model can either be used alone or together with the snow model. \cr  Delaigue Olivier committed Oct 28, 2015 25 These models can be called within airGR using the following functions: \cr  Delaigue Olivier committed Apr 01, 2019 26 27 28 29 30 31 32  - \code{\link{RunModel_GR4H}}: four-parameter hourly lumped hydrological model (Mathevet, 2005) \cr - \code{\link{RunModel_GR4J}}: four-parameter daily lumped hydrological model (Perrin \emph{et al.}, 2003) \cr - \code{\link{RunModel_GR5J}}: five-parameter daily lumped hydrological model (Le Moine, 2008) \cr - \code{\link{RunModel_GR6J}}: six-parameter daily lumped hydrological model (Pushpalatha \emph{et al.}, 2011) \cr - \code{\link{RunModel_GR2M}}: two-parameter monthly lumped hydrological model (Mouelhi, 2003 ; Mouelhi \emph{et al.}, 2006a) \cr - \code{\link{RunModel_GR1A}}: one-parameter yearly lumped hydrological model (Mouelhi, 2003 ; Mouelhi \emph{et al.}, 2006b) \cr - \code{\link{RunModel_CemaNeige}}: two-parameter degree-day snow melt and accumulation daily model (Valéry \emph{et al.}, 2014) \cr  33  - \code{\link{RunModel_CemaNeigeGR4H}}: combined use of GR4H and CemaNeige \cr  Delaigue Olivier committed Apr 01, 2019 34 35 36  - \code{\link{RunModel_CemaNeigeGR4J}}: combined use of GR4J and CemaNeige \cr - \code{\link{RunModel_CemaNeigeGR5J}}: combined use of GR5J and CemaNeige \cr - \code{\link{RunModel_CemaNeigeGR6J}}: combined use of GR6J and CemaNeige \cr\cr  Delaigue Olivier committed Apr 14, 2016 37   Delaigue Olivier committed Oct 28, 2015 38   Delaigue Olivier committed Apr 01, 2019 39 ## ---- How to get started  Delaigue Olivier committed Oct 28, 2015 40 41  To learn how to use the functions from the airGR package, it is recommended to follow the five steps described below: \cr  Delaigue Olivier committed Apr 01, 2019 42 43 44 45 46  1. refer to the help for \code{\link{RunModel_GR4J}} then run the provided example to assess how to make a simulation; \cr 2. refer to the help for \code{\link{CreateInputsModel}} to understand how the inputs of a model are prepared/organised; \cr 3. refer to the help for \code{\link{CreateRunOptions}} to understand how the run options of a model are parametrised/organised; \cr 4. refer to the help for \code{\link{ErrorCrit_NSE}} and \code{\link{CreateInputsCrit}} to understand how the computation of an error criterion is prepared/made; \cr 5. refer to the help for \code{\link{Calibration_Michel}}, run the provided example and then refer to the help for \code{\link{CreateCalibOptions}} to understand how a model calibration is prepared/made. \cr  Delaigue Olivier committed Apr 14, 2016 47   Delaigue Olivier committed Apr 01, 2019 48 For more information and to get started with the package, you can refer to the vignette (\code{vignette("airGR")}) and go on the \href{https://hydrogr.github.io/airGR/}{airGR website}. \cr\cr  Delaigue Olivier committed Oct 28, 2015 49   Delaigue Olivier committed Apr 01, 2019 50 51  ## ---- References  Delaigue Olivier committed Oct 28, 2015 52   unknown committed Jun 13, 2017 53 54 55 56 57 58 59 60 - 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 - 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: 1176-1187, doi:10.1016/j.jhydrol.2014.04.058. \cr  Delaigue Olivier committed Oct 28, 2015 61 62 63  }  Delaigue Olivier committed Jun 19, 2019 64 65 66 67 68 \concept{hydrology} \concept{model} \concept{efficiency criterion} \concept{calibration} \concept{GR4J}