README
1 SuperLU EXAMPLES
2
3This directory contains sample programs to illustrate how to use
4various functions provded in SuperLU. You can modify these
5examples to suit your applications.
6
7Here are the descriptions of the double precision examples:
8
9 dlinsol : use simple driver DGSSV to solve a linear system one time.
10 dlinsol1: use simple driver DGSSV in the symmetric mode.
11 dlinsolx: use DGSSVX with the full (default) options to solve a
12 linear system.
13 dlinsolx1: use DGSSVX to factorize A first, then solve the system later.
14 dlinsolx2: use DGSSVX to solve systems repeatedly with the same sparsity
15 pattern of matrix A.
16 dlinsolx3: use DGSSVX to solve systems repeatedly with the same sparsity
17 pattern and similar numerical values as matrix A.
18
19 superlu : the small 5x5 sample program in Section 2 of the Users' Guide.
20
21 ditersol: use GMRES with ILU preconditioner to solve a linear system.
22 ILU is computed from the equilibrated matrix, and the
23 preconditioned GMRES is applied to the equilibrated system.
24 ( The ILU is computed by the routine SRC/dgsitrf.c, the driver
25 routine is SRC/dgsisx.c. )
26 ditersol1: use GMRES with ILU preconditioner to solve a linear system.
27 ILU is computed from the equilibrated matrix, but the
28 preconditioned GMRES is applied to the original system.
29
30
31To compile all the examples, type:
32 % make
33
34To run the small 5x5 sample program in Section 1 of the Users' Guide, type:
35 % superlu
36
37To run the real version examples, type:
38 % dlinsol < g20.rua (or, % slinsol < g20.rua)
39 % dlinsolx < g20.rua (or, % slinsolx < g20.rua)
40 % dlinsolx1 < g20.rua (or, % slinsolx1 < g20.rua)
41 % dlinsolx2 < g20.rua (or, % slinsolx2 < g20.rua)
42 % dlinsolx3 < g20.rua (or, % slinsolx3 < g20.rua)
43
44To run the complex version examples, type:
45 % zlinsol < cg20.cua (or, % clinsol < cg20.cua)
46 % zlinsolx < cg20.cua (or, % clinsolx < cg20.cua)
47 % zlinsolx1 < cg20.cua (or, % clinsolx1 < cg20.cua)
48 % zlinsolx2 < cg20.cua (or, % clinsolx2 < cg20.cua)
49 % zlinsolx3 < cg20.cua (or, % clinsolx3 < cg20.cua)
50
51To run the ILU preconditioner example, type:
52 % ditersol -h < g20.rua
53 % ditersol1 -h < g20.rua
54 % zitersol -h < cg20.cua
55 % zitersol1 -h < cg20.cua
56