sim_dtl_pois: Empirically determine the operating characteristics of a...

View source: R/sim_dtl_pois.R

sim_dtl_poisR Documentation

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

Description

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.

Usage

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

## Not run: 
# The estimated operating characteristics for the default parameters
sim   <- sim_dtl_pois()

## End(Not run)

mjg211/multiarm documentation built on Jan. 19, 2024, 8:21 a.m.