PowerUpR (version 0.1.3)

mrss.bcra4r3: Model 4.5: MRSS Calculator for 4-Level Random Effects Blocked Cluster Random Assignment Designs, Treatment at Level 3

Description

mrss.bcra4r3 calculates minimum required sample size (MRSS) for designs with 4-levels where level 3 units are randomly assigned to treatment and control groups within level 4 units (random blocks).

Usage

mrss.bcra4r3(mdes=.25, power=.80, alpha=.05, two.tail=TRUE,
              gm=2, ncase=10, constrain="power",
              n=NULL, J=NULL, K=NULL, L=NULL, L0=10, tol=.10,
              rho2, rho3, rho4, omega4,
              P=.50, R12=0, R22=0, R32=0, RT42=0, g4=0)

Arguments

mdes

minimum detectable effect size.

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.

gm

grid multiplier to increase the range of sample size search for each level.

ncase

number of cases to show in the output.

constrain

parameter to constrain; "cost", "power", or "mdes".

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

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

L

number of level 4 units.

L0

starting value for estimating number of level 4 units.

tol

tolerance to stop the search algorithm.

rho2

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

rho3

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

rho4

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

omega4

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

P

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

g4

number of covariates at level 4.

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.

R32

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

RT42

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

Value

fun

function name.

par

list of parameters used in MRSS calculation.

round.mrss

solution after rounding.

integer.mrss

best integer solutions around round.mrss solution.

Details

Level 4 sample size (L) is calculated using an iterative procedure described in Dong & Maynard (2013) due to degrees of freedom dependency on L. For other levels (n, J and K) MRSS calculation is simply solving for the unknown. MRSS calculator returns values that are not integer. Rounding may produce MDES and power values different from what was specified, therefore an integer solution is approximated using brute force (See Value section). Integer solution to MRSS for an omitted level assumes that specified sample sizes for remaining levels may subject to some changes. 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

mdes.bcra4r3, power.bcra4r3, optimal.bcra4r3

Examples

## Not run: ------------------------------------
# 
#      mrss.bcra4r3(rho4=.05, rho3=.15, rho2=.15,
#                  omega4=.50,
#                  n=10, J=2, K=10)
# 
#   
## ---------------------------------------------