Statistiques
| Révision :

root / www / HPL_indxg2lp.html

Historique | Voir | Annoter | Télécharger (2,53 ko)

1 1 equemene
<HTML>
2 1 equemene
<HEAD>
3 1 equemene
<TITLE>HPL_indxg2lp HPL 2.0 Library Functions September 10, 2008</TITLE>
4 1 equemene
</HEAD>
5 1 equemene
6 1 equemene
<BODY BGCOLOR="WHITE" TEXT = "#000000" LINK = "#0000ff" VLINK = "#000099"
7 1 equemene
      ALINK = "#ffff00">
8 1 equemene
9 1 equemene
<H1>Name</H1>
10 1 equemene
<B>HPL_indxg2lp</B> Map a local index into a global one.
11 1 equemene
12 1 equemene
<H1>Synopsis</H1>
13 1 equemene
<CODE>#include "hpl.h"</CODE><BR><BR>
14 1 equemene
<CODE>void</CODE>
15 1 equemene
<CODE>HPL_indxg2lp(</CODE>
16 1 equemene
<CODE>int *</CODE>
17 1 equemene
<CODE>IL</CODE>,
18 1 equemene
<CODE>int *</CODE>
19 1 equemene
<CODE>PROC</CODE>,
20 1 equemene
<CODE>const int</CODE>
21 1 equemene
<CODE>IG</CODE>,
22 1 equemene
<CODE>const int</CODE>
23 1 equemene
<CODE>INB</CODE>,
24 1 equemene
<CODE>const int</CODE>
25 1 equemene
<CODE>NB</CODE>,
26 1 equemene
<CODE>const int</CODE>
27 1 equemene
<CODE>SRCPROC</CODE>,
28 1 equemene
<CODE>const int</CODE>
29 1 equemene
<CODE>NPROCS</CODE>
30 1 equemene
<CODE>);</CODE>
31 1 equemene
32 1 equemene
<H1>Description</H1>
33 1 equemene
<B>HPL_indxg2lp</B>
34 1 equemene
computes the local index of a matrix entry pointed to by
35 1 equemene
the global  index IG as well as the process coordinate which posseses
36 1 equemene
this entry. The local returned index is the same in all processes.
37 1 equemene
38 1 equemene
<H1>Arguments</H1>
39 1 equemene
<PRE>
40 1 equemene
IL      (output)                      int *
41 1 equemene
        On exit, IL specifies the local index corresponding to IG. IL
42 1 equemene
        is at least zero.
43 1 equemene
</PRE>
44 1 equemene
<PRE>
45 1 equemene
PROC    (output)                      int *
46 1 equemene
        On exit,  PROC  is the  coordinate of the process  owning the
47 1 equemene
        entry specified by the global index IG. PROC is at least zero
48 1 equemene
        and less than NPROCS.
49 1 equemene
</PRE>
50 1 equemene
<PRE>
51 1 equemene
IG      (input)                       const int
52 1 equemene
        On entry, IG specifies the global index of the matrix  entry.
53 1 equemene
        IG must be at least zero.
54 1 equemene
</PRE>
55 1 equemene
<PRE>
56 1 equemene
INB     (input)                       const int
57 1 equemene
        On entry,  INB  specifies  the size of the first block of the
58 1 equemene
        global matrix. INB must be at least one.
59 1 equemene
</PRE>
60 1 equemene
<PRE>
61 1 equemene
NB      (input)                       const int
62 1 equemene
        On entry,  NB specifies the blocking factor used to partition
63 1 equemene
        and distribute the matrix A. NB must be larger than one.
64 1 equemene
</PRE>
65 1 equemene
<PRE>
66 1 equemene
SRCPROC (input)                       const int
67 1 equemene
        On entry, if SRCPROC = -1, the data  is not  distributed  but
68 1 equemene
        replicated,  in  which  case  this  routine returns IG in all
69 1 equemene
        processes. Otherwise, the value of SRCPROC is ignored.
70 1 equemene
</PRE>
71 1 equemene
<PRE>
72 1 equemene
NPROCS  (input)                       const int
73 1 equemene
        On entry,  NPROCS  specifies the total number of process rows
74 1 equemene
        or columns over which the matrix is distributed.  NPROCS must
75 1 equemene
        be at least one.
76 1 equemene
</PRE>
77 1 equemene
78 1 equemene
<H1>See Also</H1>
79 1 equemene
<A HREF="HPL_indxg2l.html">HPL_indxg2l</A>,
80 1 equemene
<A HREF="HPL_indxg2p.html">HPL_indxg2p</A>,
81 1 equemene
<A HREF="HPL_indxl2g.html">HPL_indxl2g</A>,
82 1 equemene
<A HREF="HPL_numroc.html">HPL_numroc</A>,
83 1 equemene
<A HREF="HPL_numrocI.html">HPL_numrocI</A>.
84 1 equemene
85 1 equemene
</BODY>
86 1 equemene
</HTML>