xref: /petsc/src/ksp/pc/impls/gamg/agg.c (revision 67de2c8aaebf457db47b77de7beae8eecd9be82b)
1 /*
2  GAMG geometric-algebric multigrid PC - Mark Adams 2011
3  */
4 
5 #include <../src/ksp/pc/impls/gamg/gamg.h> /*I "petscpc.h" I*/
6 #include <petscblaslapack.h>
7 #include <petscdm.h>
8 #include <petsc/private/kspimpl.h>
9 
10 typedef struct {
11   PetscInt   nsmooths;
12   PetscInt   aggressive_coarsening_levels; // number of aggressive coarsening levels (square or MISk)
13   PetscInt   aggressive_mis_k;             // the k in MIS-k
14   PetscBool  use_aggressive_square_graph;
15   PetscBool  use_minimum_degree_ordering;
16   PetscBool  use_low_mem_filter;
17   MatCoarsen crs;
18 } PC_GAMG_AGG;
19 
20 /*@
21   PCGAMGSetNSmooths - Set number of smoothing steps (1 is typical) used for multigrid on all the levels
22 
23   Logically Collective
24 
25   Input Parameters:
26 + pc - the preconditioner context
27 - n  - the number of smooths
28 
29   Options Database Key:
30 . -pc_gamg_agg_nsmooths <nsmooth, default=1> - number of smoothing steps to use with smooth aggregation
31 
32   Level: intermediate
33 
34 .seealso: [](ch_ksp), `PCMG`, `PCGAMG`
35 @*/
36 PetscErrorCode PCGAMGSetNSmooths(PC pc, PetscInt n)
37 {
38   PetscFunctionBegin;
39   PetscValidHeaderSpecific(pc, PC_CLASSID, 1);
40   PetscValidLogicalCollectiveInt(pc, n, 2);
41   PetscTryMethod(pc, "PCGAMGSetNSmooths_C", (PC, PetscInt), (pc, n));
42   PetscFunctionReturn(PETSC_SUCCESS);
43 }
44 
45 static PetscErrorCode PCGAMGSetNSmooths_AGG(PC pc, PetscInt n)
46 {
47   PC_MG       *mg          = (PC_MG *)pc->data;
48   PC_GAMG     *pc_gamg     = (PC_GAMG *)mg->innerctx;
49   PC_GAMG_AGG *pc_gamg_agg = (PC_GAMG_AGG *)pc_gamg->subctx;
50 
51   PetscFunctionBegin;
52   pc_gamg_agg->nsmooths = n;
53   PetscFunctionReturn(PETSC_SUCCESS);
54 }
55 
56 /*@
57   PCGAMGSetAggressiveLevels -  Use aggressive coarsening on first n levels
58 
59   Logically Collective
60 
61   Input Parameters:
62 + pc - the preconditioner context
63 - n  - 0, 1 or more
64 
65   Options Database Key:
66 . -pc_gamg_aggressive_coarsening <n,default = 1> - Number of levels to square the graph on before aggregating it
67 
68   Level: intermediate
69 
70 .seealso: [](ch_ksp), `PCGAMG`, `PCGAMGSetThreshold()`, `PCGAMGMISkSetAggressive()`, `PCGAMGSetAggressiveSquareGraph()`, `PCGAMGMISkSetMinDegreeOrdering()`, `PCGAMGSetLowMemoryFilter()`
71 @*/
72 PetscErrorCode PCGAMGSetAggressiveLevels(PC pc, PetscInt n)
73 {
74   PetscFunctionBegin;
75   PetscValidHeaderSpecific(pc, PC_CLASSID, 1);
76   PetscValidLogicalCollectiveInt(pc, n, 2);
77   PetscTryMethod(pc, "PCGAMGSetAggressiveLevels_C", (PC, PetscInt), (pc, n));
78   PetscFunctionReturn(PETSC_SUCCESS);
79 }
80 
81 /*@
82   PCGAMGMISkSetAggressive - Number (k) distance in MIS coarsening (>2 is 'aggressive')
83 
84   Logically Collective
85 
86   Input Parameters:
87 + pc - the preconditioner context
88 - n  - 1 or more (default = 2)
89 
90   Options Database Key:
91 . -pc_gamg_aggressive_mis_k <n,default=2> - Number (k) distance in MIS coarsening (>2 is 'aggressive')
92 
93   Level: intermediate
94 
95 .seealso: [](ch_ksp), `PCGAMG`, `PCGAMGSetThreshold()`, `PCGAMGSetAggressiveLevels()`, `PCGAMGSetAggressiveSquareGraph()`, `PCGAMGMISkSetMinDegreeOrdering()`, `PCGAMGSetLowMemoryFilter()`
96 @*/
97 PetscErrorCode PCGAMGMISkSetAggressive(PC pc, PetscInt n)
98 {
99   PetscFunctionBegin;
100   PetscValidHeaderSpecific(pc, PC_CLASSID, 1);
101   PetscValidLogicalCollectiveInt(pc, n, 2);
102   PetscTryMethod(pc, "PCGAMGMISkSetAggressive_C", (PC, PetscInt), (pc, n));
103   PetscFunctionReturn(PETSC_SUCCESS);
104 }
105 
106 /*@
107   PCGAMGSetAggressiveSquareGraph - Use graph square A'A for aggressive coarsening, old method
108 
109   Logically Collective
110 
111   Input Parameters:
112 + pc - the preconditioner context
113 - b  - default false - MIS-k is faster
114 
115   Options Database Key:
116 . -pc_gamg_aggressive_square_graph <bool,default=false> - Use square graph (A'A) or MIS-k (k=2) for aggressive coarsening
117 
118   Level: intermediate
119 
120 .seealso: [](ch_ksp), `PCGAMG`, `PCGAMGSetThreshold()`, `PCGAMGSetAggressiveLevels()`, `PCGAMGMISkSetAggressive()`, `PCGAMGMISkSetMinDegreeOrdering()`, `PCGAMGSetLowMemoryFilter()`
121 @*/
122 PetscErrorCode PCGAMGSetAggressiveSquareGraph(PC pc, PetscBool b)
123 {
124   PetscFunctionBegin;
125   PetscValidHeaderSpecific(pc, PC_CLASSID, 1);
126   PetscValidLogicalCollectiveBool(pc, b, 2);
127   PetscTryMethod(pc, "PCGAMGSetAggressiveSquareGraph_C", (PC, PetscBool), (pc, b));
128   PetscFunctionReturn(PETSC_SUCCESS);
129 }
130 
131 /*@
132   PCGAMGMISkSetMinDegreeOrdering - Use minimum degree ordering in greedy MIS algorithm
133 
134   Logically Collective
135 
136   Input Parameters:
137 + pc - the preconditioner context
138 - b  - default true
139 
140   Options Database Key:
141 . -pc_gamg_mis_k_minimum_degree_ordering <bool,default=true> - Use minimum degree ordering in greedy MIS algorithm
142 
143   Level: intermediate
144 
145 .seealso: [](ch_ksp), `PCGAMG`, `PCGAMGSetThreshold()`, `PCGAMGSetAggressiveLevels()`, `PCGAMGMISkSetAggressive()`, `PCGAMGSetAggressiveSquareGraph()`, `PCGAMGSetLowMemoryFilter()`
146 @*/
147 PetscErrorCode PCGAMGMISkSetMinDegreeOrdering(PC pc, PetscBool b)
148 {
149   PetscFunctionBegin;
150   PetscValidHeaderSpecific(pc, PC_CLASSID, 1);
151   PetscValidLogicalCollectiveBool(pc, b, 2);
152   PetscTryMethod(pc, "PCGAMGMISkSetMinDegreeOrdering_C", (PC, PetscBool), (pc, b));
153   PetscFunctionReturn(PETSC_SUCCESS);
154 }
155 
156 /*@
157   PCGAMGSetLowMemoryFilter - Use low memory graph/matrix filter
158 
159   Logically Collective
160 
161   Input Parameters:
162 + pc - the preconditioner context
163 - b  - default false
164 
165   Options Database Key:
166 . -pc_gamg_low_memory_threshold_filter <bool,default=false> - Use low memory graph/matrix filter
167 
168   Level: intermediate
169 
170 .seealso: `PCGAMG`, `PCGAMGSetThreshold()`, `PCGAMGSetAggressiveLevels()`, `PCGAMGMISkSetAggressive()`, `PCGAMGSetAggressiveSquareGraph()`, `PCGAMGMISkSetMinDegreeOrdering()`
171 @*/
172 PetscErrorCode PCGAMGSetLowMemoryFilter(PC pc, PetscBool b)
173 {
174   PetscFunctionBegin;
175   PetscValidHeaderSpecific(pc, PC_CLASSID, 1);
176   PetscValidLogicalCollectiveBool(pc, b, 2);
177   PetscTryMethod(pc, "PCGAMGSetLowMemoryFilter_C", (PC, PetscBool), (pc, b));
178   PetscFunctionReturn(PETSC_SUCCESS);
179 }
180 
181 static PetscErrorCode PCGAMGSetAggressiveLevels_AGG(PC pc, PetscInt n)
182 {
183   PC_MG       *mg          = (PC_MG *)pc->data;
184   PC_GAMG     *pc_gamg     = (PC_GAMG *)mg->innerctx;
185   PC_GAMG_AGG *pc_gamg_agg = (PC_GAMG_AGG *)pc_gamg->subctx;
186 
187   PetscFunctionBegin;
188   pc_gamg_agg->aggressive_coarsening_levels = n;
189   PetscFunctionReturn(PETSC_SUCCESS);
190 }
191 
192 static PetscErrorCode PCGAMGMISkSetAggressive_AGG(PC pc, PetscInt n)
193 {
194   PC_MG       *mg          = (PC_MG *)pc->data;
195   PC_GAMG     *pc_gamg     = (PC_GAMG *)mg->innerctx;
196   PC_GAMG_AGG *pc_gamg_agg = (PC_GAMG_AGG *)pc_gamg->subctx;
197 
198   PetscFunctionBegin;
199   pc_gamg_agg->aggressive_mis_k = n;
200   PetscFunctionReturn(PETSC_SUCCESS);
201 }
202 
203 static PetscErrorCode PCGAMGSetAggressiveSquareGraph_AGG(PC pc, PetscBool b)
204 {
205   PC_MG       *mg          = (PC_MG *)pc->data;
206   PC_GAMG     *pc_gamg     = (PC_GAMG *)mg->innerctx;
207   PC_GAMG_AGG *pc_gamg_agg = (PC_GAMG_AGG *)pc_gamg->subctx;
208 
209   PetscFunctionBegin;
210   pc_gamg_agg->use_aggressive_square_graph = b;
211   PetscFunctionReturn(PETSC_SUCCESS);
212 }
213 
214 static PetscErrorCode PCGAMGSetLowMemoryFilter_AGG(PC pc, PetscBool b)
215 {
216   PC_MG       *mg          = (PC_MG *)pc->data;
217   PC_GAMG     *pc_gamg     = (PC_GAMG *)mg->innerctx;
218   PC_GAMG_AGG *pc_gamg_agg = (PC_GAMG_AGG *)pc_gamg->subctx;
219 
220   PetscFunctionBegin;
221   pc_gamg_agg->use_low_mem_filter = b;
222   PetscFunctionReturn(PETSC_SUCCESS);
223 }
224 
225 static PetscErrorCode PCGAMGMISkSetMinDegreeOrdering_AGG(PC pc, PetscBool b)
226 {
227   PC_MG       *mg          = (PC_MG *)pc->data;
228   PC_GAMG     *pc_gamg     = (PC_GAMG *)mg->innerctx;
229   PC_GAMG_AGG *pc_gamg_agg = (PC_GAMG_AGG *)pc_gamg->subctx;
230 
231   PetscFunctionBegin;
232   pc_gamg_agg->use_minimum_degree_ordering = b;
233   PetscFunctionReturn(PETSC_SUCCESS);
234 }
235 
236 static PetscErrorCode PCSetFromOptions_GAMG_AGG(PC pc, PetscOptionItems *PetscOptionsObject)
237 {
238   PC_MG       *mg          = (PC_MG *)pc->data;
239   PC_GAMG     *pc_gamg     = (PC_GAMG *)mg->innerctx;
240   PC_GAMG_AGG *pc_gamg_agg = (PC_GAMG_AGG *)pc_gamg->subctx;
241   PetscBool    n_aggressive_flg, old_sq_provided = PETSC_FALSE, new_sq_provided = PETSC_FALSE, new_sqr_graph = pc_gamg_agg->use_aggressive_square_graph;
242   PetscInt     nsq_graph_old = 0;
243 
244   PetscFunctionBegin;
245   PetscOptionsHeadBegin(PetscOptionsObject, "GAMG-AGG options");
246   PetscCall(PetscOptionsInt("-pc_gamg_agg_nsmooths", "smoothing steps for smoothed aggregation, usually 1", "PCGAMGSetNSmooths", pc_gamg_agg->nsmooths, &pc_gamg_agg->nsmooths, NULL));
247   // aggressive coarsening logic with deprecated -pc_gamg_square_graph
248   PetscCall(PetscOptionsInt("-pc_gamg_aggressive_coarsening", "Number of aggressive coarsening (MIS-2) levels from finest", "PCGAMGSetAggressiveLevels", pc_gamg_agg->aggressive_coarsening_levels, &pc_gamg_agg->aggressive_coarsening_levels, &n_aggressive_flg));
249   if (!n_aggressive_flg)
250     PetscCall(PetscOptionsInt("-pc_gamg_square_graph", "Number of aggressive coarsening (MIS-2) levels from finest (deprecated alias for -pc_gamg_aggressive_coarsening)", "PCGAMGSetAggressiveLevels", nsq_graph_old, &nsq_graph_old, &old_sq_provided));
251   PetscCall(PetscOptionsBool("-pc_gamg_aggressive_square_graph", "Use square graph (A'A) or MIS-k (k=2) for aggressive coarsening", "PCGAMGSetAggressiveSquareGraph", new_sqr_graph, &pc_gamg_agg->use_aggressive_square_graph, &new_sq_provided));
252   if (!new_sq_provided && old_sq_provided) {
253     pc_gamg_agg->aggressive_coarsening_levels = nsq_graph_old; // could be zero
254     pc_gamg_agg->use_aggressive_square_graph  = PETSC_TRUE;
255   }
256   if (new_sq_provided && old_sq_provided)
257     PetscCall(PetscInfo(pc, "Warning: both -pc_gamg_square_graph and -pc_gamg_aggressive_coarsening are used. -pc_gamg_square_graph is deprecated, Number of aggressive levels is %d\n", (int)pc_gamg_agg->aggressive_coarsening_levels));
258   PetscCall(PetscOptionsBool("-pc_gamg_mis_k_minimum_degree_ordering", "Use minimum degree ordering for greedy MIS", "PCGAMGMISkSetMinDegreeOrdering", pc_gamg_agg->use_minimum_degree_ordering, &pc_gamg_agg->use_minimum_degree_ordering, NULL));
259   PetscCall(PetscOptionsBool("-pc_gamg_low_memory_threshold_filter", "Use the (built-in) low memory graph/matrix filter", "PCGAMGSetLowMemoryFilter", pc_gamg_agg->use_low_mem_filter, &pc_gamg_agg->use_low_mem_filter, NULL));
260   PetscCall(PetscOptionsInt("-pc_gamg_aggressive_mis_k", "Number of levels of multigrid to use.", "PCGAMGMISkSetAggressive", pc_gamg_agg->aggressive_mis_k, &pc_gamg_agg->aggressive_mis_k, NULL));
261   PetscOptionsHeadEnd();
262   PetscFunctionReturn(PETSC_SUCCESS);
263 }
264 
265 static PetscErrorCode PCDestroy_GAMG_AGG(PC pc)
266 {
267   PC_MG   *mg      = (PC_MG *)pc->data;
268   PC_GAMG *pc_gamg = (PC_GAMG *)mg->innerctx;
269 
270   PetscFunctionBegin;
271   PetscCall(PetscFree(pc_gamg->subctx));
272   PetscCall(PetscObjectComposeFunction((PetscObject)pc, "PCGAMGSetNSmooths_C", NULL));
273   PetscCall(PetscObjectComposeFunction((PetscObject)pc, "PCGAMGSetAggressiveLevels_C", NULL));
274   PetscCall(PetscObjectComposeFunction((PetscObject)pc, "PCGAMGMISkSetAggressive_C", NULL));
275   PetscCall(PetscObjectComposeFunction((PetscObject)pc, "PCGAMGMISkSetMinDegreeOrdering_C", NULL));
276   PetscCall(PetscObjectComposeFunction((PetscObject)pc, "PCGAMGSetLowMemoryFilter_C", NULL));
277   PetscCall(PetscObjectComposeFunction((PetscObject)pc, "PCGAMGSetAggressiveSquareGraph_C", NULL));
278   PetscCall(PetscObjectComposeFunction((PetscObject)pc, "PCSetCoordinates_C", NULL));
279   PetscFunctionReturn(PETSC_SUCCESS);
280 }
281 
282 /*
283    PCSetCoordinates_AGG
284 
285    Collective
286 
287    Input Parameter:
288    . pc - the preconditioner context
289    . ndm - dimension of data (used for dof/vertex for Stokes)
290    . a_nloc - number of vertices local
291    . coords - [a_nloc][ndm] - interleaved coordinate data: {x_0, y_0, z_0, x_1, y_1, ...}
292 */
293 
294 static PetscErrorCode PCSetCoordinates_AGG(PC pc, PetscInt ndm, PetscInt a_nloc, PetscReal *coords)
295 {
296   PC_MG   *mg      = (PC_MG *)pc->data;
297   PC_GAMG *pc_gamg = (PC_GAMG *)mg->innerctx;
298   PetscInt arrsz, kk, ii, jj, nloc, ndatarows, ndf;
299   Mat      mat = pc->pmat;
300 
301   PetscFunctionBegin;
302   PetscValidHeaderSpecific(pc, PC_CLASSID, 1);
303   PetscValidHeaderSpecific(mat, MAT_CLASSID, 1);
304   nloc = a_nloc;
305 
306   /* SA: null space vectors */
307   PetscCall(MatGetBlockSize(mat, &ndf));               /* this does not work for Stokes */
308   if (coords && ndf == 1) pc_gamg->data_cell_cols = 1; /* scalar w/ coords and SA (not needed) */
309   else if (coords) {
310     PetscCheck(ndm <= ndf, PETSC_COMM_SELF, PETSC_ERR_PLIB, "degrees of motion %" PetscInt_FMT " > block size %" PetscInt_FMT, ndm, ndf);
311     pc_gamg->data_cell_cols = (ndm == 2 ? 3 : 6); /* displacement elasticity */
312     if (ndm != ndf) PetscCheck(pc_gamg->data_cell_cols == ndf, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Don't know how to create null space for ndm=%" PetscInt_FMT ", ndf=%" PetscInt_FMT ".  Use MatSetNearNullSpace().", ndm, ndf);
313   } else pc_gamg->data_cell_cols = ndf; /* no data, force SA with constant null space vectors */
314   pc_gamg->data_cell_rows = ndatarows = ndf;
315   PetscCheck(pc_gamg->data_cell_cols > 0, PETSC_COMM_SELF, PETSC_ERR_PLIB, "pc_gamg->data_cell_cols %" PetscInt_FMT " <= 0", pc_gamg->data_cell_cols);
316   arrsz = nloc * pc_gamg->data_cell_rows * pc_gamg->data_cell_cols;
317 
318   if (!pc_gamg->data || (pc_gamg->data_sz != arrsz)) {
319     PetscCall(PetscFree(pc_gamg->data));
320     PetscCall(PetscMalloc1(arrsz + 1, &pc_gamg->data));
321   }
322   /* copy data in - column oriented */
323   for (kk = 0; kk < nloc; kk++) {
324     const PetscInt M    = nloc * pc_gamg->data_cell_rows; /* stride into data */
325     PetscReal     *data = &pc_gamg->data[kk * ndatarows]; /* start of cell */
326     if (pc_gamg->data_cell_cols == 1) *data = 1.0;
327     else {
328       /* translational modes */
329       for (ii = 0; ii < ndatarows; ii++) {
330         for (jj = 0; jj < ndatarows; jj++) {
331           if (ii == jj) data[ii * M + jj] = 1.0;
332           else data[ii * M + jj] = 0.0;
333         }
334       }
335 
336       /* rotational modes */
337       if (coords) {
338         if (ndm == 2) {
339           data += 2 * M;
340           data[0] = -coords[2 * kk + 1];
341           data[1] = coords[2 * kk];
342         } else {
343           data += 3 * M;
344           data[0]         = 0.0;
345           data[M + 0]     = coords[3 * kk + 2];
346           data[2 * M + 0] = -coords[3 * kk + 1];
347           data[1]         = -coords[3 * kk + 2];
348           data[M + 1]     = 0.0;
349           data[2 * M + 1] = coords[3 * kk];
350           data[2]         = coords[3 * kk + 1];
351           data[M + 2]     = -coords[3 * kk];
352           data[2 * M + 2] = 0.0;
353         }
354       }
355     }
356   }
357   pc_gamg->data_sz = arrsz;
358   PetscFunctionReturn(PETSC_SUCCESS);
359 }
360 
361 /*
362    PCSetData_AGG - called if data is not set with PCSetCoordinates.
363       Looks in Mat for near null space.
364       Does not work for Stokes
365 
366   Input Parameter:
367    . pc -
368    . a_A - matrix to get (near) null space out of.
369 */
370 static PetscErrorCode PCSetData_AGG(PC pc, Mat a_A)
371 {
372   PC_MG       *mg      = (PC_MG *)pc->data;
373   PC_GAMG     *pc_gamg = (PC_GAMG *)mg->innerctx;
374   MatNullSpace mnull;
375 
376   PetscFunctionBegin;
377   PetscCall(MatGetNearNullSpace(a_A, &mnull));
378   if (!mnull) {
379     DM dm;
380     PetscCall(PCGetDM(pc, &dm));
381     if (!dm) PetscCall(MatGetDM(a_A, &dm));
382     if (dm) {
383       PetscObject deformation;
384       PetscInt    Nf;
385 
386       PetscCall(DMGetNumFields(dm, &Nf));
387       if (Nf) {
388         PetscCall(DMGetField(dm, 0, NULL, &deformation));
389         PetscCall(PetscObjectQuery((PetscObject)deformation, "nearnullspace", (PetscObject *)&mnull));
390         if (!mnull) PetscCall(PetscObjectQuery((PetscObject)deformation, "nullspace", (PetscObject *)&mnull));
391       }
392     }
393   }
394 
395   if (!mnull) {
396     PetscInt bs, NN, MM;
397     PetscCall(MatGetBlockSize(a_A, &bs));
398     PetscCall(MatGetLocalSize(a_A, &MM, &NN));
399     PetscCheck(MM % bs == 0, PETSC_COMM_SELF, PETSC_ERR_PLIB, "MM %" PetscInt_FMT " must be divisible by bs %" PetscInt_FMT, MM, bs);
400     PetscCall(PCSetCoordinates_AGG(pc, bs, MM / bs, NULL));
401   } else {
402     PetscReal         *nullvec;
403     PetscBool          has_const;
404     PetscInt           i, j, mlocal, nvec, bs;
405     const Vec         *vecs;
406     const PetscScalar *v;
407 
408     PetscCall(MatGetLocalSize(a_A, &mlocal, NULL));
409     PetscCall(MatNullSpaceGetVecs(mnull, &has_const, &nvec, &vecs));
410     for (i = 0; i < nvec; i++) {
411       PetscCall(VecGetLocalSize(vecs[i], &j));
412       PetscCheck(j == mlocal, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Attached null space vector size %" PetscInt_FMT " != matrix size %" PetscInt_FMT, j, mlocal);
413     }
414     pc_gamg->data_sz = (nvec + !!has_const) * mlocal;
415     PetscCall(PetscMalloc1((nvec + !!has_const) * mlocal, &nullvec));
416     if (has_const)
417       for (i = 0; i < mlocal; i++) nullvec[i] = 1.0;
418     for (i = 0; i < nvec; i++) {
419       PetscCall(VecGetArrayRead(vecs[i], &v));
420       for (j = 0; j < mlocal; j++) nullvec[(i + !!has_const) * mlocal + j] = PetscRealPart(v[j]);
421       PetscCall(VecRestoreArrayRead(vecs[i], &v));
422     }
423     pc_gamg->data           = nullvec;
424     pc_gamg->data_cell_cols = (nvec + !!has_const);
425     PetscCall(MatGetBlockSize(a_A, &bs));
426     pc_gamg->data_cell_rows = bs;
427   }
428   PetscFunctionReturn(PETSC_SUCCESS);
429 }
430 
431 /*
432   formProl0 - collect null space data for each aggregate, do QR, put R in coarse grid data and Q in P_0
433 
434   Input Parameter:
435    . agg_llists - list of arrays with aggregates -- list from selected vertices of aggregate unselected vertices
436    . bs - row block size
437    . nSAvec - column bs of new P
438    . my0crs - global index of start of locals
439    . data_stride - bs*(nloc nodes + ghost nodes) [data_stride][nSAvec]
440    . data_in[data_stride*nSAvec] - local data on fine grid
441    . flid_fgid[data_stride/bs] - make local to global IDs, includes ghosts in 'locals_llist'
442 
443   Output Parameter:
444    . a_data_out - in with fine grid data (w/ghosts), out with coarse grid data
445    . a_Prol - prolongation operator
446 */
447 static PetscErrorCode formProl0(PetscCoarsenData *agg_llists, PetscInt bs, PetscInt nSAvec, PetscInt my0crs, PetscInt data_stride, PetscReal data_in[], const PetscInt flid_fgid[], PetscReal **a_data_out, Mat a_Prol)
448 {
449   PetscInt        Istart, my0, Iend, nloc, clid, flid = 0, aggID, kk, jj, ii, mm, nSelected, minsz, nghosts, out_data_stride;
450   MPI_Comm        comm;
451   PetscReal      *out_data;
452   PetscCDIntNd   *pos;
453   PCGAMGHashTable fgid_flid;
454 
455   PetscFunctionBegin;
456   PetscCall(PetscObjectGetComm((PetscObject)a_Prol, &comm));
457   PetscCall(MatGetOwnershipRange(a_Prol, &Istart, &Iend));
458   nloc = (Iend - Istart) / bs;
459   my0  = Istart / bs;
460   PetscCheck((Iend - Istart) % bs == 0, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Iend %" PetscInt_FMT " - Istart %" PetscInt_FMT " must be divisible by bs %" PetscInt_FMT, Iend, Istart, bs);
461   Iend /= bs;
462   nghosts = data_stride / bs - nloc;
463 
464   PetscCall(PCGAMGHashTableCreate(2 * nghosts + 1, &fgid_flid));
465   for (kk = 0; kk < nghosts; kk++) PetscCall(PCGAMGHashTableAdd(&fgid_flid, flid_fgid[nloc + kk], nloc + kk));
466 
467   /* count selected -- same as number of cols of P */
468   for (nSelected = mm = 0; mm < nloc; mm++) {
469     PetscBool ise;
470     PetscCall(PetscCDIsEmptyAt(agg_llists, mm, &ise));
471     if (!ise) nSelected++;
472   }
473   PetscCall(MatGetOwnershipRangeColumn(a_Prol, &ii, &jj));
474   PetscCheck((ii / nSAvec) == my0crs, PETSC_COMM_SELF, PETSC_ERR_PLIB, "ii %" PetscInt_FMT " /nSAvec %" PetscInt_FMT "  != my0crs %" PetscInt_FMT, ii, nSAvec, my0crs);
475   PetscCheck(nSelected == (jj - ii) / nSAvec, PETSC_COMM_SELF, PETSC_ERR_PLIB, "nSelected %" PetscInt_FMT " != (jj %" PetscInt_FMT " - ii %" PetscInt_FMT ")/nSAvec %" PetscInt_FMT, nSelected, jj, ii, nSAvec);
476 
477   /* aloc space for coarse point data (output) */
478   out_data_stride = nSelected * nSAvec;
479 
480   PetscCall(PetscMalloc1(out_data_stride * nSAvec, &out_data));
481   for (ii = 0; ii < out_data_stride * nSAvec; ii++) out_data[ii] = PETSC_MAX_REAL;
482   *a_data_out = out_data; /* output - stride nSelected*nSAvec */
483 
484   /* find points and set prolongation */
485   minsz = 100;
486   for (mm = clid = 0; mm < nloc; mm++) {
487     PetscCall(PetscCDCountAt(agg_llists, mm, &jj));
488     if (jj > 0) {
489       const PetscInt lid = mm, cgid = my0crs + clid;
490       PetscInt       cids[100]; /* max bs */
491       PetscBLASInt   asz = jj, M = asz * bs, N = nSAvec, INFO;
492       PetscBLASInt   Mdata = M + ((N - M > 0) ? N - M : 0), LDA = Mdata, LWORK = N * bs;
493       PetscScalar   *qqc, *qqr, *TAU, *WORK;
494       PetscInt      *fids;
495       PetscReal     *data;
496 
497       /* count agg */
498       if (asz < minsz) minsz = asz;
499 
500       /* get block */
501       PetscCall(PetscMalloc5(Mdata * N, &qqc, M * N, &qqr, N, &TAU, LWORK, &WORK, M, &fids));
502 
503       aggID = 0;
504       PetscCall(PetscCDGetHeadPos(agg_llists, lid, &pos));
505       while (pos) {
506         PetscInt gid1;
507         PetscCall(PetscCDIntNdGetID(pos, &gid1));
508         PetscCall(PetscCDGetNextPos(agg_llists, lid, &pos));
509 
510         if (gid1 >= my0 && gid1 < Iend) flid = gid1 - my0;
511         else {
512           PetscCall(PCGAMGHashTableFind(&fgid_flid, gid1, &flid));
513           PetscCheck(flid >= 0, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Cannot find gid1 in table");
514         }
515         /* copy in B_i matrix - column oriented */
516         data = &data_in[flid * bs];
517         for (ii = 0; ii < bs; ii++) {
518           for (jj = 0; jj < N; jj++) {
519             PetscReal d                       = data[jj * data_stride + ii];
520             qqc[jj * Mdata + aggID * bs + ii] = d;
521           }
522         }
523         /* set fine IDs */
524         for (kk = 0; kk < bs; kk++) fids[aggID * bs + kk] = flid_fgid[flid] * bs + kk;
525         aggID++;
526       }
527 
528       /* pad with zeros */
529       for (ii = asz * bs; ii < Mdata; ii++) {
530         for (jj = 0; jj < N; jj++, kk++) qqc[jj * Mdata + ii] = .0;
531       }
532 
533       /* QR */
534       PetscCall(PetscFPTrapPush(PETSC_FP_TRAP_OFF));
535       PetscCallBLAS("LAPACKgeqrf", LAPACKgeqrf_(&Mdata, &N, qqc, &LDA, TAU, WORK, &LWORK, &INFO));
536       PetscCall(PetscFPTrapPop());
537       PetscCheck(INFO == 0, PETSC_COMM_SELF, PETSC_ERR_PLIB, "xGEQRF error");
538       /* get R - column oriented - output B_{i+1} */
539       {
540         PetscReal *data = &out_data[clid * nSAvec];
541         for (jj = 0; jj < nSAvec; jj++) {
542           for (ii = 0; ii < nSAvec; ii++) {
543             PetscCheck(data[jj * out_data_stride + ii] == PETSC_MAX_REAL, PETSC_COMM_SELF, PETSC_ERR_PLIB, "data[jj*out_data_stride + ii] != %e", (double)PETSC_MAX_REAL);
544             if (ii <= jj) data[jj * out_data_stride + ii] = PetscRealPart(qqc[jj * Mdata + ii]);
545             else data[jj * out_data_stride + ii] = 0.;
546           }
547         }
548       }
549 
550       /* get Q - row oriented */
551       PetscCallBLAS("LAPACKorgqr", LAPACKorgqr_(&Mdata, &N, &N, qqc, &LDA, TAU, WORK, &LWORK, &INFO));
552       PetscCheck(INFO == 0, PETSC_COMM_SELF, PETSC_ERR_PLIB, "xORGQR error arg %" PetscBLASInt_FMT, -INFO);
553 
554       for (ii = 0; ii < M; ii++) {
555         for (jj = 0; jj < N; jj++) qqr[N * ii + jj] = qqc[jj * Mdata + ii];
556       }
557 
558       /* add diagonal block of P0 */
559       for (kk = 0; kk < N; kk++) { cids[kk] = N * cgid + kk; /* global col IDs in P0 */ }
560       PetscCall(MatSetValues(a_Prol, M, fids, N, cids, qqr, INSERT_VALUES));
561       PetscCall(PetscFree5(qqc, qqr, TAU, WORK, fids));
562       clid++;
563     } /* coarse agg */
564   }   /* for all fine nodes */
565   PetscCall(MatAssemblyBegin(a_Prol, MAT_FINAL_ASSEMBLY));
566   PetscCall(MatAssemblyEnd(a_Prol, MAT_FINAL_ASSEMBLY));
567   PetscCall(PCGAMGHashTableDestroy(&fgid_flid));
568   PetscFunctionReturn(PETSC_SUCCESS);
569 }
570 
571 static PetscErrorCode PCView_GAMG_AGG(PC pc, PetscViewer viewer)
572 {
573   PC_MG       *mg          = (PC_MG *)pc->data;
574   PC_GAMG     *pc_gamg     = (PC_GAMG *)mg->innerctx;
575   PC_GAMG_AGG *pc_gamg_agg = (PC_GAMG_AGG *)pc_gamg->subctx;
576 
577   PetscFunctionBegin;
578   PetscCall(PetscViewerASCIIPrintf(viewer, "      AGG specific options\n"));
579   PetscCall(PetscViewerASCIIPrintf(viewer, "        Number of levels of aggressive coarsening %d\n", (int)pc_gamg_agg->aggressive_coarsening_levels));
580   if (pc_gamg_agg->aggressive_coarsening_levels > 0) {
581     PetscCall(PetscViewerASCIIPrintf(viewer, "        %s aggressive coarsening\n", !pc_gamg_agg->use_aggressive_square_graph ? "MIS-k" : "Square graph"));
582     if (!pc_gamg_agg->use_aggressive_square_graph) PetscCall(PetscViewerASCIIPrintf(viewer, "        MIS-%d coarsening on aggressive levels\n", (int)pc_gamg_agg->aggressive_mis_k));
583   }
584   PetscCall(PetscViewerASCIIPrintf(viewer, "        Number smoothing steps %d\n", (int)pc_gamg_agg->nsmooths));
585   PetscFunctionReturn(PETSC_SUCCESS);
586 }
587 
588 static PetscErrorCode PCGAMGCreateGraph_AGG(PC pc, Mat Amat, Mat *a_Gmat)
589 {
590   PC_MG          *mg          = (PC_MG *)pc->data;
591   PC_GAMG        *pc_gamg     = (PC_GAMG *)mg->innerctx;
592   PC_GAMG_AGG    *pc_gamg_agg = (PC_GAMG_AGG *)pc_gamg->subctx;
593   const PetscReal vfilter     = pc_gamg->threshold[pc_gamg->current_level];
594   PetscBool       ishem, ismis;
595   const char     *prefix;
596   MatInfo         info0, info1;
597   PetscInt        bs;
598 
599   PetscFunctionBegin;
600   PetscCall(PetscLogEventBegin(petsc_gamg_setup_events[GAMG_COARSEN], 0, 0, 0, 0));
601   /* Note: depending on the algorithm that will be used for computing the coarse grid points this should pass PETSC_TRUE or PETSC_FALSE as the first argument */
602   /* MATCOARSENHEM requires numerical weights for edges so ensure they are computed */
603   PetscCall(MatCoarsenCreate(PetscObjectComm((PetscObject)pc), &pc_gamg_agg->crs));
604   PetscCall(PetscObjectGetOptionsPrefix((PetscObject)pc, &prefix));
605   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)pc_gamg_agg->crs, prefix));
606   PetscCall(MatCoarsenSetFromOptions(pc_gamg_agg->crs));
607   PetscCall(MatGetBlockSize(Amat, &bs));
608   // check for valid indices wrt bs
609   for (int ii = 0; ii < pc_gamg_agg->crs->strength_index_size; ii++) {
610     PetscCheck(pc_gamg_agg->crs->strength_index[ii] >= 0 && pc_gamg_agg->crs->strength_index[ii] < bs, PetscObjectComm((PetscObject)pc), PETSC_ERR_ARG_WRONG, "Indices (%d) must be non-negative and < block size (%d)", (int)pc_gamg_agg->crs->strength_index[ii], (int)bs);
611   }
612   PetscCall(PetscObjectTypeCompare((PetscObject)pc_gamg_agg->crs, MATCOARSENHEM, &ishem));
613   if (ishem) {
614     if (pc_gamg_agg->aggressive_coarsening_levels) PetscCall(PetscInfo(pc, "HEM and aggressive coarsening ignored: HEM using %d iterations\n", (int)pc_gamg_agg->crs->max_it));
615     pc_gamg_agg->aggressive_coarsening_levels = 0;                                         // aggressive and HEM does not make sense
616     PetscCall(MatCoarsenSetMaximumIterations(pc_gamg_agg->crs, pc_gamg_agg->crs->max_it)); // for code coverage
617     PetscCall(MatCoarsenSetThreshold(pc_gamg_agg->crs, vfilter));                          // for code coverage
618   } else {
619     PetscCall(PetscObjectTypeCompare((PetscObject)pc_gamg_agg->crs, MATCOARSENMIS, &ismis));
620     if (ismis && pc_gamg_agg->aggressive_coarsening_levels && !pc_gamg_agg->use_aggressive_square_graph) {
621       PetscCall(PetscInfo(pc, "MIS and aggressive coarsening and no square graph: force square graph\n"));
622       pc_gamg_agg->use_aggressive_square_graph = PETSC_TRUE;
623     }
624   }
625   PetscCall(PetscLogEventEnd(petsc_gamg_setup_events[GAMG_COARSEN], 0, 0, 0, 0));
626   PetscCall(PetscLogEventBegin(petsc_gamg_setup_events[GAMG_GRAPH], 0, 0, 0, 0));
627   PetscCall(MatGetInfo(Amat, MAT_LOCAL, &info0)); /* global reduction */
628 
629   if (ishem || pc_gamg_agg->use_low_mem_filter) {
630     PetscCall(MatCreateGraph(Amat, PETSC_TRUE, (vfilter >= 0 || ishem) ? PETSC_TRUE : PETSC_FALSE, vfilter, pc_gamg_agg->crs->strength_index_size, pc_gamg_agg->crs->strength_index, a_Gmat));
631   } else {
632     // make scalar graph, symetrize if not know to be symetric, scale, but do not filter (expensive)
633     PetscCall(MatCreateGraph(Amat, PETSC_TRUE, PETSC_TRUE, -1, pc_gamg_agg->crs->strength_index_size, pc_gamg_agg->crs->strength_index, a_Gmat));
634     if (vfilter >= 0) {
635       PetscInt           Istart, Iend, ncols, nnz0, nnz1, NN, MM, nloc;
636       Mat                tGmat, Gmat = *a_Gmat;
637       MPI_Comm           comm;
638       const PetscScalar *vals;
639       const PetscInt    *idx;
640       PetscInt          *d_nnz, *o_nnz, kk, *garray = NULL, *AJ, maxcols = 0;
641       MatScalar         *AA; // this is checked in graph
642       PetscBool          isseqaij;
643       Mat                a, b, c;
644       MatType            jtype;
645 
646       PetscCall(PetscObjectGetComm((PetscObject)Gmat, &comm));
647       PetscCall(PetscObjectBaseTypeCompare((PetscObject)Gmat, MATSEQAIJ, &isseqaij));
648       PetscCall(MatGetType(Gmat, &jtype));
649       PetscCall(MatCreate(comm, &tGmat));
650       PetscCall(MatSetType(tGmat, jtype));
651 
652       /* TODO GPU: this can be called when filter = 0 -> Probably provide MatAIJThresholdCompress that compresses the entries below a threshold?
653         Also, if the matrix is symmetric, can we skip this
654         operation? It can be very expensive on large matrices. */
655 
656       // global sizes
657       PetscCall(MatGetSize(Gmat, &MM, &NN));
658       PetscCall(MatGetOwnershipRange(Gmat, &Istart, &Iend));
659       nloc = Iend - Istart;
660       PetscCall(PetscMalloc2(nloc, &d_nnz, nloc, &o_nnz));
661       if (isseqaij) {
662         a = Gmat;
663         b = NULL;
664       } else {
665         Mat_MPIAIJ *d = (Mat_MPIAIJ *)Gmat->data;
666         a             = d->A;
667         b             = d->B;
668         garray        = d->garray;
669       }
670       /* Determine upper bound on non-zeros needed in new filtered matrix */
671       for (PetscInt row = 0; row < nloc; row++) {
672         PetscCall(MatGetRow(a, row, &ncols, NULL, NULL));
673         d_nnz[row] = ncols;
674         if (ncols > maxcols) maxcols = ncols;
675         PetscCall(MatRestoreRow(a, row, &ncols, NULL, NULL));
676       }
677       if (b) {
678         for (PetscInt row = 0; row < nloc; row++) {
679           PetscCall(MatGetRow(b, row, &ncols, NULL, NULL));
680           o_nnz[row] = ncols;
681           if (ncols > maxcols) maxcols = ncols;
682           PetscCall(MatRestoreRow(b, row, &ncols, NULL, NULL));
683         }
684       }
685       PetscCall(MatSetSizes(tGmat, nloc, nloc, MM, MM));
686       PetscCall(MatSetBlockSizes(tGmat, 1, 1));
687       PetscCall(MatSeqAIJSetPreallocation(tGmat, 0, d_nnz));
688       PetscCall(MatMPIAIJSetPreallocation(tGmat, 0, d_nnz, 0, o_nnz));
689       PetscCall(MatSetOption(tGmat, MAT_NO_OFF_PROC_ENTRIES, PETSC_TRUE));
690       PetscCall(PetscFree2(d_nnz, o_nnz));
691       PetscCall(PetscMalloc2(maxcols, &AA, maxcols, &AJ));
692       nnz0 = nnz1 = 0;
693       for (c = a, kk = 0; c && kk < 2; c = b, kk++) {
694         for (PetscInt row = 0, grow = Istart, ncol_row, jj; row < nloc; row++, grow++) {
695           PetscCall(MatGetRow(c, row, &ncols, &idx, &vals));
696           for (ncol_row = jj = 0; jj < ncols; jj++, nnz0++) {
697             PetscScalar sv = PetscAbs(PetscRealPart(vals[jj]));
698             if (PetscRealPart(sv) > vfilter) {
699               PetscInt cid = idx[jj] + Istart; //diag
700               nnz1++;
701               if (c != a) cid = garray[idx[jj]];
702               AA[ncol_row] = vals[jj];
703               AJ[ncol_row] = cid;
704               ncol_row++;
705             }
706           }
707           PetscCall(MatRestoreRow(c, row, &ncols, &idx, &vals));
708           PetscCall(MatSetValues(tGmat, 1, &grow, ncol_row, AJ, AA, INSERT_VALUES));
709         }
710       }
711       PetscCall(PetscFree2(AA, AJ));
712       PetscCall(MatAssemblyBegin(tGmat, MAT_FINAL_ASSEMBLY));
713       PetscCall(MatAssemblyEnd(tGmat, MAT_FINAL_ASSEMBLY));
714       PetscCall(MatPropagateSymmetryOptions(Gmat, tGmat)); /* Normal Mat options are not relevant ? */
715       PetscCall(PetscInfo(pc, "\t %g%% nnz after filtering, with threshold %g, %g nnz ave. (N=%" PetscInt_FMT ", max row size %" PetscInt_FMT "\n", (!nnz0) ? 1. : 100. * (double)nnz1 / (double)nnz0, (double)vfilter, (!nloc) ? 1. : (double)nnz0 / (double)nloc, MM, maxcols));
716       PetscCall(MatViewFromOptions(tGmat, NULL, "-mat_filter_graph_view"));
717       PetscCall(MatDestroy(&Gmat));
718       *a_Gmat = tGmat;
719     }
720   }
721 
722   PetscCall(MatGetInfo(*a_Gmat, MAT_LOCAL, &info1)); /* global reduction */
723   if (info0.nz_used > 0) PetscCall(PetscInfo(pc, "Filtering left %g %% edges in graph (%e %e)\n", 100.0 * info1.nz_used * (double)(bs * bs) / info0.nz_used, info0.nz_used, info1.nz_used));
724   PetscCall(PetscLogEventEnd(petsc_gamg_setup_events[GAMG_GRAPH], 0, 0, 0, 0));
725   PetscFunctionReturn(PETSC_SUCCESS);
726 }
727 
728 typedef PetscInt    NState;
729 static const NState NOT_DONE = -2;
730 static const NState DELETED  = -1;
731 static const NState REMOVED  = -3;
732 #define IS_SELECTED(s) (s != DELETED && s != NOT_DONE && s != REMOVED)
733 
734 /*
735    fixAggregatesWithSquare - greedy grab of with G1 (unsquared graph) -- AIJ specific -- change to fixAggregatesWithSquare -- TODD
736      - AGG-MG specific: clears singletons out of 'selected_2'
737 
738    Input Parameter:
739    . Gmat_2 - global matrix of squared graph (data not defined)
740    . Gmat_1 - base graph to grab with base graph
741    Input/Output Parameter:
742    . aggs_2 - linked list of aggs with gids)
743 */
744 static PetscErrorCode fixAggregatesWithSquare(PC pc, Mat Gmat_2, Mat Gmat_1, PetscCoarsenData *aggs_2)
745 {
746   PetscBool      isMPI;
747   Mat_SeqAIJ    *matA_1, *matB_1 = NULL;
748   MPI_Comm       comm;
749   PetscInt       lid, *ii, *idx, ix, Iend, my0, kk, n, j;
750   Mat_MPIAIJ    *mpimat_2 = NULL, *mpimat_1 = NULL;
751   const PetscInt nloc = Gmat_2->rmap->n;
752   PetscScalar   *cpcol_1_state, *cpcol_2_state, *cpcol_2_par_orig, *lid_parent_gid;
753   PetscInt      *lid_cprowID_1 = NULL;
754   NState        *lid_state;
755   Vec            ghost_par_orig2;
756   PetscMPIInt    rank;
757 
758   PetscFunctionBegin;
759   PetscCall(PetscObjectGetComm((PetscObject)Gmat_2, &comm));
760   PetscCallMPI(MPI_Comm_rank(comm, &rank));
761   PetscCall(MatGetOwnershipRange(Gmat_1, &my0, &Iend));
762 
763   /* get submatrices */
764   PetscCall(PetscStrbeginswith(((PetscObject)Gmat_1)->type_name, MATMPIAIJ, &isMPI));
765   PetscCall(PetscInfo(pc, "isMPI = %s\n", isMPI ? "yes" : "no"));
766   PetscCall(PetscMalloc3(nloc, &lid_state, nloc, &lid_parent_gid, nloc, &lid_cprowID_1));
767   for (lid = 0; lid < nloc; lid++) lid_cprowID_1[lid] = -1;
768   if (isMPI) {
769     /* grab matrix objects */
770     mpimat_2 = (Mat_MPIAIJ *)Gmat_2->data;
771     mpimat_1 = (Mat_MPIAIJ *)Gmat_1->data;
772     matA_1   = (Mat_SeqAIJ *)mpimat_1->A->data;
773     matB_1   = (Mat_SeqAIJ *)mpimat_1->B->data;
774 
775     /* force compressed row storage for B matrix in AuxMat */
776     PetscCall(MatCheckCompressedRow(mpimat_1->B, matB_1->nonzerorowcnt, &matB_1->compressedrow, matB_1->i, Gmat_1->rmap->n, -1.0));
777     for (ix = 0; ix < matB_1->compressedrow.nrows; ix++) {
778       PetscInt lid = matB_1->compressedrow.rindex[ix];
779       PetscCheck(lid <= nloc && lid >= -1, PETSC_COMM_SELF, PETSC_ERR_USER, "lid %d out of range. nloc = %d", (int)lid, (int)nloc);
780       if (lid != -1) lid_cprowID_1[lid] = ix;
781     }
782   } else {
783     PetscBool isAIJ;
784     PetscCall(PetscStrbeginswith(((PetscObject)Gmat_1)->type_name, MATSEQAIJ, &isAIJ));
785     PetscCheck(isAIJ, PETSC_COMM_SELF, PETSC_ERR_USER, "Require AIJ matrix.");
786     matA_1 = (Mat_SeqAIJ *)Gmat_1->data;
787   }
788   if (nloc > 0) { PetscCheck(!matB_1 || matB_1->compressedrow.use, PETSC_COMM_SELF, PETSC_ERR_PLIB, "matB_1 && !matB_1->compressedrow.use: PETSc bug???"); }
789   /* get state of locals and selected gid for deleted */
790   for (lid = 0; lid < nloc; lid++) {
791     lid_parent_gid[lid] = -1.0;
792     lid_state[lid]      = DELETED;
793   }
794 
795   /* set lid_state */
796   for (lid = 0; lid < nloc; lid++) {
797     PetscCDIntNd *pos;
798     PetscCall(PetscCDGetHeadPos(aggs_2, lid, &pos));
799     if (pos) {
800       PetscInt gid1;
801 
802       PetscCall(PetscCDIntNdGetID(pos, &gid1));
803       PetscCheck(gid1 == lid + my0, PETSC_COMM_SELF, PETSC_ERR_PLIB, "gid1 %d != lid %d + my0 %d", (int)gid1, (int)lid, (int)my0);
804       lid_state[lid] = gid1;
805     }
806   }
807 
808   /* map local to selected local, DELETED means a ghost owns it */
809   for (lid = kk = 0; lid < nloc; lid++) {
810     NState state = lid_state[lid];
811     if (IS_SELECTED(state)) {
812       PetscCDIntNd *pos;
813       PetscCall(PetscCDGetHeadPos(aggs_2, lid, &pos));
814       while (pos) {
815         PetscInt gid1;
816         PetscCall(PetscCDIntNdGetID(pos, &gid1));
817         PetscCall(PetscCDGetNextPos(aggs_2, lid, &pos));
818         if (gid1 >= my0 && gid1 < Iend) lid_parent_gid[gid1 - my0] = (PetscScalar)(lid + my0);
819       }
820     }
821   }
822   /* get 'cpcol_1/2_state' & cpcol_2_par_orig - uses mpimat_1/2->lvec for temp space */
823   if (isMPI) {
824     Vec tempVec;
825     /* get 'cpcol_1_state' */
826     PetscCall(MatCreateVecs(Gmat_1, &tempVec, NULL));
827     for (kk = 0, j = my0; kk < nloc; kk++, j++) {
828       PetscScalar v = (PetscScalar)lid_state[kk];
829       PetscCall(VecSetValues(tempVec, 1, &j, &v, INSERT_VALUES));
830     }
831     PetscCall(VecAssemblyBegin(tempVec));
832     PetscCall(VecAssemblyEnd(tempVec));
833     PetscCall(VecScatterBegin(mpimat_1->Mvctx, tempVec, mpimat_1->lvec, INSERT_VALUES, SCATTER_FORWARD));
834     PetscCall(VecScatterEnd(mpimat_1->Mvctx, tempVec, mpimat_1->lvec, INSERT_VALUES, SCATTER_FORWARD));
835     PetscCall(VecGetArray(mpimat_1->lvec, &cpcol_1_state));
836     /* get 'cpcol_2_state' */
837     PetscCall(VecScatterBegin(mpimat_2->Mvctx, tempVec, mpimat_2->lvec, INSERT_VALUES, SCATTER_FORWARD));
838     PetscCall(VecScatterEnd(mpimat_2->Mvctx, tempVec, mpimat_2->lvec, INSERT_VALUES, SCATTER_FORWARD));
839     PetscCall(VecGetArray(mpimat_2->lvec, &cpcol_2_state));
840     /* get 'cpcol_2_par_orig' */
841     for (kk = 0, j = my0; kk < nloc; kk++, j++) {
842       PetscScalar v = (PetscScalar)lid_parent_gid[kk];
843       PetscCall(VecSetValues(tempVec, 1, &j, &v, INSERT_VALUES));
844     }
845     PetscCall(VecAssemblyBegin(tempVec));
846     PetscCall(VecAssemblyEnd(tempVec));
847     PetscCall(VecDuplicate(mpimat_2->lvec, &ghost_par_orig2));
848     PetscCall(VecScatterBegin(mpimat_2->Mvctx, tempVec, ghost_par_orig2, INSERT_VALUES, SCATTER_FORWARD));
849     PetscCall(VecScatterEnd(mpimat_2->Mvctx, tempVec, ghost_par_orig2, INSERT_VALUES, SCATTER_FORWARD));
850     PetscCall(VecGetArray(ghost_par_orig2, &cpcol_2_par_orig));
851 
852     PetscCall(VecDestroy(&tempVec));
853   } /* ismpi */
854   for (lid = 0; lid < nloc; lid++) {
855     NState state = lid_state[lid];
856     if (IS_SELECTED(state)) {
857       /* steal locals */
858       ii  = matA_1->i;
859       n   = ii[lid + 1] - ii[lid];
860       idx = matA_1->j + ii[lid];
861       for (j = 0; j < n; j++) {
862         PetscInt lidj   = idx[j], sgid;
863         NState   statej = lid_state[lidj];
864         if (statej == DELETED && (sgid = (PetscInt)PetscRealPart(lid_parent_gid[lidj])) != lid + my0) { /* steal local */
865           lid_parent_gid[lidj] = (PetscScalar)(lid + my0);                                              /* send this if sgid is not local */
866           if (sgid >= my0 && sgid < Iend) {                                                             /* I'm stealing this local from a local sgid */
867             PetscInt      hav = 0, slid = sgid - my0, gidj = lidj + my0;
868             PetscCDIntNd *pos, *last = NULL;
869             /* looking for local from local so id_llist_2 works */
870             PetscCall(PetscCDGetHeadPos(aggs_2, slid, &pos));
871             while (pos) {
872               PetscInt gid;
873               PetscCall(PetscCDIntNdGetID(pos, &gid));
874               if (gid == gidj) {
875                 PetscCheck(last, PETSC_COMM_SELF, PETSC_ERR_PLIB, "last cannot be null");
876                 PetscCall(PetscCDRemoveNextNode(aggs_2, slid, last));
877                 PetscCall(PetscCDAppendNode(aggs_2, lid, pos));
878                 hav = 1;
879                 break;
880               } else last = pos;
881               PetscCall(PetscCDGetNextPos(aggs_2, slid, &pos));
882             }
883             if (hav != 1) {
884               PetscCheck(hav, PETSC_COMM_SELF, PETSC_ERR_PLIB, "failed to find adj in 'selected' lists - structurally unsymmetric matrix");
885               SETERRQ(PETSC_COMM_SELF, PETSC_ERR_PLIB, "found node %d times???", (int)hav);
886             }
887           } else { /* I'm stealing this local, owned by a ghost */
888             PetscCheck(sgid == -1, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Mat has an un-symmetric graph. Use '-%spc_gamg_sym_graph true' to symmetrize the graph or '-%spc_gamg_threshold -1' if the matrix is structurally symmetric.",
889                        ((PetscObject)pc)->prefix ? ((PetscObject)pc)->prefix : "", ((PetscObject)pc)->prefix ? ((PetscObject)pc)->prefix : "");
890             PetscCall(PetscCDAppendID(aggs_2, lid, lidj + my0));
891           }
892         }
893       } /* local neighbors */
894     } else if (state == DELETED /* && lid_cprowID_1 */) {
895       PetscInt sgidold = (PetscInt)PetscRealPart(lid_parent_gid[lid]);
896       /* see if I have a selected ghost neighbor that will steal me */
897       if ((ix = lid_cprowID_1[lid]) != -1) {
898         ii  = matB_1->compressedrow.i;
899         n   = ii[ix + 1] - ii[ix];
900         idx = matB_1->j + ii[ix];
901         for (j = 0; j < n; j++) {
902           PetscInt cpid   = idx[j];
903           NState   statej = (NState)PetscRealPart(cpcol_1_state[cpid]);
904           if (IS_SELECTED(statej) && sgidold != (PetscInt)statej) { /* ghost will steal this, remove from my list */
905             lid_parent_gid[lid] = (PetscScalar)statej;              /* send who selected */
906             if (sgidold >= my0 && sgidold < Iend) {                 /* this was mine */
907               PetscInt      hav = 0, oldslidj = sgidold - my0;
908               PetscCDIntNd *pos, *last        = NULL;
909               /* remove from 'oldslidj' list */
910               PetscCall(PetscCDGetHeadPos(aggs_2, oldslidj, &pos));
911               while (pos) {
912                 PetscInt gid;
913                 PetscCall(PetscCDIntNdGetID(pos, &gid));
914                 if (lid + my0 == gid) {
915                   /* id_llist_2[lastid] = id_llist_2[flid];   /\* remove lid from oldslidj list *\/ */
916                   PetscCheck(last, PETSC_COMM_SELF, PETSC_ERR_PLIB, "last cannot be null");
917                   PetscCall(PetscCDRemoveNextNode(aggs_2, oldslidj, last));
918                   /* ghost (PetscScalar)statej will add this later */
919                   hav = 1;
920                   break;
921                 } else last = pos;
922                 PetscCall(PetscCDGetNextPos(aggs_2, oldslidj, &pos));
923               }
924               if (hav != 1) {
925                 PetscCheck(hav, PETSC_COMM_SELF, PETSC_ERR_PLIB, "failed to find (hav=%d) adj in 'selected' lists - structurally unsymmetric matrix", (int)hav);
926                 SETERRQ(PETSC_COMM_SELF, PETSC_ERR_PLIB, "found node %d times???", (int)hav);
927               }
928             } else {
929               /* TODO: ghosts remove this later */
930             }
931           }
932         }
933       }
934     } /* selected/deleted */
935   }   /* node loop */
936 
937   if (isMPI) {
938     PetscScalar    *cpcol_2_parent, *cpcol_2_gid;
939     Vec             tempVec, ghostgids2, ghostparents2;
940     PetscInt        cpid, nghost_2;
941     PCGAMGHashTable gid_cpid;
942 
943     PetscCall(VecGetSize(mpimat_2->lvec, &nghost_2));
944     PetscCall(MatCreateVecs(Gmat_2, &tempVec, NULL));
945 
946     /* get 'cpcol_2_parent' */
947     for (kk = 0, j = my0; kk < nloc; kk++, j++) { PetscCall(VecSetValues(tempVec, 1, &j, &lid_parent_gid[kk], INSERT_VALUES)); }
948     PetscCall(VecAssemblyBegin(tempVec));
949     PetscCall(VecAssemblyEnd(tempVec));
950     PetscCall(VecDuplicate(mpimat_2->lvec, &ghostparents2));
951     PetscCall(VecScatterBegin(mpimat_2->Mvctx, tempVec, ghostparents2, INSERT_VALUES, SCATTER_FORWARD));
952     PetscCall(VecScatterEnd(mpimat_2->Mvctx, tempVec, ghostparents2, INSERT_VALUES, SCATTER_FORWARD));
953     PetscCall(VecGetArray(ghostparents2, &cpcol_2_parent));
954 
955     /* get 'cpcol_2_gid' */
956     for (kk = 0, j = my0; kk < nloc; kk++, j++) {
957       PetscScalar v = (PetscScalar)j;
958       PetscCall(VecSetValues(tempVec, 1, &j, &v, INSERT_VALUES));
959     }
960     PetscCall(VecAssemblyBegin(tempVec));
961     PetscCall(VecAssemblyEnd(tempVec));
962     PetscCall(VecDuplicate(mpimat_2->lvec, &ghostgids2));
963     PetscCall(VecScatterBegin(mpimat_2->Mvctx, tempVec, ghostgids2, INSERT_VALUES, SCATTER_FORWARD));
964     PetscCall(VecScatterEnd(mpimat_2->Mvctx, tempVec, ghostgids2, INSERT_VALUES, SCATTER_FORWARD));
965     PetscCall(VecGetArray(ghostgids2, &cpcol_2_gid));
966     PetscCall(VecDestroy(&tempVec));
967 
968     /* look for deleted ghosts and add to table */
969     PetscCall(PCGAMGHashTableCreate(2 * nghost_2 + 1, &gid_cpid));
970     for (cpid = 0; cpid < nghost_2; cpid++) {
971       NState state = (NState)PetscRealPart(cpcol_2_state[cpid]);
972       if (state == DELETED) {
973         PetscInt sgid_new = (PetscInt)PetscRealPart(cpcol_2_parent[cpid]);
974         PetscInt sgid_old = (PetscInt)PetscRealPart(cpcol_2_par_orig[cpid]);
975         if (sgid_old == -1 && sgid_new != -1) {
976           PetscInt gid = (PetscInt)PetscRealPart(cpcol_2_gid[cpid]);
977           PetscCall(PCGAMGHashTableAdd(&gid_cpid, gid, cpid));
978         }
979       }
980     }
981 
982     /* look for deleted ghosts and see if they moved - remove it */
983     for (lid = 0; lid < nloc; lid++) {
984       NState state = lid_state[lid];
985       if (IS_SELECTED(state)) {
986         PetscCDIntNd *pos, *last = NULL;
987         /* look for deleted ghosts and see if they moved */
988         PetscCall(PetscCDGetHeadPos(aggs_2, lid, &pos));
989         while (pos) {
990           PetscInt gid;
991           PetscCall(PetscCDIntNdGetID(pos, &gid));
992 
993           if (gid < my0 || gid >= Iend) {
994             PetscCall(PCGAMGHashTableFind(&gid_cpid, gid, &cpid));
995             if (cpid != -1) {
996               /* a moved ghost - */
997               /* id_llist_2[lastid] = id_llist_2[flid];    /\* remove 'flid' from list *\/ */
998               PetscCall(PetscCDRemoveNextNode(aggs_2, lid, last));
999             } else last = pos;
1000           } else last = pos;
1001 
1002           PetscCall(PetscCDGetNextPos(aggs_2, lid, &pos));
1003         } /* loop over list of deleted */
1004       }   /* selected */
1005     }
1006     PetscCall(PCGAMGHashTableDestroy(&gid_cpid));
1007 
1008     /* look at ghosts, see if they changed - and it */
1009     for (cpid = 0; cpid < nghost_2; cpid++) {
1010       PetscInt sgid_new = (PetscInt)PetscRealPart(cpcol_2_parent[cpid]);
1011       if (sgid_new >= my0 && sgid_new < Iend) { /* this is mine */
1012         PetscInt      gid      = (PetscInt)PetscRealPart(cpcol_2_gid[cpid]);
1013         PetscInt      slid_new = sgid_new - my0, hav = 0;
1014         PetscCDIntNd *pos;
1015 
1016         /* search for this gid to see if I have it */
1017         PetscCall(PetscCDGetHeadPos(aggs_2, slid_new, &pos));
1018         while (pos) {
1019           PetscInt gidj;
1020           PetscCall(PetscCDIntNdGetID(pos, &gidj));
1021           PetscCall(PetscCDGetNextPos(aggs_2, slid_new, &pos));
1022 
1023           if (gidj == gid) {
1024             hav = 1;
1025             break;
1026           }
1027         }
1028         if (hav != 1) {
1029           /* insert 'flidj' into head of llist */
1030           PetscCall(PetscCDAppendID(aggs_2, slid_new, gid));
1031         }
1032       }
1033     }
1034     PetscCall(VecRestoreArray(mpimat_1->lvec, &cpcol_1_state));
1035     PetscCall(VecRestoreArray(mpimat_2->lvec, &cpcol_2_state));
1036     PetscCall(VecRestoreArray(ghostparents2, &cpcol_2_parent));
1037     PetscCall(VecRestoreArray(ghostgids2, &cpcol_2_gid));
1038     PetscCall(VecDestroy(&ghostgids2));
1039     PetscCall(VecDestroy(&ghostparents2));
1040     PetscCall(VecDestroy(&ghost_par_orig2));
1041   }
1042   PetscCall(PetscFree3(lid_state, lid_parent_gid, lid_cprowID_1));
1043   PetscFunctionReturn(PETSC_SUCCESS);
1044 }
1045 
1046 /*
1047    PCGAMGCoarsen_AGG - supports squaring the graph (deprecated) and new graph for
1048      communication of QR data used with HEM and MISk coarsening
1049 
1050   Input Parameter:
1051    . a_pc - this
1052 
1053   Input/Output Parameter:
1054    . a_Gmat1 - graph to coarsen (in), graph off processor edges for QR gather scatter (out)
1055 
1056   Output Parameter:
1057    . agg_lists - list of aggregates
1058 
1059 */
1060 static PetscErrorCode PCGAMGCoarsen_AGG(PC a_pc, Mat *a_Gmat1, PetscCoarsenData **agg_lists)
1061 {
1062   PC_MG       *mg          = (PC_MG *)a_pc->data;
1063   PC_GAMG     *pc_gamg     = (PC_GAMG *)mg->innerctx;
1064   PC_GAMG_AGG *pc_gamg_agg = (PC_GAMG_AGG *)pc_gamg->subctx;
1065   Mat          mat, Gmat2, Gmat1 = *a_Gmat1; /* aggressive graph */
1066   IS           perm;
1067   PetscInt     Istart, Iend, Ii, nloc, bs, nn;
1068   PetscInt    *permute, *degree;
1069   PetscBool   *bIndexSet;
1070   PetscReal    hashfact;
1071   PetscInt     iSwapIndex;
1072   PetscRandom  random;
1073   MPI_Comm     comm;
1074 
1075   PetscFunctionBegin;
1076   PetscCall(PetscObjectGetComm((PetscObject)Gmat1, &comm));
1077   PetscCall(PetscLogEventBegin(petsc_gamg_setup_events[GAMG_COARSEN], 0, 0, 0, 0));
1078   PetscCall(MatGetLocalSize(Gmat1, &nn, NULL));
1079   PetscCall(MatGetBlockSize(Gmat1, &bs));
1080   PetscCheck(bs == 1, PETSC_COMM_SELF, PETSC_ERR_PLIB, "bs %" PetscInt_FMT " must be 1", bs);
1081   nloc = nn / bs;
1082   /* get MIS aggs - randomize */
1083   PetscCall(PetscMalloc2(nloc, &permute, nloc, &degree));
1084   PetscCall(PetscCalloc1(nloc, &bIndexSet));
1085   for (Ii = 0; Ii < nloc; Ii++) permute[Ii] = Ii;
1086   PetscCall(PetscRandomCreate(PETSC_COMM_SELF, &random));
1087   PetscCall(MatGetOwnershipRange(Gmat1, &Istart, &Iend));
1088   for (Ii = 0; Ii < nloc; Ii++) {
1089     PetscInt nc;
1090     PetscCall(MatGetRow(Gmat1, Istart + Ii, &nc, NULL, NULL));
1091     degree[Ii] = nc;
1092     PetscCall(MatRestoreRow(Gmat1, Istart + Ii, &nc, NULL, NULL));
1093   }
1094   for (Ii = 0; Ii < nloc; Ii++) {
1095     PetscCall(PetscRandomGetValueReal(random, &hashfact));
1096     iSwapIndex = (PetscInt)(hashfact * nloc) % nloc;
1097     if (!bIndexSet[iSwapIndex] && iSwapIndex != Ii) {
1098       PetscInt iTemp        = permute[iSwapIndex];
1099       permute[iSwapIndex]   = permute[Ii];
1100       permute[Ii]           = iTemp;
1101       iTemp                 = degree[iSwapIndex];
1102       degree[iSwapIndex]    = degree[Ii];
1103       degree[Ii]            = iTemp;
1104       bIndexSet[iSwapIndex] = PETSC_TRUE;
1105     }
1106   }
1107   // apply minimum degree ordering -- NEW
1108   if (pc_gamg_agg->use_minimum_degree_ordering) { PetscCall(PetscSortIntWithArray(nloc, degree, permute)); }
1109   PetscCall(PetscFree(bIndexSet));
1110   PetscCall(PetscRandomDestroy(&random));
1111   PetscCall(ISCreateGeneral(PETSC_COMM_SELF, nloc, permute, PETSC_USE_POINTER, &perm));
1112   PetscCall(PetscLogEventBegin(petsc_gamg_setup_events[GAMG_MIS], 0, 0, 0, 0));
1113   // square graph
1114   if (pc_gamg->current_level < pc_gamg_agg->aggressive_coarsening_levels && pc_gamg_agg->use_aggressive_square_graph) {
1115     PetscCall(PCGAMGSquareGraph_GAMG(a_pc, Gmat1, &Gmat2));
1116   } else Gmat2 = Gmat1;
1117   // switch to old MIS-1 for square graph
1118   if (pc_gamg->current_level < pc_gamg_agg->aggressive_coarsening_levels) {
1119     if (!pc_gamg_agg->use_aggressive_square_graph) PetscCall(MatCoarsenMISKSetDistance(pc_gamg_agg->crs, pc_gamg_agg->aggressive_mis_k)); // hardwire to MIS-2
1120     else PetscCall(MatCoarsenSetType(pc_gamg_agg->crs, MATCOARSENMIS));                                                                   // old MIS -- side effect
1121   } else if (pc_gamg_agg->use_aggressive_square_graph && pc_gamg_agg->aggressive_coarsening_levels > 0) {                                 // we reset the MIS
1122     const char *prefix;
1123     PetscCall(PetscObjectGetOptionsPrefix((PetscObject)a_pc, &prefix));
1124     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)pc_gamg_agg->crs, prefix));
1125     PetscCall(MatCoarsenSetFromOptions(pc_gamg_agg->crs)); // get the default back on non-aggressive levels when square graph switched to old MIS
1126   }
1127   PetscCall(MatCoarsenSetAdjacency(pc_gamg_agg->crs, Gmat2));
1128   PetscCall(MatCoarsenSetStrictAggs(pc_gamg_agg->crs, PETSC_TRUE));
1129   PetscCall(MatCoarsenSetGreedyOrdering(pc_gamg_agg->crs, perm));
1130   PetscCall(MatCoarsenApply(pc_gamg_agg->crs));
1131   PetscCall(MatCoarsenViewFromOptions(pc_gamg_agg->crs, NULL, "-mat_coarsen_view"));
1132   PetscCall(MatCoarsenGetData(pc_gamg_agg->crs, agg_lists)); /* output */
1133   PetscCall(MatCoarsenDestroy(&pc_gamg_agg->crs));
1134 
1135   PetscCall(ISDestroy(&perm));
1136   PetscCall(PetscFree2(permute, degree));
1137   PetscCall(PetscLogEventEnd(petsc_gamg_setup_events[GAMG_MIS], 0, 0, 0, 0));
1138 
1139   if (Gmat2 != Gmat1) { // square graph, we need ghosts for selected
1140     PetscCoarsenData *llist = *agg_lists;
1141     PetscCall(fixAggregatesWithSquare(a_pc, Gmat2, Gmat1, *agg_lists));
1142     PetscCall(MatDestroy(&Gmat1));
1143     *a_Gmat1 = Gmat2; /* output */
1144     PetscCall(PetscCDGetMat(llist, &mat));
1145     PetscCheck(!mat, comm, PETSC_ERR_ARG_WRONG, "Unexpected auxiliary matrix with squared graph");
1146   } else {
1147     PetscCoarsenData *llist = *agg_lists;
1148     /* see if we have a matrix that takes precedence (returned from MatCoarsenApply) */
1149     PetscCall(PetscCDGetMat(llist, &mat));
1150     if (mat) {
1151       PetscCall(MatDestroy(a_Gmat1));
1152       *a_Gmat1 = mat; /* output */
1153     }
1154   }
1155   PetscCall(PetscLogEventEnd(petsc_gamg_setup_events[GAMG_COARSEN], 0, 0, 0, 0));
1156   PetscFunctionReturn(PETSC_SUCCESS);
1157 }
1158 
1159 /*
1160  PCGAMGProlongator_AGG
1161 
1162  Input Parameter:
1163  . pc - this
1164  . Amat - matrix on this fine level
1165  . Graph - used to get ghost data for nodes in
1166  . agg_lists - list of aggregates
1167  Output Parameter:
1168  . a_P_out - prolongation operator to the next level
1169  */
1170 static PetscErrorCode PCGAMGProlongator_AGG(PC pc, Mat Amat, Mat Gmat, PetscCoarsenData *agg_lists, Mat *a_P_out)
1171 {
1172   PC_MG         *mg      = (PC_MG *)pc->data;
1173   PC_GAMG       *pc_gamg = (PC_GAMG *)mg->innerctx;
1174   const PetscInt col_bs  = pc_gamg->data_cell_cols;
1175   PetscInt       Istart, Iend, nloc, ii, jj, kk, my0, nLocalSelected, bs;
1176   Mat            Prol;
1177   PetscMPIInt    size;
1178   MPI_Comm       comm;
1179   PetscReal     *data_w_ghost;
1180   PetscInt       myCrs0, nbnodes = 0, *flid_fgid;
1181   MatType        mtype;
1182 
1183   PetscFunctionBegin;
1184   PetscCall(PetscObjectGetComm((PetscObject)Amat, &comm));
1185   PetscCheck(col_bs >= 1, comm, PETSC_ERR_PLIB, "Column bs cannot be less than 1");
1186   PetscCall(PetscLogEventBegin(petsc_gamg_setup_events[GAMG_PROL], 0, 0, 0, 0));
1187   PetscCallMPI(MPI_Comm_size(comm, &size));
1188   PetscCall(MatGetOwnershipRange(Amat, &Istart, &Iend));
1189   PetscCall(MatGetBlockSize(Amat, &bs));
1190   nloc = (Iend - Istart) / bs;
1191   my0  = Istart / bs;
1192   PetscCheck((Iend - Istart) % bs == 0, PETSC_COMM_SELF, PETSC_ERR_PLIB, "(Iend %" PetscInt_FMT " - Istart %" PetscInt_FMT ") not divisible by bs %" PetscInt_FMT, Iend, Istart, bs);
1193 
1194   /* get 'nLocalSelected' */
1195   for (ii = 0, nLocalSelected = 0; ii < nloc; ii++) {
1196     PetscBool ise;
1197     /* filter out singletons 0 or 1? */
1198     PetscCall(PetscCDIsEmptyAt(agg_lists, ii, &ise));
1199     if (!ise) nLocalSelected++;
1200   }
1201 
1202   /* create prolongator, create P matrix */
1203   PetscCall(MatGetType(Amat, &mtype));
1204   PetscCall(MatCreate(comm, &Prol));
1205   PetscCall(MatSetSizes(Prol, nloc * bs, nLocalSelected * col_bs, PETSC_DETERMINE, PETSC_DETERMINE));
1206   PetscCall(MatSetBlockSizes(Prol, bs, col_bs));
1207   PetscCall(MatSetType(Prol, mtype));
1208 #if PetscDefined(HAVE_DEVICE)
1209   PetscBool flg;
1210   PetscCall(MatBoundToCPU(Amat, &flg));
1211   PetscCall(MatBindToCPU(Prol, flg));
1212   if (flg) PetscCall(MatSetBindingPropagates(Prol, PETSC_TRUE));
1213 #endif
1214   PetscCall(MatSeqAIJSetPreallocation(Prol, col_bs, NULL));
1215   PetscCall(MatMPIAIJSetPreallocation(Prol, col_bs, NULL, col_bs, NULL));
1216 
1217   /* can get all points "removed" */
1218   PetscCall(MatGetSize(Prol, &kk, &ii));
1219   if (!ii) {
1220     PetscCall(PetscInfo(pc, "%s: No selected points on coarse grid\n", ((PetscObject)pc)->prefix));
1221     PetscCall(MatDestroy(&Prol));
1222     *a_P_out = NULL; /* out */
1223     PetscCall(PetscLogEventEnd(petsc_gamg_setup_events[GAMG_PROL], 0, 0, 0, 0));
1224     PetscFunctionReturn(PETSC_SUCCESS);
1225   }
1226   PetscCall(PetscInfo(pc, "%s: New grid %" PetscInt_FMT " nodes\n", ((PetscObject)pc)->prefix, ii / col_bs));
1227   PetscCall(MatGetOwnershipRangeColumn(Prol, &myCrs0, &kk));
1228 
1229   PetscCheck((kk - myCrs0) % col_bs == 0, PETSC_COMM_SELF, PETSC_ERR_PLIB, "(kk %" PetscInt_FMT " -myCrs0 %" PetscInt_FMT ") not divisible by col_bs %" PetscInt_FMT, kk, myCrs0, col_bs);
1230   myCrs0 = myCrs0 / col_bs;
1231   PetscCheck((kk / col_bs - myCrs0) == nLocalSelected, PETSC_COMM_SELF, PETSC_ERR_PLIB, "(kk %" PetscInt_FMT "/col_bs %" PetscInt_FMT " - myCrs0 %" PetscInt_FMT ") != nLocalSelected %" PetscInt_FMT ")", kk, col_bs, myCrs0, nLocalSelected);
1232 
1233   /* create global vector of data in 'data_w_ghost' */
1234   PetscCall(PetscLogEventBegin(petsc_gamg_setup_events[GAMG_PROLA], 0, 0, 0, 0));
1235   if (size > 1) { /* get ghost null space data */
1236     PetscReal *tmp_gdata, *tmp_ldata, *tp2;
1237     PetscCall(PetscMalloc1(nloc, &tmp_ldata));
1238     for (jj = 0; jj < col_bs; jj++) {
1239       for (kk = 0; kk < bs; kk++) {
1240         PetscInt         ii, stride;
1241         const PetscReal *tp = pc_gamg->data + jj * bs * nloc + kk;
1242         for (ii = 0; ii < nloc; ii++, tp += bs) tmp_ldata[ii] = *tp;
1243 
1244         PetscCall(PCGAMGGetDataWithGhosts(Gmat, 1, tmp_ldata, &stride, &tmp_gdata));
1245 
1246         if (!jj && !kk) { /* now I know how many total nodes - allocate TODO: move below and do in one 'col_bs' call */
1247           PetscCall(PetscMalloc1(stride * bs * col_bs, &data_w_ghost));
1248           nbnodes = bs * stride;
1249         }
1250         tp2 = data_w_ghost + jj * bs * stride + kk;
1251         for (ii = 0; ii < stride; ii++, tp2 += bs) *tp2 = tmp_gdata[ii];
1252         PetscCall(PetscFree(tmp_gdata));
1253       }
1254     }
1255     PetscCall(PetscFree(tmp_ldata));
1256   } else {
1257     nbnodes      = bs * nloc;
1258     data_w_ghost = (PetscReal *)pc_gamg->data;
1259   }
1260 
1261   /* get 'flid_fgid' TODO - move up to get 'stride' and do get null space data above in one step (jj loop) */
1262   if (size > 1) {
1263     PetscReal *fid_glid_loc, *fiddata;
1264     PetscInt   stride;
1265 
1266     PetscCall(PetscMalloc1(nloc, &fid_glid_loc));
1267     for (kk = 0; kk < nloc; kk++) fid_glid_loc[kk] = (PetscReal)(my0 + kk);
1268     PetscCall(PCGAMGGetDataWithGhosts(Gmat, 1, fid_glid_loc, &stride, &fiddata));
1269     PetscCall(PetscMalloc1(stride, &flid_fgid)); /* copy real data to in */
1270     for (kk = 0; kk < stride; kk++) flid_fgid[kk] = (PetscInt)fiddata[kk];
1271     PetscCall(PetscFree(fiddata));
1272 
1273     PetscCheck(stride == nbnodes / bs, PETSC_COMM_SELF, PETSC_ERR_PLIB, "stride %" PetscInt_FMT " != nbnodes %" PetscInt_FMT "/bs %" PetscInt_FMT, stride, nbnodes, bs);
1274     PetscCall(PetscFree(fid_glid_loc));
1275   } else {
1276     PetscCall(PetscMalloc1(nloc, &flid_fgid));
1277     for (kk = 0; kk < nloc; kk++) flid_fgid[kk] = my0 + kk;
1278   }
1279   PetscCall(PetscLogEventEnd(petsc_gamg_setup_events[GAMG_PROLA], 0, 0, 0, 0));
1280   /* get P0 */
1281   PetscCall(PetscLogEventBegin(petsc_gamg_setup_events[GAMG_PROLB], 0, 0, 0, 0));
1282   {
1283     PetscReal *data_out = NULL;
1284     PetscCall(formProl0(agg_lists, bs, col_bs, myCrs0, nbnodes, data_w_ghost, flid_fgid, &data_out, Prol));
1285     PetscCall(PetscFree(pc_gamg->data));
1286 
1287     pc_gamg->data           = data_out;
1288     pc_gamg->data_cell_rows = col_bs;
1289     pc_gamg->data_sz        = col_bs * col_bs * nLocalSelected;
1290   }
1291   PetscCall(PetscLogEventEnd(petsc_gamg_setup_events[GAMG_PROLB], 0, 0, 0, 0));
1292   if (size > 1) PetscCall(PetscFree(data_w_ghost));
1293   PetscCall(PetscFree(flid_fgid));
1294 
1295   *a_P_out = Prol; /* out */
1296   PetscCall(MatViewFromOptions(Prol, NULL, "-view_P"));
1297 
1298   PetscCall(PetscLogEventEnd(petsc_gamg_setup_events[GAMG_PROL], 0, 0, 0, 0));
1299   PetscFunctionReturn(PETSC_SUCCESS);
1300 }
1301 
1302 /*
1303    PCGAMGOptProlongator_AGG
1304 
1305   Input Parameter:
1306    . pc - this
1307    . Amat - matrix on this fine level
1308  In/Output Parameter:
1309    . a_P - prolongation operator to the next level
1310 */
1311 static PetscErrorCode PCGAMGOptProlongator_AGG(PC pc, Mat Amat, Mat *a_P)
1312 {
1313   PC_MG       *mg          = (PC_MG *)pc->data;
1314   PC_GAMG     *pc_gamg     = (PC_GAMG *)mg->innerctx;
1315   PC_GAMG_AGG *pc_gamg_agg = (PC_GAMG_AGG *)pc_gamg->subctx;
1316   PetscInt     jj;
1317   Mat          Prol = *a_P;
1318   MPI_Comm     comm;
1319   KSP          eksp;
1320   Vec          bb, xx;
1321   PC           epc;
1322   PetscReal    alpha, emax, emin;
1323 
1324   PetscFunctionBegin;
1325   PetscCall(PetscObjectGetComm((PetscObject)Amat, &comm));
1326   PetscCall(PetscLogEventBegin(petsc_gamg_setup_events[GAMG_OPT], 0, 0, 0, 0));
1327 
1328   /* compute maximum singular value of operator to be used in smoother */
1329   if (0 < pc_gamg_agg->nsmooths) {
1330     /* get eigen estimates */
1331     if (pc_gamg->emax > 0) {
1332       emin = pc_gamg->emin;
1333       emax = pc_gamg->emax;
1334     } else {
1335       const char *prefix;
1336 
1337       PetscCall(MatCreateVecs(Amat, &bb, NULL));
1338       PetscCall(MatCreateVecs(Amat, &xx, NULL));
1339       PetscCall(KSPSetNoisy_Private(bb));
1340 
1341       PetscCall(KSPCreate(comm, &eksp));
1342       PetscCall(KSPSetNestLevel(eksp, pc->kspnestlevel));
1343       PetscCall(PCGetOptionsPrefix(pc, &prefix));
1344       PetscCall(KSPSetOptionsPrefix(eksp, prefix));
1345       PetscCall(KSPAppendOptionsPrefix(eksp, "pc_gamg_esteig_"));
1346       {
1347         PetscBool isset, sflg;
1348         PetscCall(MatIsSPDKnown(Amat, &isset, &sflg));
1349         if (isset && sflg) PetscCall(KSPSetType(eksp, KSPCG));
1350       }
1351       PetscCall(KSPSetErrorIfNotConverged(eksp, pc->erroriffailure));
1352       PetscCall(KSPSetNormType(eksp, KSP_NORM_NONE));
1353 
1354       PetscCall(KSPSetInitialGuessNonzero(eksp, PETSC_FALSE));
1355       PetscCall(KSPSetOperators(eksp, Amat, Amat));
1356 
1357       PetscCall(KSPGetPC(eksp, &epc));
1358       PetscCall(PCSetType(epc, PCJACOBI)); /* smoother in smoothed agg. */
1359 
1360       PetscCall(KSPSetTolerances(eksp, PETSC_DEFAULT, PETSC_DEFAULT, PETSC_DEFAULT, 10)); // 10 is safer, but 5 is often fine, can override with -pc_gamg_esteig_ksp_max_it -mg_levels_ksp_chebyshev_esteig 0,0.25,0,1.2
1361 
1362       PetscCall(KSPSetFromOptions(eksp));
1363       PetscCall(KSPSetComputeSingularValues(eksp, PETSC_TRUE));
1364       PetscCall(KSPSolve(eksp, bb, xx));
1365       PetscCall(KSPCheckSolve(eksp, pc, xx));
1366 
1367       PetscCall(KSPComputeExtremeSingularValues(eksp, &emax, &emin));
1368       PetscCall(PetscInfo(pc, "%s: Smooth P0: max eigen=%e min=%e PC=%s\n", ((PetscObject)pc)->prefix, (double)emax, (double)emin, PCJACOBI));
1369       PetscCall(VecDestroy(&xx));
1370       PetscCall(VecDestroy(&bb));
1371       PetscCall(KSPDestroy(&eksp));
1372     }
1373     if (pc_gamg->use_sa_esteig) {
1374       mg->min_eigen_DinvA[pc_gamg->current_level] = emin;
1375       mg->max_eigen_DinvA[pc_gamg->current_level] = emax;
1376       PetscCall(PetscInfo(pc, "%s: Smooth P0: level %" PetscInt_FMT ", cache spectra %g %g\n", ((PetscObject)pc)->prefix, pc_gamg->current_level, (double)emin, (double)emax));
1377     } else {
1378       mg->min_eigen_DinvA[pc_gamg->current_level] = 0;
1379       mg->max_eigen_DinvA[pc_gamg->current_level] = 0;
1380     }
1381   } else {
1382     mg->min_eigen_DinvA[pc_gamg->current_level] = 0;
1383     mg->max_eigen_DinvA[pc_gamg->current_level] = 0;
1384   }
1385 
1386   /* smooth P0 */
1387   for (jj = 0; jj < pc_gamg_agg->nsmooths; jj++) {
1388     Mat tMat;
1389     Vec diag;
1390 
1391     PetscCall(PetscLogEventBegin(petsc_gamg_setup_events[GAMG_OPTSM], 0, 0, 0, 0));
1392 
1393     /* smooth P1 := (I - omega/lam D^{-1}A)P0 */
1394     PetscCall(PetscLogEventBegin(petsc_gamg_setup_matmat_events[pc_gamg->current_level][2], 0, 0, 0, 0));
1395     PetscCall(MatMatMult(Amat, Prol, MAT_INITIAL_MATRIX, PETSC_DEFAULT, &tMat));
1396     PetscCall(PetscLogEventEnd(petsc_gamg_setup_matmat_events[pc_gamg->current_level][2], 0, 0, 0, 0));
1397     PetscCall(MatProductClear(tMat));
1398     PetscCall(MatCreateVecs(Amat, &diag, NULL));
1399     PetscCall(MatGetDiagonal(Amat, diag)); /* effectively PCJACOBI */
1400     PetscCall(VecReciprocal(diag));
1401     PetscCall(MatDiagonalScale(tMat, diag, NULL));
1402     PetscCall(VecDestroy(&diag));
1403 
1404     /* TODO: Set a PCFailedReason and exit the building of the AMG preconditioner */
1405     PetscCheck(emax != 0.0, PetscObjectComm((PetscObject)pc), PETSC_ERR_PLIB, "Computed maximum singular value as zero");
1406     /* TODO: Document the 1.4 and don't hardwire it in this routine */
1407     alpha = -1.4 / emax;
1408 
1409     PetscCall(MatAYPX(tMat, alpha, Prol, SUBSET_NONZERO_PATTERN));
1410     PetscCall(MatDestroy(&Prol));
1411     Prol = tMat;
1412     PetscCall(PetscLogEventEnd(petsc_gamg_setup_events[GAMG_OPTSM], 0, 0, 0, 0));
1413   }
1414   PetscCall(PetscLogEventEnd(petsc_gamg_setup_events[GAMG_OPT], 0, 0, 0, 0));
1415   *a_P = Prol;
1416   PetscFunctionReturn(PETSC_SUCCESS);
1417 }
1418 
1419 /*
1420    PCCreateGAMG_AGG
1421 
1422   Input Parameter:
1423    . pc -
1424 */
1425 PetscErrorCode PCCreateGAMG_AGG(PC pc)
1426 {
1427   PC_MG       *mg      = (PC_MG *)pc->data;
1428   PC_GAMG     *pc_gamg = (PC_GAMG *)mg->innerctx;
1429   PC_GAMG_AGG *pc_gamg_agg;
1430 
1431   PetscFunctionBegin;
1432   /* create sub context for SA */
1433   PetscCall(PetscNew(&pc_gamg_agg));
1434   pc_gamg->subctx = pc_gamg_agg;
1435 
1436   pc_gamg->ops->setfromoptions = PCSetFromOptions_GAMG_AGG;
1437   pc_gamg->ops->destroy        = PCDestroy_GAMG_AGG;
1438   /* reset does not do anything; setup not virtual */
1439 
1440   /* set internal function pointers */
1441   pc_gamg->ops->creategraph       = PCGAMGCreateGraph_AGG;
1442   pc_gamg->ops->coarsen           = PCGAMGCoarsen_AGG;
1443   pc_gamg->ops->prolongator       = PCGAMGProlongator_AGG;
1444   pc_gamg->ops->optprolongator    = PCGAMGOptProlongator_AGG;
1445   pc_gamg->ops->createdefaultdata = PCSetData_AGG;
1446   pc_gamg->ops->view              = PCView_GAMG_AGG;
1447 
1448   pc_gamg_agg->nsmooths                     = 1;
1449   pc_gamg_agg->aggressive_coarsening_levels = 1;
1450   pc_gamg_agg->use_aggressive_square_graph  = PETSC_TRUE;
1451   pc_gamg_agg->use_minimum_degree_ordering  = PETSC_FALSE;
1452   pc_gamg_agg->use_low_mem_filter           = PETSC_FALSE;
1453   pc_gamg_agg->aggressive_mis_k             = 2;
1454 
1455   PetscCall(PetscObjectComposeFunction((PetscObject)pc, "PCGAMGSetNSmooths_C", PCGAMGSetNSmooths_AGG));
1456   PetscCall(PetscObjectComposeFunction((PetscObject)pc, "PCGAMGSetAggressiveLevels_C", PCGAMGSetAggressiveLevels_AGG));
1457   PetscCall(PetscObjectComposeFunction((PetscObject)pc, "PCGAMGSetAggressiveSquareGraph_C", PCGAMGSetAggressiveSquareGraph_AGG));
1458   PetscCall(PetscObjectComposeFunction((PetscObject)pc, "PCGAMGMISkSetMinDegreeOrdering_C", PCGAMGMISkSetMinDegreeOrdering_AGG));
1459   PetscCall(PetscObjectComposeFunction((PetscObject)pc, "PCGAMGSetLowMemoryFilter_C", PCGAMGSetLowMemoryFilter_AGG));
1460   PetscCall(PetscObjectComposeFunction((PetscObject)pc, "PCGAMGMISkSetAggressive_C", PCGAMGMISkSetAggressive_AGG));
1461   PetscCall(PetscObjectComposeFunction((PetscObject)pc, "PCSetCoordinates_C", PCSetCoordinates_AGG));
1462   PetscFunctionReturn(PETSC_SUCCESS);
1463 }
1464