NAG Toolbox: nag_opt_nlp2_option_double_get (e04wl)

Purpose

Syntax

Description

[factol, iw, rw, ifail] = e04wl('LU Factor Tolerance', 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_solve (e04wd)).

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

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

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

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

Optional Input Parameters

None.

Output Parameters

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

The double value associated with the keyword in string.

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

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

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

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

4:     $\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_init (e04wc) 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: e04wl_example

function e04wl_example


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

string = 'LU Factor Tolerance';
factol = 1e-3;

% Initialize
[iw, rw, ifail] = e04wc;
% Set option
[iw, rw, ifail] = e04wh( ...
                         string, factol, iw, rw);
% Get option value
[rvalue, iw, rw, ifail] = e04wl( ...
                                 string, iw, rw);

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

e04wl example results

LU Factor Tolerance has been set to   1.00e-03