*! version 1.0 14 May 2018

Title

ci_gs -- Determine confidence intervals in a group sequential single-arm trial design for a single binary endpoint

Syntax

ci_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.

alpha(#) alpha-level to use in confidence interval construction. Defaults to 0.05.

pi(numlist) Numlist of response probabilities to evaluate the expected performance of the p-value calculation procedures at. This will internally default to 0,0.01,...,1.

method(string) A string indicating which method(s) to use to construct confidence intervals. Currently, support is available to use the naive (naive), exact (exact), and Mid-p (mid_p) 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 length that the expected length curve will be procedured. If set to coverage then the coverage curve will be produced.

* Additional options to use during plotting.

Description

Determines possible confidence intervals 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 confidence intervals using the naive (naive), exact (exact),
and Mid-p (mid_p) approaches.

In addition, the performance of the chosen confidence interval determination
procedures (including their coverage and expected length) 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.

alpha(#) alpha-level to use in confidence interval construction. Defaults to 0.05.

pi(numlist) Numlist of response probabilities to evaluate the expected performance of the p-value calculation procedures at. This will internally default to 0,0.01,...,1.

method(string) A string indicating which method(s) to use to construct confidence intervals. Currently, support is available to use the naive (naive), exact (exact), and Mid-p (mid_p) 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 length that the expected length curve will be procedured. If set to coverage then the coverage curve will be produced.

* Additional options to use during plotting.

Examples

ci_gs

ci_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)
est_gs (if installed)
pval_gs (if installed)