xref: /petsc/src/ksp/pc/impls/patch/pcpatch.c (revision fc8a9adeb7fcdc98711d755fa2dc544ddccf0f3e)
1 #include <petsc/private/pcpatchimpl.h>     /*I "petscpc.h" I*/
2 #include <petsc/private/kspimpl.h>         /* For ksp->setfromoptionscalled */
3 #include <petsc/private/dmpleximpl.h> /* For DMPlexComputeJacobian_Patch_Internal() */
4 #include <petscsf.h>
5 #include <petscbt.h>
6 #include <petscds.h>
7 
8 PetscLogEvent PC_Patch_CreatePatches, PC_Patch_ComputeOp, PC_Patch_Solve, PC_Patch_Scatter, PC_Patch_Apply, PC_Patch_Prealloc;
9 
10 PETSC_STATIC_INLINE PetscErrorCode ObjectView(PetscObject obj, PetscViewer viewer, PetscViewerFormat format)
11 {
12   PetscErrorCode ierr;
13 
14   ierr = PetscViewerPushFormat(viewer, format);CHKERRQ(ierr);
15   ierr = PetscObjectView(obj, viewer);CHKERRQ(ierr);
16   ierr = PetscViewerPopFormat(viewer);CHKERRQ(ierr);
17   return(0);
18 }
19 
20 static PetscErrorCode PCPatchConstruct_Star(void *vpatch, DM dm, PetscInt point, PetscHSetI ht)
21 {
22   PetscInt       starSize;
23   PetscInt      *star = NULL, si;
24   PetscErrorCode ierr;
25 
26   PetscFunctionBegin;
27   PetscHSetIClear(ht);
28   /* To start with, add the point we care about */
29   ierr = PetscHSetIAdd(ht, point);CHKERRQ(ierr);
30   /* Loop over all the points that this point connects to */
31   ierr = DMPlexGetTransitiveClosure(dm, point, PETSC_FALSE, &starSize, &star);CHKERRQ(ierr);
32   for (si = 0; si < starSize*2; si += 2) {ierr = PetscHSetIAdd(ht, star[si]);CHKERRQ(ierr);}
33   ierr = DMPlexRestoreTransitiveClosure(dm, point, PETSC_FALSE, &starSize, &star);CHKERRQ(ierr);
34   PetscFunctionReturn(0);
35 }
36 
37 static PetscErrorCode PCPatchConstruct_Vanka(void *vpatch, DM dm, PetscInt point, PetscHSetI ht)
38 {
39   PC_PATCH      *patch = (PC_PATCH *) vpatch;
40   PetscInt       starSize;
41   PetscInt      *star = NULL;
42   PetscBool      shouldIgnore = PETSC_FALSE;
43   PetscInt       cStart, cEnd, iStart, iEnd, si;
44   PetscErrorCode ierr;
45 
46   PetscFunctionBegin;
47   ierr = PetscHSetIClear(ht);CHKERRQ(ierr);
48   /* To start with, add the point we care about */
49   ierr = PetscHSetIAdd(ht, point);CHKERRQ(ierr);
50   /* Should we ignore any points of a certain dimension? */
51   if (patch->vankadim >= 0) {
52     shouldIgnore = PETSC_TRUE;
53     ierr = DMPlexGetDepthStratum(dm, patch->vankadim, &iStart, &iEnd);CHKERRQ(ierr);
54   }
55   ierr = DMPlexGetHeightStratum(dm, 0, &cStart, &cEnd);CHKERRQ(ierr);
56   /* Loop over all the cells that this point connects to */
57   ierr = DMPlexGetTransitiveClosure(dm, point, PETSC_FALSE, &starSize, &star);CHKERRQ(ierr);
58   for (si = 0; si < starSize*2; si += 2) {
59     const PetscInt cell = star[si];
60     PetscInt       closureSize;
61     PetscInt      *closure = NULL, ci;
62 
63     if (cell < cStart || cell >= cEnd) continue;
64     /* now loop over all entities in the closure of that cell */
65     ierr = DMPlexGetTransitiveClosure(dm, cell, PETSC_TRUE, &closureSize, &closure);CHKERRQ(ierr);
66     for (ci = 0; ci < closureSize*2; ci += 2) {
67       const PetscInt newpoint = closure[ci];
68 
69       /* We've been told to ignore entities of this type.*/
70       if (shouldIgnore && newpoint >= iStart && newpoint < iEnd) continue;
71       ierr = PetscHSetIAdd(ht, newpoint);CHKERRQ(ierr);
72     }
73     ierr = DMPlexRestoreTransitiveClosure(dm, cell, PETSC_TRUE, &closureSize, &closure);CHKERRQ(ierr);
74   }
75   ierr = DMPlexRestoreTransitiveClosure(dm, point, PETSC_FALSE, &starSize, &star);CHKERRQ(ierr);
76   PetscFunctionReturn(0);
77 }
78 
79 static PetscErrorCode PCPatchConstruct_Pardecomp(void *vpatch, DM dm, PetscInt point, PetscHSetI ht)
80 {
81   PC_PATCH       *patch = (PC_PATCH *) vpatch;
82   DMLabel         ghost = NULL;
83   const PetscInt *leaves;
84   PetscInt        nleaves, pStart, pEnd, loc;
85   PetscBool       isFiredrake;
86   DM              plex;
87   PetscBool       flg;
88   PetscInt        starSize;
89   PetscInt       *star = NULL;
90   PetscInt        opoint, overlapi;
91   PetscErrorCode  ierr;
92 
93   PetscFunctionBegin;
94   PetscHSetIClear(ht);
95 
96   ierr = DMConvert(dm, DMPLEX, &plex);CHKERRQ(ierr);
97   ierr = DMPlexGetChart(plex, &pStart, &pEnd);CHKERRQ(ierr);
98 
99   ierr = DMHasLabel(dm, "pyop2_ghost", &isFiredrake);CHKERRQ(ierr);
100   if (isFiredrake) {
101     ierr = DMGetLabel(dm, "pyop2_ghost", &ghost);CHKERRQ(ierr);
102     ierr = DMLabelCreateIndex(ghost, pStart, pEnd);CHKERRQ(ierr);
103   } else {
104     PetscSF sf;
105     ierr = DMGetPointSF(dm, &sf);CHKERRQ(ierr);
106     ierr = PetscSFGetGraph(sf, NULL, &nleaves, &leaves, NULL);CHKERRQ(ierr);
107     nleaves = PetscMax(nleaves, 0);
108   }
109 
110   for (opoint = pStart; opoint < pEnd; ++opoint) {
111     if (ghost) {ierr = DMLabelHasPoint(ghost, opoint, &flg);CHKERRQ(ierr);}
112     else       {ierr = PetscFindInt(opoint, nleaves, leaves, &loc);CHKERRQ(ierr); flg = loc >=0 ? PETSC_TRUE : PETSC_FALSE;}
113     /* Not an owned entity, don't make a cell patch. */
114     if (flg) continue;
115     ierr = PetscHSetIAdd(ht, opoint);CHKERRQ(ierr);
116   }
117 
118   /* Now build the overlap for the patch */
119   for (overlapi = 0; overlapi < patch->pardecomp_overlap; ++overlapi) {
120     PetscInt index = 0;
121     PetscInt *htpoints = NULL;
122     PetscInt htsize;
123     PetscInt i;
124 
125     ierr = PetscHSetIGetSize(ht, &htsize);CHKERRQ(ierr);
126     ierr = PetscMalloc1(htsize, &htpoints);CHKERRQ(ierr);
127     ierr = PetscHSetIGetElems(ht, &index, htpoints);CHKERRQ(ierr);
128 
129     for (i = 0; i < htsize; ++i) {
130       PetscInt hpoint = htpoints[i];
131       PetscInt si;
132 
133       ierr = DMPlexGetTransitiveClosure(dm, hpoint, PETSC_FALSE, &starSize, &star);CHKERRQ(ierr);
134       for (si = 0; si < starSize*2; si += 2) {
135         const PetscInt starp = star[si];
136         PetscInt       closureSize;
137         PetscInt      *closure = NULL, ci;
138 
139         /* now loop over all entities in the closure of starp */
140         ierr = DMPlexGetTransitiveClosure(dm, starp, PETSC_TRUE, &closureSize, &closure);CHKERRQ(ierr);
141         for (ci = 0; ci < closureSize*2; ci += 2) {
142           const PetscInt closstarp = closure[ci];
143           ierr = PetscHSetIAdd(ht, closstarp);CHKERRQ(ierr);
144         }
145         ierr = DMPlexRestoreTransitiveClosure(dm, starp, PETSC_TRUE, &closureSize, &closure);CHKERRQ(ierr);
146       }
147       ierr = DMPlexRestoreTransitiveClosure(dm, hpoint, PETSC_FALSE, &starSize, &star);CHKERRQ(ierr);
148     }
149     ierr = PetscFree(htpoints);CHKERRQ(ierr);
150   }
151 
152   PetscFunctionReturn(0);
153 }
154 
155 /* The user's already set the patches in patch->userIS. Build the hash tables */
156 static PetscErrorCode PCPatchConstruct_User(void *vpatch, DM dm, PetscInt point, PetscHSetI ht)
157 {
158   PC_PATCH       *patch   = (PC_PATCH *) vpatch;
159   IS              patchis = patch->userIS[point];
160   PetscInt        n;
161   const PetscInt *patchdata;
162   PetscInt        pStart, pEnd, i;
163   PetscErrorCode  ierr;
164 
165   PetscFunctionBegin;
166   ierr = PetscHSetIClear(ht);CHKERRQ(ierr);
167   ierr = DMPlexGetChart(dm, &pStart, &pEnd);CHKERRQ(ierr);
168   ierr = ISGetLocalSize(patchis, &n);CHKERRQ(ierr);
169   ierr = ISGetIndices(patchis, &patchdata);CHKERRQ(ierr);
170   for (i = 0; i < n; ++i) {
171     const PetscInt ownedpoint = patchdata[i];
172 
173     if (ownedpoint < pStart || ownedpoint >= pEnd) {
174       SETERRQ3(PetscObjectComm((PetscObject) dm), PETSC_ERR_ARG_OUTOFRANGE, "Mesh point %D was not in [%D, %D)", ownedpoint, pStart, pEnd);
175     }
176     ierr = PetscHSetIAdd(ht, ownedpoint);CHKERRQ(ierr);
177   }
178   ierr = ISRestoreIndices(patchis, &patchdata);CHKERRQ(ierr);
179   PetscFunctionReturn(0);
180 }
181 
182 static PetscErrorCode PCPatchCreateDefaultSF_Private(PC pc, PetscInt n, const PetscSF *sf, const PetscInt *bs)
183 {
184   PC_PATCH      *patch = (PC_PATCH *) pc->data;
185   PetscInt       i;
186   PetscErrorCode ierr;
187 
188   PetscFunctionBegin;
189   if (n == 1 && bs[0] == 1) {
190     patch->defaultSF = sf[0];
191     ierr = PetscObjectReference((PetscObject) patch->defaultSF);CHKERRQ(ierr);
192   } else {
193     PetscInt     allRoots = 0, allLeaves = 0;
194     PetscInt     leafOffset = 0;
195     PetscInt    *ilocal = NULL;
196     PetscSFNode *iremote = NULL;
197     PetscInt    *remoteOffsets = NULL;
198     PetscInt     index = 0;
199     PetscHMapI   rankToIndex;
200     PetscInt     numRanks = 0;
201     PetscSFNode *remote = NULL;
202     PetscSF      rankSF;
203     PetscInt    *ranks = NULL;
204     PetscInt    *offsets = NULL;
205     MPI_Datatype contig;
206     PetscHSetI   ranksUniq;
207 
208     /* First figure out how many dofs there are in the concatenated numbering.
209      * allRoots: number of owned global dofs;
210      * allLeaves: number of visible dofs (global + ghosted).
211      */
212     for (i = 0; i < n; ++i) {
213       PetscInt nroots, nleaves;
214 
215       ierr = PetscSFGetGraph(sf[i], &nroots, &nleaves, NULL, NULL);CHKERRQ(ierr);
216       allRoots  += nroots * bs[i];
217       allLeaves += nleaves * bs[i];
218     }
219     ierr = PetscMalloc1(allLeaves, &ilocal);CHKERRQ(ierr);
220     ierr = PetscMalloc1(allLeaves, &iremote);CHKERRQ(ierr);
221     /* Now build an SF that just contains process connectivity. */
222     ierr = PetscHSetICreate(&ranksUniq);CHKERRQ(ierr);
223     for (i = 0; i < n; ++i) {
224       const PetscMPIInt *ranks = NULL;
225       PetscInt           nranks, j;
226 
227       ierr = PetscSFSetUp(sf[i]);CHKERRQ(ierr);
228       ierr = PetscSFGetRanks(sf[i], &nranks, &ranks, NULL, NULL, NULL);CHKERRQ(ierr);
229       /* These are all the ranks who communicate with me. */
230       for (j = 0; j < nranks; ++j) {
231         ierr = PetscHSetIAdd(ranksUniq, (PetscInt) ranks[j]);CHKERRQ(ierr);
232       }
233     }
234     ierr = PetscHSetIGetSize(ranksUniq, &numRanks);CHKERRQ(ierr);
235     ierr = PetscMalloc1(numRanks, &remote);CHKERRQ(ierr);
236     ierr = PetscMalloc1(numRanks, &ranks);CHKERRQ(ierr);
237     ierr = PetscHSetIGetElems(ranksUniq, &index, ranks);CHKERRQ(ierr);
238 
239     ierr = PetscHMapICreate(&rankToIndex);CHKERRQ(ierr);
240     for (i = 0; i < numRanks; ++i) {
241       remote[i].rank  = ranks[i];
242       remote[i].index = 0;
243       ierr = PetscHMapISet(rankToIndex, ranks[i], i);CHKERRQ(ierr);
244     }
245     ierr = PetscFree(ranks);CHKERRQ(ierr);
246     ierr = PetscHSetIDestroy(&ranksUniq);CHKERRQ(ierr);
247     ierr = PetscSFCreate(PetscObjectComm((PetscObject) pc), &rankSF);CHKERRQ(ierr);
248     ierr = PetscSFSetGraph(rankSF, 1, numRanks, NULL, PETSC_OWN_POINTER, remote, PETSC_OWN_POINTER);CHKERRQ(ierr);
249     ierr = PetscSFSetUp(rankSF);CHKERRQ(ierr);
250     /* OK, use it to communicate the root offset on the remote
251      * processes for each subspace. */
252     ierr = PetscMalloc1(n, &offsets);CHKERRQ(ierr);
253     ierr = PetscMalloc1(n*numRanks, &remoteOffsets);CHKERRQ(ierr);
254 
255     offsets[0] = 0;
256     for (i = 1; i < n; ++i) {
257       PetscInt nroots;
258 
259       ierr = PetscSFGetGraph(sf[i-1], &nroots, NULL, NULL, NULL);CHKERRQ(ierr);
260       offsets[i] = offsets[i-1] + nroots*bs[i-1];
261     }
262     /* Offsets are the offsets on the current process of the
263      * global dof numbering for the subspaces. */
264     ierr = MPI_Type_contiguous(n, MPIU_INT, &contig);CHKERRQ(ierr);
265     ierr = MPI_Type_commit(&contig);CHKERRQ(ierr);
266 
267     ierr = PetscSFBcastBegin(rankSF, contig, offsets, remoteOffsets);CHKERRQ(ierr);
268     ierr = PetscSFBcastEnd(rankSF, contig, offsets, remoteOffsets);CHKERRQ(ierr);
269     ierr = MPI_Type_free(&contig);CHKERRQ(ierr);
270     ierr = PetscFree(offsets);CHKERRQ(ierr);
271     ierr = PetscSFDestroy(&rankSF);CHKERRQ(ierr);
272     /* Now remoteOffsets contains the offsets on the remote
273      * processes who communicate with me.  So now we can
274      * concatenate the list of SFs into a single one. */
275     index = 0;
276     for (i = 0; i < n; ++i) {
277       const PetscSFNode *remote = NULL;
278       const PetscInt    *local  = NULL;
279       PetscInt           nroots, nleaves, j;
280 
281       ierr = PetscSFGetGraph(sf[i], &nroots, &nleaves, &local, &remote);CHKERRQ(ierr);
282       for (j = 0; j < nleaves; ++j) {
283         PetscInt rank = remote[j].rank;
284         PetscInt idx, rootOffset, k;
285 
286         ierr = PetscHMapIGet(rankToIndex, rank, &idx);CHKERRQ(ierr);
287         if (idx == -1) SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "Didn't find rank, huh?");
288         /* Offset on given rank for ith subspace */
289         rootOffset = remoteOffsets[n*idx + i];
290         for (k = 0; k < bs[i]; ++k) {
291           ilocal[index]        = (local ? local[j] : j)*bs[i] + k + leafOffset;
292           iremote[index].rank  = remote[j].rank;
293           iremote[index].index = remote[j].index*bs[i] + k + rootOffset;
294           ++index;
295         }
296       }
297       leafOffset += nleaves * bs[i];
298     }
299     ierr = PetscHMapIDestroy(&rankToIndex);CHKERRQ(ierr);
300     ierr = PetscFree(remoteOffsets);CHKERRQ(ierr);
301     ierr = PetscSFCreate(PetscObjectComm((PetscObject)pc), &patch->defaultSF);CHKERRQ(ierr);
302     ierr = PetscSFSetGraph(patch->defaultSF, allRoots, allLeaves, ilocal, PETSC_OWN_POINTER, iremote, PETSC_OWN_POINTER);CHKERRQ(ierr);
303   }
304   PetscFunctionReturn(0);
305 }
306 
307 /* TODO: Docs */
308 PetscErrorCode PCPatchSetIgnoreDim(PC pc, PetscInt dim)
309 {
310   PC_PATCH *patch = (PC_PATCH *) pc->data;
311   PetscFunctionBegin;
312   patch->ignoredim = dim;
313   PetscFunctionReturn(0);
314 }
315 
316 /* TODO: Docs */
317 PetscErrorCode PCPatchGetIgnoreDim(PC pc, PetscInt *dim)
318 {
319   PC_PATCH *patch = (PC_PATCH *) pc->data;
320   PetscFunctionBegin;
321   *dim = patch->ignoredim;
322   PetscFunctionReturn(0);
323 }
324 
325 /* TODO: Docs */
326 PetscErrorCode PCPatchSetSaveOperators(PC pc, PetscBool flg)
327 {
328   PC_PATCH *patch = (PC_PATCH *) pc->data;
329   PetscFunctionBegin;
330   patch->save_operators = flg;
331   PetscFunctionReturn(0);
332 }
333 
334 /* TODO: Docs */
335 PetscErrorCode PCPatchGetSaveOperators(PC pc, PetscBool *flg)
336 {
337   PC_PATCH *patch = (PC_PATCH *) pc->data;
338   PetscFunctionBegin;
339   *flg = patch->save_operators;
340   PetscFunctionReturn(0);
341 }
342 
343 /* TODO: Docs */
344 PetscErrorCode PCPatchSetPrecomputeElementTensors(PC pc, PetscBool flg)
345 {
346   PC_PATCH *patch = (PC_PATCH *) pc->data;
347   PetscFunctionBegin;
348   patch->precomputeElementTensors = flg;
349   PetscFunctionReturn(0);
350 }
351 
352 /* TODO: Docs */
353 PetscErrorCode PCPatchGetPrecomputeElementTensors(PC pc, PetscBool *flg)
354 {
355   PC_PATCH *patch = (PC_PATCH *) pc->data;
356   PetscFunctionBegin;
357   *flg = patch->precomputeElementTensors;
358   PetscFunctionReturn(0);
359 }
360 
361 /* TODO: Docs */
362 PetscErrorCode PCPatchSetPartitionOfUnity(PC pc, PetscBool flg)
363 {
364   PC_PATCH *patch = (PC_PATCH *) pc->data;
365   PetscFunctionBegin;
366   patch->partition_of_unity = flg;
367   PetscFunctionReturn(0);
368 }
369 
370 /* TODO: Docs */
371 PetscErrorCode PCPatchGetPartitionOfUnity(PC pc, PetscBool *flg)
372 {
373   PC_PATCH *patch = (PC_PATCH *) pc->data;
374   PetscFunctionBegin;
375   *flg = patch->partition_of_unity;
376   PetscFunctionReturn(0);
377 }
378 
379 /* TODO: Docs */
380 PetscErrorCode PCPatchSetLocalComposition(PC pc, PCCompositeType type)
381 {
382   PC_PATCH *patch = (PC_PATCH *) pc->data;
383   PetscFunctionBegin;
384   if (type != PC_COMPOSITE_ADDITIVE && type != PC_COMPOSITE_MULTIPLICATIVE) SETERRQ(PetscObjectComm((PetscObject)pc),PETSC_ERR_SUP,"Only supports additive or multiplicative as the local type");
385   patch->local_composition_type = type;
386   PetscFunctionReturn(0);
387 }
388 
389 /* TODO: Docs */
390 PetscErrorCode PCPatchGetLocalComposition(PC pc, PCCompositeType *type)
391 {
392   PC_PATCH *patch = (PC_PATCH *) pc->data;
393   PetscFunctionBegin;
394   *type = patch->local_composition_type;
395   PetscFunctionReturn(0);
396 }
397 
398 /* TODO: Docs */
399 PetscErrorCode PCPatchSetSubMatType(PC pc, MatType sub_mat_type)
400 {
401   PC_PATCH      *patch = (PC_PATCH *) pc->data;
402   PetscErrorCode ierr;
403 
404   PetscFunctionBegin;
405   if (patch->sub_mat_type) {ierr = PetscFree(patch->sub_mat_type);CHKERRQ(ierr);}
406   ierr = PetscStrallocpy(sub_mat_type, (char **) &patch->sub_mat_type);CHKERRQ(ierr);
407   PetscFunctionReturn(0);
408 }
409 
410 /* TODO: Docs */
411 PetscErrorCode PCPatchGetSubMatType(PC pc, MatType *sub_mat_type)
412 {
413   PC_PATCH *patch = (PC_PATCH *) pc->data;
414   PetscFunctionBegin;
415   *sub_mat_type = patch->sub_mat_type;
416   PetscFunctionReturn(0);
417 }
418 
419 /* TODO: Docs */
420 PetscErrorCode PCPatchSetCellNumbering(PC pc, PetscSection cellNumbering)
421 {
422   PC_PATCH      *patch = (PC_PATCH *) pc->data;
423   PetscErrorCode ierr;
424 
425   PetscFunctionBegin;
426   patch->cellNumbering = cellNumbering;
427   ierr = PetscObjectReference((PetscObject) cellNumbering);CHKERRQ(ierr);
428   PetscFunctionReturn(0);
429 }
430 
431 /* TODO: Docs */
432 PetscErrorCode PCPatchGetCellNumbering(PC pc, PetscSection *cellNumbering)
433 {
434   PC_PATCH *patch = (PC_PATCH *) pc->data;
435   PetscFunctionBegin;
436   *cellNumbering = patch->cellNumbering;
437   PetscFunctionReturn(0);
438 }
439 
440 /* TODO: Docs */
441 PetscErrorCode PCPatchSetConstructType(PC pc, PCPatchConstructType ctype, PetscErrorCode (*func)(PC, PetscInt *, IS **, IS *, void *), void *ctx)
442 {
443   PC_PATCH *patch = (PC_PATCH *) pc->data;
444 
445   PetscFunctionBegin;
446   patch->ctype = ctype;
447   switch (ctype) {
448   case PC_PATCH_STAR:
449     patch->user_patches     = PETSC_FALSE;
450     patch->patchconstructop = PCPatchConstruct_Star;
451     break;
452   case PC_PATCH_VANKA:
453     patch->user_patches     = PETSC_FALSE;
454     patch->patchconstructop = PCPatchConstruct_Vanka;
455     break;
456   case PC_PATCH_PARDECOMP:
457     patch->user_patches     = PETSC_FALSE;
458     patch->patchconstructop = PCPatchConstruct_Pardecomp;
459     break;
460   case PC_PATCH_USER:
461   case PC_PATCH_PYTHON:
462     patch->user_patches     = PETSC_TRUE;
463     patch->patchconstructop = PCPatchConstruct_User;
464     if (func) {
465       patch->userpatchconstructionop = func;
466       patch->userpatchconstructctx   = ctx;
467     }
468     break;
469   default:
470     SETERRQ1(PetscObjectComm((PetscObject) pc), PETSC_ERR_USER, "Unknown patch construction type %D", (PetscInt) patch->ctype);
471   }
472   PetscFunctionReturn(0);
473 }
474 
475 /* TODO: Docs */
476 PetscErrorCode PCPatchGetConstructType(PC pc, PCPatchConstructType *ctype, PetscErrorCode (**func)(PC, PetscInt *, IS **, IS *, void *), void **ctx)
477 {
478   PC_PATCH *patch = (PC_PATCH *) pc->data;
479 
480   PetscFunctionBegin;
481   *ctype = patch->ctype;
482   switch (patch->ctype) {
483   case PC_PATCH_STAR:
484   case PC_PATCH_VANKA:
485   case PC_PATCH_PARDECOMP:
486     break;
487   case PC_PATCH_USER:
488   case PC_PATCH_PYTHON:
489     *func = patch->userpatchconstructionop;
490     *ctx  = patch->userpatchconstructctx;
491     break;
492   default:
493     SETERRQ1(PetscObjectComm((PetscObject) pc), PETSC_ERR_USER, "Unknown patch construction type %D", (PetscInt) patch->ctype);
494   }
495   PetscFunctionReturn(0);
496 }
497 
498 /* TODO: Docs */
499 PetscErrorCode PCPatchSetDiscretisationInfo(PC pc, PetscInt nsubspaces, DM *dms, PetscInt *bs, PetscInt *nodesPerCell, const PetscInt **cellNodeMap,
500                                             const PetscInt *subspaceOffsets, PetscInt numGhostBcs, const PetscInt *ghostBcNodes, PetscInt numGlobalBcs, const PetscInt *globalBcNodes)
501 {
502   PC_PATCH      *patch = (PC_PATCH *) pc->data;
503   DM             dm;
504   PetscSF       *sfs;
505   PetscInt       cStart, cEnd, i, j;
506   PetscErrorCode ierr;
507 
508   PetscFunctionBegin;
509   ierr = PCGetDM(pc, &dm);CHKERRQ(ierr);
510   ierr = DMPlexGetHeightStratum(dm, 0, &cStart, &cEnd);CHKERRQ(ierr);
511   ierr = PetscMalloc1(nsubspaces, &sfs);CHKERRQ(ierr);
512   ierr = PetscMalloc1(nsubspaces, &patch->dofSection);CHKERRQ(ierr);
513   ierr = PetscMalloc1(nsubspaces, &patch->bs);CHKERRQ(ierr);
514   ierr = PetscMalloc1(nsubspaces, &patch->nodesPerCell);CHKERRQ(ierr);
515   ierr = PetscMalloc1(nsubspaces, &patch->cellNodeMap);CHKERRQ(ierr);
516   ierr = PetscMalloc1(nsubspaces+1, &patch->subspaceOffsets);CHKERRQ(ierr);
517 
518   patch->nsubspaces       = nsubspaces;
519   patch->totalDofsPerCell = 0;
520   for (i = 0; i < nsubspaces; ++i) {
521     ierr = DMGetDefaultSection(dms[i], &patch->dofSection[i]);CHKERRQ(ierr);
522     ierr = PetscObjectReference((PetscObject) patch->dofSection[i]);CHKERRQ(ierr);
523     ierr = DMGetDefaultSF(dms[i], &sfs[i]);CHKERRQ(ierr);
524     patch->bs[i]              = bs[i];
525     patch->nodesPerCell[i]    = nodesPerCell[i];
526     patch->totalDofsPerCell  += nodesPerCell[i]*bs[i];
527     ierr = PetscMalloc1((cEnd-cStart)*nodesPerCell[i], &patch->cellNodeMap[i]);CHKERRQ(ierr);
528     for (j = 0; j < (cEnd-cStart)*nodesPerCell[i]; ++j) patch->cellNodeMap[i][j] = cellNodeMap[i][j];
529     patch->subspaceOffsets[i] = subspaceOffsets[i];
530   }
531   ierr = PCPatchCreateDefaultSF_Private(pc, nsubspaces, sfs, patch->bs);CHKERRQ(ierr);
532   ierr = PetscFree(sfs);CHKERRQ(ierr);
533 
534   patch->subspaceOffsets[nsubspaces] = subspaceOffsets[nsubspaces];
535   ierr = ISCreateGeneral(PETSC_COMM_SELF, numGhostBcs, ghostBcNodes, PETSC_COPY_VALUES, &patch->ghostBcNodes);CHKERRQ(ierr);
536   ierr = ISCreateGeneral(PETSC_COMM_SELF, numGlobalBcs, globalBcNodes, PETSC_COPY_VALUES, &patch->globalBcNodes);CHKERRQ(ierr);
537   PetscFunctionReturn(0);
538 }
539 
540 /* TODO: Docs */
541 PetscErrorCode PCPatchSetDiscretisationInfoCombined(PC pc, DM dm, PetscInt *nodesPerCell, const PetscInt **cellNodeMap, PetscInt numGhostBcs, const PetscInt *ghostBcNodes, PetscInt numGlobalBcs, const PetscInt *globalBcNodes)
542 {
543   PC_PATCH      *patch = (PC_PATCH *) pc->data;
544   PetscInt       cStart, cEnd, i, j;
545   PetscErrorCode ierr;
546 
547   PetscFunctionBegin;
548   patch->combined = PETSC_TRUE;
549   ierr = DMPlexGetHeightStratum(dm, 0, &cStart, &cEnd);CHKERRQ(ierr);
550   ierr = DMGetNumFields(dm, &patch->nsubspaces);CHKERRQ(ierr);
551   ierr = PetscCalloc1(patch->nsubspaces, &patch->dofSection);CHKERRQ(ierr);
552   ierr = PetscMalloc1(patch->nsubspaces, &patch->bs);CHKERRQ(ierr);
553   ierr = PetscMalloc1(patch->nsubspaces, &patch->nodesPerCell);CHKERRQ(ierr);
554   ierr = PetscMalloc1(patch->nsubspaces, &patch->cellNodeMap);CHKERRQ(ierr);
555   ierr = PetscCalloc1(patch->nsubspaces+1, &patch->subspaceOffsets);CHKERRQ(ierr);
556   ierr = DMGetDefaultSection(dm, &patch->dofSection[0]);CHKERRQ(ierr);
557   ierr = PetscObjectReference((PetscObject) patch->dofSection[0]);CHKERRQ(ierr);
558   ierr = PetscSectionGetStorageSize(patch->dofSection[0], &patch->subspaceOffsets[patch->nsubspaces]);CHKERRQ(ierr);
559   patch->totalDofsPerCell = 0;
560   for (i = 0; i < patch->nsubspaces; ++i) {
561     patch->bs[i]             = 1;
562     patch->nodesPerCell[i]   = nodesPerCell[i];
563     patch->totalDofsPerCell += nodesPerCell[i];
564     ierr = PetscMalloc1((cEnd-cStart)*nodesPerCell[i], &patch->cellNodeMap[i]);CHKERRQ(ierr);
565     for (j = 0; j < (cEnd-cStart)*nodesPerCell[i]; ++j) patch->cellNodeMap[i][j] = cellNodeMap[i][j];
566   }
567   ierr = DMGetDefaultSF(dm, &patch->defaultSF);CHKERRQ(ierr);
568   ierr = PetscObjectReference((PetscObject) patch->defaultSF);CHKERRQ(ierr);
569   ierr = ISCreateGeneral(PETSC_COMM_SELF, numGhostBcs, ghostBcNodes, PETSC_COPY_VALUES, &patch->ghostBcNodes);CHKERRQ(ierr);
570   ierr = ISCreateGeneral(PETSC_COMM_SELF, numGlobalBcs, globalBcNodes, PETSC_COPY_VALUES, &patch->globalBcNodes);CHKERRQ(ierr);
571   PetscFunctionReturn(0);
572 }
573 
574 /*@C
575 
576   PCPatchSetComputeFunction - Set the callback used to compute patch residuals
577 
578   Logically collective on PC
579 
580   Input Parameters:
581 + pc   - The PC
582 . func - The callback
583 - ctx  - The user context
584 
585   Calling sequence of func:
586 $   func (PC pc,PetscInt point,Vec x,Vec f,IS cellIS,PetscInt n,const PetscInt* dofsArray,const PetscInt* dofsArrayWithAll,void* ctx)
587 
588 +  pc               - The PC
589 .  point            - The point
590 .  x                - The input solution (not used in linear problems)
591 .  f                - The patch residual vector
592 .  cellIS           - An array of the cell numbers
593 .  n                - The size of dofsArray
594 .  dofsArray        - The dofmap for the dofs to be solved for
595 .  dofsArrayWithAll - The dofmap for all dofs on the patch
596 -  ctx              - The user context
597 
598   Level: advanced
599 
600   Notes:
601   The entries of F (the output residual vector) have been set to zero before the call.
602 
603 .seealso: PCPatchSetComputeOperator(), PCPatchGetComputeOperator(), PCPatchSetDiscretisationInfo(), PCPatchSetComputeFunctionInteriorFacets()
604 @*/
605 PetscErrorCode PCPatchSetComputeFunction(PC pc, PetscErrorCode (*func)(PC, PetscInt, Vec, Vec, IS, PetscInt, const PetscInt *, const PetscInt *, void *), void *ctx)
606 {
607   PC_PATCH *patch = (PC_PATCH *) pc->data;
608 
609   PetscFunctionBegin;
610   patch->usercomputef    = func;
611   patch->usercomputefctx = ctx;
612   PetscFunctionReturn(0);
613 }
614 
615 /*@C
616 
617   PCPatchSetComputeFunctionInteriorFacets - Set the callback used to compute facet integrals for patch residuals
618 
619   Logically collective on PC
620 
621   Input Parameters:
622 + pc   - The PC
623 . func - The callback
624 - ctx  - The user context
625 
626   Calling sequence of func:
627 $   func (PC pc,PetscInt point,Vec x,Vec f,IS facetIS,PetscInt n,const PetscInt* dofsArray,const PetscInt* dofsArrayWithAll,void* ctx)
628 
629 +  pc               - The PC
630 .  point            - The point
631 .  x                - The input solution (not used in linear problems)
632 .  f                - The patch residual vector
633 .  facetIS          - An array of the facet numbers
634 .  n                - The size of dofsArray
635 .  dofsArray        - The dofmap for the dofs to be solved for
636 .  dofsArrayWithAll - The dofmap for all dofs on the patch
637 -  ctx              - The user context
638 
639   Level: advanced
640 
641   Notes:
642   The entries of F (the output residual vector) have been set to zero before the call.
643 
644 .seealso: PCPatchSetComputeOperator(), PCPatchGetComputeOperator(), PCPatchSetDiscretisationInfo(), PCPatchSetComputeFunction()
645 @*/
646 PetscErrorCode PCPatchSetComputeFunctionInteriorFacets(PC pc, PetscErrorCode (*func)(PC, PetscInt, Vec, Vec, IS, PetscInt, const PetscInt *, const PetscInt *, void *), void *ctx)
647 {
648   PC_PATCH *patch = (PC_PATCH *) pc->data;
649 
650   PetscFunctionBegin;
651   patch->usercomputefintfacet    = func;
652   patch->usercomputefintfacetctx = ctx;
653   PetscFunctionReturn(0);
654 }
655 
656 /*@C
657 
658   PCPatchSetComputeOperator - Set the callback used to compute patch matrices
659 
660   Logically collective on PC
661 
662   Input Parameters:
663 + pc   - The PC
664 . func - The callback
665 - ctx  - The user context
666 
667   Calling sequence of func:
668 $   func (PC pc,PetscInt point,Vec x,Mat mat,IS facetIS,PetscInt n,const PetscInt* dofsArray,const PetscInt* dofsArrayWithAll,void* ctx)
669 
670 +  pc               - The PC
671 .  point            - The point
672 .  x                - The input solution (not used in linear problems)
673 .  mat              - The patch matrix
674 .  cellIS           - An array of the cell numbers
675 .  n                - The size of dofsArray
676 .  dofsArray        - The dofmap for the dofs to be solved for
677 .  dofsArrayWithAll - The dofmap for all dofs on the patch
678 -  ctx              - The user context
679 
680   Level: advanced
681 
682   Notes:
683   The matrix entries have been set to zero before the call.
684 
685 .seealso: PCPatchGetComputeOperator(), PCPatchSetComputeFunction(), PCPatchSetDiscretisationInfo()
686 @*/
687 PetscErrorCode PCPatchSetComputeOperator(PC pc, PetscErrorCode (*func)(PC, PetscInt, Vec, Mat, IS, PetscInt, const PetscInt *, const PetscInt *, void *), void *ctx)
688 {
689   PC_PATCH *patch = (PC_PATCH *) pc->data;
690 
691   PetscFunctionBegin;
692   patch->usercomputeop    = func;
693   patch->usercomputeopctx = ctx;
694   PetscFunctionReturn(0);
695 }
696 
697 /*@C
698 
699   PCPatchSetComputeOperatorInteriorFacets - Set the callback used to compute facet integrals for patch matrices
700 
701   Logically collective on PC
702 
703   Input Parameters:
704 + pc   - The PC
705 . func - The callback
706 - ctx  - The user context
707 
708   Calling sequence of func:
709 $   func (PC pc,PetscInt point,Vec x,Mat mat,IS facetIS,PetscInt n,const PetscInt* dofsArray,const PetscInt* dofsArrayWithAll,void* ctx)
710 
711 +  pc               - The PC
712 .  point            - The point
713 .  x                - The input solution (not used in linear problems)
714 .  mat              - The patch matrix
715 .  facetIS          - An array of the facet numbers
716 .  n                - The size of dofsArray
717 .  dofsArray        - The dofmap for the dofs to be solved for
718 .  dofsArrayWithAll - The dofmap for all dofs on the patch
719 -  ctx              - The user context
720 
721   Level: advanced
722 
723   Notes:
724   The matrix entries have been set to zero before the call.
725 
726 .seealso: PCPatchGetComputeOperator(), PCPatchSetComputeFunction(), PCPatchSetDiscretisationInfo()
727 @*/
728 PetscErrorCode PCPatchSetComputeOperatorInteriorFacets(PC pc, PetscErrorCode (*func)(PC, PetscInt, Vec, Mat, IS, PetscInt, const PetscInt *, const PetscInt *, void *), void *ctx)
729 {
730   PC_PATCH *patch = (PC_PATCH *) pc->data;
731 
732   PetscFunctionBegin;
733   patch->usercomputeopintfacet    = func;
734   patch->usercomputeopintfacetctx = ctx;
735   PetscFunctionReturn(0);
736 }
737 
738 /* On entry, ht contains the topological entities whose dofs we are responsible for solving for;
739    on exit, cht contains all the topological entities we need to compute their residuals.
740    In full generality this should incorporate knowledge of the sparsity pattern of the matrix;
741    here we assume a standard FE sparsity pattern.*/
742 /* TODO: Use DMPlexGetAdjacency() */
743 static PetscErrorCode PCPatchCompleteCellPatch(PC pc, PetscHSetI ht, PetscHSetI cht)
744 {
745   DM             dm;
746   PC_PATCH      *patch = (PC_PATCH *) pc->data;
747   PetscHashIter  hi;
748   PetscInt       point;
749   PetscInt      *star = NULL, *closure = NULL;
750   PetscInt       ignoredim, iStart = 0, iEnd = -1, starSize, closureSize, si, ci;
751   PetscInt      *fStar = NULL, *fClosure = NULL;
752   PetscInt       fBegin, fEnd, fsi, fci, fStarSize, fClosureSize;
753   PetscErrorCode ierr;
754 
755   PetscFunctionBegin;
756   ierr = PCGetDM(pc, &dm);CHKERRQ(ierr);
757   ierr = DMPlexGetHeightStratum(dm, 1, &fBegin, &fEnd);CHKERRQ(ierr);
758   ierr = PCPatchGetIgnoreDim(pc, &ignoredim);CHKERRQ(ierr);
759   if (ignoredim >= 0) {ierr = DMPlexGetDepthStratum(dm, ignoredim, &iStart, &iEnd);CHKERRQ(ierr);}
760   ierr = PetscHSetIClear(cht);CHKERRQ(ierr);
761   PetscHashIterBegin(ht, hi);
762   while (!PetscHashIterAtEnd(ht, hi)) {
763 
764     PetscHashIterGetKey(ht, hi, point);
765     PetscHashIterNext(ht, hi);
766 
767     /* Loop over all the cells that this point connects to */
768     ierr = DMPlexGetTransitiveClosure(dm, point, PETSC_FALSE, &starSize, &star);CHKERRQ(ierr);
769     for (si = 0; si < starSize*2; si += 2) {
770       const PetscInt ownedpoint = star[si];
771       /* TODO Check for point in cht before running through closure again */
772       /* now loop over all entities in the closure of that cell */
773       ierr = DMPlexGetTransitiveClosure(dm, ownedpoint, PETSC_TRUE, &closureSize, &closure);CHKERRQ(ierr);
774       for (ci = 0; ci < closureSize*2; ci += 2) {
775         const PetscInt seenpoint = closure[ci];
776         if (ignoredim >= 0 && seenpoint >= iStart && seenpoint < iEnd) continue;
777         ierr = PetscHSetIAdd(cht, seenpoint);CHKERRQ(ierr);
778         /* Facet integrals couple dofs across facets, so in that case for each of
779          * the facets we need to add all dofs on the other side of the facet to
780          * the seen dofs. */
781         if(patch->usercomputeopintfacet){
782           if(fBegin <= seenpoint && seenpoint < fEnd){
783             ierr = DMPlexGetTransitiveClosure(dm, seenpoint, PETSC_FALSE, &fStarSize, &fStar);CHKERRQ(ierr);
784             for (fsi = 0; fsi < fStarSize*2; fsi += 2) {
785               ierr = DMPlexGetTransitiveClosure(dm, fStar[fsi], PETSC_TRUE, &fClosureSize, &fClosure);CHKERRQ(ierr);
786               for (fci = 0; fci < fClosureSize*2; fci += 2) {
787                 ierr = PetscHSetIAdd(cht, fClosure[fci]);CHKERRQ(ierr);
788               }
789               ierr = DMPlexRestoreTransitiveClosure(dm, fStar[fsi], PETSC_TRUE, NULL, &fClosure);CHKERRQ(ierr);
790             }
791             ierr = DMPlexRestoreTransitiveClosure(dm, seenpoint, PETSC_FALSE, NULL, &fStar);CHKERRQ(ierr);
792           }
793         }
794       }
795       ierr = DMPlexRestoreTransitiveClosure(dm, ownedpoint, PETSC_TRUE, NULL, &closure);CHKERRQ(ierr);
796     }
797     ierr = DMPlexRestoreTransitiveClosure(dm, point, PETSC_FALSE, NULL, &star);CHKERRQ(ierr);
798   }
799   PetscFunctionReturn(0);
800 }
801 
802 static PetscErrorCode PCPatchGetGlobalDofs(PC pc, PetscSection dofSection[], PetscInt f, PetscBool combined, PetscInt p, PetscInt *dof, PetscInt *off)
803 {
804   PetscErrorCode ierr;
805 
806   PetscFunctionBegin;
807   if (combined) {
808     if (f < 0) {
809       if (dof) {ierr = PetscSectionGetDof(dofSection[0], p, dof);CHKERRQ(ierr);}
810       if (off) {ierr = PetscSectionGetOffset(dofSection[0], p, off);CHKERRQ(ierr);}
811     } else {
812       if (dof) {ierr = PetscSectionGetFieldDof(dofSection[0], p, f, dof);CHKERRQ(ierr);}
813       if (off) {ierr = PetscSectionGetFieldOffset(dofSection[0], p, f, off);CHKERRQ(ierr);}
814     }
815   } else {
816     if (f < 0) {
817       PC_PATCH *patch = (PC_PATCH *) pc->data;
818       PetscInt  fdof, g;
819 
820       if (dof) {
821         *dof = 0;
822         for (g = 0; g < patch->nsubspaces; ++g) {
823           ierr = PetscSectionGetDof(dofSection[g], p, &fdof);CHKERRQ(ierr);
824           *dof += fdof;
825         }
826       }
827       if (off) {
828         *off = 0;
829         for (g = 0; g < patch->nsubspaces; ++g) {
830           ierr = PetscSectionGetOffset(dofSection[g], p, &fdof);CHKERRQ(ierr);
831           *off += fdof;
832         }
833       }
834     } else {
835       if (dof) {ierr = PetscSectionGetDof(dofSection[f], p, dof);CHKERRQ(ierr);}
836       if (off) {ierr = PetscSectionGetOffset(dofSection[f], p, off);CHKERRQ(ierr);}
837     }
838   }
839   PetscFunctionReturn(0);
840 }
841 
842 /* Given a hash table with a set of topological entities (pts), compute the degrees of
843    freedom in global concatenated numbering on those entities.
844    For Vanka smoothing, this needs to do something special: ignore dofs of the
845    constraint subspace on entities that aren't the base entity we're building the patch
846    around. */
847 static PetscErrorCode PCPatchGetPointDofs(PC pc, PetscHSetI pts, PetscHSetI dofs, PetscInt base, PetscHSetI* subspaces_to_exclude)
848 {
849   PC_PATCH      *patch = (PC_PATCH *) pc->data;
850   PetscHashIter  hi;
851   PetscInt       ldof, loff;
852   PetscInt       k, p;
853   PetscErrorCode ierr;
854 
855   PetscFunctionBegin;
856   ierr = PetscHSetIClear(dofs);CHKERRQ(ierr);
857   for (k = 0; k < patch->nsubspaces; ++k) {
858     PetscInt subspaceOffset = patch->subspaceOffsets[k];
859     PetscInt bs             = patch->bs[k];
860     PetscInt j, l;
861 
862     if (subspaces_to_exclude != NULL) {
863       PetscBool should_exclude_k = PETSC_FALSE;
864       PetscHSetIHas(*subspaces_to_exclude, k, &should_exclude_k);
865       if (should_exclude_k) {
866         /* only get this subspace dofs at the base entity, not any others */
867         ierr = PCPatchGetGlobalDofs(pc, patch->dofSection, k, patch->combined, base, &ldof, &loff);CHKERRQ(ierr);
868         if (0 == ldof) continue;
869         for (j = loff; j < ldof + loff; ++j) {
870           for (l = 0; l < bs; ++l) {
871             PetscInt dof = bs*j + l + subspaceOffset;
872             ierr = PetscHSetIAdd(dofs, dof);CHKERRQ(ierr);
873           }
874         }
875         continue; /* skip the other dofs of this subspace */
876       }
877     }
878 
879     PetscHashIterBegin(pts, hi);
880     while (!PetscHashIterAtEnd(pts, hi)) {
881       PetscHashIterGetKey(pts, hi, p);
882       PetscHashIterNext(pts, hi);
883       ierr = PCPatchGetGlobalDofs(pc, patch->dofSection, k, patch->combined, p, &ldof, &loff);CHKERRQ(ierr);
884       if (0 == ldof) continue;
885       for (j = loff; j < ldof + loff; ++j) {
886         for (l = 0; l < bs; ++l) {
887           PetscInt dof = bs*j + l + subspaceOffset;
888           ierr = PetscHSetIAdd(dofs, dof);CHKERRQ(ierr);
889         }
890       }
891     }
892   }
893   PetscFunctionReturn(0);
894 }
895 
896 /* Given two hash tables A and B, compute the keys in B that are not in A, and put them in C */
897 static PetscErrorCode PCPatchComputeSetDifference_Private(PetscHSetI A, PetscHSetI B, PetscHSetI C)
898 {
899   PetscHashIter  hi;
900   PetscInt       key;
901   PetscBool      flg;
902   PetscErrorCode ierr;
903 
904   PetscFunctionBegin;
905   ierr = PetscHSetIClear(C);CHKERRQ(ierr);
906   PetscHashIterBegin(B, hi);
907   while (!PetscHashIterAtEnd(B, hi)) {
908     PetscHashIterGetKey(B, hi, key);
909     PetscHashIterNext(B, hi);
910     ierr = PetscHSetIHas(A, key, &flg);CHKERRQ(ierr);
911     if (!flg) {ierr = PetscHSetIAdd(C, key);CHKERRQ(ierr);}
912   }
913   PetscFunctionReturn(0);
914 }
915 
916 /*
917  * PCPatchCreateCellPatches - create patches.
918  *
919  * Input Parameters:
920  * + dm - The DMPlex object defining the mesh
921  *
922  * Output Parameters:
923  * + cellCounts  - Section with counts of cells around each vertex
924  * . cells       - IS of the cell point indices of cells in each patch
925  * . pointCounts - Section with counts of cells around each vertex
926  * - point       - IS of the cell point indices of cells in each patch
927  */
928 static PetscErrorCode PCPatchCreateCellPatches(PC pc)
929 {
930   PC_PATCH       *patch = (PC_PATCH *) pc->data;
931   DMLabel         ghost = NULL;
932   DM              dm, plex;
933   PetscHSetI      ht, cht;
934   PetscSection    cellCounts,  pointCounts, intFacetCounts, extFacetCounts;
935   PetscInt       *cellsArray, *pointsArray, *intFacetsArray, *extFacetsArray, *intFacetsToPatchCell;
936   PetscInt        numCells, numPoints, numIntFacets, numExtFacets;
937   const PetscInt *leaves;
938   PetscInt        nleaves, pStart, pEnd, cStart, cEnd, vStart, vEnd, fStart, fEnd, v;
939   PetscBool       isFiredrake;
940   PetscErrorCode  ierr;
941 
942   PetscFunctionBegin;
943   /* Used to keep track of the cells in the patch. */
944   ierr = PetscHSetICreate(&ht);CHKERRQ(ierr);
945   ierr = PetscHSetICreate(&cht);CHKERRQ(ierr);
946 
947   ierr = PCGetDM(pc, &dm);CHKERRQ(ierr);
948   if (!dm) SETERRQ(PetscObjectComm((PetscObject) pc), PETSC_ERR_ARG_WRONGSTATE, "DM not yet set on patch PC\n");
949   ierr = DMConvert(dm, DMPLEX, &plex);CHKERRQ(ierr);
950   ierr = DMPlexGetChart(plex, &pStart, &pEnd);CHKERRQ(ierr);
951   ierr = DMPlexGetHeightStratum(plex, 0, &cStart, &cEnd);CHKERRQ(ierr);
952 
953   if (patch->user_patches) {
954     ierr = patch->userpatchconstructionop(pc, &patch->npatch, &patch->userIS, &patch->iterationSet, patch->userpatchconstructctx);CHKERRQ(ierr);
955     vStart = 0; vEnd = patch->npatch;
956   } else if (patch->ctype == PC_PATCH_PARDECOMP) {
957     vStart = 0; vEnd = 1;
958   } else if (patch->codim < 0) {
959     if (patch->dim < 0) {ierr = DMPlexGetDepthStratum(plex,  0,            &vStart, &vEnd);CHKERRQ(ierr);}
960     else                {ierr = DMPlexGetDepthStratum(plex,  patch->dim,   &vStart, &vEnd);CHKERRQ(ierr);}
961   } else                {ierr = DMPlexGetHeightStratum(plex, patch->codim, &vStart, &vEnd);CHKERRQ(ierr);}
962   patch->npatch = vEnd - vStart;
963 
964   /* These labels mark the owned points.  We only create patches around points that this process owns. */
965   ierr = DMHasLabel(dm, "pyop2_ghost", &isFiredrake);CHKERRQ(ierr);
966   if (isFiredrake) {
967     ierr = DMGetLabel(dm, "pyop2_ghost", &ghost);CHKERRQ(ierr);
968     ierr = DMLabelCreateIndex(ghost, pStart, pEnd);CHKERRQ(ierr);
969   } else {
970     PetscSF sf;
971 
972     ierr = DMGetPointSF(dm, &sf);CHKERRQ(ierr);
973     ierr = PetscSFGetGraph(sf, NULL, &nleaves, &leaves, NULL);CHKERRQ(ierr);
974     nleaves = PetscMax(nleaves, 0);
975   }
976 
977   ierr = PetscSectionCreate(PETSC_COMM_SELF, &patch->cellCounts);CHKERRQ(ierr);
978   ierr = PetscObjectSetName((PetscObject) patch->cellCounts, "Patch Cell Layout");CHKERRQ(ierr);
979   cellCounts = patch->cellCounts;
980   ierr = PetscSectionSetChart(cellCounts, vStart, vEnd);CHKERRQ(ierr);
981   ierr = PetscSectionCreate(PETSC_COMM_SELF, &patch->pointCounts);CHKERRQ(ierr);
982   ierr = PetscObjectSetName((PetscObject) patch->pointCounts, "Patch Point Layout");CHKERRQ(ierr);
983   pointCounts = patch->pointCounts;
984   ierr = PetscSectionSetChart(pointCounts, vStart, vEnd);CHKERRQ(ierr);
985   ierr = PetscSectionCreate(PETSC_COMM_SELF, &patch->extFacetCounts);CHKERRQ(ierr);
986   ierr = PetscObjectSetName((PetscObject) patch->extFacetCounts, "Patch Exterior Facet Layout");CHKERRQ(ierr);
987   extFacetCounts = patch->extFacetCounts;
988   ierr = PetscSectionSetChart(extFacetCounts, vStart, vEnd);CHKERRQ(ierr);
989   ierr = PetscSectionCreate(PETSC_COMM_SELF, &patch->intFacetCounts);CHKERRQ(ierr);
990   ierr = PetscObjectSetName((PetscObject) patch->intFacetCounts, "Patch Interior Facet Layout");CHKERRQ(ierr);
991   intFacetCounts = patch->intFacetCounts;
992   ierr = PetscSectionSetChart(intFacetCounts, vStart, vEnd);CHKERRQ(ierr);
993   /* Count cells and points in the patch surrounding each entity */
994   ierr = DMPlexGetHeightStratum(dm, 1, &fStart, &fEnd);CHKERRQ(ierr);
995   for (v = vStart; v < vEnd; ++v) {
996     PetscHashIter hi;
997     PetscInt       chtSize, loc = -1;
998     PetscBool      flg;
999 
1000     if (!patch->user_patches && patch->ctype != PC_PATCH_PARDECOMP) {
1001       if (ghost) {ierr = DMLabelHasPoint(ghost, v, &flg);CHKERRQ(ierr);}
1002       else       {ierr = PetscFindInt(v, nleaves, leaves, &loc);CHKERRQ(ierr); flg = loc >=0 ? PETSC_TRUE : PETSC_FALSE;}
1003       /* Not an owned entity, don't make a cell patch. */
1004       if (flg) continue;
1005     }
1006 
1007     ierr = patch->patchconstructop((void *) patch, dm, v, ht);CHKERRQ(ierr);
1008     ierr = PCPatchCompleteCellPatch(pc, ht, cht);CHKERRQ(ierr);
1009     ierr = PetscHSetIGetSize(cht, &chtSize);CHKERRQ(ierr);
1010     /* empty patch, continue */
1011     if (chtSize == 0) continue;
1012 
1013     /* safe because size(cht) > 0 from above */
1014     PetscHashIterBegin(cht, hi);
1015     while (!PetscHashIterAtEnd(cht, hi)) {
1016       PetscInt point, pdof;
1017 
1018       PetscHashIterGetKey(cht, hi, point);
1019       if (fStart <= point && point < fEnd) {
1020         const PetscInt *support;
1021         PetscInt supportSize, p;
1022         PetscBool interior = PETSC_TRUE;
1023         ierr = DMPlexGetSupport(dm, point, &support);CHKERRQ(ierr);
1024         ierr = DMPlexGetSupportSize(dm, point, &supportSize);CHKERRQ(ierr);
1025         if (supportSize == 1) {
1026           interior = PETSC_FALSE;
1027         } else {
1028           for (p = 0; p < supportSize; p++) {
1029             PetscBool found;
1030             /* FIXME: can I do this while iterating over cht? */
1031             PetscHSetIHas(cht, support[p], &found);
1032             if (!found) {
1033               interior = PETSC_FALSE;
1034               break;
1035             }
1036           }
1037         }
1038         if (interior) {
1039           ierr = PetscSectionAddDof(intFacetCounts, v, 1);CHKERRQ(ierr);
1040         } else {
1041           ierr = PetscSectionAddDof(extFacetCounts, v, 1);CHKERRQ(ierr);
1042         }
1043       }
1044       ierr = PCPatchGetGlobalDofs(pc, patch->dofSection, -1, patch->combined, point, &pdof, NULL);CHKERRQ(ierr);
1045       if (pdof)                            {ierr = PetscSectionAddDof(pointCounts, v, 1);CHKERRQ(ierr);}
1046       if (point >= cStart && point < cEnd) {ierr = PetscSectionAddDof(cellCounts, v, 1);CHKERRQ(ierr);}
1047       PetscHashIterNext(cht, hi);
1048     }
1049   }
1050   if (isFiredrake) {ierr = DMLabelDestroyIndex(ghost);CHKERRQ(ierr);}
1051 
1052   ierr = PetscSectionSetUp(cellCounts);CHKERRQ(ierr);
1053   ierr = PetscSectionGetStorageSize(cellCounts, &numCells);CHKERRQ(ierr);
1054   ierr = PetscMalloc1(numCells, &cellsArray);CHKERRQ(ierr);
1055   ierr = PetscSectionSetUp(pointCounts);CHKERRQ(ierr);
1056   ierr = PetscSectionGetStorageSize(pointCounts, &numPoints);CHKERRQ(ierr);
1057   ierr = PetscMalloc1(numPoints, &pointsArray);CHKERRQ(ierr);
1058 
1059   ierr = PetscSectionSetUp(intFacetCounts);CHKERRQ(ierr);
1060   ierr = PetscSectionSetUp(extFacetCounts);CHKERRQ(ierr);
1061   ierr = PetscSectionGetStorageSize(intFacetCounts, &numIntFacets);CHKERRQ(ierr);
1062   ierr = PetscSectionGetStorageSize(extFacetCounts, &numExtFacets);CHKERRQ(ierr);
1063   ierr = PetscMalloc1(numIntFacets, &intFacetsArray);CHKERRQ(ierr);
1064   ierr = PetscMalloc1(numIntFacets*2, &intFacetsToPatchCell);CHKERRQ(ierr);
1065   ierr = PetscMalloc1(numExtFacets, &extFacetsArray);CHKERRQ(ierr);
1066 
1067 
1068   /* Now that we know how much space we need, run through again and actually remember the cells. */
1069   for (v = vStart; v < vEnd; v++ ) {
1070     PetscHashIter hi;
1071     PetscInt       dof, off, cdof, coff, efdof, efoff, ifdof, ifoff, pdof, n = 0, cn = 0, ifn = 0, efn = 0;
1072 
1073     ierr = PetscSectionGetDof(pointCounts, v, &dof);CHKERRQ(ierr);
1074     ierr = PetscSectionGetOffset(pointCounts, v, &off);CHKERRQ(ierr);
1075     ierr = PetscSectionGetDof(cellCounts, v, &cdof);CHKERRQ(ierr);
1076     ierr = PetscSectionGetOffset(cellCounts, v, &coff);CHKERRQ(ierr);
1077     ierr = PetscSectionGetDof(intFacetCounts, v, &ifdof);CHKERRQ(ierr);
1078     ierr = PetscSectionGetOffset(intFacetCounts, v, &ifoff);CHKERRQ(ierr);
1079     ierr = PetscSectionGetDof(extFacetCounts, v, &efdof);CHKERRQ(ierr);
1080     ierr = PetscSectionGetOffset(extFacetCounts, v, &efoff);CHKERRQ(ierr);
1081     if (dof <= 0) continue;
1082     ierr = patch->patchconstructop((void *) patch, dm, v, ht);CHKERRQ(ierr);
1083     ierr = PCPatchCompleteCellPatch(pc, ht, cht);CHKERRQ(ierr);
1084     PetscHashIterBegin(cht, hi);
1085     while (!PetscHashIterAtEnd(cht, hi)) {
1086       PetscInt point;
1087 
1088       PetscHashIterGetKey(cht, hi, point);
1089       if (fStart <= point && point < fEnd) {
1090         const PetscInt *support;
1091         PetscInt supportSize, p;
1092         PetscBool interior = PETSC_TRUE;
1093         ierr = DMPlexGetSupport(dm, point, &support);CHKERRQ(ierr);
1094         ierr = DMPlexGetSupportSize(dm, point, &supportSize);CHKERRQ(ierr);
1095         if (supportSize == 1) {
1096           interior = PETSC_FALSE;
1097         } else {
1098           for (p = 0; p < supportSize; p++) {
1099             PetscBool found;
1100             /* FIXME: can I do this while iterating over cht? */
1101             PetscHSetIHas(cht, support[p], &found);
1102             if (!found) {
1103               interior = PETSC_FALSE;
1104               break;
1105             }
1106           }
1107         }
1108         if (interior) {
1109           intFacetsToPatchCell[2*(ifoff + ifn)] = support[0];
1110           intFacetsToPatchCell[2*(ifoff + ifn) + 1] = support[1];
1111           intFacetsArray[ifoff + ifn++] = point;
1112         } else {
1113           extFacetsArray[efoff + efn++] = point;
1114         }
1115       }
1116       ierr = PCPatchGetGlobalDofs(pc, patch->dofSection, -1, patch->combined, point, &pdof, NULL);CHKERRQ(ierr);
1117       if (pdof)                            {pointsArray[off + n++] = point;}
1118       if (point >= cStart && point < cEnd) {cellsArray[coff + cn++] = point;}
1119       PetscHashIterNext(cht, hi);
1120     }
1121     if (ifn != ifdof) SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Number of interior facets in patch %D is %D, but should be %D", v, ifn, ifdof);
1122     if (efn != efdof) SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Number of exterior facets in patch %D is %D, but should be %D", v, efn, efdof);
1123     if (cn != cdof) SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Number of cells in patch %D is %D, but should be %D", v, cn, cdof);
1124     if (n  != dof)  SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Number of points in patch %D is %D, but should be %D", v, n, dof);
1125 
1126     for (ifn = 0; ifn < ifdof; ifn++) {
1127       PetscInt cell0 = intFacetsToPatchCell[2*(ifoff + ifn)];
1128       PetscInt cell1 = intFacetsToPatchCell[2*(ifoff + ifn) + 1];
1129       PetscBool found0 = PETSC_FALSE, found1 = PETSC_FALSE;
1130       for (n = 0; n < cdof; n++) {
1131         if (!found0 && cell0 == cellsArray[coff + n]) {
1132           intFacetsToPatchCell[2*(ifoff + ifn)] = n;
1133           found0 = PETSC_TRUE;
1134         }
1135         if (!found1 && cell1 == cellsArray[coff + n]) {
1136           intFacetsToPatchCell[2*(ifoff + ifn) + 1] = n;
1137           found1 = PETSC_TRUE;
1138         }
1139         if (found0 && found1) break;
1140       }
1141       if (!(found0 && found1)) SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Didn't manage to find local point numbers for facet support");
1142     }
1143   }
1144   ierr = PetscHSetIDestroy(&ht);CHKERRQ(ierr);
1145   ierr = PetscHSetIDestroy(&cht);CHKERRQ(ierr);
1146   ierr = DMDestroy(&plex);CHKERRQ(ierr);
1147 
1148   ierr = ISCreateGeneral(PETSC_COMM_SELF, numCells,  cellsArray,  PETSC_OWN_POINTER, &patch->cells);CHKERRQ(ierr);
1149   ierr = PetscObjectSetName((PetscObject) patch->cells,  "Patch Cells");CHKERRQ(ierr);
1150   if (patch->viewCells) {
1151     ierr = ObjectView((PetscObject) patch->cellCounts, patch->viewerCells, patch->formatCells);CHKERRQ(ierr);
1152     ierr = ObjectView((PetscObject) patch->cells,      patch->viewerCells, patch->formatCells);CHKERRQ(ierr);
1153   }
1154   ierr = ISCreateGeneral(PETSC_COMM_SELF, numIntFacets,  intFacetsArray,  PETSC_OWN_POINTER, &patch->intFacets);CHKERRQ(ierr);
1155   ierr = PetscObjectSetName((PetscObject) patch->intFacets,  "Patch Interior Facets");CHKERRQ(ierr);
1156   ierr = ISCreateGeneral(PETSC_COMM_SELF, 2*numIntFacets, intFacetsToPatchCell, PETSC_OWN_POINTER, &patch->intFacetsToPatchCell);CHKERRQ(ierr);
1157   ierr = PetscObjectSetName((PetscObject) patch->intFacetsToPatchCell,  "Patch Interior Facets local support");CHKERRQ(ierr);
1158   if (patch->viewIntFacets) {
1159     ierr = ObjectView((PetscObject) patch->intFacetCounts,       patch->viewerIntFacets, patch->formatIntFacets);CHKERRQ(ierr);
1160     ierr = ObjectView((PetscObject) patch->intFacets,            patch->viewerIntFacets, patch->formatIntFacets);CHKERRQ(ierr);
1161     ierr = ObjectView((PetscObject) patch->intFacetsToPatchCell, patch->viewerIntFacets, patch->formatIntFacets);CHKERRQ(ierr);
1162   }
1163   ierr = ISCreateGeneral(PETSC_COMM_SELF, numExtFacets,  extFacetsArray,  PETSC_OWN_POINTER, &patch->extFacets);CHKERRQ(ierr);
1164   ierr = PetscObjectSetName((PetscObject) patch->extFacets,  "Patch Exterior Facets");CHKERRQ(ierr);
1165   if (patch->viewExtFacets) {
1166     ierr = ObjectView((PetscObject) patch->extFacetCounts, patch->viewerExtFacets, patch->formatExtFacets);CHKERRQ(ierr);
1167     ierr = ObjectView((PetscObject) patch->extFacets,      patch->viewerExtFacets, patch->formatExtFacets);CHKERRQ(ierr);
1168   }
1169   ierr = ISCreateGeneral(PETSC_COMM_SELF, numPoints, pointsArray, PETSC_OWN_POINTER, &patch->points);CHKERRQ(ierr);
1170   ierr = PetscObjectSetName((PetscObject) patch->points, "Patch Points");CHKERRQ(ierr);
1171   if (patch->viewPoints) {
1172     ierr = ObjectView((PetscObject) patch->pointCounts, patch->viewerPoints, patch->formatPoints);CHKERRQ(ierr);
1173     ierr = ObjectView((PetscObject) patch->points,      patch->viewerPoints, patch->formatPoints);CHKERRQ(ierr);
1174   }
1175   PetscFunctionReturn(0);
1176 }
1177 
1178 /*
1179  * PCPatchCreateCellPatchDiscretisationInfo - Build the dof maps for cell patches
1180  *
1181  * Input Parameters:
1182  * + dm - The DMPlex object defining the mesh
1183  * . cellCounts - Section with counts of cells around each vertex
1184  * . cells - IS of the cell point indices of cells in each patch
1185  * . cellNumbering - Section mapping plex cell points to Firedrake cell indices.
1186  * . nodesPerCell - number of nodes per cell.
1187  * - cellNodeMap - map from cells to node indices (nodesPerCell * numCells)
1188  *
1189  * Output Parameters:
1190  * + dofs - IS of local dof numbers of each cell in the patch, where local is a patch local numbering
1191  * . gtolCounts - Section with counts of dofs per cell patch
1192  * - gtol - IS mapping from global dofs to local dofs for each patch.
1193  */
1194 static PetscErrorCode PCPatchCreateCellPatchDiscretisationInfo(PC pc)
1195 {
1196   PC_PATCH       *patch           = (PC_PATCH *) pc->data;
1197   PetscSection    cellCounts      = patch->cellCounts;
1198   PetscSection    pointCounts     = patch->pointCounts;
1199   PetscSection    gtolCounts, gtolCountsWithArtificial = NULL, gtolCountsWithAll = NULL;
1200   IS              cells           = patch->cells;
1201   IS              points          = patch->points;
1202   PetscSection    cellNumbering   = patch->cellNumbering;
1203   PetscInt        Nf              = patch->nsubspaces;
1204   PetscInt        numCells, numPoints;
1205   PetscInt        numDofs;
1206   PetscInt        numGlobalDofs, numGlobalDofsWithArtificial, numGlobalDofsWithAll;
1207   PetscInt        totalDofsPerCell = patch->totalDofsPerCell;
1208   PetscInt        vStart, vEnd, v;
1209   const PetscInt *cellsArray, *pointsArray;
1210   PetscInt       *newCellsArray   = NULL;
1211   PetscInt       *dofsArray       = NULL;
1212   PetscInt       *dofsArrayWithArtificial = NULL;
1213   PetscInt       *dofsArrayWithAll = NULL;
1214   PetscInt       *offsArray       = NULL;
1215   PetscInt       *offsArrayWithArtificial = NULL;
1216   PetscInt       *offsArrayWithAll = NULL;
1217   PetscInt       *asmArray        = NULL;
1218   PetscInt       *asmArrayWithArtificial = NULL;
1219   PetscInt       *asmArrayWithAll = NULL;
1220   PetscInt       *globalDofsArray = NULL;
1221   PetscInt       *globalDofsArrayWithArtificial = NULL;
1222   PetscInt       *globalDofsArrayWithAll = NULL;
1223   PetscInt        globalIndex     = 0;
1224   PetscInt        key             = 0;
1225   PetscInt        asmKey          = 0;
1226   DM              dm              = NULL;
1227   const PetscInt *bcNodes         = NULL;
1228   PetscHMapI      ht;
1229   PetscHMapI      htWithArtificial;
1230   PetscHMapI      htWithAll;
1231   PetscHSetI      globalBcs;
1232   PetscInt        numBcs;
1233   PetscHSetI      ownedpts, seenpts, owneddofs, seendofs, artificialbcs;
1234   PetscInt        pStart, pEnd, p, i;
1235   char            option[PETSC_MAX_PATH_LEN];
1236   PetscBool       isNonlinear;
1237   PetscErrorCode  ierr;
1238 
1239   PetscFunctionBegin;
1240 
1241   ierr = PCGetDM(pc, &dm); CHKERRQ(ierr);
1242   /* dofcounts section is cellcounts section * dofPerCell */
1243   ierr = PetscSectionGetStorageSize(cellCounts, &numCells);CHKERRQ(ierr);
1244   ierr = PetscSectionGetStorageSize(patch->pointCounts, &numPoints);CHKERRQ(ierr);
1245   numDofs = numCells * totalDofsPerCell;
1246   ierr = PetscMalloc1(numDofs, &dofsArray);CHKERRQ(ierr);
1247   ierr = PetscMalloc1(numPoints*Nf, &offsArray);CHKERRQ(ierr);
1248   ierr = PetscMalloc1(numDofs, &asmArray);CHKERRQ(ierr);
1249   ierr = PetscMalloc1(numCells, &newCellsArray);CHKERRQ(ierr);
1250   ierr = PetscSectionGetChart(cellCounts, &vStart, &vEnd);CHKERRQ(ierr);
1251   ierr = PetscSectionCreate(PETSC_COMM_SELF, &patch->gtolCounts);CHKERRQ(ierr);
1252   gtolCounts = patch->gtolCounts;
1253   ierr = PetscSectionSetChart(gtolCounts, vStart, vEnd);CHKERRQ(ierr);
1254   ierr = PetscObjectSetName((PetscObject) patch->gtolCounts, "Patch Global Index Section");CHKERRQ(ierr);
1255 
1256   if(patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE)
1257   {
1258     ierr = PetscMalloc1(numPoints*Nf, &offsArrayWithArtificial);CHKERRQ(ierr);
1259     ierr = PetscMalloc1(numDofs, &asmArrayWithArtificial);CHKERRQ(ierr);
1260     ierr = PetscMalloc1(numDofs, &dofsArrayWithArtificial);CHKERRQ(ierr);
1261     ierr = PetscSectionCreate(PETSC_COMM_SELF, &patch->gtolCountsWithArtificial);CHKERRQ(ierr);
1262     gtolCountsWithArtificial = patch->gtolCountsWithArtificial;
1263     ierr = PetscSectionSetChart(gtolCountsWithArtificial, vStart, vEnd);CHKERRQ(ierr);
1264     ierr = PetscObjectSetName((PetscObject) patch->gtolCountsWithArtificial, "Patch Global Index Section Including Artificial BCs");CHKERRQ(ierr);
1265   }
1266 
1267   isNonlinear = patch->isNonlinear;
1268   if(isNonlinear)
1269   {
1270     ierr = PetscMalloc1(numPoints*Nf, &offsArrayWithAll);CHKERRQ(ierr);
1271     ierr = PetscMalloc1(numDofs, &asmArrayWithAll);CHKERRQ(ierr);
1272     ierr = PetscMalloc1(numDofs, &dofsArrayWithAll);CHKERRQ(ierr);
1273     ierr = PetscSectionCreate(PETSC_COMM_SELF, &patch->gtolCountsWithAll);CHKERRQ(ierr);
1274     gtolCountsWithAll = patch->gtolCountsWithAll;
1275     ierr = PetscSectionSetChart(gtolCountsWithAll, vStart, vEnd);CHKERRQ(ierr);
1276     ierr = PetscObjectSetName((PetscObject) patch->gtolCountsWithAll, "Patch Global Index Section Including All BCs");CHKERRQ(ierr);
1277   }
1278 
1279   /* Outside the patch loop, get the dofs that are globally-enforced Dirichlet
1280    conditions */
1281   ierr = PetscHSetICreate(&globalBcs);CHKERRQ(ierr);
1282   ierr = ISGetIndices(patch->ghostBcNodes, &bcNodes); CHKERRQ(ierr);
1283   ierr = ISGetSize(patch->ghostBcNodes, &numBcs); CHKERRQ(ierr);
1284   for (i = 0; i < numBcs; ++i) {
1285     ierr = PetscHSetIAdd(globalBcs, bcNodes[i]);CHKERRQ(ierr); /* these are already in concatenated numbering */
1286   }
1287   ierr = ISRestoreIndices(patch->ghostBcNodes, &bcNodes); CHKERRQ(ierr);
1288   ierr = ISDestroy(&patch->ghostBcNodes); CHKERRQ(ierr); /* memory optimisation */
1289 
1290   /* Hash tables for artificial BC construction */
1291   ierr = PetscHSetICreate(&ownedpts);CHKERRQ(ierr);
1292   ierr = PetscHSetICreate(&seenpts);CHKERRQ(ierr);
1293   ierr = PetscHSetICreate(&owneddofs);CHKERRQ(ierr);
1294   ierr = PetscHSetICreate(&seendofs);CHKERRQ(ierr);
1295   ierr = PetscHSetICreate(&artificialbcs);CHKERRQ(ierr);
1296 
1297   ierr = ISGetIndices(cells, &cellsArray);CHKERRQ(ierr);
1298   ierr = ISGetIndices(points, &pointsArray);CHKERRQ(ierr);
1299   ierr = PetscHMapICreate(&ht);CHKERRQ(ierr);
1300   ierr = PetscHMapICreate(&htWithArtificial);CHKERRQ(ierr);
1301   ierr = PetscHMapICreate(&htWithAll);CHKERRQ(ierr);
1302   for (v = vStart; v < vEnd; ++v) {
1303     PetscInt localIndex = 0;
1304     PetscInt localIndexWithArtificial = 0;
1305     PetscInt localIndexWithAll = 0;
1306     PetscInt dof, off, i, j, k, l;
1307 
1308     ierr = PetscHMapIClear(ht);CHKERRQ(ierr);
1309     ierr = PetscHMapIClear(htWithArtificial);CHKERRQ(ierr);
1310     ierr = PetscHMapIClear(htWithAll);CHKERRQ(ierr);
1311     ierr = PetscSectionGetDof(cellCounts, v, &dof);CHKERRQ(ierr);
1312     ierr = PetscSectionGetOffset(cellCounts, v, &off);CHKERRQ(ierr);
1313     if (dof <= 0) continue;
1314 
1315     /* Calculate the global numbers of the artificial BC dofs here first */
1316     ierr = patch->patchconstructop((void*)patch, dm, v, ownedpts); CHKERRQ(ierr);
1317     ierr = PCPatchCompleteCellPatch(pc, ownedpts, seenpts); CHKERRQ(ierr);
1318     ierr = PCPatchGetPointDofs(pc, ownedpts, owneddofs, v, &patch->subspaces_to_exclude); CHKERRQ(ierr);
1319     ierr = PCPatchGetPointDofs(pc, seenpts, seendofs, v, NULL); CHKERRQ(ierr);
1320     ierr = PCPatchComputeSetDifference_Private(owneddofs, seendofs, artificialbcs); CHKERRQ(ierr);
1321     if (patch->viewPatches) {
1322       PetscHSetI globalbcdofs;
1323       PetscHashIter hi;
1324       MPI_Comm comm = PetscObjectComm((PetscObject)pc);
1325 
1326       ierr = PetscHSetICreate(&globalbcdofs);CHKERRQ(ierr);
1327       ierr = PetscSynchronizedPrintf(comm, "Patch %d: owned dofs:\n", v); CHKERRQ(ierr);
1328       PetscHashIterBegin(owneddofs, hi);
1329       while (!PetscHashIterAtEnd(owneddofs, hi)) {
1330         PetscInt globalDof;
1331 
1332         PetscHashIterGetKey(owneddofs, hi, globalDof);
1333         PetscHashIterNext(owneddofs, hi);
1334         ierr = PetscSynchronizedPrintf(comm, "%d ", globalDof); CHKERRQ(ierr);
1335       }
1336       ierr = PetscSynchronizedPrintf(comm, "\n"); CHKERRQ(ierr);
1337       ierr = PetscSynchronizedPrintf(comm, "Patch %d: seen dofs:\n", v); CHKERRQ(ierr);
1338       PetscHashIterBegin(seendofs, hi);
1339       while (!PetscHashIterAtEnd(seendofs, hi)) {
1340         PetscInt globalDof;
1341         PetscBool flg;
1342 
1343         PetscHashIterGetKey(seendofs, hi, globalDof);
1344         PetscHashIterNext(seendofs, hi);
1345         ierr = PetscSynchronizedPrintf(comm, "%d ", globalDof); CHKERRQ(ierr);
1346 
1347         ierr = PetscHSetIHas(globalBcs, globalDof, &flg);CHKERRQ(ierr);
1348         if (flg) {ierr = PetscHSetIAdd(globalbcdofs, globalDof);CHKERRQ(ierr);}
1349       }
1350       ierr = PetscSynchronizedPrintf(comm, "\n"); CHKERRQ(ierr);
1351       ierr = PetscSynchronizedPrintf(comm, "Patch %d: global BCs:\n", v); CHKERRQ(ierr);
1352       ierr = PetscHSetIGetSize(globalbcdofs, &numBcs);CHKERRQ(ierr);
1353       if (numBcs > 0) {
1354         PetscHashIterBegin(globalbcdofs, hi);
1355         while (!PetscHashIterAtEnd(globalbcdofs, hi)) {
1356           PetscInt globalDof;
1357           PetscHashIterGetKey(globalbcdofs, hi, globalDof);
1358           PetscHashIterNext(globalbcdofs, hi);
1359           ierr = PetscSynchronizedPrintf(comm, "%d ", globalDof);CHKERRQ(ierr);
1360         }
1361       }
1362       ierr = PetscSynchronizedPrintf(comm, "\n");CHKERRQ(ierr);
1363       ierr = PetscSynchronizedPrintf(comm, "Patch %d: artificial BCs:\n", v);CHKERRQ(ierr);
1364       ierr = PetscHSetIGetSize(artificialbcs, &numBcs);CHKERRQ(ierr);
1365       if (numBcs > 0) {
1366         PetscHashIterBegin(artificialbcs, hi);
1367         while (!PetscHashIterAtEnd(artificialbcs, hi)) {
1368           PetscInt globalDof;
1369           PetscHashIterGetKey(artificialbcs, hi, globalDof);
1370           PetscHashIterNext(artificialbcs, hi);
1371           ierr = PetscSynchronizedPrintf(comm, "%d ", globalDof); CHKERRQ(ierr);
1372         }
1373       }
1374       ierr = PetscSynchronizedPrintf(comm, "\n\n"); CHKERRQ(ierr);
1375       ierr = PetscHSetIDestroy(&globalbcdofs);CHKERRQ(ierr);
1376     }
1377    for (k = 0; k < patch->nsubspaces; ++k) {
1378       const PetscInt *cellNodeMap    = patch->cellNodeMap[k];
1379       PetscInt        nodesPerCell   = patch->nodesPerCell[k];
1380       PetscInt        subspaceOffset = patch->subspaceOffsets[k];
1381       PetscInt        bs             = patch->bs[k];
1382 
1383       for (i = off; i < off + dof; ++i) {
1384         /* Walk over the cells in this patch. */
1385         const PetscInt c    = cellsArray[i];
1386         PetscInt       cell = c;
1387 
1388         /* TODO Change this to an IS */
1389         if (cellNumbering) {
1390           ierr = PetscSectionGetDof(cellNumbering, c, &cell);CHKERRQ(ierr);
1391           if (cell <= 0) SETERRQ1(PetscObjectComm((PetscObject) pc), PETSC_ERR_ARG_OUTOFRANGE, "Cell %D doesn't appear in cell numbering map", c);
1392           ierr = PetscSectionGetOffset(cellNumbering, c, &cell);CHKERRQ(ierr);
1393         }
1394         newCellsArray[i] = cell;
1395         for (j = 0; j < nodesPerCell; ++j) {
1396           /* For each global dof, map it into contiguous local storage. */
1397           const PetscInt globalDof = cellNodeMap[cell*nodesPerCell + j]*bs + subspaceOffset;
1398           /* finally, loop over block size */
1399           for (l = 0; l < bs; ++l) {
1400             PetscInt  localDof;
1401             PetscBool isGlobalBcDof, isArtificialBcDof;
1402 
1403             /* first, check if this is either a globally enforced or locally enforced BC dof */
1404             ierr = PetscHSetIHas(globalBcs, globalDof + l, &isGlobalBcDof);CHKERRQ(ierr);
1405             ierr = PetscHSetIHas(artificialbcs, globalDof + l, &isArtificialBcDof);CHKERRQ(ierr);
1406 
1407             /* if it's either, don't ever give it a local dof number */
1408             if (isGlobalBcDof || isArtificialBcDof) {
1409               dofsArray[globalIndex] = -1; /* don't use this in assembly in this patch */
1410             } else {
1411               ierr = PetscHMapIGet(ht, globalDof + l, &localDof);CHKERRQ(ierr);
1412               if (localDof == -1) {
1413                 localDof = localIndex++;
1414                 ierr = PetscHMapISet(ht, globalDof + l, localDof);CHKERRQ(ierr);
1415               }
1416               if ( globalIndex >= numDofs ) SETERRQ2(PETSC_COMM_WORLD, PETSC_ERR_ARG_OUTOFRANGE, "Found more dofs %D than expected %D", globalIndex+1, numDofs);
1417               /* And store. */
1418               dofsArray[globalIndex] = localDof;
1419             }
1420 
1421             if(patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE) {
1422               if (isGlobalBcDof) {
1423                 dofsArrayWithArtificial[globalIndex] = -1; /* don't use this in assembly in this patch */
1424               } else {
1425                 ierr = PetscHMapIGet(htWithArtificial, globalDof + l, &localDof);CHKERRQ(ierr);
1426                 if (localDof == -1) {
1427                   localDof = localIndexWithArtificial++;
1428                   ierr = PetscHMapISet(htWithArtificial, globalDof + l, localDof);CHKERRQ(ierr);
1429                 }
1430                 if ( globalIndex >= numDofs ) SETERRQ2(PETSC_COMM_WORLD, PETSC_ERR_ARG_OUTOFRANGE, "Found more dofs %D than expected %D", globalIndex+1, numDofs);
1431                 /* And store.*/
1432                 dofsArrayWithArtificial[globalIndex] = localDof;
1433               }
1434             }
1435 
1436             if(isNonlinear) {
1437               /* Build the dofmap for the function space with _all_ dofs,
1438                  including those in any kind of boundary condition */
1439               ierr = PetscHMapIGet(htWithAll, globalDof + l, &localDof);CHKERRQ(ierr);
1440               if (localDof == -1) {
1441                 localDof = localIndexWithAll++;
1442                 ierr = PetscHMapISet(htWithAll, globalDof + l, localDof);CHKERRQ(ierr);
1443               }
1444               if ( globalIndex >= numDofs ) SETERRQ2(PETSC_COMM_WORLD, PETSC_ERR_ARG_OUTOFRANGE, "Found more dofs %D than expected %D", globalIndex+1, numDofs);
1445               /* And store.*/
1446               dofsArrayWithAll[globalIndex] = localDof;
1447             }
1448             globalIndex++;
1449           }
1450         }
1451       }
1452     }
1453      /*How many local dofs in this patch? */
1454    if (patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE) {
1455      ierr = PetscHMapIGetSize(htWithArtificial, &dof);CHKERRQ(ierr);
1456      ierr = PetscSectionSetDof(gtolCountsWithArtificial, v, dof);CHKERRQ(ierr);
1457    }
1458    if (isNonlinear) {
1459      ierr = PetscHMapIGetSize(htWithAll, &dof);CHKERRQ(ierr);
1460      ierr = PetscSectionSetDof(gtolCountsWithAll, v, dof);CHKERRQ(ierr);
1461    }
1462     ierr = PetscHMapIGetSize(ht, &dof);CHKERRQ(ierr);
1463     ierr = PetscSectionSetDof(gtolCounts, v, dof);CHKERRQ(ierr);
1464   }
1465   if (globalIndex != numDofs) SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Expected number of dofs (%d) doesn't match found number (%d)", numDofs, globalIndex);
1466   ierr = PetscSectionSetUp(gtolCounts);CHKERRQ(ierr);
1467   ierr = PetscSectionGetStorageSize(gtolCounts, &numGlobalDofs);CHKERRQ(ierr);
1468   ierr = PetscMalloc1(numGlobalDofs, &globalDofsArray);CHKERRQ(ierr);
1469 
1470   if (patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE) {
1471     ierr = PetscSectionSetUp(gtolCountsWithArtificial);CHKERRQ(ierr);
1472     ierr = PetscSectionGetStorageSize(gtolCountsWithArtificial, &numGlobalDofsWithArtificial);CHKERRQ(ierr);
1473     ierr = PetscMalloc1(numGlobalDofsWithArtificial, &globalDofsArrayWithArtificial);CHKERRQ(ierr);
1474   }
1475   if (isNonlinear) {
1476     ierr = PetscSectionSetUp(gtolCountsWithAll);CHKERRQ(ierr);
1477     ierr = PetscSectionGetStorageSize(gtolCountsWithAll, &numGlobalDofsWithAll);CHKERRQ(ierr);
1478     ierr = PetscMalloc1(numGlobalDofsWithAll, &globalDofsArrayWithAll);CHKERRQ(ierr);
1479   }
1480   /* Now populate the global to local map.  This could be merged into the above loop if we were willing to deal with reallocs. */
1481   for (v = vStart; v < vEnd; ++v) {
1482     PetscHashIter hi;
1483     PetscInt      dof, off, Np, ooff, i, j, k, l;
1484 
1485     ierr = PetscHMapIClear(ht);CHKERRQ(ierr);
1486     ierr = PetscHMapIClear(htWithArtificial);CHKERRQ(ierr);
1487     ierr = PetscHMapIClear(htWithAll);CHKERRQ(ierr);
1488     ierr = PetscSectionGetDof(cellCounts, v, &dof);CHKERRQ(ierr);
1489     ierr = PetscSectionGetOffset(cellCounts, v, &off);CHKERRQ(ierr);
1490     ierr = PetscSectionGetDof(pointCounts, v, &Np);CHKERRQ(ierr);
1491     ierr = PetscSectionGetOffset(pointCounts, v, &ooff);CHKERRQ(ierr);
1492     if (dof <= 0) continue;
1493 
1494     for (k = 0; k < patch->nsubspaces; ++k) {
1495       const PetscInt *cellNodeMap    = patch->cellNodeMap[k];
1496       PetscInt        nodesPerCell   = patch->nodesPerCell[k];
1497       PetscInt        subspaceOffset = patch->subspaceOffsets[k];
1498       PetscInt        bs             = patch->bs[k];
1499       PetscInt        goff;
1500 
1501       for (i = off; i < off + dof; ++i) {
1502         /* Reconstruct mapping of global-to-local on this patch. */
1503         const PetscInt c    = cellsArray[i];
1504         PetscInt       cell = c;
1505 
1506         if (cellNumbering) {ierr = PetscSectionGetOffset(cellNumbering, c, &cell);CHKERRQ(ierr);}
1507         for (j = 0; j < nodesPerCell; ++j) {
1508           for (l = 0; l < bs; ++l) {
1509             const PetscInt globalDof = cellNodeMap[cell*nodesPerCell + j]*bs + l + subspaceOffset;
1510             const PetscInt localDof  = dofsArray[key];
1511             if (localDof >= 0) {ierr = PetscHMapISet(ht, globalDof, localDof);CHKERRQ(ierr);}
1512             if (patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE) {
1513               const PetscInt localDofWithArtificial = dofsArrayWithArtificial[key];
1514               if (localDofWithArtificial >= 0) {
1515                 ierr = PetscHMapISet(htWithArtificial, globalDof, localDofWithArtificial);CHKERRQ(ierr);
1516               }
1517             }
1518             if (isNonlinear) {
1519               const PetscInt localDofWithAll = dofsArrayWithAll[key];
1520               if (localDofWithAll >= 0) {
1521                 ierr = PetscHMapISet(htWithAll, globalDof, localDofWithAll);CHKERRQ(ierr);
1522               }
1523             }
1524             key++;
1525           }
1526         }
1527       }
1528 
1529       /* Shove it in the output data structure. */
1530       ierr = PetscSectionGetOffset(gtolCounts, v, &goff);CHKERRQ(ierr);
1531       PetscHashIterBegin(ht, hi);
1532       while (!PetscHashIterAtEnd(ht, hi)) {
1533         PetscInt globalDof, localDof;
1534 
1535         PetscHashIterGetKey(ht, hi, globalDof);
1536         PetscHashIterGetVal(ht, hi, localDof);
1537         if (globalDof >= 0) globalDofsArray[goff + localDof] = globalDof;
1538         PetscHashIterNext(ht, hi);
1539       }
1540 
1541       if (patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE) {
1542         ierr = PetscSectionGetOffset(gtolCountsWithArtificial, v, &goff);CHKERRQ(ierr);
1543         PetscHashIterBegin(htWithArtificial, hi);
1544         while (!PetscHashIterAtEnd(htWithArtificial, hi)) {
1545           PetscInt globalDof, localDof;
1546           PetscHashIterGetKey(htWithArtificial, hi, globalDof);
1547           PetscHashIterGetVal(htWithArtificial, hi, localDof);
1548           if (globalDof >= 0) globalDofsArrayWithArtificial[goff + localDof] = globalDof;
1549           PetscHashIterNext(htWithArtificial, hi);
1550         }
1551       }
1552       if (isNonlinear) {
1553         ierr = PetscSectionGetOffset(gtolCountsWithAll, v, &goff);CHKERRQ(ierr);
1554         PetscHashIterBegin(htWithAll, hi);
1555         while (!PetscHashIterAtEnd(htWithAll, hi)) {
1556           PetscInt globalDof, localDof;
1557           PetscHashIterGetKey(htWithAll, hi, globalDof);
1558           PetscHashIterGetVal(htWithAll, hi, localDof);
1559           if (globalDof >= 0) globalDofsArrayWithAll[goff + localDof] = globalDof;
1560           PetscHashIterNext(htWithAll, hi);
1561         }
1562       }
1563 
1564       for (p = 0; p < Np; ++p) {
1565         const PetscInt point = pointsArray[ooff + p];
1566         PetscInt       globalDof, localDof;
1567 
1568         ierr = PCPatchGetGlobalDofs(pc, patch->dofSection, k, patch->combined, point, NULL, &globalDof);CHKERRQ(ierr);
1569         ierr = PetscHMapIGet(ht, globalDof, &localDof);CHKERRQ(ierr);
1570         offsArray[(ooff + p)*Nf + k] = localDof;
1571         if (patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE) {
1572           ierr = PetscHMapIGet(htWithArtificial, globalDof, &localDof);CHKERRQ(ierr);
1573           offsArrayWithArtificial[(ooff + p)*Nf + k] = localDof;
1574         }
1575         if (isNonlinear) {
1576           ierr = PetscHMapIGet(htWithAll, globalDof, &localDof);CHKERRQ(ierr);
1577           offsArrayWithAll[(ooff + p)*Nf + k] = localDof;
1578         }
1579       }
1580     }
1581 
1582     ierr = PetscHSetIDestroy(&globalBcs);CHKERRQ(ierr);
1583     ierr = PetscHSetIDestroy(&ownedpts);CHKERRQ(ierr);
1584     ierr = PetscHSetIDestroy(&seenpts);CHKERRQ(ierr);
1585     ierr = PetscHSetIDestroy(&owneddofs);CHKERRQ(ierr);
1586     ierr = PetscHSetIDestroy(&seendofs);CHKERRQ(ierr);
1587     ierr = PetscHSetIDestroy(&artificialbcs);CHKERRQ(ierr);
1588 
1589       /* At this point, we have a hash table ht built that maps globalDof -> localDof.
1590      We need to create the dof table laid out cellwise first, then by subspace,
1591      as the assembler assembles cell-wise and we need to stuff the different
1592      contributions of the different function spaces to the right places. So we loop
1593      over cells, then over subspaces. */
1594     if (patch->nsubspaces > 1) { /* for nsubspaces = 1, data we need is already in dofsArray */
1595       for (i = off; i < off + dof; ++i) {
1596         const PetscInt c    = cellsArray[i];
1597         PetscInt       cell = c;
1598 
1599         if (cellNumbering) {ierr = PetscSectionGetOffset(cellNumbering, c, &cell);CHKERRQ(ierr);}
1600         for (k = 0; k < patch->nsubspaces; ++k) {
1601           const PetscInt *cellNodeMap    = patch->cellNodeMap[k];
1602           PetscInt        nodesPerCell   = patch->nodesPerCell[k];
1603           PetscInt        subspaceOffset = patch->subspaceOffsets[k];
1604           PetscInt        bs             = patch->bs[k];
1605 
1606           for (j = 0; j < nodesPerCell; ++j) {
1607             for (l = 0; l < bs; ++l) {
1608               const PetscInt globalDof = cellNodeMap[cell*nodesPerCell + j]*bs + l + subspaceOffset;
1609               PetscInt       localDof;
1610 
1611               ierr = PetscHMapIGet(ht, globalDof, &localDof);CHKERRQ(ierr);
1612               /* If it's not in the hash table, i.e. is a BC dof,
1613                then the PetscHSetIMap above gives -1, which matches
1614                exactly the convention for PETSc's matrix assembly to
1615                ignore the dof. So we don't need to do anything here */
1616               asmArray[asmKey] = localDof;
1617               if (patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE) {
1618                 ierr = PetscHMapIGet(htWithArtificial, globalDof, &localDof);CHKERRQ(ierr);
1619                 asmArrayWithArtificial[asmKey] = localDof;
1620               }
1621               if (isNonlinear) {
1622                 ierr = PetscHMapIGet(htWithAll, globalDof, &localDof);CHKERRQ(ierr);
1623                 asmArrayWithAll[asmKey] = localDof;
1624               }
1625               asmKey++;
1626             }
1627           }
1628         }
1629       }
1630     }
1631   }
1632   if (1 == patch->nsubspaces) {
1633     ierr = PetscMemcpy(asmArray, dofsArray, numDofs * sizeof(PetscInt));CHKERRQ(ierr);
1634     if (patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE) {
1635       ierr = PetscMemcpy(asmArrayWithArtificial, dofsArrayWithArtificial, numDofs * sizeof(PetscInt));CHKERRQ(ierr);
1636     }
1637     if (isNonlinear) {
1638       ierr = PetscMemcpy(asmArrayWithAll, dofsArrayWithAll, numDofs * sizeof(PetscInt));CHKERRQ(ierr);
1639     }
1640   }
1641 
1642   ierr = PetscHMapIDestroy(&ht);CHKERRQ(ierr);
1643   ierr = PetscHMapIDestroy(&htWithArtificial);CHKERRQ(ierr);
1644   ierr = PetscHMapIDestroy(&htWithAll);CHKERRQ(ierr);
1645   ierr = ISRestoreIndices(cells, &cellsArray);CHKERRQ(ierr);
1646   ierr = ISRestoreIndices(points, &pointsArray);CHKERRQ(ierr);
1647   ierr = PetscFree(dofsArray);CHKERRQ(ierr);
1648   if (patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE) {
1649     ierr = PetscFree(dofsArrayWithArtificial);CHKERRQ(ierr);
1650   }
1651   if (isNonlinear) {
1652     ierr = PetscFree(dofsArrayWithAll);CHKERRQ(ierr);
1653   }
1654   /* Create placeholder section for map from points to patch dofs */
1655   ierr = PetscSectionCreate(PETSC_COMM_SELF, &patch->patchSection);CHKERRQ(ierr);
1656   ierr = PetscSectionSetNumFields(patch->patchSection, patch->nsubspaces);CHKERRQ(ierr);
1657   if (patch->combined) {
1658     PetscInt numFields;
1659     ierr = PetscSectionGetNumFields(patch->dofSection[0], &numFields);CHKERRQ(ierr);
1660     if (numFields != patch->nsubspaces) SETERRQ2(PetscObjectComm((PetscObject)pc), PETSC_ERR_ARG_WRONG, "Mismatch between number of section fields %D and number of subspaces %D", numFields, patch->nsubspaces);
1661     ierr = PetscSectionGetChart(patch->dofSection[0], &pStart, &pEnd);CHKERRQ(ierr);
1662     ierr = PetscSectionSetChart(patch->patchSection, pStart, pEnd);CHKERRQ(ierr);
1663     for (p = pStart; p < pEnd; ++p) {
1664       PetscInt dof, fdof, f;
1665 
1666       ierr = PetscSectionGetDof(patch->dofSection[0], p, &dof);CHKERRQ(ierr);
1667       ierr = PetscSectionSetDof(patch->patchSection, p, dof);CHKERRQ(ierr);
1668       for (f = 0; f < patch->nsubspaces; ++f) {
1669         ierr = PetscSectionGetFieldDof(patch->dofSection[0], p, f, &fdof);CHKERRQ(ierr);
1670         ierr = PetscSectionSetFieldDof(patch->patchSection, p, f, fdof);CHKERRQ(ierr);
1671       }
1672     }
1673   } else {
1674     PetscInt pStartf, pEndf, f;
1675     pStart = PETSC_MAX_INT;
1676     pEnd = PETSC_MIN_INT;
1677     for (f = 0; f < patch->nsubspaces; ++f) {
1678       ierr = PetscSectionGetChart(patch->dofSection[f], &pStartf, &pEndf);CHKERRQ(ierr);
1679       pStart = PetscMin(pStart, pStartf);
1680       pEnd = PetscMax(pEnd, pEndf);
1681     }
1682     ierr = PetscSectionSetChart(patch->patchSection, pStart, pEnd);CHKERRQ(ierr);
1683     for (f = 0; f < patch->nsubspaces; ++f) {
1684       ierr = PetscSectionGetChart(patch->dofSection[f], &pStartf, &pEndf);CHKERRQ(ierr);
1685       for (p = pStartf; p < pEndf; ++p) {
1686         PetscInt fdof;
1687         ierr = PetscSectionGetDof(patch->dofSection[f], p, &fdof);CHKERRQ(ierr);
1688         ierr = PetscSectionAddDof(patch->patchSection, p, fdof);CHKERRQ(ierr);
1689         ierr = PetscSectionSetFieldDof(patch->patchSection, p, f, fdof);CHKERRQ(ierr);
1690       }
1691     }
1692   }
1693   ierr = PetscSectionSetUp(patch->patchSection);CHKERRQ(ierr);
1694   ierr = PetscSectionSetUseFieldOffsets(patch->patchSection, PETSC_TRUE);CHKERRQ(ierr);
1695   /* Replace cell indices with firedrake-numbered ones. */
1696   ierr = ISGeneralSetIndices(cells, numCells, (const PetscInt *) newCellsArray, PETSC_OWN_POINTER);CHKERRQ(ierr);
1697   ierr = ISCreateGeneral(PETSC_COMM_SELF, numGlobalDofs, globalDofsArray, PETSC_OWN_POINTER, &patch->gtol);CHKERRQ(ierr);
1698   ierr = PetscObjectSetName((PetscObject) patch->gtol, "Global Indices");CHKERRQ(ierr);
1699   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_g2l_view", patch->classname);CHKERRQ(ierr);
1700   ierr = PetscSectionViewFromOptions(patch->gtolCounts, (PetscObject) pc, option);CHKERRQ(ierr);
1701   ierr = ISViewFromOptions(patch->gtol, (PetscObject) pc, option);CHKERRQ(ierr);
1702   ierr = ISCreateGeneral(PETSC_COMM_SELF, numDofs, asmArray, PETSC_OWN_POINTER, &patch->dofs);CHKERRQ(ierr);
1703   ierr = ISCreateGeneral(PETSC_COMM_SELF, numPoints*Nf, offsArray, PETSC_OWN_POINTER, &patch->offs);CHKERRQ(ierr);
1704   if (patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE) {
1705     ierr = ISCreateGeneral(PETSC_COMM_SELF, numGlobalDofsWithArtificial, globalDofsArrayWithArtificial, PETSC_OWN_POINTER, &patch->gtolWithArtificial);CHKERRQ(ierr);
1706     ierr = ISCreateGeneral(PETSC_COMM_SELF, numDofs, asmArrayWithArtificial, PETSC_OWN_POINTER, &patch->dofsWithArtificial);CHKERRQ(ierr);
1707     ierr = ISCreateGeneral(PETSC_COMM_SELF, numPoints*Nf, offsArrayWithArtificial, PETSC_OWN_POINTER, &patch->offsWithArtificial);CHKERRQ(ierr);
1708   }
1709   if (isNonlinear) {
1710     ierr = ISCreateGeneral(PETSC_COMM_SELF, numGlobalDofsWithAll, globalDofsArrayWithAll, PETSC_OWN_POINTER, &patch->gtolWithAll);CHKERRQ(ierr);
1711     ierr = ISCreateGeneral(PETSC_COMM_SELF, numDofs, asmArrayWithAll, PETSC_OWN_POINTER, &patch->dofsWithAll);CHKERRQ(ierr);
1712     ierr = ISCreateGeneral(PETSC_COMM_SELF, numPoints*Nf, offsArrayWithAll, PETSC_OWN_POINTER, &patch->offsWithAll);CHKERRQ(ierr);
1713   }
1714   PetscFunctionReturn(0);
1715 }
1716 
1717 static PetscErrorCode PCPatchCreateMatrix_Private(PC pc, PetscInt point, Mat *mat, PetscBool withArtificial)
1718 {
1719   PC_PATCH      *patch = (PC_PATCH *) pc->data;
1720   Vec            x, y;
1721   PetscBool      flg;
1722   PetscInt       csize, rsize;
1723   const char    *prefix = NULL;
1724   PetscErrorCode ierr;
1725 
1726   PetscFunctionBegin;
1727   if(withArtificial) {
1728     /* would be nice if we could create a rectangular matrix of size numDofsWithArtificial x numDofs here */
1729     x = patch->patchRHSWithArtificial[point];
1730     y = patch->patchRHSWithArtificial[point];
1731   } else {
1732     x = patch->patchRHS[point];
1733     y = patch->patchUpdate[point];
1734   }
1735 
1736   ierr = VecGetSize(x, &csize);CHKERRQ(ierr);
1737   ierr = VecGetSize(y, &rsize);CHKERRQ(ierr);
1738   ierr = MatCreate(PETSC_COMM_SELF, mat);CHKERRQ(ierr);
1739   ierr = PCGetOptionsPrefix(pc, &prefix);CHKERRQ(ierr);
1740   ierr = MatSetOptionsPrefix(*mat, prefix);CHKERRQ(ierr);
1741   ierr = MatAppendOptionsPrefix(*mat, "pc_patch_sub_");CHKERRQ(ierr);
1742   if (patch->sub_mat_type)       {ierr = MatSetType(*mat, patch->sub_mat_type);CHKERRQ(ierr);}
1743   else if (!patch->sub_mat_type) {ierr = MatSetType(*mat, MATDENSE);CHKERRQ(ierr);}
1744   ierr = MatSetSizes(*mat, rsize, csize, rsize, csize);CHKERRQ(ierr);
1745   ierr = PetscObjectTypeCompare((PetscObject) *mat, MATDENSE, &flg);CHKERRQ(ierr);
1746   if (!flg) {ierr = PetscObjectTypeCompare((PetscObject)*mat, MATSEQDENSE, &flg);CHKERRQ(ierr);}
1747   /* Sparse patch matrices */
1748   if (!flg) {
1749     PetscBT         bt;
1750     PetscInt       *dnnz      = NULL;
1751     const PetscInt *dofsArray = NULL;
1752     PetscInt        pStart, pEnd, ncell, offset, c, i, j;
1753 
1754     if(withArtificial) {
1755       ierr = ISGetIndices(patch->dofsWithArtificial, &dofsArray);CHKERRQ(ierr);
1756     } else {
1757       ierr = ISGetIndices(patch->dofs, &dofsArray);CHKERRQ(ierr);
1758     }
1759     ierr = PetscSectionGetChart(patch->cellCounts, &pStart, &pEnd);CHKERRQ(ierr);
1760     point += pStart;
1761     if (point >= pEnd) SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Operator point %D not in [%D, %D)\n", point, pStart, pEnd);CHKERRQ(ierr);
1762     ierr = PetscSectionGetDof(patch->cellCounts, point, &ncell);CHKERRQ(ierr);
1763     ierr = PetscSectionGetOffset(patch->cellCounts, point, &offset);CHKERRQ(ierr);
1764     ierr = PetscLogEventBegin(PC_Patch_Prealloc, pc, 0, 0, 0);CHKERRQ(ierr);
1765     /* A PetscBT uses N^2 bits to store the sparsity pattern on a
1766      * patch. This is probably OK if the patches are not too big,
1767      * but uses too much memory. We therefore switch based on rsize. */
1768     if (rsize < 3000) { /* FIXME: I picked this switch value out of my hat */
1769       PetscScalar *zeroes;
1770       PetscInt rows;
1771 
1772       ierr = PetscCalloc1(rsize, &dnnz);CHKERRQ(ierr);
1773       ierr = PetscBTCreate(rsize*rsize, &bt);CHKERRQ(ierr);
1774       for (c = 0; c < ncell; ++c) {
1775         const PetscInt *idx = dofsArray + (offset + c)*patch->totalDofsPerCell;
1776         for (i = 0; i < patch->totalDofsPerCell; ++i) {
1777           const PetscInt row = idx[i];
1778           if (row < 0) continue;
1779           for (j = 0; j < patch->totalDofsPerCell; ++j) {
1780             const PetscInt col = idx[j];
1781             const PetscInt key = row*rsize + col;
1782             if (col < 0) continue;
1783             if (!PetscBTLookupSet(bt, key)) ++dnnz[row];
1784           }
1785         }
1786       }
1787 
1788       if (patch->usercomputeopintfacet) {
1789         const PetscInt *intFacetsArray = NULL;
1790         PetscInt        i, numIntFacets, intFacetOffset;
1791         const PetscInt *facetCells = NULL;
1792 
1793         ierr = PetscSectionGetDof(patch->intFacetCounts, point, &numIntFacets);CHKERRQ(ierr);
1794         ierr = PetscSectionGetOffset(patch->intFacetCounts, point, &intFacetOffset);CHKERRQ(ierr);
1795         ierr = ISGetIndices(patch->intFacetsToPatchCell, &facetCells);CHKERRQ(ierr);
1796         ierr = ISGetIndices(patch->intFacets, &intFacetsArray);CHKERRQ(ierr);
1797         for (i = 0; i < numIntFacets; i++) {
1798           const PetscInt cell0 = facetCells[2*(intFacetOffset + i) + 0];
1799           const PetscInt cell1 = facetCells[2*(intFacetOffset + i) + 1];
1800           PetscInt       celli, cellj;
1801 
1802           for (celli = 0; celli < patch->totalDofsPerCell; celli++) {
1803             const PetscInt row = dofsArray[(offset + cell0)*patch->totalDofsPerCell + celli];
1804             if (row < 0) continue;
1805             for (cellj = 0; cellj < patch->totalDofsPerCell; cellj++) {
1806               const PetscInt col = dofsArray[(offset + cell1)*patch->totalDofsPerCell + cellj];
1807               const PetscInt key = row*rsize + col;
1808               if (col < 0) continue;
1809               if (!PetscBTLookupSet(bt, key)) ++dnnz[row];
1810             }
1811           }
1812 
1813           for (celli = 0; celli < patch->totalDofsPerCell; celli++) {
1814             const PetscInt row = dofsArray[(offset + cell1)*patch->totalDofsPerCell + celli];
1815             if (row < 0) continue;
1816             for (cellj = 0; cellj < patch->totalDofsPerCell; cellj++) {
1817               const PetscInt col = dofsArray[(offset + cell0)*patch->totalDofsPerCell + cellj];
1818               const PetscInt key = row*rsize + col;
1819               if (col < 0) continue;
1820               if (!PetscBTLookupSet(bt, key)) ++dnnz[row];
1821             }
1822           }
1823         }
1824       }
1825       ierr = PetscBTDestroy(&bt);CHKERRQ(ierr);
1826       ierr = MatXAIJSetPreallocation(*mat, 1, dnnz, NULL, NULL, NULL);CHKERRQ(ierr);
1827       ierr = PetscFree(dnnz);CHKERRQ(ierr);
1828 
1829       ierr = PetscCalloc1(patch->totalDofsPerCell*patch->totalDofsPerCell, &zeroes);CHKERRQ(ierr);
1830       for (c = 0; c < ncell; ++c) {
1831         const PetscInt *idx = &dofsArray[(offset + c)*patch->totalDofsPerCell];
1832         ierr = MatSetValues(*mat, patch->totalDofsPerCell, idx, patch->totalDofsPerCell, idx, zeroes, INSERT_VALUES);CHKERRQ(ierr);
1833       }
1834       ierr = MatGetLocalSize(*mat, &rows, NULL);CHKERRQ(ierr);
1835       for (i = 0; i < rows; ++i) {
1836         ierr = MatSetValues(*mat, 1, &i, 1, &i, zeroes, INSERT_VALUES);CHKERRQ(ierr);
1837       }
1838 
1839       if (patch->usercomputeopintfacet) {
1840         const PetscInt *intFacetsArray = NULL;
1841         PetscInt i, numIntFacets, intFacetOffset;
1842         const PetscInt *facetCells = NULL;
1843 
1844         ierr = PetscSectionGetDof(patch->intFacetCounts, point, &numIntFacets);CHKERRQ(ierr);
1845         ierr = PetscSectionGetOffset(patch->intFacetCounts, point, &intFacetOffset);CHKERRQ(ierr);
1846         ierr = ISGetIndices(patch->intFacetsToPatchCell, &facetCells);CHKERRQ(ierr);
1847         ierr = ISGetIndices(patch->intFacets, &intFacetsArray);CHKERRQ(ierr);
1848         for (i = 0; i < numIntFacets; i++) {
1849           const PetscInt cell0 = facetCells[2*(intFacetOffset + i) + 0];
1850           const PetscInt cell1 = facetCells[2*(intFacetOffset + i) + 1];
1851           const PetscInt *cell0idx = &dofsArray[(offset + cell0)*patch->totalDofsPerCell];
1852           const PetscInt *cell1idx = &dofsArray[(offset + cell1)*patch->totalDofsPerCell];
1853           ierr = MatSetValues(*mat, patch->totalDofsPerCell, cell0idx, patch->totalDofsPerCell, cell1idx, zeroes, INSERT_VALUES);CHKERRQ(ierr);
1854           ierr = MatSetValues(*mat, patch->totalDofsPerCell, cell1idx, patch->totalDofsPerCell, cell0idx, zeroes, INSERT_VALUES);CHKERRQ(ierr);
1855         }
1856       }
1857 
1858       ierr = MatAssemblyBegin(*mat, MAT_FINAL_ASSEMBLY);CHKERRQ(ierr);
1859       ierr = MatAssemblyEnd(*mat, MAT_FINAL_ASSEMBLY);CHKERRQ(ierr);
1860 
1861       ierr = PetscFree(zeroes);CHKERRQ(ierr);
1862 
1863     } else { /* rsize too big, use MATPREALLOCATOR */
1864       Mat preallocator;
1865       PetscScalar* vals;
1866 
1867       ierr = PetscCalloc1(patch->totalDofsPerCell*patch->totalDofsPerCell, &vals);CHKERRQ(ierr);
1868       ierr = MatCreate(PETSC_COMM_SELF, &preallocator);CHKERRQ(ierr);
1869       ierr = MatSetType(preallocator, MATPREALLOCATOR);CHKERRQ(ierr);
1870       ierr = MatSetSizes(preallocator, rsize, rsize, rsize, rsize);CHKERRQ(ierr);
1871       ierr = MatSetUp(preallocator);CHKERRQ(ierr);
1872 
1873       for (c = 0; c < ncell; ++c) {
1874         const PetscInt *idx = dofsArray + (offset + c)*patch->totalDofsPerCell;
1875         ierr = MatSetValues(preallocator, patch->totalDofsPerCell, idx, patch->totalDofsPerCell, idx, vals, INSERT_VALUES);CHKERRQ(ierr);
1876       }
1877 
1878       if (patch->usercomputeopintfacet) {
1879         const PetscInt *intFacetsArray = NULL;
1880         PetscInt        i, numIntFacets, intFacetOffset;
1881         const PetscInt *facetCells = NULL;
1882 
1883         ierr = PetscSectionGetDof(patch->intFacetCounts, point, &numIntFacets);CHKERRQ(ierr);
1884         ierr = PetscSectionGetOffset(patch->intFacetCounts, point, &intFacetOffset);CHKERRQ(ierr);
1885         ierr = ISGetIndices(patch->intFacetsToPatchCell, &facetCells);CHKERRQ(ierr);
1886         ierr = ISGetIndices(patch->intFacets, &intFacetsArray);CHKERRQ(ierr);
1887         for (i = 0; i < numIntFacets; i++) {
1888           const PetscInt cell0 = facetCells[2*(intFacetOffset + i) + 0];
1889           const PetscInt cell1 = facetCells[2*(intFacetOffset + i) + 1];
1890           const PetscInt *cell0idx = &dofsArray[(offset + cell0)*patch->totalDofsPerCell];
1891           const PetscInt *cell1idx = &dofsArray[(offset + cell1)*patch->totalDofsPerCell];
1892           ierr = MatSetValues(preallocator, patch->totalDofsPerCell, cell0idx, patch->totalDofsPerCell, cell1idx, vals, INSERT_VALUES);CHKERRQ(ierr);
1893           ierr = MatSetValues(preallocator, patch->totalDofsPerCell, cell1idx, patch->totalDofsPerCell, cell0idx, vals, INSERT_VALUES);CHKERRQ(ierr);
1894         }
1895       }
1896 
1897       ierr = PetscFree(vals);CHKERRQ(ierr);
1898       ierr = MatAssemblyBegin(preallocator, MAT_FINAL_ASSEMBLY);CHKERRQ(ierr);
1899       ierr = MatAssemblyEnd(preallocator, MAT_FINAL_ASSEMBLY);CHKERRQ(ierr);
1900       ierr = MatPreallocatorPreallocate(preallocator, PETSC_TRUE, *mat);CHKERRQ(ierr);
1901       ierr = MatDestroy(&preallocator);CHKERRQ(ierr);
1902     }
1903     ierr = PetscLogEventEnd(PC_Patch_Prealloc, pc, 0, 0, 0);CHKERRQ(ierr);
1904     if(withArtificial) {
1905       ierr = ISRestoreIndices(patch->dofsWithArtificial, &dofsArray);CHKERRQ(ierr);
1906     } else {
1907       ierr = ISRestoreIndices(patch->dofs, &dofsArray);CHKERRQ(ierr);
1908     }
1909   }
1910   ierr = MatSetUp(*mat);CHKERRQ(ierr);
1911   PetscFunctionReturn(0);
1912 }
1913 
1914 static PetscErrorCode PCPatchComputeFunction_DMPlex_Private(PC pc, PetscInt patchNum, Vec x, Vec F, IS cellIS, PetscInt n, const PetscInt *l2p, const PetscInt *l2pWithAll, void *ctx)
1915 {
1916   PC_PATCH       *patch = (PC_PATCH *) pc->data;
1917   DM              dm;
1918   PetscSection    s;
1919   const PetscInt *parray, *oarray;
1920   PetscInt        Nf = patch->nsubspaces, Np, poff, p, f;
1921   PetscErrorCode  ierr;
1922 
1923   PetscFunctionBegin;
1924   if (patch->precomputeElementTensors) SETERRQ(PetscObjectComm((PetscObject)pc), PETSC_ERR_ARG_WRONGSTATE, "Precomputing element tensors not implemented with DMPlex compute operator");
1925   ierr = PCGetDM(pc, &dm);CHKERRQ(ierr);
1926   ierr = DMGetDefaultSection(dm, &s);CHKERRQ(ierr);
1927   /* Set offset into patch */
1928   ierr = PetscSectionGetDof(patch->pointCounts, patchNum, &Np);CHKERRQ(ierr);
1929   ierr = PetscSectionGetOffset(patch->pointCounts, patchNum, &poff);CHKERRQ(ierr);
1930   ierr = ISGetIndices(patch->points, &parray);CHKERRQ(ierr);
1931   ierr = ISGetIndices(patch->offs,   &oarray);CHKERRQ(ierr);
1932   for (f = 0; f < Nf; ++f) {
1933     for (p = 0; p < Np; ++p) {
1934       const PetscInt point = parray[poff+p];
1935       PetscInt       dof;
1936 
1937       ierr = PetscSectionGetFieldDof(patch->patchSection, point, f, &dof);CHKERRQ(ierr);
1938       ierr = PetscSectionSetFieldOffset(patch->patchSection, point, f, oarray[(poff+p)*Nf+f]);CHKERRQ(ierr);
1939       if (patch->nsubspaces == 1) {ierr = PetscSectionSetOffset(patch->patchSection, point, oarray[(poff+p)*Nf+f]);CHKERRQ(ierr);}
1940       else                        {ierr = PetscSectionSetOffset(patch->patchSection, point, -1);CHKERRQ(ierr);}
1941     }
1942   }
1943   ierr = ISRestoreIndices(patch->points, &parray);CHKERRQ(ierr);
1944   ierr = ISRestoreIndices(patch->offs,   &oarray);CHKERRQ(ierr);
1945   if (patch->viewSection) {ierr = ObjectView((PetscObject) patch->patchSection, patch->viewerSection, patch->formatSection);CHKERRQ(ierr);}
1946   ierr = DMPlexComputeResidual_Patch_Internal(pc->dm, patch->patchSection, cellIS, 0.0, x, NULL, F, ctx);CHKERRQ(ierr);
1947   PetscFunctionReturn(0);
1948 }
1949 
1950 PetscErrorCode PCPatchComputeFunction_Internal(PC pc, Vec x, Vec F, PetscInt point)
1951 {
1952   PC_PATCH       *patch = (PC_PATCH *) pc->data;
1953   const PetscInt *dofsArray;
1954   const PetscInt *dofsArrayWithAll;
1955   const PetscInt *cellsArray;
1956   PetscInt        ncell, offset, pStart, pEnd;
1957   PetscErrorCode  ierr;
1958 
1959   PetscFunctionBegin;
1960   ierr = PetscLogEventBegin(PC_Patch_ComputeOp, pc, 0, 0, 0);CHKERRQ(ierr);
1961   if (!patch->usercomputeop) SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "Must call PCPatchSetComputeOperator() to set user callback\n");
1962   ierr = ISGetIndices(patch->dofs, &dofsArray);CHKERRQ(ierr);
1963   ierr = ISGetIndices(patch->dofsWithAll, &dofsArrayWithAll);CHKERRQ(ierr);
1964   ierr = ISGetIndices(patch->cells, &cellsArray);CHKERRQ(ierr);
1965   ierr = PetscSectionGetChart(patch->cellCounts, &pStart, &pEnd);CHKERRQ(ierr);
1966 
1967   point += pStart;
1968   if (point >= pEnd) SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Operator point %D not in [%D, %D)\n", point, pStart, pEnd);CHKERRQ(ierr);
1969 
1970   ierr = PetscSectionGetDof(patch->cellCounts, point, &ncell);CHKERRQ(ierr);
1971   ierr = PetscSectionGetOffset(patch->cellCounts, point, &offset);CHKERRQ(ierr);
1972   if (ncell <= 0) {
1973     ierr = PetscLogEventEnd(PC_Patch_ComputeOp, pc, 0, 0, 0);CHKERRQ(ierr);
1974     PetscFunctionReturn(0);
1975   }
1976   ierr = VecSet(F, 0.0);CHKERRQ(ierr);
1977   PetscStackPush("PCPatch user callback");
1978   /* Cannot reuse the same IS because the geometry info is being cached in it */
1979   ierr = ISCreateGeneral(PETSC_COMM_SELF, ncell, cellsArray + offset, PETSC_USE_POINTER, &patch->cellIS);CHKERRQ(ierr);
1980   ierr = patch->usercomputef(pc, point, x, F, patch->cellIS, ncell*patch->totalDofsPerCell, dofsArray + offset*patch->totalDofsPerCell,
1981                                                                                             dofsArrayWithAll + offset*patch->totalDofsPerCell,
1982                                                                                             patch->usercomputefctx);CHKERRQ(ierr);
1983   PetscStackPop;
1984   ierr = ISDestroy(&patch->cellIS);CHKERRQ(ierr);
1985   ierr = ISRestoreIndices(patch->dofs, &dofsArray);CHKERRQ(ierr);
1986   ierr = ISRestoreIndices(patch->dofsWithAll, &dofsArrayWithAll);CHKERRQ(ierr);
1987   ierr = ISRestoreIndices(patch->cells, &cellsArray);CHKERRQ(ierr);
1988   if (patch->viewMatrix) {
1989     char name[PETSC_MAX_PATH_LEN];
1990 
1991     ierr = PetscSNPrintf(name, PETSC_MAX_PATH_LEN-1, "Patch vector for Point %D", point);CHKERRQ(ierr);
1992     ierr = PetscObjectSetName((PetscObject) F, name);CHKERRQ(ierr);
1993     ierr = ObjectView((PetscObject) F, patch->viewerMatrix, patch->formatMatrix);CHKERRQ(ierr);
1994   }
1995   ierr = PetscLogEventEnd(PC_Patch_ComputeOp, pc, 0, 0, 0);CHKERRQ(ierr);
1996   PetscFunctionReturn(0);
1997 }
1998 
1999 static PetscErrorCode PCPatchComputeOperator_DMPlex_Private(PC pc, PetscInt patchNum, Vec x, Mat J, IS cellIS, PetscInt n, const PetscInt *l2p, const PetscInt *l2pWithAll, void *ctx)
2000 {
2001   PC_PATCH       *patch = (PC_PATCH *) pc->data;
2002   DM              dm;
2003   PetscSection    s;
2004   const PetscInt *parray, *oarray;
2005   PetscInt        Nf = patch->nsubspaces, Np, poff, p, f;
2006   PetscErrorCode  ierr;
2007 
2008   PetscFunctionBegin;
2009   ierr = PCGetDM(pc, &dm);CHKERRQ(ierr);
2010   ierr = DMGetDefaultSection(dm, &s);CHKERRQ(ierr);
2011   /* Set offset into patch */
2012   ierr = PetscSectionGetDof(patch->pointCounts, patchNum, &Np);CHKERRQ(ierr);
2013   ierr = PetscSectionGetOffset(patch->pointCounts, patchNum, &poff);CHKERRQ(ierr);
2014   ierr = ISGetIndices(patch->points, &parray);CHKERRQ(ierr);
2015   ierr = ISGetIndices(patch->offs,   &oarray);CHKERRQ(ierr);
2016   for (f = 0; f < Nf; ++f) {
2017     for (p = 0; p < Np; ++p) {
2018       const PetscInt point = parray[poff+p];
2019       PetscInt       dof;
2020 
2021       ierr = PetscSectionGetFieldDof(patch->patchSection, point, f, &dof);CHKERRQ(ierr);
2022       ierr = PetscSectionSetFieldOffset(patch->patchSection, point, f, oarray[(poff+p)*Nf+f]);CHKERRQ(ierr);
2023       if (patch->nsubspaces == 1) {ierr = PetscSectionSetOffset(patch->patchSection, point, oarray[(poff+p)*Nf+f]);CHKERRQ(ierr);}
2024       else                        {ierr = PetscSectionSetOffset(patch->patchSection, point, -1);CHKERRQ(ierr);}
2025     }
2026   }
2027   ierr = ISRestoreIndices(patch->points, &parray);CHKERRQ(ierr);
2028   ierr = ISRestoreIndices(patch->offs,   &oarray);CHKERRQ(ierr);
2029   if (patch->viewSection) {ierr = ObjectView((PetscObject) patch->patchSection, patch->viewerSection, patch->formatSection);CHKERRQ(ierr);}
2030   /* TODO Shut off MatViewFromOptions() in MatAssemblyEnd() here */
2031   ierr = DMPlexComputeJacobian_Patch_Internal(pc->dm, patch->patchSection, patch->patchSection, cellIS, 0.0, 0.0, x, NULL, J, J, ctx);CHKERRQ(ierr);
2032   PetscFunctionReturn(0);
2033 }
2034 
2035 /* This function zeros mat on entry */
2036 PetscErrorCode PCPatchComputeOperator_Internal(PC pc, Vec x, Mat mat, PetscInt point, PetscBool withArtificial)
2037 {
2038   PC_PATCH       *patch = (PC_PATCH *) pc->data;
2039   const PetscInt *dofsArray;
2040   const PetscInt *dofsArrayWithAll = NULL;
2041   const PetscInt *cellsArray;
2042   PetscInt        ncell, offset, pStart, pEnd, numIntFacets, intFacetOffset;
2043   PetscBool       isNonlinear;
2044   PetscErrorCode  ierr;
2045 
2046   PetscFunctionBegin;
2047   ierr = PetscLogEventBegin(PC_Patch_ComputeOp, pc, 0, 0, 0);CHKERRQ(ierr);
2048   isNonlinear = patch->isNonlinear;
2049   if (!patch->usercomputeop) SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "Must call PCPatchSetComputeOperator() to set user callback\n");
2050   if(withArtificial) {
2051     ierr = ISGetIndices(patch->dofsWithArtificial, &dofsArray);CHKERRQ(ierr);
2052   } else {
2053     ierr = ISGetIndices(patch->dofs, &dofsArray);CHKERRQ(ierr);
2054   }
2055   if (isNonlinear) {
2056     ierr = ISGetIndices(patch->dofsWithAll, &dofsArrayWithAll);CHKERRQ(ierr);
2057   }
2058   ierr = ISGetIndices(patch->cells, &cellsArray);CHKERRQ(ierr);
2059   ierr = PetscSectionGetChart(patch->cellCounts, &pStart, &pEnd);CHKERRQ(ierr);
2060 
2061   point += pStart;
2062   if (point >= pEnd) SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Operator point %D not in [%D, %D)\n", point, pStart, pEnd);CHKERRQ(ierr);
2063 
2064   ierr = PetscSectionGetDof(patch->cellCounts, point, &ncell);CHKERRQ(ierr);
2065   ierr = PetscSectionGetOffset(patch->cellCounts, point, &offset);CHKERRQ(ierr);
2066   if (ncell <= 0) {
2067     ierr = PetscLogEventEnd(PC_Patch_ComputeOp, pc, 0, 0, 0);CHKERRQ(ierr);
2068     PetscFunctionReturn(0);
2069   }
2070   ierr = MatZeroEntries(mat);CHKERRQ(ierr);
2071   if (patch->precomputeElementTensors) {
2072     PetscInt           i;
2073     PetscInt           ndof = patch->totalDofsPerCell;
2074     const PetscScalar *elementTensors;
2075 
2076     ierr = VecGetArrayRead(patch->cellMats, &elementTensors);CHKERRQ(ierr);
2077     for (i = 0; i < ncell; i++) {
2078       const PetscInt     cell = cellsArray[i + offset];
2079       const PetscInt    *idx  = dofsArray + (offset + i)*ndof;
2080       const PetscScalar *v    = elementTensors + patch->precomputedTensorLocations[cell]*ndof*ndof;
2081       ierr = MatSetValues(mat, ndof, idx, ndof, idx, v, ADD_VALUES);CHKERRQ(ierr);
2082     }
2083     ierr = VecRestoreArrayRead(patch->cellMats, &elementTensors);CHKERRQ(ierr);
2084     ierr = MatAssemblyBegin(mat, MAT_FINAL_ASSEMBLY);CHKERRQ(ierr);
2085     ierr = MatAssemblyEnd(mat, MAT_FINAL_ASSEMBLY);CHKERRQ(ierr);
2086   } else {
2087     PetscStackPush("PCPatch user callback");
2088     /* Cannot reuse the same IS because the geometry info is being cached in it */
2089     ierr = ISCreateGeneral(PETSC_COMM_SELF, ncell, cellsArray + offset, PETSC_USE_POINTER, &patch->cellIS);CHKERRQ(ierr);
2090     ierr = patch->usercomputeop(pc, point, x, mat, patch->cellIS, ncell*patch->totalDofsPerCell, dofsArray + offset*patch->totalDofsPerCell, dofsArrayWithAll ? dofsArrayWithAll + offset*patch->totalDofsPerCell : NULL, patch->usercomputeopctx);CHKERRQ(ierr);
2091   }
2092   if (patch->usercomputeopintfacet) {
2093     ierr = PetscSectionGetDof(patch->intFacetCounts, point, &numIntFacets);CHKERRQ(ierr);
2094     ierr = PetscSectionGetOffset(patch->intFacetCounts, point, &intFacetOffset);CHKERRQ(ierr);
2095     if (numIntFacets > 0) {
2096       /* For each interior facet, grab the two cells (in local numbering, and concatenate dof numberings for those cells) */
2097       PetscInt       *facetDofs = NULL, *facetDofsWithAll = NULL;
2098       const PetscInt *intFacetsArray = NULL;
2099       PetscInt        idx = 0;
2100       PetscInt        i, c, d;
2101       PetscInt        fStart;
2102       DM              dm;
2103       IS              facetIS = NULL;
2104       const PetscInt *facetCells = NULL;
2105 
2106       ierr = ISGetIndices(patch->intFacetsToPatchCell, &facetCells);CHKERRQ(ierr);
2107       ierr = ISGetIndices(patch->intFacets, &intFacetsArray);CHKERRQ(ierr);
2108       ierr = PCGetDM(pc, &dm);CHKERRQ(ierr);
2109       ierr = DMPlexGetHeightStratum(dm, 1, &fStart, NULL);CHKERRQ(ierr);
2110       /* FIXME: Pull this malloc out. */
2111       ierr = PetscMalloc1(2 * patch->totalDofsPerCell * numIntFacets, &facetDofs);CHKERRQ(ierr);
2112       if (dofsArrayWithAll) {
2113         ierr = PetscMalloc1(2 * patch->totalDofsPerCell * numIntFacets, &facetDofsWithAll);CHKERRQ(ierr);
2114       }
2115       if (patch->precomputeElementTensors) {
2116         PetscInt           nFacetDof = 2*patch->totalDofsPerCell;
2117         const PetscScalar *elementTensors;
2118 
2119         ierr = VecGetArrayRead(patch->intFacetMats, &elementTensors);CHKERRQ(ierr);
2120 
2121         for (i = 0; i < numIntFacets; i++) {
2122           const PetscInt     facet = intFacetsArray[i + intFacetOffset];
2123           const PetscScalar *v     = elementTensors + patch->precomputedIntFacetTensorLocations[facet - fStart]*nFacetDof*nFacetDof;
2124           idx = 0;
2125           /*
2126            * 0--1
2127            * |\-|
2128            * |+\|
2129            * 2--3
2130            * [0, 2, 3, 0, 1, 3]
2131            */
2132           for (c = 0; c < 2; c++) {
2133             const PetscInt cell = facetCells[2*(intFacetOffset + i) + c];
2134             for (d = 0; d < patch->totalDofsPerCell; d++) {
2135               facetDofs[idx] = dofsArray[(offset + cell)*patch->totalDofsPerCell + d];
2136               idx++;
2137             }
2138           }
2139           ierr = MatSetValues(mat, nFacetDof, facetDofs, nFacetDof, facetDofs, v, ADD_VALUES);CHKERRQ(ierr);
2140         }
2141         ierr = VecRestoreArrayRead(patch->intFacetMats, &elementTensors);CHKERRQ(ierr);
2142       } else {
2143         /*
2144          * 0--1
2145          * |\-|
2146          * |+\|
2147          * 2--3
2148          * [0, 2, 3, 0, 1, 3]
2149          */
2150         for (i = 0; i < numIntFacets; i++) {
2151           for (c = 0; c < 2; c++) {
2152             const PetscInt cell = facetCells[2*(intFacetOffset + i) + c];
2153             for (d = 0; d < patch->totalDofsPerCell; d++) {
2154               facetDofs[idx] = dofsArray[(offset + cell)*patch->totalDofsPerCell + d];
2155               if (dofsArrayWithAll) {
2156                 facetDofsWithAll[idx] = dofsArrayWithAll[(offset + cell)*patch->totalDofsPerCell + d];
2157               }
2158               idx++;
2159             }
2160           }
2161         }
2162         ierr = ISCreateGeneral(PETSC_COMM_SELF, numIntFacets, intFacetsArray + intFacetOffset, PETSC_USE_POINTER, &facetIS);CHKERRQ(ierr);
2163         ierr = patch->usercomputeopintfacet(pc, point, x, mat, facetIS, 2*numIntFacets*patch->totalDofsPerCell, facetDofs, facetDofsWithAll, patch->usercomputeopintfacetctx);CHKERRQ(ierr);
2164         ierr = ISDestroy(&facetIS);CHKERRQ(ierr);
2165       }
2166       ierr = ISRestoreIndices(patch->intFacetsToPatchCell, &facetCells);CHKERRQ(ierr);
2167       ierr = ISRestoreIndices(patch->intFacets, &intFacetsArray);CHKERRQ(ierr);
2168       ierr = PetscFree(facetDofs);CHKERRQ(ierr);
2169       ierr = PetscFree(facetDofsWithAll);CHKERRQ(ierr);
2170     }
2171   }
2172 
2173   ierr = MatAssemblyBegin(mat, MAT_FINAL_ASSEMBLY);CHKERRQ(ierr);
2174   ierr = MatAssemblyEnd(mat, MAT_FINAL_ASSEMBLY);CHKERRQ(ierr);
2175 
2176   PetscStackPop;
2177   ierr = ISDestroy(&patch->cellIS);CHKERRQ(ierr);
2178   if(withArtificial) {
2179     ierr = ISRestoreIndices(patch->dofsWithArtificial, &dofsArray);CHKERRQ(ierr);
2180   } else {
2181     ierr = ISRestoreIndices(patch->dofs, &dofsArray);CHKERRQ(ierr);
2182   }
2183   if (isNonlinear) {
2184     ierr = ISRestoreIndices(patch->dofsWithAll, &dofsArrayWithAll);CHKERRQ(ierr);
2185   }
2186   ierr = ISRestoreIndices(patch->cells, &cellsArray);CHKERRQ(ierr);
2187   if (patch->viewMatrix) {
2188     char name[PETSC_MAX_PATH_LEN];
2189 
2190     ierr = PetscSNPrintf(name, PETSC_MAX_PATH_LEN-1, "Patch matrix for Point %D", point);CHKERRQ(ierr);
2191     ierr = PetscObjectSetName((PetscObject) mat, name);CHKERRQ(ierr);
2192     ierr = ObjectView((PetscObject) mat, patch->viewerMatrix, patch->formatMatrix);CHKERRQ(ierr);
2193   }
2194   ierr = PetscLogEventEnd(PC_Patch_ComputeOp, pc, 0, 0, 0);CHKERRQ(ierr);
2195   PetscFunctionReturn(0);
2196 }
2197 
2198 static PetscErrorCode MatSetValues_PCPatch_Private(Mat mat, PetscInt m, const PetscInt idxm[],
2199                                                    PetscInt n, const PetscInt idxn[], const PetscScalar *v, InsertMode addv)
2200 {
2201   Vec            data;
2202   PetscScalar   *array;
2203   PetscInt       bs, nz, i, j, cell;
2204   PetscErrorCode ierr;
2205 
2206   ierr = MatShellGetContext(mat, &data);CHKERRQ(ierr);
2207   ierr = VecGetBlockSize(data, &bs);CHKERRQ(ierr);
2208   ierr = VecGetSize(data, &nz);CHKERRQ(ierr);
2209   ierr = VecGetArray(data, &array);CHKERRQ(ierr);
2210   if (m != n) SETERRQ(PetscObjectComm((PetscObject)mat), PETSC_ERR_ARG_WRONG, "Only for square insertion");
2211   cell = (PetscInt)(idxm[0]/bs); /* use the fact that this is called once per cell */
2212   for (i = 0; i < m; i++) {
2213     if (idxm[i] != idxn[i]) SETERRQ(PetscObjectComm((PetscObject)mat), PETSC_ERR_ARG_WRONG, "Row and column indices must match!");
2214     for (j = 0; j < n; j++) {
2215       const PetscScalar v_ = v[i*bs + j];
2216       /* Indexing is special to the data structure we have! */
2217       if (addv == INSERT_VALUES) {
2218         array[cell*bs*bs + i*bs + j] = v_;
2219       } else {
2220         array[cell*bs*bs + i*bs + j] += v_;
2221       }
2222     }
2223   }
2224   ierr = VecRestoreArray(data, &array);CHKERRQ(ierr);
2225   PetscFunctionReturn(0);
2226 }
2227 
2228 static PetscErrorCode PCPatchPrecomputePatchTensors_Private(PC pc)
2229 {
2230   PC_PATCH       *patch = (PC_PATCH *)pc->data;
2231   const PetscInt *cellsArray;
2232   PetscInt        ncell, offset;
2233   const PetscInt *dofMapArray;
2234   PetscInt        i, j;
2235   IS              dofMap;
2236   IS              cellIS;
2237   const PetscInt  ndof  = patch->totalDofsPerCell;
2238   PetscErrorCode  ierr;
2239   Mat             vecMat;
2240   PetscInt        cStart, cEnd;
2241   DM              dm, plex;
2242 
2243 
2244   ierr = ISGetSize(patch->cells, &ncell);CHKERRQ(ierr);
2245   if (!ncell) { /* No cells to assemble over -> skip */
2246     PetscFunctionReturn(0);
2247   }
2248 
2249   ierr = PetscLogEventBegin(PC_Patch_ComputeOp, pc, 0, 0, 0);CHKERRQ(ierr);
2250 
2251   if (!patch->allCells) {
2252     PetscHSetI      cells;
2253     PetscHashIter   hi;
2254     PetscInt pStart, pEnd;
2255     PetscInt *allCells = NULL;
2256     ierr = PetscHSetICreate(&cells);CHKERRQ(ierr);
2257     ierr = ISGetIndices(patch->cells, &cellsArray);CHKERRQ(ierr);
2258     ierr = PetscSectionGetChart(patch->cellCounts, &pStart, &pEnd);CHKERRQ(ierr);
2259     for (i = pStart; i < pEnd; i++) {
2260       ierr = PetscSectionGetDof(patch->cellCounts, i, &ncell);CHKERRQ(ierr);
2261       ierr = PetscSectionGetOffset(patch->cellCounts, i, &offset);CHKERRQ(ierr);
2262       if (ncell <= 0) continue;
2263       for (j = 0; j < ncell; j++) {
2264         PetscHSetIAdd(cells, cellsArray[offset + j]);CHKERRQ(ierr);
2265       }
2266     }
2267     ierr = ISRestoreIndices(patch->cells, &cellsArray);CHKERRQ(ierr);
2268     ierr = PetscHSetIGetSize(cells, &ncell);CHKERRQ(ierr);
2269     ierr = PetscMalloc1(ncell, &allCells);CHKERRQ(ierr);
2270     ierr = PCGetDM(pc, &dm);CHKERRQ(ierr);
2271     ierr = DMConvert(dm, DMPLEX, &plex);CHKERRQ(ierr);
2272     ierr = DMPlexGetHeightStratum(dm, 0, &cStart, &cEnd);CHKERRQ(ierr);
2273     ierr = PetscMalloc1(cEnd-cStart, &patch->precomputedTensorLocations);CHKERRQ(ierr);
2274     i = 0;
2275     PetscHashIterBegin(cells, hi);
2276     while (!PetscHashIterAtEnd(cells, hi)) {
2277       PetscHashIterGetKey(cells, hi, allCells[i]);
2278       patch->precomputedTensorLocations[allCells[i]] = i;
2279       PetscHashIterNext(cells, hi);
2280       i++;
2281     }
2282     ierr = PetscHSetIDestroy(&cells);CHKERRQ(ierr);
2283     ierr = ISCreateGeneral(PETSC_COMM_SELF, ncell, allCells, PETSC_OWN_POINTER, &patch->allCells);CHKERRQ(ierr);
2284   }
2285   ierr = ISGetSize(patch->allCells, &ncell);CHKERRQ(ierr);
2286   if (!patch->cellMats) {
2287     ierr = VecCreateSeq(PETSC_COMM_SELF, ncell*ndof*ndof, &patch->cellMats);CHKERRQ(ierr);
2288     ierr = VecSetBlockSize(patch->cellMats, ndof);CHKERRQ(ierr);
2289   }
2290   ierr = VecSet(patch->cellMats, 0);CHKERRQ(ierr);
2291 
2292   ierr = MatCreateShell(PETSC_COMM_SELF, ncell*ndof, ncell*ndof, ncell*ndof, ncell*ndof,
2293                         (void*)patch->cellMats, &vecMat);CHKERRQ(ierr);
2294   ierr = MatShellSetOperation(vecMat, MATOP_SET_VALUES, (void(*)(void))&MatSetValues_PCPatch_Private);CHKERRQ(ierr);
2295   ierr = ISGetSize(patch->allCells, &ncell);CHKERRQ(ierr);
2296   ierr = ISCreateStride(PETSC_COMM_SELF, ndof*ncell, 0, 1, &dofMap);CHKERRQ(ierr);
2297   ierr = ISGetIndices(dofMap, &dofMapArray);CHKERRQ(ierr);
2298   ierr = ISGetIndices(patch->allCells, &cellsArray);CHKERRQ(ierr);
2299   ierr = ISCreateGeneral(PETSC_COMM_SELF, ncell, cellsArray, PETSC_USE_POINTER, &cellIS);CHKERRQ(ierr);
2300   PetscStackPush("PCPatch user callback");
2301   /* TODO: Fix for DMPlex compute op, this bypasses a lot of the machinery and just assembles every element tensor. */
2302   ierr = patch->usercomputeop(pc, -1, NULL, vecMat, cellIS, ndof*ncell, dofMapArray, NULL, patch->usercomputeopctx);CHKERRQ(ierr);
2303   PetscStackPop;
2304   ierr = ISDestroy(&cellIS);CHKERRQ(ierr);
2305   ierr = MatDestroy(&vecMat);CHKERRQ(ierr);
2306   ierr = ISRestoreIndices(patch->allCells, &cellsArray);CHKERRQ(ierr);
2307   ierr = ISRestoreIndices(dofMap, &dofMapArray);CHKERRQ(ierr);
2308   ierr = ISDestroy(&dofMap);CHKERRQ(ierr);
2309 
2310   if (patch->usercomputeopintfacet) {
2311     PetscInt nIntFacets;
2312     IS       intFacetsIS;
2313     const PetscInt *intFacetsArray = NULL;
2314     if (!patch->allIntFacets) {
2315       PetscHSetI      facets;
2316       PetscHashIter   hi;
2317       PetscInt pStart, pEnd, fStart, fEnd;
2318       PetscInt *allIntFacets = NULL;
2319       ierr = PetscHSetICreate(&facets);CHKERRQ(ierr);
2320       ierr = ISGetIndices(patch->intFacets, &intFacetsArray);CHKERRQ(ierr);
2321       ierr = PetscSectionGetChart(patch->intFacetCounts, &pStart, &pEnd);CHKERRQ(ierr);
2322       ierr = DMPlexGetHeightStratum(dm, 1, &fStart, &fEnd);CHKERRQ(ierr);
2323       for (i = pStart; i < pEnd; i++) {
2324         ierr = PetscSectionGetDof(patch->intFacetCounts, i, &nIntFacets);CHKERRQ(ierr);
2325         ierr = PetscSectionGetOffset(patch->intFacetCounts, i, &offset);CHKERRQ(ierr);
2326         if (nIntFacets <= 0) continue;
2327         for (j = 0; j < nIntFacets; j++) {
2328           PetscHSetIAdd(facets, intFacetsArray[offset + j]);CHKERRQ(ierr);
2329         }
2330       }
2331       ierr = ISRestoreIndices(patch->intFacets, &intFacetsArray);CHKERRQ(ierr);
2332       ierr = PetscHSetIGetSize(facets, &nIntFacets);CHKERRQ(ierr);
2333       ierr = PetscMalloc1(nIntFacets, &allIntFacets);CHKERRQ(ierr);
2334       ierr = PCGetDM(pc, &dm);CHKERRQ(ierr);
2335       ierr = DMConvert(dm, DMPLEX, &plex);CHKERRQ(ierr);
2336       ierr = PetscMalloc1(fEnd-fStart, &patch->precomputedIntFacetTensorLocations);CHKERRQ(ierr);
2337       i = 0;
2338       PetscHashIterBegin(facets, hi);
2339       while (!PetscHashIterAtEnd(facets, hi)) {
2340         PetscHashIterGetKey(facets, hi, allIntFacets[i]);
2341         patch->precomputedIntFacetTensorLocations[allIntFacets[i] - fStart] = i;
2342         PetscHashIterNext(facets, hi);
2343         i++;
2344       }
2345       ierr = PetscHSetIDestroy(&facets);CHKERRQ(ierr);
2346       ierr = ISCreateGeneral(PETSC_COMM_SELF, nIntFacets, allIntFacets, PETSC_OWN_POINTER, &patch->allIntFacets);CHKERRQ(ierr);
2347     }
2348     ierr = ISGetSize(patch->allIntFacets, &nIntFacets);CHKERRQ(ierr);
2349     if (!patch->intFacetMats) {
2350       ierr = VecCreateSeq(PETSC_COMM_SELF, nIntFacets*ndof*ndof*4, &patch->intFacetMats);CHKERRQ(ierr);
2351       ierr = VecSetBlockSize(patch->intFacetMats, ndof*2);CHKERRQ(ierr);
2352     }
2353     ierr = VecSet(patch->intFacetMats, 0);CHKERRQ(ierr);
2354 
2355     ierr = MatCreateShell(PETSC_COMM_SELF, nIntFacets*ndof*2, nIntFacets*ndof*2, nIntFacets*ndof*2, nIntFacets*ndof*2,
2356                           (void*)patch->intFacetMats, &vecMat);CHKERRQ(ierr);
2357     ierr = MatShellSetOperation(vecMat, MATOP_SET_VALUES, (void(*)(void))&MatSetValues_PCPatch_Private);CHKERRQ(ierr);
2358     ierr = ISCreateStride(PETSC_COMM_SELF, 2*ndof*nIntFacets, 0, 1, &dofMap);CHKERRQ(ierr);
2359     ierr = ISGetIndices(dofMap, &dofMapArray);CHKERRQ(ierr);
2360     ierr = ISGetIndices(patch->allIntFacets, &intFacetsArray);CHKERRQ(ierr);
2361     ierr = ISCreateGeneral(PETSC_COMM_SELF, nIntFacets, intFacetsArray, PETSC_USE_POINTER, &intFacetsIS);CHKERRQ(ierr);
2362     PetscStackPush("PCPatch user callback (interior facets)");
2363     /* TODO: Fix for DMPlex compute op, this bypasses a lot of the machinery and just assembles every element tensor. */
2364     ierr = patch->usercomputeopintfacet(pc, -1, NULL, vecMat, intFacetsIS, 2*ndof*nIntFacets, dofMapArray, NULL, patch->usercomputeopintfacetctx);CHKERRQ(ierr);
2365     PetscStackPop;
2366     ierr = ISDestroy(&intFacetsIS);CHKERRQ(ierr);
2367     ierr = MatDestroy(&vecMat);CHKERRQ(ierr);
2368     ierr = ISRestoreIndices(patch->allIntFacets, &intFacetsArray);CHKERRQ(ierr);
2369     ierr = ISRestoreIndices(dofMap, &dofMapArray);CHKERRQ(ierr);
2370     ierr = ISDestroy(&dofMap);CHKERRQ(ierr);
2371   }
2372   ierr = PetscLogEventEnd(PC_Patch_ComputeOp, pc, 0, 0, 0);CHKERRQ(ierr);
2373 
2374   PetscFunctionReturn(0);
2375 }
2376 
2377 PetscErrorCode PCPatch_ScatterLocal_Private(PC pc, PetscInt p, Vec x, Vec y, InsertMode mode, ScatterMode scat, PatchScatterType scattertype)
2378 {
2379   PC_PATCH          *patch     = (PC_PATCH *) pc->data;
2380   const PetscScalar *xArray    = NULL;
2381   PetscScalar       *yArray    = NULL;
2382   const PetscInt    *gtolArray = NULL;
2383   PetscInt           dof, offset, lidx;
2384   PetscErrorCode     ierr;
2385 
2386   PetscFunctionBeginHot;
2387   ierr = PetscLogEventBegin(PC_Patch_Scatter, pc, 0, 0, 0);CHKERRQ(ierr);
2388   ierr = VecGetArrayRead(x, &xArray);CHKERRQ(ierr);
2389   ierr = VecGetArray(y, &yArray);CHKERRQ(ierr);
2390   if (scattertype == SCATTER_WITHARTIFICIAL) {
2391     ierr = PetscSectionGetDof(patch->gtolCountsWithArtificial, p, &dof);CHKERRQ(ierr);
2392     ierr = PetscSectionGetOffset(patch->gtolCountsWithArtificial, p, &offset);CHKERRQ(ierr);
2393     ierr = ISGetIndices(patch->gtolWithArtificial, &gtolArray);CHKERRQ(ierr);
2394   } else if (scattertype == SCATTER_WITHALL) {
2395     ierr = PetscSectionGetDof(patch->gtolCountsWithAll, p, &dof);CHKERRQ(ierr);
2396     ierr = PetscSectionGetOffset(patch->gtolCountsWithAll, p, &offset);CHKERRQ(ierr);
2397     ierr = ISGetIndices(patch->gtolWithAll, &gtolArray);CHKERRQ(ierr);
2398   } else {
2399     ierr = PetscSectionGetDof(patch->gtolCounts, p, &dof);CHKERRQ(ierr);
2400     ierr = PetscSectionGetOffset(patch->gtolCounts, p, &offset);CHKERRQ(ierr);
2401     ierr = ISGetIndices(patch->gtol, &gtolArray);CHKERRQ(ierr);
2402   }
2403   if (mode == INSERT_VALUES && scat != SCATTER_FORWARD) SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_INCOMP, "Can't insert if not scattering forward\n");
2404   if (mode == ADD_VALUES    && scat != SCATTER_REVERSE) SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_INCOMP, "Can't add if not scattering reverse\n");
2405   for (lidx = 0; lidx < dof; ++lidx) {
2406     const PetscInt gidx = gtolArray[offset+lidx];
2407 
2408     if (mode == INSERT_VALUES) yArray[lidx]  = xArray[gidx]; /* Forward */
2409     else                       yArray[gidx] += xArray[lidx]; /* Reverse */
2410   }
2411   if (scattertype == SCATTER_WITHARTIFICIAL) {
2412     ierr = ISRestoreIndices(patch->gtolWithArtificial, &gtolArray);CHKERRQ(ierr);
2413   } else if (scattertype == SCATTER_WITHALL) {
2414     ierr = ISRestoreIndices(patch->gtolWithAll, &gtolArray);CHKERRQ(ierr);
2415   } else {
2416     ierr = ISRestoreIndices(patch->gtol, &gtolArray);CHKERRQ(ierr);
2417   }
2418   ierr = VecRestoreArrayRead(x, &xArray);CHKERRQ(ierr);
2419   ierr = VecRestoreArray(y, &yArray);CHKERRQ(ierr);
2420   ierr = PetscLogEventEnd(PC_Patch_Scatter, pc, 0, 0, 0);CHKERRQ(ierr);
2421   PetscFunctionReturn(0);
2422 }
2423 
2424 static PetscErrorCode PCSetUp_PATCH_Linear(PC pc)
2425 {
2426   PC_PATCH      *patch = (PC_PATCH *) pc->data;
2427   const char    *prefix;
2428   PetscInt       i;
2429   PetscErrorCode ierr;
2430 
2431   PetscFunctionBegin;
2432   if (!pc->setupcalled) {
2433     ierr = PetscMalloc1(patch->npatch, &patch->solver);CHKERRQ(ierr);
2434     ierr = PCGetOptionsPrefix(pc, &prefix);CHKERRQ(ierr);
2435     for (i = 0; i < patch->npatch; ++i) {
2436       KSP ksp;
2437       PC  subpc;
2438 
2439       ierr = KSPCreate(PETSC_COMM_SELF, &ksp);CHKERRQ(ierr);
2440       ierr = KSPSetErrorIfNotConverged(ksp, pc->erroriffailure);CHKERRQ(ierr);
2441       ierr = KSPSetOptionsPrefix(ksp, prefix);CHKERRQ(ierr);
2442       ierr = KSPAppendOptionsPrefix(ksp, "sub_");CHKERRQ(ierr);
2443       ierr = PetscObjectIncrementTabLevel((PetscObject) ksp, (PetscObject) pc, 1);CHKERRQ(ierr);
2444       ierr = KSPGetPC(ksp, &subpc);CHKERRQ(ierr);
2445       ierr = PetscObjectIncrementTabLevel((PetscObject) subpc, (PetscObject) pc, 1);CHKERRQ(ierr);
2446       ierr = PetscLogObjectParent((PetscObject) pc, (PetscObject) ksp);CHKERRQ(ierr);
2447       patch->solver[i] = (PetscObject) ksp;
2448     }
2449   }
2450   if (patch->save_operators) {
2451     if (patch->precomputeElementTensors) {
2452       ierr = PCPatchPrecomputePatchTensors_Private(pc);CHKERRQ(ierr);
2453     }
2454     for (i = 0; i < patch->npatch; ++i) {
2455       ierr = PCPatchComputeOperator_Internal(pc, NULL, patch->mat[i], i, PETSC_FALSE);CHKERRQ(ierr);
2456       ierr = KSPSetOperators((KSP) patch->solver[i], patch->mat[i], patch->mat[i]);CHKERRQ(ierr);
2457     }
2458   }
2459   if(patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE) {
2460     for (i = 0; i < patch->npatch; ++i) {
2461       /* Instead of padding patch->patchUpdate with zeros to get */
2462       /* patch->patchUpdateWithArtificial and then multiplying with the matrix, */
2463       /* just get rid of the columns that correspond to the dofs with */
2464       /* artificial bcs. That's of course fairly inefficient, hopefully we */
2465       /* can just assemble the rectangular matrix in the first place. */
2466       Mat matSquare;
2467       IS rowis;
2468       PetscInt dof;
2469 
2470       ierr = MatGetSize(patch->mat[i], &dof, NULL);CHKERRQ(ierr);
2471       if (dof == 0) {
2472         patch->matWithArtificial[i] = NULL;
2473         continue;
2474       }
2475 
2476       ierr = PCPatchCreateMatrix_Private(pc, i, &matSquare, PETSC_TRUE);CHKERRQ(ierr);
2477       ierr = PCPatchComputeOperator_Internal(pc, NULL, matSquare, i, PETSC_TRUE);CHKERRQ(ierr);
2478 
2479       ierr = MatGetSize(matSquare, &dof, NULL);CHKERRQ(ierr);
2480       ierr = ISCreateStride(PETSC_COMM_SELF, dof, 0, 1, &rowis); CHKERRQ(ierr);
2481       if(pc->setupcalled) {
2482         ierr = MatCreateSubMatrix(matSquare, rowis, patch->dofMappingWithoutToWithArtificial[i], MAT_REUSE_MATRIX, &patch->matWithArtificial[i]); CHKERRQ(ierr);
2483       } else {
2484         ierr = MatCreateSubMatrix(matSquare, rowis, patch->dofMappingWithoutToWithArtificial[i], MAT_INITIAL_MATRIX, &patch->matWithArtificial[i]); CHKERRQ(ierr);
2485       }
2486       ierr = ISDestroy(&rowis); CHKERRQ(ierr);
2487       ierr = MatDestroy(&matSquare);CHKERRQ(ierr);
2488     }
2489   }
2490   PetscFunctionReturn(0);
2491 }
2492 
2493 static PetscErrorCode PCSetUp_PATCH(PC pc)
2494 {
2495   PC_PATCH      *patch = (PC_PATCH *) pc->data;
2496   PetscInt       i;
2497   PetscBool       isNonlinear;
2498   PetscErrorCode ierr;
2499 
2500   PetscFunctionBegin;
2501   if (!pc->setupcalled) {
2502     PetscInt pStart, pEnd, p;
2503     PetscInt localSize;
2504 
2505     ierr = PetscLogEventBegin(PC_Patch_CreatePatches, pc, 0, 0, 0);CHKERRQ(ierr);
2506 
2507     isNonlinear = patch->isNonlinear;
2508     if (!patch->nsubspaces) {
2509       DM           dm;
2510       PetscSection s;
2511       PetscInt     cStart, cEnd, c, Nf, f, numGlobalBcs = 0, *globalBcs, *Nb, totNb = 0, **cellDofs;
2512 
2513       ierr = PCGetDM(pc, &dm);CHKERRQ(ierr);
2514       if (!dm) SETERRQ(PetscObjectComm((PetscObject) pc), PETSC_ERR_ARG_WRONG, "Must set DM for PCPATCH or call PCPatchSetDiscretisationInfo()");
2515       ierr = DMGetDefaultSection(dm, &s);CHKERRQ(ierr);
2516       ierr = PetscSectionGetNumFields(s, &Nf);CHKERRQ(ierr);
2517       ierr = PetscSectionGetChart(s, &pStart, &pEnd);CHKERRQ(ierr);
2518       for (p = pStart; p < pEnd; ++p) {
2519         PetscInt cdof;
2520         ierr = PetscSectionGetConstraintDof(s, p, &cdof);CHKERRQ(ierr);
2521         numGlobalBcs += cdof;
2522       }
2523       ierr = DMPlexGetHeightStratum(dm, 0, &cStart, &cEnd);CHKERRQ(ierr);
2524       ierr = PetscMalloc3(Nf, &Nb, Nf, &cellDofs, numGlobalBcs, &globalBcs);CHKERRQ(ierr);
2525       for (f = 0; f < Nf; ++f) {
2526         PetscFE        fe;
2527         PetscDualSpace sp;
2528         PetscInt       cdoff = 0;
2529 
2530         ierr = DMGetField(dm, f, NULL, (PetscObject *) &fe);CHKERRQ(ierr);
2531         /* ierr = PetscFEGetNumComponents(fe, &Nc[f]);CHKERRQ(ierr); */
2532         ierr = PetscFEGetDualSpace(fe, &sp);CHKERRQ(ierr);
2533         ierr = PetscDualSpaceGetDimension(sp, &Nb[f]);CHKERRQ(ierr);
2534         totNb += Nb[f];
2535 
2536         ierr = PetscMalloc1((cEnd-cStart)*Nb[f], &cellDofs[f]);CHKERRQ(ierr);
2537         for (c = cStart; c < cEnd; ++c) {
2538           PetscInt *closure = NULL;
2539           PetscInt  clSize  = 0, cl;
2540 
2541           ierr = DMPlexGetTransitiveClosure(dm, c, PETSC_TRUE, &clSize, &closure);CHKERRQ(ierr);
2542           for (cl = 0; cl < clSize*2; cl += 2) {
2543             const PetscInt p = closure[cl];
2544             PetscInt       fdof, d, foff;
2545 
2546             ierr = PetscSectionGetFieldDof(s, p, f, &fdof);CHKERRQ(ierr);
2547             ierr = PetscSectionGetFieldOffset(s, p, f, &foff);CHKERRQ(ierr);
2548             for (d = 0; d < fdof; ++d, ++cdoff) cellDofs[f][cdoff] = foff + d;
2549           }
2550           ierr = DMPlexRestoreTransitiveClosure(dm, c, PETSC_TRUE, &clSize, &closure);CHKERRQ(ierr);
2551         }
2552         if (cdoff != (cEnd-cStart)*Nb[f]) SETERRQ4(PetscObjectComm((PetscObject) pc), PETSC_ERR_ARG_SIZ, "Total number of cellDofs %D for field %D should be Nc (%D) * cellDof (%D)", cdoff, f, cEnd-cStart, Nb[f]);
2553       }
2554       numGlobalBcs = 0;
2555       for (p = pStart; p < pEnd; ++p) {
2556         const PetscInt *ind;
2557         PetscInt        off, cdof, d;
2558 
2559         ierr = PetscSectionGetOffset(s, p, &off);CHKERRQ(ierr);
2560         ierr = PetscSectionGetConstraintDof(s, p, &cdof);CHKERRQ(ierr);
2561         ierr = PetscSectionGetConstraintIndices(s, p, &ind);CHKERRQ(ierr);
2562         for (d = 0; d < cdof; ++d) globalBcs[numGlobalBcs++] = off + ind[d];
2563       }
2564 
2565       ierr = PCPatchSetDiscretisationInfoCombined(pc, dm, Nb, (const PetscInt **) cellDofs, numGlobalBcs, globalBcs, numGlobalBcs, globalBcs);CHKERRQ(ierr);
2566       for (f = 0; f < Nf; ++f) {
2567         ierr = PetscFree(cellDofs[f]);CHKERRQ(ierr);
2568       }
2569       ierr = PetscFree3(Nb, cellDofs, globalBcs);CHKERRQ(ierr);
2570       ierr = PCPatchSetComputeFunction(pc, PCPatchComputeFunction_DMPlex_Private, NULL);CHKERRQ(ierr);
2571       ierr = PCPatchSetComputeOperator(pc, PCPatchComputeOperator_DMPlex_Private, NULL);CHKERRQ(ierr);
2572     }
2573 
2574     localSize = patch->subspaceOffsets[patch->nsubspaces];
2575     ierr = VecCreateSeq(PETSC_COMM_SELF, localSize, &patch->localRHS);CHKERRQ(ierr);
2576     ierr = VecSetUp(patch->localRHS);CHKERRQ(ierr);
2577     ierr = VecDuplicate(patch->localRHS, &patch->localUpdate);CHKERRQ(ierr);
2578     ierr = PCPatchCreateCellPatches(pc);CHKERRQ(ierr);
2579     ierr = PCPatchCreateCellPatchDiscretisationInfo(pc);CHKERRQ(ierr);
2580 
2581     /* OK, now build the work vectors */
2582     ierr = PetscSectionGetChart(patch->gtolCounts, &pStart, &pEnd);CHKERRQ(ierr);
2583     ierr = PetscMalloc1(patch->npatch, &patch->patchRHS);CHKERRQ(ierr);
2584     ierr = PetscMalloc1(patch->npatch, &patch->patchUpdate);CHKERRQ(ierr);
2585 
2586     if (patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE) {
2587       ierr = PetscMalloc1(patch->npatch, &patch->patchRHSWithArtificial);CHKERRQ(ierr);
2588       ierr = PetscMalloc1(patch->npatch, &patch->dofMappingWithoutToWithArtificial);CHKERRQ(ierr);
2589     }
2590     if (isNonlinear) {
2591       ierr = PetscMalloc1(patch->npatch, &patch->dofMappingWithoutToWithAll);CHKERRQ(ierr);
2592     }
2593     for (p = pStart; p < pEnd; ++p) {
2594       PetscInt dof;
2595 
2596       ierr = PetscSectionGetDof(patch->gtolCounts, p, &dof);CHKERRQ(ierr);
2597       ierr = VecCreateSeq(PETSC_COMM_SELF, dof, &patch->patchRHS[p-pStart]);CHKERRQ(ierr);
2598       ierr = VecSetUp(patch->patchRHS[p-pStart]);CHKERRQ(ierr);
2599       ierr = VecCreateSeq(PETSC_COMM_SELF, dof, &patch->patchUpdate[p-pStart]);CHKERRQ(ierr);
2600       ierr = VecSetUp(patch->patchUpdate[p-pStart]);CHKERRQ(ierr);
2601       if (patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE) {
2602         const PetscInt    *gtolArray, *gtolArrayWithArtificial = NULL;
2603         PetscInt           numPatchDofs, offset;
2604         PetscInt           numPatchDofsWithArtificial, offsetWithArtificial;
2605         PetscInt           dofWithoutArtificialCounter = 0;
2606         PetscInt          *patchWithoutArtificialToWithArtificialArray;
2607 
2608         ierr = PetscSectionGetDof(patch->gtolCountsWithArtificial, p, &dof);CHKERRQ(ierr);
2609         ierr = VecCreateSeq(PETSC_COMM_SELF, dof, &patch->patchRHSWithArtificial[p-pStart]);CHKERRQ(ierr);
2610         ierr = VecSetUp(patch->patchRHSWithArtificial[p-pStart]);CHKERRQ(ierr);
2611 
2612         /* Now build the mapping that for a dof in a patch WITHOUT dofs that have artificial bcs gives the */
2613         /* the index in the patch with all dofs */
2614         ierr = ISGetIndices(patch->gtol, &gtolArray);CHKERRQ(ierr);
2615 
2616         ierr = PetscSectionGetDof(patch->gtolCounts, p, &numPatchDofs);CHKERRQ(ierr);
2617         if (numPatchDofs == 0) {
2618           patch->dofMappingWithoutToWithArtificial[p-pStart] = NULL;
2619           continue;
2620         }
2621 
2622         ierr = PetscSectionGetOffset(patch->gtolCounts, p, &offset);CHKERRQ(ierr);
2623         ierr = ISGetIndices(patch->gtolWithArtificial, &gtolArrayWithArtificial);CHKERRQ(ierr);
2624         ierr = PetscSectionGetDof(patch->gtolCountsWithArtificial, p, &numPatchDofsWithArtificial);CHKERRQ(ierr);
2625         ierr = PetscSectionGetOffset(patch->gtolCountsWithArtificial, p, &offsetWithArtificial);CHKERRQ(ierr);
2626 
2627         ierr = PetscMalloc1(numPatchDofs, &patchWithoutArtificialToWithArtificialArray);CHKERRQ(ierr);
2628         for (i=0; i<numPatchDofsWithArtificial; i++) {
2629           if (gtolArrayWithArtificial[i+offsetWithArtificial] == gtolArray[offset+dofWithoutArtificialCounter]) {
2630             patchWithoutArtificialToWithArtificialArray[dofWithoutArtificialCounter] = i;
2631             dofWithoutArtificialCounter++;
2632             if (dofWithoutArtificialCounter == numPatchDofs)
2633               break;
2634           }
2635         }
2636         ierr = ISCreateGeneral(PETSC_COMM_SELF, numPatchDofs, patchWithoutArtificialToWithArtificialArray, PETSC_OWN_POINTER, &patch->dofMappingWithoutToWithArtificial[p-pStart]);CHKERRQ(ierr);
2637         ierr = ISRestoreIndices(patch->gtol, &gtolArray);CHKERRQ(ierr);
2638         ierr = ISRestoreIndices(patch->gtolWithArtificial, &gtolArrayWithArtificial);CHKERRQ(ierr);
2639       }
2640       if (isNonlinear) {
2641         const PetscInt    *gtolArray, *gtolArrayWithAll = NULL;
2642         PetscInt           numPatchDofs, offset;
2643         PetscInt           numPatchDofsWithAll, offsetWithAll;
2644         PetscInt           dofWithoutAllCounter = 0;
2645         PetscInt          *patchWithoutAllToWithAllArray;
2646 
2647         /* Now build the mapping that for a dof in a patch WITHOUT dofs that have artificial bcs gives the */
2648         /* the index in the patch with all dofs */
2649         ierr = ISGetIndices(patch->gtol, &gtolArray);CHKERRQ(ierr);
2650 
2651         ierr = PetscSectionGetDof(patch->gtolCounts, p, &numPatchDofs);CHKERRQ(ierr);
2652         if (numPatchDofs == 0) {
2653           patch->dofMappingWithoutToWithAll[p-pStart] = NULL;
2654           continue;
2655         }
2656 
2657         ierr = PetscSectionGetOffset(patch->gtolCounts, p, &offset);CHKERRQ(ierr);
2658         ierr = ISGetIndices(patch->gtolWithAll, &gtolArrayWithAll);CHKERRQ(ierr);
2659         ierr = PetscSectionGetDof(patch->gtolCountsWithAll, p, &numPatchDofsWithAll);CHKERRQ(ierr);
2660         ierr = PetscSectionGetOffset(patch->gtolCountsWithAll, p, &offsetWithAll);CHKERRQ(ierr);
2661 
2662         ierr = PetscMalloc1(numPatchDofs, &patchWithoutAllToWithAllArray);CHKERRQ(ierr);
2663 
2664         for (i=0; i<numPatchDofsWithAll; i++) {
2665           if (gtolArrayWithAll[i+offsetWithAll] == gtolArray[offset+dofWithoutAllCounter]) {
2666             patchWithoutAllToWithAllArray[dofWithoutAllCounter] = i;
2667             dofWithoutAllCounter++;
2668             if (dofWithoutAllCounter == numPatchDofs)
2669               break;
2670           }
2671         }
2672         ierr = ISCreateGeneral(PETSC_COMM_SELF, numPatchDofs, patchWithoutAllToWithAllArray, PETSC_OWN_POINTER, &patch->dofMappingWithoutToWithAll[p-pStart]);CHKERRQ(ierr);
2673         ierr = ISRestoreIndices(patch->gtol, &gtolArray);CHKERRQ(ierr);
2674         ierr = ISRestoreIndices(patch->gtolWithAll, &gtolArrayWithAll);CHKERRQ(ierr);
2675       }
2676     }
2677     if (patch->save_operators) {
2678       ierr = PetscMalloc1(patch->npatch, &patch->mat);CHKERRQ(ierr);
2679       for (i = 0; i < patch->npatch; ++i) {
2680         ierr = PCPatchCreateMatrix_Private(pc, i, &patch->mat[i], PETSC_FALSE);CHKERRQ(ierr);
2681       }
2682     }
2683     ierr = PetscLogEventEnd(PC_Patch_CreatePatches, pc, 0, 0, 0);CHKERRQ(ierr);
2684 
2685     /* If desired, calculate weights for dof multiplicity */
2686     if (patch->partition_of_unity) {
2687       PetscScalar *input = NULL;
2688       PetscScalar *output = NULL;
2689       Vec global;
2690 
2691       ierr = VecDuplicate(patch->localRHS, &patch->dof_weights);CHKERRQ(ierr);
2692       if(patch->local_composition_type == PC_COMPOSITE_ADDITIVE) {
2693         for (i = 0; i < patch->npatch; ++i) {
2694           PetscInt dof;
2695 
2696           ierr = PetscSectionGetDof(patch->gtolCounts, i+pStart, &dof);CHKERRQ(ierr);
2697           if (dof <= 0) continue;
2698           ierr = VecSet(patch->patchRHS[i], 1.0);CHKERRQ(ierr);
2699           ierr = PCPatch_ScatterLocal_Private(pc, i+pStart, patch->patchRHS[i], patch->dof_weights, ADD_VALUES, SCATTER_REVERSE, SCATTER_INTERIOR);CHKERRQ(ierr);
2700         }
2701       } else {
2702         /* multiplicative is actually only locally multiplicative and globally additive. need the pou where the mesh decomposition overlaps */
2703         ierr = VecSet(patch->dof_weights, 1.0);CHKERRQ(ierr);
2704       }
2705 
2706       VecDuplicate(patch->dof_weights, &global);
2707       VecSet(global, 0.);
2708 
2709       ierr = VecGetArray(patch->dof_weights, &input);CHKERRQ(ierr);
2710       ierr = VecGetArray(global, &output);CHKERRQ(ierr);
2711       ierr = PetscSFReduceBegin(patch->defaultSF, MPIU_SCALAR, input, output, MPI_SUM);CHKERRQ(ierr);
2712       ierr = PetscSFReduceEnd(patch->defaultSF, MPIU_SCALAR, input, output, MPI_SUM);CHKERRQ(ierr);
2713       ierr = VecRestoreArray(patch->dof_weights, &input);CHKERRQ(ierr);
2714       ierr = VecRestoreArray(global, &output);CHKERRQ(ierr);
2715 
2716       ierr = VecReciprocal(global);CHKERRQ(ierr);
2717 
2718       ierr = VecGetArray(patch->dof_weights, &output);CHKERRQ(ierr);
2719       ierr = VecGetArray(global, &input);CHKERRQ(ierr);
2720       ierr = PetscSFBcastBegin(patch->defaultSF, MPIU_SCALAR, input, output);CHKERRQ(ierr);
2721       ierr = PetscSFBcastEnd(patch->defaultSF, MPIU_SCALAR, input, output);CHKERRQ(ierr);
2722       ierr = VecRestoreArray(patch->dof_weights, &output);CHKERRQ(ierr);
2723       ierr = VecRestoreArray(global, &input);CHKERRQ(ierr);
2724       ierr = VecDestroy(&global);CHKERRQ(ierr);
2725     }
2726     if(patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE && patch->save_operators) {
2727       ierr = PetscMalloc1(patch->npatch, &patch->matWithArtificial);CHKERRQ(ierr);
2728     }
2729   }
2730   ierr = (*patch->setupsolver)(pc);CHKERRQ(ierr);
2731   PetscFunctionReturn(0);
2732 }
2733 
2734 static PetscErrorCode PCApply_PATCH_Linear(PC pc, PetscInt i, Vec x, Vec y)
2735 {
2736   PC_PATCH      *patch = (PC_PATCH *) pc->data;
2737   KSP            ksp   = (KSP) patch->solver[i];
2738   PetscErrorCode ierr;
2739 
2740   PetscFunctionBegin;
2741   if (!patch->save_operators) {
2742     Mat mat;
2743 
2744     ierr = PCPatchCreateMatrix_Private(pc, i, &mat, PETSC_FALSE);CHKERRQ(ierr);
2745     /* Populate operator here. */
2746     ierr = PCPatchComputeOperator_Internal(pc, NULL, mat, i, PETSC_FALSE);CHKERRQ(ierr);
2747     ierr = KSPSetOperators(ksp, mat, mat);CHKERRQ(ierr);
2748     /* Drop reference so the KSPSetOperators below will blow it away. */
2749     ierr = MatDestroy(&mat);CHKERRQ(ierr);
2750   }
2751   ierr = PetscLogEventBegin(PC_Patch_Solve, pc, 0, 0, 0);CHKERRQ(ierr);
2752   if (!ksp->setfromoptionscalled) {
2753     ierr = KSPSetFromOptions(ksp);CHKERRQ(ierr);
2754   }
2755   ierr = KSPSolve(ksp, x, y);CHKERRQ(ierr);
2756   ierr = KSPCheckSolve(ksp, pc, y);CHKERRQ(ierr);
2757   ierr = PetscLogEventEnd(PC_Patch_Solve, pc, 0, 0, 0);CHKERRQ(ierr);
2758   if (!patch->save_operators) {
2759     PC pc;
2760     ierr = KSPSetOperators(ksp, NULL, NULL);CHKERRQ(ierr);
2761     ierr = KSPGetPC(ksp, &pc);CHKERRQ(ierr);
2762     /* Destroy PC context too, otherwise the factored matrix hangs around. */
2763     ierr = PCReset(pc);CHKERRQ(ierr);
2764   }
2765   PetscFunctionReturn(0);
2766 }
2767 
2768 static PetscErrorCode PCUpdateMultiplicative_PATCH_Linear(PC pc, PetscInt i, PetscInt pStart)
2769 {
2770   PC_PATCH      *patch = (PC_PATCH *) pc->data;
2771   Mat multMat;
2772   PetscErrorCode ierr;
2773 
2774   PetscFunctionBegin;
2775 
2776   if (patch->save_operators) {
2777     multMat = patch->matWithArtificial[i];
2778   } else {
2779     /*Very inefficient, hopefully we can just assemble the rectangular matrix in the first place.*/
2780     Mat matSquare;
2781     PetscInt dof;
2782     IS rowis;
2783     ierr = PCPatchCreateMatrix_Private(pc, i, &matSquare, PETSC_TRUE);CHKERRQ(ierr);
2784     ierr = PCPatchComputeOperator_Internal(pc, NULL, matSquare, i, PETSC_TRUE);CHKERRQ(ierr);
2785     ierr = MatGetSize(matSquare, &dof, NULL);CHKERRQ(ierr);
2786     ierr = ISCreateStride(PETSC_COMM_SELF, dof, 0, 1, &rowis); CHKERRQ(ierr);
2787     ierr = MatCreateSubMatrix(matSquare, rowis, patch->dofMappingWithoutToWithArtificial[i], MAT_INITIAL_MATRIX, &multMat); CHKERRQ(ierr);
2788     ierr = MatDestroy(&matSquare);CHKERRQ(ierr);
2789     ierr = ISDestroy(&rowis); CHKERRQ(ierr);
2790   }
2791   ierr = MatMult(multMat, patch->patchUpdate[i], patch->patchRHSWithArtificial[i]); CHKERRQ(ierr);
2792   ierr = VecScale(patch->patchRHSWithArtificial[i], -1.0); CHKERRQ(ierr);
2793   ierr = PCPatch_ScatterLocal_Private(pc, i + pStart, patch->patchRHSWithArtificial[i], patch->localRHS, ADD_VALUES, SCATTER_REVERSE, SCATTER_WITHARTIFICIAL); CHKERRQ(ierr);
2794   if (!patch->save_operators) {
2795     ierr = MatDestroy(&multMat); CHKERRQ(ierr);
2796   }
2797   PetscFunctionReturn(0);
2798 }
2799 
2800 static PetscErrorCode PCApply_PATCH(PC pc, Vec x, Vec y)
2801 {
2802   PC_PATCH          *patch    = (PC_PATCH *) pc->data;
2803   const PetscScalar *globalRHS  = NULL;
2804   PetscScalar       *localRHS   = NULL;
2805   PetscScalar       *globalUpdate  = NULL;
2806   const PetscInt    *bcNodes  = NULL;
2807   PetscInt           nsweep   = patch->symmetrise_sweep ? 2 : 1;
2808   PetscInt           start[2] = {0, 0};
2809   PetscInt           end[2]   = {-1, -1};
2810   const PetscInt     inc[2]   = {1, -1};
2811   const PetscScalar *localUpdate;
2812   const PetscInt    *iterationSet;
2813   PetscInt           pStart, numBcs, n, sweep, bc, j;
2814   PetscErrorCode     ierr;
2815 
2816   PetscFunctionBegin;
2817   ierr = PetscLogEventBegin(PC_Patch_Apply, pc, 0, 0, 0);CHKERRQ(ierr);
2818   ierr = PetscOptionsPushGetViewerOff(PETSC_TRUE);CHKERRQ(ierr);
2819   /* start, end, inc have 2 entries to manage a second backward sweep if we symmetrize */
2820   end[0]   = patch->npatch;
2821   start[1] = patch->npatch-1;
2822   if (patch->user_patches) {
2823     ierr = ISGetLocalSize(patch->iterationSet, &end[0]);CHKERRQ(ierr);
2824     start[1] = end[0] - 1;
2825     ierr = ISGetIndices(patch->iterationSet, &iterationSet);CHKERRQ(ierr);
2826   }
2827   /* Scatter from global space into overlapped local spaces */
2828   ierr = VecGetArrayRead(x, &globalRHS);CHKERRQ(ierr);
2829   ierr = VecGetArray(patch->localRHS, &localRHS);CHKERRQ(ierr);
2830   ierr = PetscSFBcastBegin(patch->defaultSF, MPIU_SCALAR, globalRHS, localRHS);CHKERRQ(ierr);
2831   ierr = PetscSFBcastEnd(patch->defaultSF, MPIU_SCALAR, globalRHS, localRHS);CHKERRQ(ierr);
2832   ierr = VecRestoreArrayRead(x, &globalRHS);CHKERRQ(ierr);
2833   ierr = VecRestoreArray(patch->localRHS, &localRHS);CHKERRQ(ierr);
2834 
2835   ierr = VecSet(patch->localUpdate, 0.0);CHKERRQ(ierr);
2836   ierr = PetscSectionGetChart(patch->gtolCounts, &pStart, NULL);CHKERRQ(ierr);
2837   for (sweep = 0; sweep < nsweep; sweep++) {
2838     for (j = start[sweep]; j*inc[sweep] < end[sweep]*inc[sweep]; j += inc[sweep]) {
2839       PetscInt i       = patch->user_patches ? iterationSet[j] : j;
2840       PetscInt start, len;
2841 
2842       ierr = PetscSectionGetDof(patch->gtolCounts, i+pStart, &len);CHKERRQ(ierr);
2843       ierr = PetscSectionGetOffset(patch->gtolCounts, i+pStart, &start);CHKERRQ(ierr);
2844       /* TODO: Squash out these guys in the setup as well. */
2845       if (len <= 0) continue;
2846       /* TODO: Do we need different scatters for X and Y? */
2847       ierr = PCPatch_ScatterLocal_Private(pc, i+pStart, patch->localRHS, patch->patchRHS[i], INSERT_VALUES, SCATTER_FORWARD, SCATTER_INTERIOR);CHKERRQ(ierr);
2848       ierr = (*patch->applysolver)(pc, i, patch->patchRHS[i], patch->patchUpdate[i]);CHKERRQ(ierr);
2849       ierr = PCPatch_ScatterLocal_Private(pc, i+pStart, patch->patchUpdate[i], patch->localUpdate, ADD_VALUES, SCATTER_REVERSE, SCATTER_INTERIOR);CHKERRQ(ierr);
2850       if(patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE) {
2851         ierr = (*patch->updatemultiplicative)(pc, i, pStart);CHKERRQ(ierr);
2852       }
2853     }
2854   }
2855   if (patch->user_patches) {ierr = ISRestoreIndices(patch->iterationSet, &iterationSet);CHKERRQ(ierr);}
2856   /* XXX: should we do this on the global vector? */
2857   if (patch->partition_of_unity) {
2858     ierr = VecPointwiseMult(patch->localUpdate, patch->localUpdate, patch->dof_weights);CHKERRQ(ierr);
2859   }
2860   /* Now patch->localUpdate contains the solution of the patch solves, so we need to combine them all. */
2861   ierr = VecSet(y, 0.0);CHKERRQ(ierr);
2862   ierr = VecGetArray(y, &globalUpdate);CHKERRQ(ierr);
2863   ierr = VecGetArrayRead(patch->localUpdate, &localUpdate);CHKERRQ(ierr);
2864   ierr = PetscSFReduceBegin(patch->defaultSF, MPIU_SCALAR, localUpdate, globalUpdate, MPI_SUM);CHKERRQ(ierr);
2865   ierr = PetscSFReduceEnd(patch->defaultSF, MPIU_SCALAR, localUpdate, globalUpdate, MPI_SUM);CHKERRQ(ierr);
2866   ierr = VecRestoreArrayRead(patch->localUpdate, &localUpdate);CHKERRQ(ierr);
2867 
2868   /* Now we need to send the global BC values through */
2869   ierr = VecGetArrayRead(x, &globalRHS);CHKERRQ(ierr);
2870   ierr = ISGetSize(patch->globalBcNodes, &numBcs);CHKERRQ(ierr);
2871   ierr = ISGetIndices(patch->globalBcNodes, &bcNodes);CHKERRQ(ierr);
2872   ierr = VecGetLocalSize(x, &n);CHKERRQ(ierr);
2873   for (bc = 0; bc < numBcs; ++bc) {
2874     const PetscInt idx = bcNodes[bc];
2875     if (idx < n) globalUpdate[idx] = globalRHS[idx];
2876   }
2877 
2878   ierr = ISRestoreIndices(patch->globalBcNodes, &bcNodes);CHKERRQ(ierr);
2879   ierr = VecRestoreArrayRead(x, &globalRHS);CHKERRQ(ierr);
2880   ierr = VecRestoreArray(y, &globalUpdate);CHKERRQ(ierr);
2881 
2882   ierr = PetscOptionsPopGetViewerOff();CHKERRQ(ierr);
2883   ierr = PetscLogEventEnd(PC_Patch_Apply, pc, 0, 0, 0);CHKERRQ(ierr);
2884   PetscFunctionReturn(0);
2885 }
2886 
2887 static PetscErrorCode PCReset_PATCH_Linear(PC pc)
2888 {
2889   PC_PATCH      *patch = (PC_PATCH *) pc->data;
2890   PetscInt       i;
2891   PetscErrorCode ierr;
2892 
2893   PetscFunctionBegin;
2894   if (patch->solver) {
2895     for (i = 0; i < patch->npatch; ++i) {ierr = KSPReset((KSP) patch->solver[i]);CHKERRQ(ierr);}
2896   }
2897   PetscFunctionReturn(0);
2898 }
2899 
2900 static PetscErrorCode PCReset_PATCH(PC pc)
2901 {
2902   PC_PATCH      *patch = (PC_PATCH *) pc->data;
2903   PetscInt       i;
2904   PetscErrorCode ierr;
2905 
2906   PetscFunctionBegin;
2907 
2908   ierr = PetscSFDestroy(&patch->defaultSF);CHKERRQ(ierr);
2909   ierr = PetscSectionDestroy(&patch->cellCounts);CHKERRQ(ierr);
2910   ierr = PetscSectionDestroy(&patch->pointCounts);CHKERRQ(ierr);
2911   ierr = PetscSectionDestroy(&patch->cellNumbering);CHKERRQ(ierr);
2912   ierr = PetscSectionDestroy(&patch->gtolCounts);CHKERRQ(ierr);
2913   ierr = ISDestroy(&patch->gtol);CHKERRQ(ierr);
2914   ierr = ISDestroy(&patch->cells);CHKERRQ(ierr);
2915   ierr = ISDestroy(&patch->points);CHKERRQ(ierr);
2916   ierr = ISDestroy(&patch->dofs);CHKERRQ(ierr);
2917   ierr = ISDestroy(&patch->offs);CHKERRQ(ierr);
2918   ierr = PetscSectionDestroy(&patch->patchSection);CHKERRQ(ierr);
2919   ierr = ISDestroy(&patch->ghostBcNodes);CHKERRQ(ierr);
2920   ierr = ISDestroy(&patch->globalBcNodes);CHKERRQ(ierr);
2921   ierr = PetscSectionDestroy(&patch->gtolCountsWithArtificial);CHKERRQ(ierr);
2922   ierr = ISDestroy(&patch->gtolWithArtificial);CHKERRQ(ierr);
2923   ierr = ISDestroy(&patch->dofsWithArtificial);CHKERRQ(ierr);
2924   ierr = ISDestroy(&patch->offsWithArtificial);CHKERRQ(ierr);
2925   ierr = PetscSectionDestroy(&patch->gtolCountsWithAll);CHKERRQ(ierr);
2926   ierr = ISDestroy(&patch->gtolWithAll);CHKERRQ(ierr);
2927   ierr = ISDestroy(&patch->dofsWithAll);CHKERRQ(ierr);
2928   ierr = ISDestroy(&patch->offsWithAll);CHKERRQ(ierr);
2929   ierr = VecDestroy(&patch->cellMats);CHKERRQ(ierr);
2930   ierr = VecDestroy(&patch->intFacetMats);CHKERRQ(ierr);
2931   ierr = ISDestroy(&patch->allCells);CHKERRQ(ierr);
2932   ierr = ISDestroy(&patch->intFacets);CHKERRQ(ierr);
2933   ierr = ISDestroy(&patch->extFacets);CHKERRQ(ierr);
2934   ierr = ISDestroy(&patch->intFacetsToPatchCell);CHKERRQ(ierr);
2935   ierr = PetscSectionDestroy(&patch->intFacetCounts);CHKERRQ(ierr);
2936   ierr = PetscSectionDestroy(&patch->extFacetCounts);CHKERRQ(ierr);
2937 
2938   if (patch->dofSection) for (i = 0; i < patch->nsubspaces; i++) {ierr = PetscSectionDestroy(&patch->dofSection[i]);CHKERRQ(ierr);}
2939   ierr = PetscFree(patch->dofSection);CHKERRQ(ierr);
2940   ierr = PetscFree(patch->bs);CHKERRQ(ierr);
2941   ierr = PetscFree(patch->nodesPerCell);CHKERRQ(ierr);
2942   if (patch->cellNodeMap) for (i = 0; i < patch->nsubspaces; i++) {ierr = PetscFree(patch->cellNodeMap[i]);CHKERRQ(ierr);}
2943   ierr = PetscFree(patch->cellNodeMap);CHKERRQ(ierr);
2944   ierr = PetscFree(patch->subspaceOffsets);CHKERRQ(ierr);
2945 
2946   ierr = (*patch->resetsolver)(pc);CHKERRQ(ierr);
2947 
2948   if (patch->subspaces_to_exclude) {
2949     PetscHSetIDestroy(&patch->subspaces_to_exclude);
2950   }
2951 
2952   ierr = VecDestroy(&patch->localRHS);CHKERRQ(ierr);
2953   ierr = VecDestroy(&patch->localUpdate);CHKERRQ(ierr);
2954   if (patch->patchRHS) {
2955     for (i = 0; i < patch->npatch; ++i) {ierr = VecDestroy(&patch->patchRHS[i]);CHKERRQ(ierr);}
2956     ierr = PetscFree(patch->patchRHS);CHKERRQ(ierr);
2957   }
2958   if (patch->patchUpdate) {
2959     for (i = 0; i < patch->npatch; ++i) {ierr = VecDestroy(&patch->patchUpdate[i]);CHKERRQ(ierr);}
2960     ierr = PetscFree(patch->patchUpdate);CHKERRQ(ierr);
2961   }
2962   ierr = VecDestroy(&patch->dof_weights);CHKERRQ(ierr);
2963   if (patch->patch_dof_weights) {
2964     for (i = 0; i < patch->npatch; ++i) {ierr = VecDestroy(&patch->patch_dof_weights[i]);CHKERRQ(ierr);}
2965     ierr = PetscFree(patch->patch_dof_weights);CHKERRQ(ierr);
2966   }
2967   if (patch->mat) {
2968     for (i = 0; i < patch->npatch; ++i) {ierr = MatDestroy(&patch->mat[i]);CHKERRQ(ierr);}
2969     ierr = PetscFree(patch->mat);CHKERRQ(ierr);
2970   }
2971   if (patch->matWithArtificial) {
2972     for (i = 0; i < patch->npatch; ++i) {ierr = MatDestroy(&patch->matWithArtificial[i]);CHKERRQ(ierr);}
2973     ierr = PetscFree(patch->matWithArtificial);CHKERRQ(ierr);
2974   }
2975   if (patch->patchRHSWithArtificial) {
2976     for (i = 0; i < patch->npatch; ++i) {ierr = VecDestroy(&patch->patchRHSWithArtificial[i]);CHKERRQ(ierr);}
2977     ierr = PetscFree(patch->patchRHSWithArtificial);CHKERRQ(ierr);
2978   }
2979   if(patch->dofMappingWithoutToWithArtificial) {
2980     for (i = 0; i < patch->npatch; ++i) {ierr = ISDestroy(&patch->dofMappingWithoutToWithArtificial[i]);CHKERRQ(ierr);}
2981     ierr = PetscFree(patch->dofMappingWithoutToWithArtificial);CHKERRQ(ierr);
2982 
2983   }
2984   if(patch->dofMappingWithoutToWithAll) {
2985     for (i = 0; i < patch->npatch; ++i) {ierr = ISDestroy(&patch->dofMappingWithoutToWithAll[i]);CHKERRQ(ierr);}
2986     ierr = PetscFree(patch->dofMappingWithoutToWithAll);CHKERRQ(ierr);
2987 
2988   }
2989   ierr = PetscFree(patch->sub_mat_type);CHKERRQ(ierr);
2990   if (patch->userIS) {
2991     for (i = 0; i < patch->npatch; ++i) {ierr = ISDestroy(&patch->userIS[i]);CHKERRQ(ierr);}
2992     ierr = PetscFree(patch->userIS);CHKERRQ(ierr);
2993   }
2994   ierr = PetscFree(patch->precomputedTensorLocations);CHKERRQ(ierr);
2995   ierr = PetscFree(patch->precomputedIntFacetTensorLocations);CHKERRQ(ierr);
2996 
2997   patch->bs          = 0;
2998   patch->cellNodeMap = NULL;
2999   patch->nsubspaces  = 0;
3000   ierr = ISDestroy(&patch->iterationSet);CHKERRQ(ierr);
3001 
3002   ierr = PetscViewerDestroy(&patch->viewerSection);CHKERRQ(ierr);
3003   PetscFunctionReturn(0);
3004 }
3005 
3006 static PetscErrorCode PCDestroy_PATCH_Linear(PC pc)
3007 {
3008   PC_PATCH      *patch = (PC_PATCH *) pc->data;
3009   PetscInt       i;
3010   PetscErrorCode ierr;
3011 
3012   PetscFunctionBegin;
3013   if (patch->solver) {
3014     for (i = 0; i < patch->npatch; ++i) {ierr = KSPDestroy((KSP *) &patch->solver[i]);CHKERRQ(ierr);}
3015     ierr = PetscFree(patch->solver);CHKERRQ(ierr);
3016   }
3017   PetscFunctionReturn(0);
3018 }
3019 
3020 static PetscErrorCode PCDestroy_PATCH(PC pc)
3021 {
3022   PC_PATCH      *patch = (PC_PATCH *) pc->data;
3023   PetscErrorCode ierr;
3024 
3025   PetscFunctionBegin;
3026   ierr = PCReset_PATCH(pc);CHKERRQ(ierr);
3027   ierr = (*patch->destroysolver)(pc);CHKERRQ(ierr);
3028   ierr = PetscFree(pc->data);CHKERRQ(ierr);
3029   PetscFunctionReturn(0);
3030 }
3031 
3032 static PetscErrorCode PCSetFromOptions_PATCH(PetscOptionItems *PetscOptionsObject, PC pc)
3033 {
3034   PC_PATCH            *patch = (PC_PATCH *) pc->data;
3035   PCPatchConstructType patchConstructionType = PC_PATCH_STAR;
3036   char                 sub_mat_type[PETSC_MAX_PATH_LEN];
3037   char                 option[PETSC_MAX_PATH_LEN];
3038   const char          *prefix;
3039   PetscBool            flg, dimflg, codimflg;
3040   MPI_Comm             comm;
3041   PetscInt            *ifields, nfields, k;
3042   PetscErrorCode       ierr;
3043   PCCompositeType loctype = PC_COMPOSITE_ADDITIVE;
3044 
3045   PetscFunctionBegin;
3046   ierr = PetscObjectGetComm((PetscObject) pc, &comm);CHKERRQ(ierr);
3047   ierr = PetscObjectGetOptionsPrefix((PetscObject) pc, &prefix);CHKERRQ(ierr);
3048   ierr = PetscOptionsHead(PetscOptionsObject, "Patch solver options");CHKERRQ(ierr);
3049 
3050   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_save_operators", patch->classname);CHKERRQ(ierr);
3051   ierr = PetscOptionsBool(option,  "Store all patch operators for lifetime of object?", "PCPatchSetSaveOperators", patch->save_operators, &patch->save_operators, &flg);CHKERRQ(ierr);
3052 
3053   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_precompute_element_tensors", patch->classname);CHKERRQ(ierr);
3054   ierr = PetscOptionsBool(option,  "Compute each element tensor only once?", "PCPatchSetPrecomputeElementTensors", patch->precomputeElementTensors, &patch->precomputeElementTensors, &flg);CHKERRQ(ierr);
3055   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_partition_of_unity", patch->classname);CHKERRQ(ierr);
3056   ierr = PetscOptionsBool(option, "Weight contributions by dof multiplicity?", "PCPatchSetPartitionOfUnity", patch->partition_of_unity, &patch->partition_of_unity, &flg);CHKERRQ(ierr);
3057 
3058   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_local_type", patch->classname);CHKERRQ(ierr);
3059   ierr = PetscOptionsEnum(option,"Type of local solver composition (additive or multiplicative)","PCPatchSetLocalComposition",PCCompositeTypes,(PetscEnum)loctype,(PetscEnum*)&loctype,&flg);CHKERRQ(ierr);
3060   if(flg) { ierr = PCPatchSetLocalComposition(pc, loctype);CHKERRQ(ierr);}
3061 
3062   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_construct_dim", patch->classname);CHKERRQ(ierr);
3063   ierr = PetscOptionsInt(option, "What dimension of mesh point to construct patches by? (0 = vertices)", "PCPATCH", patch->dim, &patch->dim, &dimflg);CHKERRQ(ierr);
3064   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_construct_codim", patch->classname);CHKERRQ(ierr);
3065   ierr = PetscOptionsInt(option, "What co-dimension of mesh point to construct patches by? (0 = cells)", "PCPATCH", patch->codim, &patch->codim, &codimflg);CHKERRQ(ierr);
3066   if (dimflg && codimflg) SETERRQ(comm, PETSC_ERR_ARG_WRONG, "Can only set one of dimension or co-dimension");
3067 
3068   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_construct_type", patch->classname);CHKERRQ(ierr);
3069   ierr = PetscOptionsEnum(option, "How should the patches be constructed?", "PCPatchSetConstructType", PCPatchConstructTypes, (PetscEnum) patchConstructionType, (PetscEnum *) &patchConstructionType, &flg);CHKERRQ(ierr);
3070   if (flg) {ierr = PCPatchSetConstructType(pc, patchConstructionType, NULL, NULL);CHKERRQ(ierr);}
3071 
3072   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_vanka_dim", patch->classname);CHKERRQ(ierr);
3073   ierr = PetscOptionsInt(option, "Topological dimension of entities for Vanka to ignore", "PCPATCH", patch->vankadim, &patch->vankadim, &flg);CHKERRQ(ierr);
3074 
3075   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_ignore_dim", patch->classname);CHKERRQ(ierr);
3076   ierr = PetscOptionsInt(option, "Topological dimension of entities for completion to ignore", "PCPATCH", patch->ignoredim, &patch->ignoredim, &flg);CHKERRQ(ierr);
3077 
3078   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_pardecomp_overlap", patch->classname);CHKERRQ(ierr);
3079   ierr = PetscOptionsInt(option, "What overlap should we use in construct type pardecomp?", "PCPATCH", patch->pardecomp_overlap, &patch->pardecomp_overlap, &flg);CHKERRQ(ierr);
3080 
3081   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_sub_mat_type", patch->classname);CHKERRQ(ierr);
3082   ierr = PetscOptionsFList(option, "Matrix type for patch solves", "PCPatchSetSubMatType", MatList, NULL, sub_mat_type, PETSC_MAX_PATH_LEN, &flg);CHKERRQ(ierr);
3083   if (flg) {ierr = PCPatchSetSubMatType(pc, sub_mat_type);CHKERRQ(ierr);}
3084 
3085   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_symmetrise_sweep", patch->classname);CHKERRQ(ierr);
3086   ierr = PetscOptionsBool(option, "Go start->end, end->start?", "PCPATCH", patch->symmetrise_sweep, &patch->symmetrise_sweep, &flg);CHKERRQ(ierr);
3087 
3088   /* If the user has set the number of subspaces, use that for the buffer size,
3089      otherwise use a large number */
3090   if (patch->nsubspaces <= 0) {
3091     nfields = 128;
3092   } else {
3093     nfields = patch->nsubspaces;
3094   }
3095   ierr = PetscMalloc1(nfields, &ifields);CHKERRQ(ierr);
3096   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_exclude_subspaces", patch->classname);CHKERRQ(ierr);
3097   ierr = PetscOptionsGetIntArray(((PetscObject)pc)->options,((PetscObject)pc)->prefix,option,ifields,&nfields,&flg);CHKERRQ(ierr);
3098   if (flg && (patchConstructionType == PC_PATCH_USER)) SETERRQ(comm, PETSC_ERR_ARG_INCOMP, "We cannot support excluding a subspace with user patches because we do not index patches with a mesh point");
3099   if (flg) {
3100     PetscHSetIClear(patch->subspaces_to_exclude);
3101     for (k = 0; k < nfields; k++) {
3102       PetscHSetIAdd(patch->subspaces_to_exclude, ifields[k]);
3103     }
3104   }
3105   ierr = PetscFree(ifields);CHKERRQ(ierr);
3106 
3107   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_patches_view", patch->classname);CHKERRQ(ierr);
3108   ierr = PetscOptionsBool(option, "Print out information during patch construction", "PCPATCH", patch->viewPatches, &patch->viewPatches, &flg);CHKERRQ(ierr);
3109   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_cells_view", patch->classname);CHKERRQ(ierr);
3110   ierr = PetscOptionsGetViewer(comm,((PetscObject) pc)->options, prefix, option, &patch->viewerCells, &patch->formatCells, &patch->viewCells);CHKERRQ(ierr);
3111   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_interior_facets_view", patch->classname);CHKERRQ(ierr);
3112   ierr = PetscOptionsGetViewer(comm,((PetscObject) pc)->options, prefix, option, &patch->viewerIntFacets, &patch->formatIntFacets, &patch->viewIntFacets);CHKERRQ(ierr);
3113   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_exterior_facets_view", patch->classname);CHKERRQ(ierr);
3114   ierr = PetscOptionsGetViewer(comm,((PetscObject) pc)->options, prefix, option, &patch->viewerExtFacets, &patch->formatExtFacets, &patch->viewExtFacets);CHKERRQ(ierr);
3115   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_points_view", patch->classname);CHKERRQ(ierr);
3116   ierr = PetscOptionsGetViewer(comm,((PetscObject) pc)->options, prefix, option, &patch->viewerPoints, &patch->formatPoints, &patch->viewPoints);CHKERRQ(ierr);
3117   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_section_view", patch->classname);CHKERRQ(ierr);
3118   ierr = PetscOptionsGetViewer(comm,((PetscObject) pc)->options, prefix, option, &patch->viewerSection, &patch->formatSection, &patch->viewSection);CHKERRQ(ierr);
3119   ierr = PetscSNPrintf(option, PETSC_MAX_PATH_LEN, "-%s_patch_mat_view", patch->classname);CHKERRQ(ierr);
3120   ierr = PetscOptionsGetViewer(comm,((PetscObject) pc)->options, prefix, option, &patch->viewerMatrix, &patch->formatMatrix, &patch->viewMatrix);CHKERRQ(ierr);
3121   ierr = PetscOptionsTail();CHKERRQ(ierr);
3122   patch->optionsSet = PETSC_TRUE;
3123   PetscFunctionReturn(0);
3124 }
3125 
3126 static PetscErrorCode PCSetUpOnBlocks_PATCH(PC pc)
3127 {
3128   PC_PATCH          *patch = (PC_PATCH*) pc->data;
3129   KSPConvergedReason reason;
3130   PetscInt           i;
3131   PetscErrorCode     ierr;
3132 
3133   PetscFunctionBegin;
3134   if (!patch->save_operators) {
3135     /* Can't do this here because the sub KSPs don't have an operator attached yet. */
3136     PetscFunctionReturn(0);
3137   }
3138   for (i = 0; i < patch->npatch; ++i) {
3139     if (!((KSP) patch->solver[i])->setfromoptionscalled) {
3140       ierr = KSPSetFromOptions((KSP) patch->solver[i]);CHKERRQ(ierr);
3141     }
3142     ierr = KSPSetUp((KSP) patch->solver[i]);CHKERRQ(ierr);
3143     ierr = KSPGetConvergedReason((KSP) patch->solver[i], &reason);CHKERRQ(ierr);
3144     if (reason == KSP_DIVERGED_PC_FAILED) pc->failedreason = PC_SUBPC_ERROR;
3145   }
3146   PetscFunctionReturn(0);
3147 }
3148 
3149 static PetscErrorCode PCView_PATCH(PC pc, PetscViewer viewer)
3150 {
3151   PC_PATCH      *patch = (PC_PATCH *) pc->data;
3152   PetscViewer    sviewer;
3153   PetscBool      isascii;
3154   PetscMPIInt    rank;
3155   PetscErrorCode ierr;
3156 
3157   PetscFunctionBegin;
3158   /* TODO Redo tabbing with set tbas in new style */
3159   ierr = PetscObjectTypeCompare((PetscObject) viewer, PETSCVIEWERASCII, &isascii);CHKERRQ(ierr);
3160   if (!isascii) PetscFunctionReturn(0);
3161   ierr = MPI_Comm_rank(PetscObjectComm((PetscObject) pc), &rank);CHKERRQ(ierr);
3162   ierr = PetscViewerASCIIPushTab(viewer);CHKERRQ(ierr);
3163   ierr = PetscViewerASCIIPrintf(viewer, "Subspace Correction preconditioner with %d patches\n", patch->npatch);CHKERRQ(ierr);
3164   if(patch->local_composition_type == PC_COMPOSITE_MULTIPLICATIVE) {
3165     ierr = PetscViewerASCIIPrintf(viewer, "Schwarz type: multiplicative\n");CHKERRQ(ierr);
3166   } else {
3167     ierr = PetscViewerASCIIPrintf(viewer, "Schwarz type: additive\n");CHKERRQ(ierr);
3168   }
3169   if (patch->partition_of_unity) {ierr = PetscViewerASCIIPrintf(viewer, "Weighting by partition of unity\n");CHKERRQ(ierr);}
3170   else                           {ierr = PetscViewerASCIIPrintf(viewer, "Not weighting by partition of unity\n");CHKERRQ(ierr);}
3171   if (patch->symmetrise_sweep) {ierr = PetscViewerASCIIPrintf(viewer, "Symmetrising sweep (start->end, then end->start)\n");CHKERRQ(ierr);}
3172   else                         {ierr = PetscViewerASCIIPrintf(viewer, "Not symmetrising sweep\n");CHKERRQ(ierr);}
3173   if (!patch->precomputeElementTensors) {ierr = PetscViewerASCIIPrintf(viewer, "Not precomputing element tensors (overlapping cells rebuilt in every patch assembly)\n");CHKERRQ(ierr);}
3174   else                            {ierr = PetscViewerASCIIPrintf(viewer, "Precomputing element tensors (each cell assembled only once)\n");CHKERRQ(ierr);}
3175   if (!patch->save_operators) {ierr = PetscViewerASCIIPrintf(viewer, "Not saving patch operators (rebuilt every PCApply)\n");CHKERRQ(ierr);}
3176   else                        {ierr = PetscViewerASCIIPrintf(viewer, "Saving patch operators (rebuilt every PCSetUp)\n");CHKERRQ(ierr);}
3177   if (patch->patchconstructop == PCPatchConstruct_Star)       {ierr = PetscViewerASCIIPrintf(viewer, "Patch construction operator: star\n");CHKERRQ(ierr);}
3178   else if (patch->patchconstructop == PCPatchConstruct_Vanka) {ierr = PetscViewerASCIIPrintf(viewer, "Patch construction operator: Vanka\n");CHKERRQ(ierr);}
3179   else if (patch->patchconstructop == PCPatchConstruct_User)  {ierr = PetscViewerASCIIPrintf(viewer, "Patch construction operator: user-specified\n");CHKERRQ(ierr);}
3180   else                                                        {ierr = PetscViewerASCIIPrintf(viewer, "Patch construction operator: unknown\n");CHKERRQ(ierr);}
3181 
3182   if (patch->isNonlinear) {
3183     ierr = PetscViewerASCIIPrintf(viewer, "SNES on patches (all same):\n");CHKERRQ(ierr);
3184   } else {
3185     ierr = PetscViewerASCIIPrintf(viewer, "KSP on patches (all same):\n");CHKERRQ(ierr);
3186   }
3187   if (patch->solver) {
3188     ierr = PetscViewerGetSubViewer(viewer, PETSC_COMM_SELF, &sviewer);CHKERRQ(ierr);
3189     if (!rank) {
3190       ierr = PetscViewerASCIIPushTab(sviewer);CHKERRQ(ierr);
3191       ierr = PetscObjectView(patch->solver[0], sviewer);CHKERRQ(ierr);
3192       ierr = PetscViewerASCIIPopTab(sviewer);CHKERRQ(ierr);
3193     }
3194     ierr = PetscViewerRestoreSubViewer(viewer, PETSC_COMM_SELF, &sviewer);CHKERRQ(ierr);
3195   } else {
3196     ierr = PetscViewerASCIIPushTab(viewer);CHKERRQ(ierr);
3197     ierr = PetscViewerASCIIPrintf(viewer, "Solver not yet set.\n");CHKERRQ(ierr);
3198     ierr = PetscViewerASCIIPopTab(viewer);CHKERRQ(ierr);
3199   }
3200   ierr = PetscViewerASCIIPopTab(viewer);CHKERRQ(ierr);
3201   PetscFunctionReturn(0);
3202 }
3203 
3204 /*MC
3205   PCPATCH - A PC object that encapsulates flexible definition of blocks for overlapping and non-overlapping
3206             small block additive preconditioners. Block definition is based on topology from
3207             a DM and equation numbering from a PetscSection.
3208 
3209   Options Database Keys:
3210 + -pc_patch_cells_view   - Views the process local cell numbers for each patch
3211 . -pc_patch_points_view  - Views the process local mesh point numbers for each patch
3212 . -pc_patch_g2l_view     - Views the map between global dofs and patch local dofs for each patch
3213 . -pc_patch_patches_view - Views the global dofs associated with each patch and its boundary
3214 - -pc_patch_sub_mat_view - Views the matrix associated with each patch
3215 
3216   Level: intermediate
3217 
3218 .seealso: PCType, PCCreate(), PCSetType()
3219 M*/
3220 PETSC_EXTERN PetscErrorCode PCCreate_Patch(PC pc)
3221 {
3222   PC_PATCH      *patch;
3223   PetscErrorCode ierr;
3224 
3225   PetscFunctionBegin;
3226   ierr = PetscNewLog(pc, &patch);CHKERRQ(ierr);
3227 
3228   if (patch->subspaces_to_exclude) {
3229     PetscHSetIDestroy(&patch->subspaces_to_exclude);
3230   }
3231   PetscHSetICreate(&patch->subspaces_to_exclude);
3232 
3233   patch->classname = "pc";
3234   patch->isNonlinear = PETSC_FALSE;
3235 
3236   /* Set some defaults */
3237   patch->combined           = PETSC_FALSE;
3238   patch->save_operators     = PETSC_TRUE;
3239   patch->local_composition_type = PC_COMPOSITE_ADDITIVE;
3240   patch->precomputeElementTensors = PETSC_FALSE;
3241   patch->partition_of_unity = PETSC_FALSE;
3242   patch->codim              = -1;
3243   patch->dim                = -1;
3244   patch->vankadim           = -1;
3245   patch->ignoredim          = -1;
3246   patch->pardecomp_overlap  = 0;
3247   patch->patchconstructop   = PCPatchConstruct_Star;
3248   patch->symmetrise_sweep   = PETSC_FALSE;
3249   patch->npatch             = 0;
3250   patch->userIS             = NULL;
3251   patch->optionsSet         = PETSC_FALSE;
3252   patch->iterationSet       = NULL;
3253   patch->user_patches       = PETSC_FALSE;
3254   ierr = PetscStrallocpy(MATDENSE, (char **) &patch->sub_mat_type);CHKERRQ(ierr);
3255   patch->viewPatches        = PETSC_FALSE;
3256   patch->viewCells          = PETSC_FALSE;
3257   patch->viewPoints         = PETSC_FALSE;
3258   patch->viewSection        = PETSC_FALSE;
3259   patch->viewMatrix         = PETSC_FALSE;
3260   patch->setupsolver        = PCSetUp_PATCH_Linear;
3261   patch->applysolver        = PCApply_PATCH_Linear;
3262   patch->resetsolver        = PCReset_PATCH_Linear;
3263   patch->destroysolver      = PCDestroy_PATCH_Linear;
3264   patch->updatemultiplicative = PCUpdateMultiplicative_PATCH_Linear;
3265   patch->dofMappingWithoutToWithArtificial = NULL;
3266   patch->dofMappingWithoutToWithAll = NULL;
3267 
3268   pc->data                 = (void *) patch;
3269   pc->ops->apply           = PCApply_PATCH;
3270   pc->ops->applytranspose  = 0; /* PCApplyTranspose_PATCH; */
3271   pc->ops->setup           = PCSetUp_PATCH;
3272   pc->ops->reset           = PCReset_PATCH;
3273   pc->ops->destroy         = PCDestroy_PATCH;
3274   pc->ops->setfromoptions  = PCSetFromOptions_PATCH;
3275   pc->ops->setuponblocks   = PCSetUpOnBlocks_PATCH;
3276   pc->ops->view            = PCView_PATCH;
3277   pc->ops->applyrichardson = 0;
3278 
3279   PetscFunctionReturn(0);
3280 }
3281