R: Creates summary plots of the biases in the multi-site...

plotMultiSiteScenarios {foreSIGHT}

R Documentation

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

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)

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.

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
## Not run: 
plotMultiSiteScenarios(reference=barossa_obs,sim=egMultiSiteSim)

## End(Not run)