root / man / man3 / HPL_indxg2lp.3 @ 1
Historique | Voir | Annoter | Télécharger (1,94 ko)
| 1 |
.TH HPL_indxg2lp 3 "September 10, 2008" "HPL 2.0" "HPL Library Functions" |
|---|---|
| 2 |
.SH NAME |
| 3 |
HPL_indxg2lp \- Map a local index into a global one. |
| 4 |
.SH SYNOPSIS |
| 5 |
\fB\&#include "hpl.h"\fR |
| 6 |
|
| 7 |
\fB\&void\fR |
| 8 |
\fB\&HPL_indxg2lp(\fR |
| 9 |
\fB\&int *\fR |
| 10 |
\fI\&IL\fR, |
| 11 |
\fB\&int *\fR |
| 12 |
\fI\&PROC\fR, |
| 13 |
\fB\&const int\fR |
| 14 |
\fI\&IG\fR, |
| 15 |
\fB\&const int\fR |
| 16 |
\fI\&INB\fR, |
| 17 |
\fB\&const int\fR |
| 18 |
\fI\&NB\fR, |
| 19 |
\fB\&const int\fR |
| 20 |
\fI\&SRCPROC\fR, |
| 21 |
\fB\&const int\fR |
| 22 |
\fI\&NPROCS\fR |
| 23 |
\fB\&);\fR |
| 24 |
.SH DESCRIPTION |
| 25 |
\fB\&HPL_indxg2lp\fR |
| 26 |
computes the local index of a matrix entry pointed to by |
| 27 |
the global index IG as well as the process coordinate which posseses |
| 28 |
this entry. The local returned index is the same in all processes. |
| 29 |
.SH ARGUMENTS |
| 30 |
.TP 8 |
| 31 |
IL (output) int * |
| 32 |
On exit, IL specifies the local index corresponding to IG. IL |
| 33 |
is at least zero. |
| 34 |
.TP 8 |
| 35 |
PROC (output) int * |
| 36 |
On exit, PROC is the coordinate of the process owning the |
| 37 |
entry specified by the global index IG. PROC is at least zero |
| 38 |
and less than NPROCS. |
| 39 |
.TP 8 |
| 40 |
IG (input) const int |
| 41 |
On entry, IG specifies the global index of the matrix entry. |
| 42 |
IG must be at least zero. |
| 43 |
.TP 8 |
| 44 |
INB (input) const int |
| 45 |
On entry, INB specifies the size of the first block of the |
| 46 |
global matrix. INB must be at least one. |
| 47 |
.TP 8 |
| 48 |
NB (input) const int |
| 49 |
On entry, NB specifies the blocking factor used to partition |
| 50 |
and distribute the matrix A. NB must be larger than one. |
| 51 |
.TP 8 |
| 52 |
SRCPROC (input) const int |
| 53 |
On entry, if SRCPROC = -1, the data is not distributed but |
| 54 |
replicated, in which case this routine returns IG in all |
| 55 |
processes. Otherwise, the value of SRCPROC is ignored. |
| 56 |
.TP 8 |
| 57 |
NPROCS (input) const int |
| 58 |
On entry, NPROCS specifies the total number of process rows |
| 59 |
or columns over which the matrix is distributed. NPROCS must |
| 60 |
be at least one. |
| 61 |
.SH SEE ALSO |
| 62 |
.BR HPL_indxg2l \ (3), |
| 63 |
.BR HPL_indxg2p \ (3), |
| 64 |
.BR HPL_indxl2g \ (3), |
| 65 |
.BR HPL_numroc \ (3), |
| 66 |
.BR HPL_numrocI \ (3). |