n4meansEB: Number of Subjects Required for a Cluster Randomized Trial...

Description Usage Arguments Details Value Author(s) References See Also Examples

View source: R/n4meansEB.R

Description

This function provides detailed sample size estimation information to determine the required number of clusters that must be enrolled in a cluster randomized trial using the empirical smoothing density for the ICC. The method applies a smoothed density function (including optional weighting) to obtain an empirical distribution for the ICC. Output includes quantiles of values of the required number of clusters to obtain a prespecified power level. This version assumes the outcome of interest is continuous.

Usage

1
2
n4meansEB(ICC, varICC=0, delta, from, to, sigma, m, iter=1000, alpha=0.05, power=0.8, 
two.tailed=TRUE, digits=3, plot=TRUE)

Arguments

ICC

A vector of possible ICC values, obtained from a reasonable number of independent studies. These values form the basis of the empirical density function for the ICC.

varICC

A vector of variances of the ICC estimates. In some cases, it may be desirable to give greater weight (smaller variances) to estimates of the ICC that are obtained from larger samples. The default value is zero, which implies that all estimates are weighted equally.

delta

The anticipated mean difference in the planned study.

from

A lower limit representing the lowest plausible value for the ICC. This is used in the estimation of the ICC's empirical density function. The default value is zero as the ICC is assumed to be non-negative.

to

An upper bound for the plausible range of the ICC. A default value is not specified as this may range depending on the circumstances.

sigma

The anticipated variance in each group.

m

The anticipated average (or actual) cluster size.

iter

The total number of iterations.

alpha

The desired type I error rate.

power

The desired level of power, recall power = 1 - type II error.

two.tailed

Logical, If TRUE calculations are based on a two-tailed type I error, if FALSE, a one-sided calculation is performed.

digits

Number of digits to round calculations.

plot

Logical: Would you like a plot of the estimated density of the ICC and Histogram?

Details

This function estimates an empirical density for the ICC using the Gaussian kernel. Weights can be incorporated through the use of the varICC parameter. Values are sampled from this empirical density a large (iter) number of times and the resulting number of clusters that must be randomized to achieve a pre-specified power level is then calculated. The resulting output is the quantiles of the required number of clusters, illustrating the most likely values of the ICC and number of clusters required. Additional details are in Rotondi and Donner (2009).

Value

ResRho

A vector of values of sampled values of the ICC. This is of length iter.

ResK

A vector of values of the required number of clusters k, using the ICC values in ResRho. This is also of length iter.

pe

The anticipated proportion of individuals in the experimental group with the outcome.

pc

The anticipated proportion of individuals in the control group with the outcome.

ICC

The specified vector of values for the ICC.

varICC

A vector of variances of the ICC (study weights).

from

Lower bound in the ICC density estimation. Default of zero.

to

Upper bound in ICC Density Estimation.

m

The size of each cluster.

alpha

The desired type I error rate.

power

The desired level of power, recall power = 1 - type II error.

two.tailed

TRUE or FALSE; Depending on whether the alpha level is one or two sided.

digits

Number of digits to round results.

Author(s)

Michael Rotondi, mrotondi@yorku.ca

References

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.

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.

See Also

n4propsEB

Examples

1
2
3
4
5
6
## Not run: ICC values are from Rotondi and Donner (2009).  Suppose classrooms of size 25 are randomized 
with hypothetical experimental rates of 0.05 and control rates of 0.18.  Plots are suppressed, 
and iter = 50 for testing purposes.
## End(Not run)
n4meansEB(delta=0.5, sigma=1, m=25, ICC=c(0.162, 0.205, 0.234, 0.253), 
varICC= c(0.030, 0.032, 0.010, 0.026)^2, from=0.15, to=0.28, iter=50, plot=FALSE);

CRTSize documentation built on May 1, 2019, 8:22 p.m.

Related to n4meansEB in CRTSize...