readme

SuperLU 2.2版本。对大型、稀疏、非对称的线性系统的直接求解

		SuperLU_DIST  EXAMPLES

This directory contains sample programs to illustrate how to use
various functions provded in SuperLU_DIST. You can modify these
examples to suit your applications.

The examples illustrate the following functionalities:
  1. pddrive.c, pddrive_ABglobal.c
     Use PDGSSVX with the full (default) options to solve a linear system.
  2. pddrive1.c, pddrive1_ABglobal.c
     Solve the systems with same A but different right-hand side.
     (Reuse the factored form of A)
  3. pddrive2.c, pddrive2_ABglobal.c
     Solve the systems with the same sparsity pattern of A.
     (Reuse the sparsity ordering)
  4. pddrive3.c, pddrive3_ABglobal.c
     Solve the systems with the same sparsity pattern and similar values.
  5. pddrive4.c, pddrive4_ABglobal.c
     Divide the processors into two subgroups (two grids) such that each
     subgroup solves a linear system independently from the other.


The command line options "-r <process rows>" and "-c <process columns>"
defines the 2-D process grid. The total number of processes <procs> is:
	<procs> = <process rows> * <process columns>
If the options is not provided at the command line, the programs
will use 1 processor as default in each case.

Three input matrices (Harwell-Boeing format) are provided in this directory:
	g20.rua  -- a real matrix of dimension 400x400
	big.rua  -- a real matrix of dimension 4960x4960
        cg20.cua -- a complex matrix of dimension 400x400

The command lines given below show how to run parallel programs on the
IBM SP using "poe". On the other platforms, you may need other
command in place of "poe".

1. To run the real examples (pddrive, pddrive1, etc.)
   you may type:
   % poe pddrive -r <process row> -c <process columns> g20.rua -procs <n>
     (e.g., poe pddrive -r 2 -c 2 g20.rua -procs 4)

2. To run the real examples pddrive4 and pddrive4_ABglobal, you may type:
   % poe pddrive4 g20.rua -procs 10
   
3. To run the complex examples (pzdrive, pzdrive1, etc.),
   you may type:
   % poe pzdrive -r <process row> -c <process columns> cg20.cua -procs <n>

4. To run the complex examples pzdrive4 and pzdrive4_ABglobal, you may type:
   % poe pzdrive4 cg20.rua -procs 10