naginterfaces.library.quad.opt_​set

naginterfaces.library.quad.opt_set(optstr, comm)

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

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

https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/d01/d01zkf.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 md_sgq_multi_vec and Other Parameters for dim1_gen_vec_multi_rcomm 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 $14$)

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

(errno $21$)

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

Warns

NagAlgorithmicWarning

(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 $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⟩$.

Notes

opt_set 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 opt_get().

The available option names and their corresponding valid values are given in Other Parameters for md_sgq_multi_vec and Other Parameters for dim1_gen_vec_multi_rcomm.