semPower is an R-package that provides several functions to perform a-priori, compromise, and post-hoc power analyses for structural equation models (SEM).

(Very) basic functionality is also provided as a shiny app, which you can use online at https://sempower.shinyapps.io/sempower.

`semPower`

can be installed via CRAN. The CRAN
version often lags behind the development version, which can be
installed as follows:

```
# install.packages("devtools")
devtools::install_github("moshagen/semPower")
```

Find a detailed manual at https://moshagen.github.io/semPower/.

We also recommend this in-depth tutorial on power analyses in SEM using a previous version of semPower. Although some information are outdated, this provides a detailed description on generic model based power analysis:

Jobst, L., Bader, M., & Moshagen, M. (2023). A Tutorial on
Assessing Statistical Power and Determining Sample Size for Structural
Equation Models. *Psychological Methods, 28*, 207-221. https://doi.org/10.1037/met0000423
preprint

If you use `semPower`

in publications, please cite the
package as follows:

Moshagen, M., & Bader, M. (2023). semPower: General Power
Analysis for Structural Equation Models. *Behavior Research Methods,
56*, 2901-2922. https://doi.org/10.3758/s13428-023-02254-7

Determine the required sample size to detect misspecifications of a model (involving df = 100 degrees of freedom) corresponding to RMSEA = .05 with a power of 80% on an alpha error of .05:

```
ap <- semPower.aPriori(effect = .05, effect.measure = 'RMSEA',
alpha = .05, power = .80, df = 100)
summary(ap)
```

Determine the achieved power with a sample size of N = 1000 to detect misspecifications of a model (involving df = 100 degrees of freedom) corresponding to RMSEA = .05 on an alpha error of .05:

```
ph <- semPower.postHoc(effect = .05, effect.measure = 'RMSEA',
alpha = .05, N = 1000, df = 100)
summary(ph)
```

Determine the critical chi-square such that the associated alpha and beta errors are equal, assuming sample size of N = 1000, a model involving df = 100 degrees of freedom, and misspecifications corresponding to RMSEA = .05:

```
cp <- semPower.compromise(effect = .05, effect.measure = 'RMSEA',
abratio = 1, N = 1000, df = 100)
summary(cp)
```

Plot power as function of the sample size to detect misspecifications corresponding to RMSEA = .05 (assuming df = 100) on alpha = .05:

```
semPower.powerPlot.byN(effect = .05, effect.measure = 'RMSEA',
alpha = .05, df = 100, power.min = .05, power.max = .99)
```

Plot power as function of the magnitude of effect (measured through the RMSEA assuming df = 100) at N = 500 on alpha = .05:

```
semPower.powerPlot.byEffect(effect.measure = 'RMSEA', alpha = .05, N = 500,
df = 100, effect.min = .001, effect.max = .10)
```

Obtain the df of a model provided as lavaan model string (this requires the lavaan package):

```
lavModel <- '
f1 =~ x1 + x2 + x3
f2 =~ x4 + x5 + x6
'
semPower.getDf(lavModel)
```

Determine the required sample size to discriminate a model exhibiting an RMSEA of .04 on 44 df from a model with RMSEA = .05 on 41 df with a power of 80% on an alpha error of .05:

```
ap <- semPower.aPriori(effect = c(.04, .05), effect.measure = 'RMSEA',
alpha = .05, power = .80, df = c(44, 41))
summary(ap)
```

See the manual for details.

All the following examples determine the required sample size to
detect the specified effect (a priori power analysis) with a power of
80% on alpha .05 and define the measurement model via the
`loadings`

argument. See the manual
for details and for other ways to specify the measurement model.

Determine sample size to detect that a correlation between the first and the second factor of at least .3 differs from zero:

```
Phi <- matrix(c(
c(1, .3, .4, .5),
c(.3, 1, .2, .6),
c(.4, .2, 1, .1),
c(.5, .6, .1, 1)
), ncol = 4, byrow = TRUE)
powerCFA <- semPower.powerCFA(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80,
# define hypothesis
Phi = Phi,
nullEffect = 'cor = 0',
nullWhich = c(1, 2),
# define measurement model
loadings = list(
c(.7, .6, .5),
c(.5, .8, .6),
c(.7, .6, .5),
c(.5, .8, .6))
)
summary(powerCFA)
```

