`R/plotExampleRun.R`

`plotExampleRun.Rd`

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(),
...
)
```

- 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.

Nothing.