naginterfaces.library.mip.iqp_​sparse_​optstr

naginterfaces.library.mip.iqp_sparse_optstr(optstr, comm, io_manager=None)[source]

iqp_sparse_optstr may be used to supply individual options to iqp_sparse().

For full information please refer to the NAG Library document for h02cg

https://support.nag.com/numeric/nl/nagdoc_30.3/flhtml/h/h02cgf.html

Parameters
optstrstr

A single valid option string (as described in Notes above and in Other Parameters for iqp_sparse).

commdict, communication object, modified in place

Communication structure.

This argument must have been initialized by a prior call to opt.nlp1_init with .

io_managerFileObjManager, optional

Manager for I/O in this routine.

Raises
NagValueError
(errno )

The supplied option string is invalid. Supplied value was: .

Notes

No equivalent traditional C interface for this routine exists in the NAG Library.

iqp_sparse_optstr may be used to supply values for options to iqp_sparse(). It is only necessary to call iqp_sparse_optstr for those arguments whose values are to be different from their default values. One call to iqp_sparse_optstr 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 equal 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 77’s I, F, E or D formats, terminated by a space if this is not the last item on the line.

Blank strings and comments are ignored. A comment begins with an asterisk (*) and all subsequent characters in the string are regarded as part of the comment.

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 iqp_sparse(), and so the keyword ‘Defaults’ is provided to allow you to reset all the options to their default values.

A complete list of options, their abbreviations, synonyms and default values is given in Other Parameters for iqp_sparse.