CPXgetdblquality

Description

The routine CPXgetdblquality() is used to access 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 variables pointed to by the argument quality_p.

The maximum bound infeasibility identifies the largest bound violation, which helps determine the cause of an infeasible problem. If it 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, it gives insight into the smallest setting for the feasibility tolerance that would not cause the problem to terminate infeasible.

The routine returns a zero on success, and a nonzero if an error occurs.

int CPXgetdblquality (CPXCENVptr env, CPXCLPptr lp, double *quality_p, int what);

Arguments

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

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

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

A symbolic constant indicating the quality value to be retrieved. The possible quality values for a solution are listed in Appendix D, Solution Quality Values.

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