check_remaining_arms {adaptr}  R Documentation 
This function summarises the numbers and proportions of all combinations of
remaining arms (i.e., excluding arms dropped for inferiority or futility at
any analysis, and arms dropped for equivalence at earlier analyses in trials
with a common control
) across multiple simulated trial results. The
function supplements the extract_results()
, check_performance()
, and
summary()
functions, and is especially useful for designs with > 2
arms,
where it provides details that the other functionality mentioned do not.
check_remaining_arms(object, ci_width = 0.95)
object 

ci_width 
single numeric 
a data.frame
containing the combinations of remaining arms, sorted
in descending order of, with the following columns:
arm_*
, one column per arm, each named as arm_<arm name>
. These
columns will contain an empty character string ""
for dropped arms
(including arms dropped at the final analysis), and otherwise be
"superior"
, "control"
, "equivalence"
(only if equivalent at the
final analysis), or "active"
, as described in run_trial()
.
n
integer vector, number of trial simulations ending with the
combination of remaining arms as specified by the preceding columns.
prop
numeric vector, the proportion of trial simulations ending
with the combination of remaining arms as specified by the preceding
columns.
se
,lo_ci
,hi_ci
: the standard error of prop
and the confidence
intervals of the width specified by ci_width
.
extract_results()
, check_performance()
, summary()
,
plot_convergence()
, plot_metrics_ecdf()
.
# Setup a trial specification
binom_trial < setup_trial_binom(arms = c("A", "B", "C", "D"),
control = "A",
true_ys = c(0.20, 0.18, 0.22, 0.24),
data_looks = 1:20 * 200,
equivalence_prob = 0.7,
equivalence_diff = 0.03,
equivalence_only_first = FALSE)
# Run 35 simulations with a specified random base seed
res < run_trials(binom_trial, n_rep = 25, base_seed = 12345)
# Check remaining arms (printed with fewer digits)
print(check_remaining_arms(res), digits = 3)