CPXcopydnorms

Note

This is an advanced routine. Advanced routines typically demand a profound understanding of the algorithms used by ILOG CPLEX. Thus they incur a higher risk of incorrect behavior in your application, behavior that can be difficult to debug. Therefore, ILOG encourages you to consider carefully whether you can accomplish the same task by means of other Callable Library routines instead.

The routine CPXcopydnorms copies the dual steepest-edge norms to the specified LP problem object. The argument head is an array of column or row indices corresponding to the array of norms. Column indices are indexed with nonnegative values. Row indices are indexed with negative values offset by 1 (one). For example, if head[0] = -5, then norm[0] is associated with row 4.

The pointer to the ILOG CPLEX environment, as returned by CPXopenCPLEX.

A pointer to the CPLEX LP problem object, as returned by CPXcreateprob.

An array containing values to be used in a subsequent call to CPXdualopt, with a setting of CPX_PARAM_DGRADIENT different from 1 (one), as the initial values for the dual steepest-edge norms of the corresponding basic variables specified in head[]. The array must be of length at least equal to the value of the argument len. If any indices in head[] are not basic, the corresponding values in norm[] are ignored.

An array containing the indices of the basic variables for which norms have been specified in norm[]. The array must be of length at least equal to the value of the argument len.

An integer that indicates the number of entries in norm[] and head[].

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

CPXcopydnorms

Parameters:

Returns:

env	The pointer to the ILOG CPLEX environment, as returned by `CPXopenCPLEX`.
lp	A pointer to the CPLEX LP problem object, as returned by `CPXcreateprob`.
norm	An array containing values to be used in a subsequent call to CPXdualopt`, with a setting of CPX_PARAM_DGRADIENT different from 1 (one), as the initial values for the dual steepest-edge norms of the corresponding basic variables specified in head[]. The array must be of length at least equal to the value of the argument len. If any indices in head[] are not basic, the corresponding values in norm[] are ignored.`
head	An array containing the indices of the basic variables for which norms have been specified in `norm[]`. The array must be of length at least equal to the value of the argument `len`.
len	An integer that indicates the number of entries in `norm[]` and `head[]`.