opchar_adaptive: Determine the operating characteristics of adaptive two-stage...

Description Usage Arguments Details Value See Also Examples

View source: R/opchar_adaptive.R

Description

opchar_adaptive() supports the simultaneous evaluation of the operating characteristics of multiple adaptive two-stage single-arm clinical trial designs for a single binary primary endpoint, determined using des_adaptive().

Usage

1
opchar_adaptive(des, ..., k, pi, summary = F)

Arguments

des

An object of class "sa_des_adaptive", as returned by des_adaptive().

...

Additional objects of class "sa_des_adaptive". These will be grouped in to a list named "add_des".

k

Calculations are performed conditional on the trial stopping in one of the stages listed in vector k. Thus, k should be a vector of integers, with elements between one and two. If left unspecified, it will internally default to all possible stages.

pi

A vector of response probabilities to evaluate operating characteristics at. This will internally default to be the π0 and π1 from the supplied designs if it is left unspecified.

summary

A logical variable indicating whether a summary of the function's progress should be printed to the console.

Details

Note that each of the supplied designs must have been designed for the same value of π0.

For each value of pi) in the supplied vector pi), opchar_adaptive() evaluates the power, ESS, and other key characteristics, of each of the supplied designs.

Calculations are performed conditional on the trial stopping in one of the stages specified using the input (vector) k.

Value

A list of class "sa_opchar_adaptive" containing the following elements

See Also

des_adaptive, and their associated plot family of functions.

Examples

1
2
3
4
5
# Find the optimal adaptive design for the default parameters
des    <- des_adaptive()
# Find its operating characteristics for a range of possible response
# probabilities
opchar <- opchar_adaptive(des)

mjg211/singlearm documentation built on May 8, 2021, 3:17 a.m.