Determine sample size to detect that the correlations between factor 1 and 2 (of .3) as well as between 3 and 4 (of .1) differ from each other:

```
Phi <- matrix(c(
c(1, .3, .4, .5),
c(.3, 1, .2, .6),
c(.4, .2, 1, .1),
c(.5, .6, .1, 1)
), ncol = 4, byrow = TRUE)
powerCFA <- semPower.powerCFA(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80,
# define hypothesis
Phi = Phi,
nullEffect = 'corX = corZ',
nullWhich = list(c(1, 2), c(3, 4)),
# define measurement model
loadings = list(
c(.7, .6, .5),
c(.5, .8, .6),
c(.7, .6, .5),
c(.5, .8, .6))
)
summary(powerCFA)
```

Determine sample size to detect that the correlations between factor 1 and 2 in group (of .3) differs from the one in group 2 (of .5):

```
Phi1 <- matrix(c(
c(1, .3, .4, .5),
c(.3, 1, .2, .6),
c(.4, .2, 1, .1),
c(.5, .6, .1, 1)
), ncol = 4, byrow = TRUE)
Phi2 <- matrix(c(
c(1, .5, .4, .5),
c(.5, 1, .2, .6),
c(.4, .2, 1, .1),
c(.5, .6, .1, 1)
), ncol = 4, byrow = TRUE)
powerCFA <- semPower.powerCFA(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80, N = list(1, 1),
# define hypothesis
Phi = list(Phi1, Phi2),
nullEffect = 'corA = corB',
nullWhich = c(1, 2),
# define measurement model
loadings = list(
c(.7, .6, .5),
c(.5, .8, .6),
c(.7, .6, .5),
c(.5, .8, .6))
)
summary(powerCFA)
```

See the manual for more details.

Determine sample size to detect that the first slope (of .2) differs from zero:

```
corXX <- matrix(c(
c(1, .2, .6),
c(.2, 1, .1),
c(.6, .1, 1)
), ncol = 3, byrow = TRUE)
powerReg <- semPower.powerRegression(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80,
# define hypothesis
slopes = c(.2, .3, .4),
corXX = corXX,
nullEffect = 'slope = 0',
nullWhich = 1,
# define measurement model
loadings = list(
c(.7, .6, .5),
c(.5, .8, .6),
c(.7, .6, .5),
c(.5, .8, .6))
)
summary(powerReg)
```

Determine sample size to detect that the first slope (of .2) differs from the third slope (of .4):

```
corXX <- matrix(c(
c(1, .2, .6),
c(.2, 1, .1),
c(.6, .1, 1)
), ncol = 3, byrow = TRUE)
powerReg <- semPower.powerRegression(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80,
# define hypothesis
slopes = c(.2, .3, .4),
corXX = corXX,
nullEffect = 'slopeX = slopeZ',
nullWhich = c(1, 3),
# define measurement model
loadings = list(
c(.7, .6, .5),
c(.5, .8, .6),
c(.7, .6, .5),
c(.5, .8, .6))
)
summary(powerReg)
```

Determine sample size to detect that the first slope in group 1 (of .2) differs from the first slope in group 2 (of .4):

```
corXX <- matrix(c(
c(1, .2, .6),
c(.2, 1, .1),
c(.6, .1, 1)
), ncol = 3, byrow = TRUE)
powerReg <- semPower.powerRegression(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80, N = list(1, 1),
# define hypothesis
slopes = list(c(.2, .3, .4),
c(.4, .3, .2)),
corXX = corXX,
nullEffect = 'slopeA = slopeB',
nullWhich = 1,
# define measurement model
loadings = list(
c(.7, .6, .5),
c(.5, .8, .6),
c(.7, .6, .5),
c(.5, .8, .6))
)
summary(powerReg)
```

See the manual for more details.

Determine sample size to detect an indirect effect of at least .12 (=
.3*.4) in a simple `X -> M -> Y`

mediation based on an
observed variable only model:

```
powerMed <- semPower.powerMediation(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80,
# define hypothesis
bYX = .25,
bMX = .3,
bYM = .4,
nullEffect = 'ind = 0',
# define observed only
Lambda = diag(3)
)
summary(powerMed)
```

Determine sample size to detect the indirect effect in group 1 (of
.12) differs from the indirect effect in group 2 (of .25) in a simple
`X -> M -> Y`

