mlrMBO: exampleRunMultiObj – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

exampleRunMultiObj

Perform an MBO run on a multi-objective test function and and visualize what happens.

Description

Only available for 2D -> 2D examples, useful for figuring out how stuff works and for teaching purposes. Currently only parameter spaces with numerical parameters are supported. For visualization, run plotExampleRun on the resulting object. What is displayed is documented here: plotExampleRun.

Usage

exampleRunMultiObj(
  fun,
  design = NULL,
  learner,
  control,
  points.per.dim = 50,
  show.info = getOption("mlrMBO.show.info", TRUE),
  nsga2.args = list(),
  ...
)

Arguments

`fun`	[`smoof_function`] Fitness function to optimize. For one dimensional target functions you can obtain a `smoof_function` by using `makeSingleObjectiveFunction`. For multi dimensional functions use `makeMultiObjectiveFunction`. It is possible to return even more information which will be stored in the optimization path. To achieve this, simply append the attribute “extras” to the return value of the target function. This has to be a named list of scalar values. Each of these values will be stored additionally in the optimization path.
`design`	[`data.frame`] Initial design as data frame. If the y-values are not already present in design, mbo will evaluate the points. If the parameters have corresponding trafo functions, the design must not be transformed before it is passed! Functions to generate designs are available in `ParamHelpers`: `generateDesign`, `generateGridDesign`, `generateRandomDesign`. Default is `NULL`, which means `generateDesign` is called and a design of size 4 times number of all parameters is created The points are drawn via `maximinLHS` to maximize the minimal distance between design points.
`learner`	[`Learner`] Regression learner from mlr, which is used as a surrogate to model our fitness function. If `NULL` (default), the default learner is determined as described here: mbo_default_learner.
`control`	[`MBOControl`] Control object for mbo.
`points.per.dim`	[`integer`] Number of (regular spaced) locations at which to sample the `fun` function per dimension. Default is 50.
`show.info`	[`logical(1)`] Verbose output on console? Default is `TRUE`.
`nsga2.args`	[`list`] Further arguments passed to the nsga2 call. Default is `list()`.
`...`	[any] Further arguments passed to the learner.

Value

[MBOExampleRunMultiObj]

Note

If the passed objective function has no associated reference point max(y_i) + 1 of the nsga2 front is used.

mlrMBO

Bayesian Optimization and Model-Based Optimization of Expensive Black-Box Functions

v1.1.5

BSD_2_clause + file LICENSE

Authors

Bernd Bischl [aut] (<https://orcid.org/0000-0001-6002-6980>), Jakob Richter [aut, cre] (<https://orcid.org/0000-0003-4481-5554>), Jakob Bossek [aut] (<https://orcid.org/0000-0002-4121-4668>), Daniel Horn [aut], Michel Lang [aut] (<https://orcid.org/0000-0001-9754-0393>), Janek Thomas [aut] (<https://orcid.org/0000-0003-4511-6245>)

Initial release