Initializing help system before first use

XSLPaddvars

Purpose
This subroutine is deprecated and will be removed in a future release.
Add SLP variables defined as matrix columns to an SLP problem.
Synopsis
int XPRS_CC XSLPaddvars(XSLPprob prob, int nvars, int *colind, int *coltype, int *detrow, int *seqnum, int *tolind, double *initial, double *stepbound);
Arguments
prob 
The current SLP problem.
nvars 
The number of SLP variables to be added.
colind 
Integer array holding the index of the matrix column corresponding to each SLP variable.
coltype 
Bitmap giving information about the SLP variables, compare the variable status keys, in particular:
Bit 2 (XSLP_HASIV) 
Variable has an initial value;
May be NULL if not required.
detrow 
Integer array holding the index of the determining row for each SLP variable (a negative value means there is no determining row)
May be NULL if not required.
seqnum 
Integer array holding the index sequence number for cascading for each SLP variable (a zero value means there is no pre-defined order for this variable)
May be NULL if not required.
tolind 
Integer array holding the index of the tolerance set for each SLP variable (a zero value means the default tolerances are used)
May be NULL if not required.
initial 
Double array holding the initial value for each SLP variable (use the coltype bit map to indicate if a value is being provided)
May be NULL if not required.
stepbound 
Double array holding the initial step bound size for each SLP variable (a zero value means that no initial step bound size has been specified). If a value of XPRS_PLUSINFINITY is used for a value in stepbound, the delta will never have step bounds applied, and will almost always be regarded as converged.
May be NULL if not required.
Example
The following example loads two SLP variables into the problem. They correspond to columns 23 and 25 of the underlying LP problem. Column 25 has an initial value of 1.42; column 23 has no specific initial value
int colind[2], coltype[2];
double initial[2];

colind[0] = 23; coltype[0] = 0; initial[0] = 0.0;
colind[1] = 25; coltype[1] = XSLP_HASIV; initial[1] = 1.42;

XSLPaddvars(prob, 2, colind, coltype, NULL, NULL,
            NULL, initial, NULL);

Note that initial for the first variable will not actually be used, because the XSLP_HASIV flag is not set (coltype = 0). Setting the variable type to XSLP_HASIV for the second variable indicates that the initial value has been set.

The arrays for determining rows, sequence numbers, tolerance sets and step bounds are not used at all, and so have been passed to the function as NULL.


Further information

The XSLPadd... functions load additional items into the SLP problem. The corresponding XSLPload... functions delete any existing items first.


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.