plotExampleRun function

Renders plots for exampleRun objects and displays them.

The graphical output depends on the target function at hand. - For 1D numeric functions the upper plot shows the true function (if known), the model and the (infill) points. The lower plot shows the infill criterion. - For 2D mixed target functions only one plot is displayed. - For 2D numeric only target functions up to four plots are presented to the viewer: - levelplot of the true function landscape (with [infill] points), - levelplot of the model landscape (with [infill] points), - levelplot of the infill criterion - levelplot of the standard error (only if learner supports standard error estimation). - For bi-criteria target functions the upper plot shows the target space and the lower plot displays the x-space.

plotExampleRun(
  object,
  iters,
  pause = interactive(),
  densregion = TRUE,
  se.factor = 1,
  single.prop.point.plots = FALSE,
  xlim = NULL,
  ylim = NULL,
  point.size = 3,
  line.size = 1,
  trafo = NULL,
  colors = c("red", "blue", "green"),
  gg.objects = list(),
  ...
)

Arguments

• object: [function]

  MBOExampleRun object from exampleRun or MBOExampleRunMultiObj object from exampleRunMultiObj.

• iters: [integer]

  Selected iterations of object to produce plots. Default is all iterations.

• pause: [logical(1)]

  Should the process be paused after each iteration? Default is interactive().

• densregion: [logical(1)]

  Should the background be shaded? Default is TRUE. Only used if learner supports computation of standard error.

• se.factor: [numeric(1)]

  If the model provides local standard error estimation, in addition to the mean response yhat(x) +- se.factor * se(x)

  is plotted above and below. Default is 1.

• single.prop.point.plots: [logical(1)]

  Parameter for MOI-MBO Multi-point proposal: Should every proposed point be displayed in a single plot - or one plot per Iteration? Default is FALSE indicating single plots per proposed points.

• xlim: [numeric(2)]

  For 1D: xlim parameter for first and second plot. Default is range of x-values evaluated in run object x.

• ylim: [numeric(2)]

  For 1D: ylim parameter for first plot, for the second plot ylim is always set automatically, depending on the range of the evaluated infill criterion. Default for the first plot is a heuristic to have the true function and yhat(x) +- se.factor2 * se(x) both in the plot. Note that this heuristic might change the ylim setting between plot iterations.

• point.size: [numeric(1)]

  Point size for plotted points. Default is 3.

• line.size: [numeric(1)]

  Line width of the graphs of plotted functions.

• trafo: [list]

  List of transformation functions of type MBOTrafoFunction for the different plots. For 1D: The list elements should be named with y (applied to objective function and model) or crit (applied to the criterion). Only applied to plots with numeric parameters. For 2D: The list should contain at least one element y , yhat , crit

  or se . This way one can specify different transformations for different plots. If a single function is provided, this function is used for all plots.

• colors: [character(3)] Specify colors for point in the plots. Must be a vector of length 3, each element a color for the type design, prop and seq respectively. Default is red for the initial design, blue for already proposed points and green for the actual iteration.

• gg.objects: [list)] List of gg objects that should be added to all ggplots.

• ...: [any]

  Currently not used.

Returns

Nothing.