From 1c7dcd4f515d2d4b2378a283e8b105a757887f43 Mon Sep 17 00:00:00 2001 From: Salvatore Filippone Date: Fri, 15 Sep 2017 11:17:32 +0100 Subject: [PATCH] Doc fixes. --- docs/html/index.html | 2 +- docs/html/node1.html | 14 +-- docs/html/node11.html | 2 +- docs/html/node14.html | 2 +- docs/html/node16.html | 4 +- docs/html/node17.html | 14 +-- docs/html/node18.html | 2 +- docs/html/node20.html | 31 +++--- docs/html/node21.html | 4 +- docs/html/node22.html | 2 +- docs/html/node23.html | 2 +- docs/html/node28.html | 2 +- docs/html/node29.html | 5 +- docs/html/node3.html | 14 +-- docs/html/node30.html | 224 +++++++++++++++++++------------------- docs/html/node31.html | 2 +- docs/html/node4.html | 2 +- docs/html/node7.html | 2 +- docs/html/node8.html | 2 +- docs/html/node9.html | 3 +- docs/html/userhtml.html | 2 +- docs/mld2p4-2.1-guide.pdf | 6 +- 22 files changed, 171 insertions(+), 172 deletions(-) diff --git a/docs/html/index.html b/docs/html/index.html index dfbb0955..8be22a42 100644 --- a/docs/html/index.html +++ b/docs/html/index.html @@ -43,7 +43,7 @@ original version by: Nikos Drakos, CBLU, University of Leeds

User's and Reference Guide -
A guide for the Multi-Level Domain Decomposition +
A guide for the MultiLevel Domain Decomposition Parallel Preconditioners Package based on PSBLAS
diff --git a/docs/html/node1.html b/docs/html/node1.html index 537f9b98..44dcc6bd 100644 --- a/docs/html/node1.html +++ b/docs/html/node1.html @@ -55,12 +55,12 @@ original version by: Nikos Drakos, CBLU, University of Leeds Abstract -MLD2P4 (MULTI-LEVEL DOMAIN DECOMPOSITION PARALLEL PRECONDITIONERS PACKAGE -BASED ON PSBLAS) is a package of parallel algebraic multi-level preconditioners. -The first release of MLD2P4 made available multi-level additive and hybrid Schwarz +MLD2P4 (MULTILEVEL DOMAIN DECOMPOSITION PARALLEL PRECONDITIONERS PACKAGE +BASED ON PSBLAS) is a package of parallel algebraic multilevel preconditioners. +The first release of MLD2P4 made available multilevel additive and hybrid Schwarz preconditioners, as well as one-level additive Schwarz preconditioners. The package -has been extended to include further multi-level cycles and smoothers widely used in -multigrid methods. In the multi-level case, a purely algebraic approach is applied to +has been extended to include further multilevel cycles and smoothers widely used in +multigrid methods. In the multilevel case, a purely algebraic approach is applied to generate coarse-level corrections, so that no geometric background is needed concerning the matrix to be preconditioned. The matrix is assumed to be square, real or complex. @@ -70,14 +70,14 @@ real or complex. in the context of the PSBLAS (Parallel Sparse Basic Linear Algebra Subprograms) computational framework and can be used in conjuction with the Krylov solvers available in this framework. MLD2P4 enables the user to easily specify different -features of an algebraic multi-level preconditioner, thus allowing to search +features of an algebraic multilevel preconditioner, thus allowing to search for the ``best'' preconditioner for the problem at hand.

The package employs object-oriented design techniques in Fortran 2003, with interfaces to additional third party libraries such as MUMPS, UMFPACK, SuperLU, and SuperLU_Dist, which -can be exploited in building multi-level preconditioners. The parallel +can be exploited in building multilevel preconditioners. The parallel implementation is based on a Single Program Multiple Data (SPMD) paradigm; the inter-process communication is based on MPI and is managed mainly through PSBLAS. diff --git a/docs/html/node11.html b/docs/html/node11.html index 6c27253f..a930291c 100644 --- a/docs/html/node11.html +++ b/docs/html/node11.html @@ -62,7 +62,7 @@ both of them are further divided into fileread and

contains a set of simple example programs with a predefined choice of preconditioners, selectable via integer values. These are intended to get an acquaintance with the - multi-level preconditioners available in MLD2P4. + multilevel preconditioners available in MLD2P4.
tests
contains a set of more sophisticated examples that diff --git a/docs/html/node14.html b/docs/html/node14.html index 0b19fb06..547d56df 100644 --- a/docs/html/node14.html +++ b/docs/html/node14.html @@ -265,7 +265,7 @@ P^k = S^k \bar{P}^k,

