From 4585e479c5f2ea3aacb1ca1b54e2a5a76f3e3816 Mon Sep 17 00:00:00 2001
From: Wolfgang Bangerth
Date: Tue, 11 Mar 2008 19:09:35 +0000
Subject: [PATCH] Shorten the PETSc entry, add an entry on Trilinos.
git-svn-id: https://svn.dealii.org/trunk@15886 0785d39b-7218-0410-832d-ea1e28bc413d
---
deal.II/doc/readme.html | 55 +++++++++++++++++++++++++++++------------
1 file changed, 39 insertions(+), 16 deletions(-)
diff --git a/deal.II/doc/readme.html b/deal.II/doc/readme.html
index 487a733be8..a27641d78e 100644
--- a/deal.II/doc/readme.html
+++ b/deal.II/doc/readme.html
@@ -5,7 +5,7 @@
The deal.II Readme
-
+
@@ -552,22 +552,17 @@
deal.II can interface to the PETSc
- library. PETSc's main strength is to provide lots of functions for
- linear algebra, among several other things. It comes with
+ library. PETSc's provides lots of functions for
+ linear algebra, among other things, for example
implementations of a variety of linear solvers, as well as various
- different sparse and dense matrix and vector formats, for which
+ different sparse and dense matrix and vector formats.
deal.II has wrapper classes that provide almost the
same interfaces as the built-in deal.II linear
algebra classes. The main advantage of PETSc is the variety of its
algorithms, and that all of them can work in a parallel setting,
i.e. matrices and vectors can be distributed across a cluster of
- computers that communicate via MPI. This makes PETSc the choice of
- linear algrebra implementations for very large problems that do not fit
- into a single computer's memory or have run-times that are too long for
- a single computer. At present, our interfaces are only wrappers for
- vector and matrix formats, as well as to their solver and preconditioner
- classes. However, we plan to extend this to a tighter coupling in the
- future.
+ computers that communicate via MPI, providing deal.II
+ with parallel computing capabilities.
@@ -581,11 +576,12 @@
compiled. If these environment variables are set, then
deal.II will pick them up during configuration, and
store them. It will then also recognize that PETSc shall be used, and
- enable the wrapper classes (they are disabled by default, if PETSc is
- unavailable). However, you can override the values of these environment
- variablaes by using the --with-petsc=DIR and
- --with-mpi-arch=ARCH switches to
- ./configure. If you do have a PETSc installation
+ enable the wrapper classes. The
+ --with-petsc=DIR and
+ --with-petsc-arch=ARCH switches to
+ ./configure can be used to override the values
+ of PETSC_DIR and PETSC_ARCH or if these
+ environment variables are not set at all. If you do have a PETSc installation
and have set the PETSC_DIR and
PETSC_ARCH environment variables but do not wish
deal.II to be configured for PETSc use, you
@@ -612,6 +608,33 @@
+
+
+
Trilinos
+
+
+ deal.II can also interface to the Trilinos software
+ library. Trilinos, like PETSc, provides a large number of linear algebra
+ and other classes that can be used on sequential or parallel
+ computers. It is written in C++ and considered more modern than PETSc.
+
+
+
+ As with our PETSc support, deal.II
+ has wrappers that allow Trilinos linear algebra classes to be used with
+ the same interface as deal.II classes. These
+ interfaces can be enabled by setting the TRILINOS_DIR
+ environment variable to the path to an existing Trilinos installation,
+ or using the --enable-trilinos=/path/to/trilinos switch of
+ the ./configure script. The Trilinos installation needs to
+ provide the same kind of libraries that deal.II is
+ configured for, i.e. if you want deal.II to use shared libraries, then
+ Trilinos needs to use shared libraries as well.
+