nag_opt_nlp2_option_double_set (e04wh) may be used to supply individual double optional parameters to nag_opt_nlp2_solve (e04wd). The initialization function nag_opt_nlp2_init (e04wc) must have been called before calling nag_opt_nlp2_option_double_set (e04wh).

Syntax

[iw, rw, ifail] = e04wh(string, rvalue, iw, rw)

[iw, rw, ifail] = nag_opt_nlp2_option_double_set(string, rvalue, iw, rw)

Description

nag_opt_nlp2_option_double_set (e04wh) may be used to supply values for double optional parameters to nag_opt_nlp2_solve (e04wd). It is only necessary to call nag_opt_nlp2_option_double_set (e04wh) for those arguments whose values are to be different from their default values. One call to nag_opt_nlp2_option_double_set (e04wh) sets one argument value.

Each double optional parameter is defined by a single character string in string and the corresponding value in rvalue. For example the following illustrates how the

L U

stability tolerance could be defined:

factol = 100.0
if (illcon)
  factol = 5.0;
end
[iw, rw, ifail] = e04wh('LU Factor Tolerance', factol, iw, rw);

Optional parameter settings are preserved following a call to nag_opt_nlp2_solve (e04wd) and so the keyword Defaults is provided to allow you to reset all the optional parameters to their default values before a subsequent call to nag_opt_nlp2_solve (e04wd).

A complete list of optional parameters, their abbreviations, synonyms and default values is given in Optional Parameters in nag_opt_nlp2_solve (e04wd).

References

None.

Parameters

Compulsory Input Parameters

1: $string$ – string: A single valid keyword of a double optional parameter (as described in Optional Parameters in nag_opt_nlp2_solve (e04wd)).
2: $rvalue$ – double scalar: The value associated with the keyword in string.
3: $iw (:)$ – int64int32nag_int array: The dimension of the array iw must be at least $leniw$ (see nag_opt_nlp2_init (e04wc))
4: $rw (:)$ – double array: The dimension of the array rw must be at least $lenrw$ (see nag_opt_nlp2_init (e04wc))

Optional Input Parameters

None.

Output Parameters

1: $iw (:)$ – int64int32nag_int array: The dimension of the array iw will be $leniw$ (see nag_opt_nlp2_init (e04wc))
2: $rw (:)$ – double array: The dimension of the array rw will be $lenrw$ (see nag_opt_nlp2_init (e04wc))
3: $ifail$ – int64int32nag_int scalar: $ifail = 0$ unless the function detects an error (see Error Indicators and Warnings).

Error Indicators and Warnings

Errors or warnings detected by the function:

$ifail = 1$: The initialization function nag_opt_nlp2_init (e04wc) has not been called.

$ifail = 2$: The supplied option is invalid. Check that the keywords are neither ambiguous nor misspelt.

$ifail = - 99$: An unexpected error has been triggered by this routine. Please contact NAG.

$ifail = - 399$: Your licence key may have expired or may not have been installed correctly.

$ifail = - 999$: Dynamic memory allocation failed.

Accuracy

Not applicable.

Further Comments

nag_opt_nlp2_option_string (e04wf) may also be used to supply double optional parameters to nag_opt_nlp2_solve (e04wd).

Example

Open in the MATLAB editor: e04wh_example

function e04wh_example


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

string = 'Infinite bound size';
infbd = 1d10;

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

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

e04wh example results

Infinite bound size has been set to   1.00e+10

PDF version (NAG web site, 64-bit version, 64-bit version)

Chapter Contents

Chapter Introduction

NAG Toolbox