naginterfaces.library.mip.optget

naginterfaces.library.mip.optget(optstr, comm)

optget is used to query the value of options available to supported problem solving functions in submodule mip.

Currently, only sqp() is supported.

Deprecated since version 30.3.0.0: optget is deprecated. There is no suggested replacement for this routine.

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

https://support.nag.com/numeric/nl/nagdoc_30.3/flhtml/h/h02zlf.html

Parameters

optstrstr

A string identifying the option whose current value is required. See Other Parameters for sqp for information on valid options. In addition, the following is a valid option:

Identify

optget returns the function name supplied to optset() when the option arrays $comm$[‘iopts’] and $comm$[‘opts’] were initialized.

commdict, communication object

Communication structure.

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

Returns

optvaluedict

The option-value dict, with the following keys:

'value'float, int or str

The value of the requested option.

'annotation'None or str

Possible additional information about the option value.

Raises

NagValueError

(errno $11$)

On entry, the $\text{option}$ in $optstr$ has not been recognized.

(errno $61$)

The arrays $comm$[‘iopts’] and $comm$[‘opts’] have either not been initialized, have become corrupted, or are not compatible with this option setting function.

Warns

NagAlgorithmicWarning

(errno $41$)

On entry, $optstr$ indicates a character option, but $\text{cvalue}$ is too short to hold the stored value. The returned value will be truncated.

Notes

optget is used to query the current values of options. It is necessary to initialize option arrays using optset() before any options are queried.

Information on option names and whether these options are real, integer or character can be found in Other Parameters for sqp.