est_gs: Determine point estimates in a group sequential single-arm...

In mjg211/singlearm: Design and analysis of single-arm clinical trials

Description

Determines possible point estimates at the end of a group sequential single-arm trial for a single binary endpoint, as determined using des_gs(). Support is available to compute point estimates using the naive ("naive"), bias-adjusted ("bias_adj"), bias-subtracted ("bias_sub"), conditional ("conditional"), median unbiased ("mue"), UMVUE ("umvue"), and UMVCUE ("umvcue") approaches.

Usage

est_gs(des, k, pi, method = c("bias_adj", "bias_sub", "conditional",
  "naive", "mue", "umvcue", "umvue"), summary = F)

Arguments

des	An object of class "sa_des_gs", as returned by des_gs().
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 the maximum number of possible stages. If left unspecified, it will internally default to all possible stages.
pi	A vector of response probabilities to evaluate the expected performance of the point estimation procedures at. This will internally default to be the π0 and π1 from des if it is left unspecified.
method	A vector of methods to use to construct point estimates. Currently, support is available to use the naive ("naive"), bias-adjusted ("bias_adj"), bias-subtracted ("bias_sub"), conditional ("conditional"), median unbiased ("mue"), UMVUE ("umvue"), and UMVCUE ("umvcue") approaches. Defaults to all available methods.
summary	A logical variable indicating whether a summary of the function's progress should be printed to the console.

Details

In addition, the performance of the chosen point estimate procedures (including their expected value and variance) for each value of pi in the supplied vector pi, will also be evaluated.

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_est_gs" containing the following elements

• A tibble in the slot $est summarising the possible point estimates at the end of the trial for the supplied design, according to the chosen methods.

• A tibble in the slot $perf summarising the performance of the chosen point estimation procedures for each specified value of π.

• Each of the input variables as specified, subject to internal modification.

See Also

des_gs, opchar_gs, pval_gs, ci_gs, and their associated plot family of functions.

Examples

# Find the optimal two-stage design for the default parameters
des <- des_gs()
# Determine the performance of all supported point estimation procedures for
# a range of possible response probabilities
est <- est_gs(des, pi = seq(0, 1, 0.01))

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