complex_gen_basic_diagis the third in a suite of three functions for the iterative solution of a complex general (non-Hermitian) system of simultaneous linear equations (see Golub and Van Loan (1996)).
complex_gen_basic_diagreturns information about the computations during an iteration and/or after this has been completed. The first function of the suite,
complex_gen_basic_setup(), is a setup function; the second function,
complex_gen_basic_solver(), is the iterative solver itself.
These three functions are suitable for the solution of large sparse general (non-Hermitian) systems of equations.
For full information please refer to the NAG Library document for f11bt
- commdict, communication object, modified in place
This argument must have been initialized by a prior call to
The number of iterations carried out by
The current value of the left-hand side of the termination criterion used by
The current value of the right-hand side of the termination criterion used by
If in the previous call to
complex_gen_basic_setup(), the current estimate of the largest singular value of the preconditioned iteration matrix when it is used by the termination criterion in
complex_gen_basic_solver(), either when it has been supplied to
complex_gen_basic_setup()or it has been estimated by
complex_gen_basic_solver()(see also Notes for complex_gen_basic_setup and Parameters for complex_gen_basic_setup); otherwise, is returned.
- (errno )
complex_gen_basic_diaghas been called out of sequence.
complex_gen_basic_diagreturns information about the solution process. It can be called either during a monitoring step of
complex_gen_basic_solver()has completed its tasks. Calling
complex_gen_basic_diagat any other time will result in an error condition being raised.
Golub, G H and Van Loan, C F, 1996, Matrix Computations, (3rd Edition), Johns Hopkins University Press, Baltimore