CPXaddsos

The routine CPXaddsos adds information about a Special Ordered Set (SOS) to a problem object of type CPXPROB_MILP, CPXPROB_MIQP, or CPXPROB_MIQCP. The problem may already contain SOS information.

Table 1: Values of elements of sostype
`CPX_TYPE_SOS1`	`'1'`	Type 1
`CPX_TYPE_SOS2`	`'2'`	Type 2

The arrays sosbeg, sosind, and soswts follow the same conventions as similar arrays in other routines of the Callable Library. For j < numsos-1 the indices of set j must be stored in sosind[sosbeg[j]],..., sosind[sosbeg[j+1]-1] and the weights in soswt[sosbeg[j],..., soswt[sosbeg[j+1]-1]. For the last set, j = numsos-1, the indices must be stored in sosind[sosbeg[numsos-1]],..., sosind[numsosnz-1]and the corresponding weights in soswt[sosbeg[numsos-1]],..., soswt[numsosnz-1]. Hence, the length of sosbeg must be at least numsos, while the lengths of sosind and soswt must must be at least numsosnz.

Example

 status = CPXaddsos (env, lp, numsos, numsosnz, sostype, sospri,
                     sosbeg, sosind, soswt);

A pointer to the CPLEX environment as returned by CPXopenCPLEX.

A pointer to a CPLEX problem object as returned by CPXcreateprob.

The number of sets to be added to existing SOS sets, if any.

The total number of members in all of the sets to be added to existing SOS sets, if any.

An array containing SOS type information for the sets to be added. According to Table 1, sostype[i] specifies the SOS type of set i. The length of this array must be at least numsos.

An array containing priority values for each set to be added. sospri[i] specifies the priority for set i, and may take any nonnegative value. This array may be NULL; otherwise, its length must be at least numsos.

An array that with sosind and soswt defines the weights for the sets to be added.

An array that with sosbeg and soswt defines the weights of the sets to be added.

An array that with sosbeg and sosind defines the indices and weights for the sets to be added. The indices of each set must be stored in sequential locations in sosind. The weights of each set must be stored in sequential locations in soswt. The array sosbeg[j] containing the index of the beginning of set j. The weights must be unique within each set.

The routine returns zero on success and nonzero if an error occurs.

CPXaddsos

Parameters:

Returns:

env	A pointer to the CPLEX environment as returned by `CPXopenCPLEX`.
lp	A pointer to a CPLEX problem object as returned by `CPXcreateprob`.
numsos	The number of sets to be added to existing SOS sets, if any.
numsosnz	The total number of members in all of the sets to be added to existing SOS sets, if any.
sostype	An array containing SOS type information for the sets to be added. According to Table 1, `sostype[i]` specifies the SOS type of set `i`. The length of this array must be at least `numsos`.
sospri	An array containing priority values for each set to be added. `sospri[i]` specifies the priority for set `i`, and may take any nonnegative value. This array may be NULL; otherwise, its length must be at least `numsos`.
sosbeg	An array that with `sosind` and `soswt` defines the weights for the sets to be added.
sosind	An array that with `sosbeg` and `soswt` defines the weights of the sets to be added.
soswt	An array that with `sosbeg` and `sosind` defines the indices and weights for the sets to be added. The indices of each set must be stored in sequential locations in `sosind`. The weights of each set must be stored in sequential locations in `soswt`. The array `sosbeg[j]` containing the index of the beginning of set `j`. The weights must be unique within each set.