Fixed docs for new smoothers/solvers, updated Makefile

This commit is contained in:
Salvatore Filippone
2017-07-19 22:06:32 +01:00
parent 50ec525f48
commit ae8ac64d24
33 changed files with 3435 additions and 3088 deletions
+30 -30
View File
@@ -26,26 +26,26 @@ original version by: Nikos Drakos, CBLU, University of Leeds
<BODY >
<!--Navigation Panel-->
<A NAME="tex2html108"
<A NAME="tex2html110"
HREF="node4.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html104"
<A NAME="tex2html106"
HREF="userhtml.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html98"
<A NAME="tex2html100"
HREF="node2.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html106"
<A NAME="tex2html108"
HREF="node2.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html109"
<B> Next:</B> <A NAME="tex2html111"
HREF="node4.html">Code Distribution</A>
<B> Up:</B> <A NAME="tex2html105"
<B> Up:</B> <A NAME="tex2html107"
HREF="userhtml.html">userhtml</A>
<B> Previous:</B> <A NAME="tex2html99"
<B> Previous:</B> <A NAME="tex2html101"
HREF="node2.html">Contents</A>
&nbsp; <B> <A NAME="tex2html107"
&nbsp; <B> <A NAME="tex2html109"
HREF="node2.html">Contents</A></B>
<BR>
<BR>
@@ -60,9 +60,9 @@ General Overview
The M<SMALL>ULTI-</SMALL>L<SMALL>EVEL </SMALL>D<SMALL>OMAIN </SMALL>D<SMALL>ECOMPOSITION </SMALL>P<SMALL>ARALLEL </SMALL>P<SMALL>RECONDITIONERS </SMALL>P<SMALL>ACKAGE BASED ON
</SMALL>PSBLAS (MLD2P4) provides parallel Algebraic MultiGrid (AMG) and Domain
Decomposition preconditioners (see, e.g., [<A
HREF="node26.html#Briggs2000">3</A>,<A
HREF="node26.html#Stuben_01">23</A>,<A
HREF="node26.html#dd2_96">21</A>]),
HREF="node27.html#Briggs2000">3</A>,<A
HREF="node27.html#Stuben_01">23</A>,<A
HREF="node27.html#dd2_96">21</A>]),
to be used in the iterative solution of linear systems,
<BR>
<DIV ALIGN="RIGHT">
@@ -95,8 +95,8 @@ multi-level cycles and smoothers widely used in multigrid methods.
The multi-level preconditioners implemented in MLD2P4 are obtained by combining
AMG cycles with smoothers and coarsest-level solvers. The V-, W-, and
K-cycles&nbsp;[<A
HREF="node26.html#Briggs2000">3</A>,<A
HREF="node26.html#Notay2008">19</A>] are available, which allow to define
HREF="node27.html#Briggs2000">3</A>,<A
HREF="node27.html#Notay2008">19</A>] 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
Schwarz preconditioners. The Jacobi, hybridforward/backward Gauss-Seidel, block-Jacobi, and additive Schwarz methods
@@ -104,8 +104,8 @@ are available as smoothers. An algebraic approach is used to generate a hierarch
coarse-level matrices and operators, without explicitly using any information on the
geometry of the original problem, e.g., the discretization of a PDE. To this end,
the smoothed aggregation technique&nbsp;[<A
HREF="node26.html#BREZINA_VANEK">2</A>,<A
HREF="node26.html#VANEK_MANDEL_BREZINA">25</A>]
HREF="node27.html#BREZINA_VANEK">2</A>,<A
HREF="node27.html#VANEK_MANDEL_BREZINA">25</A>]
is applied. Either exact or approximate solvers can be used on the coarsest-level
system. Specifically, different sparse LU factorizations from external
packages, and native incomplete LU factorizations and Jacobi, hybrid Gauss-Seidel,
@@ -126,8 +126,8 @@ interface.
MLD2P4 has been designed to implement scalable and easy-to-use
multilevel preconditioners in the context of the PSBLAS (Parallel Sparse BLAS)
computational framework&nbsp;[<A
HREF="node26.html#psblas_00">15</A>,<A
HREF="node26.html#PSBLAS3">14</A>]. PSBLAS provides basic linear algebra
HREF="node27.html#psblas_00">15</A>,<A
HREF="node27.html#PSBLAS3">14</A>]. PSBLAS provides basic linear algebra
operators and data management facilities for distributed sparse matrices,
as well as parallel Krylov solvers which can be used with the MLD2P4 preconditioners.
The choice of PSBLAS has been mainly motivated by the need of having
@@ -150,14 +150,14 @@ few black-box routines at the upper layer allow all users to easily
build and apply any preconditioner available in MLD2P4;
facilities are also available allowing expert users to extend the set of smoothers
and solvers for building new versions of the preconditioners (see
Section&nbsp;<A HREF="#sec:adding"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>).
Section&nbsp;<A HREF="node24.html#sec:adding">7</A>).
<P>
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
the construction of the smoothers and solvers, and to allow for more flexibility
at each level. The software architecture described in&nbsp;[<A
HREF="node26.html#MLD2P4_TOMS">8</A>] has significantly
HREF="node27.html#MLD2P4_TOMS">8</A>] has significantly
evolved too, in order to fully exploit the Fortran&nbsp;2003 features implemented in PSBLAS 3.
However, compatibility with previous versions has been preserved.
@@ -171,34 +171,34 @@ preconditioners with the Krylov solvers implemented in PSBLAS are reported
in&nbsp;Section&nbsp;<A HREF="node13.html#sec:started">5</A>, where the Fortran codes of a few sample programs
are also shown. A reference guide for the user interface routines is provided
in Section&nbsp;<A HREF="node15.html#sec:userinterface">6</A>. Information on the extension of the package
through the addition of new smoothers and solvers is reported in Section&nbsp;<A HREF="#sec:adding"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>.
through the addition of new smoothers and solvers is reported in Section&nbsp;<A HREF="node24.html#sec:adding">7</A>.
The error handling mechanism used by the package
is briefly described in Section&nbsp;<A HREF="node24.html#sec:errors">7</A>. The copyright terms concerning the
distribution and modification of MLD2P4 are reported in Appendix&nbsp;<A HREF="node25.html#sec:license">A</A>.
is briefly described in Section&nbsp;<A HREF="node25.html#sec:errors">8</A>. The copyright terms concerning the
distribution and modification of MLD2P4 are reported in Appendix&nbsp;<A HREF="node26.html#sec:license">A</A>.
<P>
<HR>
<!--Navigation Panel-->
<A NAME="tex2html108"
<A NAME="tex2html110"
HREF="node4.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html104"
<A NAME="tex2html106"
HREF="userhtml.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html98"
<A NAME="tex2html100"
HREF="node2.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html106"
<A NAME="tex2html108"
HREF="node2.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html109"
<B> Next:</B> <A NAME="tex2html111"
HREF="node4.html">Code Distribution</A>
<B> Up:</B> <A NAME="tex2html105"
<B> Up:</B> <A NAME="tex2html107"
HREF="userhtml.html">userhtml</A>
<B> Previous:</B> <A NAME="tex2html99"
<B> Previous:</B> <A NAME="tex2html101"
HREF="node2.html">Contents</A>
&nbsp; <B> <A NAME="tex2html107"
&nbsp; <B> <A NAME="tex2html109"
HREF="node2.html">Contents</A></B>
<!--End of Navigation Panel-->