mirror of
https://github.com/sfilippone/amg4psblas.git
synced 2026-10-06 22:55:12 +00:00
Merge branch 'development' into cmake
This commit is contained in:
sfilippone
Binary file not shown.
@@ -31,7 +31,7 @@ class="cmr-12">University of Rome Tor-Vergata and IAC-CNR</span><br
|
||||
class="newline" /> <span
|
||||
class="cmr-12">Software version: 1.2</span><br
|
||||
class="newline" /><span
|
||||
class="cmr-12">December 31st, 2024</span>
|
||||
class="cmr-12">June 9th, 2025</span>
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -31,7 +31,7 @@ class="cmr-12">University of Rome Tor-Vergata and IAC-CNR</span><br
|
||||
class="newline" /> <span
|
||||
class="cmr-12">Software version: 1.2</span><br
|
||||
class="newline" /><span
|
||||
class="cmr-12">December 31st, 2024</span>
|
||||
class="cmr-12">June 9th, 2025</span>
|
||||
|
||||
|
||||
|
||||
|
||||
+54
-23
@@ -38,33 +38,35 @@ class="cmr-12">AMG4PSBLAS is available from the web site</span>
|
||||
href="https://psctoolkit.github.io/products/amg4psblas/" ><span
|
||||
class="cmr-12">https://psctoolkit.github.io/products/amg4psblas/</span></a></blockquote>
|
||||
<!--l. 10--><p class="noindent" ><span
|
||||
class="cmr-12">where contact points for further information can be also found.</span>
|
||||
<!--l. 12--><p class="indent" > <span
|
||||
class="cmr-12">The software is available under a modified BSD license, as specified in Appendix</span><span
|
||||
class="cmr-12">where contact points for further information can be also found. The software is available</span>
|
||||
<span
|
||||
class="cmr-12">under a modified BSD license, as specified in Appendix</span><span
|
||||
class="cmr-12"> </span><a
|
||||
href="userhtmlse8.html#x11-33000A"><span
|
||||
class="cmr-12">A</span><!--tex4ht:ref: sec:license --></a><span
|
||||
class="cmr-12">;</span>
|
||||
class="cmr-12">; please note that some of the</span>
|
||||
<span
|
||||
class="cmr-12">please note that some of the optional third party libraries may be licensed under a</span>
|
||||
class="cmr-12">optional third party libraries may be licensed under a different and more stringent</span>
|
||||
<span
|
||||
class="cmr-12">different and more stringent license, most notably the GPL, and this should be taken</span>
|
||||
class="cmr-12">license, most notably the GPL, and this should be taken into account when treating</span>
|
||||
<span
|
||||
class="cmr-12">into account when treating derived works.</span>
|
||||
<!--l. 18--><p class="indent" > <span
|
||||
class="cmr-12">derived works.</span>
|
||||
<!--l. 17--><p class="indent" > <span
|
||||
class="cmr-12">The library defines a version string with the constant</span>
|
||||
<div class="math-display" >
|
||||
<img
|
||||
src="userhtml1x.png" alt="amg_version_string_
|
||||
" class="math-display" ></div>
|
||||
<!--l. 20--><p class="nopar" > <span
|
||||
<!--l. 19--><p class="nopar" > <span
|
||||
class="cmr-12">whose current value is </span><span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-12">1.0</span></span></span><span
|
||||
class="cmtt-12">1.2</span></span></span><span
|
||||
class="cmr-12">.</span>
|
||||
<!--l. 23--><p class="noindent" >
|
||||
<!--l. 22--><p class="noindent" >
|
||||
<h4 class="likesubsectionHead"><a
|
||||
id="x5-5000"></a><span
|
||||
class="cmr-12">Contributors</span></h4>
|
||||
class="cmr-12">Development team</span></h4>
|
||||
<!--l. 23--><p class="noindent" ><span
|
||||
class="cmr-12">The main development team for AMG4PSBLAS is:</span>
|
||||
<ul class="itemize1">
|
||||
<li class="itemize">
|
||||
<!--l. 25--><p class="noindent" ><span
|
||||
@@ -77,27 +79,56 @@ class="cmr-12">Fabio Durastante, University of Pisa and IAC-CNR, IT;</span>
|
||||
<li class="itemize">
|
||||
<!--l. 27--><p class="noindent" ><span
|
||||
class="cmr-12">Salvatore Filippone, University of Rome Tor-Vergata and IAC-CNR, IT;</span></li></ul>
|
||||
<!--l. 29--><p class="noindent" ><span
|
||||
class="cmr-12">Other contributors:</span>
|
||||
|
||||
|
||||
|
||||
<div class="center"
|
||||
>
|
||||
<!--l. 30--><p class="noindent" >
|
||||
<div class="minipage"> <ul class="itemize1">
|
||||
<li class="itemize">
|
||||
<!--l. 33--><p class="noindent" ><span
|
||||
class="cmr-12">Luca Pep</span><span
|
||||
class="cmr-12">è Sciarria;</span>
|
||||
</li>
|
||||
<li class="itemize">
|
||||
<!--l. 34--><p class="noindent" ><span
|
||||
class="cmr-12">Andea Di Iorio;</span></li></ul> </div> <div class="minipage"> <ul class="itemize1">
|
||||
<li class="itemize">
|
||||
<!--l. 40--><p class="noindent" ><span
|
||||
class="cmr-12">Zaak Beekman;</span>
|
||||
</li>
|
||||
<li class="itemize">
|
||||
<!--l. 41--><p class="noindent" ><span
|
||||
class="cmr-12">Ambra Abdullahi Hassan.</span></li></ul> </div></div>
|
||||
<!--l. 45--><p class="noindent" >
|
||||
<h4 class="likesubsectionHead"><a
|
||||
id="x5-6000"></a><span
|
||||
class="cmr-12">Citing AMG4PSBLAS</span></h4>
|
||||
<!--l. 31--><p class="noindent" ><span
|
||||
class="cmr-12">When use the library, please cite the following:</span>
|
||||
<!--l. 46--><p class="noindent" ><span
|
||||
class="cmr-12">When using the library, please cite the following:</span>
|
||||
|
||||
|
||||
|
||||
<pre class="verbatim" id="verbatim-1">
|
||||
@article{DDF2021,
|
||||
       author = {D’Ambra, Pasqua and Durastante, Fabio and Filippone, Salvatore},
|
||||
       title = {{{AMG Preconditioners for Linear Solvers towards Extreme Scale}},
|
||||
       journal = {arXiv e-preprints},
|
||||
       eprint = {2006.16147v3},
|
||||
       archivePrefix = {arXiv},
|
||||
       year={2021}
|
||||
     }
|
||||
@article {MR4331965,
|
||||
     AUTHOR = {D’Ambra, Pasqua and Durastante, Fabio and Filippone, Salvatore},
|
||||
     TITLE = {A{MG} preconditioners for linear solvers towards extreme
|
||||
            scale},
|
||||
     JOURNAL = {SIAM J. Sci. Comput.},
|
||||
     FJOURNAL = {SIAM Journal on Scientific Computing},
|
||||
     VOLUME = {43},
|
||||
     YEAR = {2021},
|
||||
     NUMBER = {5},
|
||||
     PAGES = {S679--S703},
|
||||
     ISSN = {1064-8275,1095-7197},
|
||||
     MRCLASS = {65F50 (65F08 65F10 65N55 65Y05)},
|
||||
     MRNUMBER = {4331965},
|
||||
     MRREVIEWER = {Yongzhong\ Song},
|
||||
     DOI = {10.1137/20M134914X},
|
||||
}
|
||||
|
||||
@Misc{psctoolkit-web-page,
|
||||
       author = {D’Ambra, Pasqua and Durastante, Fabio and Filippone, Salvatore},
|
||||
@@ -107,7 +138,7 @@ class="cmr-12">When use the library, please cite the following:</span>
|
||||
       year = {2021}
|
||||
     }
|
||||
</pre>
|
||||
<!--l. 70--><p class="nopar" >
|
||||
<!--l. 92--><p class="nopar" >
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -790,15 +790,13 @@ class="cmr-12">In this particular example we are choosing to employ a </span><sp
|
||||
class="cmtt-12">HLG</span></span></span> <span
|
||||
class="cmr-12">data structure for</span>
|
||||
<span
|
||||
class="cmr-12">sparse matrices on GPUs; for more information please refer to the PSBLAS-EXT users’</span>
|
||||
class="cmr-12">sparse matrices on GPUs; for more information please refer to the PSBLAS users’</span>
|
||||
<span
|
||||
class="cmr-12">guide.</span>
|
||||
<!--l. 482--><p class="indent" > <span
|
||||
class="cmr-12">We then have to initialize the GPU environment, and pass the appropriate MOLD</span>
|
||||
<span
|
||||
class="cmr-12">variables to the build methods (see also the PSBLAS and PSBLAS-EXT users’</span>
|
||||
<span
|
||||
class="cmr-12">guides).</span>
|
||||
class="cmr-12">variables to the build methods (see also the PSBLAS users’ guide).</span>
|
||||
|
||||
|
||||
|
||||
@@ -914,8 +912,11 @@ class="cmtt-12">INVT</span></span></span>
|
||||
<li class="itemize">
|
||||
<!--l. 601--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-12">AINV</span></span></span></li></ul>
|
||||
</li></ul>
|
||||
<!--l. 604--><p class="noindent" ><span
|
||||
</li>
|
||||
<li class="itemize">
|
||||
<!--l. 603--><p class="noindent" ><span class="obeylines-h"><span class="verb"><span
|
||||
class="cmtt-12">POLY</span></span></span></li></ul>
|
||||
<!--l. 605--><p class="noindent" ><span
|
||||
class="cmr-12">and their </span><span
|
||||
class="cmmi-12">ℓ</span><sub><span
|
||||
class="cmr-8">1</span></sub> <span
|
||||
|
||||
@@ -1871,9 +1871,9 @@ class="cmr-10">Degree of the polynomial accelerator, is</span>
|
||||
<span
|
||||
class="cmr-10">equal to the number of matrix-vector</span>
|
||||
<span
|
||||
class="cmr-10">products performed by the smoother. Is</span>
|
||||
class="cmr-10">products performed by the smoother.</span>
|
||||
<span
|
||||
class="cmr-10">ignored if the smoother is not </span><code class="lstinline"><span style="color:#000000">’</span><span style="color:#000000">POLY</span><span style="color:#000000">’</span></code> </td>
|
||||
class="cmr-10">Ignored if the smoother is not </span><code class="lstinline"><span style="color:#000000">’</span><span style="color:#000000">POLY</span><span style="color:#000000">’</span></code> </td>
|
||||
</tr><tr
|
||||
class="hline"><td><hr></td><td><hr></td><td><hr></td><td><hr></td><td><hr></td></tr><tr
|
||||
style="vertical-align:baseline;" id="TBL-9-6-"><td style="white-space:normal; text-align:left;" id="TBL-9-6-1"
|
||||
|
||||
+67
-35
@@ -8,7 +8,6 @@ AMG4PSBLAS is available from the web site
|
||||
\href{https://psctoolkit.github.io/products/amg4psblas/}{https://psctoolkit.github.io/products/amg4psblas/}
|
||||
\end{quotation}
|
||||
where contact points for further information can be also found.
|
||||
|
||||
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
|
||||
@@ -18,47 +17,70 @@ account when treating derived works.
|
||||
The library defines a version string with the
|
||||
constant
|
||||
\[ \verb|amg_version_string_|\]
|
||||
whose current value is \verb|1.0|.
|
||||
whose current value is \verb|1.2|.
|
||||
|
||||
\subsection*{Contributors}
|
||||
\subsection*{Development team}
|
||||
The main development team for AMG4PSBLAS is:
|
||||
\begin{itemize}
|
||||
\item Pasqua D'Ambra, IAC-CNR, IT;
|
||||
\item Fabio Durastante, University of Pisa and IAC-CNR, IT;
|
||||
\item Salvatore Filippone, University of Rome Tor-Vergata and IAC-CNR, IT;
|
||||
\item Salvatore Filippone, University of Rome Tor-Vergata and IAC-CNR, IT;
|
||||
\end{itemize}
|
||||
|
||||
Other contributors:
|
||||
\begin{center}
|
||||
\begin{minipage}{.48\textwidth}
|
||||
\begin{itemize}
|
||||
\item Luca Pepè Sciarria;
|
||||
\item Andea Di Iorio;
|
||||
\end{itemize}
|
||||
\end{minipage}
|
||||
\hfill
|
||||
\begin{minipage}{.48\textwidth}
|
||||
\begin{itemize}
|
||||
\item Zaak Beekman;
|
||||
\item Ambra Abdullahi Hassan.
|
||||
\end{itemize}
|
||||
\end{minipage}
|
||||
\end{center}
|
||||
\subsection*{Citing AMG4PSBLAS}
|
||||
When use the library, please cite the following:
|
||||
When using the library, please cite the following:
|
||||
% \ifpdf
|
||||
% \begin{minted}[breakanywhere,fontsize=\small]{bibtex}
|
||||
% @article{DDF2021,
|
||||
% author = {D'Ambra, Pasqua and Durastante, Fabio and Filippone, Salvatore},
|
||||
% title = {{{AMG Preconditioners for Linear Solvers towards Extreme Scale}},
|
||||
% journal = {arXiv e-preprints},
|
||||
% eprint = {2006.16147v3},
|
||||
% archivePrefix = {arXiv},
|
||||
% year={2021}
|
||||
% }
|
||||
|
||||
\ifpdf
|
||||
\begin{minted}[breakanywhere,fontsize=\small]{bibtex}
|
||||
@article{DDF2021,
|
||||
author = {D'Ambra, Pasqua and Durastante, Fabio and Filippone, Salvatore},
|
||||
title = {{{AMG Preconditioners for Linear Solvers towards Extreme Scale}},
|
||||
journal = {arXiv e-preprints},
|
||||
eprint = {2006.16147v3},
|
||||
archivePrefix = {arXiv},
|
||||
year={2021}
|
||||
}
|
||||
|
||||
@Misc{psctoolkit-web-page,
|
||||
author = {D'Ambra, Pasqua and Durastante, Fabio and Filippone, Salvatore},
|
||||
title = {{PSCToolkit} {W}eb page},
|
||||
url = {https://psctoolkit.github.io/},
|
||||
howpublished = {\url{https://psctoolkit.github.io/}},
|
||||
year = {2021}
|
||||
}
|
||||
\end{minted}
|
||||
\else
|
||||
% @Misc{psctoolkit-web-page,
|
||||
% author = {D'Ambra, Pasqua and Durastante, Fabio and Filippone, Salvatore},
|
||||
% title = {{PSCToolkit} {W}eb page},
|
||||
% url = {https://psctoolkit.github.io/},
|
||||
% howpublished = {\url{https://psctoolkit.github.io/}},
|
||||
% year = {2021}
|
||||
% }
|
||||
% \end{minted}
|
||||
% \else
|
||||
\begin{verbatim}
|
||||
@article{DDF2021,
|
||||
author = {D'Ambra, Pasqua and Durastante, Fabio and Filippone, Salvatore},
|
||||
title = {{{AMG Preconditioners for Linear Solvers towards Extreme Scale}},
|
||||
journal = {arXiv e-preprints},
|
||||
eprint = {2006.16147v3},
|
||||
archivePrefix = {arXiv},
|
||||
year={2021}
|
||||
}
|
||||
@article {MR4331965,
|
||||
AUTHOR = {D'Ambra, Pasqua and Durastante, Fabio and Filippone, Salvatore},
|
||||
TITLE = {A{MG} preconditioners for linear solvers towards extreme
|
||||
scale},
|
||||
JOURNAL = {SIAM J. Sci. Comput.},
|
||||
FJOURNAL = {SIAM Journal on Scientific Computing},
|
||||
VOLUME = {43},
|
||||
YEAR = {2021},
|
||||
NUMBER = {5},
|
||||
PAGES = {S679--S703},
|
||||
ISSN = {1064-8275,1095-7197},
|
||||
MRCLASS = {65F50 (65F08 65F10 65N55 65Y05)},
|
||||
MRNUMBER = {4331965},
|
||||
MRREVIEWER = {Yongzhong\ Song},
|
||||
DOI = {10.1137/20M134914X},
|
||||
}
|
||||
|
||||
@Misc{psctoolkit-web-page,
|
||||
author = {D'Ambra, Pasqua and Durastante, Fabio and Filippone, Salvatore},
|
||||
@@ -68,4 +90,14 @@ When use the library, please cite the following:
|
||||
year = {2021}
|
||||
}
|
||||
\end{verbatim}
|
||||
\fi
|
||||
%\fi
|
||||
% @article{DDF2021,
|
||||
% author = {D'Ambra, Pasqua and Durastante, Fabio and Filippone, Salvatore},
|
||||
% title = {{{AMG Preconditioners for Linear Solvers towards Extreme Scale}},
|
||||
% journal = {arXiv e-preprints},
|
||||
% eprint = {2006.16147v3},
|
||||
% archivePrefix = {arXiv},
|
||||
% year={2021}
|
||||
% }
|
||||
|
||||
|
||||
|
||||
@@ -477,11 +477,11 @@ program amg_dexample_gpu
|
||||
\end{listing}
|
||||
In this particular example we are choosing to employ a \verb|HLG| data
|
||||
structure for sparse matrices on GPUs; for more information please
|
||||
refer to the PSBLAS-EXT users' guide.
|
||||
refer to the PSBLAS users' guide.
|
||||
|
||||
We then have to initialize the GPU environment, and pass the
|
||||
appropriate MOLD variables to the build methods (see also the PSBLAS
|
||||
and PSBLAS-EXT users' guides).
|
||||
users' guide).
|
||||
\begin{listing}[h!]
|
||||
\ifpdf
|
||||
\begin{minted}[breaklines=true,bgcolor=bg,fontsize=\small]{fortran}
|
||||
@@ -600,6 +600,7 @@ system solve kernels. Methods that satisfy this constraint include:
|
||||
\item \verb|INVT|
|
||||
\item \verb|AINV|
|
||||
\end{itemize}
|
||||
\item \verb|POLY|
|
||||
\end{itemize}
|
||||
and their $\ell_1$ variants.
|
||||
|
||||
|
||||
@@ -154,7 +154,7 @@ Preconditioners Package based on PSBLAS}
|
||||
\flushright
|
||||
\large Software version: 1.2\\
|
||||
%\todaym
|
||||
\large Deceber 31st, 2024
|
||||
\large June 9th, 2025
|
||||
\end{minipage}}
|
||||
%\addtolength{\textwidth}{\centeroffset}
|
||||
\vspace{\stretch{2}}
|
||||
|
||||
@@ -114,7 +114,7 @@
|
||||
%\today
|
||||
Software version: 1.2\\
|
||||
%\today
|
||||
December 31st, 2024
|
||||
June 9th, 2025
|
||||
\clearpage
|
||||
\ \\
|
||||
\thispagestyle{empty}
|
||||
|
||||
@@ -625,7 +625,7 @@ level (continued).\label{tab:p_coarse_1}}
|
||||
\fortinline|'POLY_DEGREE'| & \fortinline|integer|
|
||||
& Any integer \par number~$\ge 1$ and~$\le 30$
|
||||
& 1
|
||||
& Degree of the polynomial accelerator, is equal to the number of matrix-vector products performed by the smoother. Is ignored if the smoother is not \fortinline|'POLY'|\\ \hline
|
||||
& Degree of the polynomial accelerator, is equal to the number of matrix-vector products performed by the smoother. Ignored if the smoother is not \fortinline|'POLY'|\\ \hline
|
||||
\end{tabular}
|
||||
\end{center}
|
||||
\caption{Parameters defining the smoother or the details of the one-level preconditioner.
|
||||
|
||||
Reference in New Issue
Block a user