extract_fs_estimates

Extracts operating characteristics (HRs, classification metrics, etc.)
from ForestSearch analysis results. Aligned with new DGM output structure.

internal

Implements statistical methods for exploratory subgroup identification
in clinical trials with survival endpoints. Provides tools for identifying
patient subgroups with differential treatment effects using machine learning
approaches including Generalized Random Forests (GRF), LASSO regularization,
and exhaustive combinatorial search algorithms. Features bootstrap bias
correction using infinitesimal jackknife methods to address selection bias
in post-hoc analyses. Designed for clinical researchers conducting exploratory
subgroup analyses in randomized controlled trials, particularly for
multi-regional clinical trials (MRCT) requiring regional consistency
evaluation. Supports both accelerated failure time (AFT) and Cox proportional
hazards models with comprehensive diagnostic and visualization tools.
Methods are described in León et al. (2024) <doi:10.1002/sim.10163>.

Larry Leon

forestsearch

Exploratory Subgroup Identification in Clinical Trials with
Survival Endpoints

extract_fs_estimates function

<dl><dt>df</dt>
<dd>Simulated data frame</dd>
<dt>fs_res</dt>
<dd>ForestSearch result table (grp.consistency$out_sg$result, or NULL)</dd>
<dt>dgm</dt>
<dd>DGM object containing true HRs (supports both old and new formats)</dd>
<dt>cox_formula</dt>
<dd>Cox formula for estimation (optional)</dd>
<dt>cox_formula_adj</dt>
<dd>Adjusted Cox formula (optional)</dd>
<dt>analysis</dt>
<dd>Analysis label (e.g., "FS", "FSlg")</dd>
<dt>fs_full</dt>
<dd>Full forestsearch result object (for df.est access)</dd>
<dt>verbose</dt>
<dd>Logical. Print extraction details. Default: FALSE</dd></dl>

Arguments

Extract Estimates from ForestSearch Results — extract_fs_estimates

<dl>

<dt>df</dt>
<dd>Simulated data frame</dd>


<dt>fs_res</dt>
<dd>ForestSearch result table (grp.consistency$out_sg$result, or NULL)</dd>


<dt>dgm</dt>
<dd>DGM object containing true HRs (supports both old and new formats)</dd>


<dt>cox_formula</dt>
<dd>Cox formula for estimation (optional)</dd>


<dt>cox_formula_adj</dt>
<dd>Adjusted Cox formula (optional)</dd>


<dt>analysis</dt>
<dd>Analysis label (e.g., "FS", "FSlg")</dd>


<dt>fs_full</dt>
<dd>Full forestsearch result object (for df.est access)</dd>


<dt>verbose</dt>
<dd>Logical. Print extraction details. Default: FALSE</dd>

</dl>

extract_fs_estimates: Extract Estimates from ForestSearch Results

Description

Usage

Value

Arguments