TRexGVSSelector: T-Rex Selector for Grouped Variable Selection (T-Rex+GVS)

TRexGVSSelectorR Documentation

T-Rex Selector for Grouped Variable Selection (T-Rex+GVS)

Description

FDR-controlled variable selection for groups of highly correlated variables.

L-loop strategies

The selector supports the strategies "STANDARD", "HCONCAT", "SKIPL" and "SEEDED" of trex_control(), and "SEEDED" equals "STANDARD" here. "PERMUTATION" and "PERMUTATION_SEEDED" are refused, because a row permutation destroys the covariance of the dummies within a cluster.

Super class

TRexSelector -> TRexGVSSelector

Active bindings

lambda2_used

lambda_2 of the last select(): the supplied value, or the pick of the cross-validation rule lambda2_method.

lambda2_cv_diagnostics

Health record of the lambda_2 tuner of the last select(): a list with ran, seconds, n_profile_at_edge (lambda_2 values whose profiled lambda_1 optimum sat on a truncation edge; 0 is healthy), support_cap (-1 = disabled), dfmax_ratio (IEN tuner: the cv_dfmax_ratio it was called with; 0 when no IEN-geometry tuner ran), low_dimensional, and the boundary-pick guard fields: grid_index / grid_size (0-based position of the returned lambda_2 on the tuner's grid), at_grid_edge (the pick is the first or last grid point, so the grid boundary rather than a CV optimum), profile_at_edge (IEN tuner: the profiled lambda_1 optimum of the chosen lambda_2 sat on the truncation edge), profile_at_support_cap (that edge is the support cap; raise cv_dfmax_ratio to move it) and boundary_pick (at_grid_edge or profile_at_edge; the selector warned once and returned the pick unchanged).

gvs_type

Penalty of the grouped selection that was applied, "EN" or "IEN".

max_clusters

Number of groups M, supplied or found by the clustering.

groups

Integer vector of length p giving the group of each variable, numbered from 1: the supplied groups, or the assignment of the clustering.

group_labels

Optional human-readable cluster names (length max_clusters), or an empty character vector when none were supplied.

hc_method_used

Origin of the groups: "prior" when they were supplied, else the linkage of the clustering, "single", "complete", "average" or "wpgma".

Methods

Public methods

Inherited methods

TRexGVSSelector$new()

Create a new TRexGVSSelector object.

Usage
TRexGVSSelector$new(
  X,
  y,
  tFDR = 0.1,
  seed = -1,
  verbose = TRUE,
  gvs_control = trex_gvs_control(),
  control = NULL
)
Arguments
X

Feature matrix in memory, or an mmap_matrix, the handle of a memory-mapped file. Both are bound without a copy. The selector standardizes a memory-mapped design in place and restores it, which needs "readwrite" mode. Under scaling_mode = "NONE" it writes nothing and "readonly" mode suffices.

y

Response vector.

tFDR

Target FDR level (default: 0.1).

seed

Random seed. A negative value (default: -1) gives a run that is not reproducible.

verbose

Whether to print progress (default: TRUE).

gvs_control

A GVS control list from trex_gvs_control() (default: trex_gvs_control()). For gvs_type = "EN" its en_solver chooses the solver, "TENET" by default. "TCDENET" and "TCDIENET" are deprecated and will be removed in TRexSelector 2.1.0: the selector raises a deprecation warning for them.

control

A control list from trex_control(), or NULL (default). With NULL the base control of the C++ class applies: the defaults of trex_control() with the solver "TENET". A control that is passed is taken as it is, so it has to name a solver of the track. For gvs_type = "EN" its solver must be "TENET" or the solver of en_solver. For gvs_type = "IEN" it must be "TIENET" (native pathwise) or "TIENET_AUG" (row-augmented), so the IEN track needs a base control: trex_control(solver = "TIENET", ...). Every other solver is an error, also "TLARS", the default of trex_control().


TRexGVSSelector$select()

Run the GVS algorithm. A selector runs once: a second call is an error, see TRexSelector.

Usage
TRexGVSSelector$select()

TRexGVSSelector$clone()

The objects of this class are cloneable with this method.

Usage
TRexGVSSelector$clone(deep = FALSE)
Arguments
deep

Whether to make a deep clone.

References

J. Machkour, M. Muma, and D. P. Palomar, "False Discovery Rate Control for Grouped Variable Selection in High-Dimensional Linear Models Using the T-Knock Filter," in Proc. 30th Eur. Signal Process. Conf. (EUSIPCO), 2022, pp. 892-896.

J. Machkour, M. Muma, and D. P. Palomar, "The Informed Elastic Net for Fast Grouped Variable Selection and FDR Control in Genomics Research," in Proc. IEEE 9th Int. Workshop Comput. Adv. Multi-Sensor Adapt. Process. (CAMSAP), 2023, pp. 466-470.

H. Zou and T. Hastie, "Regularization and Variable Selection via the Elastic Net," J. R. Stat. Soc. Ser. B Stat. Methodol., vol. 67, no. 2, pp. 301-320, 2005.

J. Machkour, M. Muma, and D. P. Palomar, "The Terminating-Random Experiments Selector: Fast High-Dimensional Variable Selection with False Discovery Rate Control," Signal Process., vol. 231, Art. no. 109894, 2025, doi: 10.1016/j.sigpro.2025.109894.

See Also

Other T-Rex selectors and controls: Gauss_data, TRexBiobankScreeningSelector, TRexDASelector, TRexSPCASelector, TRexScreeningSelector, TRexSelector, TRexTikhonovSelector, trex_biobank_control(), trex_build_group_centering_k(), trex_control(), trex_da_control(), trex_default_lambda2_grid(), trex_dummy_distribution(), trex_fdp(), trex_fdp_dense(), trex_gamma_to_k(), trex_get_num_threads(), trex_gvs_control(), trex_gvs_lambda2_power_rule(), trex_normalize_design(), trex_precision(), trex_recall(), trex_screen_control(), trex_spca_control(), trex_tikhonov_control(), trex_tikhonov_lambda2_power_rule(), trex_tpp(), trex_tpp_dense()

Examples


data(Gauss_data)
X <- Gauss_data$X
y <- Gauss_data$y
sel <- TRexGVSSelector$new(X, y, tFDR = 0.1, verbose = FALSE,
                           gvs_control = trex_gvs_control(gvs_type = "EN"))
sel$select()
sel$selected_indices


TRexSelector documentation built on Nov. 20, 2026, 5:09 p.m.