diff --git a/DESCRIPTION b/DESCRIPTION index ad168ee913c01e53aed40887da3eb00ea5c22251..5070970e6192818a80efe57112a3936f0b1aa131 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,7 +1,7 @@ Package: airGR Type: Package Title: Suite of GR Hydrological Models for Precipitation-Runoff Modelling -Version: 1.0.9.1 +Version: 1.0.9.2 Date: 2017-06-22 Authors@R: c( person("Laurent", "Coron", role = c("aut", "trl")), diff --git a/man/CreateIniStates.Rd b/man/CreateIniStates.Rd index efb91556b576236397e01bcf90f1530a60771723..f1426e764f4c782f50bcf1d8b24df4aa03328571 100644 --- a/man/CreateIniStates.Rd +++ b/man/CreateIniStates.Rd @@ -5,7 +5,7 @@ \alias{CreateIniStates} -\title{Creation of the IniStates object possible required to the CreateRunOptions functions} +\title{Creation of the IniStates object possibly required by the CreateRunOptions functions} \usage{ @@ -20,21 +20,21 @@ CreateIniStates(FUN_MOD, InputsModel, \arguments{ \item{FUN_MOD}{[function] hydrological model function (e.g. RunModel_GR4J, RunModel_CemaNeigeGR4J)} -\item{InputsModel}{[object of class \emph{InputsModel}] see \code{\link{CreateInputsModel}} for details} +\item{InputsModel}{[object of class \code{InputsModel}] see \code{\link{CreateInputsModel}} for details} -\item{ProdStore}{[numeric]} +\item{ProdStore}{[numeric] production store level [mm]} -\item{RoutStore}{[numeric]} +\item{RoutStore}{[numeric] routing store level [mm]} -\item{ExpStore}{[numeric]} +\item{ExpStore}{(optional) [numeric] series of exponential store level (negative) [mm] for the GR6J model} -\item{UH1}{[numeric]} +\item{UH1}{(optional) [numeric] unit hydrograph 1 levels [mm]} -\item{UH2}{[numeric]} +\item{UH2}{(optional) [numeric] unit hydrograph 2 levels [mm]} -\item{GCemaNeigeLayers}{[numeric]} +\item{GCemaNeigeLayers}{(optional) [numeric] snow pack [mm], possibly used to create the CemaNeige model initial state} -\item{eTGCemaNeigeLayers}{[numeric]} +\item{eTGCemaNeigeLayers}{(optional) [numeric] snow pack thermal state [°C], possibly used to create the CemaNeige model initial state} \item{verbose}{(optional) [boolean] boolean indicating if the function is run in verbose mode or not, \code{default = TRUE}} @@ -42,21 +42,26 @@ CreateIniStates(FUN_MOD, InputsModel, \value{ -[list] object of class \emph{IniStates} containing the initial model internal states; it includes the following: - \itemize{ - \item{Store }{} - \item{UH }{} - \item{CemaNeigeLayers}{} +[list] object of class \code{IniStates} containing the initial model internal states; it includes the following: + \tabular{ll}{ + \emph{$Store } \tab [numeric] list of store levels (always \emph{$Prod}, \emph{$Rout} and \emph{$Exp}) \cr + \emph{$UH } \tab [numeric] list of unit hydrographs levels (always \emph{$UH1} and \emph{$UH2} \cr + \emph{$CemaNeigeLayers} \tab [numeric] list of CemaNeige variables (always \emph{$G} and \emph{$eTG}) } } \description{ -Creation of the IniStates object required to XXXX +Creation of the IniStates object possibly required by the CreateRunOptions functions } \details{ -XXXX +20 floats are required for UH1 and 40 floats are required for UH2 (repectivly 20*24 and 40*24 for the daily model GR4H). \cr +NLayers floats are required for GCemaNeigeLayers and eTGCemaNeigeLayers. \cr +The structure of the object of class \code{IniStates} returned is always the exactly same for all models(except for the unit hydrographs more longer with GR4H), even some states don't exist (e.g. \emph{$UH$UH1} for GR2M). \cr +If CemaNeige is not used , \emph{$CemaNeigeLayers$G} and \emph{$CemaNeigeLayers$eTG} are set to \code{NA}. \cr + +Nota: the \code{StateEnd} objects from the outputs of \code{RunModel*} functions already respect the format given by the \code{CreateIniStates} function. } diff --git a/man/RunModel_CemaNeige.Rd b/man/RunModel_CemaNeige.Rd index 33507b4c201e77edfb9e5a2b82ca71ff193e8aed..f77a57944803eba28683f2f41466d75dad11581e 100644 --- a/man/RunModel_CemaNeige.Rd +++ b/man/RunModel_CemaNeige.Rd @@ -30,7 +30,7 @@ CemaNeige X2 \tab degree-day melt coefficient [mm/°C/d] \ \emph{$CemaNeigeLayers[[iLayer]]$Melt } \tab [numeric] series of actual snow melt [mm] \cr \emph{$CemaNeigeLayers[[iLayer]]$PliqAndMelt } \tab [numeric] series of liquid precip. + actual snow melt [mm] \cr \emph{$CemaNeigeLayers[[iLayer]]$Temp } \tab [numeric] series of air temperature [°C] \cr - \emph{$StateEnd} \tab [numeric] states at the end of the run: CemaNeige states [mm & °C] \cr + \emph{$StateEnd} \tab [numeric] states at the end of the run: CemaNeige states [mm & °C], \cr\tab see \code{\link{CreateIniStates}} for more details \cr } (refer to the provided references or to the package source code for further details on these model outputs) } diff --git a/man/RunModel_CemaNeigeGR4J.Rd b/man/RunModel_CemaNeigeGR4J.Rd index 38bbb8518a9cee18c43330341a96411deccf89a8..63993f9eeb2f48687b9658eca26e32defa39ba8e 100644 --- a/man/RunModel_CemaNeigeGR4J.Rd +++ b/man/RunModel_CemaNeigeGR4J.Rd @@ -52,7 +52,7 @@ CemaNeige X2 \tab degree-day melt coefficient [mm/°C/d] \ \emph{$CemaNeigeLayers[[iLayer]]$Melt } \tab [numeric] series of actual snow melt [mm/d] \cr \emph{$CemaNeigeLayers[[iLayer]]$PliqAndMelt } \tab [numeric] series of liquid precip. + actual snow melt [mm/d] \cr \emph{$CemaNeigeLayers[[iLayer]]$Temp } \tab [numeric] series of air temperature [°C] \cr - \emph{$StateEnd} \tab [numeric] states at the end of the run: \cr\tab store & unit hydrographs levels [mm], CemaNeige states [mm & °C] \cr + \emph{$StateEnd} \tab [numeric] states at the end of the run: \cr\tab store & unit hydrographs levels [mm], CemaNeige states [mm & °C], \cr\tab see \code{\link{CreateIniStates}} for more details \cr } (refer to the provided references or to the package source code for further details on these model outputs) } diff --git a/man/RunModel_CemaNeigeGR5J.Rd b/man/RunModel_CemaNeigeGR5J.Rd index 01c53c7eb7fcab2104541e70c5e4151c506d70bd..6ccb4e2d38a0e546a96a34e71ba8abd39ff020c3 100644 --- a/man/RunModel_CemaNeigeGR5J.Rd +++ b/man/RunModel_CemaNeigeGR5J.Rd @@ -53,7 +53,7 @@ CemaNeige X2 \tab degree-day melt coefficient [mm/°C/d] \ \emph{$CemaNeigeLayers[[iLayer]]$Melt } \tab [numeric] series of actual snow melt [mm/d] \cr \emph{$CemaNeigeLayers[[iLayer]]$PliqAndMelt } \tab [numeric] series of liquid precip. + actual snow melt [mm/d] \cr \emph{$CemaNeigeLayers[[iLayer]]$Temp } \tab [numeric] series of air temperature [°C] \cr - \emph{$StateEnd} \tab [numeric] states at the end of the run: \cr\tab store & unit hydrographs levels [mm], CemaNeige states [mm & °C] \cr + \emph{$StateEnd} \tab [numeric] states at the end of the run: \cr\tab store & unit hydrographs levels [mm], CemaNeige states [mm & °C], \cr\tab see \code{\link{CreateIniStates}} for more details \cr } (refer to the provided references or to the package source code for further details on these model outputs) } diff --git a/man/RunModel_CemaNeigeGR6J.Rd b/man/RunModel_CemaNeigeGR6J.Rd index 77044b7eb25ebab34eaae9c84605aa60b7cf68b9..19ec23fcfbd7e581c3ec47ffa7ebc3dc1d41b2d0 100644 --- a/man/RunModel_CemaNeigeGR6J.Rd +++ b/man/RunModel_CemaNeigeGR6J.Rd @@ -56,7 +56,7 @@ CemaNeige X2 \tab degree-day melt coefficient [mm/°C/d] \ \emph{$CemaNeigeLayers[[iLayer]]$Melt } \tab [numeric] series of actual snow melt [mm/d] \cr \emph{$CemaNeigeLayers[[iLayer]]$PliqAndMelt } \tab [numeric] series of liquid precip. + actual snow melt [mm/d] \cr \emph{$CemaNeigeLayers[[iLayer]]$Temp } \tab [numeric] series of air temperature [°C] \cr - \emph{$StateEnd} \tab [numeric] states at the end of the run: \cr\tab store & unit hydrographs levels [mm], CemaNeige states [mm & °C] \cr + \emph{$StateEnd} \tab [numeric] states at the end of the run: \cr\tab store & unit hydrographs levels [mm], CemaNeige states [mm & °C], \cr\tab see \code{\link{CreateIniStates}} for more details \cr } (refer to the provided references or to the package source code for further details on these model outputs) } diff --git a/man/RunModel_GR2M.Rd b/man/RunModel_GR2M.Rd index fc3bac20d622db34b9c9385c4a5d5d551d2ac7d8..f697c347f3dc18eab33324da254d57c5b957ff01 100644 --- a/man/RunModel_GR2M.Rd +++ b/man/RunModel_GR2M.Rd @@ -23,7 +23,7 @@ GR2M X2 \tab groundwater exchange coefficient [-] \cr \emph{$PotEvap } \tab [numeric] series of input potential evapotranspiration [mm/month] \cr \emph{$Precip } \tab [numeric] series of input total precipitation [mm/month] \cr \emph{$Qsim } \tab [numeric] series of Qsim [mm/month] \cr - \emph{$StateEnd} \tab [numeric] states at the end of the run (production store level and routing store level) [mm] \cr + \emph{$StateEnd} \tab [numeric] states at the end of the run (production store level and routing store level) [mm], \cr\tab see \code{\link{CreateIniStates}} for more details \cr } (refer to the provided references or to the package source code for further details on these model outputs) } diff --git a/man/RunModel_GR4H.Rd b/man/RunModel_GR4H.Rd index 071760dc124ba76da6eb080c6aae03894f3e24b2..07a9e7dc05e2082742e98ac8bde0d098652a7803 100644 --- a/man/RunModel_GR4H.Rd +++ b/man/RunModel_GR4H.Rd @@ -36,7 +36,7 @@ GR4H X4 \tab unit hydrograph time constant [h] \emph{$QR } \tab [numeric] series of routing store outflow (QR) [mm/h] \cr \emph{$QD } \tab [numeric] series of direct flow from UH2 after exchange (QD) [mm/h] \cr \emph{$Qsim } \tab [numeric] series of Qsim [mm/h] \cr - \emph{$StateEnd} \tab [numeric] states at the end of the run (res. levels, UH1 levels, UH2 levels) [mm] \cr + \emph{$StateEnd} \tab [numeric] states at the end of the run (res. levels, UH1 levels, UH2 levels) [mm], see \code{\link{CreateIniStates}} for more details \cr } (refer to the provided references or to the package source code for further details on these model outputs) } diff --git a/man/RunModel_GR4J.Rd b/man/RunModel_GR4J.Rd index c3f488057ae52836ae5e030e6e226219aa8d5522..924b112ff522e444372e2b2cfa892935f786a38d 100644 --- a/man/RunModel_GR4J.Rd +++ b/man/RunModel_GR4J.Rd @@ -40,7 +40,7 @@ GR4J X4 \tab unit hydrograph time constant [d] \emph{$QR } \tab [numeric] series of routing store outflow (QR) [mm/d] \cr \emph{$QD } \tab [numeric] series of direct flow from UH2 after exchange (QD) [mm/d] \cr \emph{$Qsim } \tab [numeric] series of Qsim [mm/d] \cr - \emph{$StateEnd} \tab [numeric] states at the end of the run (res. levels, UH1 levels, UH2 levels) [mm] \cr + \emph{$StateEnd} \tab [numeric] states at the end of the run (res. levels, UH1 levels, UH2 levels) [mm], \cr\tab see \code{\link{CreateIniStates}} for more details \cr } (refer to the provided references or to the package source code for further details on these model outputs) } diff --git a/man/RunModel_GR5J.Rd b/man/RunModel_GR5J.Rd index 803eb8696f76ff274d7c2001b2f03662b51129c4..94f3f4863906929672db4f92c3498515ed02c3ae 100644 --- a/man/RunModel_GR5J.Rd +++ b/man/RunModel_GR5J.Rd @@ -41,7 +41,7 @@ GR5J X5 \tab intercatchment exchange threshold [-] \cr \emph{$QR } \tab [numeric] series of routing store outflow (QR) [mm/d] \cr \emph{$QD } \tab [numeric] series of direct flow from UH2 after exchange (QD) [mm/d] \cr \emph{$Qsim } \tab [numeric] series of Qsim [mm/d] \cr - \emph{$StateEnd} \tab [numeric] states at the end of the run (res. levels, UH1 levels, UH2 levels) [mm] \cr + \emph{$StateEnd} \tab [numeric] states at the end of the run (res. levels, UH1 levels, UH2 levels) [mm], \cr\tab see \code{\link{CreateIniStates}} for more details \cr } (refer to the provided references or to the package source code for further details on these model outputs) } diff --git a/man/RunModel_GR6J.Rd b/man/RunModel_GR6J.Rd index 5586b906422c2283f87aefeb1ac4b16bf5be75ec..60c30a1d73f06678b2c2315fec372d73b129ac9b 100644 --- a/man/RunModel_GR6J.Rd +++ b/man/RunModel_GR6J.Rd @@ -44,7 +44,7 @@ GR6J X6 \tab coefficient for emptying exponential store [mm] \emph{$Exp } \tab [numeric] series of exponential store level (negative) [mm] \cr \emph{$QD } \tab [numeric] series of direct flow from UH2 after exchange (QD) [mm/d] \cr \emph{$Qsim } \tab [numeric] series of Qsim [mm/d] \cr - \emph{$StateEnd} \tab [numeric] states at the end of the run (res. levels, UH1 levels, UH2 levels) [mm] \cr + \emph{$StateEnd} \tab [numeric] states at the end of the run (res. levels, UH1 levels, UH2 levels) [mm], \cr\tab see \code{\link{CreateIniStates}} for more details \cr } (refer to the provided references or to the package source code for further details on these model outputs) }