mxMLObjective {OpenMx}R Documentation

Function To Create MxMLObjective Object


This function creates a new MxMLObjective object.


mxMLObjective(covariance, means = NA)


covariance A character string indicating the name of the expected covariance algebra.
means An optional character string indicating the name of expected means algebra.


Objective functions are functions for which free parameter values are chosen such that the value of the objective function is minimized. The mxMLObjective function uses full-information maximum likelihood to provide maximum likelihood estimates of free parameters in the algebra defined by the 'covariance' argument given the covariance of an MxData object. The 'covariance' argument takes an MxAlgebra object, which defines the expected covariance of an associated MxData object.

mxMLObjective evaluates with respect to an MxData object. The MxData object need not be referenced in the mxMLObjective function, but must be included in the MxModel object. mxMLObjective requires that the 'type' argument in the associated MxData object be equal to 'cov', 'cov', or 'sscp'. The 'covariance' argument of this function evaluates with respect to the 'matrix' argument of the associated MxData object, while the 'means' argument of this function evaluates with respect to the 'vector' argument of the associated MxData object. The 'means' and 'vector' arguments are optional in both functions. If the 'means' argument is not specified (NA), the optional 'vector' argument of the MxData object is ignored. If the 'means' argument is specified, the associated MxData object should specify a 'means' argument of equivalent dimension as the 'means' algebra.

To evaluate, place MxMLObjective objects, the mxData object for which the expected covariance approximates, referenced MxAlgebra and MxMatrix objects, and optional MxBounds and MxConstraint objects in an MxModel object. This model may then be evaluated using the mxRun function. The results of the optimization can be found in the 'output' slot of the resulting model, and may be referenced using the Extract functionality.


Returns a new MxMLObjective object. MxMLObjective objects should be included with models with referenced MxAlgebra, MxData and MxMatrix objects.


The OpenMx User's guide can be found at


A <- mxMatrix(values = 0.5, nrow = 2, ncol = 1, 
        free = TRUE, name = "A")

D <- mxMatrix(type = "Diag", values = c(0, 0.5), 
        free = c(FALSE, TRUE), nrow = 2, name = "D")

expectedCov <- mxAlgebra(A %*% t(A) + D, "expectedCov")

observedCov <- mxData(matrix(c(1.2, 0.8, 0.8, 1.3), nrow = 2, ncol = 2), 
        'cov', numObs = 150)

objective <- mxMLObjective(covariance = "expectedCov")

model <- mxModel(A, D, expectedCov, objective, observedCov)

[Package OpenMx version 0.1-1 Index]