Creation of the InputsCrit object required to the ErrorCrit functions — CreateInputsCrit.GRiwrmInputsModel • airGRiwrm

This function can be used either for a catchment (with an InputsModel object) or for a network (with a GRiwrmInputsModel object)

# S3 method for GRiwrmInputsModel
CreateInputsCrit(
  InputsModel,
  FUN_CRIT = ErrorCrit_NSE,
  RunOptions,
  Obs,
  AprioriIds = NULL,
  k = 0.15,
  AprCelerity = 1,
  ...
)

# S3 method for InputsModel
CreateInputsCrit(InputsModel, FUN_CRIT, ...)

CreateInputsCrit(InputsModel, ...)

Arguments

InputsModel: object of class InputsModel or GRiwrmInputsModel. See CreateInputsModel
FUN_CRIT: [function (atomic or list)] error criterion function (e.g. airGR::ErrorCrit_RMSE, airGR::ErrorCrit_NSE)
RunOptions: object of class RunOptions or GRiwrmRunOptions, see CreateRunOptions
Obs: numeric, matrix or data.frame series of observed flows, see details
AprioriIds: (optional) named list or named vector of character used for the parameter regularization (see details)
k: (optional) numeric weight coefficient used in the parameter regularization (See airGR::CreateInputsCrit_Lavenne)
AprCelerity: (optional) numeric Default celerity used as a priori parameter for upstream catchments
...: arguments passed to airGR::CreateInputsCrit, see details

Value

Depending on the class of InputsModel argument (respectively InputsModel and GRiwrmInputsModel object), the returned value is respectively:

a InputsCrit object (See airGR::CreateInputsCrit)
a GRiwrmInputsCrit object which is a list of InputsCrit objects with one item per modeled sub-catchment

Details

See airGR::CreateInputsCrit documentation for a complete list of arguments.

Obs argument is equivalent to the same argument in airGR::CreateInputsCrit except that it must be a matrix or a data.frame if InputsModel is a GRiwrmInputsModel object. Then, each column of the matrix or data.frame represents the observations of one of the simulated node with the name of the columns representing the id of each node.

With a GRiwrmInputsModel object, all arguments are applied on each sub-catchments of the network.

Parameter regularization consists of defining a priori parameters which are used in a composed criterion based on the formula proposed by Lavenne et al. (2019) (See airGR::CreateInputsCrit_Lavenne). The parameter AprioriIds allows to define which upstream sub-catchment is used for providing a priori parameters. Its format is as follows: AprioriIds <- c("Downstream sub-catchment 1" = "A priori upstream sub-catchment 1", ...) where the quoted strings are the ids of the sub-catchments. See vignettes for more details. The parameter AprCelerity is a default value used as a priori for the parameter 'Celerity' in case of an upstream catchment (without celerity parameter) is used as a priori catchment.

References

De Lavenne, A., Andréassian, V., Thirel, G., Ramos, M.-H., Perrin, C., 2019. A Regularization Approach to Improve the Sequential Calibration of a Semidistributed Hydrological Model. Water Resources Research 55, 8821–8839. doi: 10.1029/2018WR024266