trex_screen_control: T-Rex+Screening Control Parameters

View source: R/control_parameters.R

trex_screen_controlR Documentation

T-Rex+Screening Control Parameters

Description

Build a control list for the screening step in TRexScreeningSelector and TRexBiobankScreeningSelector.

Usage

trex_screen_control(
  use_bootstrap_CI = FALSE,
  R_boot = 1000,
  ci_grid_step = 0.001,
  trex_method = "TREX",
  cor_coef = -2,
  rho_thr_DA = 0.02,
  n_blocks = 5
)

Arguments

use_bootstrap_CI

Whether the confidence-based screening (bootstrap) makes the selection (default: FALSE). The FDR estimate stays one over the number of selected variables. With a dependency-aware variant it mostly selects nothing: the filter lowers the ordinary count that the confidence level has to reach, and in simulations no level reached it in 90 % to 100 % of the runs.

R_boot

Number of bootstrap resamples, at least 2 (default: 1000).

ci_grid_step

Step of the grid over the confidence level, in (0, 1] (default: 0.001).

trex_method

Variant of the screening (default: "TREX"). "TREX" screens without a dependency-aware filter. The other variants apply a dependency-aware filter to the relative occurrences. "TREX_DA_AR1", for a first-order autoregressive dependency, compares a variable with the neighbors inside the AR(1) window. "TREX_DA_EQUI", for equi-correlated variables, compares a variable with all other variables. "TREX_DA_BLOCK_EQUI", for block equi-correlated variables, makes the same comparison inside contiguous blocks. "TREX_DA_NN" compares a variable with the neighbors inside the AR(1) window whose sample correlation reaches rho_thr_DA, and a variable without such a neighbor keeps its relative occurrence. With a threshold at or above the correlation of the data no neighbor is left, and the variant selects as "TREX".

cor_coef

Correlation coefficient of the dependency-aware variants. -2.0 triggers auto-estimation (default: -2.0). The variants use the magnitude of a supplied coefficient. Any other value outside [-1, 1] gives a warning and is replaced by the estimate.

rho_thr_DA

Correlation threshold of the dependency-aware variants (default: 0.02). "TREX_DA_AR1": the window around a variable reaches ceiling(log(rho_thr_DA) / log(abs(cor_coef))) columns to each side, up to the first lag whose correlation abs(cor_coef)^lag has fallen to the threshold, range [0, 1). "TREX_DA_NN": the same window, of which the variables stay whose sample correlation with the variable reaches the threshold, range [0, 1). A threshold at or above the correlation of the data leaves no neighbor, the variant then selects as "TREX" and the filter protects no longer, so the threshold stays below the correlation that the filter is meant to guard against. At the default the variant selected as "TREX_DA_AR1" in simulations. "TREX_DA_EQUI" and "TREX_DA_BLOCK_EQUI": the filter is skipped when abs(cor_coef) does not exceed the threshold, range [0, 1].

n_blocks

Number of blocks of "TREX_DA_BLOCK_EQUI", between 1 and the number of variables (default: 5).

Value

A named list for use in TRexScreeningSelector or TRexBiobankScreeningSelector.

See Also

Other T-Rex selectors and controls: Gauss_data, TRexBiobankScreeningSelector, TRexDASelector, TRexGVSSelector, 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_spca_control(), trex_tikhonov_control(), trex_tikhonov_lambda2_power_rule(), trex_tpp(), trex_tpp_dense()

Examples

trex_screen_control()
trex_screen_control(use_bootstrap_CI = TRUE, R_boot = 500)


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