[Previous] [Next]

XSLPchgdc

---

Purpose

Add or change the settings for a delayed constraint (DC)

Synopsis

int XPRS_CC XSLPchgdc(XSLPprob Prob, int RowIndex, char *RowType, int *Delay, int *IterCount, int Parsed, int *Type, double *Value);

Arguments

Prob	The current SLP problem.
RowIndex	Index of row whose DC status is to be changed. This respects the setting of XPRS_CSTYLE.
RowType	Character buffer holding the type of the row when it is constraining. May be NULL if not required.
Delay	Address of an integer holding the delay after the DC is initiated. May be NULL if not required.
IterCount	Address of an integer holding the number of SLP iterations since the DC was initiated. May be NULL if not required.
Parsed	integer indicating whether the formula is in internal unparsed (Parsed=0) or internal parsed reverse Polish (Parsed=1) format.
Type	Integer array of token types (see the section on Formula Parsing for a full list). May be NULL if not required.
Value	Array of values corresponding to the types in Type. May be NULL if not required.

Example

The following example delays row 3 until 2 SLP iterations after column 12 becomes nonzero

int Delay, Type[2];
double Value[2];

Delay = 2;
Type[0] = XSLP_COL; Value[0] = 12;
Type[1] = XSLP_EOF;

XSLPchgdc(Prob, 3, NULL, 2, &Delay, NULL, 0 Type, Value);

Further information

The formula is used to determine when the DC is initiated. An empty formula and zero Delay means that the DC is initiated after the first SLP iteration.

If any of the addresses is NULL then the current information for the DC will be left unaltered. For a new DC, the defaults will be left unchanged.

The array of formula tokens must be terminated by an XSLP_EOF token.

If RowType is not given, the type of the row in the current matrix will be used.

If Delay is not given, the default delay from XSLP_DCLIMIT will be used. To activate a DC immediately, set Delay to -1 and provide an empty formula.

If IterCount is less than Delay, then the DC is inactive. A nonzero value for IterCount implies that the DC is initiated, and IterCount will be incremented at each subsequent SLP iteration.

If Type and/or Value is NULL the existing formula will not be changed.

If an empty formula (Type[0] = XSLP_EOF) is given, then the DC will be initiated after the delay; a zero delay means after the first SLP iteration.

Related topics

XSLPadddcs, XSLPgetdc, XSLPloaddcs,

[Previous] [Next] [Index]

---

If you have any comments or suggestions about these pages, please send mail to docs@dashoptimization.com.