# mbo

##### Optimizes a function with sequential model based optimization.

See mbo_parallel for all parallelization options.

##### Usage

```
mbo(fun, design = NULL, learner = NULL, control,
show.info = getOption("mlrMBO.show.info", TRUE), more.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.- show.info
[

`logical(1)`

] Verbose output on console? Default is`TRUE`

.- more.args
[list] Further arguments passed to fitness function.

##### Value

##### Examples

```
# NOT RUN {
# simple 2d objective function
obj.fun = makeSingleObjectiveFunction(
fn = function(x) x[1]^2 + sin(x[2]),
par.set = makeNumericParamSet(id = "x", lower = -1, upper = 1, len = 2)
)
# create base control object
ctrl = makeMBOControl()
# do three MBO iterations
ctrl = setMBOControlTermination(ctrl, iters = 3L)
# use 500 points in the focussearch (should be sufficient for 2d)
ctrl = setMBOControlInfill(ctrl, opt.focussearch.points = 500)
# create initial design
des = generateDesign(n = 5L, getParamSet(obj.fun), fun = lhs::maximinLHS)
# start mbo
res = mbo(obj.fun, design = des, control = ctrl)
print(res)
# }
# NOT RUN {
plot(res)
# }
```

*Documentation reproduced from package mlrMBO, version 1.1.2, License: BSD_2_clause + file LICENSE*