mediation based on an observed variable
only model:

```
powerMed <- semPower.powerMediation(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80, N = list(1, 1),
# define hypothesis
bYX = list(.25, .25),
bMX = list(.3, .5),
bYM = list(.4, .5),
nullEffect = 'indA = indB',
# define observed only
Lambda = diag(3)
)
summary(powerMed)
```

See the manual for more details.

Determine sample size to detect metric-noninvariance across two groups of magnitude as defined through the different loadings:

```
powerMI <- semPower.powerMI(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80, N = list(1, 1),
# define hypothesis
comparison = 'configural',
nullEffect = 'metric',
# define measurement model
loadings = list(
# group 1
list(
c(.7, .6, .5),
c(.5, .8, .6),
c(.7, .6, .5),
c(.5, .8, .6)),
# group 2
list(
c(.6, .5, .4),
c(.5, .8, .6),
c(.6, .5, .4),
c(.5, .8, .6))
)
)
summary(powerMI)
```

Determine sample size to detect that the latent means differ across groups:

```
powerMI <- semPower.powerMI(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80, N = list(1, 1),
# define hypothesis
comparison = c('loadings', 'intercepts'),
nullEffect = c('loadings', 'intercepts', 'means'),
# define measurement model (same for all groups)
loadings = list(
c(.7, .6, .5),
c(.5, .8, .6),
c(.7, .6, .5),
c(.5, .8, .6)),
# define indicator intercepts
tau = list(rep(0, 12), rep(0, 12)),
# define latent means
Alpha = list(
# group 1
rep(0, 4),
# group 2
c(0.5, 0, 0.5, 0)
)
)
summary(powerMI)
```

See the manual for more details and further hypotheses.

Determine sample size to detect metric-noninvariance across four measurement occasions of magnitude as defined through the different loadings:

```
powerLI <- semPower.powerLI(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80,
# define hypothesis
comparison = 'configural',
nullEffect = 'metric',
# define measurement model
loadings = list(
c(.7, .6, .5), # time 1
c(.6, .6, .5), # time 2
c(.5, .5, .4), # time 3
c(.4, .5, .4) # time 4
),
autocorResiduals = TRUE
)
summary(powerLI)
```

See the manual for more details and further hypotheses.

Determine sample size to detect that the (wave-constant) lag-2 effects differ from zero in a 4-wave autoregressive model involving wave-constant lag-1 effects:

```
powerAutoreg <- semPower.powerAutoreg(
# define type of power analysis
'a-priori', alpha = .05, power = .80,
# define hypothesis
nWaves = 4,
autoregEffects = c(.6, .6, .6),
lag2Effects = c(.2, .2),
waveEqual = c('autoreg', 'lag2'),
nullEffect = 'lag2=0',
# define measurement model
loadings = list(
c(.5, .6, .7),
c(.5, .6, .7),
c(.5, .6, .7),
c(.5, .6, .7)
),
invariance = TRUE,
autocorResiduals = TRUE
)
summary(powerAutoreg)
```

Determine sample size to detect that the latent means differ across measurements in a 4 wave autoregressive model involving wave-constant lag-1 effects and wave-constant residual variances:

```
powerAutoreg <- semPower.powerAutoreg(
# define type of power analysis
'a-priori', alpha = .05, power = .80,
# define hypothesis
nWaves = 4,
autoregEffects = c(.6, .6, .6),
variances = c(1, 1, 1, 1),
means = c(0, .5, 1, .7),
waveEqual = c('autoreg', 'var'),
nullEffect = 'mean',
# define measurement model
loadings = list(
c(.5, .6, .7),
c(.5, .6, .7),
c(.5, .6, .7),
c(.5, .6, .7)
),
standardized = FALSE,
invariance = TRUE,
autocorResiduals = TRUE
)
summary(powerAutoreg)
```

See the manual for more details and further hypotheses.

Determine sample size to detect a that the lag-1 autoregressive effects differ across waves in a 10-wave ARMA model with wave-stable variances and moving average parameters :

```
powerARMA <- semPower.powerARMA(
# define type of power analysis
'a-priori', alpha = .05, power = .80,
# define hypothesis
nWaves = 10,
autoregLag1 = c(.5, .7, .6, .5, .7, .6, .6, .5, .6),
mvAvgLag1 = rep(.3, 9),
variances = rep(1, 10),
waveEqual = c('var', 'mvAvg'),
nullEffect = 'autoreg',
# define measurement model
loadings = rep(list(c(.6, .5, .6)), 10),
invariance = TRUE,
autocorResiduals = TRUE
)
summary(powerARMA)
```

