[Previous] [Next]

XSLPloadtolsets

Purpose

Load sets of standard tolerance values into an SLP problem

Synopsis

int XPRS_CC XSLPloadtolsets(XSLPprob Prob, int nSLPTol, double *SLPTol);

Arguments

Prob	The current SLP problem.
nSLPTol	The number of tolerance sets to be loaded.
SLPTol	Double array of (nSLPTol * 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 SLPTol[18];
for (i=0;i<9;i++) SLPTol[i] = 0.005;
SLPTol[9] = 0;
for (i=10;i<18;i=i+2) SLPTol[i] = 0.01;
for (i=11;i<18;i=i+2) SLPTol[i] = 0.001;
XSLPloadtolsets(Prob, 2, SLPTol);

Further information

A tolerance set is an array of 9 values containing the following tolerances:

Entry Tolerance

0 Closure tolerance (TC)

1 Absolute delta tolerance (TA)

2 Relative delta tolerance (RA)

3 Absolute coefficient tolerance (TM)

4 Relative coefficient tolerance (RM)

5 Absolute impact tolerance (TI)

6 Relative impact tolerance (RI)

7 Absolute slack tolerance (TS)

8 Relative slack tolerance (RS)

Entry	Tolerance
0	Closure tolerance (TC)
1	Absolute delta tolerance (TA)
2	Relative delta tolerance (RA)
3	Absolute coefficient tolerance (TM)
4	Relative coefficient tolerance (RM)
5	Absolute impact tolerance (TI)
6	Relative impact tolerance (RI)
7	Absolute slack tolerance (TS)
8	Relative slack tolerance (RS)

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