nag_opt_sparse_nlp_option_set_string (e04vlc) may be used to supply individual optional parameters to
nag_opt_sparse_nlp_solve (e04vhc). The initialization function
nag_opt_sparse_nlp_init (e04vgc) must have been called before calling
nag_opt_sparse_nlp_option_set_string (e04vlc).
nag_opt_sparse_nlp_option_set_string (e04vlc) may be used to supply values for optional parameters to
nag_opt_sparse_nlp_solve (e04vhc). It is only necessary to call
nag_opt_sparse_nlp_option_set_string (e04vlc) for those arguments whose values are to be different from their default values. One call to
nag_opt_sparse_nlp_option_set_string (e04vlc) sets one argument value.
Each optional parameter is defined by a single character string,
consisting of one or more items. The items associated with a given option must be separated by spaces, or equals signs
. Alphabetic characters may be upper or lower case. The string
Print Level = 1
is an example of a string used to set an optional parameter. For each option the string contains one or more of the following items:
| – |
a mandatory keyword; |
| – |
a phrase that qualifies the keyword; |
| – |
a number that specifies an Integer or double value. Such numbers may be up to contiguous characters
which can be read using C's d or g formats, terminated by a space if this is not the last item on the line. |
For
nag_opt_sparse_nlp_option_set_string (e04vlc), each user-specified option is not normally printed as it is defined, but this printing may be turned on using the keyword
. Thus the statement
e04vlc ("List", &state, &fail);
turns on printing of this and subsequent options. Printing may be turned off again using the keyword
.
Optional parameter settings are preserved following a call to
nag_opt_sparse_nlp_solve (e04vhc) and so the keyword
is provided to allow you to reset all the optional parameters to their default values before a subsequent call to
nag_opt_sparse_nlp_solve (e04vhc).
A complete list of optional parameters, their abbreviations, synonyms and default values is given in
Section 12 in
nag_opt_sparse_nlp_solve (e04vhc).
None.
Not applicable.