foreSIGHT (version 1.2.0)

plotMultiSiteScenarios: Creates summary plots of the biases in the multi-site scenarios

Description

plotMultiSiteScenarios uses a multi-site simulation performed using the function generateScenarios as input, and creates heatmaps that show biases in simulated attributes and spatial correlation. The function creates heatmaps (for each replicate and target) that show:

• magnitude of biases in single site attributes

• magnitude of biases in catchment total attributes

• biases in spatial correlation

Usage

plotMultiSiteScenarios(
  reference,
  sim,
  attSel = NULL,
  targets = 1,
  reps = 1,
  stages = c("Stage1", "Stage2", "Stage3")
)

Value

The function returns three R plots for each target and replicate showing the biases in single site attributes, catchment average attributes, and spatial correlations.

Arguments

reference

list; contains reference daily climate data, with elements named year, month, day, *variable_name1*, *variable_name2*. List format is suitable for both single and multi-site data. Climate variables are specified as matrices, with columns for each site.
Please refer to data provided with the package that may be loaded using data(barossaDat) for examples of the expected format of multi-site reference.

sim

a list; contains a multi-site stochastic simulation created using the function generateScenarios

attSel

a vector; contains names of selected attributes to be evaluated

targets

a vector; contains set of targets in exposure space to be evaluated

reps

a vector; contains replicates of stochastic simulation to be evaluated

stages

a vector; contains names of approaches used to generate multi-site stochastic simulations ('Stage3' is recommended approach, while 'Stage1' and 'Stage2' show intermediate results)

See Also

generateScenarios

Examples

# load data from multi-site simulation
data(egMultiSiteSim)
# plot performance of simulated time series in terms of single site 
# and catchment attributes, and correlation between sites
if (FALSE) {
plotMultiSiteScenarios(reference=barossa_obs,sim=egMultiSiteSim)
}