Initializing help system before first use

XSLPgettolset

Purpose
This subroutine is deprecated and will be removed in a future release.
Retrieve the values of a set of convergence tolerances for an SLP problem.
Topic areas
SLP, SLP-convergence
Synopsis
int XPRS_CC XSLPgettolset(XSLPprob prob, int tolset, int *p_status, double *tols);
Arguments
prob 
The current SLP problem.
tolset 
The index of the tolerance set.
p_status 
Address of integer to receive the bit-map of status settings. May be NULL if not required.
tols 
Array of 9 double-precision values to hold the tolerances. May be NULL if not required.
Example
The following example retrieves the values for tolerance set 3 and prints those which are set: 
double tols[9];
int i, status;
XSLPgettolset(prob, 3, &status, tols);
for (i=0;i<9;i++)
  if (status & (1<<i))
    printf("\nTolerance %d = %lg",i,tols[i]);
Further information
1. If p_status or tols is NULL, then the corresponding information will not be returned.
2. If tols is not NULL, then a set of 9 values will always be returned. p_status indicates which of these values is active as follows. Bit n of p_status is set if tols[n] is active, where n is:

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


3. 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.
Related topics
Related topics
XSLPaddtolsets, XSLPchgtolset, XSLPdeltolsets, XSLPloadtolsets


Parent Topic Library functions

© 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.