rvn_annual_peak_event_error: Annual Peak Event Errors

In rchlumsk/RavenR: Raven Hydrological Modelling Framework R Support and Analysis

Annual Peak Event Errors

Description

rvn_annual_peak_event_error creates a plot of the annual observed and simulated peak event errors.

Usage

rvn_annual_peak_event_error(
  sim,
  obs,
  mm = 9,
  dd = 30,
  add_line = TRUE,
  add_labels = TRUE
)

Arguments

sim	time series object of simulated flows
obs	time series object of observed flows
mm	month of water year (default 9)
dd	day of water year (default 30)
add_line	optionally adds a 1:1 line to the plot for reference (default TRUE)
add_labels	optionally adds labels for overpredict/underpredict on right side axis (default TRUE)

Details

Creates a plot of the percent errors in simulated peak events for each water year. The peaks are calculated as using flows from the same day as the peak event in the observed series, i.e. the timing of the peak is considered here. Note that the rvn_annual_peak_event function is first used to obtain the peaks in each year, then the percent errors are calculated.

The percent errors are calculated as (QP_sim-QP_obs)/QP_obs*100, where QP is the peak flow event.

The sim and obs should be of time series (xts) format and are assumed to be of the same length and time period. The flow series are assumed to be daily flows with units of m3/s.

The add_labels will add the labels of 'overprediction' and 'underprediction' to the right hand side axis if set to TRUE. This is useful in interpreting the plots.

Note that a plot title is purposely omitted in order to allow the automatic generation of plot titles.

Value

returns a list with peak event error data in a data frame, and a ggplot object

df_peak_event_error	data frame of the calculated peak event errors
p1	ggplot object with plotted annual peak event errors

See Also

rvn_annual_peak to consider just the magnitude of each year's peak rvn_annual_peak_error to calculate errors in peaks

Examples

# load sample hydrograph data, two years worth of sim/obs
data(rvn_hydrograph_data)
sim <- rvn_hydrograph_data$hyd$Sub36
obs <- rvn_hydrograph_data$hyd$Sub36_obs

# create a plot of peak annual errors with default options
peak1 <- rvn_annual_peak_event_error(sim, obs)
peak1$df_peak_event_error
peak1$p1

rchlumsk/RavenR documentation built on April 19, 2024, 5:15 a.m.