fdurastante
/
psblas3
mirror of https://github.com/sfilippone/psblas3.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Added various minor spell fixes.

Browse Source
psblas3-type-indexed
Salvatore Filippone 18 years ago
parent d665988606
commit 63c39fd0f2
5 changed files with 10610 additions and 10162 deletions
Show Stats Download Patch File Download Diff File

27
docs/pdf/datastruct.tex
Unescape Escape View File

@ -64,6 +64,9 @@ processes with which it is necessary to communicate:
The list may contain an arbitrary number of groups; its end is marked The list may contain an arbitrary number of groups; its end is marked
by a -1.\\ by a -1.\\
Specified as: an allocatable integer array of rank one. Specified as: an allocatable integer array of rank one.
\item[{\bf ext\_index}] A list of element indices to be exchanged to
implement the mapping between a base descriptor and a descriptor
with overlap.
\item [{\bf ovrlap\_index}] A list of the overlap elements for the \item [{\bf ovrlap\_index}] A list of the overlap elements for the
current process, organized in groups like the previous vector: current process, organized in groups like the previous vector:
\begin{enumerate} \begin{enumerate}
@ -76,7 +79,7 @@ current process, organized in groups like the previous vector:
The list may contain an arbitrary number of groups; its end is marked The list may contain an arbitrary number of groups; its end is marked
by a -1.\\ by a -1.\\
Specified as: an allocatable integer array of rank one. Specified as: an allocatable integer array of rank one.
\item [{\bf ovrlap\_index}] For all overlap points belonging to th \item [{\bf ovrlap\_elem}] For all overlap points belonging to th
ecurrent process: ecurrent process:
\begin{enumerate} \begin{enumerate}
\item Overlap point index; \item Overlap point index;
@ -90,7 +93,7 @@ global identifier of the local variable $i$.\\
Specified as: an allocatable integer array of rank one. Specified as: an allocatable integer array of rank one.
\item[{\bf glob\_to\_loc, glb\_lc, hashv}] Contain a mapping from \item[{\bf glob\_to\_loc, glb\_lc, hashv}] Contain a mapping from
global to local indices. The mapping may be stored in two different global to local indices. The mapping may be stored in two different
ways depending on the size of the index space. formats depending on the size of the index space.
\end{description} \end{description}
The Fortran95 definition for \verb|psb_desc_type| structures is The Fortran95 definition for \verb|psb_desc_type| structures is
as follows: as follows:
@ -99,7 +102,8 @@ as follows:
\begin{minipage}[tl]{0.9\textwidth} \begin{minipage}[tl]{0.9\textwidth}
\begin{verbatim} \begin{verbatim}
type psb_desc_type type psb_desc_type
integer, allocatable :: matrix_data(:), halo_index(:), ext_index(:) integer, allocatable :: matrix_data(:), halo_index(:)
integer, allocatable :: ext_index(:)
integer, allocatable :: overlap_elem(:), overlap_index(:) integer, allocatable :: overlap_elem(:), overlap_index(:)
integer, allocatable :: loc_to_glob(:), glob_to_loc(:) integer, allocatable :: loc_to_glob(:), glob_to_loc(:)
integer, allocatable :: hashv(:), glb_lc(:,:) integer, allocatable :: hashv(:), glb_lc(:,:)
@ -411,6 +415,23 @@ Specified as: a structured data of type \descdata.
\item[Function value] The number of global rows in the mesh \item[Function value] The number of global rows in the mesh
\end{description} \end{description}
\subsubroutine{psb\_cd\_get\_global\_cols}{Get number of global cols}
\syntax{nr = psb\_cd\_get\_global\_cols}{desc}
\begin{description}
\item[\bf On Entry]
\item[desc] the communication descriptor.\\
Scope:{\bf local}.\\
Type:{\bf required}.\\
Specified as: a structured data of type \descdata.
\end{description}
\begin{description}
\item[\bf On Return]
\item[Function value] The number of global cols in the mesh
\end{description}
\subsubroutine{psb\_cd\_get\_context}{Get communication context} \subsubroutine{psb\_cd\_get\_context}{Get communication context}
\syntax{ictxt = psb\_cd\_get\_context}{desc} \syntax{ictxt = psb\_cd\_get\_context}{desc}

