trex_dummy_distribution: T-Rex Dummy Variable Distribution

View source: R/control_parameters.R

trex_dummy_distributionR Documentation

T-Rex Dummy Variable Distribution

Description

Build a distribution specification for the dummy variables injected by the T-Rex Selector. Pass the result to the dummy_distribution argument of trex_control.

Usage

trex_dummy_distribution(
  type = "Normal",
  a = NULL,
  df = NULL,
  location = NULL,
  scale = NULL,
  b = NULL,
  c = NULL,
  dim = NULL,
  s = NULL,
  p1 = NULL,
  p2 = NULL
)

Arguments

type

Character string naming the distribution. One of: "Normal", "Uniform", "Rademacher", "StudentT", "Laplace", "Gumbel", "Triangle", "UniformSphere", "Mammen", "ConstrainedSparseRademacher", "Logistic". Defaults to "Normal".

a

Half-range of "Uniform", which draws from U(-a, a) (default: sqrt(3), unit variance), or lower bound of "Triangle" (default: -sqrt(6)).

df

Degrees of freedom of "StudentT" (default: 5).

location

Location parameter of "Laplace", "Gumbel" and "Logistic" (default: 0).

scale

Scale parameter of "Laplace" (default: 1/sqrt(2)), "Gumbel" (default: 1) and "Logistic" (default: sqrt(3)/pi).

b

Mode of "Triangle" (default: 0).

c

Upper bound of "Triangle" (default: sqrt(6)).

dim

Dimension of the sphere of "UniformSphere" (default: 3).

s

Sparsity parameter of "ConstrainedSparseRademacher" in (0, 1] (default: 0.1). An entry is +1 or -1 with probability s/2 each and 0 otherwise, and s = 1 gives the Rademacher distribution.

p1, p2

Probabilities of the two points of "Mammen", -(sqrt(5) - 1)/2 and (sqrt(5) + 1)/2 (defaults: (sqrt(5) + 1)/(2 sqrt(5)) and (sqrt(5) - 1)/(2 sqrt(5))).

Value

A named list describing the dummy distribution, for use in trex_control.

References

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.

E. Mammen, "Bootstrap and Wild Bootstrap for High Dimensional Linear Models," Ann. Statist., vol. 21, no. 1, pp. 255-285, 1993, doi: 10.1214/aos/1176349025.

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_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

# Standard Normal (default)
trex_dummy_distribution()

# Student-t with 3 degrees of freedom
trex_dummy_distribution("StudentT", df = 3)


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