mirror of
https://github.com/sfilippone/amg4psblas.git
synced 2026-10-06 22:55:12 +00:00
mld2p4-2:
docs/html/userhtml.html docs/mld2p4-2.1-guide.pdf docs/src/abstract.tex docs/src/background.tex docs/src/bibliography.tex docs/src/building.tex docs/src/distribution.tex docs/src/gettingstarted.tex docs/src/overview.tex docs/src/userguide.tex docs/src/userinterface.tex mlprec/impl/mld_ccprecset.F90 mlprec/impl/mld_cprecset.F90 mlprec/impl/mld_csp_renum.f90 mlprec/impl/mld_dcprecset.F90 mlprec/impl/mld_dprecset.F90 mlprec/impl/mld_dsp_renum.f90 mlprec/impl/mld_scprecset.F90 mlprec/impl/mld_sprecset.F90 mlprec/impl/mld_ssp_renum.f90 mlprec/impl/mld_z_onelev_impl.f90 mlprec/impl/mld_zcprecset.F90 mlprec/impl/mld_zprecset.F90 mlprec/impl/mld_zsp_renum.f90 mlprec/mld_base_prec_type.F90 Take out SUB_REN. Update docs.
This commit is contained in:
+85
-27
@@ -7,8 +7,8 @@ original version by: Nikos Drakos, CBLU, University of Leeds
|
||||
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
|
||||
<HTML>
|
||||
<HEAD>
|
||||
<TITLE>Error Handling</TITLE>
|
||||
<META NAME="description" CONTENT="Error Handling">
|
||||
<TITLE>Adding smoothers and solvers to MLD2P4</TITLE>
|
||||
<META NAME="description" CONTENT="Adding smoothers and solvers to MLD2P4">
|
||||
<META NAME="keywords" CONTENT="userhtml">
|
||||
<META NAME="resource-type" CONTENT="document">
|
||||
<META NAME="distribution" CONTENT="global">
|
||||
@@ -26,53 +26,111 @@ original version by: Nikos Drakos, CBLU, University of Leeds
|
||||
|
||||
<BODY >
|
||||
<!--Navigation Panel-->
|
||||
<A NAME="tex2html374"
|
||||
<A NAME="tex2html385"
|
||||
HREF="node26.html">
|
||||
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
|
||||
<A NAME="tex2html370"
|
||||
<A NAME="tex2html381"
|
||||
HREF="userhtml.html">
|
||||
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
|
||||
<A NAME="tex2html364"
|
||||
<A NAME="tex2html375"
|
||||
HREF="node24.html">
|
||||
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
|
||||
<A NAME="tex2html372"
|
||||
<A NAME="tex2html383"
|
||||
HREF="node2.html">
|
||||
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
|
||||
<BR>
|
||||
<B> Next:</B> <A NAME="tex2html375"
|
||||
HREF="node26.html">License</A>
|
||||
<B> Up:</B> <A NAME="tex2html371"
|
||||
<B> Next:</B> <A NAME="tex2html386"
|
||||
HREF="node26.html">Error Handling</A>
|
||||
<B> Up:</B> <A NAME="tex2html382"
|
||||
HREF="userhtml.html">userhtml</A>
|
||||
<B> Previous:</B> <A NAME="tex2html365"
|
||||
HREF="node24.html">Subroutine mld_precdescr</A>
|
||||
<B> <A NAME="tex2html373"
|
||||
<B> Previous:</B> <A NAME="tex2html376"
|
||||
HREF="node24.html">Subroutine descr</A>
|
||||
<B> <A NAME="tex2html384"
|
||||
HREF="node2.html">Contents</A></B>
|
||||
<BR>
|
||||
<BR>
|
||||
<!--End of Navigation Panel-->
|
||||
|
||||
<H1><A NAME="SECTION00090000000000000000"></A><A NAME="sec:errors"></A>
|
||||
<H1><A NAME="SECTION00090000000000000000"></A><A NAME="sec:adding"></A>
|
||||
<BR>
|
||||
Error Handling
|
||||
Adding smoothers and solvers to MLD2P4
|
||||
</H1>
|
||||
|
||||
<P>
|
||||
The error handling in MLD2P4 is based on the PSBLAS (version 2) error
|
||||
handling. Error conditions are signaled via an integer argument
|
||||
<code>info</code>; whenever an error condition is detected, an error trace
|
||||
stack is built by the library up to the top-level, user-callable
|
||||
routine. This routine will then decide, according to the user
|
||||
preferences, whether the error should be handled by terminating the
|
||||
program or by returning the error condition to the user code, which
|
||||
will then take action, and whether
|
||||
an error message should be printed. These options may be set by using
|
||||
the PSBLAS error handling routines; for further details see the PSBLAS
|
||||
User's Guide [<A
|
||||
HREF="node27.html#PSBLASGUIDE">16</A>].
|
||||
<B>Da ampliare e completare - SALVATORE.</B>
|
||||
<BR>
|
||||
<P>
|
||||
Completely new smoother and/or solver classes derived from the
|
||||
base objects in the library may be used without recompiling the
|
||||
library itself. Once the new smoother/solver class has been
|
||||
developed, the user can declare a variable of that new type in the
|
||||
application, and pass that variable to the <code>p%set(solver,info)</code>
|
||||
call; the new solver object is then dynamically included in the
|
||||
preconditioner structure.
|
||||
|
||||
<P>
|
||||
|
||||
<BR>
|
||||
<P>
|
||||
If the user has developed a new type of smoother and/or
|
||||
solver by extending one of the base MLD2P4 types, and has declared a
|
||||
variable of the new type in the main program, it is possible to pass
|
||||
the new smoother/solver variable to the setup routine as follows:
|
||||
<DIV ALIGN="CENTER">
|
||||
<code>call p%set(smoother,info [,ilev, ilmax,pos])</code>
|
||||
<BR><code>call p%set(solver,info [,ilev, ilmax,pos])</code>
|
||||
|
||||
<BR><HR>
|
||||
</DIV>
|
||||
In this way, the variable will act as a <I>mold</I> to which the
|
||||
preconditioner will conform, even though the MLD2P4 library is not
|
||||
modified, and thus has no direct knowledge about the new type.
|
||||
|
||||
<P>
|
||||
|
||||
<BR>
|
||||
<P>
|
||||
<TABLE CELLPADDING=3>
|
||||
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=34><code>smoother</code></TD>
|
||||
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=340><code>class(mld_x_base_smoother_type)</code></TD>
|
||||
</TR>
|
||||
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=34> </TD>
|
||||
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=340>The user-defined new smoother to be employed in the
|
||||
preconditioner.</TD>
|
||||
</TR>
|
||||
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=34><code>solver</code></TD>
|
||||
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=340><code>class(mld_x_base_solver_type)</code></TD>
|
||||
</TR>
|
||||
<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=34> </TD>
|
||||
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=340>The user-defined new solver to be employed in the
|
||||
preconditioner.</TD>
|
||||
</TR>
|
||||
</TABLE>
|
||||
|
||||
<P>
|
||||
<HR>
|
||||
<!--Navigation Panel-->
|
||||
<A NAME="tex2html385"
|
||||
HREF="node26.html">
|
||||
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
|
||||
<A NAME="tex2html381"
|
||||
HREF="userhtml.html">
|
||||
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
|
||||
<A NAME="tex2html375"
|
||||
HREF="node24.html">
|
||||
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
|
||||
<A NAME="tex2html383"
|
||||
HREF="node2.html">
|
||||
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
|
||||
<BR>
|
||||
<B> Next:</B> <A NAME="tex2html386"
|
||||
HREF="node26.html">Error Handling</A>
|
||||
<B> Up:</B> <A NAME="tex2html382"
|
||||
HREF="userhtml.html">userhtml</A>
|
||||
<B> Previous:</B> <A NAME="tex2html376"
|
||||
HREF="node24.html">Subroutine descr</A>
|
||||
<B> <A NAME="tex2html384"
|
||||
HREF="node2.html">Contents</A></B>
|
||||
<!--End of Navigation Panel-->
|
||||
|
||||
</BODY>
|
||||
</HTML>
|
||||
|
||||
Reference in New Issue
Block a user