These functions allow generation of synthetic hydrologic peaks
generated from a combination of exponetial functions. Also, synthetic
errors for the reproduction of a reference peak can be generated in
order to subsequentially test the behaviour of performance measures
with respect to these errors.
number of time steps before the rise phase starts.
May be negative, such that the peak starts outside the window.
rise.time
Number of time steps for the rise phase
rise.factor
The peak maximum is about rise.factor
higher than the base flow.
rise.factor2
rise.factor for the "peaks" which only
show a recession phase.
recession.const
Recession constant for the peak.
length.out
Total length of the time series to be returned.
rez.time
Length of the recession phase
err1.factor
Factors to use for the first error type: Over-
and underestimation of the peak
err2.factor
Factors to use for the second error type: shifting of the entire time series
err3.factor
Factors to use for the third error type:
Recession too fast/too slow
err4.factor
Factors to use for the fourth error type: Lag time
err5.factor
Factors to use for the fifth error type: Correct
total volume, but peak over/underestimated
err6.factor
Factors to use for the sixth error type: Peak
too wide/too narrow
err9.factor
Factors to use for the ninth error type: Shift
during the recession phase
peaks
object returned from synth.peak.error()
y.max
upper limit for the y-axis
peak.cluster
object returned from peaks.in.clusters used for
coloring the cluster assignment of synthetic peaks (see examples)
peak.palette
Colors to use if peak.cluster is NULL: first
color for reference, second and third for peaks over- and
underestimating the reference
use.layout
Boolean, indicating whether to use the predefined
layout
plot.legend
Boolean, indicating whether to show the legend
print.error.nr
Boolean, indicating whether to label each subplot with a number
mfrow
mfrow plot parameter (only used, if use.layout=FALSE)
show.errors
Vector with indices indicating which errors to display
peak.lty
Line types for either clusters as defined in
peak.cluster or as in peak.palette
Value
synth.peak returns a vector with the synthetic peak according to
the provided parameters
synth.peak.error returns an array with dimension 3. The first
dimension corresponds to the error type. The second dimension to the
level of the corresponding error type. The third dimension corresponds
to the time.
Author(s)
Dominik Reusser
References
Reusser, D. E., Blume, T., Schaefli, B., and Zehe, E.: Analysing the temporal dynamics of model performance for hydrological models, Hydrol. Earth Syst. Sci. Discuss., 5, 3169-3211, 2008.