Learn R Programming

Sequential (version 1.1)

CV.G.Poisson: Critical Values for Group Sequential Analysis with Poisson Data.

Description

The function CV.G.Poisson calculates the critical values for the group sequential MaxSPRT test with Poisson data, using a Wald type upper boundary, which is flat with respect to the likelihood ratio function, and with a pre-specified upper limit on the sample size.

Usage

CV.G.Poisson(SampleSize,alpha=0.05,Looks=1,M=1)

Arguments

SampleSize
The upper limit on the sample size (length of surveillance) expressed in terms of the expected number of events under the null hypothesis. "SampleSize" must be greater than 0. To avoid very large computation times, we suggest not using values greater th
M
The minimum number of events needed before the null hypothesis can be rejected. The default value is 'M=1'. If there are frequent looks at the data, so that the group sizes are extremely small, a value of 'M=1' means that even a single event can reject
alpha
The significance level, or the type 1 error probability, which is the probability of rejecting the null hypothesis when it is true. The alpha level must be in the range (0,0.5]. The default value is 'alpha=0.05'.
Looks
The maximum number of tests to be performed, which is, the number of equally spaced looks at the data if the null hypothesis is never rejected. The value must be an integer greater or equal to 1. The default value is 'Looks=1'.

Value

  • cvThe critical value for a significance level equal to alpha. The largest conservative value is provided when it is not possible to have a type I error that is exactly equal to 'alpha'.

Details

For group sequential analysis with Poisson data, CV.G.Poisson calculates the critical value that constitutes the upper boundary used to determine if the null hypothesis should be rejected. This is done for pre-specified values of the statistical significance level (alpha) and an upper limit on the sample size, determining the maximum length of surveillance, as well as other parameter settings. Details about the algorithm used to calculate the critical value is provided by Silva and Kulldorff (2012). For several configurations of 'SampleSize', 'Looks' and 'M' there is no critical value that gives a probability of Type I error that is exactly equal to "alpha". In such cases, the function CV.G.Poisson returns the largest critical value that will guarantee a type I error probability that is smaller than 'alpha', so that the sequential analysis is conservative. For large values of the maximum 'SampleSize', such as 200 or more, the computational requirements can be high.

References

Ivair R. Silva, Martin Kulldorff. (2012). Continuous versus Group Sequential Analysis for Vaccine and Drug Safety Surveillance. Manuscript, to be submitted. Jennison, V. and Turnbull, B. (1999), Group Sequential Methods with Applications to Clinical Trials, no. ISBN 0-8493-0316-8, London: Chapman and Hall/CRC. Martin Kulldorff, Ivair R. Silva. (2012). Continuous Sequential Analysis with a Delayed Start. Munuscript, under review. Martin Kulldorff, Robert L. Davis, Margarette Kolczak, Edwin Lewis, Tracy Lieu, and Richard Platt. (2011). A Maximized Sequential Probability Ratio Test for Drug and Safety Surveillance. Sequential Analysis, 30: 58--78.

Examples

Run this code
#  Calculates the critical value for five equally spaced group sequential looks, at 6, 12,
#  18, 24 and 30 expected events under the null hypothesis, and for a statistical signifi-
#  cance level of 0.05. 

CV.G.Poisson(SampleSize=30,alpha=0.05,Looks=5,M=1)

Run the code above in your browser using DataLab