in order to remove nonsmooth components from the range of the prolongator, -and hence to improve the convergence properties of the multi-level +and hence to improve the convergence properties of the multilevel method [2,23]. diff --git a/docs/html/node16.html b/docs/html/node16.html index 7a9da919..8b62880f 100644 --- a/docs/html/node16.html +++ b/docs/html/node16.html @@ -56,7 +56,7 @@ original version by: Nikos Drakos, CBLU, University of Leeds Getting Started

-We describe the basics for building and applying MLD2P4 one-level and multi-level +We describe the basics for building and applying MLD2P4 one-level and multilevel (i.e., AMG) preconditioners with the Krylov solvers included in PSBLAS [13]. The following steps are required: @@ -90,7 +90,7 @@ The following steps are required: Section 6, Tables 2-8.

  • Build the preconditioner for a given matrix. If the selected preconditioner - is multi-level, then two steps must be performed, as specified next. + is multilevel, then two steps must be performed, as specified next.
    4.1
    Build the aggregation hierarchy for a given matrix. This is diff --git a/docs/html/node17.html b/docs/html/node17.html index 3d749561..6c843a7e 100644 --- a/docs/html/node17.html +++ b/docs/html/node17.html @@ -56,7 +56,7 @@ Examples

    The code reported in Figure 2 shows how to set and apply the default -multi-level preconditioner available in the real double precision version +multilevel preconditioner available in the real double precision version of MLD2P4 (see Table 1). This preconditioner is chosen by simply specifying 'ML' as the second argument of P%init (a call to P%set is not needed) and is applied with the CG @@ -80,7 +80,7 @@ Guide [13].

    -The setup and application of the default multi-level preconditioner +The setup and application of the default multilevel preconditioner for the real single precision and the complex, single and double precision, versions are obtained with straightforward modifications of the previous example (see Section 6 for details). If these versions are installed, @@ -91,7 +91,7 @@ the corresponding codes are available in examples/fileread/.

    Figure 2: -setup and application of the default multi-level preconditioner (example 1). +setup and application of the default multilevel preconditioner (example 1).
    @@ -122,7 +122,7 @@ setup and application of the default multi-level preconditioner (example 1). ! using PSBLAS routines for sparse matrix / vector management ... ... ! -! initialize the default multi-level preconditioner, i.e. V-cycle +! initialize the default multilevel preconditioner, i.e. V-cycle ! with basic smoothed aggregation, 1 hybrid forward/backward ! GS sweep as pre/post-smoother and UMFPACK as coarsest-level ! solver @@ -159,7 +159,7 @@ setup and application of the default multi-level preconditioner (example 1).

    -Different versions of the multi-level preconditioner can be obtained by changing +Different versions of the multilevel preconditioner can be obtained by changing the default values of the preconditioner parameters. The code reported in Figure 3 shows how to set a V-cycle preconditioner which applies 1 block-Jacobi sweep as pre- and post-smoother, @@ -197,7 +197,7 @@ boundary conditions are also available in the directory examples/pdegen +setup of a multilevel preconditioner
    Figure 3: -setup of a multi-level preconditioner
    @@ -230,7 +230,7 @@ setup of a multi-level preconditioner
    +setup of a multilevel preconditioner
    Figure 4: -setup of a multi-level preconditioner
    diff --git a/docs/html/node18.html b/docs/html/node18.html index 8a65faa0..cec251b6 100644 --- a/docs/html/node18.html +++ b/docs/html/node18.html @@ -60,7 +60,7 @@ User Interface routines init, set, hierarchy_build, smoothers_build, bld, and apply encapsulate all the -functionalities for the setup and the application of any multi-level and one-level +functionalities for the setup and the application of any multilevel and one-level preconditioner implemented in the package. The routine free deallocates the preconditioner data structure, while descr prints a description of the preconditioner setup by the user. diff --git a/docs/html/node20.html b/docs/html/node20.html index 54203990..04151d3e 100644 --- a/docs/html/node20.html +++ b/docs/html/node20.html @@ -109,7 +109,7 @@ contained in val. - - @@ -690,7 +689,7 @@ Parameters defining the smoother or the details of the one-level preconditioner. - diff --git a/docs/html/node21.html b/docs/html/node21.html index b998987f..83a9f502 100644 --- a/docs/html/node21.html +++ b/docs/html/node21.html @@ -63,7 +63,7 @@ Subroutine build This routine builds the one-level preconditioner p according to the requirements made by the user through the routines init and set -(see Sections 6.4 and 6.5 for multi-level preconditioners). +(see Sections 6.4 and 6.5 for multilevel preconditioners).

    Arguments @@ -111,7 +111,7 @@ as follows:

    -In this case, the routine can be used to build multi-level preconditioners too. +In this case, the routine can be used to build multilevel preconditioners too.

    diff --git a/docs/html/node22.html b/docs/html/node22.html index 344ae846..2ed059c8 100644 --- a/docs/html/node22.html +++ b/docs/html/node22.html @@ -62,7 +62,7 @@ Subroutine hierarchy_build

    This routine builds the hierarchy of matrices and restriction/prolongation -operators for the multi-level preconditioner p, according to the requirements +operators for the multilevel preconditioner p, according to the requirements made by the user through the routines init and set.

    diff --git a/docs/html/node23.html b/docs/html/node23.html index 44b9e1d5..94e2ce16 100644 --- a/docs/html/node23.html +++ b/docs/html/node23.html @@ -62,7 +62,7 @@ Subroutine smoothers_build

    This routine builds the smoothers and the coarsest-level solvers for the -multi-level preconditioner p, according to the requirements made by +multilevel preconditioner p, according to the requirements made by the user through the routines init and set, and based on the aggregation hierarchy produced by a previous call to hierarchy_build (see Section 6.4). diff --git a/docs/html/node28.html b/docs/html/node28.html index b7194cdb..d42a56e7 100644 --- a/docs/html/node28.html +++ b/docs/html/node28.html @@ -56,7 +56,7 @@ original version by: Nikos Drakos, CBLU, University of Leeds Error Handling

    -The error handling in MLD2P4 is based on the PSBLAS (version 2) error +The error handling in MLD2P4 is based on the PSBLAS error handling. Error conditions are signaled via an integer argument info; whenever an error condition is detected, an error trace stack is built by the library up to the top-level, user-callable diff --git a/docs/html/node29.html b/docs/html/node29.html index 0af35633..89ad8e9f 100644 --- a/docs/html/node29.html +++ b/docs/html/node29.html @@ -58,13 +58,12 @@ License

    The MLD2P4 is freely distributable under the following copyright terms: 

     
