hydroPSO (version 0.4-1)

verification: verification

Description

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

Usage

verification(fn="hydromod", par, control=list(), 
             model.FUN=NULL, model.FUN.args=list() )

Arguments

fn

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

par

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

control

a list of control parameters. See ‘Details’

model.FUN

OPTIONAL. Only used when fn='hydromod' character, valid R function representing the model code to be calibrated/optimised

model.FUN.args

OPTIONAL. Only used when fn='hydromod' list with the arguments to be passed to model.FUN

Value

A list of two elements:

gofs

goodness-of-fit values corresponding to each one of the parameter sets provided in par

best.gof

goodness-of-fit of the "best" parameter set found during the verification round

best.par

parameter values of the "best" paraemter set found during the verification round

Details

The control argument is a list that can supply any of the following components:

drty.in

character, path to the directory storing the input files required for PSO, i.e. ‘ParamRanges.txt’ and ‘ParamFiles.txt’

drty.out

character, path to the directory storing the output files generated by hydroPSO

digits

OPTIONAL. Only used when write2disk=TRUE numeric, number of significant digits used for writing the outputs in scientific notation

gof.name

character, ONLY used for identifying the goodness-of-fit of each model run and writing it to the LH_OAT-gof.txt output file

MinMax

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')

do.plots

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

write2disk

logical, indicates if the output files will be written to the disk

verbose

logical, if TRUE progress messages are printed

%% \item{\dots}{ %% ~~Describe \code{\dots} here~~ %%}

See Also

hydromod