File: PB_Cnnxtroc.c

package info (click to toggle)
scalapack 1.8.0-6
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 32,240 kB
  • ctags: 29,143
  • sloc: fortran: 288,069; ansic: 64,035; makefile: 1,911
file content (195 lines) | stat: -rw-r--r-- 7,233 bytes parent folder | download | duplicates (10)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
/* ---------------------------------------------------------------------
*
*  -- PBLAS auxiliary routine (version 2.0) --
*     University of Tennessee, Knoxville, Oak Ridge National Laboratory,
*     and University of California, Berkeley.
*     April 1, 1998
*
*  ---------------------------------------------------------------------
*/
/*
*  Include files
*/
#include "../pblas.h"
#include "../PBpblas.h"
#include "../PBtools.h"
#include "../PBblacs.h"
#include "../PBblas.h"

#ifdef __STDC__
int PB_Cnnxtroc( int N, int I, int INB, int NB, int PROC, int SRCPROC,
                 int NPROCS )
#else
int PB_Cnnxtroc( N, I, INB, NB, PROC, SRCPROC, NPROCS )
/*
*  .. Scalar Arguments ..
*/
   int            I, INB, N, NB, NPROCS, PROC, SRCPROC;
#endif
{
/*
*  Purpose
*  =======
*
*  PB_Cnnxtroc computes  the number of next rows or columns of a subma-
*  trix that are possessed by processes closer to  SRCPROC1  than  PROC
*  where  SRCPROC1 is the process owning the row or column globally in-
*  dexed by I. The submatrix is defined by giving out N rows or columns
*  starting  from  global index I.  Therefore, if SRCPROC=0 and PROC=1,
*  then PB_Cnnxtroc returns the number of matrix rows or columns  owned
*  by processes 2, 3 ... NPROCS-1.
*
*  In fact, if the same exact parameters N,  I,  INB,  NB,  SRCPROC and
*  NPROCS are passed to PB_Cnpreroc, PB_Cnumroc and PB_Cnnxtroc  produ-
*  cing respectively npre, np and nnxt,  then  npre + np + nnxt = N  in
*  every process PROC.
*
*  Arguments
*  =========
*
*  N       (global input) INTEGER
*          On entry, N  specifies the number of rows/columns being dealt
*          out. N must be at least zero.
*
*  I       (global input) INTEGER
*          On entry, I  specifies the global index of the matrix  entry.
*          I must be at least zero.
*
*  INB     (global input) INTEGER
*          On entry,  INB  specifies  the size of the first block of the
*          global matrix distribution. INB must be at least one.
*
*  NB      (global input) INTEGER
*          On entry, NB specifies the size of the blocks used to  parti-
*          tion the matrix. NB must be at least one.
*
*  PROC    (local input) INTEGER
*          On entry, PROC specifies  the coordinate of the process whose
*          local portion is determined.  PROC must be at least zero  and
*          strictly less than NPROCS.
*
*  SRCPROC (global input) INTEGER
*          On entry,  SRCPROC  specifies  the coordinate of the  process
*          that possesses the  first row or column  of the matrix.  When
*          SRCPROC = -1, the data  is not  distributed  but  replicated,
*          otherwise  SRCPROC  must be at least zero and  strictly  less
*          than NPROCS.
*
*  NPROCS  (global input) INTEGER
*          On entry,  NPROCS  specifies the total number of process rows
*          or columns over which the matrix is distributed.  NPROCS must
*          be at least one.
*
*  -- Written on April 1, 1998 by
*     Antoine Petitet, University of Tennessee, Knoxville 37996, USA.
*
*  ---------------------------------------------------------------------
*/
/*
*  .. Local Scalars ..
*/
   int            ilocblk, mydist, nblocks;
/* ..
*  .. Executable Statements ..
*
*/
   if( ( SRCPROC == -1 ) || ( NPROCS == 1 ) )
/*
*  The data is not distributed, or there is just one process in this dimension
*  of the grid.
*/
      return( 0 );
/*
*  Compute coordinate of process owning I and corresponding INB
*/
   if( ( INB -= I ) <= 0 )
   {
/*
*  I is not in first block, find out which process has it and update size of
*  first block
*/
      nblocks  = ( -INB ) / NB + 1;
      SRCPROC += nblocks;
      SRCPROC -= ( SRCPROC / NPROCS ) * NPROCS;
      INB     += nblocks * NB;
   }
/*
*  Now everything is just like N, I=0, INB, NB, SRCPROC, NPROCS. If the source
*  process owns the N rows or columns, nothing follows me ...
*/
   if( N <= INB ) return( 0 );
/*
*  The discussion goes as follows: compute my distance from the source process
*  so that within this process coordinate system, the source process is the
*  process such that mydist = 0, or equivalently PROC == SRCPROC.
*
*  Find out how many full blocks are globally (nblocks) and locally (ilocblk)
*  in those N entries. Then remark that
*
*  when mydist < nblocks - ilocblk * NPROCS, I own ilocblk + 1 full blocks,
*  when mydist > nblocks - ilocblk * NPROCS, I own ilocblk     full blocks,
*  when mydist = nblocks - ilocblk * NPROCS, either the last block is not full
*  and I own it, or the last block is full and I am the first process owning
*  only ilocblk full blocks.
*/
   nblocks = ( N - INB ) / NB + 1;

   if( PROC == SRCPROC )
   {
/*
*  First note that I cannot be the source and the last process because mydist=0
*  and NPROCS > 1. Since mydist = 0 and nblocks - ilocblk * NPROCS >= 0, there
*  are only two possible cases:
*
*    1) When mydist = nblocks - ilocblk * NPROCS = 0, that is NPROCS divides
*       the global number of full blocks, then the source process SRCPROC owns
*       one more block than the other processes; Thus, N can be rewritten as
*       N  = INB + (nblocks-1) * NB + LNB with LNB >= 0 size of the last block.
*       Similarly, the local value Np corresponding to the local number of rows
*       and columns owned by the source process is INB + (ilocblk-1)*NB + LNB,
*       that is N + ( ilocblk-1 - (nblocks-1) )*NB. Therefore, there must be
*       ( nblocks - ilocblk ) * NB rows or columns following me. Note that this
*       case cannot happen when ilocblk is zero, since nblocks is at least one.
*
*    2) mydist = 0 < nblocks - ilocblk * NPROCS, the source process only owns
*       full blocks, and therefore locally INB + ilocblk * NB rows or columns.
*       Thus, N - INB - ilocblk * NB rows or columns follow me. Note that when
*       ilocblk is zero, this becomes simply N - INB.
*/
      if( nblocks < NPROCS ) return( N - INB );

      ilocblk = nblocks / NPROCS;
      return( ( ( nblocks - ilocblk * NPROCS ) ? N - INB - ilocblk * NB :
                ( nblocks - ilocblk ) * NB ) );
   }
   else
   {
/*
*  I am not the source process. Compute my distance from the source process.
*/
      if( ( mydist = PROC - SRCPROC ) < 0 ) mydist += NPROCS;
/*
*  If I am the last process i.e. mydist = NPROCS - 1, nothing follows me.
*/
      if( mydist == NPROCS - 1 ) return( 0 );
/*
*  Otherwise, when mydist >= nblocks - ilocblk * NPROCS, there are exactly
*  NB * ilocblk * ( NPROCS - mydist ) rows or columns after me including mine,
*  i.e NB * ilocblk * ( NPROCS - 1 - mydist ) rows or columns following me.
*  Finally, when 0 < mydist < nblocks - ilocblk * NPROCS, the number of rows
*  or columns preceeding me is INB + ilocblk * NB + mydist*( ilocblk+1 )*NB
*  including mine, therefore there are N-INB-NB*( ilocblk+mydist*(ilocblk+1) )
*  rows or columns following me.
*/
      if( nblocks < NPROCS )
         return( ( ( mydist < nblocks ) ? N - mydist * NB - INB : 0 ) );

      ilocblk = nblocks / NPROCS;
      return( ( ( mydist >= ( nblocks - ilocblk * NPROCS ) ) ?
                ( NPROCS - 1 - mydist ) * ilocblk * NB :
                N - INB - ( ilocblk * mydist + ilocblk + mydist )*NB ) );
   }
/*
*  End of PB_Cnnxtroc
*/
}