Problem Attributes
During the optimization process, various properties of the problem being solved are stored and made available to users of the Xpress-SLP 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-SLP attributes:
XSLP_COEFFICIENTS Number of nonlinear coefficientsXSLP_CURRENTDELTACOST Current value of penalty cost multiplier for penalty delta vectorsXSLP_CURRENTERRORCOST Current value of penalty cost multiplier for penalty error vectorsXSLP_CVS Number of character variablesXSLP_DELTAS Number of delta vectors created during augmentationXSLP_ECFCOUNT Number of infeasible constraints found at the point of linearizationXSLP_EQUALSCOLUMN Index of the reserved "=" columnXSLP_ERRORCOSTS Total penalty costs in the solutionXSLP_GLOBALFUNCOBJECT The user-defined global function objectXSLP_IFS Number of internal functionsXSLP_IMPLICITVARIABLES Number of SLP variables appearing only in coefficientsXSLP_INTERNALFUNCCALLS Number of calls made to internal functionsXSLP_ITER SLP iteration countXSLP_MINORVERSION Xpress-SLP minor version numberXSLP_MINUSPENALTYERRORS Number of negative penalty error vectorsXSLP_MIPITER Total number of SLP iterations in MISLPXSLP_MIPNODES Number of nodes explored in MISLPXSLP_MIPPROBLEM The underlying Optimizer MIP problemXSLP_NONLINEARCONSTRAINTS Number of nonlinear constraints in the problemXSLP_OBJSENSE Objective function senseXSLP_OBJVAL Objective function value excluding any penalty costsXSLP_PENALTYDELTACOLUMN Index of column costing the penalty delta rowXSLP_PENALTYDELTAROW Index of equality row holding the penalties for delta vectorsXSLP_PENALTYDELTAS Number of penalty delta vectorsXSLP_PENALTYDELTATOTAL Total activity of penalty delta vectorsXSLP_PENALTYDELTAVALUE Total penalty cost attributed to penalty delta vectorsXSLP_PENALTYERRORCOLUMN Index of column costing the penalty error rowXSLP_PENALTYERRORROW Index of equality row holding the penalties for penalty error vectorsXSLP_PENALTYERRORS Number of penalty error vectorsXSLP_PENALTYERRORTOTAL Total activity of penalty error vectorsXSLP_PENALTYERRORVALUE Total penalty cost attributed to penalty error vectorsXSLP_PLUSPENALTYERRORS Number of positive penalty error vectorsXSLP_PRESOLVEPASSES Number of passes made by the SLP nonlinear presolve procedureXSLP_SBXCONVERGED Number of step-bounded variables converged only on extended criteriaXSLP_STATUS Bitmap holding the problem convergence statusXSLP_TOLSETS Number of tolerance setsXSLP_UCCONSTRAINEDCOUNT Number of unconverged variables with coefficients in constraining rowsXSLP_UFINSTANCES Number of user function instancesXSLP_UFS Number of user functionsXSLP_UNCONVERGED Number of unconverged valuesXSLP_UNIQUEPREFIX Unique prefix for generated namesXSLP_USEDERIVATIVES Indicates whether numeric or analytic derivatives were used to create the linear approximations and solve the problemXSLP_USERFUNCCALLS Number of calls made to user functionsXSLP_VALIDATIONINDEX_A Absolute validation indexXSLP_VALIDATIONINDEX_R Relative validation indexXSLP_VARIABLES Number of SLP variablesXSLP_VERSION Xpress-SLP major version numberXSLP_VERSIONDATE Date of creation of Xpress-SLPXSLP_XPRSPROBLEM The underlying Optimizer problemXSLP_XSLPPROBLEM The Xpress-SLP problemXSLP_XVS Number of extended variable arraysDouble problem attributes
Integer problem attributes
Reference (pointer) problem attributes
The reference attributes are void pointers whose size (32 or 64 bit) depends on the platform.
String problem attributes
If you have any comments or suggestions about these pages, please send mail to docs@dashoptimization.com.