NO FRAMES

CPXgetdblquality

public int CPXgetdblquality(CPXCENVptr env, CPXCLPptr lp, double * quality_p, int what)
Definition file: cplex.h

The routine CPXgetdblquality accesses double-valued information about the quality of the current solution of a problem. A solution, though not necessarily a feasible or optimal one, must be available in the CPLEX problem object. The quality values are returned in the double variable pointed to by the argument quality_p.

The maximum bound infeasibility identifies the largest bound violation. Largest bound violation may help determine the cause of an infeasible problem. If the largest bound violation exceeds the feasibility tolerance by only a small amount, it may be possible to obtain a feasible solution to the problem by increasing the feasibility tolerance. If a problem is optimal, the largest bound violation gives insight into the smallest setting for the feasibility tolerance that would not cause the problem to terminate infeasibly.

Example

 status = CPXgetdblquality (env, lp, &max_x, CPX_MAX_X);
 

Parameters:

env

A pointer to the CPLEX environment as returned by the CPXopenCPLEX routine.

lp

A pointer to a CPLEX problem object as returned by CPXcreateprob.

quality_p

A pointer to a double variable in which the requested quality value is to be stored. If an error occurs, the quality-value remains unchanged.

what

A symbolic constant specifying the quality value to be retrieved. The possible quality values for a solution are listed in the group optim.cplex.callable.solutionquality in the ILOG CPLEX Reference Manual.

Returns:

The routine returns zero if successful and nonzero if an error occurs. If an error occurs, the quality-value remains unchanged.