naginterfaces.library.mip.optset

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

optset either initializes or resets the option arrays or sets a single option for supported problem solving functions in submodule mip.

Currently, only sqp() is supported.

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

https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/h/h02zkf.html

Parameters

optstrstr

A string identifying the option to be set.

Initialize = $\text{function name}$

Initialize the option arrays $comm$[‘iopts’] and $comm$[‘opts’] for use with function $\text{function name}$, where $\text{function name}$ is the name associated with the function of interest.

Defaults

Resets all options to their default values.

$\text{option}=\text{optval}$

See Other Parameters for sqp for details of valid values for $\text{option}$ and $\text{optval}$. The equals sign ($=$) delimiter must be used to separate the $\text{option}$ from its $\text{optval}$ value.

$optstr$ is case insensitive.

Each token in the $\text{option}$ and $\text{optval}$ component must be separated by at least one space.

commdict, communication object, modified in place

Communication structure.

On initial entry: need not be set.

Raises

NagValueError

(errno $11$)

On entry, the option in $optstr$ was not recognized: $optstr=⟨value⟩$.

(errno $12$)

On entry, the expected delimiter ‘$=$’ was not found in $optstr$: $optstr=⟨value⟩$.

(errno $13$)

On entry, could not convert the specified $\text{optval}$ to an integer: $optstr=⟨value⟩$.

(errno $13$)

On entry, could not convert the specified $\text{optval}$ to a real: $optstr=⟨value⟩$.

(errno $14$)

On entry, attempting to initialize the option arrays but specified function name was not valid: $\text{name}=⟨value⟩$.

(errno $15$)

On entry, the $\text{optval}$ supplied for the integer option is not valid.

$optstr=⟨value⟩$.

(errno $16$)

On entry, the $\text{optval}$ supplied for the real option is not valid.

$optstr=⟨value⟩$.

(errno $17$)

On entry, the $\text{optval}$ supplied for the character option is not valid.

$optstr=⟨value⟩$.

(errno $21$)

On entry, either the option arrays have not been initialized or they have been corrupted.

Notes

optset has three purposes: to initialize option arrays; to reset all options to their default values; or to set a single option to a user-supplied value.

Options and their values are, in general, presented as a character string, $optstr$, of the form ‘$\text{option}=\text{optval}$’; alphabetic characters can be supplied in either upper or lower case. Both $\text{option}$ and $\text{optval}$ may consist of one or more tokens separated by white space. The tokens that comprise $\text{optval}$ will normally be either an integer, real or character value as defined in the description of the specific optional argument. In addition all options can take an $\text{optval}$ DEFAULT which resets the option to its default value.

It is imperative that option arrays are initialized before any options are set, before the relevant problem solving function is called and before any options are queried using optget().

Information relating to available option names and their corresponding valid values is given in Other Parameters for sqp.

See also

naginterfaces.library.examples.mip.sqp_ex.main()