FiltorSurrogate {miesmuschel} | R Documentation |
Abstract Surrogate Model Filtering Base Class
Description
Abstract base class for surrogate model filtering.
A surrogate model is a regression model, based on an mlr3::Learner
, which predicts the approximate performance of newly sampled configurations
given the empirical performance of already evaluated configurations. The surrogate model can be used to propose points that have, according to the
surrogate model, a relatively high chance of performing well.
The FiltorSurrogate
base class can be inherited from to create different Filtor
s that filter based on a surrogate model, for example tournament
filtering or progresive filtering.
Configuration Parameters
FiltorSurrogateProgressive
's configuration parameters are the hyperparameters of the surrogate_learner
Learner
, as well as
the configuration parameters of the surrogate_selector
Selector
.
Supported Operand Types
Supported Domain
classes depend on the supported feature types of the surrogate_learner
, as reported
by surrogate_learner$feature_types
: "ParamInt"
requires
"integer"
, "ParamDbl"
requires "numeric"
, "ParamLgl"
requires "logical"
, and "ParamFct"
requires "factor"
.
Super classes
miesmuschel::MiesOperator
-> miesmuschel::Filtor
-> FiltorSurrogate
Active bindings
surrogate_learner
(
mlr3::LearnerRegr
)
Regression learner for the surrogate model filtering algorithm.surrogate_selector
(
Selector
)
Selector
with which to select using surrogate-predicted performance
Methods
Public methods
Inherited methods
Method new()
Initialize the base class components of the FiltorSurrogate
.
Usage
FiltorSurrogate$new( surrogate_learner, surrogate_selector = SelectorBest$new(), param_set = ps(), packages = character(0), dict_entry = NULL )
Arguments
surrogate_learner
(
mlr3::LearnerRegr
)
Regression learner for the surrogate model filtering algorithm.
The$surrogate_learner
field will reflect this value.surrogate_learner
(
mlr3::LearnerRegr
)
Regression learner for the surrogate model filtering algorithm.
The$surrogate_learner
field will reflect this value.surrogate_selector
(
Selector
)Selector
for the surrogate model filtering algorithm.
The$surrogate_selector
field will reflect this value.surrogate_selector
(
Selector
)Selector
for the surrogate model filtering algorithm.
The$surrogate_selector
field will reflect this value.param_set
(
ParamSet
)
ParamSet
of the method implemented in the inheriting class with configuration parameters that go beyond the parameters of thesurrogate_learner
andsurrogate_selector
.param_set
(
ParamSet
|list
ofexpression
)
Strategy parameters of the operator. This should be created by the subclass and given tosuper$initialize()
. If this is aParamSet
, it is used as theMiesOperator
'sParamSet
directly. Otherwise it must be alist
of expressions e.g. created byalist()
that evaluate toParamSet
s, possibly referencingself
andprivate
. TheseParamSet
are then combined using aParamSetCollection
. Default is the emptyParamSet
.
The$param_set
field will reflect this value.packages
(
character
) Packages that need to be loaded for the operator to function. This should be declared so these packages can be loaded when operators run on parallel instances. Default ischaracter(0)
.
The$packages
field will reflect this values.packages
(
character
) Packages that need to be loaded for the operator to function. This should be declared so these packages can be loaded when operators run on parallel instances. Default ischaracter(0)
.
The$packages
field will reflect this values.dict_entry
(
character(1)
|NULL
)
Key of the class inside theDictionary
(usually one ofdict_mutators
,dict_recombinators
,dict_selectors
), where it can be retrieved using a short access function. May beNULL
if the operator is not entered in a dictionary.
The$dict_entry
field will reflect this value.dict_entry
(
character(1)
|NULL
)
Key of the class inside theDictionary
(usually one ofdict_mutators
,dict_recombinators
,dict_selectors
), where it can be retrieved using a short access function. May beNULL
if the operator is not entered in a dictionary.
The$dict_entry
field will reflect this value.
Method prime()
See MiesOperator
method. Primes both this operator, as well as the wrapped operator
given to surrogate_selector
during construction.
Usage
FiltorSurrogate$prime(param_set)
Arguments
param_set
(
ParamSet
)
Passed toMiesOperator
$prime()
.
Returns
invisible self
.
Method clone()
The objects of this class are cloneable with this method.
Usage
FiltorSurrogate$clone(deep = FALSE)
Arguments
deep
Whether to make a deep clone.
See Also
Other base classes:
Filtor
,
MiesOperator
,
Mutator
,
MutatorDiscrete
,
MutatorNumeric
,
OperatorCombination
,
Recombinator
,
RecombinatorPair
,
Scalor
,
Selector
,
SelectorScalar
Other filtors:
Filtor
,
dict_filtors_maybe
,
dict_filtors_null
,
dict_filtors_proxy
,
dict_filtors_surprog
,
dict_filtors_surtour