eqMI.semtest {equaltestMI}

Measurement invariance tests using lavaan

Description

Conventional multiple-group SEM to test measurement invariance. A sequence of chi-squared and chi-squared difference tests will be conducted.

Usage

eqMI.semtest(..., output = "both", quiet = FALSE)

Arguments

...

The same arguments as for any lavaan model. See lavaan::cfa and lavaan::lavOptions for more information about the arguments.

Users must explicitly specify the name of the input elements for this function to catch. For example, specify 'eqMI.semtest(model = semmodel, data = HolzingerSwineford)' instead just 'eqMI.semtest(semmodel, HolzingerSwineford)'.

output

If the function prints out results of covariance structure, mean structure, or both. The value of output must be mean, covariance, or both. When the tests involve mean structure (output = 'mean' or 'both'), both the strong and the strict tests of measurement invariance will be conducted.

quiet

If quiet=FALSE (default), a summary is printed out containing an overview of the different models that are fitted, together with some model comparison tests. If quiet=TRUE, no summary is printed but results will be stored in the object.

Details

This is a wrapper around the (now deprecated) measurementInvariance in package semTools, with the following default options: std.lv = FALSE, fit.measures = "default", and method = "satorra.bentler.2001". See semTools for more information. This function is now updated to semTools::measEq.syntax.

Value

A list is returned with:

LavaanOut

A sublist in convention.sem. Contains lavann style output and results for each chi-squared and chi-squared difference.

Mean.part

A sublist in convention.sem. Contains test statistics and fit measures on invariance tests of mean structure.

Cov.part

A sublist in convention.sem. Contains test statistics and fit measures on invariance tests of covariacne structure.

Author(s)

The maintainer, Ge Jiang, adapted the original source code of measurementInvariance() in the lavaan and semTools packages written by Yves Rosseel, Sunthud Pornprasertmanit, and Terrence D. Jorgensen (permission obtained).

References

Yuan, K. H., & Chan, W. (2016). Measurement invariance via multigroup SEM: Issues and solutions with chi-square-difference tests. Psychological methods, 21(3), 405-426.

Yves Rosseel (2012). lavaan: An R Package for Structural Equation Modeling. Journal of Statistical Software, 48(2), 1-36.

semTools Contributors. (2016). semTools: Useful tools for structural equation modeling. R package version 0.4-14. Retrieved from https://CRAN.R-project.org/package=semTools

See Also

sem, measurementInvariance

Examples

data(HolzingerSwineford)
semmodel<-'
L1 =~ V1 + V2 + V3
L2 =~ V4 + V5 + V6
L3 =~ V7 + V8
L4 =~ V9 + V10 + V11
'

run.sem <- eqMI.semtest(model = semmodel, data = HolzingerSwineford,
           group = "school", meanstructure = TRUE)