Evaluate Invariance Equality Constraints in a specified Dyadic Invariance Model
Source:R/outputConstraintTab.R
outputConstraintTab.RdoutputConstraintTab() is used to perform a score test for relaxing each
invariance equality constraint between partners in a given dyadic SEM model.
Usage
outputConstraintTab(
constrainFit,
filterSig = FALSE,
gtTab = FALSE,
writeTo = NULL,
fileName = NULL
)Arguments
- constrainFit
A fitted
lavaanmodel with dyadic invariance equality constraints- filterSig
A logical indicating whether to filter for significant constraints (default is
FALSE)- gtTab
A logical input indicating whether to generate the table(s) in
gt::gt()table object format (TRUE). By default (FALSE), the table(s) are generated intibble::tibble()format. Users can also apply thewriteToargument if they wish to export thegt::gt()table object(s).- writeTo
A character string specifying a directory path to where the output file(s) should be saved. If set to
".", the file(s) will be written to the current working directory. The default isNULL, and examples use a temporary directory created bytempdir(). When dealing with tabular output,writeTois only relevant ifgtTab = TRUE.- fileName
A character string specifying a desired base name for the output file. The default is
NULL. The specified name will be automatically appended with the appropriate file extension (e.g.,.txtforlavaanscripts,.rtffor tabular output whengtTab = TRUE, or other extensions as appropriate for the output type). If a file with the same name already exists in the user's chosen directory, it will be overwritten.
Value
A tibble::tibble() if gtTab = FALSE (default), or gt::gt() object if gtTab = TRUE, with
rows of equality constraints (now with readable param labels) and test statistic, df, and p for whether constraint worsens model fit.
Details
If
gtTab = TRUEandwriteTois specified, then output will simultaneously be saved as a.rtffile to the user's specified directory.If output file is successfully saved, a confirmation message will be printed to the console.
If a file with the same name already exists in the user's chosen directory, it will be overwritten.
Examples
dvn <- scrapeVarCross(
dat = commitmentM, x_order = "sip", x_stem = "sat.g",
x_delim2 = "_", distinguish_1 = "f", distinguish_2 = "m"
)
#>
#> ── Variable Scraping Summary ──
#>
#> ✔ Successfully scraped 1 latent variable: sat.g
#> ℹ sat.g: 5 indicators for P1 (f), 5 indicators for P2 (m)
#> ℹ Total indicators: 10
sat.resids.script <- scriptCor(dvn,
lvname = "Sat",
constr_dy_meas = c("loadings", "intercepts", "residuals"),
constr_dy_struct = "none"
)
sat.resids.mod <- lavaan::cfa(sat.resids.script,
data = commitmentM, std.lv = FALSE,
auto.fix.first = FALSE, meanstructure = TRUE
)
outputConstraintTab(sat.resids.mod,
filterSig = FALSE,
gtTab = TRUE, writeTo = tempdir(), fileName = "dCFA_Residual"
)
#> Output stored in: /tmp/RtmpIVCISQ/dCFA_Residual.rtf
param1
constraint
param2
chi2
df
pvalue
sig