randomsearch: Optimizes a function with random search.
In jakob-r/randomsearch: Random Search for Expensive Functions

Description Usage Arguments Value Methods (by class) Examples

This function conducts a random search on the given function with the support of parallelization and multiple termination criteria.

randomsearch(fun, ...)

## S3 method for class 'smoof_function'
randomsearch(fun, design = NULL,
  max.evals = 20, max.execbudget = NULL, target.fun.value = NULL,
  design.y.cols = NULL, par.dir = NULL, par.jobs = NULL, ...)

## S3 method for class 'function'
randomsearch(fun, minimize = TRUE, lower, upper,
  design = NULL, max.evals = 20, max.execbudget = NULL,
  target.fun.value = NULL, design.y.cols = NULL, par.dir = NULL,
  par.jobs = NULL, ...)

`fun`	[`smoof_function`\|`function`] Fitness function to optimize. Can be either a `smoof_function` or a normal function that takes the numeric vector over that should be optimized as the first argument. 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.
`...`	[any] Additional arguments that will be passed to each call of `fun`.
`design`	[`data.frame`] Initial design as data frame. If the y-values are not already present in design, randomsearch 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 no initial design.
`max.evals`	[`integer(1)`] Maximum number of evaulations of the objective functions. Includes the initial design.
`max.execbudget`	[`integer(1)`] Exceution time budget in seconds.
`target.fun.value`	[`numeric(1)`] Traget function value.
`design.y.cols`	[`characer()`] The name of the column containing the function outcomes. One for single-crit optimization. Multiple for multi-crit optimization.
`par.dir`	[`character(1)`] Location to store parallel communication files. Defaults to `tmpfile()` which might not be suitable for parallelization methods that work on multiple machines. Those need a shared directory.
`par.jobs`	[`integer(1)`] How many parallel jobs do you want to run to evaluate the random search? Default is `NULL` which means 1 if no `parallelStart*` function is called. Otherwise it will detect the number through `parallelGetOptions`.
`minimize`	[`logical()`] Wheter the function should be minimized or maximized. If this is a vector we will assume it is a multi-objective optimization. Has to have the same length as the output of the objective function `fun`.
`lower`	[`numeric()`] Lower bounds on the variables.
`upper`	[`numeric()`] Upper bounds on the variables.

[OptPath]

smoof_function: optimize smoof function
function: optimize generic function

obj.fun = makeSingleObjectiveFunction(
 fn = function(x) x[1]^2 + sin(x[2]),
 par.set = makeNumericParamSet(id = "x", lower = -1, upper = 1, len = 2)
)
res = randomsearch(obj.fun, max.evals = 10)
summary(res)