PowerUpR (version 0.1.3)

power.bcra3r2: Model 4.2: Statistical Power Calculator for 3-Level Random Effects Blocked Cluster Random Assignment Designs, Treatment at Level 2

Description

power.bcra3r2 calculates statistical power for designs with 3-levels where level 2 units are randomly assigned to treatment and control groups within level 3 units (random blocks).

Usage

power.bcra3r2(mdes=.25, alpha=.05, two.tail=TRUE,
       rho2, rho3, omega3,
       P=.50, g3=0, R12=0, R22=0, RT32=0,
       n, J, K, ...)

Arguments

mdes

minimum detectable effect size.

alpha

probability of type I error.

two.tail

logical; TRUE for two-tailed hypothesis testing, FALSE for one-tailed hypothesis testing.

rho2

proportion of variance in the outcome explained by level 2 units.

rho3

proportion of variance in the outcome explained by level 3 units.

omega3

treatment effect heterogeneity as ratio of treatment effect variance among level 3 units to the residual variance at level 3.

P

average proportion of level 2 units randomly assigned to treatment within level 3 units.

g3

number of covariates at level 3.

R12

proportion of level 1 variance in the outcome explained by level 1 covariates.

R22

proportion of level 2 variance in the outcome explained by level 2 covariates.

RT32

proportion of treatment effect variance among level 3 units explained by level 3 covariates.

n

harmonic mean of level 1 units across level 2 units (or simple average).

J

harmonic mean of level 2 units across level 3 units (or simple average).

K

level 3 sample size.

...

to handle extra parameters passed from other functions, do not define any additional parameters.

Value

fun

function name.

par

list of parameters used in power calculation.

df

degrees of freedom

M

multiplier for MDES calcuation given degrees of freedom, \(\alpha\) and \(\beta\) (1-power).

power

statistical power (1 - type II error).

Details

Power formula was derived within power analysis framework descibed by Hedges & Rhoads (2009). Further definition of design parameters can be found in Dong & Maynard (2013).

References

Dong, N., & Maynard, R. A. (2013). PowerUp!: A Tool for Calculating Minum Detectable Effect Sizes and Minimum Required Sample Sizes for Experimental and Quasi-Experimental Design Studies,Journal of Research on Educational Effectiveness, 6(1), 24-6. Hedges, L. & Rhoads, C.(2009). Statistical Power Analysis in Education Research (NCSER 2010-3006). Washington, DC: National Center for Special Education Research, Institute of Education Sciences, U.S. Department of Education. This report is available on the IES website at http://ies.ed.gov/ncser/.

See Also

mdes.bcra3r2, mrss.bcra3r2, optimal.bcra3r2

Examples

## Not run: ------------------------------------
# 
#     power.bcra3r2(rho3=.13, rho2=.10, omega3=.40,
#                  n=10, J=6, K=24)
# 
#   
## ---------------------------------------------