SPOOLES 2.2 : SParse Object Oriented Linear Equations Solver
SPOOLES is a library for solving sparse real and complex
linear systems of equations, written in the C language using object
oriented design.
At present, there is the following functionality:

Compute multiple minimum degree, generalized nested dissection
and multisection orderings of matrices with symmetric structure.

Factor and solve square linear systems of equations with
symmetric structure, with or without pivoting for stability.
The factorization can be symmetric LDL^{T},
Hermitian LDL^{H},
or nonsymmetric LDU.
A direct factorization or a
drop tolerance factorization can be computed.
The factors and solve can be done in serial
mode, multithreaded with Solaris or POSIX threads, or with MPI.

Factor and solve overdetermined full rank systems of equations
using a multifrontal QR factorization, in serial or using POSIX
threads.

Solve square linear systems using a variety of Krylov iterative
methods.
The preconditioner is a drop tolerance factorization,
constructed with or without pivoting for stability.
The SPOOLES library has been developed by members of the Mathematics
and Engineering Analysis Unit of Boeing Phantom Works.
The library was supported in part by DARPA contract
DABT6395C0122 and the DoD High Performance Computing
Modernization Program Common HPC Software Support Initiative.
Individuals who have contributed to this package include:
 Cleve Ashcraft, Boeing Phantom Works
 Roger Grimes, Boeing Phantom Works
 Joseph Liu, York University
 Jim Patterson, Boeing Phantom Works
 Dan Pierce, Boeing Phantom Works
 Yichi Pierce, Boeing Phantom Works
 Peter Schartz, CSAR Corporation
 Juergen Schulze, University of Paderborn
 WeiPai Tang, University of Waterloo
 David Wah, Boeing Phantom Works
 Jason Wu, Boeing Phantom Works
This release is entirely within the public domain;
there are no licensing restrictions,
and there is no warranty of any sort.
Contact cleve.ashcraft@boeing.com for more information,
comments and bug reports.
The library is available as a gzip'd, tar'd file that contains the
entire source, drivers and LaTeX documentation.
There are seven Postscript files that contain documentation.

Install.ps.gz
 "SPOOLES 2.2 Installation Manual",
7 pages,
describes the library's structure and installation procedures.

ReferenceManual.ps.gz
 "The Reference Manual for SPOOLES, Release 2.2:
An Object Oriented Software Library for Solving Sparse Linear
Systems of Equations",
over 400 pages, every object, method and
driver is documented.

Ordering.ps.gz
 "Ordering Sparse Matrices and Transforming Front Trees",
20, pages,
describes the different ordering methods in the library and
the effect of the front trees on performance.

LinSol.ps.gz
 "Wrapper Objects for Solving a Linear System of Equations
using SPOOLES 2.2",
58 pages, provides the most gentle introduction to the library,
documents a set of software objects written to incorporate the
SPOOLES linear solver into the CSARNastran finite element software
package.

AllInOne.ps.gz
 "Solving Linear Systems using SPOOLES 2.2",
54 pages, contains example programs with commentary,
a general introduction to the library, much more detail
than the "Wrapper Objects" document immediately above.

Eigen.ps.gz
 "Integrating the SPOOLES 2.2 Sparse Linear Algebra Library into
the LANCZOS BlockShifted Lanczos Eigensolver",
42 pages,
documents a set of software objects written to incorporate the
SPOOLES linear solver into an eigenanalysis package,
also funded by DARPA contract DABT6395C0122 and
the DoD High Performance Computing
Modernization Program Common HPC Software Support Initiative.

PP99.ps.gz
"SPOOLES: An ObjectOriented Sparse Matrix Library",
10 pages,
a paper to be included in the Proceedings of the
1999 SIAM Conference on Parallel Processing for Scientific Computing,
March 2227, 1999.

spooles.2.2.tgz
 gzip'd, tar'd file that contains the
entire source, drivers and LaTeX documentation.
Changes since the 2.0 release.
 Semiimplicit factorizations to reduce storage and/or
operation counts for direct and approximate factorizations.
(See the SemiImplMtx directory.)
 Krylov solvers for real SPD, symmetric indefinite,
and nonsymmetric linear systems.
(See the Iter directory.)
The preconditioner is a drop tolerance approximate factorization
obtained from the FrontMtx object.
There also exists a simpler ILU drop tolerance factorization
in the ILUMtx directory.

There is a "patchandgo" functionality for factorizations
that must be modified on the fly.
One application is found in singular or near singular matrices
from structural analysis applications.
Another application is for matrices from interior point methods.
In both cases, the presence of a zero or small pivot element
requires special handling, without changing the pivot sequence.

There is a "wrapper" object to solve linear systems
found in the LinSol directory.
It was used to incorporate the SPOOLES library into
the CSARNastran finite element package.

There is a "wrapper" object used in an eigenanalysis package
found in the Eigen directory.

Several bugs were fixed in the multithreaded and MPI solvers.
Users of the SPOOLES 2.0 versions should upgrade.

The user manual and reference manual documentation has been
reorganized. There is a new documentation
directory, with five subdirectories:

documentation/Install holds
"SPOOLES 2.2 Installation Manual",
the installation manual.

documentation/AllInOne holds
"Solving Linear Systems using SPOOLES 2.2",
the driver programs manual.

documentation/FrontTrees holds
"Ordering Sparse Matrices and Transforming Front Trees",
the ordering manual.

documentation/ReferenceManual holds
"The Reference Manual for SPOOLES, Release 2.2:
An Object Oriented Software Library for Solving Sparse Linear
Systems of Equations",
the complete reference manual.

documentation/PP99 holds
"SPOOLES: An ObjectOriented Sparse Matrix Library",
a paper to be included in the Proceedings of the
1999 SIAM Conference on Parallel Processing for Scientific Computing,
March 2227, 1999.
Changes since the 1.0 release.
 Complex linear systems are now supported
 Factor storage has been reorganized to improve parallel solves
 Several bugs in the MPI solvers have been fixed