From 2459441ca6ac298e3cfa3c75d55a2633c28b9a14 Mon Sep 17 00:00:00 2001 From: Salvatore Filippone Date: Tue, 1 Sep 2020 09:57:05 +0200 Subject: [PATCH] New license and docs --- LICENSE | 70 ++++++++++++++++++++++++-------------------------- LICENSE.MLD2P4 | 37 ++++++++++++++++++++++++++ README.md | 61 ++++++++++++------------------------------- 3 files changed, 88 insertions(+), 80 deletions(-) create mode 100644 LICENSE.MLD2P4 diff --git a/LICENSE b/LICENSE index 89dcff9b..8709dee3 100644 --- a/LICENSE +++ b/LICENSE @@ -1,37 +1,35 @@ - - - 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. - + + AMG4PSBLAS version 1.0 + Algebraic Multigrid Package + based on PSBLAS (Parallel Sparse BLAS version 3.7) + + (C) Copyright 2020 + + Salvatore Filippone + Pasqua D'Ambra + Fabio Durastante + + 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 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 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 + 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. diff --git a/LICENSE.MLD2P4 b/LICENSE.MLD2P4 new file mode 100644 index 00000000..89dcff9b --- /dev/null +++ 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. + diff --git a/README.md b/README.md index b0def0e7..fbea8c39 100644 --- 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