NAG Toolbox: nag_opt_qpconvex2_sparse_option_double_get (e04ny)

Purpose

Syntax

Description

[featol, cw, iw, rw, ifail] = e04ny('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_qpconvex2_sparse_solve (e04nq)).

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

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

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

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

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

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

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_qpconvex2_sparse_init (e04np))

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

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

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

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

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_qpconvex2_sparse_init (e04np) 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: e04ny_example

function e04ny_example


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

string = 'Feasibility tolerance';
featol = 0.0001;

% Initialize
[cw, iw, rw, ifail] = e04np;
%Set option
[cw, iw, rw, ifail] = e04nu( ...
                             string, featol, cw, iw, rw);
% Get option
[rvalue, cw, iw, rw, ifail] = e04ny( ...
                                     string, cw, iw, rw);

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

e04ny example results

Feasibility tolerance has been set to  1.00000e-04