runModels: Run Mplus Models

Description Usage Arguments Value Author(s) See Also Examples

View source: R/runModels.R

Description

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

Usage

1
2
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 "modifiedDate", which only runs a model if the modified date for the input file is more recent than the output file modified date (implying there have been updates to the model).

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 path, or where one wants to test different versions of the Mplus program.

Value

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

Author(s)

Michael Hallquist

See Also

runModels_Interactive

Examples

1
2
3
4
5
## Not run: 
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")
## End(Not run)

MplusAutomation documentation built on May 2, 2019, 5:55 p.m.