# CV.CondPoisson: Critical Values for continuous sequential CMaxSPRT for... In Sequential: Exact Sequential Analysis for Poisson and Binomial Data

## Description

The function `CV.CondPoisson` calculates critical values for the continuous sequential CMaxSPRT, using a Wald-type upper boundary, which is flat with respect to the likelihood ratio function, and a pre-specified upper limit on surveillance length.

## Usage

 ```1 2``` ```CV.CondPoisson(Inference="exact", StopType="Cases",T="n",K="n",cc, D=0,M=1,alpha=0.05) ```

## Arguments

 `Inference` Inference='liberal', 'exact', or 'conservative' for the computation approach. Inference='liberal' for the liberal approach with possibly underestimated critival values and higher-than-nominal Type I error rate, Inference='exact' for the exact approach with exact critival values and nominal Type I error rates, Inference='conservative' for the conservative approach with possibly overestimated critival values and lower-than-nominal Type I error rates. The default is Inference="exact". `StopType` StopType='Tal' or 'Cases' for the type of surveillance length definition. With StopType='Tal', the maximum surveillance length (i.e., the upper limit) is defined in terms of the ratio of the cumulative person-time in the surveillance population divided by the total cumulative person-time in historical data, i.e., P_k/V ≤q T; with StopType='Cases', the maximum surveillance length is defined interms of the observed number of events in the surveillance population, i.e., k ≤q K. The default is StopType="Cases" `cc` The total number of observed adverse events in the historical data. There is no default value. `K` The upper limit on length of surveillance expressed in terms of the observed number of events in the surveillance population, i.e., k ≤q K. This argument K is used if and only if StopType='Cases'. There is no default value. `T` The upper limit on length of surveillance expressed in terms of the ratio of the cumulative person-time in the surveillance population divided by the total cumulative person-time in historical data, i.e., P_k/V ≤ T. This argument T is used if and only if StopType='Tal'. There is no default value. `D` The minium number for the ratio P_k/V before the null hypothesis can be rejected. This argument is used together with T. The default value is D=0. A delayed start with D>0 is recommended to avoid signaling very early on such that very little information would be available to judge whether the signal is more likely to be a true signal or chance finding. `M` The minimum number of events needed before the null hypothesis can be rejected. This argument is used together with K. A delayed start with M>1 is recommended to avoid signaling very early on such that very little information would be available to judge whether the signal is more likely to be a true signal or chance finding. The default value is M=1. `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.

## Details

For continuous sequential analysis with CMaxSPRT for Poisson data and limited historical data, `CV.CondPoisson` 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 which can be defined based on either the observed number of events, "K", or the ratio "T" between the cumulative person-times in the surveillance population versus the historical data, as well as other parameter settings.

The test is one-sided, so that the null hypothesis is only rejected when there are more events than expected.

Following the results of Silva et al. (2016), the function offers three computation approaches which calculate liberal, exact, and conservative critical values respectively. When the upper limit is medium (e.g., K=50) or large, the computational requirements for the exact approach can be high. The recommendation is to use the exact approach when the upper limit is small (e.g., K=10), use the conservative approach when the upper limit is medium (K=50) or large but cc is small, and use the liberal approach when cc is medium (e.g., 50) or large. Exact numerical results show that the three approaches yield very similar results when K and cc are reasonably large.

## Value

 `Type_I_Error` The actual Type I error, for the exact approach. It equals the nominal level specified by the argument "alpha". For the liberal approach, the actual Type I error rate may be higher than the specified nominal level. For the conservative approach, the actual Type I error rate may be lower than the specified nominal level. `cv` The critical value for a significance level. For the exact approach, it is the exact critical value, for the liberal approach, it is the smallest liberal vaue, for the conservative approach, it is the largest conservative value.

## Acknowledgements

Development of the `CV.CondPoisson` function was funded by:
- National Institute of General Medical Sciences, NIH, USA, through grant number R01GM108999 (v2.0.1, v2.0.2).

`SampleSize.CondPoisson`: calculating the upper limit with given Alpha, RR, and a desired power level for continuous CMaxSPRT.
`Performance.CondPoisson`: calculating the statistical power, expected time to signal and expected time of analysis for continuous CMaxSPRT.

## Author(s)

Ivair Ramos Silva, Lingling Li

## References

Li L, Kulldorff M. (2010). A conditional maximized sequential probability ratio test for pharmacovigilance. Statistics in Medicine, 30;29(2):284-95.

Silva IR, Li L, Kulldorff M. (2016). Exact Conditional Sequential Testing for Poisson Data. Working paper.

## Examples

 ``` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29``` ```# Calculates the exact critical value with upper limit of # K=20 and a delayed start of a minimum of 2 cases, historical # data has 20 events, and for a statistical significance level # of 0.05. # res<- CV.CondPoisson(Inference="exact", StopType="Cases",K=20,cc=20, # M=2,alpha=0.05) # which gives the results: # res # \$Type_I_Error # [1] 0.05 # \$cv # [1] 3.149115 # Calculates the liberal critical value with a uppe limit of # T=0.5 and a delayed start of D=0.1, i.e., the cumulative # person-time in the surveillance population is at least # one-tenth of the total cumulative person-time in historical # data, historical data has 20 events, and for a statistical # significance level of 0.05. # res2<- CV.CondPoisson(Inference="liberal",StopType="Tal",T=0.5,cc=20, # D=0.1,alpha=0.05) # which gives the results: # res2 # \$Type_I_Error # [1] 0.05 # \$cv # [1] 2.874993 ```

Sequential documentation built on Aug. 2, 2017, 9:01 a.m.