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.

1 2 | ```
n4propsMeta(data, k, ICC, ICCDistn="unif", lower=0, upper=0.25, varRed=FALSE,
m, sdm, pC, sdpC, iter=1000, alpha=0.05, RR=TRUE)
``` |

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

`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 cluster trials themselves, or from the literature. |

`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 fixed effects level. For simplicity, this function assumes that each of the inputed lower and upper limits that are 95 % confidence limits. |

`RR` |
Logical; Are the effect measures Relative Risks (TRUE) (default) or Odds Ratios (FALSE)? This is necessary only for the calculation of variances. |

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

`power` |
The power of the updated meta-analysis. Presented as a vector of 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 Effects log relative risk (RR) or odds ratio (OR). |

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

`lF` |
The 100(1 - |

`uF` |
The 100(1 - |

`Var` |
The variance of the overall 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. (2011) Sample Size Estimation in Cluster Randomized Trials: An Evidence-Based Perspective. Computational Statistics and Data Analysis 56:1174-1187.

`fixedMetaAnalRROR`

, `n4meansMeta`

1 2 3 4 |

Questions? Problems? Suggestions? Tweet to @rdrrHQ or email at ian@mutexlabs.com.

Please suggest features or report bugs with the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.