MplusAutomation (version 0.6-1)

runModels: Run Mplus Models

Description

This function runs a group of Mplus models (.inp files) located within a single directory or nested within subdirectories.

Usage

runModels(directory = getwd(), recursive = FALSE,
    showOutput = FALSE, replaceOutfile = "always",
    logFile = "Mplus Run Models.log",
    Mplus_command = "Mplus")

Arguments

directory

the directory containing Mplus input files (.inp) to run. Defaults to the current working directory. Example: C:/Users/Michael/Mplus Runs

recursive

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

showOutput

optional. If TRUE, show estimation output (TECH8) in the R console. Note that if run within Rgui, output will display within R, but if run via Rterm, a separate window will appear during estimation.

replaceOutfile

optional. Currently supports three settings: always, which runs all models, regardless of whether an output file for the model exists; never, which does not run any model that has an existing output file; and

logFile

optional. If non-null, specifies a file (and optionally, directory) that records the settings passed into the function and the models run (or skipped) during the run.

Mplus_command

optional. N.B.: No need to pass this parameter for most users (has intelligent defaults). Allows the user to specify the name/path of the Mplus executable to be used for running models. This covers situations where Mplus is not in the system's pat

Value

• None. Function is used for its side effects (running models).

See Also

runModels_Interactive

Examples

runModels("C:/Users/Michael/Mplus Runs", recursive=TRUE, showOutput=TRUE,
    replaceOutfile="modifiedDate", logFile="MH_RunLog.txt",
    Mplus_command="C:\\Users\\Michael\\Mplus Install\\Mplus51.exe")