PowerUpR (version 0.1.3)

mdes.bcra3f2: Model 4.1: MDES Calculator for 3-Level Fixed Effects Blocked Cluster Random Assignment Design, Treatment at Level 2

Description

mdes.bcra3f2 calculates minimum detectable effect size (MDES) for designs with 3-levels where level 2 units are randomly assigned to treatment and control groups within level 3 units (fixed blocks).

Usage

mdes.bcra3f2(power=.80, alpha=.05, two.tail=TRUE,
             rho2, P=.50, g2=0, R12=0, R22=0,
             n, J, K, ...)

Arguments

power

statistical power (1 - type II error).

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.

P

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

g2

number of covariates at level 2.

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.

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

df

degrees of freedom

M

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

mdes

minimum detectable effect size and 95% lower and upper confidence limits.

Details

MDES formula and 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.

See Also

power.bcra3f2, mrss.bcra3f2, optimal.bcra3f2

Examples

## Not run: ------------------------------------
# 
#  mdes.bcra3f2(rho2=.10, n=20,
#              J=44, K=5)
# 
#   
## ---------------------------------------------