New license and docs

4 years ago · 2459441ca6
parent 5fb73c0070
commit 2459441ca6
3 changed files with 88 additions and 80 deletions
--- a/16
+++ b/16
@ -1,15 +1,14 @@
  
   
-                           MLD2P4  version 2.2
-  MultiLevel Domain Decomposition Parallel Preconditioners Package
-             based on PSBLAS (Parallel Sparse BLAS version 3.5)
+                             AMG4PSBLAS version 1.0
+    Algebraic Multigrid Package
+               based on PSBLAS (Parallel Sparse BLAS version 3.7)
    
-  (C) Copyright 2008-2018
+    (C) Copyright 2020 
  
        Salvatore Filippone  
        Pasqua D'Ambra   
-      Daniela di Serafino   
-
+        Fabio Durastante        
   
    Redistribution and use in source and binary forms, with or without
    modification, are permitted provided that the following conditions
@ -19,14 +18,14 @@
      2. Redistributions in binary form must reproduce the above copyright
         notice, this list of conditions, and the following disclaimer in the
         documentation and/or other materials provided with the distribution.
-    3. The name of the MLD2P4 group or the names of its contributors may
+      3. The name of the AMG4PSBLAS group or the names of its contributors may
         not be used to endorse or promote products derived from this
         software without specific written permission.
   
    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
    ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
    TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-  PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE MLD2P4 GROUP OR ITS CONTRIBUTORS
+    PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AMG4PSBLAS GROUP OR ITS CONTRIBUTORS
    BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
    CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
    SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
@ -34,4 +33,3 @@
    CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
    ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
    POSSIBILITY OF SUCH DAMAGE.
- 
--- a/LICENSE.MLD2P4
+++ b/LICENSE.MLD2P4
@ -0,0 +1,37 @@
+
+ 
+                           MLD2P4  version 2.2
+  MultiLevel Domain Decomposition Parallel Preconditioners Package
+             based on PSBLAS (Parallel Sparse BLAS version 3.5)
+  
+  (C) Copyright 2008-2018
+
+      Salvatore Filippone  
+      Pasqua D'Ambra   
+      Daniela di Serafino   
+
+ 
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions
+  are met:
+    1. Redistributions of source code must retain the above copyright
+       notice, this list of conditions and the following disclaimer.
+    2. Redistributions in binary form must reproduce the above copyright
+       notice, this list of conditions, and the following disclaimer in the
+       documentation and/or other materials provided with the distribution.
+    3. The name of the MLD2P4 group or the names of its contributors may
+       not be used to endorse or promote products derived from this
+       software without specific written permission.
+ 
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+  ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+  TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+  PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE MLD2P4 GROUP OR ITS CONTRIBUTORS
+  BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+  POSSIBILITY OF SUCH DAMAGE.
+ 
--- a/README.md
+++ b/README.md
@ -1,41 +1,24 @@

-                         MLD2P4  
-MultiLevel Domain Decomposition Parallel Preconditioners Package
-           based on PSBLAS (Parallel Sparse BLAS version 3.5)
+                         AMG4PSBLAS  
+ Algebraic Multigrid Package  based on PSBLAS (Parallel Sparse BLAS version 3.7)
    
-Salvatore Filippone    (Cranfield University, UK)
+Salvatore Filippone    (University of Rome Tor Vergata and IAC-CNR)
 Pasqua D'Ambra         (IAC-CNR, Naples, IT)
-Daniela di Serafino    (Univ. of Campania "L. Vanvitelli", Caserta, IT)
+Fabio Durastante       (IAC-CNR, Naples, IT)

 ---------------------------------------------------------------------

-MLD2P4 (MultiLevel Domain Decomposition Parallel Preconditioners
-Package based on PSBLAS) provides parallel Algebraic MultiGrid (AMG)
-and Domain Decomposition preconditioners, to be used in the
-iterative solution of linear systems.
-
-The name of the package comes from its original implementation,
-containing multilevel additive and hybrid Schwarz preconditioners,
-as well as one-level additive Schwarz preconditioners. The current
-version extends the original plan by including multilevel cycles
-and smoothers widely used in multigrid methods. A purely algebraic
-approach is applied to generate coarse-level corrections, so that
-no geometric background is needed concerning the matrix to be
-preconditioned.
-
-MLD2P4 has been designed to provide scalable and easy-to-use 
-preconditioners in the context of the PSBLAS (Parallel Sparse Basic
-Linear Algebra Subprograms) computational framework and is used
-in conjuction with the Krylov solvers available from PSBLAS. 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
-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.
-
-
-MAIN REFERENCE:
+AMG4PSBLAS is a package of Algebraic MultiGrid (AMG)
+preconditioners for  the iterative solution of large and sparse linear systems.
+
+It is an evolution of MLD2P4 (see LICENSE.MLD2P4), but it has been
+thoroughly reworked, and it is sufficiently different to warrant a new
+project name.
+
+
+MAIN REFERENCES:
+
+     

 P. D'Ambra, D. di Serafino, S. Filippone,
 MLD2P4: a Package of Parallel Algebraic Multilevel Domain Decomposition
@ -64,19 +47,9 @@ NOTES
  the corresponding preconditioner options will be available only from
  the double precision version.

- The preconditioners in MLD2P4 extend those of PSBLAS and are meant
-  to be used with the PSBLAS Krylov solvers; so in an existing program
-  you need to modify the type of the preconditioner object and its
-  settings, but the rest of the application needs not be changed. 
-   

-The MLD2P4 team. 
+The AMG4PSBLAS team. 
 ---------------
-Project lead:
 Salvatore Filippone
-
-Contributors:
 Pasqua     D'Ambra
-Daniela    di Serafino
-Ambra	   Abdullahi Hassan
-Alfredo    Buttari
+Fabio     Durastante