naginterfaces.library.fit.opt_​set

naginterfaces.library.fit.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 fit. Currently, only dim2_spline_ts_sctr() is supported.

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

https://support.nag.com/numeric/nl/nagdoc_30/flhtml/e02/e02zkf.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 of the problem solving function you wish to use.

Defaults

Resets all options to their default values.

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

See Other Parameters for dim2_spline_ts_sctr 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}$.

The processing of $optstr$ does not depend on its case.

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

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

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

See also

naginterfaces.library.examples.fit.dim2_spline_ts_sctr_ex.main()