Used internally. Extracts overall trial statuses or statuses from a single
arm from multiple trial simulations. Works with sparse results.
extract_statuses(object, x_value, arm = NULL)A tidy data.frame (one row possible status per look) containing the
following columns:
x: the look numbers or total number of patients at each look,
as specified in x_value.
status: each possible status ("Recruiting", "Inferiority"
(only relevant for individual arms), "Futility", "Equivalence", and
"Superiority", as relevant).
p: the proportion (0-1) of patients with each status at each
value of x.
value: as described under metric.
trial_results object from run_trials().
single character string, determining whether the number of
adaptive analysis looks ("look", default), the total cumulated number of
patients randomised ("total n") or the total cumulated number of patients
with outcome data available at each adaptive analysis ("followed n") are
plotted on the x-axis.
character vector containing one or more unique, valid arm names,
NA, or NULL (default). If NULL, the overall trial statuses are plotted,
otherwise the specified arms or all arms (if NA is specified) are plotted.