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

naginterfaces.library.opt.handle_set_linobj_coeff(handle, idxci, ci)

handle_set_linobj_coeff is a part of the NAG optimization modelling suite and sets or modifies a single element in the linear objective function of the problem.

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

https://support.nag.com/numeric/nl/nagdoc_30.3/flhtml/e04/e04tef.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.

idxciint

$i$, the index of the element $c_i$ in the linear objective function.

cifloat

$c_i$, the new value of the element in the linear objective function.

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$)

The objective function is not linear.

(errno $8$)

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

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

Notes

After the model has been fully or partially built by calling functions from the NAG optimization modelling suite, handle_set_linobj_coeff may be used to set or modify a single element $c_i$ in the (possibly sparse) linear objective function $c^{T}x$. This might be particularly helpful when the objective function 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()