MplusAutomation (version 0.2-5)

extractModelSummaries: Extract summary statistics from a single output file or from a group of Mplus models within a directory

Description

Parses a group of Mplus model output files (.out extension) for model fit statistics. At this time, the details extracted are fixed and include: Filename, InputInstructions, Title, Estimator, LL, BIC, aBIC, AIC, AICC, Parameters, Observations, CFI, TLI, RMSEA_Estimate, RMSEA_90CI_LB, RMSEA_90CI_UB, RMSEA_pLT05, ChiSqM_Value, ChiSqM_DF, ChiSq_PValue, BLRT_KM1LL, BLRT_PValue, BLRT_Numdraws). The infrastructure is in place to allow for user-specified selection of summary statistics in future versions.

Usage

extractModelSummaries(target = getwd(), recursive = FALSE, filefilter)

Arguments

target

the directory containing Mplus output files (.out) to parse OR the single output file to be parsed. Defaults to the current working directory. Example: "C:/Users/Michael/Mplus Runs"

recursive

optional. If TRUE, parse all models nested in subdirectories within directory. Defaults to FALSE.

filefilter

a Perl regular expression (PCRE-compatible) specifying particular output files to be parsed within directory. See regex or http://www.pcre.org/pcre.txt for details about regular expression syntax.

Value

• Returns a data.frame containing model fit statistics for all output files within directory. The data.frame contains the following variables:
• Title
  Title for the model, specified by the TITLE: command
• Filename
  Filename of the output file
• InputInstructions
  A string containing the full input syntax for the model
• Estimator
  Estimator used for the model (e.g., ML, MLR, WLSMV, etc.)
• LL
  Log-likelihood of the model
• BIC
  Bayesian Information Criterion
• aBIC
  Sample-Size-Adjusted BIC (Sclove, 1987)
• AIC
  Akaike's Information Criterion
• AICC
  Corrected AIC, based on Sugiura (1978) and recommended by Burnham & Anderson (2002)
• Parameters
  Number of parameters estimated by the model
• Observations
  The number of observations for the model (does not suppport multiple-groups analysis at this time)
• CFI
  Confirmatory Fit Index
• TLI
  Tucker-Lewis Index
• RMSEA_Estimate
  Point estimate of root mean squared error of approximation
• RMSEA_90CI_LB
  Lower bound of the 90% Confidence Interval around the RMSEA estimate.
• RMSEA_90CI_UB
  Upper bound of the 90% Confidence Interval around the RMSEA estimate.
• RMSEA_pLT05
  Probability that the RMSEA estimate falls below .05, indicating good fit.
• ChiSqM_Value
  Model chi-squared value
• ChiSqM_DF
  Model chi-squared degrees of freedom
• ChiSqM_PValue
  Model chi-squared p value
• BLRT_KM1LL
  Log-likelihood of the K-1 model (one less class) for the Bootstrapped Likelihood Ratio Test (TECH14).
• BLRT_PValue
  P-value of the Bootstrapped Likelihood Ratio Test (TECH14) testing whether the K class model is significantly better than K-1
• BLRT_Numdraws
  The number of bootstrapped samples used in the Bootstrapped Likelihood Ratio Test
• SRMR
  Standardized root mean square residual
• WRMR
  Weighted root mean square residual
• ChiSqBaseline_Value
  Baseline (unstructured) chi-squared value
• ChiSqBaseline_DF
  Baseline (unstructured) chi-squared degrees of freedom
• ChiSqBaseline_PValue
  Baseline (unstructured) chi-squared p value

See Also

regex runModels