umx (version 1.9.1)

umxRun: umxRun: Run an mxModel

Description

umxRun is a version of mxRun which can run also set start values, labels, and run multiple times It can also calculate the saturated and independence likelihoods necessary for most fit indices.

Usage

umxRun(model, n = 1, calc_SE = TRUE, calc_sat = TRUE, setValues = FALSE,
  setLabels = FALSE, intervals = FALSE, comparison = NULL)

Arguments

model

The mxModel you wish to run.

n

The maximum number of times you want to run the model trying to get a code green run (defaults to 1)

calc_SE

Whether to calculate standard errors (ignored when n = 1) for the summary (if you use mxCI or umxCI, you can turn this off)

calc_sat

Whether to calculate the saturated and independence models (for raw mxData mxModels) (defaults to TRUE - why would you want anything else?)

setValues

Whether to set the starting values of free parameters (default = FALSE)

setLabels

Whether to set the labels (default = FALSE)

intervals

Whether to run mxCI confidence intervals (default = FALSE) intervals = FALSE

comparison

Whether to run umxCompare() after umxRun

Value

- mxModel

References

- http://www.github.com/tbates/umx

See Also

Other Core Modelling Functions: plot.MxModel, umxDiagnose, umxLatent, umxMatrix, umxPath, umxRAM, umxReduceACE, umxReduceGxE, umxSuperModel, umx

Examples

# NOT RUN {
require(umx)
data(demoOneFactor)
latents  = c("G")
manifests = names(demoOneFactor)
m1 <- mxModel("One Factor", type = "RAM", 
	manifestVars = manifests, latentVars = latents, 
	mxPath(from = latents, to = manifests),
	mxPath(from = manifests, arrows = 2),
	mxPath(from = latents, arrows = 2, free = FALSE, values = 1.0),
	mxData(cov(demoOneFactor), type = "cov", numObs = 500)
)
m1 = umxRun(m1) # just run: will create saturated model if needed
m1 = umxRun(m1, setValues = TRUE, setLabels = TRUE) # set start values and label all parameters
umxSummary(m1, show = "std")
m1 = mxModel(m1, mxCI("G_to_x1")) # add one CI
m1 = mxRun(m1, intervals = TRUE)
residuals(m1, run = TRUE) # get CIs on all free parameters
confint(m1) # OpenMx's SE-based CIs
umxConfint(m1, run = TRUE) # get likelihood-based CIs on all free parameters
m1 = umxRun(m1, n = 10) # re-run up to 10 times if not green on first run
# }