*! version 1.0 14 May 2018

Title

est_gs -- Determine point estimates in a group sequential single-arm trial design for a single binary endpointt

Syntax

est_gs
[,
options]

Main
j(#) The maximal number of stages to allow. Defaults to 2.

n(numlist) Numlist of stage-wise sample sizes. Internally defaults to 10,19.

a(numlist miss) Numlist of acceptance boundaries. Internally defaults to 1,5.

r(numlist miss) Numlist of rejection boundaries. Internally defaults to .,6.

k(numlist) Calculations are performed conditional on the trial stopping in one of the stages listed in numlist k. Thus, k should be a numlist 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(numlist) Numlist of response probabilities to evaluate the expected performance of the point estimation procedures at. This will internally default to 0,0.01,...,1.

method(string) A string indicating which method(s) 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. Internally defaults to all available methods.

summary(#) An integer indicating whether a summary of the function's progress should be printed (summary = 1) to the console. Defaults to 0.

plot Indicates whether a plot should be produced. If set to bias that the bias curve will be procedured. If set to rmse then the RMSE curve will be produced.

* Additional options to use during plotting.

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.

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 (numlist) k.

Options

Main

j(#) The maximal number of stages to allow. Defaults to 2.

n(numlist) Numlist of stage-wise sample sizes. Internally defaults to 10,19.

a(numlist miss) Numlist of acceptance boundaries. Internally defaults to 1,5.

r(numlist miss) Numlist of rejection boundaries. Internally defaults to .,6.

k(numlist) Calculations are performed conditional on the trial stopping in one of the stages listed in numlist k. Thus, k should be a numlist 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(numlist) Numlist of response probabilities to evaluate the expected performance of the point estimation procedures at. This will internally default to 0,0.01,...,1.

method(string) A string detailing the method(s) 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. Internally defaults to all available methods.

summary(#) An integer indicating whether a summary of the function's progress should be printed (summary = 1) to the console. Defaults to 0.

plot Indicates whether a plot should be produced. If set to bias that the bias curve will be procedured. If set to rmse then the RMSE curve will be produced.

* Additional options to use during plotting.

Examples

est_gs

est_gs, n(15, 10) a(1, 5) r(., 6)

Author

Michael J. Grayling, MRC Biostatistics Unit, Cambridge.

Email mjg211@cam.ac.uk

See Also

Related commands:

des_gs (if installed)
opchar_gs (if installed)
ci_gs (if installed)
pval_gs (if installed)