← Back to branch summary

~ubuntu-branches/ubuntu/warty/petsc/warty

« back to all changes in this revision

Viewing changes to docs/manualpages/concepts/sles.htm

  • Committer: Bazaar Package Importer
  • Author(s): Adam C. Powell, IV
  • Date: 2004-06-07 13:41:43 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20040607134143-92p586zrauvie0le
Tags: 2.2.0-2
http://bugs.debian.org/249617
* Upstream patch level 2.
* New PETSC_BOPT_EXTRA option for different BOPT and lib names, with _c++
  symlinks only for plain and single (closes: #249617).
* New DEBIAN_DIST=contrib option to link with hypre, parmetis (closes:
  #249619).
* Combined petsc-c and petsc-fortran substvars into petsc-compilers.
* Extra quote in -dev prerm eliminates "too many arguments" problem.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/manualpages/concepts/sles.htm
1
 
<html>
2
 
<title>SLES</title><body bgcolor="FFFFFF">
3
 
<h2>SLES</h2>
4
 
<menu>
5
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex1.c.html"><CONCEPT>solving a system of linear equations</CONCEPT></A>
6
 
<menu>
7
 
Solves a tridiagonal linear system with SLES.<BR></menu>
8
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex12.c.html"><CONCEPT>solving a system of linear equations</CONCEPT></A>
9
 
<menu>
10
 
Solves a linear system in parallel with SLES.<BR>Input parameters include:<BR>
11
 
  -m &lt;mesh_x&gt;       : number of mesh points in x-direction<BR>
12
 
  -n &lt;mesh_n&gt;       : number of mesh points in y-direction<BR>
13
 
</menu>
14
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex1f.F.html"><CONCEPT>solving a system of linear equations</CONCEPT></A>
15
 
<menu>
16
 
<BR>
17
 
<BR>
18
 
   Description: Solves a tridiagonal linear system with SLES.<BR>
19
 
<BR>
20
 
</menu>
21
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex2.c.html"><CONCEPT>basic parallel example;</CONCEPT></A>
22
 
<menu>
23
 
Solves a linear system in parallel with SLES.<BR>Input parameters include:<BR>
24
 
  -random_exact_sol : use a random exact solution vector<BR>
25
 
  -view_exact_sol   : write exact solution vector to stdout<BR>
26
 
  -m &lt;mesh_x&gt;       : number of mesh points in x-direction<BR>
27
 
  -n &lt;mesh_n&gt;       : number of mesh points in y-direction<BR>
28
 
</menu>
29
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex23.c.html"><CONCEPT>basic parallel example;</CONCEPT></A>
30
 
<menu>
31
 
Solves a tridiagonal linear system.<BR></menu>
32
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex12.c.html"><CONCEPT>Laplacian, 2d</CONCEPT></A>
33
 
<menu>
34
 
Solves a linear system in parallel with SLES.<BR>Input parameters include:<BR>
35
 
  -m &lt;mesh_x&gt;       : number of mesh points in x-direction<BR>
36
 
  -n &lt;mesh_n&gt;       : number of mesh points in y-direction<BR>
37
 
</menu>
38
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex13.c.html"><CONCEPT>Laplacian, 2d</CONCEPT></A>
39
 
<menu>
40
 
Solves a variable Poisson problem with SLES.<BR></menu>
41
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex13f90.F.html"><CONCEPT>Laplacian, 2d</CONCEPT></A>
42
 
<menu>
43
 
<BR>
44
 
<BR>
45
 
<BR>
46
 
</menu>
47
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex16.c.html"><CONCEPT>Laplacian, 2d</CONCEPT></A>
48
 
<menu>
49
 
Solves a sequence of linear systems with different right-hand-side vectors.<BR>Input parameters include:<BR>
50
 
  -ntimes &lt;ntimes&gt;  : number of linear systems to solve<BR>
51
 
  -view_exact_sol   : write exact solution vector to stdout<BR>
52
 
  -m &lt;mesh_x&gt;       : number of mesh points in x-direction<BR>
53
 
  -n &lt;mesh_n&gt;       : number of mesh points in y-direction<BR>
54
 
</menu>
55
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex2.c.html"><CONCEPT>Laplacian, 2d</CONCEPT></A>
56
 
<menu>
57
 
Solves a linear system in parallel with SLES.<BR>Input parameters include:<BR>
58
 
  -random_exact_sol : use a random exact solution vector<BR>
59
 
  -view_exact_sol   : write exact solution vector to stdout<BR>
60
 
  -m &lt;mesh_x&gt;       : number of mesh points in x-direction<BR>
61
 
  -n &lt;mesh_n&gt;       : number of mesh points in y-direction<BR>
62
 
</menu>
63
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex15.c.html"><CONCEPT>basic parallel example</CONCEPT></A>
64
 
<menu>
65
 
Solves a linear system in parallel with SLES.  Also<BR>illustrates setting a user-defined shell preconditioner and using the<BR>
66
 
macro __FUNCT__ to define routine names for use in error handling.<BR>
67
 
Input parameters include:<BR>
68
 
  -user_defined_pc : Activate a user-defined preconditioner<BR>
69
 
</menu>
70
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex15f.F.html"><CONCEPT>basic parallel example</CONCEPT></A>
71
 
<menu>
72
 
<BR>
73
 
<BR>
74
 
   Solves a linear system in parallel with SLES.  Also indicates<BR>
75
 
   use of a user-provided preconditioner.  Input parameters include:<BR>
76
 
      -user_defined_pc : Activate a user-defined preconditioner<BR>
77
 
<BR>
78
 
  Program usage: mpirun ex15f [-help] [all PETSc options]<BR>
79
 
<BR>
80
 
</menu>
81
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex21f.F.html"><CONCEPT>basic parallel example</CONCEPT></A>
82
 
<menu>
83
 
<BR>
84
 
<BR>
85
 
   Solves a linear system in parallel with SLES.  Also indicates<BR>
86
 
   use of a user-provided preconditioner.  Input parameters include:<BR>
87
 
<BR>
88
 
  Program usage: mpirun ex21f [-help] [all PETSc options]<BR>
89
 
<BR>
90
 
</menu>
91
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex2f.F.html"><CONCEPT>basic parallel example</CONCEPT></A>
92
 
<menu>
93
 
<BR>
94
 
<BR>
95
 
  Description: Solves a linear system in parallel with SLES (Fortran code).<BR>
96
 
               Also shows how to set a user-defined monitoring routine.<BR>
97
 
<BR>
98
 
  Program usage: mpirun -np &lt;procs&gt; ex2f [-help] [all PETSc options]<BR>
99
 
<BR>
100
 
</menu>
101
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex3.c.html"><CONCEPT>basic parallel example</CONCEPT></A>
102
 
<menu>
103
 
Solves a linear system in parallel with SLES.  The matrix<BR>uses simple bilinear elements on the unit square.  To test the parallel<BR>
104
 
matrix assembly, the matrix is intentionally laid out across processors<BR>
105
 
differently from the way it is assembled.  Input arguments are:<BR>
106
 
  -m &lt;size&gt; : problem size<BR>
107
 
</menu>
108
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex4.c.html"><CONCEPT>different matrices for linear system and preconditioner;</CONCEPT></A>
109
 
<menu>
110
 
Uses a different preconditioner matrix and linear system matrix in the SLES solvers.<BR>Note that different storage formats<BR>
111
 
can be used for the different matrices.<BR>
112
 
</menu>
113
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex6f.F.html"><CONCEPT>different matrices for linear system and preconditioner;</CONCEPT></A>
114
 
<menu>
115
 
<BR>
116
 
<BR>
117
 
  Description: This example demonstrates repeated linear solves as<BR>
118
 
  well as the use of different preconditioner and linear system<BR>
119
 
  matrices.  This example also illustrates how to save PETSc objects<BR>
120
 
  in common blocks.<BR>
121
 
<BR>
122
 
</menu>
123
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex16.c.html"><CONCEPT>repeatedly solving linear systems;</CONCEPT></A>
124
 
<menu>
125
 
Solves a sequence of linear systems with different right-hand-side vectors.<BR>Input parameters include:<BR>
126
 
  -ntimes &lt;ntimes&gt;  : number of linear systems to solve<BR>
127
 
  -view_exact_sol   : write exact solution vector to stdout<BR>
128
 
  -m &lt;mesh_x&gt;       : number of mesh points in x-direction<BR>
129
 
  -n &lt;mesh_n&gt;       : number of mesh points in y-direction<BR>
130
 
</menu>
131
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex5.c.html"><CONCEPT>repeatedly solving linear systems;</CONCEPT></A>
132
 
<menu>
133
 
Solves two linear systems in parallel with SLES.  The code<BR>illustrates repeated solution of linear systems with the same preconditioner<BR>
134
 
method but different matrices (having the same nonzero structure).  The code<BR>
135
 
also uses multiple profiling stages.  Input arguments are<BR>
136
 
  -m &lt;size&gt; : problem size<BR>
137
 
  -mat_nonsym : use nonsymmetric matrix (default is symmetric)<BR>
138
 
</menu>
139
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex6f.F.html"><CONCEPT>repeatedly solving linear systems;</CONCEPT></A>
140
 
<menu>
141
 
<BR>
142
 
<BR>
143
 
  Description: This example demonstrates repeated linear solves as<BR>
144
 
  well as the use of different preconditioner and linear system<BR>
145
 
  matrices.  This example also illustrates how to save PETSc objects<BR>
146
 
  in common blocks.<BR>
147
 
<BR>
148
 
</menu>
149
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex9.c.html"><CONCEPT>repeatedly solving linear systems;</CONCEPT></A>
150
 
<menu>
151
 
The solution of 2 different linear systems with different linear solvers.<BR>Also, this example illustrates the repeated<BR>
152
 
solution of linear systems, while reusing matrix, vector, and solver data<BR>
153
 
structures throughout the process.  Note the various stages of event logging.<BR>
154
 
</menu>
155
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex7.c.html"><CONCEPT>customizing the block Jacobi preconditioner</CONCEPT></A>
156
 
<menu>
157
 
Block Jacobi preconditioner for solving a linear system in parallel with SLES.<BR>The code indicates the<BR>
158
 
procedures for setting the particular block sizes and for using different<BR>
159
 
linear solvers on the individual blocks.<BR>
160
 
</menu>
161
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex8.c.html"><CONCEPT>Additive Schwarz Method (ASM) with user-defined subdomains</CONCEPT></A>
162
 
<menu>
163
 
Illustrates use of the preconditioner ASM.<BR>The Additive Schwarz Method for solving a linear system in parallel with SLES.  The<BR>
164
 
code indicates the procedure for setting user-defined subdomains.  Input<BR>
165
 
parameters include:<BR>
166
 
  -user_set_subdomain_solvers:  User explicitly sets subdomain solvers<BR>
167
 
  -user_set_subdomains:  Activate user-defined subdomains<BR>
168
 
</menu>
169
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex10.c.html"><CONCEPT>solving a linear system</CONCEPT></A>
170
 
<menu>
171
 
Reads a PETSc matrix and vector from a file and solves a linear system.<BR>This version first preloads and solves a small system, then loads <BR>
172
 
another (larger) system and solves it as well.  This example illustrates<BR>
173
 
preloading of instructions with the smaller system so that more accurate<BR>
174
 
performance monitoring can be done with the larger one (that actually<BR>
175
 
is the system of interest).  See the 'Performance Hints' chapter of the<BR>
176
 
users manual for a discussion of preloading.  Input parameters include<BR>
177
 
  -f0 &lt;input_file&gt; : first file to load (small system)<BR>
178
 
  -f1 &lt;input_file&gt; : second file to load (larger system)<BR>
179
 
  -trans  : solve transpose system instead<BR>
180
 
</menu>
181
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex11.c.html"><CONCEPT>solving a Helmholtz equation</CONCEPT></A>
182
 
<menu>
183
 
Solves a linear system in parallel with SLES.<BR></menu>
184
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex11f.F.html"><CONCEPT>solving a Helmholtz equation</CONCEPT></A>
185
 
<menu>
186
 
<BR>
187
 
<BR>
188
 
  Description: Solves a complex linear system in parallel with SLES (Fortran code).<BR>
189
 
<BR>
190
 
</menu>
191
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex13.c.html"><CONCEPT>basic sequential example</CONCEPT></A>
192
 
<menu>
193
 
Solves a variable Poisson problem with SLES.<BR></menu>
194
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex13f90.F.html"><CONCEPT>basic sequential example</CONCEPT></A>
195
 
<menu>
196
 
<BR>
197
 
<BR>
198
 
<BR>
199
 
</menu>
200
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex2f.F.html"><CONCEPT>setting a user-defined monitoring routine</CONCEPT></A>
201
 
<menu>
202
 
<BR>
203
 
<BR>
204
 
  Description: Solves a linear system in parallel with SLES (Fortran code).<BR>
205
 
               Also shows how to set a user-defined monitoring routine.<BR>
206
 
<BR>
207
 
  Program usage: mpirun -np &lt;procs&gt; ex2f [-help] [all PETSc options]<BR>
208
 
<BR>
209
 
</menu>
210
 
<LI><A HREF="../../../src/sles/examples/tutorials/ex14f.F.html"><CONCEPT>writing a user-defined nonlinear solver</CONCEPT></A>
211
 
<menu>
212
 
<BR>
213
 
<BR>
214
 
  Solves a nonlinear system in parallel with a user-defined<BR>
215
 
  Newton method that uses SLES to solve the linearized Newton sytems.  This solver<BR>
216
 
  is a very simplistic inexact Newton method.  The intent of this code is to<BR>
217
 
  demonstrate the repeated solution of linear sytems with the same nonzero pattern.<BR>
218
 
<BR>
219
 
  This is NOT the recommended approach for solving nonlinear problems with PETSc!<BR>
220
 
  We urge users to employ the SNES component for solving nonlinear problems whenever<BR>
221
 
  possible, as it offers many advantages over coding nonlinear solvers independently.<BR>
222
 
<BR>
223
 
  We solve the  Bratu (SFI - solid fuel ignition) problem in a 2D rectangular<BR>
224
 
  domain, using distributed arrays (DAs) to partition the parallel grid.<BR>
225
 
<BR>
226
 
</menu>
227
 
</menu>
228
 
</body>
229
 
</html>