Mercurial > octave-antonio
annotate scripts/sparse/bicgstab.m @ 14609:3edba8b5f430
doc: Remove unnecessary blank line after start of Texinfo section.
* bicg.m, bicgstab.m, cgs.m: Remove blank line after Texinfo start.
author | Rik <octave@nomad.inbox5.com> |
---|---|
date | Tue, 08 May 2012 18:02:24 -0700 |
parents | f3d52523cde1 |
children | 72b8b39e12be |
rev | line source |
---|---|
14138
72c96de7a403
maint: update copyright notices for 2012
John W. Eaton <jwe@octave.org>
parents:
13929
diff
changeset
|
1 ## Copyright (C) 2008-2012 Radek Salac |
72c96de7a403
maint: update copyright notices for 2012
John W. Eaton <jwe@octave.org>
parents:
13929
diff
changeset
|
2 ## Copyright (C) 2012 Carlo de Falco |
8416 | 3 ## |
4 ## This file is part of Octave. | |
5 ## | |
6 ## Octave is free software; you can redistribute it and/or modify it | |
7 ## under the terms of the GNU General Public License as published by | |
8 ## the Free Software Foundation; either version 3 of the License, or (at | |
9 ## your option) any later version. | |
10 ## | |
11 ## Octave is distributed in the hope that it will be useful, but | |
12 ## WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
14 ## General Public License for more details. | |
15 ## | |
16 ## You should have received a copy of the GNU General Public License | |
17 ## along with Octave; see the file COPYING. If not, see | |
18 ## <http://www.gnu.org/licenses/>. | |
19 | |
20 ## -*- texinfo -*- | |
13929
9cae456085c2
Grammarcheck of documentation before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents:
13837
diff
changeset
|
21 ## @deftypefn {Function File} {@var{x} =} bicgstab (@var{A}, @var{b}, @var{rtol}, @var{maxit}, @var{M1}, @var{M2}, @var{x0}) |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
22 ## @deftypefnx {Function File} {@var{x} =} bicgstab (@var{A}, @var{b}, @var{rtol}, @var{maxit}, @var{P}) |
13929
9cae456085c2
Grammarcheck of documentation before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents:
13837
diff
changeset
|
23 ## @deftypefnx {Function File} {[@var{x}, @var{flag}, @var{relres}, @var{iter}, @var{resvec}] =} bicgstab (@var{A}, @var{b}, @dots{}) |
9cae456085c2
Grammarcheck of documentation before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents:
13837
diff
changeset
|
24 ## Solve @code{A x = b} using the stabilizied Bi-conjugate gradient iterative |
9cae456085c2
Grammarcheck of documentation before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents:
13837
diff
changeset
|
25 ## method. |
13070
a0d854f079d2
codesprint: Fix building of docs for new bicg functions
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents:
13061
diff
changeset
|
26 ## |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
27 ## @itemize @minus |
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
28 ## @item @var{rtol} is the relative tolerance, if not given or set to |
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
29 ## [] the default value 1e-6 is used. |
13929
9cae456085c2
Grammarcheck of documentation before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents:
13837
diff
changeset
|
30 ## |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
31 ## @item @var{maxit} the maximum number of outer iterations, if not |
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
32 ## given or set to [] the default value @code{min (20, numel (b))} is |
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
33 ## used. |
13929
9cae456085c2
Grammarcheck of documentation before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents:
13837
diff
changeset
|
34 ## |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
35 ## @item @var{x0} the initial guess, if not given or set to [] the |
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
36 ## default value @code{zeros (size (b))} is used. |
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
37 ## @end itemize |
13070
a0d854f079d2
codesprint: Fix building of docs for new bicg functions
Jordi Gutiérrez Hermoso <jordigh@gmail.com>
parents:
13061
diff
changeset
|
38 ## |
13141
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
39 ## @var{A} can be passed as a matrix or as a function handle or |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
40 ## inline function @code{f} such that @code{f(x) = A*x}. |
8416 | 41 ## |
13141
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
42 ## The preconditioner @var{P} is given as @code{P = M1 * M2}. |
13929
9cae456085c2
Grammarcheck of documentation before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents:
13837
diff
changeset
|
43 ## Both @var{M1} and @var{M2} can be passed as a matrix or as a function |
9cae456085c2
Grammarcheck of documentation before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents:
13837
diff
changeset
|
44 ## handle or inline function @code{g} such that @code{g(x) = M1 \ x} or |
9cae456085c2
Grammarcheck of documentation before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents:
13837
diff
changeset
|
45 ## @code{g(x) = M2 \ x}. |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
46 ## |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
47 ## If called with more than one output parameter |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
48 ## |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
49 ## @itemize @minus |
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
50 ## @item @var{flag} indicates the exit status: |
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
51 ## @itemize @minus |
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
52 ## @item 0: iteration converged to the within the chosen tolerance |
13929
9cae456085c2
Grammarcheck of documentation before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents:
13837
diff
changeset
|
53 ## |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
54 ## @item 1: the maximum number of iterations was reached before convergence |
13929
9cae456085c2
Grammarcheck of documentation before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents:
13837
diff
changeset
|
55 ## |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
56 ## @item 3: the algorithm reached stagnation |
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
57 ## @end itemize |
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
58 ## (the value 2 is unused but skipped for compatibility). |
13929
9cae456085c2
Grammarcheck of documentation before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents:
13837
diff
changeset
|
59 ## |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
60 ## @item @var{relres} is the final value of the relative residual. |
13929
9cae456085c2
Grammarcheck of documentation before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents:
13837
diff
changeset
|
61 ## |
13141
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
62 ## @item @var{iter} is the number of iterations performed. |
13929
9cae456085c2
Grammarcheck of documentation before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents:
13837
diff
changeset
|
63 ## |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
64 ## @item @var{resvec} is a vector containing the relative residual at each iteration. |
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
65 ## @end itemize |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
66 ## |
13929
9cae456085c2
Grammarcheck of documentation before 3.6.0 release.
Rik <octave@nomad.inbox5.com>
parents:
13837
diff
changeset
|
67 ## @seealso{bicg, cgs, gmres, pcg} |
8416 | 68 ## |
69 ## @end deftypefn | |
70 | |
13141
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
71 function [x, flag, relres, iter, resvec] = bicgstab (A, b, tol, maxit, |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
72 M1, M2, x0) |
8416 | 73 |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
74 if (nargin >= 2 && nargin <= 7 && isvector (full (b))) |
13141
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
75 |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
76 if (ischar (A)) |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
77 A = str2func (A); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
78 elseif (ismatrix (A)) |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
79 Ax = @(x) A * x; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
80 elseif (isa (A, "function_handle")) |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
81 Ax = @(x) feval (A, x); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
82 else |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
83 error (["bicgstab: first argument is expected " ... |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
84 "to be a function or a square matrix"]); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
85 endif |
13141
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
86 |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
87 if (nargin < 3 || isempty (tol)) |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
88 tol = 1e-6; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
89 endif |
8416 | 90 |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
91 if (nargin < 4 || isempty (maxit)) |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
92 maxit = min (rows (b), 20); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
93 endif |
8416 | 94 |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
95 if (nargin < 5 || isempty (M1)) |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
96 M1m1x = @(x) x; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
97 elseif (ischar (M1)) |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
98 M1m1x = str2func (M1); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
99 elseif (ismatrix (M1)) |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
100 M1m1x = @(x) M1 \ x; |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
101 elseif (isa (M1, "function_handle")) |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
102 M1m1x = @(x) feval (M1, x); |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
103 else |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
104 error (["bicgstab: preconditioner is " ... |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
105 "expected to be a function or matrix"]); |
9279
1673a0dc019f
fix & improve preconditioning strategy in cgs & bicgstab
Jaroslav Hajek <highegg@gmail.com>
parents:
9278
diff
changeset
|
106 endif |
13141
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
107 |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
108 if (nargin < 6 || isempty (M2)) |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
109 M2m1x = @(x) x; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
110 elseif (ischar (M2)) |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
111 M2m1x = str2func (M2); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
112 elseif (ismatrix (M2)) |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
113 M2m1x = @(x) M2 \ x; |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
114 elseif (isa (M2, "function_handle")) |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
115 M2m1x = @(x) feval (M2, x); |
8416 | 116 else |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
117 error (["bicgstab: preconditioner is "... |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
118 "expected to be a function or matrix"]); |
9279
1673a0dc019f
fix & improve preconditioning strategy in cgs & bicgstab
Jaroslav Hajek <highegg@gmail.com>
parents:
9278
diff
changeset
|
119 endif |
8416 | 120 |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
121 precon = @(x) M2m1x (M1m1x (x)); |
8416 | 122 |
13091
e5aaba072d2b
maint: style fixes in iterative linear solvers
Carlo de Falco <kingcrimson@tiscali.it>
parents:
13070
diff
changeset
|
123 if (nargin < 7 || isempty (x0)) |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
124 x0 = zeros (size (b)); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
125 endif |
13141
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
126 |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
127 ## specifies initial estimate x0 |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
128 if (nargin < 7) |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
129 x = zeros (rows (b), 1); |
8416 | 130 else |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
131 x = x0; |
8416 | 132 endif |
133 | |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
134 norm_b = norm (b); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
135 |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
136 res = b - Ax (x); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
137 rr = res; |
8416 | 138 |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
139 ## Vector of the residual norms for each iteration. |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
140 resvec = norm(res) / norm_b; |
8416 | 141 |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
142 ## Default behaviour we don't reach tolerance tol within maxit iterations. |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
143 flag = 1; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
144 |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
145 for iter = 1:maxit |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
146 rho_1 = res' * rr; |
8416 | 147 |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
148 if (iter == 1) |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
149 p = res; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
150 else |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
151 beta = (rho_1 / rho_2) * (alpha / omega); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
152 p = res + beta * (p - omega * v); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
153 endif |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
154 |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
155 phat = precon (p); |
8416 | 156 |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
157 v = Ax (phat); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
158 alpha = rho_1 / (rr' * v); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
159 s = res - alpha * v; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
160 |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
161 shat = precon (s); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
162 |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
163 t = Ax (shat); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
164 omega = (t' * s) / (t' * t); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
165 x = x + alpha * phat + omega * shat; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
166 res = s - omega * t; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
167 rho_2 = rho_1; |
8416 | 168 |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
169 relres = norm (res) / norm_b; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
170 resvec = [resvec; relres]; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
171 |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
172 if (relres <= tol) |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
173 ## We reach tolerance tol within maxit iterations. |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
174 flag = 0; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
175 break; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
176 elseif (resvec(end) == resvec(end - 1)) |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
177 ## The method stagnates. |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
178 flag = 3; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
179 break; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
180 endif |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
181 endfor |
8416 | 182 |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
183 if (nargout < 2) |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
184 if (flag == 0) |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
185 printf ("bicgstab converged at iteration %i ", iter); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
186 printf ("to a solution with relative residual %e\n", relres); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
187 elseif (flag == 3) |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
188 printf ("bicgstab stopped at iteration %i ", iter); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
189 printf ("without converging to the desired tolerance %e\n", tol); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
190 printf ("because the method stagnated.\n"); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
191 printf ("The iterate returned (number %i) ", iter); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
192 printf ("has relative residual %e\n", relres); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
193 else |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
194 printf ("bicgstab stopped at iteration %i ", iter); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
195 printf ("without converging to the desired toleranc %e\n", tol); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
196 printf ("because the maximum number of iterations was reached.\n"); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
197 printf ("The iterate returned (number %i) ", iter); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
198 printf ("has relative residual %e\n", relres); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
199 endif |
9278 | 200 endif |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
201 |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
202 else |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
203 print_usage (); |
9278 | 204 endif |
205 | |
8416 | 206 endfunction |
207 | |
14237
11949c9795a0
Revamp %!demos in m-files to use Octave coding conventions on spacing, etc.
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
208 |
8416 | 209 %!demo |
210 %! % Solve system of A*x=b | |
14237
11949c9795a0
Revamp %!demos in m-files to use Octave coding conventions on spacing, etc.
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
211 %! A = [5 -1 3;-1 2 -2;3 -2 3]; |
11949c9795a0
Revamp %!demos in m-files to use Octave coding conventions on spacing, etc.
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
212 %! b = [7;-1;4]; |
11949c9795a0
Revamp %!demos in m-files to use Octave coding conventions on spacing, etc.
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
213 %! [x, flag, relres, iter, resvec] = bicgstab (A, b) |
8416 | 214 |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
215 %!shared A, b, n, M1, M2 |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
216 %! |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
217 %!test |
13141
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
218 %! n = 100; |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
219 %! A = spdiags ([-2*ones(n,1) 4*ones(n,1) -ones(n,1)], -1:1, n, n); |
13141
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
220 %! b = sum (A, 2); |
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
221 %! tol = 1e-8; |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
222 %! maxit = 15; |
13141
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
223 %! M1 = spdiags ([ones(n,1)/(-2) ones(n,1)],-1:0, n, n); |
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
224 %! M2 = spdiags ([4*ones(n,1) -ones(n,1)], 0:1, n, n); |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
225 %! [x, flag, relres, iter, resvec] = bicgstab (A, b, tol, maxit, M1, M2); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
226 %! assert (x, ones (size (b)), 1e-7); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
227 %! |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
228 %!test |
13837
2c80bbd87f5d
don't define functions in test and demo blocks
John W. Eaton <jwe@octave.org>
parents:
13141
diff
changeset
|
229 %!function y = afun (x, a) |
2c80bbd87f5d
don't define functions in test and demo blocks
John W. Eaton <jwe@octave.org>
parents:
13141
diff
changeset
|
230 %! y = a * x; |
2c80bbd87f5d
don't define functions in test and demo blocks
John W. Eaton <jwe@octave.org>
parents:
13141
diff
changeset
|
231 %!endfunction |
2c80bbd87f5d
don't define functions in test and demo blocks
John W. Eaton <jwe@octave.org>
parents:
13141
diff
changeset
|
232 %! |
13141
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
233 %! tol = 1e-8; |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
234 %! maxit = 15; |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
235 %! |
13141
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
236 %! [x, flag, relres, iter, resvec] = bicgstab (@(x) afun (x, A), b, |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
237 %! tol, maxit, M1, M2); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
238 %! assert (x, ones (size (b)), 1e-7); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
239 |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
240 %!test |
13141
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
241 %! n = 100; |
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
242 %! tol = 1e-8; |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
243 %! a = sprand (n, n, .1); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
244 %! A = a'*a + 100 * eye (n); |
13141
e81ddf9cacd5
maint: untabify and remove trailing whitespace from source files
John W. Eaton <jwe@octave.org>
parents:
13091
diff
changeset
|
245 %! b = sum (A, 2); |
13061
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
246 %! [x, flag, relres, iter, resvec] = bicgstab (A, b, tol, [], diag (diag (A))); |
addfc0ae69c0
Make bicgstab interface more compatible
Carlo de Falco <kingcrimson@tiscali.it>
parents:
11587
diff
changeset
|
247 %! assert (x, ones (size (b)), 1e-7); |
14363
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14237
diff
changeset
|
248 |