Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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  en-
	     try. I must be at least zero.

     J	     (global input)	     int
	     On  entry,   J  specifies the global column index of the matrix en-
	     try. 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 sub-
	     matrix. On exit, II is at least 0.

     JJ      (local output)	     int *
	     On exit, JJ  specifies the local starting column index of the  sub-
	     matrix. 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_num-
     rocI (3).

HPL 2.3 			December 2, 2018		  HPL_infog2l(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=HPL_infog2l&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help