CPXcopylpwnames

The routine CPXcopylpwnames copies LP data into a CPLEX problem object in the same way as the routine CPXcopylp, but using some additional arguments to specify the names of constraints and variables in the CPLEX problem object. The arguments to CPXcopylpwnames define an objective function, constraint matrix, variable bounds, righthand side constraint senses, and range values. Unlike the routine CPXcopylp, CPXcopylpwnames also copies names. This routine is used in the same way as CPXcopylp.

Table 1: Settings for objsense
`objsense`	= `1`	(`CPX_MIN`) minimize
`objsense`	= `-1`	(`CPX_MAX`) maximize

Table 2: Settings for sense
`sense[i]`	= `'L'`	<= constraint
`sense[i]`	= `'E'`	= constraint
`sense[i]`	= `'G'`	>= constraint
`sense[i]`	= `'R'`	ranged constraint

With respect to the parameters matbeg (beginning of the matrix), matcnt (count of the matrix), matind (indices of the matrix), and matval (values of the matrix), CPLEX needs to know only the nonzero coefficients. These are grouped by column in the array matval. The nonzero elements of every column must be stored in sequential locations in this array with matbeg[j] containing the index of the beginning of column j and matcnt[j] containing the number of entries in column j. The components of matbeg must be in ascending order. For each k, matind[k] indicates the row number of the corresponding coefficient, matval[k].

These arrays are accessed as follows. Suppose that CPLEX wants to access the entries in some column j. These are assumed to be given by the array entries:

 matval[matbeg[j]],.., matval[matbeg[j]+matcnt[j]-1]

The corresponding row indices are:

 matind[matbeg[j]],.., matind[matbeg[j]+matcnt[j]-1]

Entries in matind are not required to be in row order. Duplicate entries in matind and matval within a single column are not allowed. The length of the arrays matbeg and matind should be at least numcols. The length of arrays matind and matval should be at least matbeg[numcols-1]+matcnt[numcols-1].

When you build or modify your model with this routine, you can verify that the results are as you intended by calling CPXcheckcopylpwnames during application development.

Example

 status = CPXcopylpwnames (env,
                           lp,
                           numcols,
                           numrows,
                           objsen,
                           obj,
                           rhs,
                           sense,
                           matbeg,
                           matcnt,
                           matind,
                           matval,
                           lb,
                           ub,
                           rngval,
                           colname,
                           rowname);

A pointer to the CPLEX environment as returned by CPXopenCPLEX.

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

An integer that indicates the number of columns in the constraint matrix, or equivalently, the number of variables in the problem object.

An integer that indicates the number of rows in the constraint matrix, not including the objective function or bounds on the variables.

An integer that indicates whether the problem is a minimization or maximization problem. Table 1 shows its possible settings.

An array of length at least numcols containing the objective function coefficients.

An array of length at least numrows containing the righthand side value for each constraint in the constraint matrix.

An array of length at least numrows containing the sense of each constraint in the constraint matrix. Table 2 shows the possible settings.

An array that defines the constraint matrix.

An array of length at least numcols containing the lower bound on each of the variables. Any lower bound that is set to a value less than or equal to that of the constant -CPX_INFBOUND is treated as negative infinity. CPX_INFBOUND is defined in the header file cplex.h.

An array of length at least numcols containing the upper bound on each of the variables. Any upper bound that is set to a value greater than or equal to that of the constant CPX_INFBOUND is treated as infinity. CPX_INFBOUND is defined in the header file cplex.h.

An array of length at least numrows containing the range value of each ranged constraint. Ranged rows are those designated by R in the sense array. If the row is not ranged, the rngval array entry is ignored. If rngval[i] > 0, then row i activity is in [rhs[i],rhs[i]+rngval[i]], and if rngval[i] <= 0, then row i activity is in [rhs[i]+rngval[i],rhs[i]]. This parameter may be NULL.

An array of length at least numcols containing pointers to character strings. Each string is terminated with the NULL character. These strings represent the names of the matrix columns or, equivalently, the variable names. May be NULL if no names are associated with the variables. If colname is not NULL, every variable must be given a name. The addresses in colname do not have to be in ascending order.

An array of length at least numrows containing pointers to character strings. Each string is terminated with the NULL character. These strings represent the names of the matrix rows or, equivalently, the constraint names. May be NULL if no names are associated with the constraints. If rowname is not NULL, every constraint must be given a name. The addresses in rowname do not have to be in ascending order.

The routine returns zero if successful and nonzero if an error occurs.

CPXcopylpwnames

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`.
numcols	An integer that indicates the number of columns in the constraint matrix, or equivalently, the number of variables in the problem object.
numrows	An integer that indicates the number of rows in the constraint matrix, not including the objective function or bounds on the variables.
objsense	An integer that indicates whether the problem is a minimization or maximization problem. Table 1 shows its possible settings.
objective	An array of length at least `numcols` containing the objective function coefficients.
rhs	An array of length at least `numrows` containing the righthand side value for each constraint in the constraint matrix.
sense	An array of length at least `numrows` containing the sense of each constraint in the constraint matrix. Table 2 shows the possible settings.
matbeg	An array that defines the constraint matrix.
matcnt	An array that defines the constraint matrix.
matind	An array that defines the constraint matrix.
matval	An array that defines the constraint matrix.
lb	An array of length at least `numcols` containing the lower bound on each of the variables. Any lower bound that is set to a value less than or equal to that of the constant `-CPX_INFBOUND` is treated as negative infinity. `CPX_INFBOUND` is defined in the header file `cplex.h`.
ub	An array of length at least `numcols` containing the upper bound on each of the variables. Any upper bound that is set to a value greater than or equal to that of the constant `CPX_INFBOUND` is treated as infinity. `CPX_INFBOUND` is defined in the header file `cplex.h`.
rngval	An array of length at least `numrows` containing the range value of each ranged constraint. Ranged rows are those designated by `R` in the `sense` array. If the row is not ranged, the `rngval` array entry is ignored. If `rngval[i]` > 0, then row `i` activity is in `[rhs[i],rhs[i]+rngval[i]]`, and if `rngval[i]` <= 0, then row `i` activity is in `[rhs[i]+rngval[i],rhs[i]]`. This parameter may be NULL.
colname	An array of length at least `numcols` containing pointers to character strings. Each string is terminated with the NULL character. These strings represent the names of the matrix columns or, equivalently, the variable names. May be NULL if no names are associated with the variables. If `colname` is not NULL, every variable must be given a name. The addresses in `colname` do not have to be in ascending order.
rowname	An array of length at least `numrows` containing pointers to character strings. Each string is terminated with the NULL character. These strings represent the names of the matrix rows or, equivalently, the constraint names. May be NULL if no names are associated with the constraints. If `rowname` is not NULL, every constraint must be given a name. The addresses in `rowname` do not have to be in ascending order.