|
|
|
\documentclass[a4paper,twoside,11pt]{article}
|
|
|
|
\usepackage{pstricks}
|
|
|
|
\usepackage{fancybox}
|
|
|
|
\usepackage{amsfonts}
|
|
|
|
\usepackage{ifpdf}
|
|
|
|
% \usepackage{minitoc}
|
|
|
|
% \setcounter{minitocdepth}{2}
|
|
|
|
\usepackage[bookmarks=true,
|
|
|
|
bookmarksnumbered=true,
|
|
|
|
bookmarksopen=false,
|
|
|
|
plainpages=false,
|
|
|
|
pdfpagelabels,
|
|
|
|
colorlinks,
|
|
|
|
linkcolor=blue]{hyperref}
|
|
|
|
\usepackage{ifthen}
|
|
|
|
\usepackage{graphicx}
|
|
|
|
\newtheorem{theorem}{Theorem}
|
|
|
|
\newtheorem{corollary}{Corollary}
|
|
|
|
\usepackage{rotating}
|
|
|
|
%\newboolean{mtc}
|
|
|
|
%\setboolean{mtc}{true}
|
|
|
|
|
|
|
|
\pdfoutput=0
|
|
|
|
% \relax
|
|
|
|
% \pdfcompresslevel=0 %-- 0 = none, 9 = best
|
|
|
|
% \pdfinfo{ %-- Info dictionary of PDF output /Author (PD, DdS, SF)
|
|
|
|
% /Title (MultiLevel Domain Decomposition Parallel Preconditioners Package
|
|
|
|
% based on PSBLAS, V. 1.0)
|
|
|
|
% /Subject (MultiLevel Domain Decomposition Parallel Preconditioners Package)
|
|
|
|
% /Keywords (Parallel Numerical Software, Algebraic Multilevel Preconditioners, Sparse Iterative Solvers, PSBLAS, MPI)
|
|
|
|
% /Creator (pdfLaTeX)
|
|
|
|
% /Producer ($Id: userguide.tex 2008-04-08 Pasqua D'Ambra, Daniela di Serafino,
|
|
|
|
% Salvatore Filippone$)
|
|
|
|
% }
|
|
|
|
% \pdfcatalog{ %-- Catalog dictionary of PDF output.
|
|
|
|
% % /URI (http://ce.uniroma2.it/psblas)
|
|
|
|
% }
|
|
|
|
|
|
|
|
\setlength\textwidth{1.15\textwidth}
|
|
|
|
% \setlength\evensidemargin{.7in}
|
|
|
|
% \newlength{\centeroffset}
|
|
|
|
% \setlength{\centeroffset}{0.5\oddsidemargin}
|
|
|
|
% \addtolength{\centeroffset}{0.5\evensidemargin}
|
|
|
|
% \addtolength{\textwidth}{-\centeroffset}
|
|
|
|
\pagestyle{myheadings}
|
|
|
|
|
|
|
|
\newcounter{subroutine}[subsection]
|
|
|
|
\newcounter{example}[subroutine]
|
|
|
|
\makeatletter
|
|
|
|
\def\subroutine{\@ifstar{\@subroutine}{\clearpage\@subroutine}}%
|
|
|
|
\def\@subroutine#1#2{%
|
|
|
|
\stepcounter{subroutine}%
|
|
|
|
\section*{\flushleft #1---#2 \endflushleft}%
|
|
|
|
\addcontentsline{toc}{subsection}{#1}%
|
|
|
|
\markright{#1}}%
|
|
|
|
\newcommand{\subsubroutine}[2]{%
|
|
|
|
\stepcounter{subroutine}%
|
|
|
|
\subsection*{\flushleft #1---#2 \endflushleft}%
|
|
|
|
\addcontentsline{toc}{subsubsection}{#1}%
|
|
|
|
\markright{#1}}%
|
|
|
|
\newcommand{\examplename}{Example}
|
|
|
|
\newcommand{\syntaxname}{Syntax}
|
|
|
|
\def\syntax{\@ifstar{\@ssyntax}{\@syntax}}%
|
|
|
|
\def\@syntax{\nobreak\section*{\syntaxname}%
|
|
|
|
\@ssyntax}%
|
|
|
|
\def\@ssyntax#1#2{%
|
|
|
|
\nobreak
|
|
|
|
\setbox\@tempboxa\hbox{#1\ {\em $($#2$)$}}%
|
|
|
|
\ifdim \wd\@tempboxa >\hsize
|
|
|
|
\setbox\@tempboxa\hbox{\em $($#2$)$}
|
|
|
|
\ifdim\wd\@tempboxa >\hsize
|
|
|
|
\begin{flushright}#1\ \em$($#2$)$\end{flushright}%
|
|
|
|
\else
|
|
|
|
\hbox to\hsize{#1\hfil}%
|
|
|
|
\hbox to\hsize{\hfil\box\@tempboxa}%
|
|
|
|
\fi
|
|
|
|
\else
|
|
|
|
\hbox to\hsize{\hfil\box\@tempboxa\hfil}%
|
|
|
|
\fi\par\vskip\baselineskip}
|
|
|
|
\makeatother
|
|
|
|
\newcommand{\example}{\stepcounter{example}%
|
|
|
|
\section*{\examplename~\theexample}}
|
|
|
|
\def\bsideways{\begin{table}}
|
|
|
|
\def\esideways{\end{table}}
|
|
|
|
|
|
|
|
\newcommand{\precdata}{\hyperlink{precdata}{{\tt mld\_prec\_type}}}
|
|
|
|
\newcommand{\descdata}{\hyperlink{descdata}{{\tt psb\_desc\_type}}}
|
|
|
|
\newcommand{\spdata}{\hyperlink{spdata}{{\tt psb\_spmat\_type}}}
|
|
|
|
\newcommand{\Ref}[1]{\mbox{(\ref{#1})}}
|
|
|
|
|
|
|
|
\begin{document}
|
|
|
|
{\Large\bfseries MLD2P4\\[.8ex] User's and Reference Guide}\\
|
|
|
|
\emph{\large A guide for the Multi-Level Domain Decomposition \\[.6ex]
|
|
|
|
Parallel Preconditioners Package
|
|
|
|
based on PSBLAS}
|
|
|
|
{\bfseries Pasqua D'Ambra}\\
|
|
|
|
ICAR-CNR, Naples, Italy\\[3ex]
|
|
|
|
{\bfseries Daniela di Serafino}\\
|
|
|
|
Second University of Naples, Italy\\[3ex]
|
|
|
|
{\bfseries Salvatore Filippone} \\
|
|
|
|
University of Rome ``Tor Vergata'', Italy
|
|
|
|
%\\[10ex]
|
|
|
|
%\today
|
|
|
|
Software version: 1.0\\
|
|
|
|
%\today
|
|
|
|
July 24, 2008
|
|
|
|
\clearpage
|
|
|
|
\ \\
|
|
|
|
\thispagestyle{empty}
|
|
|
|
\clearpage
|
|
|
|
|
|
|
|
\pagenumbering{roman} % Roman numbering
|
|
|
|
\setcounter{page}{1} % Abstract start on page i
|
|
|
|
|
|
|
|
\include{abstract}
|
|
|
|
\cleardoublepage
|
|
|
|
|
|
|
|
\begingroup
|
|
|
|
\renewcommand*{\thepage}{toc}
|
|
|
|
%\pagenumbering{roman} % Roman numbering
|
|
|
|
%\setcounter{page}{1} % Abstract start on page ii
|
|
|
|
\tableofcontents
|
|
|
|
\endgroup
|
|
|
|
\cleardoublepage
|
|
|
|
|
|
|
|
\pagenumbering{arabic} % Arabic numbering
|
|
|
|
\setcounter{page}{1} % Chapters start on page 1
|
|
|
|
|
|
|
|
\include{overview}
|
|
|
|
\include{distribution}
|
|
|
|
\include{building}
|
|
|
|
\include{background}
|
|
|
|
\include{gettingstarted}
|
|
|
|
\include{userinterface}
|
|
|
|
%\include{advanced}
|
|
|
|
\include{errors}
|
|
|
|
%\include{listofroutines}
|
|
|
|
\cleardoublepage
|
|
|
|
\appendix
|
|
|
|
\include{license}
|
|
|
|
\cleardoublepage
|
|
|
|
\include{bibliography}
|
|
|
|
|
|
|
|
|
|
|
|
\end{document}
|
|
|
|
%%% Local Variables:
|
|
|
|
%%% mode: latex
|
|
|
|
%%% TeX-master: 'userguide'
|
|
|
|
%%% End:
|