FITEVAL can be executed as standalone
application or as a MATLAB function.
An ASCII text file located in the
same directory as the application is required. This file must contain two paired
vectors or columns: the first with the observations and the second with
the model-calculated values file is required containing
the observed and calculated values to be evaluated.
The input file may contain missing
values that must be denoted as nan.
The filename can be passed as an
argument (default filename is "fiteval.in").
The program finishes after closing
After running FITEVAL, it performs
the goodness-of-fit evaluation providing a portable data file (pdf)
plot of observed vs. computed values illustrating the match on the 1:1
calculation of NSE and RMSE and their corresponding
intervals of 95%;
qualitative goodness-of-fit interpretation based on the established
d) a verification of the presence of bias or the possible presence of
plot of the Ceff cumulative probability function superimposed on the
Ceff class regions;
plot illustrating the evolution of the observed and computed values.
the numerical output is stored in a ascii text file.
above-mentioned plots can be obtained also as separated files in the
specified (as argument) graphic format ('eps', 'pdf', 'jpg',
'tiff, or 'png'). A plot label can be provided by using a "text string"
as argument after the filename. Examples of use are provided in the
repeated cases in the observed and calculated values is possible by
passing as second argument NOREP. For example: fiteval
indicates the number of removals only if repeated cases present.
files are included in this package data_ex1.in, data_ex2.in,
data_ex3.in and fiteval.in (default).
apply Efron and Tibshirani (1993) bootstrap or Politis and
Romano (1994) block bootstrap when dealing with time series. The
latter is the default option.
fitevalconfig.txt file is required when you want to run FITEVAL with
other threshold values or for calculating Legates and McCabe (1999)
modified form of the coefficient of efficiency (E1) instead of NSE.
This file contains six lines specifying: Acceptable NSEthreshold, Good
NSEthreshold, Very good NSEthreshold, relative bias threshold value
(%), the option for computing E1, figures’ font size, and the option
for canceling the on-screen display of the graphical output (useful
when using FITEVAL for multiple series calculations in a script). The
corresponding default values are 0.65, 0.80, 0.90, 5, 0, 10, and 0,
respectively (see below fitevalconfig.txt example).
0.65 % Acceptable NSE
0.80 % Good NSE threshold value
0.90 % Very good NSE threshold value
5 % BiasValue
0 % Compute Legates and McCabe modified Ceff (1=yes,0=no)
0 % Bootstrap method (1= Efrons' bootstrapping, 0= block boostrapping)
10 % FontSizeValue
0 % Do not display the graphical output (1=yes)