naginterfaces.library.opt.handle_​set_​linconstr_​coeff

naginterfaces.library.opt.handle_set_linconstr_coeff(handle, idlc, icolbj, bij)

handle_set_linconstr_coeff is a part of the NAG optimization modelling suite and sets or modifies a single element in the linear constraint matrix of the problem.

For full information please refer to the NAG Library document for e04tj

https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/e04/e04tjf.html

Parameters

handleHandle

The handle to the problem. It needs to be initialized (e.g., by handle_init()) and must not be changed between calls to the NAG optimization modelling suite.

idlcint

$i$, the number of the linear constraint, i.e., the row index of the element $b_{\text{ij}}$ in the linear constraint matrix to be changed.

icolbjint

$j$, the column (variable) index of the element $b_{\text{ij}}$.

bijfloat

$b_{\text{ij}}$, the new value of the element in the linear constraint matrix $B$.

Raises

NagValueError

(errno $1$)

$handle$ has not been initialized.

(errno $1$)

$handle$ does not belong to the NAG optimization modelling suite, has not been initialized properly or is corrupted.

(errno $1$)

$handle$ has not been initialized properly or is corrupted.

(errno $2$)

The problem cannot be modified right now, the solver is running.

(errno $3$)

There are no linear constraints in the problem.

(errno $8$)

On entry, $icolbj=⟨value⟩$ and $n=⟨value⟩$.

Constraint: $1\le icolbj\le n$.

(errno $8$)

On entry, $idlc=⟨value⟩$ and $m_B=⟨value⟩$.

Constraint: $1\le idlc\le m_B$.

Notes

After the model has been fully or partially built by calling functions of the NAG optimization modelling suite, handle_set_linconstr_coeff may be used to set or modify a single element $b_{\text{ij}}$ in the sparse linear constraint matrix $B$ previously defined by handle_set_linconstr(). This might be particularly helpful when a linear constraint needs to be extended after new variables have been added to the model by handle_add_vars().

See the E04 Introduction for more details about the NAG optimization modelling suite.

See also

naginterfaces.library.examples.opt.handle_add_vars_ex.main()