PowerUpR (version 0.1.3)

mdes.bira3r1: Model 2.4: MDES Calculator for 3-Level Random Effects Blocked Individual Random Assignment Design, Individuals Randomized within Blocks

Description

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

Usage

mdes.bira3r1(power=.80, alpha=.05, two.tail=TRUE,
              rho2, rho3, omega2, omega3,
              P=.50, R12=0, RT22=0, RT32=0, g3=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.

rho3

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

omega2

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

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 1 units randomly assigned to treatment within level 2 units.

g3

number of covariates at level 3.

R12

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

RT22

proportion of treatment effect variance among level 2 units 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 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.bira3r1, mrss.bira3r1, optimal.bira3r1

Examples

## Not run: ------------------------------------
# 
#  mdes.bira3r1(rho3=.20, rho2=.15, omega3=.10, omega2=.10,
#              n=69, J=10, K=100)
#   
## ---------------------------------------------