com.itemanalysis.psychometrics.uncmin

Class DefaultUncminOptimizer

java.lang.Object

com.itemanalysis.psychometrics.uncmin.DefaultUncminOptimizer

public class DefaultUncminOptimizer
extends java.lang.Object

Provides a more user friendly interface to Uncmin_f77. Many of the flags and tolerances have been set with IRT estimation in mind. These values may not be suitable for other optimization problems.

Constructor Summary

Constructors

Constructor and Description
DefaultUncminOptimizer()
DefaultUncminOptimizer(boolean verbose)
DefaultUncminOptimizer(int messageLevel)

Method Summary

Modifier and Type	Method and Description
void	addUncminStatusListener(UncminStatusListener listener)
double	getFunctionValue()
double[]	getGradient()
double[][]	getHessian()
double[]	getParameters()
int	getTerminationCode() ITRMCD = 0: Optimal solution found ITRMCD = 1: Terminated with gradientAt small, xpls is probably optimal ITRMCD = 2: Terminated with stepsize small, xpls is probably optimal ITRMCD = 3: Lower point cannot be found, xpls is probably optimal ITRMCD = 4: Iteration limit (150) exceeded ITRMCD = 5: Too many large steps, function may be unbounded
java.lang.String	getTerminationMessage()
void	minimize(Uncmin_methods minclass, double[] initialValue) This wrapper will use the same configuration as Uncmin_f77.optif0_f77.
void	minimize(Uncmin_methods minclass, double[] initialValue, boolean analyticGradient, boolean analyticHessian, int maxIter, double maxStep) Wrapper for calling in Uncmin_f77.optif9_f77.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultUncminOptimizer

public DefaultUncminOptimizer()

DefaultUncminOptimizer

public DefaultUncminOptimizer(int messageLevel)

DefaultUncminOptimizer

public DefaultUncminOptimizer(boolean verbose)

Method Detail

addUncminStatusListener

public void addUncminStatusListener(UncminStatusListener listener)

minimize

public void minimize(Uncmin_methods minclass,
                     double[] initialValue)
              throws UncminException

This wrapper will use the same configuration as Uncmin_f77.optif0_f77.

Parameters:

minclass - a class that implements Uncmin_methods to provide the value of the objective funciton, gradientAt, and hessian.

initialValue - initial value for the prameters. It should be an array of teh same size as the number of parameters.

Throws:

UncminException

minimize

public void minimize(Uncmin_methods minclass,
                     double[] initialValue,
                     boolean analyticGradient,
                     boolean analyticHessian,
                     int maxIter,
                     double maxStep)
              throws UncminException

Wrapper for calling in Uncmin_f77.optif9_f77. It includes many of the default values from Uncmin_f77.optif0_f77 but allows access to some additional options.

Parameters:

minclass - a class that implements Uncmin_methods to provide the value of the objective funciton, gradientAt, and hessian.

initialValue - initial value for the prameters. It should be an array of teh same size as the number of parameters.

analyticGradient - true if analytic gradientAt is provided in minClass. False otherwise and will compute gradientAt numerically.

analyticHessian - true if analytic Hessian is provided in minClass. False otherwise and will compute Hessian numerically.

maxIter - maximum number of iterations.

Throws:

UncminException

getFunctionValue

public double getFunctionValue()

getParameters

public double[] getParameters()

getGradient

public double[] getGradient()

getHessian

public double[][] getHessian()

getTerminationCode

public int getTerminationCode()

ITRMCD = 0: Optimal solution found ITRMCD = 1: Terminated with gradientAt small, xpls is probably optimal ITRMCD = 2: Terminated with stepsize small, xpls is probably optimal ITRMCD = 3: Lower point cannot be found, xpls is probably optimal ITRMCD = 4: Iteration limit (150) exceeded ITRMCD = 5: Too many large steps, function may be unbounded

Returns:

termination code

getTerminationMessage

public java.lang.String getTerminationMessage()