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

Source: `R/sim_gs_bern.R`
`sim_gs_bern.Rd`

`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()
    }