CPXcopylp

Description

The routine CPXcopylp() copies data that defines an LP problem to a CPLEX problem object. The arguments to CPXcopylp() define an objective function, the constraint matrix, the right-hand side, and the bounds on the variables. The routine CPXcopylp() does not copy names. Calling CPXcopylp() destroys any existing data associated with the problem object.

The more comprehensive routine CPXcopylpwnames() can be used in place of CPXcopylp() to copy linear programs with associated names.

The arguments passed to CPXcopylp() define a linear program. Since these arguments are copied into local arrays maintained by CPLEX, the LP problem data passed via CPXcopylp() may be modified or freed after the call to CPXcopylp() without affecting the state of the CPLEX problem object.

Return Value

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

Synopsis

int CPXcopylp (CPXCENVptr env, CPXLPptr lp, int numcols, int numrows, int objsen, const double *obj, const double *rhs, const char *sense, const int *matbeg, const int *matcnt, const int *matind, const double *matval, const double *lb, const double *ub, const double *rngval);

Arguments

`objsen`	= `1`	(`CPX_MIN`) minimize
`objsen`	= `-1`	(`CPX_MAX`) maximize

const double *obj

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

const double *rhs

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

const char *sense

An array of at least length at least numrows containing the sense of each constraint in the constraint matrix.

`sense[i]`	= `'L'`	constraint
`sense[i]`	= `'E'`	= constraint
`sense[i]`	= `'G'`	constraint
`sense[i]`	= `'R'`	ranged constraint

const int *matbeg

const int *matcnt

const int *matind

const double *matval

Arrays that describe the constraint 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 within a single column are not allowed. The length of the arrays matbeg and matind should be of at least numcols. The length of arrays matind and matval should be of at least matbeg[numcols-1]+matcnt[numcols-1].

const double *lb

An array of at least length 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 . CPX_INFBOUND is defined in the header file cplex.h.

const double *ub

An array of at least length 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 . CPX_INFBOUND is defined in the header file cplex.h.

const double *rngval

An array of at least length 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.

Example

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