Initializing help system before first use

XSLPloadtolsets

Purpose
This subroutine is deprecated and will be removed in a future release.
Load sets of standard tolerance values into an SLP problem.
Synopsis
int XPRS_CC XSLPloadtolsets(XSLPprob prob, int ntolsets, double *tols);
Arguments
prob 
The current SLP problem.
ntolsets 
The number of tolerance sets to be loaded.
tols 
Double array of ( ntolsets * 9) items containing the 9 tolerance values for each set in order.
Example
The following example creates two tolerance sets: the first has values of 0.005 for all tolerances; the second has values of 0.001 for relative tolerances (numbers 2,4,6,8), values of 0.01 for absolute tolerances (numbers 1,3,5,7) and zero for the closure tolerance (number 0).
double tols[18];
for (i=0;i<9;i++) tols[i] = 0.005;
tols[9] = 0;
for (i=10;i<18;i=i+2) tols[i] = 0.01;
for (i=11;i<18;i=i+2) tols[i] = 0.001;
XSLPloadtolsets(prob, 2, tols);
Further information
A tolerance set is an array of 9 values containing the following tolerances:

Entry / Bit Tolerance XSLP constant XSLP bit constant
0 Closure tolerance (TC) XSLP_TOLSET_TC XSLP_TOLSETBIT_TC
1 Absolute delta tolerance (TA) XSLP_TOLSET_TA XSLP_TOLSETBIT_TA
2 Relative delta tolerance (RA) XSLP_TOLSET_RA XSLP_TOLSETBIT_RA
3 Absolute coefficient tolerance (TM) XSLP_TOLSET_TM XSLP_TOLSETBIT_TM
4 Relative coefficient tolerance (RM) XSLP_TOLSET_RM XSLP_TOLSETBIT_RM
5 Absolute impact tolerance (TI) XSLP_TOLSET_TI XSLP_TOLSETBIT_TI
6 Relative impact tolerance (RI) XSLP_TOLSET_RI XSLP_TOLSETBIT_RI
7 Absolute slack tolerance (TS) XSLP_TOLSET_TS XSLP_TOLSETBIT_TS
8 Relative slack tolerance (RS) XSLP_TOLSET_RS XSLP_TOLSETBIT_RS

The XSLP_TOLSET constants can be used to access the corresponding entry in the value arrays, while the XSLP_TOLSETBIT constants are used to set or retrieve which tolerance values are used for a given SLP variable.

Once created, a tolerance set can be used to set the tolerances for any SLP variable.

If a tolerance value is zero, then the default tolerance will be used instead. To force the use of a tolerance, use the XSLPchgtolset function and set the Status variable appropriately.

See the section "Convergence Criteria" for a fuller description of tolerances and their uses.

The XSLPload... functions load items into the SLP problem. Any existing items of the same type are deleted first. The corresponding XSLPadd... functions add or replace items leaving other items of the same type unchanged.


Related topics

© 2001-2025 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.