-
  
                            MLD2P4  version 2.1
   MultiLevel Domain Decomposition Parallel Preconditioners Package
-             based on PSBLAS (Parallel Sparse BLAS version 3.4)
+             based on PSBLAS (Parallel Sparse BLAS version 3.5)
   
-  (C) Copyright 2008, 2010, 2012, 2017
+  (C) Copyright 2008, 2010, 2012, 2015, 2017
 
   Salvatore Filippone    Cranfield University, Cranfield, UK
   Pasqua D'Ambra         IAC-CNR, Naples, IT
diff --git a/docs/html/node3.html b/docs/html/node3.html
index b8c2c7a7..47bb8156 100644
--- a/docs/html/node3.html
+++ b/docs/html/node3.html
@@ -56,7 +56,7 @@ original version by:  Nikos Drakos, CBLU, University of Leeds
 General Overview
 
 
    
-The MULTI-LEVEL DOMAIN DECOMPOSITION PARALLEL PRECONDITIONERS PACKAGE BASED ON
+The MULTILEVEL DOMAIN DECOMPOSITION PARALLEL PRECONDITIONERS PACKAGE BASED ON
 PSBLAS (MLD2P4) provides parallel Algebraic MultiGrid (AMG) and Domain 
 Decomposition preconditioners (see, e.g., [3, is a square, real or complex, sparse matrix. The name of the package comes from its original implementation, containing
-multi-level additive and hybrid Schwarz preconditioners, as well as one-level additive
+multilevel additive and hybrid Schwarz preconditioners, as well as one-level additive
 Schwarz preconditioners. The current version extends the original plan by including
-multi-level cycles and smoothers widely used in multigrid methods.
+multilevel cycles and smoothers widely used in multigrid methods.
 
 
    
-The multi-level preconditioners implemented in MLD2P4 are obtained by combining
+The multilevel preconditioners implemented in MLD2P4 are obtained by combining
 AMG cycles with smoothers and coarsest-level solvers. The V-, W-, and
 K-cycles [3,19] are available, which allow to define
-almost all the preconditioners in the package, including the multi-level hybrid
-Schwarz ones; a specific cycle is implemented to obtain multi-level additive
+almost all the preconditioners in the package, including the multilevel hybrid
+Schwarz ones; a specific cycle is implemented to obtain multilevel additive
 Schwarz preconditioners. The Jacobi, hybridforward/backward Gauss-Seidel, block-Jacobi, and additive Schwarz methods
 are available as smoothers. An algebraic approach is used to generate a hierarchy of
 coarse-level matrices and operators, without explicitly using any information on the
@@ -154,7 +154,7 @@ Section 7).
 
 
    
 We note that the user interface of MLD2P4 2.1 has been extended with respect to the
-previous versions in order to separate the construction of the multi-level hierarchy from
+previous versions in order to separate the construction of the multilevel hierarchy from
 the construction of the smoothers and solvers, and to allow for more flexibility
 at each level. The software architecture described in [8] has significantly
diff --git a/docs/html/node30.html b/docs/html/node30.html
index f599d623..70959564 100644
--- a/docs/html/node30.html
+++ b/docs/html/node30.html
@@ -56,121 +56,121 @@ Bibliography
 
 
    
 
    1
-
    
-P. R. Amestoy, C. Ashcraft, O. Boiteau, A. Buttari, J. L'Excellent, C. Weisbecker,
-Improving multifrontal methods by means of block low-rank representations,
-SIAM Journal on Scientific Computing, volume 37 (3), 2015, A1452-A1474.
-See also http://mumps.enseeiht.fr.

    2
-
    
-M. Brezina, P. Vanek,
-A Black-Box Iterative Solver Based on a Two-Level Schwarz Method,
-Computing, 63, 1999, 233-263.

    3
-
    
-W. L. Briggs, V. E. Henson, S. F. McCormick, 
-A Multigrid Tutorial, Second Edition,
-SIAM, 2000.

    4
-
    
-A. Buttari, P. D'Ambra, D. di Serafino, S. Filippone,
-Extending PSBLAS to Build Parallel Schwarz Preconditioners,
-in J. Dongarra, K. Madsen, J. Wasniewski, editors,
-Proceedings of PARA 04 Workshop on State of the Art
-in Scientific Computing, Lecture Notes in Computer Science,
-Springer, 2005, 593-602.

    5
-
     
-A. Buttari, P. D'Ambra, D. di Serafino, S. Filippone,
-2LEV-D2P4: a package of high-performance preconditioners
-for scientific and engineering applications,
-Applicable Algebra in Engineering, Communications and Computing, 
-18 (3) 2007, 223-239.

    6
-
    
-X. C. Cai, M. Sarkis,
-A Restricted Additive Schwarz Preconditioner for General Sparse Linear Systems,
-SIAM Journal on Scientific Computing, 21 (2), 1999, 792-797.

    7
-
    
-P. D'Ambra, S. Filippone,  D. di Serafino,
-On the Development of PSBLAS-based Parallel Two-level Schwarz Preconditioners,
-Applied Numerical Mathematics, Elsevier Science, 
-57 (11-12), 2007, 1181-1196.

    8
-
     
-P. D'Ambra, D. di Serafino, S. Filippone,
-MLD2P4: a Package of Parallel Multilevel
-Algebraic Domain Decomposition Preconditioners
-in Fortran 95,  ACM Trans. Math. Softw., 37(3), 2010, art. 30.

    9
-
    
-T. A. Davis, 
-Algorithm 832: UMFPACK - an Unsymmetric-pattern Multifrontal
-Method with a Column Pre-ordering Strategy,
-ACM Transactions on Mathematical Software, 30, 2004, 196-199.
-(See also http://www.cise.ufl.edu/ davis/)

    10
-
    
-J. W. Demmel, S. C. Eisenstat, J. R. Gilbert, X. S. Li, J. W. H. Liu,
-A supernodal approach to sparse partial pivoting,
-SIAM Journal on Matrix Analysis and Applications, 20 (3), 1999, 720-755.

    11
-
    
-J. J. Dongarra, J. Du Croz, I. S. Duff, S. Hammarling,
-A set of Level 3 Basic Linear Algebra Subprograms,
-ACM Transactions on Mathematical Software, 16 (1) 1990, 1-17.

    12
-
    
-J. J. Dongarra, J. Du Croz, S. Hammarling, R. J. Hanson,
-An extended set of FORTRAN Basic Linear Algebra Subprograms,
-ACM Transactions on Mathematical Software, 14 (1) 1988, 1-17.

    13
-
    
-S. Filippone, A. Buttari, 
-PSBLAS-3.0 User's Guide. A Reference Guide for the Parallel Sparse BLAS Library, 2012,
-available from http://www.ce.uniroma2.it/psblas/.

    14
-
    
-S. Filippone, A. Buttari,
-Object-Oriented Techniques for Sparse Matrix Computations in Fortran 2003.
-ACM Transactions on on Mathematical Software, 38 (4), 2012, art. 23.

    15
-
    
-S. Filippone, M. Colajanni, 
-PSBLAS: A Library for Parallel Linear Algebra
-Computation on Sparse Matrices,
-ACM Transactions on Mathematical Software, 26 (4), 2000, 527-550.

    16
-
    
-W. Gropp, S. Huss-Lederman, A. Lumsdaine, E. Lusk, B. Nitzberg, W. Saphir, M. Snir, 
-MPI: The Complete Reference. Volume 2 - The MPI-2 Extensions,
-MIT Press, 1998.

    17
-
    
-C. L. Lawson, R. J. Hanson, D. Kincaid, F. T. Krogh,
-Basic Linear Algebra Subprograms for FORTRAN usage,
-ACM Transactions on Mathematical Software, 5 (3), 1979, 308-323.

    18
-
    
-X. S. Li, J. W. Demmel,
-SuperLU_DIST: A Scalable Distributed-memory
-Sparse Direct Solver for Unsymmetric Linear Systems,
-ACM Transactions on Mathematical Software, 29 (2), 2003, 110-140.

    19
-
    
-Y. Notay, P. S. Vassilevski,
-Recursive Krylov-based multigrid cycles,
-Numerical Linear Algebra with Applications, 15 (5), 2008, 473-487. 

    20
-
    
-Y. Saad,
-Iterative methods for sparse linear systems, 2nd edition, SIAM, 2003.

    21
-
    
-B. Smith, P. Bjorstad, W. Gropp,
-Domain Decomposition: Parallel Multilevel Methods for Elliptic
-Partial Differential Equations,
-Cambridge University Press, 1996.

    22
-
    
-M. Snir, S. Otto, S. Huss-Lederman, D. Walker, J. Dongarra,
-MPI: The Complete Reference. Volume 1 - The MPI Core, second edition,
-MIT Press, 1998.

    23
-
    
-K. Stüben,
-An Introduction to Algebraic Multigrid,
-in A. Schüller, U. Trottenberg, C. Oosterlee, Multigrid,
-Academic Press, 2001.

    24
-
    
-R. S. Tuminaro, C. Tong,
-Parallel Smoothed Aggregation Multigrid: Aggregation Strategies on Massively Parallel Machines, in J. Donnelley, editor, Proceedings of SuperComputing 2000, Dallas, 2000.

    25
-
    
-P. Vanek, J. Mandel, M. Brezina,
-Algebraic Multigrid by Smoothed Aggregation for Second and Fourth Order Elliptic Problems,
+
    
+P. R. Amestoy, C. Ashcraft, O. Boiteau, A. Buttari, J. L'Excellent, C. Weisbecker,
+Improving multifrontal methods by means of block low-rank representations,
+SIAM Journal on Scientific Computing, volume 37 (3), 2015, A1452-A1474.
+See also http://mumps.enseeiht.fr.
    2
+
    
+M. Brezina, P. Vanek,
+A Black-Box Iterative Solver Based on a Two-Level Schwarz Method,
+Computing, 63, 1999, 233-263.
    3
+
    
+W. L. Briggs, V. E. Henson, S. F. McCormick, 
+A Multigrid Tutorial, Second Edition,
+SIAM, 2000.
    4
+
    
+A. Buttari, P. D'Ambra, D. di Serafino, S. Filippone,
+Extending PSBLAS to Build Parallel Schwarz Preconditioners,
+in J. Dongarra, K. Madsen, J. Wasniewski, editors,
+Proceedings of PARA 04 Workshop on State of the Art
+in Scientific Computing, Lecture Notes in Computer Science,
+Springer, 2005, 593-602.
    5
+
     
+A. Buttari, P. D'Ambra, D. di Serafino, S. Filippone,
+2LEV-D2P4: a package of high-performance preconditioners
+for scientific and engineering applications,
+Applicable Algebra in Engineering, Communications and Computing, 
+18 (3) 2007, 223-239.
    6
+
    
+X. C. Cai, M. Sarkis,
+A Restricted Additive Schwarz Preconditioner for General Sparse Linear Systems,
+SIAM Journal on Scientific Computing, 21 (2), 1999, 792-797.
    7
+
    
+P. D'Ambra, S. Filippone,  D. di Serafino,
+On the Development of PSBLAS-based Parallel Two-level Schwarz Preconditioners,
+Applied Numerical Mathematics, Elsevier Science, 
+57 (11-12), 2007, 1181-1196.
    8
+
     
+P. D'Ambra, D. di Serafino, S. Filippone,
+MLD2P4: a Package of Parallel Multilevel
+Algebraic Domain Decomposition Preconditioners
+in Fortran 95,  ACM Trans. Math. Softw., 37(3), 2010, art. 30.
    9
+
    
+T. A. Davis, 
+Algorithm 832: UMFPACK - an Unsymmetric-pattern Multifrontal
+Method with a Column Pre-ordering Strategy,
+ACM Transactions on Mathematical Software, 30, 2004, 196-199.
+(See also http://www.cise.ufl.edu/~davis/)
    10
+
    
+J. W. Demmel, S. C. Eisenstat, J. R. Gilbert, X. S. Li, J. W. H. Liu,
+A supernodal approach to sparse partial pivoting,
+SIAM Journal on Matrix Analysis and Applications, 20 (3), 1999, 720-755.
    11
+
    
+J. J. Dongarra, J. Du Croz, I. S. Duff, S. Hammarling,
+A set of Level 3 Basic Linear Algebra Subprograms,
+ACM Transactions on Mathematical Software, 16 (1) 1990, 1-17.
    12
+
    
+J. J. Dongarra, J. Du Croz, S. Hammarling, R. J. Hanson,
+An extended set of FORTRAN Basic Linear Algebra Subprograms,
+ACM Transactions on Mathematical Software, 14 (1) 1988, 1-17.
    13
+
    
+S. Filippone, A. Buttari, 
+PSBLAS 3.5.0 User's Guide. A Reference Guide for the Parallel Sparse BLAS Library, 2012,
+available from https://github.com/sfilippone/psblas3/tree/master/docs.
    14
+
    
+S. Filippone, A. Buttari,
+Object-Oriented Techniques for Sparse Matrix Computations in Fortran 2003.
+ACM Transactions on on Mathematical Software, 38 (4), 2012, art. 23.
    15
+
    
+S. Filippone, M. Colajanni, 
+PSBLAS: A Library for Parallel Linear Algebra
+Computation on Sparse Matrices,
+ACM Transactions on Mathematical Software, 26 (4), 2000, 527-550.
    16
+
    
+W. Gropp, S. Huss-Lederman, A. Lumsdaine, E. Lusk, B. Nitzberg, W. Saphir, M. Snir, 
+MPI: The Complete Reference. Volume 2 - The MPI-2 Extensions,
+MIT Press, 1998.
    17
+
    
+C. L. Lawson, R. J. Hanson, D. Kincaid, F. T. Krogh,
+Basic Linear Algebra Subprograms for FORTRAN usage,
+ACM Transactions on Mathematical Software, 5 (3), 1979, 308-323.
    18
+
    
+X. S. Li, J. W. Demmel,
+SuperLU_DIST: A Scalable Distributed-memory
+Sparse Direct Solver for Unsymmetric Linear Systems,
+ACM Transactions on Mathematical Software, 29 (2), 2003, 110-140.
    19
+
    
+Y. Notay, P. S. Vassilevski,
+Recursive Krylov-based multigrid cycles,
+Numerical Linear Algebra with Applications, 15 (5), 2008, 473-487. 
    20
+
    
+Y. Saad,
+Iterative methods for sparse linear systems, 2nd edition, SIAM, 2003.
    21
+
    
+B. Smith, P. Bjorstad, W. Gropp,
+Domain Decomposition: Parallel Multilevel Methods for Elliptic
+Partial Differential Equations,
+Cambridge University Press, 1996.
    22
+
    
+M. Snir, S. Otto, S. Huss-Lederman, D. Walker, J. Dongarra,
+MPI: The Complete Reference. Volume 1 - The MPI Core, second edition,
+MIT Press, 1998.
    23
+
    
+K. Stüben,
+An Introduction to Algebraic Multigrid,
+in A. Schüller, U. Trottenberg, C. Oosterlee, Multigrid,
+Academic Press, 2001.
    24
+
    
+R. S. Tuminaro, C. Tong,
+Parallel Smoothed Aggregation Multigrid: Aggregation Strategies on Massively Parallel Machines, in J. Donnelley, editor, Proceedings of SuperComputing 2000, Dallas, 2000.
    25
+
    
+P. Vanek, J. Mandel, M. Brezina,
+Algebraic Multigrid by Smoothed Aggregation for Second and Fourth Order Elliptic Problems,
 Computing, 56 (3) 1996, 179-196.
 
 
    
-
+
 
 
    
 
    
diff --git a/docs/html/node31.html b/docs/html/node31.html
index 13a02ef9..b5ab483b 100644
--- a/docs/html/node31.html
+++ b/docs/html/node31.html
@@ -63,7 +63,7 @@ Mathematics Department, Macquarie University, Sydney.
 The command line arguments were: 
    
  latex2html -local_icons -noaddress -dir ../../html userhtml.tex
 
    
-The translation was initiated by Salvatore Filippone on 2017-08-09
+The translation was initiated by Salvatore Filippone on 2017-09-15
 
    
 
 
diff --git a/docs/html/node4.html b/docs/html/node4.html
index c97dade1..d7cc508f 100644
--- a/docs/html/node4.html
+++ b/docs/html/node4.html
@@ -59,7 +59,7 @@ Code Distribution
 
 MLD2P4 is available from the web site 
 
-
    http://www.mld2p4.it
+
    https://github.com/sfilippone/mld2p4-2
 
    
 where contact points for further information can be also found.
 
diff --git a/docs/html/node7.html b/docs/html/node7.html
index cd53709f..8b5a5d6f 100644
--- a/docs/html/node7.html
+++ b/docs/html/node7.html
@@ -95,7 +95,7 @@ in the make.inc file of the LAPACK library.
  HREF="node30.html#PSBLASGUIDE">13,15] Parallel Sparse BLAS (PSBLAS) is
   available from www.ce.uniroma2.it/psblas; version
+  HREF="github.com/sfilippone/psblas3">github.com/sfilippone/psblas3; version
   3.5.0  (or later) is required. Indeed, all the prerequisites
   listed so far are also prerequisites of PSBLAS.
 
    
diff --git a/docs/html/node8.html b/docs/html/node8.html
index fc7bb0fd..c213c7e7 100644
--- a/docs/html/node8.html
+++ b/docs/html/node8.html
@@ -58,7 +58,7 @@ Optional third party libraries
 
    
 We provide interfaces to the following third-party software libraries;
 note that these are optional, but if you enable them some defaults
-for multi-level preconditioners may change to reflect their presence. 
+for multilevel preconditioners may change to reflect their presence. 
 
 
    
 
    
diff --git a/docs/html/node9.html b/docs/html/node9.html
index 0bec52db..58dd1969 100644
--- a/docs/html/node9.html
+++ b/docs/html/node9.html
@@ -225,7 +225,8 @@ Some influential environment variables:
 Use these variables to override the choices made by `configure' or to help
 it to find libraries and programs with nonstandard names/locations.
 
-Report bugs to <bugreport@mld2p4.it>.
+Report bugs to <pasqua.dambra@cnr.it; daniela.diserafino@unicampania.it;
+salvatore.filippone@cranfield.ac.uk>.

    For instance, if a user has built and installed PSBLAS 3.5 under the diff --git a/docs/html/userhtml.html b/docs/html/userhtml.html index dfbb0955..8be22a42 100644 --- a/docs/html/userhtml.html +++ b/docs/html/userhtml.html @@ -43,7 +43,7 @@ original version by: Nikos Drakos, CBLU, University of Leeds

    User's and Reference Guide     -
    A guide for the Multi-Level Domain Decomposition +
    A guide for the MultiLevel Domain Decomposition Parallel Preconditioners Package based on PSBLAS
    diff --git a/docs/mld2p4-2.1-guide.pdf b/docs/mld2p4-2.1-guide.pdf index d4c774f0..28e80ce9 100644 --- a/docs/mld2p4-2.1-guide.pdf +++ b/docs/mld2p4-2.1-guide.pdf @@ -10002,8 +10002,8 @@ endobj 681 0 obj << /Title (MultiLevel Domain Decomposition Parallel Preconditioners Package based on PSBLAS, V. 2.1) /Subject (MultiLevel Domain Decomposition Parallel Preconditioners Package) /Keywords (Parallel Numerical Software, Algebraic Multilevel Preconditioners, Sparse Iterative Solvers, PSBLAS, MPI) /Creator (pdfLaTeX) /Producer ($Id: userguide.tex 2008-04-08 Pasqua D'Ambra, Daniela di Serafino, Salvatore Filippone$) /Author()/Title()/Subject()/Creator(LaTeX with hyperref package)/Producer(pdfTeX-1.40.17)/Keywords() -/CreationDate (D:20170915113419+02'00') -/ModDate (D:20170915113419+02'00') +/CreationDate (D:20170915111631+01'00') +/ModDate (D:20170915111631+01'00') /Trapped /False /PTEX.Fullbanner (This is pdfTeX, Version 3.14159265-2.6-1.40.17 (TeX Live 2016) kpathsea version 6.2.2) >> @@ -10061,7 +10061,7 @@ endobj /W [1 3 1] /Root 680 0 R /Info 681 0 R -/ID [ ] +/ID [ ] /Length 3415 >> stream

    For the multi-level preconditioner, the level at which the + For the multilevel preconditioner, the level at which the preconditioner parameter has to be set. The levels are numbered in increasing order starting from the finest one, i.e., level 1 is the finest level. @@ -123,7 +123,7 @@ contained in val.
    For the multi-level preconditioner, when both + For the multilevel preconditioner, when both ilev and ilmax are present, the settings are applied at all levels ilev:ilmax. When ilev is present but ilmax is not, then @@ -164,14 +164,14 @@ by a suitable setting of the preconditioner parameters. These parameters can be logically divided into four groups, i.e., parameters defining
      -
    1. the type of multi-level cycle and how many cycles must be applied; +
    2. the type of multilevel cycle and how many cycles must be applied;
    3. the aggregation algorithm;
      4. -
    4. the coarse-space correction at the coarsest level (for multi-level +
    5. the coarse-space correction at the coarsest level (for multilevel preconditioners only);
      6. -
    6. the smoother of the multi-level preconditioners, or the one-level +
    7. the smoother of the multilevel preconditioners, or the one-level preconditioner.

      @@ -252,7 +252,7 @@ solver is changed to the default sequential solver.

      - - +
      Table 2: -Parameters defining the multi-level cycle and the number of cycles to +Parameters defining the multilevel cycle and the number of cycles to be applied.
      @@ -276,7 +276,7 @@ be applied.

      'ADD'

      		 'VCYCLE'Multi-level cycle: V-cycle, W-cycle, K-cycle, hybrid Multiplicative Schwarz, +Multilevel cycle: V-cycle, W-cycle, K-cycle, hybrid Multiplicative Schwarz, and Additive Schwarz.

      Note that hybrid Multiplicative Schwarz is equivalent to V-cycle and @@ -291,7 +291,7 @@ number $\ge 1$

      		 1Number of multi-level cycles.Number of multilevel cycles.
      @@ -533,12 +533,11 @@ level. Note that UMF and SLU require the coarsest matrix to be replicated, SLUDIST, JACOBI, GS and BJAC require it to be - distributed, MUMPS can be used with either + distributed, and MUMPS can be used with either a replicated or a distributed matrix. When any of the previous - solvers is specified, the matrix layout is set to a default - value - which allows the use - value UMFPACK and SuperLU_Dist + solvers is specified, the matrix layout is set to a default + value which allows the use of the solver (see Remark 3, p. 24). + Note also that UMFPACK and SuperLU_Dist are available only in double precision.
    'COARSE_SUBSOLVE' 'FBGS' Type of smoother used in the multi-level preconditioner: + Type of smoother used in the multilevel preconditioner: point-Jacobi, hybrid (forward) Gauss-Seidel, hybrid backward Gauss-Seidel, block-Jacobi, and Additive Schwarz. @@ -719,7 +718,7 @@ Parameters defining the smoother or the details of the one-level preconditioner. 'UMF' GS and BGS for pre- and post-smoothers - of multi-level preconditioners, respectively + of multilevel preconditioners, respectively

    ILU for block-Jacobi and Additive Schwarz one-level preconditioners @@ -754,7 +753,7 @@ Parameters defining the smoother or the details of the one-level preconditioner.

    		1 Number of sweeps of the smoother or one-level preconditioner. - In the multi-level case, no pre-smother or + In the multilevel case, no pre-smother or post-smoother is used if this parameter is set to 0 together with pos='PRE' or pos='POST, respectively.