NAG Toolbox: nag_opt_nlp2_sparse_option_double_get (e04vs)

Purpose

Syntax

Description

[featol, cw, iw, rw, ifail] = e04vr('Feasibility Tolerance', cw, iw, rw);

References

Parameters

Compulsory Input Parameters

1:     $\mathrm{string}$ – string

A single valid keyword of a double optional parameter (as described in Optional Parameters in nag_opt_nlp2_sparse_solve (e04vh)).

2:     $\mathrm{cw}\left(:\right)$ – cell array of strings

The dimension of the array cw must be at least $\mathbf{lencw}$ (see nag_opt_nlp2_sparse_init (e04vg))

3:     $\mathrm{iw}\left(:\right)$ – int64int32nag_int array

The dimension of the array iw must be at least $\mathbf{leniw}$ (see nag_opt_nlp2_sparse_init (e04vg))

4:     $\mathrm{rw}\left(:\right)$ – double array

The dimension of the array rw must be at least $\mathbf{lenrw}$ (see nag_opt_nlp2_sparse_init (e04vg))

Optional Input Parameters

None.

Output Parameters

1:     $\mathrm{rvalue}$ – double scalar

The double value associated with the keyword in string.

2:     $\mathrm{cw}\left(:\right)$ – cell array of strings

The dimension of the array cw will be $\mathbf{lencw}$ (see nag_opt_nlp2_sparse_init (e04vg))

3:     $\mathrm{iw}\left(:\right)$ – int64int32nag_int array

The dimension of the array iw will be $\mathbf{leniw}$ (see nag_opt_nlp2_sparse_init (e04vg))

4:     $\mathrm{rw}\left(:\right)$ – double array

The dimension of the array rw will be $\mathbf{lenrw}$ (see nag_opt_nlp2_sparse_init (e04vg))

5:     $\mathrm{ifail}$ – int64int32nag_int scalar

$\mathbf{ifail}=\mathbf{0}$ unless the function detects an error (see Error Indicators and Warnings).

Error Indicators and Warnings

   $\mathbf{ifail}=1$

The initialization function nag_opt_nlp2_sparse_init (e04vg) has not been called.

   $\mathbf{ifail}=2$

The supplied option is invalid. Check that the keywords are neither ambiguous nor misspelt.

   $\mathbf{ifail}=-99$

An unexpected error has been triggered by this routine. Please contact NAG.

   $\mathbf{ifail}=-399$

Your licence key may have expired or may not have been installed correctly.

   $\mathbf{ifail}=-999$

Dynamic memory allocation failed.

Accuracy

Further Comments

Example

Open in the MATLAB editor: e04vs_example

function e04vs_example


fprintf('e04vs example results\n\n');

featol = 1e-6;
string = 'Feasibility Tolerance';

% Initialize
[cw, iw, rw, ifail] = e04vg;

% Set option
[cw, iw, rw, ifail] = e04vn( ...
                             string, featol, cw, iw, rw);
% Get option
[rvalue, cw, iw, rw, ifail] = e04vs( ...
                                     string, cw, iw, rw);

fprintf('%s has been set to %10.2e\n', string, rvalue);

e04vs example results

Feasibility Tolerance has been set to   1.00e-06