1HPL_infog2l(3)               HPL Library Functions              HPL_infog2l(3)
2
3
4

NAME

6       HPL_infog2l - global to local index translation.
7

SYNOPSIS

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

DESCRIPTION

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

ARGUMENTS

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

SEE ALSO

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)
Impressum