<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!-- Converted with LaTeX2HTML 2012 (1.2)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
< HTML >
< HEAD >
< TITLE > Subroutine build< / TITLE >
< META NAME = "description" CONTENT = "Subroutine build" >
< META NAME = "keywords" CONTENT = "userhtml" >
< META NAME = "resource-type" CONTENT = "document" >
< META NAME = "distribution" CONTENT = "global" >
< META NAME = "Generator" CONTENT = "LaTeX2HTML v2012" >
< META HTTP-EQUIV = "Content-Style-Type" CONTENT = "text/css" >
< LINK REL = "STYLESHEET" HREF = "userhtml.css" >
< LINK REL = "next" HREF = "node19.html" >
< LINK REL = "previous" HREF = "node17.html" >
< LINK REL = "up" HREF = "node15.html" >
< LINK REL = "next" HREF = "node19.html" >
< / HEAD >
< BODY >
<!-- Navigation Panel -->
< A NAME = "tex2html299"
HREF="node19.html">
< IMG WIDTH = "37" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "next" SRC = "next.png" > < / A >
< A NAME = "tex2html295"
HREF="node15.html">
< IMG WIDTH = "26" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "up" SRC = "up.png" > < / A >
< A NAME = "tex2html289"
HREF="node17.html">
< IMG WIDTH = "63" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "previous" SRC = "prev.png" > < / A >
< A NAME = "tex2html297"
HREF="node2.html">
< IMG WIDTH = "65" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "contents" SRC = "contents.png" > < / A >
< BR >
< B > Next:< / B > < A NAME = "tex2html300"
HREF="node19.html">Subroutine hierarchy_build< / A >
< B > Up:< / B > < A NAME = "tex2html296"
HREF="node15.html">User Interface< / A >
< B > Previous:< / B > < A NAME = "tex2html290"
HREF="node17.html">Subroutine set< / A >
< B > < A NAME = "tex2html298"
HREF="node2.html">Contents< / A > < / B >
< BR >
< BR >
<!-- End of Navigation Panel -->
< H2 > < A NAME = "SECTION00083000000000000000" > < / A > < A NAME = "sec:precbld" > < / A >
< BR >
Subroutine build
< / H2 > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < / FONT > < / FONT >
< P >
< FONT SIZE = "+1" > < FONT SIZE = "+1" > < / FONT > < / FONT >
< DIV ALIGN = "CENTER" > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < code > call p%build(a,desc_a,info)< / code >
< BR > < / FONT > < / FONT > < / FONT > < / DIV > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < / FONT > < / FONT >
< P >
< FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" >
This routine builds the one-level preconditioner < code > p< / code > according to the requirements
made by the user through the routines < code > init< / code > and < code > set< / code >
(see Sections < A HREF = "node19.html#sec:hier_bld" > 6.4< / A > and < A HREF = "node20.html#sec:smooth_bld" > 6.5< / A > for multi-level preconditioners).
< / FONT > < / FONT > < / FONT >
< P >
< FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < B > Arguments< / B > < / FONT > < / FONT > < / FONT > < / FONT >
< P > < / P >
< FONT SIZE = "+1" > < FONT SIZE = "+1" > < / FONT > < / FONT >
< P >
< FONT SIZE = "+1" > < FONT SIZE = "+1" > < / FONT > < / FONT > < TABLE CELLPADDING = 3 >
< TR > < TD ALIGN = "LEFT" VALIGN = "TOP" WIDTH = 34 > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" >
< code > a< / code > < / FONT > < / FONT > < / FONT > < / TD >
< TD ALIGN = "LEFT" VALIGN = "TOP" WIDTH = 340 > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < code > type(psb_< / code > < I > x< / I > < code > spmat_type), intent(in)< / code > . < / FONT > < / FONT > < / FONT > < / TD >
< / TR >
< TR > < TD ALIGN = "LEFT" VALIGN = "TOP" WIDTH = 34 > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" >
< / FONT > < / FONT > < / FONT > < / TD >
< TD ALIGN = "LEFT" VALIGN = "TOP" WIDTH = 340 > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" > The sparse matrix structure containing the local part of the
matrix to be preconditioned. Note that < I > x< / I > must be chosen according
to the real/complex, single/double precision version of MLD2P4 under use.
See the PSBLAS User's Guide for details [< A
HREF="node27.html#PSBLASGUIDE">13< / A > ].< / FONT > < / FONT > < / FONT > < / TD >
< / TR >
< TR > < TD ALIGN = "LEFT" VALIGN = "TOP" WIDTH = 34 > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" >
< code > desc_a< / code > < / FONT > < / FONT > < / FONT > < / TD >
< TD ALIGN = "LEFT" VALIGN = "TOP" WIDTH = 340 > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < code > type(psb_desc_type), intent(in)< / code > . < / FONT > < / FONT > < / FONT > < / TD >
< / TR >
< TR > < TD ALIGN = "LEFT" VALIGN = "TOP" WIDTH = 34 > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" >
< / FONT > < / FONT > < / FONT > < / TD >
< TD ALIGN = "LEFT" VALIGN = "TOP" WIDTH = 340 > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" > The communication descriptor of < code > a< / code > . See the PSBLAS User's Guide for
details [< A
HREF="node27.html#PSBLASGUIDE">13< / A > ].< / FONT > < / FONT > < / FONT > < / TD >
< / TR >
< TR > < TD ALIGN = "LEFT" VALIGN = "TOP" WIDTH = 34 > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < code > info< / code > < / FONT > < / FONT > < / FONT > < / TD >
< TD ALIGN = "LEFT" VALIGN = "TOP" WIDTH = 340 > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < code > integer, intent(out)< / code > .< / FONT > < / FONT > < / FONT > < / TD >
< / TR >
< TR > < TD ALIGN = "LEFT" VALIGN = "TOP" WIDTH = 34 > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" >
< / FONT > < / FONT > < / FONT > < / TD >
< TD ALIGN = "LEFT" VALIGN = "TOP" WIDTH = 340 > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" > Error code. If no error, 0 is returned. See Section < A HREF = "node25.html#sec:errors" > 8< / A > for details.< / FONT > < / FONT > < / FONT > < / TD >
< / TR >
< / TABLE > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < / FONT > < / FONT >
< P >
< FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" > For compatibility with the previous versions of MLD2P4, this routine can be also invoked
as follows:
< / FONT > < / FONT > < / FONT >
< P >
< FONT SIZE = "+1" > < FONT SIZE = "+1" > < / FONT > < / FONT >
< DIV ALIGN = "CENTER" > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < code > call mld_precbld(p,what,val,info)< / code >
< / FONT > < / FONT > < / FONT > < / DIV > < FONT SIZE = "+1" > < FONT SIZE = "+1" > < / FONT > < / FONT >
< P >
< FONT SIZE = "+1" > < FONT SIZE = "+1" > < FONT SIZE = "+1" >
In this case, the routine can be used to build multi-level preconditioners too.
< / FONT > < / FONT > < / FONT >
< P >
< FONT SIZE = "+1" > < FONT SIZE = "+1" > < / FONT > < / FONT >
< P >
< FONT SIZE = "+1" > < FONT SIZE = "+1" > < / FONT > < / FONT > < HR >
<!-- Navigation Panel -->
< A NAME = "tex2html299"
HREF="node19.html">
< IMG WIDTH = "37" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "next" SRC = "next.png" > < / A >
< A NAME = "tex2html295"
HREF="node15.html">
< IMG WIDTH = "26" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "up" SRC = "up.png" > < / A >
< A NAME = "tex2html289"
HREF="node17.html">
< IMG WIDTH = "63" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "previous" SRC = "prev.png" > < / A >
< A NAME = "tex2html297"
HREF="node2.html">
< IMG WIDTH = "65" HEIGHT = "24" ALIGN = "BOTTOM" BORDER = "0" ALT = "contents" SRC = "contents.png" > < / A >
< BR >
< B > Next:< / B > < A NAME = "tex2html300"
HREF="node19.html">Subroutine hierarchy_build< / A >
< B > Up:< / B > < A NAME = "tex2html296"
HREF="node15.html">User Interface< / A >
< B > Previous:< / B > < A NAME = "tex2html290"
HREF="node17.html">Subroutine set< / A >
< B > < A NAME = "tex2html298"
HREF="node2.html">Contents< / A > < / B >
<!-- End of Navigation Panel -->
< / BODY >
< / HTML >
