Initializing help system before first use

Problem Attributes

During the optimization process, various properties of the problem being solved are stored and made available to users of the Xpress NonLinear Libraries in the form of problem attributes. These can be accessed in much the same manner as the controls. Examples of problem attributes include the sizes of arrays, for which library users may need to allocate space before the arrays themselves are retrieved. A full list of the attributes available and their types may be found in this chapter.

Library users are provided with the following functions for obtaining the values of attributes:

XSLPgetintattrib XSLPgetdblattrib
XSLPgetptrattrib XSLPgetstrattrib

The attributes listed in this chapter are all prefixed with XSLP_. It is possible to use the above functions with attributes for the Xpress Optimizer (attributes prefixed with XPRS_). For details of the Optimizer attributes, see the Optimizer manual.

Example of the usage of the functions:

XSLPgetintattrib(Prob, XSLP_ITER, &nIter);
printf("The number of SLP iterations is %d\n", nIter);
XSLPgetdblattrib(Prob, XSLP_ERRORCOSTS, &Errors);
printf("and the total error cost is %lg\n", Errors);

The following is a list of all the Xpress NonLinear attributes:

Number of nonlinear coefficients
Current value of penalty cost multiplier for penalty delta vectors
Current value of penalty cost multiplier for penalty error vectors
Number of character variables
Number of delta vectors created during augmentation
Number of infeasible constraints found at the point of linearization
Index of the reserved "=" column
Total penalty costs in the solution
Number of variables with an exploration-type delta set up in the problem
Number of internal functions
Number of SLP variables appearing only in coefficients
Number of variables set up with an integer delta in the problem
Number of calls made to internal functions
SLP iteration count
Unique identifier for the current job
The iteration in which the returned solution has been found.
Xpress NonLinear minor version number
Number of negative penalty error vectors
Total number of SLP iterations in MISLP
Number of nodes explored in MISLP. This includes any nodes for which a non-linear solve has been carried out.
The underlying Optimizer MIP problem. XSLP_MIPPROBLEM is a reference of type XPRSprob, and should be used in MISLP callbacks to access MIP-specific Optimizer values (such as node and parent numbers).
Number of integer solutions found in MISLP. This includes solutions found during the tree search or any heuristics.
Number of model columns in the problem
Number of model rows in the problem
Status of the mutlistart search
The solution status of the problem.
Number of coefficients in the augmented problem that might change between SLP iterations
Number of nonlinear constraints in the problem
Objective function value excluding any penalty costs
Number of model columns in the problem
Number of model rows in the problem
Index of column costing the penalty delta row
Index of equality row holding the penalties for delta vectors
Number of penalty delta vectors
Total activity of penalty delta vectors
Total penalty cost attributed to penalty delta vectors
Index of column costing the penalty error row
Index of equality row holding the penalties for penalty error vectors
Number of penalty error vectors
Total activity of penalty error vectors
Total penalty cost attributed to penalty error vectors
Number of positive penalty error vectors
Number of potential delta variables deleted by XSLPpresolve
Number of SLP variables eliminated by XSLPpresolve
Number of SLP coefficients fixed by XSLPpresolve
Number of determining rows fixed by XSLPpresolve
Number of variables fixed to a nonzero value by XSLPpresolve
Number of SLP variables fixed by XSLPpresolve
Number of variables fixed at zero by XSLPpresolve
Number of passes made by the SLP nonlinear presolve procedure
Indicates if the problem is presolved
Number of bounds tightened by XSLPpresolve
Local primal integral of the solve
Number of step-bounded variables converged only on extended criteria
Number of variables with a minimum perturbation step set up in the problem
Indicates the type of solution returned by the solver.
The underlying solution pool. XSLP_SOLUTIONPOOL is a reference of type XPRSmipsolpool. Change control XSLP_ANALYZE to record the solutions into the pool.
Includes information of which Xpress solver has been used to solve the problem
Bitmap holding the problem convergence status
Status of the optimization process.
Number of tolerance sets
The total number of evaluation errors during the solve
Number of unconverged variables with coefficients in constraining rows
Number of user function instances
Number of user functions
Number of unconverged values
Indicates whether numeric or analytic derivatives were used to create the linear approximations and solve the problem
Number of calls made to user functions
Absolute validation index
Relative first order optimality validation index
Relative validation index
Number of SLP variables
Xpress NonLinear major version number
Date of creation of Xpress NonLinear
Vertex solution index
The underlying Optimizer problem
The Xpress NonLinear problem
Number of placeholder entries set to zero
Number of potentially zero placeholders left untouched
Number of potential zero placeholder entries