Learn R Programming

PowerUpR (version 0.1.2)

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

Description

mrss.bcra4f3 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 (fixed blocks).

Usage

mrss.bcra4f3(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, K0=10, tol=.10, rho2, rho3, P=.50, g3=0, R12=0, R22=0, R32=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 contrain; "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 3 units (or simple average).
L
number of level 4 units.
K0
starting value for estimating number of level 3 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.
P
average proportion of level 3 units randomly assigned to treatment within level 4 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.
R32
proportion of level 3 variance in the outcome explained by level 3 covariates.

Value

Details

Level 3 and level 4 sample sizes (K and L) are calculated using an iterative procedure described in Dong & Maynard (2013) due to model degrees of freedom dependency on K and L. For other levels (n and J) 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 & Maynard (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.bcra4f3, power.bcra4f3, optimal.bcra4f3

Examples

Run this code
## Not run: 
# 
#      mrss.bcra4f3(rho3=.15, rho2=.15,
#                  n=10, J=4, K=4)
# 
#   ## End(Not run)

Run the code above in your browser using DataLab