plot.forestsearch

Dispatches to <code>plot_sg_results</code> for Kaplan-Meier curves,
hazard-ratio forest plots, or combined panels.

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.forestsearch function

<dl><dt>x</dt>
<dd>A <code>forestsearch</code> object returned by
<code>forestsearch</code>.</dd>
<dt>type</dt>
<dd>Character. Type of plot:<dl>
<dt><code>"combined"</code></dt>
<dd>KM curves + forest plot (default)</dd></dl></dd><dt><code>"km"</code></dt>
<dd>Kaplan-Meier survival curves only</dd><dt><code>"forest"</code></dt>
<dd>Hazard-ratio forest plot only</dd><dt><code>"summary"</code></dt>
<dd>Summary statistics panel</dd>
</dl>
<dt>outcome.name</dt>
<dd>Character. Name of time-to-event column.
Default: <code>"Y"</code>.</dd>
<dt>event.name</dt>
<dd>Character. Name of event indicator column.
Default: <code>"Event"</code>.</dd>
<dt>treat.name</dt>
<dd>Character. Name of treatment column.
Default: <code>"Treat"</code>.</dd>
<dt>...</dt>
<dd>Additional arguments passed to <code>plot_sg_results</code>,
such as <code>by.risk</code>, <code>conf.level</code>, <code>est.scale</code>,
<code>sg0_name</code>, <code>sg1_name</code>, <code>treat_labels</code>, <code>colors</code>,
<code>title</code>, <code>show_events</code>, <code>show_ci</code>, <code>show_logrank</code>,
<code>show_hr</code>.</dd>

Arguments

Plot ForestSearch Results — plot.forestsearch

<dl>

<dt>x</dt>
<dd>A <code>forestsearch</code> object returned by
<code>forestsearch</code>.</dd>


<dt>type</dt>
<dd>Character. Type of plot:<dl>
<dt><code>"combined"</code></dt>
<dd>KM curves + forest plot (default)</dd>

<dt><code>"km"</code></dt>
<dd>Kaplan-Meier survival curves only</dd>

<dt><code>"forest"</code></dt>
<dd>Hazard-ratio forest plot only</dd>

<dt><code>"summary"</code></dt>
<dd>Summary statistics panel</dd>


</dl></dd>


<dt>outcome.name</dt>
<dd>Character. Name of time-to-event column.
Default: <code>"Y"</code>.</dd>


<dt>event.name</dt>
<dd>Character. Name of event indicator column.
Default: <code>"Event"</code>.</dd>


<dt>treat.name</dt>
<dd>Character. Name of treatment column.
Default: <code>"Treat"</code>.</dd>


<dt>...</dt>
<dd>Additional arguments passed to <code>plot_sg_results</code>,
such as <code>by.risk</code>, <code>conf.level</code>, <code>est.scale</code>,
<code>sg0_name</code>, <code>sg1_name</code>, <code>treat_labels</code>, <code>colors</code>,
<code>title</code>, <code>show_events</code>, <code>show_ci</code>, <code>show_logrank</code>,
<code>show_hr</code>.</dd>

</dl>

plot.forestsearch: Plot ForestSearch Results

Description

Usage

Value

Arguments

See Also