DragonFly On-Line Manual Pages

Search: Section:  

HPL_infog2l(3)               HPL Library Functions              HPL_infog2l(3)


NAME

       HPL_infog2l - global to local index translation.


SYNOPSIS

       #include "hpl.h"

       void HPL_infog2l( int I, int J, const int IMB, const int MB, const int
       INB, const int NB, const int RSRC, const int CSRC, const int MYROW,
       const int MYCOL, const int NPROW, const int NPCOL, int * II, int * JJ,
       int * PROW, int * PCOL );


DESCRIPTION

       HPL_infog2l computes the starting local index II, JJ corresponding to
       the submatrix starting globally at the entry pointed by  I,  J.  This
       routine returns the coordinates in the grid of the process owning the
       matrix entry of global indexes I, J, namely PROW and PCOL.


ARGUMENTS

       I       (global input)          int
               On entry,  I  specifies  the  global  row index of the matrix
               entry. I must be at least zero.

       J       (global input)          int
               On entry,  J  specifies the global column index of the matrix
               entry. J must be at least zero.

       IMB     (global input)          const int
               On entry,  IMB  specifies  the size of the first row block of
               the global matrix. IMB must be at least one.

       MB      (global input)          const int
               On entry,  MB specifies the blocking factor used to partition
               and  distribute the rows of the matrix A.  MB  must be larger
               than one.

       INB     (global input)          const int
               On entry, INB specifies the size of the first column block of
               the global matrix. INB must be at least one.

       NB      (global input)          const int
               On entry,  NB specifies the blocking factor used to partition
               and distribute the columns of the matrix A. NB must be larger
               than one.

       RSRC    (global input)          const int
               On entry,  RSRC  specifies  the row coordinate of the process
               that possesses the row  I.  RSRC  must  be at least zero  and
               strictly less than NPROW.

       CSRC    (global input)          const int
               On entry, CSRC specifies the column coordinate of the process
               that possesses the column J. CSRC  must be at least zero  and
               strictly less than NPCOL.

       MYROW   (local input)           const int
               On entry, MYROW  specifies my  row process  coordinate in the
               grid. MYROW is greater than or equal  to zero  and  less than
               NPROW.

       MYCOL   (local input)           const int
               On entry, MYCOL specifies my column process coordinate in the
               grid. MYCOL is greater than or equal  to zero  and  less than
               NPCOL.

       NPROW   (global input)          const int
               On entry,  NPROW  specifies the number of process rows in the
               grid. NPROW is at least one.

       NPCOL   (global input)          const int
               On entry,  NPCOL  specifies  the number of process columns in
               the grid. NPCOL is at least one.

       II      (local output)          int *
               On exit, II  specifies the  local  starting  row index of the
               submatrix. On exit, II is at least 0.

       JJ      (local output)          int *
               On exit, JJ  specifies the local starting column index of the
               submatrix. On exit, JJ is at least 0.

       PROW    (global output)         int *
               On exit, PROW is the row coordinate of the process owning the
               entry specified by the global index I.  PROW is at least zero
               and less than NPROW.

       PCOL    (global output)         int *
               On exit, PCOL  is the column coordinate of the process owning
               the entry specified by the global index J.  PCOL  is at least
               zero and less than NPCOL.


SEE ALSO

       HPL_indxg2l (3), HPL_indxg2p (3), HPL_indxl2g (3), HPL_numroc (3),
       HPL_numrocI (3).

HPL 2.1                        October 26, 2012                 HPL_infog2l(3)

Search: Section: