ArchiveAsyncFSelect: Rush Data Storage
In mlr3fselect: Feature Selection for 'mlr3'
ArchiveAsyncFSelect R Documentation
Rush Data Storage
Description
The ArchiveAsyncFSelect stores all evaluated feature subsets and performance scores in a rush::Rush database.
Details
The ArchiveAsyncFSelect is a connector to a rush::Rush database.
Data Structure
The table ($data) has the following columns:
One column for each feature of the search space ($search_space).
One column for each performance measure ($codomain).
-
runtime_learners (numeric(1))
Sum of training and predict times logged in learners per mlr3::ResampleResult / evaluation.
This does not include potential overhead time.
-
timestamp (POSIXct)
Time stamp when the evaluation was logged into the archive.
Analysis
For analyzing the feature selection results, it is recommended to pass the ArchiveAsyncFSelect to as.data.table().
The returned data table contains the mlr3::ResampleResult for each feature subset evaluation.
S3 Methods
-
as.data.table.ArchiveFSelect(x, unnest = "x_domain", exclude_columns = "uhash", measures = NULL)
Returns a tabular view of all evaluated feature subsets.
ArchiveAsyncFSelect -> data.table::data.table()
-
x (ArchiveAsyncFSelect)
-
unnest (character())
Transforms list columns to separate columns. Set to NULL if no column should be unnested.
-
exclude_columns (character())
Exclude columns from table. Set to NULL if no column should be excluded.
-
measures (List of mlr3::Measure)
Score feature subsets on additional measures.
Super classes
bbotk::Archive -> bbotk::ArchiveAsync -> ArchiveAsyncFSelect
Active bindings
benchmark_result(mlr3::BenchmarkResult)
Benchmark result.
ties_method(character(1))
Method to handle ties in the archive.
One of "least_features" (default) or "random".
Methods
Public methods
-
-
-
-
-
-
-
-
-
Inherited methods
Method new()
Creates a new instance of this R6 class.
Usage
ArchiveAsyncFSelect$new(
search_space,
codomain,
rush,
ties_method = "least_features"
)
Arguments
search_space(paradox::ParamSet)
Search space.
Internally created from provided mlr3::Task by instance.
codomain(paradox::ParamSet)
Specifies codomain of function.
Most importantly the tags of each output "Parameter" define whether it should
be minimized or maximized. The default is to minimize each component.
rush(Rush)
If a rush instance is supplied, the optimization runs without batches.
ties_method(character(1))
The method to break ties when selecting sets while optimizing and when selecting the best set.
Can be "least_features" or "random".
The option "least_features" (default) selects the feature set with the least features.
If there are multiple best feature sets with the same number of features, one is selected randomly.
The random method returns a random feature set from the best feature sets.
Ignored if multiple measures are used.
check_values(logical(1))
If TRUE (default), feature subsets are check for validity.
Method learner()
Retrieve mlr3::Learner of the i-th evaluation, by position or by unique hash uhash.
i and uhash are mutually exclusive.
Learner does not contain a model. Use $learners() to get learners with models.
Usage
ArchiveAsyncFSelect$learner(i = NULL, uhash = NULL)
Arguments
i(integer(1))
The iteration value to filter for.
uhash(logical(1))
The uhash value to filter for.
Method learners()
Retrieve list of trained mlr3::Learner objects of the i-th evaluation, by position or by unique hash uhash.
i and uhash are mutually exclusive.
Usage
ArchiveAsyncFSelect$learners(i = NULL, uhash = NULL)
Arguments
i(integer(1))
The iteration value to filter for.
uhash(logical(1))
The uhash value to filter for.
Method predictions()
Retrieve list of mlr3::Prediction objects of the i-th evaluation, by position or by unique hash uhash.
i and uhash are mutually exclusive.
Usage
ArchiveAsyncFSelect$predictions(i = NULL, uhash = NULL)
Arguments
i(integer(1))
The iteration value to filter for.
uhash(logical(1))
The uhash value to filter for.
Method resample_result()
Retrieve mlr3::ResampleResult of the i-th evaluation, by position or by unique hash uhash.
i and uhash are mutually exclusive.
Usage
ArchiveAsyncFSelect$resample_result(i = NULL, uhash = NULL)
Arguments
i(integer(1))
The iteration value to filter for.
uhash(logical(1))
The uhash value to filter for.
Method print()
Printer.
Usage
ArchiveAsyncFSelect$print()
Arguments
...(ignored).
Method best()
Returns the best scoring feature set(s).
For single-crit optimization, the solution that minimizes / maximizes the objective function.
For multi-crit optimization, the Pareto set / front.
Usage
ArchiveAsyncFSelect$best(n_select = 1, ties_method = "least_features")
Arguments
n_select(integer(1L))
Amount of points to select.
Ignored for multi-crit optimization.
ties_method(character(1L))
Method to break ties when multiple points have the same score.
Either "least_features" (default) or "random".
Ignored for multi-crit optimization.
If n_select > 1L, the tie method is ignored and the first point is returned.
Returns
data.table::data.table()
Method push_result()
Push result to the archive.
Usage
ArchiveAsyncFSelect$push_result(key, ys, x_domain, extra = NULL)
Arguments
key(character())
Key of the point.
ys(list())
Named list of results.
x_domain(list())
Is ignored for feature selection.
extra(list())
Named list of additional information.
Method clone()
The objects of this class are cloneable with this method.
Usage
ArchiveAsyncFSelect$clone(deep = FALSE)
Arguments
deepWhether to make a deep clone.
mlr3fselect documentation built on Aug. 8, 2025, 7:46 p.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
| ArchiveAsyncFSelect | R Documentation |
Rush Data Storage
Description
The ArchiveAsyncFSelect stores all evaluated feature subsets and performance scores in a rush::Rush database.
Details
The ArchiveAsyncFSelect is a connector to a rush::Rush database.
Data Structure
The table ($data) has the following columns:
One column for each feature of the search space (
$search_space).One column for each performance measure (
$codomain).-
runtime_learners(numeric(1))
Sum of training and predict times logged in learners per mlr3::ResampleResult / evaluation. This does not include potential overhead time. -
timestamp(POSIXct)
Time stamp when the evaluation was logged into the archive.
Analysis
For analyzing the feature selection results, it is recommended to pass the ArchiveAsyncFSelect to as.data.table().
The returned data table contains the mlr3::ResampleResult for each feature subset evaluation.
S3 Methods
-
as.data.table.ArchiveFSelect(x, unnest = "x_domain", exclude_columns = "uhash", measures = NULL)
Returns a tabular view of all evaluated feature subsets.
ArchiveAsyncFSelect ->data.table::data.table()
-
x(ArchiveAsyncFSelect) -
unnest(character())
Transforms list columns to separate columns. Set toNULLif no column should be unnested. -
exclude_columns(character())
Exclude columns from table. Set toNULLif no column should be excluded. -
measures(List of mlr3::Measure)
Score feature subsets on additional measures.
-
Super classes
bbotk::Archive -> bbotk::ArchiveAsync -> ArchiveAsyncFSelect
Active bindings
benchmark_result(mlr3::BenchmarkResult)
Benchmark result.ties_method(
character(1))
Method to handle ties in the archive. One of"least_features"(default) or"random".
Methods
Public methods
Inherited methods
Method new()
Creates a new instance of this R6 class.
Usage
ArchiveAsyncFSelect$new( search_space, codomain, rush, ties_method = "least_features" )
Arguments
search_space(paradox::ParamSet)
Search space. Internally created from provided mlr3::Task by instance.codomain(paradox::ParamSet)
Specifies codomain of function. Most importantly the tags of each output "Parameter" define whether it should be minimized or maximized. The default is to minimize each component.rush(
Rush)
If a rush instance is supplied, the optimization runs without batches.ties_method(
character(1))
The method to break ties when selecting sets while optimizing and when selecting the best set. Can be"least_features"or"random". The option"least_features"(default) selects the feature set with the least features. If there are multiple best feature sets with the same number of features, one is selected randomly. Therandommethod returns a random feature set from the best feature sets. Ignored if multiple measures are used.check_values(
logical(1))
IfTRUE(default), feature subsets are check for validity.
Method learner()
Retrieve mlr3::Learner of the i-th evaluation, by position or by unique hash uhash.
i and uhash are mutually exclusive.
Learner does not contain a model. Use $learners() to get learners with models.
Usage
ArchiveAsyncFSelect$learner(i = NULL, uhash = NULL)
Arguments
i(
integer(1))
The iteration value to filter for.uhash(
logical(1))
Theuhashvalue to filter for.
Method learners()
Retrieve list of trained mlr3::Learner objects of the i-th evaluation, by position or by unique hash uhash.
i and uhash are mutually exclusive.
Usage
ArchiveAsyncFSelect$learners(i = NULL, uhash = NULL)
Arguments
i(
integer(1))
The iteration value to filter for.uhash(
logical(1))
Theuhashvalue to filter for.
Method predictions()
Retrieve list of mlr3::Prediction objects of the i-th evaluation, by position or by unique hash uhash.
i and uhash are mutually exclusive.
Usage
ArchiveAsyncFSelect$predictions(i = NULL, uhash = NULL)
Arguments
i(
integer(1))
The iteration value to filter for.uhash(
logical(1))
Theuhashvalue to filter for.
Method resample_result()
Retrieve mlr3::ResampleResult of the i-th evaluation, by position or by unique hash uhash.
i and uhash are mutually exclusive.
Usage
ArchiveAsyncFSelect$resample_result(i = NULL, uhash = NULL)
Arguments
i(
integer(1))
The iteration value to filter for.uhash(
logical(1))
Theuhashvalue to filter for.
Method print()
Printer.
Usage
ArchiveAsyncFSelect$print()
Arguments
...(ignored).
Method best()
Returns the best scoring feature set(s). For single-crit optimization, the solution that minimizes / maximizes the objective function. For multi-crit optimization, the Pareto set / front.
Usage
ArchiveAsyncFSelect$best(n_select = 1, ties_method = "least_features")
Arguments
n_select(
integer(1L))
Amount of points to select. Ignored for multi-crit optimization.ties_method(
character(1L))
Method to break ties when multiple points have the same score. Either"least_features"(default) or"random". Ignored for multi-crit optimization. Ifn_select > 1L, the tie method is ignored and the first point is returned.
Returns
data.table::data.table()
Method push_result()
Push result to the archive.
Usage
ArchiveAsyncFSelect$push_result(key, ys, x_domain, extra = NULL)
Arguments
key(
character())
Key of the point.ys(
list())
Named list of results.x_domain(
list())
Is ignored for feature selection.extra(
list())
Named list of additional information.
Method clone()
The objects of this class are cloneable with this method.
Usage
ArchiveAsyncFSelect$clone(deep = FALSE)
Arguments
deepWhether to make a deep clone.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.