File: dgraph_match_sync.h

package info (click to toggle)
scotch 5.0.1.dfsg-1
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 6,088 kB
  • ctags: 4,515
  • sloc: ansic: 46,851; makefile: 2,093; yacc: 588; lex: 263; fortran: 90
file content (248 lines) | stat: -rw-r--r-- 9,737 bytes parent folder | download
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
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
/* Copyright 2007 ENSEIRB, INRIA & CNRS
**
** This file is part of the Scotch software package for static mapping,
** graph partitioning and sparse matrix ordering.
**
** This software is governed by the CeCILL-C license under French law
** and abiding by the rules of distribution of free software. You can
** use, modify and/or redistribute the software under the terms of the
** CeCILL-C license as circulated by CEA, CNRS and INRIA at the following
** URL: "http://www.cecill.info".
** 
** As a counterpart to the access to the source code and rights to copy,
** modify and redistribute granted by the license, users are provided
** only with a limited warranty and the software's author, the holder of
** the economic rights, and the successive licensors have only limited
** liability.
** 
** In this respect, the user's attention is drawn to the risks associated
** with loading, using, modifying and/or developing or reproducing the
** software by the user in light of its specific status of free software,
** that may mean that it is complicated to manipulate, and that also
** therefore means that it is reserved for developers and experienced
** professionals having in-depth computer knowledge. Users are therefore
** encouraged to load and test the software's suitability as regards
** their requirements in conditions enabling the security of their
** systems and/or data to be ensured and, more generally, to use and
** operate it in the same conditions as regards security.
** 
** The fact that you are presently reading this means that you have had
** knowledge of the CeCILL-C license and that you accept its terms.
*/
/************************************************************/
/**                                                        **/
/**   NAME       : dgraph_match_sync.h                     **/
/**                                                        **/
/**   AUTHOR     : Cedric CHEVALIER                        **/
/**                                                        **/
/**   FUNCTION   : This file contains declarations of      **/
/**                matching algorithm for multi-level.     **/
/**                The implementation uses an synchrone    **/
/**                way with one thread.                    **/
/**                                                        **/
/**   DATES      : # Version 0.5  : from : 14 sep 2006     **/
/**                                 to   : 21 jun 2007     **/
/**                                                        **/
/************************************************************/

/*
** The types
*/

typedef struct DgraphMatchSyncQueue_ {
  Gnum *                    head;                 /*+ Head of distance queue  +*/
  Gnum *                    tail;                 /*+ Tail of distance queue  +*/
  Gnum *                    qtab;                 /*+ Array of queue elements +*/
  Gnum *                    qend;                 /*+ Mark end of buffer      +*/
  Gnum *                    oldtail;              /*+ Oldtail for restarting  +*/
  Gnum                      size;                 /*+ Number of elements      +*/
} DgraphMatchSyncQueue;

/* This structure contains infos for a distant matching */
typedef struct DgraphMatchSyncMessage_ {
  Gnum                      finevertdstnum;       /*+ Global indice of destination vertex +*/
  Gnum                      finevertsrcnum;       /*+ Global indice of source vertex      +*/
  union {
    Gnum                    coarvertnum;          /*+ Global indice of matched vertex     +*/
    Gnum                    degree;               /*+ Number of edges to exchange in case of successfull matching +*/
  };
} DgraphMatchSyncMessage;

/* This structure contains datas to allow exchange of ghost vertices infos */
typedef struct DgraphMatchSyncCommProc_ {
  DgraphMatchSyncMessage *      begin;            /*+ Pointer on first data to exchange +*/
  DgraphMatchSyncMessage *      end;              /*+ Pointer on last data to exchange  +*/
  int                           maxsize;
} DgraphMatchSyncCommProc;


typedef enum {LUBY_SYNC=314,                      /*+ Exchange using Luby coloration of processors +*/
              SIMPLE_SYNC=42,                     /*+ Exchande using a ParMetis like All2All comm  +*/
              PREPAR_SYNC,                        /*+ Used to initialize luby, in order to mix strat +*/
              LUBY_SIMPLE_SYNC,                   /*+ Used to initialize luby, in order to mix strat +*/
} DgraphMatchSyncExchangeMethod;

/* This structure is used to call various synchronisation method */
typedef struct DgraphMatchSyncComm_ {
  DgraphMatchSyncExchangeMethod      method;
  int                     * restrict colortab;    /*+ Used in Luby Processor Coloration +*/
  int                                mycolor;     /*+ Used in Luby Processor Coloration +*/
  int                                nbrcolor;
  int                                begcolor;
  MPI_Request             * restrict requesttab;  /*+ Array of requests +*/
  MPI_Datatype                       datatype;    /*+ Datatype for exchanges +*/
  DgraphMatchSyncCommProc * restrict comsndtab;
  DgraphMatchSyncCommProc * restrict comrcvtab;
  DgraphMatchConvert                 convertstruct;/*+ To convert between ghst et local nums +*/
  DgraphCoarsenMulti      * restrict coarmultgsttab;/*+ Tab used for inter-proc prematching +*/
  Gnum                               coarmultgstnum;/*+ Indice in previous table +*/
  Gnum                  * restrict * verttosndtab;/*+ Indirections table to keep migrant vertices +*/
  DgraphMatchSyncMessage          ** proccoarmulttab;
} DgraphMatchSyncComm;

