CPXgetbase

The routine CPXgetbase is used to get the basis resident in a CPLEX problem object. Either of the arguments cstat or rstat may be NULL if only one set of status values is needed.

Table 1: Values of elements of cstat
`CPX_AT_LOWER`	`0`	variable at lower bound
`CPX_BASIC`	`1`	variable is basic
`CPX_AT_UPPER`	`2`	variable at upper bound
`CPX_FREE_SUPER`	`3`	variable free and nonbasic

Table 2: Values of elements of rstat in rows other than ranged rows
`CPX_AT_LOWER`	`0`	associated slack, surplus, or artificial variable is nonbasic at value 0.0 (zero)
`CPX_BASIC`	`1`	associated slack, surplus, or artificial variable is basic

Table 3: Values of elements of rstat for ranged rows
`CPX_AT_LOWER`	`0`	associated slack, surplus, or artificial variable is nonbasic at its lower bound
`CPX_BASIC`	`1`	associated slack, surplus, or artificial variable is basic
`CPX_AT_UPPER`	`2`	associated slack, surplus, or artificial variable is nonbasic at upper bound

Example

 status = CPXgetbase (env, lp, cstat, rstat);

See also the example lpex2.c in the examples distributed with the product.

A pointer to the CPLEX environment as returned by CPXopenCPLEX.

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

An array to receive the basis status of the columns in the CPLEX problem object. The length of the array must be no less than the number of columns in the matrix. The array element cstat[i] has the meaning indicated in Table 1.

An array to receive the basis status of the artificial, slack, or surplus variable associated with each row in the constraint matrix. The length of the array must be no less than the number of rows in the CPLEX problem object. For rows other than ranged rows, the array element rstat[i] has the meaning indicated in Table 2. For ranged rows, the array element rstat[i] has the meaning indicated in Table 3.

The routine returns zero if a basis exists. It returns nonzero if no solution exists or any other type of error occurs.

CPXgetbase

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`.
cstat	An array to receive the basis status of the columns in the CPLEX problem object. The length of the array must be no less than the number of columns in the matrix. The array element `cstat[i]` has the meaning indicated in Table 1.
rstat	An array to receive the basis status of the artificial, slack, or surplus variable associated with each row in the constraint matrix. The length of the array must be no less than the number of rows in the CPLEX problem object. For rows other than ranged rows, the array element `rstat[i]` has the meaning indicated in Table 2. For ranged rows, the array element `rstat[i]` has the meaning indicated in Table 3.