naginterfaces.library.opt.handle_​add_​vars

naginterfaces.library.opt.handle_add_vars(handle, nadd)

handle_add_vars is a part of the NAG optimization modelling suite and adds new variables to the problem.

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

https://www.nag.com/numeric/nl/nagdoc_29.3/flhtml/e04/e04taf.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.

naddint

$n_{\text{add}}$, the number of decision variables to add to the problem.

Returns

nvarint

$n$, the new total number of the variables in the problem.

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

On entry, $nadd=⟨value⟩$.

Constraint: $nadd>0$.

Notes

After the $handle$ has been initialized (e.g., handle_init() has been called), handle_add_vars may be used to define $n_{\text{add}}$ new unconstrained continuous variables to the problem. If $n_{\text{now}}$ denotes the current number of variables in the model, the total number of variables will be $n=n_{\text{now}}+n_{\text{add}}$ and the new variables will be indexed by $n_{\text{now}}+1,\dots ,n_{\text{now}}+n_{\text{add}}$. The objective function or constraints, if already defined in the model, won’t be affected as they will be naturally extended as if the new variables were not referred during their definition (e.g., for a linear objective function the coefficients for the new variables would be set to zero). If the new variables should enter any already defined parts of the problem, you should modify them with the appropriate functions from the suite.

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

See also

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