mxOption {OpenMx}R Documentation

Set or Clear an Optimizer Option

Description

The function sets or clears an option that is specific to the optimizer in the back-end.

Usage

mxOption(model, key, value, reset = FALSE)

Arguments

model An MxModel object
key The name of the option.
value The value of the option.
reset If TRUE then reset all options to their defaults.

Details

Sets an option that is specific to the particular optimizer used in the back-end. The name of the option is the ‘key’ argument. Use value = NULL to remove an existing option. Before the model is submitted to the back-end, all keys and values are converted into strings using the as.character function. To reset all options to their default values, use reset = TRUE. If reset = TRUE, then 'key' and 'value' are ignored. Use getOption('mxOptimizerOptions') to see the default optimizer options.

OpenMx options

Calculate Hessian [Yes|No] calculate the hessian explicitly after optimization. If ‘No’, a less precise hessian estimate (from the optimizer) is returned. Forced to ‘Yes’ if ‘Standard Errors’ option is enabled.
Standard Errors [Yes|No] return standard error estimates from the explicitly calculate hessian. Forces explicit calculation of the hessian.
Chi-square Confidence Intervals [Yes|No] calculate confidence intervals based on boundaries of the maximum likelihood space. At present, this assumes a Chi-square distribution for the results of the objective function.

NPSOL-specific options

Nolist this option suppresses printing of the options
Print level i the value of i controls the amount of printout produced by the major iterations
Minor print level i the value of i controls the amount of printout produced by the minor iterations
Print file i for i > 0 a full log is sent to the file with logical unit number i.
Summary file i for i > 0 a brief log will be output to file i.
Function Precision r a measure of accuracy with which f and c can be computed.
Infinite Bound Size r if r > 0 defines the "infinite" bound bigbnd.
Feasibility tolerance r the maximum acceptable absolute violations in linear and nonlinear constraints.
Major iterations i the maximum number of major iterations before termination.
Verify level [-1:3|Yes|No] see NPSOL manual.
Line search tolerance r controls the accuracy with which a step is taken.
Derivative Level [0-3] see NPSOL manual.
Hessian [Yes|No] return the transformed Hessian (if ‘No’) or the Hessian itself (if ‘Yes’).

Value

Returns the model with the optimizer option either set or cleared.

References

The OpenMx User's guide can be found at http://openmx.psyc.virginia.edu/documentation.

Examples

model <- mxModel()

model <- mxOption(model, "Function Precision", 1e-5)
model <- mxOption(model, "Standard Errors", "Yes")
model <- mxOption(model, "Function Precision", NULL)


[Package OpenMx version 0.2.9-1147 Index]