8
docs/pdf/intro.tex
Unescape Escape View File

@ -24,8 +24,8 @@ In the current release we rely on the availability of the so-called
allocatable extensions, specified in TR~15581. Strictly speaking they allocatable extensions, specified in TR~15581. Strictly speaking they
are outside the Fortran~95 standard; however they have been included are outside the Fortran~95 standard; however they have been included
in the Fortran~2003 language standard, and are available in in the Fortran~2003 language standard, and are available in
prctically all Fortran~95 compilers on the market, including the GCC practically all Fortran~95 compilers on the market, including the GNU
compiler from the Free Software Foundation (as of version 4.2). Fortran compiler from the Free Software Foundation (as of version 4.2).
The presentation of the The presentation of the
PSBLAS library follows the general structure of the proposal for PSBLAS library follows the general structure of the proposal for
serial Sparse BLAS~\cite{sblas97,sblas02}, which in its turn is based on the serial Sparse BLAS~\cite{sblas97,sblas02}, which in its turn is based on the
@ -53,8 +53,8 @@ factor that affects efficiency of the implemented application. Optimal
data distribution requirements for a given preconditioner may conflict data distribution requirements for a given preconditioner may conflict
with distribution requirements of the rest of the solver. Finding the with distribution requirements of the rest of the solver. Finding the
optimal trade-off may be very difficult because it is application optimal trade-off may be very difficult because it is application
dependent. Possible solution to these problems and other important dependent. Possible solutions to these problems and other important
inputs to the development of the PSBLAS software package has come from inputs to the development of the PSBLAS software package have come from
an established experience in applying the PSBLAS solvers to an established experience in applying the PSBLAS solvers to
computational fluid dynamics applications. computational fluid dynamics applications.

2
docs/pdf/penv.tex
Unescape Escape View File

@ -41,7 +41,7 @@ Specified as: an integer variable.
\syntax{call psb\_info}{icontxt, iam, np} \syntax{call psb\_info}{icontxt, iam, np}
This subroutine returns informantion about the PSBLAS parallel environment, defining This subroutine returns information about the PSBLAS parallel environment, defining
a virtual parallel machine. a virtual parallel machine.
\begin{description} \begin{description}
\item[\bf On Entry ] \item[\bf On Entry ]

39
docs/pdf/toolsrout.tex
Unescape Escape View File

