plotOptions uses the system model performances calculated using the function runSystemModel for two alternate system model options,
and the summary of the simulation generated using the functions generateScenarios & getSimSummary as input. The function plots the differences in
the performance metrics between the two options, and the changes in performance thresholds in the space.
The user may specify the attributes to be used as the axes of the plot. The function contains arguments to control the finer details of the plot.
plotOptions(
performanceOpt1,
performanceOpt2,
sim,
metric = NULL,
attX = NULL,
attY = NULL,
topReps = NULL,
opt1Label = "Option 1",
opt2Label = "Option 2",
titleText = paste0(opt2Label, " - ", opt1Label),
perfThresh = NULL,
perfThreshLabel = "Threshold",
attSlices = NULL,
climData = NULL,
colMap = NULL,
colLim = NULL
)The plot of the differences in the performance metrics (option 2 - option 1) in a ggplot object.
a named list; contains the system model performance calculated using runSystemModel for system model option 1.
If the list contains more than one performance metric, the argument metric can be used to specify the metric to be used.
a named list; contains the system model performance calculated using runSystemModel for system model option 2.
If the list contains more than one performance metric, the argument metric can be used to specify the metric to be used.
a list; summary of the simulation containing the scenarios generated using the function generateScenarios that is used to run the system model using runSystemModel.
The summary of the simulation may be obtained by using the function getSimSummary on the full simulation. The summary object is much smaller in size for ease of storage and use with the performance
plotting functions like plotPerformanceSpace.
a string; the name of the performance metric to be plotted. The argument can be used to select the metric from
performanceOpt1 and performanceOpt2 lists for plotting. If NULL (the default), the first metric in the lists will be used.
a string; the tag of the perturbed attribute to plot on the xaxis. The attribute must be one of the perturbed attributes of sim.
Type sim$expSpace$attPerturb to view all perturbed attributes of sim. If NULL (default), the first perturbed attribute of sim will be used.
a string; the tag of the perturbed attribute to plot on the yaxis. The attribute must be another perturbed attribute of sim.
If NULL, the second perturbed attribute of sim will be used.
an integer (default is NULL); the number of "top" replicates in terms of simulation fitness to be used. If topReps is specified, topReps
number of replicates will be identified for each target and the average performance across these replicates will be plotted. If NULL, the average performance across all the replicates will be plotted.
a string; the text to label performanceOpt1.
a string; the text to label performanceOpt2.
a string; text for the title of the plot. The default is paste0(opt2Label, " - ", opt1Label).
a number; the minimum or maximum threshold value of the performance metric. A line will be drawn to mark this threshold value in the performance space.
a string; the text to label perfThresh.
a list; used to subset perturbed attributes in sim for the plot. This argument would typically be used in cases where there are more than two perturbed attributes.
The elements of the list correspond to the perturbed attributes to be subsetted and must be named using the attribute tag. Each element may contain a single value or a two-element vector specifying the minimum-maximum values.
If the element is a single value, the exposure space is sliced on this single value of the attribute. If minimum-maximum values are specified, the exposure space will be sliced to subset this range.
If attSlices includes attX or attY, these attributes will be sliced and the resulting plot will be a "zoomed-in" space.
data.frame; the values of attX and attY from other sources like climate models. This data will be plotted as points in the performance space.
The data frame may contain columns with values of the performance metric to be plotted and the "Name" of the dataset.
If the performance metric is available in the data.frame, the points will be coloured based on the performance colMap scale.
If the Name of the data is available in the data.frame, the points will be identified using the Name.
Please refer data provided with the package that may be loaded using data("egClimData") for an example of the expected format of climData.
a vector of colours; to specify the colourmap to be used. If NULL, the default foreSIGHT colourmap is used.
a vector of 2 values; the minimum and maximum limits of the colour scale.
runSystemModel, plotPerformanceSpace, generateScenarios, getSimSummary
# load example datasets
data("egSimSummary")
data("egSimPerformance") # performance of option1
data("egSimPerformance_systemB") # performance of option2
data("egClimData")
plotOptions(egSimPerformance[1], egSimPerformance_systemB [1], egSimSummary,
attX = "P_ann_seasRatio", attY = "P_ann_tot_m", topReps = 7, perfThreshLabel = "Threshold (28L)",
perfThresh = 28, opt1Label = "System A", opt2Label = "System B", climData = egClimData)
Run the code above in your browser using DataLab