From 8733e5f67db9bd74552e7eaf6a145f40fa7002ee Mon Sep 17 00:00:00 2001 From: unknown <olivier.delaigue@ANPI1430.antony.irstea.priv> Date: Fri, 18 Aug 2017 17:13:38 +0200 Subject: [PATCH] v1.0.9.28 many typo revisions in documentation --- DESCRIPTION | 2 +- man/CreateRunOptions.Rd | 23 +++++++++++++---------- man/DataAltiExtrapolation_Valery.Rd | 2 +- 3 files changed, 15 insertions(+), 12 deletions(-) diff --git a/DESCRIPTION b/DESCRIPTION index 93bc07ce..6295afa7 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.27 +Version: 1.0.9.28 Date: 2017-08-18 Authors@R: c( person("Laurent", "Coron", role = c("aut", "trl")), diff --git a/man/CreateRunOptions.Rd b/man/CreateRunOptions.Rd index 6e0e4eeb..1d3f56c8 100644 --- a/man/CreateRunOptions.Rd +++ b/man/CreateRunOptions.Rd @@ -85,17 +85,20 @@ The actual length of this warm-up might be shorter depending on data availabilit (2) Customisation of initialisation options: \itemize{ -\item \code{IndPeriod_WarmUp} can be used to specify the indices of the warm-up period (within the time series prepared in InputsModel). \cr -- remark 1: for most common cases, indices corresponding to one or several years preceding \code{IndPeriod_Run} are used (e.g. \code{IndPeriod_WarmUp = 1000:1365} and \code{IndPeriod_Run = 1366:5000)}. \cr +\item \code{IndPeriod_WarmUp} can be used to specify the indices of the warm-up period (within the time series prepared in InputsModel). +\itemize{ +\item remark 1: for most common cases, indices corresponding to one or several years preceding \code{IndPeriod_Run} are used (e.g. \code{IndPeriod_WarmUp = 1000:1365} and \code{IndPeriod_Run = 1366:5000)}. \cr However, it is also possible to perform a long-term initialisation if other indices than the warm-up ones are set in \code{IndPeriod_WarmUp} (e.g. \code{IndPeriod_WarmUp = c(1:5000, 1:5000, 1:5000, 1000:1365)}). \cr -- remark 2: it is also possible to completely disable the warm-up period when using \code{IndPeriod_WarmUp = 0L}. This is necessary if you want \code{IniStates} and / or \code{IniResLevels} to be the actual initial values of the model variables from your simulation (e.g. to perform a forecast form a given initial state). - -\item \code{IniStates} and \code{IniResLevels} can be used to specify the initial model states. \cr -- remark 1: \code{IniStates} and \code{IniResLevels} can not be used with GR1A. \cr -- remark 2: if \code{IniStates} is used, two possibilities are offered: - - \code{IniStates} can be set to the \code{$StateEnd} output of a previous \code{RunModel} call, as \code{$StateEnd} already respects the correct format; \cr - - \code{IniStates} can be created with the \code{\link{CreateIniStates}} function. -- remark 3: in addition to \code{IniStates}, \code{IniResLevels} allows to set the filling rate of the production and routing stores for the GR models. For instance for GR4J and , GR5J: \code{IniResLevels = c(0.3, 0.5)} should be used to obtain initial fillings of 30 \% and 50 \% for the production and routing stores, respectively. For GR6J, \code{IniResLevels = c(0.3, 0.5, 0)} shold be use to obtain initial fillings of 30 \% and 50 \% for the production, routing stores and 0 mm for the exponential store, respectively. \code{IniResLevels} is optional and can only be used if \code{IniStates} is also defined (the state values corresponding to these two other stores in \code{IniStates} are not used in such case). \cr \cr +\item remark 2: it is also possible to completely disable the warm-up period when using \code{IndPeriod_WarmUp = 0L}. This is necessary if you want \code{IniStates} and/or \code{IniResLevels} to be the actual initial values of the model variables from your simulation (e.g. to perform a forecast form a given initial state). +} +\item \code{IniStates} and \code{IniResLevels} can be used to specify the initial model states. +\itemize{ +\item remark 1: \code{IniStates} and \code{IniResLevels} can not be used with GR1A. \cr +\item remark 2: if \code{IniStates} is used, two possibilities are offered:\cr +- \code{IniStates} can be set to the \emph{$StateEnd} output of a previous \code{RunModel} call, as \emph{$StateEnd} already respects the correct format; \cr +- \code{IniStates} can be created with the \code{\link{CreateIniStates}} function. +\item remark 3: in addition to \code{IniStates}, \code{IniResLevels} allows to set the filling rate of the production and routing stores for the GR models. For instance for GR4J and GR5J: \code{IniResLevels = c(0.3, 0.5)} should be used to obtain initial fillings of 30 \% and 50 \% for the production and routing stores, respectively. For GR6J, \code{IniResLevels = c(0.3, 0.5, 0)} shold be use to obtain initial fillings of 30 \% and 50 \% for the production, routing stores and 0 mm for the exponential store, respectively. \code{IniResLevels} is optional and can only be used if \code{IniStates} is also defined (the state values corresponding to these two other stores in \code{IniStates} are not used in such case). +} } } diff --git a/man/DataAltiExtrapolation_Valery.Rd b/man/DataAltiExtrapolation_Valery.Rd index c4c77cf9..1edab604 100644 --- a/man/DataAltiExtrapolation_Valery.Rd +++ b/man/DataAltiExtrapolation_Valery.Rd @@ -59,7 +59,7 @@ Elevation layers of equal surface are created the 101 elevation quantiles (\code and the number requested elevation layers (\code{NLayers}). \cr Forcing data (precipitation and air temperature) are extrapolated using gradients from Valery (2010). (e.g. gradP = 0.0004 [m-1] for France and gradT = 0.434 [°C/100m] for January, 1st). \cr -This function is used by the \code{CreateInputsModel} function. +This function is used by the \code{\link{CreateInputsModel}} function. } -- GitLab