Base class for recombination that covers the common case of combining two individuals, where two (typically complementary) child individuals could be taken as the result, such as bitwise crossover or SBX crossover.
This is a relatively lightweight class, it adds the keep_complement active binding and sets $n_indivs_in and $n_indivs_out appropriately.
RecombinatorPair is an abstract base class and should be inherited from. Inheriting classes should implement the private
$.recombine_pair() function. During $operate(), the $.recombine_pair() function is called with the same input as the $.recombine() function
of the Recombinator class. It should return a data.table of two individuals.
Constructors of inheriting classes should have a keep_complement argument.
Other base classes:
Filtor,
FiltorSurrogate,
MiesOperator,
Mutator,
MutatorDiscrete,
MutatorNumeric,
OperatorCombination,
Recombinator,
Scalor,
Selector,
SelectorScalar
Other recombinators:
OperatorCombination,
Recombinator,
dict_recombinators_cmpmaybe,
dict_recombinators_convex,
dict_recombinators_cvxpair,
dict_recombinators_maybe,
dict_recombinators_null,
dict_recombinators_proxy,
dict_recombinators_sbx,
dict_recombinators_sequential,
dict_recombinators_swap,
dict_recombinators_xonary,
dict_recombinators_xounif
miesmuschel::MiesOperator -> miesmuschel::Recombinator -> RecombinatorPair
keep_complement(logical(1))
Whether the operation keeps both resulting individuals of the operation or discards the complement.
new()Initialize base class components of the RecombinatorPair.
RecombinatorPair$new(
keep_complement = TRUE,
param_classes = c("ParamLgl", "ParamInt", "ParamDbl", "ParamFct"),
param_set = ps(),
packages = character(0),
dict_entry = NULL,
own_param_set = quote(self$param_set)
)keep_complement(logical(1))
Whether the operation should keep both resulting individuals (TRUE), or only the first and discard
the complement (FALSE). Default TRUE.
The $keep_complement field will reflect this value.
param_classes(character)
Classes of parameters that the operator can handle. May contain any of "ParamLgl", "ParamInt", "ParamDbl", "ParamFct".
Default is all of them.
The $param_classes field will reflect this value.
param_set(ParamSet | list of expression)
Strategy parameters of the operator. This should be created by the subclass and given to super$initialize().
If this is a ParamSet, it is used as the MiesOperator's ParamSet
directly. Otherwise it must be a list of expressions e.g. created by alist() that evaluate to ParamSets,
possibly referencing self and private.
These ParamSet are then combined using a ParamSetCollection.
Default is the empty ParamSet.
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 is character(0).
The $packages field will reflect this values.
dict_entry(character(1) | NULL)
Key of the class inside the Dictionary (usually one of
dict_mutators, dict_recombinators, dict_selectors), where it can
be retrieved using a short access function. May be NULL if the operator
is not entered in a dictionary.
The $dict_entry field will reflect this value.
own_param_set(language)
An expression that evaluates to a ParamSet indicating the configuration parameters that are entirely owned by
this operator class (and not proxied from a construction argument object). This should be quote(self$param_set) (the default) when
the param_set argument is not a list of expressions.