@ -14,7 +14,8 @@
This subroutine initializes the communication descriptor associated This subroutine initializes the communication descriptor associated
with an index space. Exactly one of the optional arguments with an index space. Exactly one of the optional arguments
\verb|parts|, \verb|vg|, \verb|vl| must be specified, thereby choosing \verb|parts|, \verb|vg|, \verb|vl| or \verb|nl|
must be specified, thereby choosing
the specific initialization strategy: the specific initialization strategy:
\begin{description} \begin{description}
\item[\bf On Entry ] \item[\bf On Entry ]
@ -109,7 +110,7 @@ An integer value; 0 means no error has been detected.
the sum of the sizes of the individual vectors \verb|vl| specified the sum of the sizes of the individual vectors \verb|vl| specified
on the calling processes. The subroutine will check that each entry on the calling processes. The subroutine will check that each entry
in the global index space $(1\dots mg)$ is specified exactly once. in the global index space $(1\dots mg)$ is specified exactly once.
\item[nl] In this case we are implying a generalize row-block \item[nl] In this case we are implying a generalized row-block
distribution in which each process $I$ gets assigned a consecutive distribution in which each process $I$ gets assigned a consecutive
chunk of $N_I=nl$ global indices. chunk of $N_I=nl$ global indices.
\end{description} \end{description}
@ -124,17 +125,24 @@ An integer value; 0 means no error has been detected.
\syntax{call psb\_cdins}{nz, ia, ja, desc\_a, info} \syntax{call psb\_cdins}{nz, ia, ja, desc\_a, info}
This subroutine examines the edges of the graph associated with the
discretization mesh (and isomorphic to the sparsity pattern of a
linear system coefficient matrix), storing them as necessary into the
communication descriptor. It automatically ignores edges that do not
insist on the current process, i.e. edges for which neither the starting
nor the end vertex belong to the current process.
\begin{description} \begin{description}
\item[\bf On Entry] \item[\bf On Entry]
\item[nz] the number of points being inserted.\\ \item[nz] the number of points being inserted.\\
Scope: {\bf local}.\\ Scope: {\bf local}.\\
Type: {\bf required}.\\ Type: {\bf required}.\\
Specified as: an integer value. Specified as: an integer value.
\item[ia] the row indices of the points being inserted.\\ \item[ia] the indices of the starting vertex of the edges being inserted.\\
Scope: {\bf local}.\\ Scope: {\bf local}.\\
Type: {\bf required}.\\ Type: {\bf required}.\\
Specified as: an integer array of length $nz$. Specified as: an integer array of length $nz$.
\item[ja] the column indices of the points being inserted.\\ \item[ja] the indices of the end vertex of the edges being inserted.\\
Scope: {\bf local}.\\ Scope: {\bf local}.\\
Type: {\bf required}.\\ Type: {\bf required}.\\
Specified as: an integer array of length $nz$. Specified as: an integer array of length $nz$.
@ -272,7 +280,7 @@ Specified as: a structured data type.
Scope:{\bf local}.\\ Scope:{\bf local}.\\
Type:{\bf required}.\\ Type:{\bf required}.\\
Specified as: a structured data of type \spdata. Specified as: a structured data of type \spdata.
\item[nl] the number of layers desired.\\ \item[nl] the number of additional layers desired.\\
Scope:{\bf global}.\\ Scope:{\bf global}.\\
Type:{\bf required}.\\ Type:{\bf required}.\\
Specified as: an integer value $nl\ge 0$. Specified as: an integer value $nl\ge 0$.
@ -296,6 +304,20 @@ Type: {\bf required} \\
An integer value; 0 means no error has been detected. An integer value; 0 means no error has been detected.
\end{description} \end{description}
\section*{Notes}
\begin{enumerate}
\item Specifying \verb|psb_ovt_xhal_| for the \verb|extype| argument
the user will obtain a descriptor for a domain partition in which
the additional layers are fetched as part of an (extended) halo;
however the index-to-process mapping is identical to that of the
base descriptor;
\item Specifying \verb|psb_ovt_asov_| for the \verb|extype| argument
the user will obtain a descriptor with an overlapped decomposition:
the additional layer is aggregated to the local subdomain (and thus
is an overlap), and a new halo extending beyond the last additional
layer is formed.
\end{enumerate}
%% % %% %
%% %% psb_cdren %% %% %% psb_cdren %%
@ -467,7 +489,9 @@ An integer value; 0 means no error has been detected.
\item If the descriptor is in the build state, then the sparse matrix \item If the descriptor is in the build state, then the sparse matrix
must also be in the build state; the action of the routine is to must also be in the build state; the action of the routine is to
(implicitly) call \verb|psb_cdins| to add entries to the sparsity (implicitly) call \verb|psb_cdins| to add entries to the sparsity
pattern; pattern; each sparse matrix entry implicitly defines a graph edge,
that is passed to the descriptor routine for the appropriate
processing.
\item If the descriptor is in the assembled state, then any entries in \item If the descriptor is in the assembled state, then any entries in
the sparse matrix that would generate additional communication the sparse matrix that would generate additional communication
requirements will be ignored; requirements will be ignored;
@ -945,7 +969,8 @@ Specified as: a structured data of type \descdata.
\item[iact] specifies action to be taken in case of range errors. \item[iact] specifies action to be taken in case of range errors.
Scope: {\bf global} \\ Scope: {\bf global} \\
Type: {\bf optional}\\ Type: {\bf optional}\\
Specified as: a character variable \verb|E|, \verb|W| or \verb|A|. Specified as: a character variable \verb|I|gnore, \verb|W|arning or
\verb|A|bort, default \verb|I|gnore.
\end{description} \end{description}
\begin{description} \begin{description}

20696
docs/userguide.pdf
View File

File diff suppressed because one or more lines are too long
Write Preview
Loading…
Cancel
Save