Debian Codegraph @

hpl/www/HPL_infog2l.html

raw
1 <HTML>
2 <HEAD>
3 <TITLE>HPL_infog2l HPL 2.0 Library Functions September 10, 2008</TITLE>
4 </HEAD>
5
6 <BODY BGCOLOR="WHITE" TEXT = "#000000" LINK = "#0000ff" VLINK = "#000099"
7 ALINK = "#ffff00">
8
9 <H1>Name</H1>
10 <B>HPL_infog2l</B> global to local index translation.
11
12 <H1>Synopsis</H1>
13 <CODE>#include "hpl.h"</CODE><BR><BR>
14 <CODE>void</CODE>
15 <CODE>HPL_infog2l(</CODE>
16 <CODE>int</CODE>
17 <CODE>I</CODE>,
18 <CODE>int</CODE>
19 <CODE>J</CODE>,
20 <CODE>const int</CODE>
21 <CODE>IMB</CODE>,
22 <CODE>const int</CODE>
23 <CODE>MB</CODE>,
24 <CODE>const int</CODE>
25 <CODE>INB</CODE>,
26 <CODE>const int</CODE>
27 <CODE>NB</CODE>,
28 <CODE>const int</CODE>
29 <CODE>RSRC</CODE>,
30 <CODE>const int</CODE>
31 <CODE>CSRC</CODE>,
32 <CODE>const int</CODE>
33 <CODE>MYROW</CODE>,
34 <CODE>const int</CODE>
35 <CODE>MYCOL</CODE>,
36 <CODE>const int</CODE>
37 <CODE>NPROW</CODE>,
38 <CODE>const int</CODE>
39 <CODE>NPCOL</CODE>,
40 <CODE>int *</CODE>
41 <CODE>II</CODE>,
42 <CODE>int *</CODE>
43 <CODE>JJ</CODE>,
44 <CODE>int *</CODE>
45 <CODE>PROW</CODE>,
46 <CODE>int *</CODE>
47 <CODE>PCOL</CODE>
48 <CODE>);</CODE>
49
50 <H1>Description</H1>
51 <B>HPL_infog2l</B>
52 computes the starting local index II, JJ corresponding to
53 the submatrix starting globally at the entry pointed by I, J. This
54 routine returns the coordinates in the grid of the process owning the
55 matrix entry of global indexes I, J, namely PROW and PCOL.
56
57 <H1>Arguments</H1>
58 <PRE>
59 I (global input) int
60 On entry, I specifies the global row index of the matrix
61 entry. I must be at least zero.
62 </PRE>
63 <PRE>
64 J (global input) int
65 On entry, J specifies the global column index of the matrix
66 entry. J must be at least zero.
67 </PRE>
68 <PRE>
69 IMB (global input) const int
70 On entry, IMB specifies the size of the first row block of
71 the global matrix. IMB must be at least one.
72 </PRE>
73 <PRE>
74 MB (global input) const int
75 On entry, MB specifies the blocking factor used to partition
76 and distribute the rows of the matrix A. MB must be larger
77 than one.
78 </PRE>
79 <PRE>
80 INB (global input) const int
81 On entry, INB specifies the size of the first column block of
82 the global matrix. INB must be at least one.
83 </PRE>
84 <PRE>
85 NB (global input) const int
86 On entry, NB specifies the blocking factor used to partition
87 and distribute the columns of the matrix A. NB must be larger
88 than one.
89 </PRE>
90 <PRE>
91 RSRC (global input) const int
92 On entry, RSRC specifies the row coordinate of the process
93 that possesses the row I. RSRC must be at least zero and
94 strictly less than NPROW.
95 </PRE>
96 <PRE>
97 CSRC (global input) const int
98 On entry, CSRC specifies the column coordinate of the process
99 that possesses the column J. CSRC must be at least zero and
100 strictly less than NPCOL.
101 </PRE>
102 <PRE>
103 MYROW (local input) const int
104 On entry, MYROW specifies my row process coordinate in the
105 grid. MYROW is greater than or equal to zero and less than
106 NPROW.
107 </PRE>
108 <PRE>
109 MYCOL (local input) const int
110 On entry, MYCOL specifies my column process coordinate in the
111 grid. MYCOL is greater than or equal to zero and less than
112 NPCOL.
113 </PRE>
114 <PRE>
115 NPROW (global input) const int
116 On entry, NPROW specifies the number of process rows in the
117 grid. NPROW is at least one.
118 </PRE>
119 <PRE>
120 NPCOL (global input) const int
121 On entry, NPCOL specifies the number of process columns in
122 the grid. NPCOL is at least one.
123 </PRE>
124 <PRE>
125 II (local output) int *
126 On exit, II specifies the local starting row index of the
127 submatrix. On exit, II is at least 0.
128 </PRE>
129 <PRE>
130 JJ (local output) int *
131 On exit, JJ specifies the local starting column index of the
132 submatrix. On exit, JJ is at least 0.
133 </PRE>
134 <PRE>
135 PROW (global output) int *
136 On exit, PROW is the row coordinate of the process owning the
137 entry specified by the global index I. PROW is at least zero
138 and less than NPROW.
139 </PRE>
140 <PRE>
141 PCOL (global output) int *
142 On exit, PCOL is the column coordinate of the process owning
143 the entry specified by the global index J. PCOL is at least
144 zero and less than NPCOL.
145 </PRE>
146
147 <H1>See Also</H1>
148 <A HREF="HPL_indxg2l.html">HPL_indxg2l</A>,
149 <A HREF="HPL_indxg2p.html">HPL_indxg2p</A>,
150 <A HREF="HPL_indxl2g.html">HPL_indxl2g</A>,
151 <A HREF="HPL_numroc.html">HPL_numroc</A>,
152 <A HREF="HPL_numrocI.html">HPL_numrocI</A>.
153
154 </BODY>
155 </HTML>