1HPL_infog2l(3) HPL Library Functions HPL_infog2l(3)
2
3
4
6 HPL_infog2l - global to local index translation.
7
9 #include "hpl.h"
10
11 void HPL_infog2l( int I, int J, const int IMB, const int MB, const int
12 INB, const int NB, const int RSRC, const int CSRC, const int MYROW,
13 const int MYCOL, const int NPROW, const int NPCOL, int * II, int * JJ,
14 int * PROW, int * PCOL );
15
17 HPL_infog2l computes the starting local index II, JJ corresponding to
18 the submatrix starting globally at the entry pointed by I, J. This
19 routine returns the coordinates in the grid of the process owning the
20 matrix entry of global indexes I, J, namely PROW and PCOL.
21
23 I (global input) int
24 On entry, I specifies the global row index of the matrix
25 entry. I must be at least zero.
26
27 J (global input) int
28 On entry, J specifies the global column index of the matrix
29 entry. J must be at least zero.
30
31 IMB (global input) const int
32 On entry, IMB specifies the size of the first row block of
33 the global matrix. IMB must be at least one.
34
35 MB (global input) const int
36 On entry, MB specifies the blocking factor used to partition
37 and distribute the rows of the matrix A. MB must be larger
38 than one.
39
40 INB (global input) const int
41 On entry, INB specifies the size of the first column block of
42 the global matrix. INB must be at least one.
43
44 NB (global input) const int
45 On entry, NB specifies the blocking factor used to partition
46 and distribute the columns of the matrix A. NB must be larger
47 than one.
48
49 RSRC (global input) const int
50 On entry, RSRC specifies the row coordinate of the process
51 that possesses the row I. RSRC must be at least zero and
52 strictly less than NPROW.
53
54 CSRC (global input) const int
55 On entry, CSRC specifies the column coordinate of the process
56 that possesses the column J. CSRC must be at least zero and
57 strictly less than NPCOL.
58
59 MYROW (local input) const int
60 On entry, MYROW specifies my row process coordinate in the
61 grid. MYROW is greater than or equal to zero and less than
62 NPROW.
63
64 MYCOL (local input) const int
65 On entry, MYCOL specifies my column process coordinate in the
66 grid. MYCOL is greater than or equal to zero and less than
67 NPCOL.
68
69 NPROW (global input) const int
70 On entry, NPROW specifies the number of process rows in the
71 grid. NPROW is at least one.
72
73 NPCOL (global input) const int
74 On entry, NPCOL specifies the number of process columns in
75 the grid. NPCOL is at least one.
76
77 II (local output) int *
78 On exit, II specifies the local starting row index of the
79 submatrix. On exit, II is at least 0.
80
81 JJ (local output) int *
82 On exit, JJ specifies the local starting column index of the
83 submatrix. On exit, JJ is at least 0.
84
85 PROW (global output) int *
86 On exit, PROW is the row coordinate of the process owning the
87 entry specified by the global index I. PROW is at least zero
88 and less than NPROW.
89
90 PCOL (global output) int *
91 On exit, PCOL is the column coordinate of the process owning
92 the entry specified by the global index J. PCOL is at least
93 zero and less than NPCOL.
94
96 HPL_indxg2l (3), HPL_indxg2p (3), HPL_indxl2g (3), HPL_numroc (3),
97 HPL_numrocI (3).
98
99
100
101HPL 2.1 October 26, 2012 HPL_infog2l(3)