n4propsMeta {CRTSize} | R Documentation |

This function provides the empirical power/variance reduction of an updated meta-analysis for a vector of the number of clusters to randomize per group and a vector of estimates of the ICC with a binary outcome measured using the (log) relative risk or odds ratio.

```
n4propsMeta(data, measure="RR", model="fixed", k, ICC, ICCDistn="unif",
lower=0, upper=0.25, varRed=FALSE, m, sdm, pC, sdpC, iter=1000, alpha=0.05)
```

`data` |
A matrix with completed studies in each row. The first column contains the estimate of the relative risk or odds ratio, the second column contains the 95 % lower limit and the third contains the 95 % upper limit. Note that the variance is estimated from the upper bound of these confidence intervals and risk differences are not permitted. |

`measure` |
Corresponds to the effect measure. Can be one of "RR" or "OR", corresponding to the Relative Risk or Odds Ratio. |

`model` |
One of fixed or random, corresponding to the fixed or random effects meta-analysis models. Note that the random effects model is estimated according to the DerSimonian-Laird estimate of the between-study variance. |

`k` |
A vector of the potential number of clusters to randomize to each of the treatment and control groups. Note that this function assumes an equal allocation to treatment and control group status. |

`ICC` |
A vector of potential values of the ICC, these can be obtained from the literature, pilot studies, etc. |

`ICCDistn` |
The hypothetical distribution of the ICC values. This can be set to "fixed" (note that only one ICC value is accepted for this option), "unif" on the range [lower, upper], "normal", corresponding to the truncated normal distribution (Turner et al, 2004), and "smooth" corresponding to the empirical smoothing option (Rotondi and Donner, 2009). |

`lower` |
The lower bound for the smoothing or unif options. Default value is zero. |

`upper` |
The upper bound for the smoothing or unif options. Default value is 0.25. |

`varRed` |
Logical; If varRed is set to TRUE, the proportionate reduction of variance is displayed for the fixed effects meta-analysis. |

`m` |
The mean cluster size. |

`sdm` |
The standard deviation of the mean cluster size. This adds additional real-world variation in the simulated study, using a normal model for large cluster sizes. |

`pC` |
The anticipated event in the control group. The anticipated treatment event is calculated from the simulated effect size of the preliminary meta-analysis. |

`sdpC` |
The standard deviation of the control rate. This is to generate real-world variation in the simulated study and can be precise or imprecise depending on the investigators preference. |

`iter` |
The number of iterations for each value of k and the ICC. This has a large impact on computational time. Default is 1000. |

`alpha` |
The desired type I error rate for calculation of confidence limits for the meta-analysis model. Note that for simplicity, this function assumes that each of the inputed lower and upper limits are 95 % confidence limits and this cannot be changed. |

This function calculates the empirical power of an updated meta-analysis by a generalization of Sutton et al. (2007) to the context of cluster randomized trials with a binary outcome. The procedure is summarized in the accompanying manuscript (Rotondi and Donner, 2012). In short, a hypothetical new study of a given size is simulated, then added to the meta-analysis. The results are re-meta-analyzed and it is verified whether the pooled result is statistically significant, or the appropriate reduction in variance of the pooled effect measure is recorded. Note that the proportion of variance reduction and power may not always (strictly) decrease with k, as the simulation exhibits individual-level variation. In addition, the random effects model does not guarantee that future studies will result in higher power due to the presence of between-study heterogeneity.

`power` |
The power of the updated meta-analysis. Presented as a vector corresponding to the number of clusters. |

`varianceReduction` |
The proportionate reduction in variance for the number of clusters in the fixed effects meta-analysis. |

`m` |
The mean cluster size. |

`data` |
The data matrix is returned. |

`newMean` |
The preliminary fixed (or random) effects log relative risk (RR) or odds ratio (OR). |

`newVar` |
The variance of the preliminary fixed (or random) effects log RR or log OR. |

`lF` |
The 100(1 - |

`uF` |
The 100(1 - |

`Var` |
The variance of the updated log RR/log OR. |

`k` |
The number of clusters randomized per group (vector). |

`ICC` |
A vector of ICC values. |

`ICCDistn` |
The distributional assumption about the ICC. |

`varRed` |
Variance Reduction: Logical. |

`sdm` |
The standard deviation of the mean cluster size. |

`pC` |
The mean control rate. |

`sdpC` |
The standard deviation of the control rate. |

`alpha` |
The desired type I error rate. |

`iter` |
The total number of iterations. |

Michael Rotondi, mrotondi@yorku.ca

Matthews JNS. Introduction to Randomized Controlled Clinical Trials (2nd Ed.) Chapman & Hall: New York, 2006.

Donner A and Klar N. Design and Analysis of Cluster Randomization Trials in Health Research. Arnold: London, 2000.

Sutton AJ et al. (2007) Evidence-based sample size calculations based upon updated meta-analysis. Statistics in Medicine, 26(12):2479-2500.

Turner R et al. (2004) Allowing for imprecision in the intracluster correlation coefficient in the design of cluster randomized trials. Statistics in Medicine, 23(8):1195-1214.

Rotondi M and Donner A. (2009) Sample Size Estimation in Cluster Randomized Trials: An Empirical Bayes Approach. Journal of Educational and Behavioral Statistics, 34:229-237.

Rotondi M and Donner A. (2012) Sample Size Estimation in Cluster Randomized Trials: An Evidence-Based Perspective. Computational Statistics and Data Analysis 56:1174-1187.

```
## Not run: A brief example with 10 iterations and a simple initial meta-analysis
of two studies with the following RRs and CIs:
## End(Not run)
n4propsMeta(data=rbind(c(0.800, 0.551, 1.162), c(0.690, 0.342, 1.390)),
model="fixed", measure="RR", k=c(20, 40, 60, 80, 100), ICC=0.011,
m=100, sdm=0, pC=0.1, sdpC=0, iter=10, alpha=0.05, ICCDistn="fixed");
```

[Package *CRTSize* version 1.2 Index]