Same as above, but detect that the moving average parameters differ across waves:

```
powerARMA <- semPower.powerARMA(
# define type of power analysis
'a-priori', alpha = .05, power = .80,
# define hypothesis
nWaves = 10,
autoregLag1 = rep(.5, 9),
mvAvgLag1 = c(.3, .4, .5, .3, .4, .5, .3, .4, .5),
variances = rep(1, 10),
waveEqual = c('var', 'autoreg'),
nullEffect = 'mvAvg',
# define measurement model
loadings = rep(list(c(.6, .5, .6)), 10),
invariance = TRUE,
autocorResiduals = TRUE
)
summary(powerARMA)
```

Same as above, but include (wave-constant) lag-2 effects and detect that the lag-2 autoregressive parameters differ from zero:

```
powerARMA <- semPower.powerARMA(
# define type of power analysis
'a-priori', alpha = .05, power = .80,
# define hypothesis
nWaves = 10,
autoregLag1 = rep(.5, 9),
mvAvgLag1 = rep(.3, 9),
autoregLag2 = rep(.2, 8),
mvAvgLag2 = rep(.1, 8),
variances = rep(1, 10),
waveEqual = c('var', 'autoreg', 'mvAvg', 'autoregLag2', 'mvAvgLag2'),
nullEffect = 'autoregLag2 = 0',
# define measurement model
loadings = rep(list(c(.6, .5, .6)), 10),
invariance = TRUE,
autocorResiduals = TRUE
)
summary(powerARMA)
```

Same as above, but detect that residual variances differ across waves:

```
powerARMA <- semPower.powerARMA(
# define type of power analysis
'a-priori', alpha = .05, power = .80,
# define hypothesis
nWaves = 10,
autoregLag1 = rep(.5, 9),
mvAvgLag1 = rep(.3, 9),
variances = c(1, .8, .7, .6, .8, .7, .6, .8, .7, .6),
waveEqual = c('mvAvg', 'autoreg'),
nullEffect = 'var',
# define measurement model
loadings = rep(list(c(.6, .5, .6)), 10),
invariance = TRUE,
autocorResiduals = TRUE
)
summary(powerARMA)
```

See the manual for more details and further hypotheses.

Determine sample size to detect a cross-lagged effect of X on Y of at least .10 in a two-wave CLPM:

```
powerCLPM <- semPower.powerCLPM(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80,
# define hypothesis
nullEffect = 'crossedX = 0',
nWaves = 2,
autoregEffects = c(.60, .70),
crossedEffects = c(.10, .15),
rXY = c(.3, .1),
# define measurement model
loadings = list(
c(.7, .6, .5),
c(.5, .8, .6),
c(.7, .6, .5),
c(.5, .8, .6))
)
summary(powerCLPM)
```

Same as above, but in a random-intercept CLPM involving 3 waves with observed variables only:

```
powerRICLPM <- semPower.powerRICLPM(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80,
# define hypothesis
nullEffect = 'crossedX = 0',
nWaves = 3,
autoregEffects = c(.60, .70),
crossedEffects = c(.10, .15),
rXY = c(.3, .1, .1),
waveEqual = c('autoregX', 'autoregY', 'crossedX', 'crossedY'),
# define measurement model
Lambda = diag(6)
)
summary(powerRICLPM)
```

Determine sample size to detect the cross-lagged effect of X on Y differs from the one of Y on X a two-wave CLPM:

```
powerCLPM <- semPower.powerCLPM(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80,
# define hypothesis
nullEffect = 'crossedX = crossedY',
nWaves = 2,
autoregEffects = c(.60, .70),
crossedEffects = c(.10, .15),
rXY = c(.3, .1),
# define measurement model
loadings = list(
c(.7, .6, .5),
c(.5, .8, .6),
c(.7, .6, .5),
c(.5, .8, .6))
)
summary(powerCLPM)
```

Determine sample size to detect the cross-lagged effect of X on Y in group 1 (of .10) differs from the one in group 2 (of .2):

