CPXXNETgetbase and CPXNETgetbase

The routine CPXXNETgetbase/CPXNETgetbase is used to access the network basis for a network problem object.

int CPXXNETgetbase( CPXCENVptr env, CPXCNETptr net, int * astat, int * nstat )

int CPXNETgetbase( CPXCENVptr env, CPXCNETptr net, int * astat, int * nstat )

Description

The routine CPXXNETgetbase/CPXNETgetbase is used to access the network basis for a network problem object. Either of the arguments astat or nstat may be NULL.

For this function to succeed, a solution must exist for the problem object.

Table 1. Table 1: Status codes of network arcs
`CPX_BASIC`	If the arc is basic.
`CPX_AT_LOWER`	If the arc is nonbasic and its flow is on the lower bound.
`CPX_AT_UPPER`	If the arc is nonbasic and its flow is on the upper bound.
`CPX_FREE_SUPER`	If the arc is nonbasic but is free.In this case its flow is 0.

Table 2. Table 2: Status of artificial arcs
`CPX_BASIC`	If the arc is basic.
`CPX_AT_LOWER`	If the arc is nonbasic and its flow is on the lower bound.

Arguments

env: A pointer to the CPLEX environment as returned by CPXXopenCPLEX/CPXopenCPLEX.
net: A pointer to a CPLEX network problem object as returned by CPXXNETcreateprob/CPXNETcreateprob.
astat: An array in which the statuses for network arcs are to be written. After termination, astat[i] contains the status assigned to arc i of the network stored in net. The status may be one of the values in Table 1. If NULL is passed, no arc statuses are copied. Otherwise, astat must be an array of a size that is at least CPXXNETgetnumarcs/CPXNETgetnumarcs.
nstat: An array in which the statuses for artificial arcs from each node to the root node are to be written. After termination, nstat[i] contains the status assigned to the artificial arc from node i to the root node of the network stored in net. The status may be one of values in Table 2. If NULL is passed, no node statuses are copied. Otherwise, nstat must be an array of a size that is at least CPXXNETgetnumnodes/CPXNETgetnumnodes.

Return

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

Example


 status = CPXNETgetbase (env, net, astat, nstat);