Navigation

Operators and Keywords

Function List:

C++ API

: x = cgs (A, b, rtol, maxit, M1, M2, x0)
: x = cgs (A, b, rtol, maxit, P)
: [x, flag, relres, iter, resvec] = cgs (A, b, …)

Solve A x = b, where A is a square matrix, using the Conjugate Gradients Squared method.

  • - rtol is the relative tolerance, if not given or set to [] the default value 1e-6 is used.
  • - maxit the maximum number of outer iterations, if not given or set to [] the default value min (20, numel (b)) is used.
  • - x0 the initial guess, if not given or set to [] the default value zeros (size (b)) is used.

A can be passed as a matrix or as a function handle or inline function f such that f(x) = A*x.

The preconditioner P is given as P = M1 * M2. Both M1 and M2 can be passed as a matrix or as a function handle or inline function g such that g(x) = M1 \ x or g(x) = M2 \ x.

If called with more than one output parameter

  • - flag indicates the exit status:
    • - 0: iteration converged to the within the chosen tolerance
    • - 1: the maximum number of iterations was reached before convergence
    • - 3: the algorithm reached stagnation

    (the value 2 is unused but skipped for compatibility).

  • - relres is the final value of the relative residual.
  • - iter is the number of iterations performed.
  • - resvec is a vector containing the relative residual at each iteration.

See also: pcg, bicgstab, bicg, gmres, qmr.

Demonstration 1

The following code

 % Solve system of A*x=b
 A = [5 -1 3;-1 2 -2;3 -2 3];
 b = [7;-1;4];
 [a,b,c,d,e] = cgs (A,b)

Produces the following output

a =

   1.00000
   1.00000
   1.00000

b = 0
c =    1.2529e-14
d =  3
e =

   1.0000e+00
   1.9178e-01
   7.2378e-03
   1.2529e-14

Package: octave