plot_subgroup

Plots weighted Kaplan-Meier survival curves for a specified subgroup and its complement using the weightedsurv package.

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

plot_subgroup function

<dl><dt>df.sub</dt>
<dd>A data frame containing data for the subgroup of interest.</dd>
<dt>df.subC</dt>
<dd>A data frame containing data for the complement subgroup.</dd>
<dt>by.risk</dt>
<dd>Numeric. The risk interval for plotting (passed to <code>weightedsurv::df_counting</code>).</dd>
<dt>confs_labels</dt>
<dd>Named character vector. Covariate label mapping (not used directly in this function, but may be used for labeling).</dd>
<dt>this.1_label</dt>
<dd>Character. Label for the subgroup being plotted.</dd>
<dt>top_result</dt>
<dd>Data frame row. The top subgroup result row, expected to contain a <code>Pcons</code> column for consistency criteria.</dd></dl>

Arguments

Plot Subgroup Survival Curves — plot_subgroup

<dl>

<dt>df.sub</dt>
<dd>A data frame containing data for the subgroup of interest.</dd>


<dt>df.subC</dt>
<dd>A data frame containing data for the complement subgroup.</dd>


<dt>by.risk</dt>
<dd>Numeric. The risk interval for plotting (passed to <code>weightedsurv::df_counting</code>).</dd>


<dt>confs_labels</dt>
<dd>Named character vector. Covariate label mapping (not used directly in this function, but may be used for labeling).</dd>


<dt>this.1_label</dt>
<dd>Character. Label for the subgroup being plotted.</dd>


<dt>top_result</dt>
<dd>Data frame row. The top subgroup result row, expected to contain a <code>Pcons</code> column for consistency criteria.</dd>

</dl>

plot_subgroup: Plot Subgroup Survival Curves

Description

Usage

Arguments