From e58ef87429e855950b3eab547a8956bb057a2e63 Mon Sep 17 00:00:00 2001 From: wolf Date: Tue, 6 Feb 2001 09:52:53 +0000 Subject: [PATCH] More and complete words on use and installation of HSL functions. git-svn-id: https://svn.dealii.org/trunk@3864 0785d39b-7218-0410-832d-ea1e28bc413d --- deal.II/contrib/hsl/include/hsl/hsl.h | 6 +- deal.II/doc/development/makefiles.1.html | 15 +++ deal.II/doc/external-libs/hsl.html | 123 +++++++++++++++++++++++ deal.II/doc/news/2001/c-3-1.html | 11 +- deal.II/doc/news/news.html | 15 +++ deal.II/doc/readme.html | 7 +- deal.II/lac/include/lac/sparse_direct.h | 3 + 7 files changed, 176 insertions(+), 4 deletions(-) create mode 100644 deal.II/doc/external-libs/hsl.html diff --git a/deal.II/contrib/hsl/include/hsl/hsl.h b/deal.II/contrib/hsl/include/hsl/hsl.h index e502b367db..73ce7a1c85 100644 --- a/deal.II/contrib/hsl/include/hsl/hsl.h +++ b/deal.II/contrib/hsl/include/hsl/hsl.h @@ -19,9 +19,11 @@ * here provide services for the direct solution of sparse systems of * linear equations. For a thorough discussion of these functions, as * well as for a way to download them, please see - * @url{http://www.cse.clrc.ac.uk/Activity/HSL}. + * @url{http://www.cse.clrc.ac.uk/Activity/HSL}. For a description of + * the steps necessary for the installation of HSL subroutines, read + * the section on external libraries in the deal.II ReadMe file. * - * @author Wolfgang Bangerth, 2000 + * @author Wolfgang Bangerth, 2000, 2001 */ namespace HSL { diff --git a/deal.II/doc/development/makefiles.1.html b/deal.II/doc/development/makefiles.1.html index dd09c0351f..15e6fdc8f1 100644 --- a/deal.II/doc/development/makefiles.1.html +++ b/deal.II/doc/development/makefiles.1.html @@ -127,6 +127,9 @@ yes indicates whether some subroutines from the HSL have been explicitely installed and shall be used by the library. no otherwise. + (See the + ReadMe + file for more information on installation of HSL subroutines.)

@@ -162,6 +165,10 @@ Path to the place where the HSL subroutine functions are linked into a library. Note that this library is only available if it is installed explicitely by the user. + (See the + ReadMe + file for more information on installation of HSL + subroutines.)

@@ -217,6 +224,10 @@

Path and name of the library that contains the HSL subroutines explicitely installed. + (See the + ReadMe + file for more information on installation of HSL + subroutines.)

@@ -252,6 +263,10 @@ If some HSL files are installed, this path points to includes for the declaration of C bindings to these functions. + (See the + ReadMe + file for more information on installation of HSL + subroutines.)

diff --git a/deal.II/doc/external-libs/hsl.html b/deal.II/doc/external-libs/hsl.html new file mode 100644 index 0000000000..7f413f9e48 --- /dev/null +++ b/deal.II/doc/external-libs/hsl.html @@ -0,0 +1,123 @@ + + + + + + The deal.II Readme + + + + + + + +

Using and installing instructions for functions from the + Harwell Subroutine Library (HSL)

+ +

+ The Harwell Subroutine Library (HSL) is a collection of + Fortran77 files that implement various methods to solve linear + systems of equations, but also cover various other aspects of + mathematical algorithms. deal.II is presently + able to use two of the sparse direct solvers implemented in that + library: +

+ Within deal.II, they are used by the classes + SparseDirectMA27 and SparseDirectMA47 + (see the online reference in the LAC sublibrary for more + information). +

+ +

+ With respect to the integration of these functions into + deal.II, there are two problems: Firstly, for + license reasons, we can not, however, include these solvers in the + standard distribution of the library, so you have to download them + yourself, if you want to use them. Secondly, these functions are + usually downloaded as single files, rather than as a complete + library, so one does not usually build up a whole library against which + a deal.II program could be linked, but is left + with the individual files. +

+ +

+ Our solution to this problem is as follows: +

+

+ +

+ Note that if the respective functions have not been found at + configure time, then the classes using them are still available to + programs, but when called will issue an error message and abort + the program with an exception. +

+ +

+ If HSL functions have been found, then we also have some Fortran77 + code in the system. Of course, the requires that some F77 compiler + has been found at configure time, but note that this also changes + the libraries that need to be linked to the program. For example, + on Sun, these are the libraries -lF77 -lsunmath + -lM77. Usually, the right set of additional libraries + should be detected automatically at configure time, and the + respective flags should also be set correctly without user + interaction. +

+ +
+ +
+ The deal.II mailing list + $Date$ +
+ + diff --git a/deal.II/doc/news/2001/c-3-1.html b/deal.II/doc/news/2001/c-3-1.html index 2b9b1253a6..57fc7a7e2a 100644 --- a/deal.II/doc/news/2001/c-3-1.html +++ b/deal.II/doc/news/2001/c-3-1.html @@ -30,6 +30,9 @@ documentation, etc. New: There is now some support to include and use routines from the Harwell Subroutine Library. + (See the ReadMe + file for more information on installation of HSL + subroutines.)
(WB 2001/01/30)

@@ -80,7 +83,13 @@ documentation, etc. New: There is now some support to include and use routines from the Harwell Subroutine Library, and support - classes for the sparse direct solvers MA27 and MA47. + classes + SparseDirectMA27 and + SparseDirectMA47 + for the sparse direct solvers MA27 and MA47. + (See the ReadMe + file for more information on installation of HSL + subroutines.)
(WB 2001/01/30)

diff --git a/deal.II/doc/news/news.html b/deal.II/doc/news/news.html index 1aa5b34ac4..de0744eeb7 100644 --- a/deal.II/doc/news/news.html +++ b/deal.II/doc/news/news.html @@ -30,6 +30,21 @@
+
+ Support for Subroutines from the Harwell Subroutine + Library (HSL) +
+
+ The Harwell Subroutine Library (HSL) is a + library that, among much other functionality, offers some + sparse direct solvers. We have added support for an + interface to these solvers to the library. + (See the ReadMe + file for more information on installation of HSL + subroutines.) +
+
Changes between the upcoming version 3.1 and the main branch diff --git a/deal.II/doc/readme.html b/deal.II/doc/readme.html index 7665d391d2..cf64eb8cd8 100644 --- a/deal.II/doc/readme.html +++ b/deal.II/doc/readme.html @@ -542,7 +542,12 @@
  • - It is also possible to use some subroutines from the ... + It is also possible to use some subroutines from the + Harwell Subroutine Library (HSL) to make use + of some sparse direct solvers. For a description of how to + include these functions, see + this page.

    diff --git a/deal.II/lac/include/lac/sparse_direct.h b/deal.II/lac/include/lac/sparse_direct.h index 3f89fd2f07..fa9fd11881 100644 --- a/deal.II/lac/include/lac/sparse_direct.h +++ b/deal.II/lac/include/lac/sparse_direct.h @@ -35,6 +35,9 @@ * etc. It also manages allocation of the right amount of temporary * storage required by these functions. * + * For a description of the steps necessary for the installation of + * HSL subroutines, read the section on external libraries in the + * deal.II ReadMe file. * * @section3{Interface and Method} * -- 2.39.5