Run the model and get a goodness-of-fit value by comparing the simulated values against observations for the optimum parameter set found by optimisation
verification(fn="hydromod", par, control=list(),
model.FUN=NULL, model.FUN.args=list() )
character, name of a valid R function to be optimised or character value 'hydromod'. When fn='hydromod'
the algorithm uses model.FUN
and model.FUN.args
to extract the values simulated by the model and to compute its corresponding goodness-of-fit function. When fn!='hydromod'
the algorithm uses the value(s) returned by fn
as both model output and its corresponding goodness-of-fit
When fn='hydromod'
the algorithm will optimise the model defined by model.FUN
and model.args
numeric, or matrix/data.frame with the parameter sets that will be used for verification
Parameter sets in par
must be stored by row, i.e., each different row represents a different parameter set
a list of control parameters. See ‘Details’
OPTIONAL. Only used when fn='hydromod'
character, valid R function representing the model code to be calibrated/optimised
OPTIONAL. Only used when fn='hydromod'
list with the arguments to be passed to model.FUN
A list of two elements:
goodness-of-fit values corresponding to each one of the parameter sets provided in par
goodness-of-fit of the "best" parameter set found during the verification round
parameter values of the "best" paraemter set found during the verification round
The control
argument is a list that can supply any of the following components:
character, path to the directory storing the input files required for PSO, i.e. ‘ParamRanges.txt’ and ‘ParamFiles.txt’
character, path to the directory storing the output files generated by hydroPSO
OPTIONAL. Only used when write2disk=TRUE
numeric, number of significant digits used for writing the outputs in scientific notation
character, ONLY used for identifying the goodness-of-fit of each model run and writing it to the LH_OAT-gof.txt output file
character, indicates whether the optimum value for the analysed problem corresponds to the minimum or maximum of the the objective function. It is used to select the ‘best’ parameter set.
Valid values are in: c('min', 'max')
logical, if TRUE a PNG plot with the comparison between observed and simulated values is produced for each parameter set used in the LH-OAT
logical, indicates if the output files will be written to the disk
logical, if TRUE progress messages are printed