Empirically determine the operating characteristics of a multi-stage group-sequential multi-arm clinical trial for a Bernoulli distributed primary outcome

sim_gs_bern() determines the operating characteristics of a specified multi-stage group-sequential multi-arm clinical trial design assuming the primary outcome is Bernoulli distributed, for given values of the true treatment effects, using simulation.

sim_gs_bern(
  des = des_gs_bern(integer = TRUE),
  pi,
  replicates = 1e+05,
  summary = FALSE
)

Arguments

des	A list of class "multiarm_des_gs_bern", as returned by build_gs_bern or des_gs_bern (i.e., a multi-stage group-sequential multi-arm clinical trial design for a Bernoulli distributed outcome). Note: The sample sizes in all arms must be whole numbers. Defaults to des_gs_bern(integer = TRUE).
pi	A matrix whose rows indicate values of π at which to evaluate the operating characteristics. Defaults internally to the global null, global alternative, and each of the least favourable configurations if unspecified.
replicates	A numeric indicating the number of replicate simulations to use for each value of τ. Defaults to 1e5.
summary	A logical variable indicating whether a summary of the function's progress should be printed to the console. Defaults to FALSE.

Value

A list containing the following elements

• A tibble in the slot $sim giving the estimated operating characteristics.

• Each of the input variables.

See also

build_gs_bern, des_gs_bern, opchar_gs_bern, plot.multiarm_des_gs_bern.

Examples

if (FALSE) {
# The estimated operating characteristics for the default parameters
sim   <- sim_gs_bern()
}