mirror of
https://github.com/sfilippone/psblas3.git
synced 2026-10-12 00:49:05 +00:00
psblas3:
Documentation changes. We have barely begun.....
This commit is contained in:
+33
-37
@@ -26,26 +26,26 @@ original version by: Nikos Drakos, CBLU, University of Leeds
|
||||
|
||||
<BODY >
|
||||
<!--Navigation Panel-->
|
||||
<A NAME="tex2html196"
|
||||
<A NAME="tex2html194"
|
||||
HREF="node4.html">
|
||||
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
|
||||
<A NAME="tex2html192"
|
||||
<A NAME="tex2html190"
|
||||
HREF="userhtml.html">
|
||||
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
|
||||
<A NAME="tex2html186"
|
||||
<A NAME="tex2html184"
|
||||
HREF="node2.html">
|
||||
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
|
||||
<A NAME="tex2html194"
|
||||
<A NAME="tex2html192"
|
||||
HREF="node1.html">
|
||||
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
|
||||
<BR>
|
||||
<B> Next:</B> <A NAME="tex2html197"
|
||||
<B> Next:</B> <A NAME="tex2html195"
|
||||
HREF="node4.html">Basic Nomenclature</A>
|
||||
<B> Up:</B> <A NAME="tex2html193"
|
||||
<B> Up:</B> <A NAME="tex2html191"
|
||||
HREF="userhtml.html">userhtml</A>
|
||||
<B> Previous:</B> <A NAME="tex2html187"
|
||||
<B> Previous:</B> <A NAME="tex2html185"
|
||||
HREF="node2.html">Introduction</A>
|
||||
<B> <A NAME="tex2html195"
|
||||
<B> <A NAME="tex2html193"
|
||||
HREF="node1.html">Contents</A></B>
|
||||
<BR>
|
||||
<BR>
|
||||
@@ -71,22 +71,17 @@ influenced by the structure of the ScaLAPACK parallel
|
||||
library. The layered structure of the PSBLAS library
|
||||
is shown in figure <A HREF="#fig:psblas">1</A>; lower layers of the library
|
||||
indicate an encapsulation relationship with upper layers. The ongoing
|
||||
discussion focuses on the Fortran 95 layer immediately below the
|
||||
discussion focuses on the Fortran 2003 layer immediately below the
|
||||
application layer.
|
||||
The serial parts of the computation on each process are executed through
|
||||
calls to the serial sparse BLAS subroutines. In a similar way, the
|
||||
inter-process message exchanges are implemented through the Basic
|
||||
calls to the serial sparse BLAS subroutines.
|
||||
In a similar way, the inter-process message exchanges are encapsulated
|
||||
in an applicaiton layer that has been strongly inspired by the Basic
|
||||
Linear Algebra Communication Subroutines (BLACS) library [<A
|
||||
HREF="node108.html#BLACS">7</A>]
|
||||
that guarantees a portable and efficient communication layer. The
|
||||
Message Passing Interface code is encapsulated within the BLACS
|
||||
layer. However, in some cases, MPI routines are directly used either
|
||||
to improve efficiency or to implement communication patterns for which
|
||||
the BLACS package doesn't provide any method.
|
||||
|
||||
<P>
|
||||
In any case we provide wrappers around the BLACS routines so that the
|
||||
user does not need to delve into their details (see Sec. <A HREF="node73.html#sec:parenv">7</A>).
|
||||
HREF="node107.html#BLACS">7</A>].
|
||||
Usually there is no need to deal directly with MPI; however, in some
|
||||
cases, MPI routines are used directly to improve efficiency. For
|
||||
further details on our communication layer see Sec. <A HREF="node72.html#sec:parenv">7</A>.
|
||||
|
||||
<P>
|
||||
|
||||
@@ -135,13 +130,14 @@ is equivalent to a partition of the discretization mesh into <EM>sub-domains</EM
|
||||
Our library supports any distribution that keeps together
|
||||
the coefficients of each matrix row; there are no other constraints on
|
||||
the variable assignment.
|
||||
This choice is consistent with data distributions commonly used in
|
||||
ScaLAPACK such as <code>CYCLIC(N)</code> and <code>BLOCK</code>,
|
||||
This choice is consistent with simple data distributions
|
||||
such as <code>CYCLIC(N)</code> and <code>BLOCK</code>,
|
||||
as well as completely arbitrary assignments of
|
||||
equation indices to processes. In particular it is consistent with the
|
||||
equation indices to processes.
|
||||
In particular it is consistent with the
|
||||
usage of graph partitioning tools commonly available in the
|
||||
literature, e.g. METIS [<A
|
||||
HREF="node108.html#METIS">13</A>].
|
||||
HREF="node107.html#METIS">13</A>].
|
||||
Dense vectors conform to sparse
|
||||
matrices, that is, the entries of a vector follow the same distribution
|
||||
of the matrix rows.
|
||||
@@ -161,38 +157,38 @@ bottleneck would make this option unattractive in most cases.
|
||||
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
|
||||
|
||||
<UL>
|
||||
<LI><A NAME="tex2html198"
|
||||
<LI><A NAME="tex2html196"
|
||||
HREF="node4.html">Basic Nomenclature</A>
|
||||
<LI><A NAME="tex2html199"
|
||||
<LI><A NAME="tex2html197"
|
||||
HREF="node5.html">Library contents</A>
|
||||
<LI><A NAME="tex2html200"
|
||||
<LI><A NAME="tex2html198"
|
||||
HREF="node6.html">Application structure</A>
|
||||
<LI><A NAME="tex2html201"
|
||||
<LI><A NAME="tex2html199"
|
||||
HREF="node7.html">Programming model</A>
|
||||
</UL>
|
||||
<!--End of Table of Child-Links-->
|
||||
<HR>
|
||||
<!--Navigation Panel-->
|
||||
<A NAME="tex2html196"
|
||||
<A NAME="tex2html194"
|
||||
HREF="node4.html">
|
||||
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
|
||||
<A NAME="tex2html192"
|
||||
<A NAME="tex2html190"
|
||||
HREF="userhtml.html">
|
||||
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
|
||||
<A NAME="tex2html186"
|
||||
<A NAME="tex2html184"
|
||||
HREF="node2.html">
|
||||
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
|
||||
<A NAME="tex2html194"
|
||||
<A NAME="tex2html192"
|
||||
HREF="node1.html">
|
||||
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
|
||||
<BR>
|
||||
<B> Next:</B> <A NAME="tex2html197"
|
||||
<B> Next:</B> <A NAME="tex2html195"
|
||||
HREF="node4.html">Basic Nomenclature</A>
|
||||
<B> Up:</B> <A NAME="tex2html193"
|
||||
<B> Up:</B> <A NAME="tex2html191"
|
||||
HREF="userhtml.html">userhtml</A>
|
||||
<B> Previous:</B> <A NAME="tex2html187"
|
||||
<B> Previous:</B> <A NAME="tex2html185"
|
||||
HREF="node2.html">Introduction</A>
|
||||
<B> <A NAME="tex2html195"
|
||||
<B> <A NAME="tex2html193"
|
||||
HREF="node1.html">Contents</A></B>
|
||||
<!--End of Navigation Panel-->
|
||||
|
||||
|
||||
Reference in New Issue
Block a user