XPRSaddcuts, XPRSaddcuts64
Purpose
Adds
cuts directly to the matrix at the current node. Any cuts added to the matrix at the current node and not deleted at the current node will be automatically added to the
cut pool. The cuts added to the cut pool will be automatically restored at descendant nodes.
Synopsis
int XPRS_CC XPRSaddcuts(XPRSprob prob, int ncuts, const int cuttype[], const char rowtype[], const double rhs[], const int start[], const int colind[], const double cutcoef[]);
int XPRS_CC XPRSaddcuts64(XPRSprob prob, int ncuts, const int cuttype[], const char rowtype[], const double rhs[], const XPRSint64 start[], const int colind[], const double cutcoef[]);
Arguments
|
prob
|
The current problem.
|
||||||
|
ncuts
|
Number of cuts to add.
|
||||||
|
cuttype
|
Integer array of length
ncuts containing the user assigned cut types. The cut types can be any integer chosen by the user, and are used to identify the cuts in other cut manager routines using user supplied parameters. The cut type can be interpreted as an integer or a bitmap - see XPRSdelcuts.
|
||||||
|
rowtype
|
Character array of length
ncuts containing the row types:
|
||||||
|
rhs
|
Double array of length
ncuts containing the right hand side elements for the cuts.
|
||||||
|
start
|
Integer array containing offset into the
colind and
cutcoef arrays indicating the start of each cut. This array is of length ncuts+1 with the last element,
start[ncuts], being where cut
ncuts+1 would start.
|
||||||
|
colind
|
Integer array of length
start[ncuts] containing the column indices in the cuts.
|
||||||
|
cutcoef
|
Double array of length
start[ncuts] containing the matrix values for the cuts.
|
Further information
1. The columns and elements of the cuts must be stored contiguously in the
colind and
cutcoef arrays passed to
XPRSaddcuts. The starting point of each cut must be stored in the
start array. To determine the length of the final cut, the
start array must be of length
ncuts+1 with the last element of this array containing the position in
colind and
cutcoef where the cut
ncuts+1 would start.
start[ncuts] denotes the number of nonzeros in the added cuts.
2. The cuts added to the matrix are always added at the end of the matrix and the number of rows is always set to the original number of cuts added. If ncuts have been added, then the rows
0,...,
ROWS-
ncuts-
1 are the original rows, whilst the rows
ROWS-
ncuts,...,
ROWS-
1 are the added cuts. The number of cuts can be found by consulting the
CUTS problem attribute.
3. This function should be called only from within callback functions set by either
XPRSaddcboptnode,
XPRSaddcbnodelpsolved or
XPRSaddcbcutmgr.
Related topics
XPRSaddrows,
XPRSdelcpcuts,
XPRSdelcuts,
XPRSgetcpcutlist,
XPRSgetcutlist,
XPRSloadcuts,
XPRSstorecuts, Section
Working with the Cut Manager.
© 2001-2022 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.