naginterfaces.library.glopt.bnd_​mcs_​optset_​real

naginterfaces.library.glopt.bnd_mcs_optset_real(optstr, rvalue, comm, io_manager=None)

bnd_mcs_optset_real may be used to supply individual real options to bnd_mcs_solve(). The initialization function bnd_mcs_init() must have been called before calling bnd_mcs_optset_real.

Deprecated since version 28.3.0.0: bnd_mcs_optset_real is deprecated. There is no suggested replacement for this routine.

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

https://support.nag.com/numeric/nl/nagdoc_30.3/flhtml/e05/e05jgf.html

Parameters

optstrstr

A string identifying a real-valued option (as described in Other Parameters for bnd_mcs_solve).

rvaluefloat

The value associated with the option in $optstr$.

commdict, communication object, modified in place

Communication structure.

This argument must have been initialized by a prior call to bnd_mcs_init().

io_managerFileObjManager, optional

Manager for I/O in this routine.

Raises

NagValueError

(errno $1$)

Initialization function bnd_mcs_init() has not been called.

(errno $2$)

The supplied option is invalid. A keyword or keyword combination was not recognized.

(errno $3$)

Attempt to assign an out-of-bounds value of ‘Infinite Bound Size’ ($\text{infbnd}$): $\text{infbnd}=⟨value⟩$.

(errno $3$)

Attempt to assign too small a value of ‘Target Objective Error’ ($\text{objerr}$): $\text{objerr}=⟨value⟩$.

(errno $3$)

Attempt to assign too small a value of ‘Target Objective Safeguard’ ($\text{objsfg}$): $\text{objsfg}=⟨value⟩$.

(errno $3$)

Attempt to assign too small a value of ‘Local Searches Tolerance’ ($\text{loctol}$): $\text{loctol}=⟨value⟩$.

Notes

bnd_mcs_optset_real may be used to supply values for real options to bnd_mcs_solve(). It is only necessary to call bnd_mcs_optset_real for those arguments whose values are to be different from their default values. One call to bnd_mcs_optset_real sets one argument value.

Each real option is defined by a single character string in $optstr$ and the corresponding value in $rvalue$.

A complete list of options, their symbolic names and default values is given in Other Parameters for bnd_mcs_solve.