/**********************************************************
 *                                                        *
 * Auxiliary functions.                                   *
 *                                                        *
 *********************************************************/

int
dgraphMatchSyncDoMatching (
const Dgraph * restrict const finegraph,     /* Graph to match                               */
DgraphMatchParam   * restrict shared,     /* Shared tables concerning the vertices states */
int                           coarvertmax);  /* Maximum number of matching pairs             */


int
dgraphMatchSyncCommInit (
const Dgraph * restrict const  finegraph,     /* Graph to match                               */
DgraphMatchParam    * restrict shared,
DgraphMatchSyncComm * restrict commptr);

void
dgraphMatchSyncCommExit (
const Dgraph * restrict const  finegraph,     /* Graph to match                               */
DgraphMatchSyncComm * restrict commptr);

int
dgraphMatchSyncCommDo (
const Dgraph * restrict const  finegraph,     /* Graph to match                               */
DgraphMatchSyncComm * restrict commptr,
DgraphMatchParam    * restrict shared,
Gnum                         * nonmatenbr,
DgraphMatchSyncQueue * restrict nonmatequeue);

/* A ParMetis Like exchange function */
int
dgraphMatchSyncSimpleExchange (
const Dgraph * restrict const  finegraph,     /* Graph to match                               */
DgraphMatchSyncComm * restrict commptr,
DgraphMatchParam    * restrict shared,
Gnum                         *  nonmatenbr,
DgraphMatchSyncQueue * restrict nonmatequeue);

int
dgraphMatchSyncLubyExchange (
const Dgraph * restrict const  finegraph,     /* Graph to match                               */
DgraphMatchSyncComm * restrict commptr,
DgraphMatchParam    * restrict shared,
Gnum                         *  nonmatenbr,
DgraphMatchSyncQueue * restrict nonmatequeue);

int
dgraphMatchSyncBalance (
const Dgraph * restrict const  finegraph,     /* Graph to match                               */
DgraphMatchSyncComm * restrict commptr,
DgraphMatchParam    * restrict shared,
int                            nonmatenbr);


int dgraphMatchLubyColor (
  const Dgraph * restrict const dgrafptr,
  int *                         mycolor,
  int * restrict                colors,
  int *                         nbrcolor);


#define inline static __inline__

inline void
dgraphMatchSyncQueueFlush (DgraphMatchSyncQueue * queue)
{
  queue->head    = queue->tail = queue->qtab;
  queue->oldtail = queue->tail;
  queue->size    = 0;
}

inline void
dgraphMatchSyncQueueInit (DgraphMatchSyncQueue * queue, Gnum size)
{
  queue->qend = queue->qtab + size;
  dgraphMatchSyncQueueFlush (queue);
}

inline int
dgraphMatchSyncQueueEmpty (DgraphMatchSyncQueue * queue)
{
  return (queue->size == 0);
}

inline int
dgraphMatchSyncQueueReady (DgraphMatchSyncQueue * queue)
{
  return ((!dgraphMatchSyncQueueEmpty (queue)) &&(queue->head != queue->oldtail));
}

inline void
dgraphMatchSyncQueueSetReady (DgraphMatchSyncQueue * queue)
{
  queue->oldtail = queue->tail;
}

inline void
dgraphMatchSyncQueuePut (DgraphMatchSyncQueue * queue , Gnum vnum)
{
#ifdef SCOTCH_DEBUG_DGRAPH2
  if (queue->qtab + queue->size >= queue->qend) {
    errorPrint ("dgraphMatchSyncQueuePut : queue too small\n");
    return;
  }
#endif /* SCOTCH_DEBUG_DGRAPH2 */

  *(queue->tail) = vnum;
  if (queue->tail == queue->qend - 1)
    queue->tail = queue->qtab;
  else
    queue->tail ++;
  queue->size ++;
}

inline Gnum
dgraphMatchSyncQueueGet (DgraphMatchSyncQueue * queue)
{
  Gnum vnum;

#ifdef SCOTCH_DEBUG_DGRAPH2
  if (queue->size == 0) {
    errorPrint ("dgraphMatchSyncQueueGet : queue has no element small\n");
    return (-1);
  }
#endif /* SCOTCH_DEBUG_DGRAPH2 */

  vnum = *(queue->head);
  if (queue->head == queue->qend - 1)
    queue->head = queue->qtab;
  else
    queue->head ++;
  queue->size --;

  return (vnum);
}

inline Gnum
dgraphMatchSyncQueueSize (DgraphMatchSyncQueue * queue)
{
  return (queue->size);
}

#undef inline