nag_opt_init (e04xxc) is the options structure initialization function for
Chapter e04. This function or
nag_opt_read (e04xyc) must be called before using the options structure.
The optimization functions of
Chapter e04 have a number of optional parameters, which are set by means of a structure of type Nag_E04_Opt. Optional parameter values may be assigned to members of an options structure directly in the program text and/or by supplying the optional values in a file which can be read by the function
nag_opt_read (e04xyc).
If optional parameter values are assigned directly in the program text and no use is made of
nag_opt_read (e04xyc), then nag_opt_init (e04xxc)
must be called before any assignments are made to the options structure. Initialization is still required even if no assignments are made to the structure before it is passed to the optimization function.
If the file reading function
nag_opt_read (e04xyc) is used then this will automatically initialize the options structure if this has not already been done. Any direct assignment to the options structure made
after a call to
nag_opt_read (e04xyc) must
not be preceded by a call to nag_opt_init (e04xxc) otherwise the values set by
nag_opt_read (e04xyc) will be lost. Direct assignments to the options structure made
before calling
nag_opt_read (e04xyc) must, of course, still be preceded by a call to nag_opt_init (e04xxc).
The purpose of nag_opt_init (e04xxc) is to initialize the options structure members with null values which indicate to the optimization function that the optional parameter that a structure member represents is not to be changed from its default value.
None.
None.
Not applicable.
nag_opt_init (e04xxc) is not threaded in any implementation.
None.