fdurastante/amg4psblas
1
0
Fork 0
mirror of https://github.com/sfilippone/amg4psblas.git synced 2026-10-06 14:44:55 +00:00
Code Issues Packages Projects Releases Wiki Activity

mld2p4:

Browse Source 
docs/pdf/building.tex
 docs/pdf/distribution.tex
 docs/pdf/license.tex
 docs/pdf/userinterface.tex
 examples
 examples/fileread
 examples/fileread/Makefile
 examples/fileread/data_input.f90
 examples/fileread/mld_dexample_1lev.f90
 examples/fileread/mld_dexample_ml.f90
 examples/fileread/runs
 examples/pdegen
 examples/pdegen/Makefile
 examples/pdegen/data_input.f90
 examples/pdegen/mld_dexample_1lev.f90
 examples/pdegen/mld_dexample_ml.f90
 examples/pdegen/runs
 test/fileread/Makefile
 test/fileread/df_bench.f90
 test/fileread/runs/drt.sh
 test/fileread/zf_bench.f90
 test/pargen/Makefile
 test/pargen/ppde.f90
 test/pargen/spde.f90

Added exampels directory. 
Cleaned up/aligned test/pargen.
Moved out Xf_bench to psb_bench.
This commit is contained in:
Salvatore Filippone
2008-07-19 15:22:51 +00:00
parent 23cdcff940
commit a9722dc049
19 changed files with 2274 additions and 1490 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/pdf/building.tex
+54 -4
View File
@@ -1,13 +1,63 @@
\section{Configuring and Building MLD2P4\label{sec:building}}
\markboth{\textsc{MLD2P4 User's and Reference Guide}}
{\textsc{\ref{sec:building} Configuring and Building MLD2P4}}
- uso di GNU autoconf e automake, con riferimento alla compilazione delle varie versioni
(reale/complessa, singola/doppia precisione) \\
- software di base (MPI, BLACS, BLAS, PSBLAS - specificare versioni)\\
To build MLD2P4 it is necessary to set up a Makefile with appropriate
values for your system; this is done by means of the \verb|configure|
script. The distribution also includes the autoconf and automake
sources employed to generate the script, but this should not normally
be needed to build the software.
MLD2P4 is implemented almost entirely in Fortran~95, with some
interfaces to external libraries in C; we require the Fortran compiler
to support the Fortran~95 standard plus the extension TR15581, which
enhances the usability of \verb|ALLOCATABLE| variables. Most modern
Fortran compilers, including the GNU Fortran compiler, support this
language level. The software defines data types and interfaces for
real and complex data, in both single and double precision.
\subsection{Prerequisites}
The following base libraries are needed:
\begin{description}
\item[BLAS] The Basic Linear Algebra subprograms. Many vendors provide
optimized versions; if no vendor version is available for a given
platform, the ATLAS software \verb!http://www.netlib.org/atlas!
may be employed. The reference BLAS from Netlib
\verb|htt://www.netlib.org/blas| are meant to define the standard
behaviour of the BLAS interface, so they not optimized for any
particular plaftorm, and they should only be used as a last
resort; note that BLAS computation form a relatively small part of
the MLD2P4/PSBLAS computations, except when using preconditioners
based on the UMFPACK or SuperLU third party libraries.
\item[MPI] A version of MPI is available on most high performance
computing system; we only require version 1.1.
\item[BLACS] The Basic Linear Algebra Communication Subroutines are
available in source form from \verb|http://www.netlib.org/blacs|;
some vendors include them in their parallel computing
support libraries.
\end{description}
The MLD2P4 software requires PSBLAS version 2.3 (at least), available
from \verb|http://www.ce.uniroma2.it/psblas|; indeed, all the
prerequisites listed so fare are also prerequisites of PSBLAS. Please
note that to build the MLD2P4 library it is necessary to get access to
the source PSBLAS directory used to build the version under use; after
the build process completes, only the compiled form of the library is
necessary to build user applications.
Please note that all the libraries listed so fare (BLAS, MPI, BLACS,
PSBLAS) must have Fortran interfaces compatible with the MLD2P4;
usually this means that they should all be built with the same
compiler.
\subsection{Optional third party libraries}
- software `third party" (UMFPACK, SuperLU, SuperLUdist - specificare versioni e opzioni di
configure, dire che UMFPACK e SuperLU sono richiesti, rispettivamente, dalle versioni in
singola ed in doppia precisione.)\\
- sistemi operativi e compilatori su cui MLD2P4 e' stato implementato con successo \\
\subsection{Configuration options}
- sistemi operativi e compilatori su cui MLD2P4 e' stato
implementato con successo \\
- sono previste opzioni di configurazione per il debugging o per il profiling? \\
- albero delle directory generato al momento dell'installazione, con brevissima
descrizione del contenuto delle directory - aggiungere la directory \texttt{examples}\\
docs/pdf/distribution.tex
+11 -2
View File
@@ -3,5 +3,14 @@
{\textsc{\ref{sec:distribution} Code Distribution}}
\noindent
- sito web sul quale e' disponibile il software\\
- modalita' di uso con cenno alla licenza (i dettagli sulla licenza vanno in appendice)
MLD2P4 is available from our project web site
\begin{quotation}
\tt http://www.mld2p4.it
\end{quotation}
where you will also find contact points for further information and
bug reports.
The software is available under a modified BSD license, as specified
in appendix~\ref{sec:license}; please note that some of the optional
third party libraries may be licensed under a different and more
stringent license.
docs/pdf/license.tex
+2 -2
View File
@@ -1,6 +1,6 @@
\section{License\label{sec:distribution}}
\section{License\label{sec:license}}
\markboth{\textsc{MLD2P4 User's and Reference Guide}}
{\textsc{\ref{sec:distribution} License}}
{\textsc{\ref{sec:license} License}}
The MLD2P4 is freely distributable under the following copyright
terms: {\small
docs/pdf/userinterface.tex
+7 -6
View File
@@ -57,8 +57,9 @@ according to the preconditioner type chosen by the user.
must be chosen according to the real/complex, single/double
precision version of MLD2P4 under use.\\
\verb|ptype| & \verb|character(len=*), intent(in)|.\\
& The type of preconditioner. Its values are specified in Table~\ref{tab:precinit}.\\
Note that the uppercase and lowercase letters can be used indifferently.\\
& The type of preconditioner. Its values are specified
in Table~\ref{tab:precinit}.\\
& Note that the strings are case insensitive.\\
\verb|info| & \verb|integer, intent(out)|.\\
& Error code. If no error, 0 is returned. See Section~\ref{sec:errors} for details.\\
\verb|nlev| & \verb|integer, optional, intent(in)|.\\
@@ -97,7 +98,7 @@ contained in \verb|val|.
values and the corresponding data types is given in
Tables~\ref{tab:p_type}-\ref{tab:p_coarse}.
When the value is of type \verb|character(len=*)|,
uppercase and lowercase letters can be used indifferently.\\
it is also treated as case insensitive.\\
\verb|info| & \verb|integer, intent(out)|.\\
& Error code. If no error, 0 is returned. See Section~\ref{sec:errors}
for details.\\
@@ -121,10 +122,10 @@ can be logically divided into four groups, i.e.\ parameters defining
\item the aggregation algorithm;
\item the coarse-space correction at the coarsest level.
\end{enumerate}
A list of the parameters that can be set, along with their allowed and
A list of the parameters that can be set, along with allowed and
default values, is given in Tables~\ref{tab:p_type}-\ref{tab:p_coarse}.
For a better understanding of the meaning of the parameters, the user
is referred to Section \ref{sec:background}.
For a detailed description of the meaning of the parameters, please
see Section~\ref{sec:background}.
%
%Note that the routine allows to set different features of the
%preconditioner at each level through the use of \verb|ilev|.