Merge mumps into trunk

docs/src/abstract.tex

@@ -17,7 +17,7 @@ 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 UMFPACK, SuperLU and SuperLU\_Dist, that
+such as UMFPACK, SuperLU, SuperLU\_Dist and MUMPS, that
 can be exploited in building multi-level preconditioners. The parallel
 implementation is based on a Single Program Multiple Data (SPMD)
 paradigm for distributed-memory architectures; the inter-process data

docs/src/bibliography.tex

@@ -84,6 +84,14 @@ Method with a Column Pre-ordering Strategy},
 ACM Transactions on Mathematical Software, 30, 2004, 196--199.
 (See also {\tt http://www.cise.ufl.edu/~davis/})
 %
+
+\bibitem{MUMPS}
+P.R.~Amestoy, C.~Ashcraft, O.~Boiteau, A.~Buttari, J.~L'Excellent, C.~Weisbecker 
+{\em Improving multifrontal methods by means of block low-rank representations},
+SIAM SISC, volume 37, number 3, pages A1452-A1474.
+(See also {\tt http://mumps.enseeiht.fr})
+%
+
 \bibitem{SUPERLU}
 J.W.~Demmel, S.C.~Eisenstat, J.R.~Gilbert, X.S.~Li and J.W.H.~Liu,
 A supernodal approach to sparse partial pivoting,

docs/src/building.tex

@@ -69,6 +69,14 @@ for multilevel preconditioners may change to reflect their presence.
    from the same site as SuperLU; provides parallel factorization and
    triangular system solution for double precision real and complex data.
    We have tested version 3.3 and 4.2.
+\item[MUMPS] \cite{MUMPS}
+  MUMPS (“MUltifrontal Massively Parallel Solver”) is a sparse, direct factorization 
+  package available from \\ 
+  \verb|http://mumps.enseeiht.fr/|.
+  It implements a direct method based on a multifrontal approach which performs 
+  a Gaussian factorization. 
+  We have tested versions 4.10.0 and version 5.0.1.  
+
 \end{description}
 \subsection{Configuration options}
 
@@ -222,6 +230,9 @@ generated the file \verb|Make.inc| which will then be used by all
 Makefiles in the directory tree; this file will be copied in the
 install directory under the name \verb|Make.inc.MLD2P4|.
 
+In order to use the MUMPS solver based on multifrontal factorization, the user has to add MUMPS flags, include directories and libraries in the Make.inc file.
+The necessary MUMPS libraries are \verb|-ldmumps, -lsmumps -lzmumps -lzmumps -mumps_common -lpord|. The flag \verb|-DHAVE_MUMPS_| is mandatory too. Since MUMPS uses openmp and ScaLAPACK, \verb|LINKOPT=-fonemp| must be added as well, along with the ScaLAPACK flags, include directories and library (which can be set using the configure script).
+
 To build the library the user will now enter 
 \begin{verbatim}
 make

docs/src/gettingstarted.tex

@@ -203,6 +203,9 @@ Figure~\ref{fig:ex_3lh} shows how to set a three-level hybrid Schwarz
 preconditioner, which uses block Jacobi with ILU(0) on the
 local blocks as post-smoother, has a coarsest matrix replicated on the processors,
 and solves the coarsest-level system with the LU factorization from UMFPACK~\cite{UMFPACK}.
+Figure~\ref{fig:ex_3lhm} shows how to set a three-level preconditioner similar to the one of ~\ref{fig:ex_3lh}, but the coarsest-level systems is solved with the multifrontal factorization from MUMPS~\cite{UMFPACK}. 
+Note that MUMPS can be used on both replicated and distributed coarsest level matrices, 
+as a global and local solver respectively.   
 The number of levels is specified by using \verb|mld_precinit|; the other
 preconditioner parameters are set by calling \verb|mld_precset|. Note that
 the type of multilevel framework (i.e.\ multiplicative among the levels
@@ -218,7 +221,7 @@ solver. Again, \verb|mld_precset| is used only to set
 non-default values of the parameters (see Tables~\ref{tab:p_type}-\ref{tab:p_coarse}).
 In both cases, the construction and the application of the preconditioner
 are carried out as for the default multi-level preconditioner.
-The code fragments shown in in Figures~\ref{fig:ex_3lh}-\ref{fig:ex_3la} are
+The code fragments shown in in Figures~\ref{fig:ex_3lh}~\ref{fig:ex_3lhm}-\ref{fig:ex_3la} are
 included in the example program file \verb|mld_dexample_ml.f90| too.
 
 Finally, Figure~\ref{fig:ex_1l} shows the setup of a one-level
@@ -263,6 +266,32 @@ boundary conditions are also available in the directory \verb|examples/pdegen|.
 \end{center}
 \end{figure}
 
+\begin{figure}[tbh]
+\begin{center}
+\begin{minipage}{.90\textwidth} 
+{\small
+\begin{verbatim}
+... ...
+! set a three-level hybrid Schwarz preconditioner, which uses
+! block Jacobi (with ILU(0) on the blocks) as post-smoother,
+! a coarsest matrix replicated on the processors, and the
+! multifrontal solver in MUMPS as coarse-level solver
+
+  call mld_precinit(P,'ML',info,nlev=3)
+  call mld_precset(P,mld_smoother_type_,'BJAC',info)
+  call mld_precset(P,mld_coarse_mat_,'REPL',info)
+  call mld_precset(P,mld_coarse_solve_,'MUMPS',info)
+
+... ...
+\end{verbatim}
+}
+\end{minipage}
+
+\caption{Setup of a hybrid three-level Schwarz preconditioner.\label{fig:ex_3lhm}}
+\end{center}
+\end{figure}
+
+
 \begin{figure}[tbh]
 \begin{center}
 \begin{minipage}{.90\textwidth}