# Empirically determine the operating characteristics of a multi-stage drop-the-losers multi-arm clinical trial for a Poisson distributed primary outcome

Source: `R/sim_dtl_pois.R`
`sim_dtl_pois.Rd`

`sim_dtl_pois()` determines the operating characteristics of a specified multi-stage drop-the-losers multi-arm clinical trial design assuming the primary outcome is Poisson distributed, for given values of the true treatment effects, using simulation.

    sim_dtl_pois(
      des = des_dtl_pois(integer = TRUE),
      lambda,
      replicates = 1e+05,
      summary = FALSE
    )

## Arguments

des | A `list` of class `"multiarm_des_dtl_pois"`, as returned by `build_dtl_pois` or `des_dtl_pois` (i.e., a multi-stage drop-the-losers multi-arm clinical trial design for a Poisson distributed outcome). Note: The sample sizes in all arms must be whole numbers. Defaults to `des_dtl_pois(integer = TRUE)`.
lambda | 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_dtl_pois`, `des_dtl_pois`, `opchar_dtl_pois`, `plot.multiarm_des_dtl_pois`.

## Examples

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