naginterfaces.library.opt.qpconvex2_sparse_option_string¶
- naginterfaces.library.opt.qpconvex2_sparse_option_string(string, comm, io_manager=None)[source]¶
qpconvex2_sparse_option_string
may be used to supply individual options toqpconvex2_sparse_solve()
. The initialization functionqpconvex2_sparse_init()
must have been called before callingqpconvex2_sparse_option_string
.For full information please refer to the NAG Library document for e04ns
https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/e04/e04nsf.html
- Parameters
- stringstr
A single valid option string (see Notes in
qpconvex2_sparse_option_string
and Other Parameters for qpconvex2_sparse_solve).- commdict, communication object, modified in place
Communication structure.
This argument must have been initialized by a prior call to
qpconvex2_sparse_init()
.- io_managerFileObjManager, optional
Manager for I/O in this routine.
- Raises
- NagValueError
- (errno )
The initialization function
qpconvex2_sparse_init()
has not been called.- (errno )
The supplied option is invalid. Check that the keywords are neither ambiguous nor misspelt. The option string is .
- Notes
qpconvex2_sparse_option_string
may be used to supply values for options toqpconvex2_sparse_solve()
. It is only necessary to callqpconvex2_sparse_option_string
for those arguments whose values are to be different from their default values. One call toqpconvex2_sparse_option_string
sets one argument value.Each option is defined by a single character string, of up to characters, 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 option. 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 int or float value. Such numbers may be up to contiguous characters in Fortran’s I, F, E or D formats, terminated by a space if this is not the last item on the line.
Printing of user-specified options is turned off by default. It may be turned on at any time using the keyword ‘List’.
Option settings are preserved following a call to
qpconvex2_sparse_solve()
and so the keyword ‘Defaults’ is provided to allow you to reset all the options to their default values before a subsequent call toqpconvex2_sparse_solve()
.A complete list of options, their abbreviations, synonyms and default values is given in Other Parameters for qpconvex2_sparse_solve.