{smcl}
{* *! version 1.0 14 May 2018}{...}
{vieweralsosee "" "--"}{...}
{vieweralsosee "Install command2" "ssc install command2"}{...}
{vieweralsosee "Help command2 (if installed)" "help command2"}{...}
{viewerjumpto "Syntax" "est_gs##syntax"}{...}
{viewerjumpto "Description" "est_gs##description"}{...}
{viewerjumpto "Options" "est_gs##options"}{...}
{viewerjumpto "Remarks" "est_gs##remarks"}{...}
{viewerjumpto "Examples" "est_gs##examples"}{...}
{title:Title}
{phang}
{bf:est_gs} {hline 2} Determine point estimates in a group sequential single-arm trial design for a single binary endpointt
{marker syntax}{...}
{title:Syntax}
{p 8 17 2}
{cmdab:est_gs}
[{cmd:,}
{it:options}]
{synoptset 20 tabbed}{...}
{synopthdr}
{synoptline}
{syntab:Main}
{synopt:{opt j(#)}} The maximal number of stages to allow. Defaults to 2.{p_end}
{synopt:{opt n(numlist)}} Numlist of stage-wise sample sizes. Internally defaults to 10,19.{p_end}
{synopt:{opt a(numlist miss)}} Numlist of acceptance boundaries. Internally defaults to 1,5.{p_end}
{synopt:{opt r(numlist miss)}} Numlist of rejection boundaries. Internally defaults to .,6.{p_end}
{synopt:{opt 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.{p_end}
{synopt:{opt 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.{p_end}
{synopt:{opt 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.{p_end}
{synopt:{opt sum:mary(#)}} An integer indicating whether a summary of the function's progress should be printed (summary = 1) to the console. Defaults to 0.{p_end}
{synopt:{opt pl:ot}} 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.{p_end}
{synopt:{opt *}} Additional options to use during plotting.{p_end}
{synoptline}
{p2colreset}{...}
{p 4 6 2}
{marker description}{...}
{title:Description}
{pstd}
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.
{marker options}{...}
{title:Options}
{dlgtab:Main}
{phang}
{opt j(#)} The maximal number of stages to allow. Defaults to 2.
{phang}
{opt n(numlist)} Numlist of stage-wise sample sizes. Internally defaults to 10,19.
{phang}
{opt a(numlist miss)} Numlist of acceptance boundaries. Internally defaults to 1,5.
{phang}
{opt r(numlist miss)} Numlist of rejection boundaries. Internally defaults to .,6.
{phang}
{opt 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.
{phang}
{opt 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.
{phang}
{opt 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.
{phang}
{opt sum:mary(#)} An integer indicating whether a summary of the function's progress should be printed (summary = 1) to the console. Defaults to 0.
{phang}
{opt pl:ot} 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.
{phang}
{opt *} Additional options to use during plotting.
{marker examples}{...}
{title:Examples}
{phang}
{stata est_gs}
{phang}
{stata est_gs, n(15, 10) a(1, 5) r(., 6)}
{title:Author}
{p}
Michael J. Grayling, MRC Biostatistics Unit, Cambridge.
Email {browse "mjg211@cam.ac.uk":mjg211@cam.ac.uk}
{title:See Also}
Related commands:
{help des_gs} (if installed)
{help opchar_gs} (if installed)
{help ci_gs} (if installed)
{help pval_gs} (if installed)