ilog.cplex

Class IloCplex.ContinuousCallback

java.lang.Object

ilog.cplex.IloCplex.Callback

ilog.cplex.IloCplex.OptimizationCallback

ilog.cplex.IloCplex.ContinuousCallback

All Implemented Interfaces:

java.lang.Cloneable

Direct Known Subclasses:

IloCplex.BarrierCallback, IloCplex.SimplexCallback

Enclosing class:

IloCplex

public abstract static class IloCplex.ContinuousCallback
extends IloCplex.OptimizationCallback

The callback base class for user-written callbacks invoked at every iteration of the simplex or barrier optimizers when they are solving a continuous model.

Continuous callbacks are executed at every iteration of the simplex algorithm or the barrier algorithm during the solution of a continuous model. Algorithm-specific callbacks are also available in the extensions IloCplex.SimplexCallback and IloCplex.BarrierCallback. By setting a continuous callback with the method IloCplex.use, you set the same callback for both the simplex and the barrier callback, thus potentially overriding other previously installed callbacks of these types.

In the case of concurrent optimization, CPLEX calls the user-written callback only in the main thread, not in other concurrent threads.

The constructor and methods of this class are protected to make sure that they are used only to derive a user-written callback class or to implement the main method in it.

See Also:

IloCplex.Callback, IloCplex.SimplexCallback, IloCplex.BarrierCallback

Nested Class Summary

Nested classes/interfaces inherited from class ilog.cplex.IloCplex.Callback

IloCplex.Callback.Context, IloCplex.Callback.Function

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	IloCplex.ContinuousCallback() The user-written callback constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected double	getDualInfeasibility() Returns a measure for the dual infeasibility of the current solution.
protected double	getInfeasibility() Returns a measure for the primal infeasibility of the current solution.
protected int	getNiterations() Returns the number of iterations performed so far.
protected long	getNiterations64() Returns the number of iterations performed so far.
protected double	getObjValue() Returns the current objective value.
protected boolean	isDualFeasible() Returns a Boolean value reporting whether the current solution is dual feasible.
protected boolean	isFeasible() Returns a Boolean value reporting whether the current solution is primal feasible.

Methods inherited from class ilog.cplex.IloCplex.OptimizationCallback

getModel, getNcols, getNQCs, getNrows

Methods inherited from class ilog.cplex.IloCplex.Callback

abort, getCplexTime, getDetTime, getEndDetTime, getEndTime, getStartDetTime, getStartTime, main

Methods inherited from class java.lang.Object

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

Constructor Detail

IloCplex.ContinuousCallback

protected IloCplex.ContinuousCallback()

The user-written callback constructor. This constructor can be called only to construct objects of derived user-written callback classes, not to construct IloCplex.ContinuousCallback objects directly.

Method Detail

getObjValue

protected double getObjValue()
                      throws IloException

Returns the current objective value. The current objective value is the objective value at the point when the callback is called. In the simplex method, this objective value may not reflect the objective function defined for the model being solved, but an artificial phase 1 objective function used to achieve primal or dual feasibility. In the barrier method, where the objective functions can be computed using dual or primal vectors and both definitions are not equivalent (unless optimality is achieved), the primal objective function is returned.

Throws:

IloException

Returns:

The current objective value.

getInfeasibility

protected double getInfeasibility()
                           throws IloException

Returns a measure for the primal infeasibility of the current solution. If the current solution is primal feasible, a value of 0 will be returned. Otherwise a positive value will be returned.

Throws:

IloException

Returns:

A measure for the primal infeasibility of the current solution.

getDualInfeasibility

protected double getDualInfeasibility()
                               throws IloException

Returns a measure for the dual infeasibility of the current solution. If the current solution is dual feasible, a value of 0 will be returned. Otherwise a positive value will be returned.

Throws:

IloException

Returns:

A measure for the dual infeasibility of the current solution.

isFeasible

protected boolean isFeasible()
                      throws IloException

Returns a Boolean value reporting whether the current solution is primal feasible.

Throws:

IloException

Returns:

A Boolean value reporting whether the current solution is primal feasible.

isDualFeasible

protected boolean isDualFeasible()
                          throws IloException

Returns a Boolean value reporting whether the current solution is dual feasible.

Throws:

IloException

Returns:

A Boolean value reporting whether the current solution is dual feasible.

getNiterations

protected int getNiterations()
                      throws IloException

Returns the number of iterations performed so far.

Throws:

IloException

Returns:

The number of iterations performed so far.

getNiterations64

protected long getNiterations64()
                         throws IloException

Returns the number of iterations performed so far.

Throws:

IloException

Returns:

The number of iterations performed so far.