mplusObject: Create an Mplus model object

Description

This is a function to create an Mplus model object in R. The object holds all the sections of an Mplus input file, plus some extra R ones. Once created, the model can be run using other functions such as mplusModeler or updated using methods defined for the update function.

Usage

mplusObject(
  TITLE = NULL,
  DATA = NULL,
  VARIABLE = NULL,
  DEFINE = NULL,
  MONTECARLO = NULL,
  MODELPOPULATION = NULL,
  MODELMISSING = NULL,
  ANALYSIS = NULL,
  MODEL = NULL,
  MODELINDIRECT = NULL,
  MODELCONSTRAINT = NULL,
  MODELTEST = NULL,
  MODELPRIORS = NULL,
  OUTPUT = NULL,
  SAVEDATA = NULL,
  PLOT = NULL,
  usevariables = NULL,
  rdata = NULL,
  autov = TRUE,
  imputed = FALSE,
  quiet = TRUE,
  ...
)

Value

A list of class mplusObject with elements

TITLE: The title in Mplus (if defined)
DATA: The data section in Mplus (if defined)
VARIABLE: The variable section in Mplus (if defined)
DEFINE: The define section in Mplus (if defined)
MONTECARLO: The montecarlo section in Mplus (if defined)
MODELPOPULATION: The modelpopulation section in Mplus (if defined)
MODELMISSING: The modelmissing section in Mplus (if defined)
ANALYSIS: The analysis section in Mplus (if defined)
MODEL: The model section in Mplus (if defined)
MODELINDIRECT: The modelindirect section in Mplus (if defined)
MODELCONSTRAINT: The modelconstraint section in Mplus (if defined)
MODELTEST: The modeltest section in Mplus (if defined)
MODELPRIORS: The modelpriors section in Mplus (if defined)
OUTPUT: The output section in Mplus (if defined)
SAVEDATA: The savedata section in Mplus (if defined)
PLOT: The plot section in Mplus (if defined)
results: NULL by default, but can be later updated to include the results from the model run.
usevariables: A character vector of the variables from the R data set to be used.
rdata: The R data set to use for the model.
imputed: A logical whether the data are multiply imputed.
autov: A logical whether the data should have the usevariables detected automatically or not

Arguments

TITLE: A character string of the title for Mplus.
DATA: A charater string of the data section for Mplus (note, do not define the filename as this is generated automatically)
VARIABLE: A character string of the variable section for Mplus (note, do not define the variable names from the dataset as this is generated automatically)
DEFINE: A character string of the define section for Mplus (optional)
MONTECARLO: A character string of the montecarlo section for Mplus (optional). If used, autov is defaults to FALSE instead of the usual default, TRUE, but may still be overwritten, if desired.
MODELPOPULATION: A character string of the MODEL POPULATION section for Mplus (optional).
MODELMISSING: A character string of the MODEL MISSING section for Mplus (optional).
ANALYSIS: A character string of the analysis section for Mplus (optional)
MODEL: A character string of the model section for Mplus (optional, although typically you want to define a model)
MODELINDIRECT: A character string of the MODEL INDIRECT section for Mplus (optional).
MODELCONSTRAINT: A character string of the MODEL CONSTRAINT section for Mplus (optional).
MODELTEST: A character string of the MODEL TEST section for Mplus (optional).
MODELPRIORS: A character string of the MODEL PRIORS section for Mplus (optional).
OUTPUT: A character string of the output section for Mplus (optional)
SAVEDATA: A character string of the savedata section for Mplus (optional)
PLOT: A character string of the plot section for Mplus (optional)
usevariables: A character vector of the variables from the R dataset to use in the model.
rdata: An R dataset to be used for the model.
autov: A logical (defaults to TRUE) argument indicating whether R should attempt to guess the correct variables to use from the R dataset, if usevariables is left NULL.
imputed: A logical whether the data are multiply imputed (a list). Defaults to FALSE.
quiet: optional. If TRUE, show status messages in the console.
...: Arguments passed on to mplusModeler if run > 0.

Author

Joshua F. Wiley <jwiley.psych@gmail.com>

Details

Mplus model objects allow a base model to be defined, and then flexibly update the data, change the precise model, etc. If a section does not vary between models, you can leave it the same. For example, suppose you are fitting a number of models, but in all cases, wish to use maximum likelihood estimator, “ANALYSIS: ESTIMATOR = ML;” and would like standardized output, “OUTPUT: STDYX;”. Rather than retype those in every model, they can be defined in one Mplus model object, and then that can simply be updated with different models, leaving the analysis and output sections untouched. This also means that if a reviewer comes back and asks for all analyses to be re-run say using the robust maximum likelihood estimator, all you have to do is change it in the model object once, and re run all your code.

Examples

Run this code


example1 <- mplusObject(MODEL = "mpg ON wt;",
  usevariables = c("mpg", "hp"), rdata = mtcars)
str(example1)
rm(example1)

# R figures out the variables automagically, with a message
example2 <- mplusObject(MODEL = "mpg ON wt;",
  rdata = mtcars, autov = TRUE)
str(example2)
rm(example2)

# R can also try to figure out a list of variables when
# variable names are hyphenated first-last variable, all variables
# between the first and last one will be included
example3 <- mplusObject(MODEL = "mpg ON wt-vs;",
  rdata = mtcars, autov = TRUE)
str(example3)
rm(example3)

# R warns if the first 8 characters of a (used) variable name are not unique
# as they will be indistinguishable in the Mplus output
example4 <- mplusObject(MODEL = "basename_01 ON basename_02;",
  rdata = data.frame(basename_01 = 1:5, basename_02 = 5:1),
  autov = TRUE)
rm(example4)

Run the code above in your browser using DataLab