```
powerCLPM <- semPower.powerCLPM(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80, N =list(1, 1),
# define hypothesis
nullEffect = 'crossedXA = crossedXB',
nWaves = 2,
autoregEffects = c(.60, .70),
crossedEffects = list(
# group 1
list(.10, .15),
# group 2
list(.20, .15)
),
rXY = c(.3, .1),
# define measurement model
loadings = list(
c(.7, .6, .5),
c(.5, .8, .6),
c(.7, .6, .5),
c(.5, .8, .6))
)
summary(powerCLPM)
```

See the manual for more details and for additional types of hypothesis.

Determine sample size to detect a that the mean of the slope factor differs from zero in a 3-wave LGCM:

```
powerLGCM <- semPower.powerLGCM(
# define type of power analysis
'a-priori', alpha = .05, power = .80,
# define hypothesis
nWaves = 3,
means = c(.5, .2), # i, s
variances = c(1, .5), # i, s
covariances = .25,
nullEffect = 'sMean = 0',
# define measurement model
loadings = list(
c(.6, .7, .5),
c(.6, .7, .5),
c(.6, .7, .5)
),
autocorResiduals = TRUE
)
summary(powerLGCM)
```

Same as above, but detect that the variance of the intercept factor differs from zero:

```
powerLGCM <- semPower.powerLGCM(
# define type of power analysis
'a-priori', alpha = .05, power = .80,
# define hypothesis
nWaves = 3,
means = c(.5, .2), # i, s
variances = c(1, .5), # i, s
covariances = .25,
nullEffect = 'iVar = 0',
# define measurement model
loadings = list(
c(.6, .7, .5),
c(.6, .7, .5),
c(.6, .7, .5)
),
autocorResiduals = TRUE
)
summary(powerLGCM)
```

Detect that the variance of a quadratic slope factor in a 4-wave LGCM differs from zero:

```
powerLGCM <- semPower.powerLGCM(
# define type of power analysis
'a-priori', alpha = .05, power = .80,
# define hypothesis
nWaves = 4,
quadratic = TRUE,
means = c(.5, .2, .1), # i, s, s2
covariances = matrix(c(
# i, s, s2
c(1, .2, .1),
c(.2, .2, .05),
c(.1, .05, .1)
), ncol = 3, byrow = TRUE),
nullEffect = 's2Var = 0',
# define measurement model
loadings = list(
c(.6, .7, .5),
c(.6, .7, .5),
c(.6, .7, .5),
c(.6, .7, .5)
),
autocorResiduals = TRUE
)
summary(powerLGCM)
```

Detect that the intercept-slope covariance differs across groups in a two-group 3-wave LGCM:

```
powerLGCM <- semPower.powerLGCM(
# define type of power analysis
'a-priori', alpha = .05, power = .80, N = list(1, 1),
# define hypothesis
nWaves = 3,
means = c(.5, .2),
variances = c(1, .5),
covariances = list(
c(.25), # group 1
c(.1)), # group 2
nullEffect = 'isCovA = isCovB',
groupEqual = c('ivar', 'svar'),
# define measurement model
loadings = list(
c(.6, .7, .5),
c(.6, .7, .5),
c(.6, .7, .5)
),
autocorResiduals = TRUE
)
summary(powerLGCM)
```

See the manual for more details and further hypotheses.

Perform a simulated power-analysis with 500 replications and non-normal data with a population multivariate skewness of 10 and multivariate kurtosis of 200 to determine the sample size to detect that a correlation between the first and the second factor of at least .3 differs from zero:

```
Phi <- matrix(c(
c(1, .3, .4, .5),
c(.3, 1, .2, .6),
c(.4, .2, 1, .1),
c(.5, .6, .1, 1)
), ncol = 4, byrow = TRUE)
set.seed(1234)
powerCFA <- semPower.powerCFA(
# define type of power analysis
type = 'a-priori', alpha = .05, power = .80,
# define hypothesis
Phi = Phi,
nullEffect = 'cor = 0',
nullWhich = c(1, 2),
# define measurement model
loadings = list(
c(.7, .6, .5),
c(.5, .8, .6),
c(.7, .6, .5),
c(.5, .8, .6)),
# request simulated power analysis
simulatedPower = TRUE,
simOptions = list(
nReplications = 500,
type = 'mnonr',
skewness = 10,
kurtosis = 200
))
summary(powerCFA)
```

See the manual for more details.