| TRexGVSSelector | R Documentation |
FDR-controlled variable selection for groups of highly correlated variables.
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.
TRexSelector -> TRexGVSSelector
lambda2_usedlambda_2 of the last select(): the supplied value,
or the pick of the cross-validation rule lambda2_method.
lambda2_cv_diagnosticsHealth 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_typePenalty of the grouped selection that was applied, "EN" or
"IEN".
max_clustersNumber of groups M, supplied or found by the clustering.
groupsInteger vector of length p giving the group of each
variable, numbered from 1: the supplied groups, or the assignment of the
clustering.
group_labelsOptional human-readable cluster names (length
max_clusters), or an empty character vector when none were
supplied.
hc_method_usedOrigin of the groups: "prior" when they were
supplied, else the linkage of the clustering, "single",
"complete", "average" or "wpgma".
TRexGVSSelector$new()Create a new TRexGVSSelector object.
TRexGVSSelector$new( X, y, tFDR = 0.1, seed = -1, verbose = TRUE, gvs_control = trex_gvs_control(), control = NULL )
XFeature 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.
yResponse vector.
tFDRTarget FDR level (default: 0.1).
seedRandom seed. A negative value (default: -1) gives a run that is not reproducible.
verboseWhether to print progress (default: TRUE).
gvs_controlA 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.
controlA 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.
TRexGVSSelector$select()
TRexGVSSelector$clone()The objects of this class are cloneable with this method.
TRexGVSSelector$clone(deep = FALSE)
deepWhether to make a deep clone.
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.
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()
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
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.