xref: /petsc/src/dm/impls/plex/plexinterpolate.c (revision b325530a1d25ab27936094b2210f9f79ea17e33d)
1 #include <petsc/private/dmpleximpl.h>   /*I      "petscdmplex.h"   I*/
2 #include <petsc/private/hashmapi.h>
3 #include <petsc/private/hashmapij.h>
4 
5 /* HashIJKL */
6 
7 #include <petsc/private/hashmap.h>
8 
9 typedef struct _PetscHashIJKLKey { PetscInt i, j, k, l; } PetscHashIJKLKey;
10 
11 #define PetscHashIJKLKeyHash(key) \
12   PetscHashCombine(PetscHashCombine(PetscHashInt((key).i),PetscHashInt((key).j)), \
13                    PetscHashCombine(PetscHashInt((key).k),PetscHashInt((key).l)))
14 
15 #define PetscHashIJKLKeyEqual(k1,k2) \
16   (((k1).i==(k2).i) ? ((k1).j==(k2).j) ? ((k1).k==(k2).k) ? ((k1).l==(k2).l) : 0 : 0 : 0)
17 
18 PETSC_HASH_MAP(HashIJKL, PetscHashIJKLKey, PetscInt, PetscHashIJKLKeyHash, PetscHashIJKLKeyEqual, -1)
19 
20 
21 /*
22   DMPlexGetFaces_Internal - Gets groups of vertices that correspond to faces for the given cell
23   This assumes that the mesh is not interpolated from the depth of point p to the vertices
24 */
25 PetscErrorCode DMPlexGetFaces_Internal(DM dm, PetscInt dim, PetscInt p, PetscInt *numFaces, PetscInt *faceSize, const PetscInt *faces[])
26 {
27   const PetscInt *cone = NULL;
28   PetscInt        coneSize;
29   PetscErrorCode  ierr;
30 
31   PetscFunctionBegin;
32   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
33   ierr = DMPlexGetConeSize(dm, p, &coneSize);CHKERRQ(ierr);
34   ierr = DMPlexGetCone(dm, p, &cone);CHKERRQ(ierr);
35   ierr = DMPlexGetRawFaces_Internal(dm, dim, coneSize, cone, numFaces, faceSize, faces);CHKERRQ(ierr);
36   PetscFunctionReturn(0);
37 }
38 
39 /*
40   DMPlexRestoreFaces_Internal - Restores the array
41 */
42 PetscErrorCode DMPlexRestoreFaces_Internal(DM dm, PetscInt dim, PetscInt p, PetscInt *numFaces, PetscInt *faceSize, const PetscInt *faces[])
43 {
44   PetscErrorCode  ierr;
45 
46   PetscFunctionBegin;
47   if (faces) { ierr = DMRestoreWorkArray(dm, 0, MPIU_INT, (void *) faces);CHKERRQ(ierr); }
48   PetscFunctionReturn(0);
49 }
50 
51 /*
52   DMPlexGetRawFaces_Internal - Gets groups of vertices that correspond to faces for the given cone
53 */
54 PetscErrorCode DMPlexGetRawFaces_Internal(DM dm, PetscInt dim, PetscInt coneSize, const PetscInt cone[], PetscInt *numFaces, PetscInt *faceSize, const PetscInt *faces[])
55 {
56   PetscInt       *facesTmp;
57   PetscInt        maxConeSize, maxSupportSize;
58   PetscErrorCode  ierr;
59 
60   PetscFunctionBegin;
61   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
62   if (faces && coneSize) PetscValidIntPointer(cone,4);
63   ierr = DMPlexGetMaxSizes(dm, &maxConeSize, &maxSupportSize);CHKERRQ(ierr);
64   if (faces) {ierr = DMGetWorkArray(dm, PetscSqr(PetscMax(maxConeSize, maxSupportSize)), MPIU_INT, &facesTmp);CHKERRQ(ierr);}
65   switch (dim) {
66   case 1:
67     switch (coneSize) {
68     case 2:
69       if (faces) {
70         facesTmp[0] = cone[0]; facesTmp[1] = cone[1];
71         *faces = facesTmp;
72       }
73       if (numFaces) *numFaces = 2;
74       if (faceSize) *faceSize = 1;
75       break;
76     default:
77       SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Cone size %D not supported for dimension %D", coneSize, dim);
78     }
79     break;
80   case 2:
81     switch (coneSize) {
82     case 3:
83       if (faces) {
84         facesTmp[0] = cone[0]; facesTmp[1] = cone[1];
85         facesTmp[2] = cone[1]; facesTmp[3] = cone[2];
86         facesTmp[4] = cone[2]; facesTmp[5] = cone[0];
87         *faces = facesTmp;
88       }
89       if (numFaces) *numFaces = 3;
90       if (faceSize) *faceSize = 2;
91       break;
92     case 4:
93       /* Vertices follow right hand rule */
94       if (faces) {
95         facesTmp[0] = cone[0]; facesTmp[1] = cone[1];
96         facesTmp[2] = cone[1]; facesTmp[3] = cone[2];
97         facesTmp[4] = cone[2]; facesTmp[5] = cone[3];
98         facesTmp[6] = cone[3]; facesTmp[7] = cone[0];
99         *faces = facesTmp;
100       }
101       if (numFaces) *numFaces = 4;
102       if (faceSize) *faceSize = 2;
103       break;
104     default:
105       SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Cone size %D not supported for dimension %D", coneSize, dim);
106     }
107     break;
108   case 3:
109     switch (coneSize) {
110     case 3:
111       if (faces) {
112         facesTmp[0] = cone[0]; facesTmp[1] = cone[1];
113         facesTmp[2] = cone[1]; facesTmp[3] = cone[2];
114         facesTmp[4] = cone[2]; facesTmp[5] = cone[0];
115         *faces = facesTmp;
116       }
117       if (numFaces) *numFaces = 3;
118       if (faceSize) *faceSize = 2;
119       break;
120     case 4:
121       /* Vertices of first face follow right hand rule and normal points away from last vertex */
122       if (faces) {
123         facesTmp[0] = cone[0]; facesTmp[1]  = cone[1]; facesTmp[2]  = cone[2];
124         facesTmp[3] = cone[0]; facesTmp[4]  = cone[3]; facesTmp[5]  = cone[1];
125         facesTmp[6] = cone[0]; facesTmp[7]  = cone[2]; facesTmp[8]  = cone[3];
126         facesTmp[9] = cone[2]; facesTmp[10] = cone[1]; facesTmp[11] = cone[3];
127         *faces = facesTmp;
128       }
129       if (numFaces) *numFaces = 4;
130       if (faceSize) *faceSize = 3;
131       break;
132     case 8:
133       /*  7--------6
134          /|       /|
135         / |      / |
136        4--------5  |
137        |  |     |  |
138        |  |     |  |
139        |  1--------2
140        | /      | /
141        |/       |/
142        0--------3
143        */
144       if (faces) {
145         facesTmp[0]  = cone[0]; facesTmp[1]  = cone[1]; facesTmp[2]  = cone[2]; facesTmp[3]  = cone[3]; /* Bottom */
146         facesTmp[4]  = cone[4]; facesTmp[5]  = cone[5]; facesTmp[6]  = cone[6]; facesTmp[7]  = cone[7]; /* Top */
147         facesTmp[8]  = cone[0]; facesTmp[9]  = cone[3]; facesTmp[10] = cone[5]; facesTmp[11] = cone[4]; /* Front */
148         facesTmp[12] = cone[2]; facesTmp[13] = cone[1]; facesTmp[14] = cone[7]; facesTmp[15] = cone[6]; /* Back */
149         facesTmp[16] = cone[3]; facesTmp[17] = cone[2]; facesTmp[18] = cone[6]; facesTmp[19] = cone[5]; /* Right */
150         facesTmp[20] = cone[0]; facesTmp[21] = cone[4]; facesTmp[22] = cone[7]; facesTmp[23] = cone[1]; /* Left */
151         *faces = facesTmp;
152       }
153       if (numFaces) *numFaces = 6;
154       if (faceSize) *faceSize = 4;
155       break;
156     default:
157       SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Cone size %D not supported for dimension %D", coneSize, dim);
158     }
159     break;
160   default:
161     SETERRQ1(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Dimension %D not supported", dim);
162   }
163   PetscFunctionReturn(0);
164 }
165 
166 /*
167   DMPlexGetRawFacesHybrid_Internal - Gets groups of vertices that correspond to faces for the given cone using hybrid ordering (prisms)
168 */
169 static PetscErrorCode DMPlexGetRawFacesHybrid_Internal(DM dm, PetscInt dim, PetscInt coneSize, const PetscInt cone[], PetscInt *numFaces, PetscInt *numFacesNotH, PetscInt *faceSize, const PetscInt *faces[])
170 {
171   PetscInt       *facesTmp;
172   PetscInt        maxConeSize, maxSupportSize;
173   PetscErrorCode  ierr;
174 
175   PetscFunctionBegin;
176   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
177   if (faces && coneSize) PetscValidIntPointer(cone,4);
178   ierr = DMPlexGetMaxSizes(dm, &maxConeSize, &maxSupportSize);CHKERRQ(ierr);
179   if (faces) {ierr = DMGetWorkArray(dm, PetscSqr(PetscMax(maxConeSize, maxSupportSize)), MPIU_INT, &facesTmp);CHKERRQ(ierr);}
180   switch (dim) {
181   case 1:
182     switch (coneSize) {
183     case 2:
184       if (faces) {
185         facesTmp[0] = cone[0]; facesTmp[1] = cone[1];
186         *faces = facesTmp;
187       }
188       if (numFaces)     *numFaces = 2;
189       if (numFacesNotH) *numFacesNotH = 2;
190       if (faceSize)     *faceSize = 1;
191       break;
192     default:
193       SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Cone size %D not supported for dimension %D", coneSize, dim);
194     }
195     break;
196   case 2:
197     switch (coneSize) {
198     case 4:
199       if (faces) {
200         facesTmp[0] = cone[0]; facesTmp[1] = cone[1];
201         facesTmp[2] = cone[2]; facesTmp[3] = cone[3];
202         facesTmp[4] = cone[0]; facesTmp[5] = cone[2];
203         facesTmp[6] = cone[1]; facesTmp[7] = cone[3];
204         *faces = facesTmp;
205       }
206       if (numFaces)     *numFaces = 4;
207       if (numFacesNotH) *numFacesNotH = 2;
208       if (faceSize)     *faceSize = 2;
209       break;
210     default:
211       SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Cone size %D not supported for dimension %D", coneSize, dim);
212     }
213     break;
214   case 3:
215     switch (coneSize) {
216     case 6: /* triangular prism */
217       if (faces) {
218         facesTmp[0]  = cone[0]; facesTmp[1]  = cone[1]; facesTmp[2]  = cone[2]; facesTmp[3]  = -1;      /* Bottom */
219         facesTmp[4]  = cone[3]; facesTmp[5]  = cone[4]; facesTmp[6]  = cone[5]; facesTmp[7]  = -1;      /* Top */
220         facesTmp[8]  = cone[0]; facesTmp[9]  = cone[1]; facesTmp[10] = cone[3]; facesTmp[11] = cone[4]; /* Back left */
221         facesTmp[12] = cone[1]; facesTmp[13] = cone[2]; facesTmp[14] = cone[4]; facesTmp[15] = cone[5]; /* Back right */
222         facesTmp[16] = cone[2]; facesTmp[17] = cone[0]; facesTmp[18] = cone[5]; facesTmp[19] = cone[3]; /* Front */
223         *faces = facesTmp;
224       }
225       if (numFaces)     *numFaces = 5;
226       if (numFacesNotH) *numFacesNotH = 2;
227       if (faceSize)     *faceSize = -4;
228       break;
229     default:
230       SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Cone size %D not supported for dimension %D", coneSize, dim);
231     }
232     break;
233   default:
234     SETERRQ1(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Dimension %D not supported", dim);
235   }
236   PetscFunctionReturn(0);
237 }
238 
239 static PetscErrorCode DMPlexRestoreRawFacesHybrid_Internal(DM dm, PetscInt dim, PetscInt coneSize, const PetscInt cone[], PetscInt *numFaces, PetscInt *numFacesNotH, PetscInt *faceSize, const PetscInt *faces[])
240 {
241   PetscErrorCode  ierr;
242 
243   PetscFunctionBegin;
244   if (faces) { ierr = DMRestoreWorkArray(dm, 0, MPIU_INT, (void *) faces);CHKERRQ(ierr); }
245   PetscFunctionReturn(0);
246 }
247 
248 static PetscErrorCode DMPlexGetFacesHybrid_Internal(DM dm, PetscInt dim, PetscInt p, PetscInt *numFaces, PetscInt *numFacesNotH, PetscInt *faceSize, const PetscInt *faces[])
249 {
250   const PetscInt *cone = NULL;
251   PetscInt        coneSize;
252   PetscErrorCode  ierr;
253 
254   PetscFunctionBegin;
255   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
256   ierr = DMPlexGetConeSize(dm, p, &coneSize);CHKERRQ(ierr);
257   ierr = DMPlexGetCone(dm, p, &cone);CHKERRQ(ierr);
258   ierr = DMPlexGetRawFacesHybrid_Internal(dm, dim, coneSize, cone, numFaces, numFacesNotH, faceSize, faces);CHKERRQ(ierr);
259   PetscFunctionReturn(0);
260 }
261 
262 /* This interpolates faces for cells at some stratum */
263 static PetscErrorCode DMPlexInterpolateFaces_Internal(DM dm, PetscInt cellDepth, DM idm)
264 {
265   DMLabel        subpointMap;
266   PetscHashIJKL  faceTable;
267   PetscInt      *pStart, *pEnd;
268   PetscInt       cellDim, depth, faceDepth = cellDepth, numPoints = 0, faceSizeAll = 0, face, c, d;
269   PetscInt       coneSizeH = 0, faceSizeAllH = 0, numCellFacesH = 0, faceH, pMax = -1, dim, outerloop;
270   PetscInt       cMax, fMax, eMax, vMax;
271   PetscErrorCode ierr;
272 
273   PetscFunctionBegin;
274   ierr = DMGetDimension(dm, &cellDim);CHKERRQ(ierr);
275   /* HACK: I need a better way to determine face dimension, or an alternative to GetFaces() */
276   ierr = DMPlexGetSubpointMap(dm, &subpointMap);CHKERRQ(ierr);
277   if (subpointMap) ++cellDim;
278   ierr = DMPlexGetDepth(dm, &depth);CHKERRQ(ierr);
279   ++depth;
280   ++cellDepth;
281   cellDim -= depth - cellDepth;
282   ierr = PetscMalloc2(depth+1,&pStart,depth+1,&pEnd);CHKERRQ(ierr);
283   for (d = depth-1; d >= faceDepth; --d) {
284     ierr = DMPlexGetDepthStratum(dm, d, &pStart[d+1], &pEnd[d+1]);CHKERRQ(ierr);
285   }
286   ierr = DMPlexGetDepthStratum(dm, -1, NULL, &pStart[faceDepth]);CHKERRQ(ierr);
287   pEnd[faceDepth] = pStart[faceDepth];
288   for (d = faceDepth-1; d >= 0; --d) {
289     ierr = DMPlexGetDepthStratum(dm, d, &pStart[d], &pEnd[d]);CHKERRQ(ierr);
290   }
291   cMax = fMax = eMax = vMax = PETSC_DETERMINE;
292   ierr = DMGetDimension(dm, &dim);CHKERRQ(ierr);
293   if (cellDim == dim) {
294     ierr = DMPlexGetHybridBounds(dm, &cMax, NULL, NULL, NULL);CHKERRQ(ierr);
295     pMax = cMax;
296   } else if (cellDim == dim -1) {
297     ierr = DMPlexGetHybridBounds(dm, &cMax, &fMax, NULL, NULL);CHKERRQ(ierr);
298     pMax = fMax;
299   }
300   pMax = pMax < 0 ? pEnd[cellDepth] : pMax;
301   if (pMax < pEnd[cellDepth]) {
302     const PetscInt *cellFaces, *cone;
303     PetscInt        numCellFacesT, faceSize, cf;
304 
305     ierr = DMPlexGetConeSize(dm, pMax, &coneSizeH);CHKERRQ(ierr);
306     ierr = DMPlexGetCone(dm, pMax, &cone);CHKERRQ(ierr);
307     ierr = DMPlexGetRawFacesHybrid_Internal(dm, cellDim, coneSizeH, cone, &numCellFacesH, &numCellFacesT, &faceSize, &cellFaces);CHKERRQ(ierr);
308     if (faceSize < 0) {
309       PetscInt *sizes, minv, maxv;
310 
311       /* count vertices of hybrid and non-hybrid faces */
312       ierr = PetscCalloc1(numCellFacesH, &sizes);CHKERRQ(ierr);
313       for (cf = 0; cf < numCellFacesT; ++cf) { /* These are the non-hybrid faces */
314         const PetscInt *cellFace = &cellFaces[-cf*faceSize];
315         PetscInt       f;
316 
317         for (f = 0; f < -faceSize; ++f) sizes[cf] += (cellFace[f] >= 0 ? 1 : 0);
318       }
319       ierr = PetscSortInt(numCellFacesT, sizes);CHKERRQ(ierr);
320       minv = sizes[0];
321       maxv = sizes[PetscMax(numCellFacesT-1, 0)];
322       if (minv != maxv) SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_SUP, "Different number of vertices for non-hybrid face %D != %D", minv, maxv);
323       faceSizeAll = minv;
324       ierr = PetscMemzero(sizes, numCellFacesH*sizeof(PetscInt));CHKERRQ(ierr);
325       for (cf = numCellFacesT; cf < numCellFacesH; ++cf) { /* These are the hybrid faces */
326         const PetscInt *cellFace = &cellFaces[-cf*faceSize];
327         PetscInt       f;
328 
329         for (f = 0; f < -faceSize; ++f) sizes[cf-numCellFacesT] += (cellFace[f] >= 0 ? 1 : 0);
330       }
331       ierr = PetscSortInt(numCellFacesH - numCellFacesT, sizes);CHKERRQ(ierr);
332       minv = sizes[0];
333       maxv = sizes[PetscMax(numCellFacesH - numCellFacesT-1, 0)];
334       ierr = PetscFree(sizes);CHKERRQ(ierr);
335       if (minv != maxv) SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_SUP, "Different number of vertices for hybrid face %D != %D", minv, maxv);
336       faceSizeAllH = minv;
337     } else { /* the size of the faces in hybrid cells is the same */
338       faceSizeAll = faceSizeAllH = faceSize;
339     }
340     ierr = DMPlexRestoreRawFacesHybrid_Internal(dm, cellDim, coneSizeH, cone, &numCellFacesH, &numCellFacesT, &faceSize, &cellFaces);CHKERRQ(ierr);
341   } else if (pEnd[cellDepth] > pStart[cellDepth]) {
342     ierr = DMPlexGetFaces_Internal(dm, cellDim, pStart[cellDepth], NULL, &faceSizeAll, NULL);CHKERRQ(ierr);
343   }
344   if (faceSizeAll > 4) SETERRQ1(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Do not support interpolation of meshes with faces of %D vertices", faceSizeAll);
345 
346   /* With hybrid grids, we first iterate on hybrid cells and start numbering the non-hybrid grids
347      Then, faces for non-hybrid cells are numbered.
348      This is to guarantee consistent orientations (all 0) of all the points in the cone of the hybrid cells */
349   ierr = PetscHashIJKLCreate(&faceTable);CHKERRQ(ierr);
350   for (outerloop = 0, face = pStart[faceDepth]; outerloop < 2; outerloop++) {
351     PetscInt start, end;
352 
353     start = outerloop == 0 ? pMax : pStart[cellDepth];
354     end = outerloop == 0 ? pEnd[cellDepth] : pMax;
355     for (c = start; c < end; ++c) {
356       const PetscInt *cellFaces;
357       PetscInt        numCellFaces, faceSize, faceSizeInc, cf;
358 
359       if (c < pMax) {
360         ierr = DMPlexGetFaces_Internal(dm, cellDim, c, &numCellFaces, &faceSize, &cellFaces);CHKERRQ(ierr);
361         if (faceSize != faceSizeAll) SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Inconsistent face for cell %D of size %D != %D", c, faceSize, faceSizeAll);
362       } else { /* Hybrid cell */
363         const PetscInt *cone;
364         PetscInt        numCellFacesN, coneSize;
365 
366         ierr = DMPlexGetConeSize(dm, c, &coneSize);CHKERRQ(ierr);
367         if (coneSize != coneSizeH) SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_SUP, "Unexpected hybrid coneSize %D != %D", coneSize, coneSizeH);
368         ierr = DMPlexGetCone(dm, c, &cone);CHKERRQ(ierr);
369         ierr = DMPlexGetRawFacesHybrid_Internal(dm, cellDim, coneSize, cone, &numCellFaces, &numCellFacesN, &faceSize, &cellFaces);CHKERRQ(ierr);
370         if (numCellFaces != numCellFacesH) SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_SUP, "Unexpected numCellFaces %D != %D for hybrid cell %D", numCellFaces, numCellFacesH, c);
371         faceSize = PetscMax(faceSize, -faceSize);
372         if (faceSize > 4) SETERRQ1(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Do not support interpolation of meshes with faces of %D vertices", faceSize);
373         numCellFaces = numCellFacesN; /* process only non-hybrid faces */
374       }
375       faceSizeInc = faceSize;
376       for (cf = 0; cf < numCellFaces; ++cf) {
377         const PetscInt   *cellFace = &cellFaces[cf*faceSizeInc];
378         PetscInt          faceSizeH = faceSize;
379         PetscHashIJKLKey  key;
380         PetscHashIter     iter;
381         PetscBool         missing;
382 
383         if (faceSizeInc == 2) {
384           key.i = PetscMin(cellFace[0], cellFace[1]);
385           key.j = PetscMax(cellFace[0], cellFace[1]);
386           key.k = PETSC_MAX_INT;
387           key.l = PETSC_MAX_INT;
388         } else {
389           key.i = cellFace[0];
390           key.j = cellFace[1];
391           key.k = cellFace[2];
392           key.l = faceSize > 3 ? (cellFace[3] < 0 ? faceSizeH = 3, PETSC_MAX_INT : cellFace[3]) : PETSC_MAX_INT;
393           ierr  = PetscSortInt(faceSize, (PetscInt *) &key);CHKERRQ(ierr);
394         }
395         /* this check is redundant for non-hybrid meshes */
396         if (faceSizeH != faceSizeAll) SETERRQ4(PETSC_COMM_SELF, PETSC_ERR_SUP, "Unexpected number of vertices for face %D of point %D -> %D != %D", cf, c, faceSizeH, faceSizeAll);
397         ierr = PetscHashIJKLPut(faceTable, key, &iter, &missing);CHKERRQ(ierr);
398         if (missing) {ierr = PetscHashIJKLIterSet(faceTable, iter, face++);CHKERRQ(ierr);}
399       }
400       if (c < pMax) {
401         ierr = DMPlexRestoreFaces_Internal(dm, cellDim, c, &numCellFaces, &faceSize, &cellFaces);CHKERRQ(ierr);
402       } else {
403         ierr = DMPlexRestoreRawFacesHybrid_Internal(dm, cellDim, coneSizeH, NULL, NULL, NULL, NULL, &cellFaces);CHKERRQ(ierr);
404       }
405     }
406   }
407   pEnd[faceDepth] = face;
408 
409   /* Second pass for hybrid meshes: number hybrid faces */
410   for (c = pMax; c < pEnd[cellDepth]; ++c) {
411     const PetscInt *cellFaces, *cone;
412     PetscInt        numCellFaces, numCellFacesN, faceSize, cf, coneSize;
413 
414     ierr = DMPlexGetConeSize(dm, c, &coneSize);CHKERRQ(ierr);
415     ierr = DMPlexGetCone(dm, c, &cone);CHKERRQ(ierr);
416     ierr = DMPlexGetRawFacesHybrid_Internal(dm, cellDim, coneSize, cone, &numCellFaces, &numCellFacesN, &faceSize, &cellFaces);CHKERRQ(ierr);
417     if (numCellFaces != numCellFacesH) SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_SUP, "Unexpected hybrid numCellFaces %D != %D", numCellFaces, numCellFacesH);
418     faceSize = PetscMax(faceSize, -faceSize);
419     for (cf = numCellFacesN; cf < numCellFaces; ++cf) { /* These are the hybrid faces */
420       const PetscInt   *cellFace = &cellFaces[cf*faceSize];
421       PetscHashIJKLKey  key;
422       PetscHashIter     iter;
423       PetscBool         missing;
424       PetscInt          faceSizeH = faceSize;
425 
426       if (faceSize == 2) {
427         key.i = PetscMin(cellFace[0], cellFace[1]);
428         key.j = PetscMax(cellFace[0], cellFace[1]);
429         key.k = PETSC_MAX_INT;
430         key.l = PETSC_MAX_INT;
431       } else {
432         key.i = cellFace[0];
433         key.j = cellFace[1];
434         key.k = cellFace[2];
435         key.l = faceSize > 3 ? (cellFace[3] < 0 ? faceSizeH = 3, PETSC_MAX_INT : cellFace[3]) : PETSC_MAX_INT;
436         ierr  = PetscSortInt(faceSize, (PetscInt *) &key);CHKERRQ(ierr);
437       }
438       if (faceSizeH != faceSizeAllH) SETERRQ4(PETSC_COMM_SELF, PETSC_ERR_SUP, "Unexpected number of vertices for hybrid face %D of point %D -> %D != %D", cf, c, faceSizeH, faceSizeAllH);
439       ierr = PetscHashIJKLPut(faceTable, key, &iter, &missing);CHKERRQ(ierr);
440       if (missing) {ierr = PetscHashIJKLIterSet(faceTable, iter, face++);CHKERRQ(ierr);}
441     }
442     ierr = DMPlexRestoreRawFacesHybrid_Internal(dm, cellDim, coneSize, cone, &numCellFaces, &numCellFacesN, &faceSize, &cellFaces);CHKERRQ(ierr);
443   }
444   faceH = face - pEnd[faceDepth];
445   if (faceH) {
446     if (fMax == PETSC_DETERMINE) fMax = pEnd[faceDepth];
447     else if (eMax == PETSC_DETERMINE) eMax = pEnd[faceDepth];
448     else SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Number of unassigned hybrid facets %D for cellDim %D and dimension %D", faceH, cellDim, dim);
449   }
450   pEnd[faceDepth] = face;
451   ierr = PetscHashIJKLDestroy(&faceTable);CHKERRQ(ierr);
452   /* Count new points */
453   for (d = 0; d <= depth; ++d) {
454     numPoints += pEnd[d]-pStart[d];
455   }
456   ierr = DMPlexSetChart(idm, 0, numPoints);CHKERRQ(ierr);
457   /* Set cone sizes */
458   for (d = 0; d <= depth; ++d) {
459     PetscInt coneSize, p;
460 
461     if (d == faceDepth) {
462       /* I see no way to do this if we admit faces of different shapes */
463       for (p = pStart[d]; p < pEnd[d]-faceH; ++p) {
464         ierr = DMPlexSetConeSize(idm, p, faceSizeAll);CHKERRQ(ierr);
465       }
466       for (p = pEnd[d]-faceH; p < pEnd[d]; ++p) {
467         ierr = DMPlexSetConeSize(idm, p, faceSizeAllH);CHKERRQ(ierr);
468       }
469     } else if (d == cellDepth) {
470       for (p = pStart[d]; p < pEnd[d]; ++p) {
471         /* Number of cell faces may be different from number of cell vertices*/
472         if (p < pMax) {
473           ierr = DMPlexGetFaces_Internal(dm, cellDim, p, &coneSize, NULL, NULL);CHKERRQ(ierr);
474         } else {
475           ierr = DMPlexGetFacesHybrid_Internal(dm, cellDim, p, &coneSize, NULL, NULL, NULL);CHKERRQ(ierr);
476         }
477         ierr = DMPlexSetConeSize(idm, p, coneSize);CHKERRQ(ierr);
478       }
479     } else {
480       for (p = pStart[d]; p < pEnd[d]; ++p) {
481         ierr = DMPlexGetConeSize(dm, p, &coneSize);CHKERRQ(ierr);
482         ierr = DMPlexSetConeSize(idm, p, coneSize);CHKERRQ(ierr);
483       }
484     }
485   }
486   ierr = DMSetUp(idm);CHKERRQ(ierr);
487   /* Get face cones from subsets of cell vertices */
488   if (faceSizeAll > 4) SETERRQ1(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Do not support interpolation of meshes with faces of %D vertices", faceSizeAll);
489   ierr = PetscHashIJKLCreate(&faceTable);CHKERRQ(ierr);
490   for (d = depth; d > cellDepth; --d) {
491     const PetscInt *cone;
492     PetscInt        p;
493 
494     for (p = pStart[d]; p < pEnd[d]; ++p) {
495       ierr = DMPlexGetCone(dm, p, &cone);CHKERRQ(ierr);
496       ierr = DMPlexSetCone(idm, p, cone);CHKERRQ(ierr);
497       ierr = DMPlexGetConeOrientation(dm, p, &cone);CHKERRQ(ierr);
498       ierr = DMPlexSetConeOrientation(idm, p, cone);CHKERRQ(ierr);
499     }
500   }
501   for (outerloop = 0, face = pStart[faceDepth]; outerloop < 2; outerloop++) {
502     PetscInt start, end;
503 
504     start = outerloop == 0 ? pMax : pStart[cellDepth];
505     end = outerloop == 0 ? pEnd[cellDepth] : pMax;
506     for (c = start; c < end; ++c) {
507       const PetscInt *cellFaces;
508       PetscInt        numCellFaces, faceSize, faceSizeInc, cf;
509 
510       if (c < pMax) {
511         ierr = DMPlexGetFaces_Internal(dm, cellDim, c, &numCellFaces, &faceSize, &cellFaces);CHKERRQ(ierr);
512         if (faceSize != faceSizeAll) SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Inconsistent face for cell %D of size %D != %D", c, faceSize, faceSizeAll);
513       } else {
514         const PetscInt *cone;
515         PetscInt        numCellFacesN, coneSize;
516 
517         ierr = DMPlexGetConeSize(dm, c, &coneSize);CHKERRQ(ierr);
518         if (coneSize != coneSizeH) SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_SUP, "Unexpected hybrid coneSize %D != %D", coneSize, coneSizeH);
519         ierr = DMPlexGetCone(dm, c, &cone);CHKERRQ(ierr);
520         ierr = DMPlexGetRawFacesHybrid_Internal(dm, cellDim, coneSize, cone, &numCellFaces, &numCellFacesN, &faceSize, &cellFaces);CHKERRQ(ierr);
521         if (numCellFaces != numCellFacesH) SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_SUP, "Unexpected numCellFaces %D != %D for hybrid cell %D", numCellFaces, numCellFacesH, c);
522         faceSize = PetscMax(faceSize, -faceSize);
523         if (faceSize > 4) SETERRQ1(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Do not support interpolation of meshes with faces of %D vertices", faceSize);
524         numCellFaces = numCellFacesN; /* process only non-hybrid faces */
525       }
526       faceSizeInc = faceSize;
527       for (cf = 0; cf < numCellFaces; ++cf) {
528         const PetscInt  *cellFace = &cellFaces[cf*faceSizeInc];
529         PetscHashIJKLKey key;
530         PetscHashIter    iter;
531         PetscBool        missing;
532 
533         if (faceSizeInc == 2) {
534           key.i = PetscMin(cellFace[0], cellFace[1]);
535           key.j = PetscMax(cellFace[0], cellFace[1]);
536           key.k = PETSC_MAX_INT;
537           key.l = PETSC_MAX_INT;
538         } else {
539           key.i = cellFace[0];
540           key.j = cellFace[1];
541           key.k = cellFace[2];
542           key.l = faceSizeInc > 3 ? (cellFace[3] < 0 ? faceSize = 3, PETSC_MAX_INT : cellFace[3]) : PETSC_MAX_INT;
543           ierr  = PetscSortInt(faceSizeInc, (PetscInt *) &key);CHKERRQ(ierr);
544         }
545         ierr = PetscHashIJKLPut(faceTable, key, &iter, &missing);CHKERRQ(ierr);
546         if (missing) {
547           ierr = DMPlexSetCone(idm, face, cellFace);CHKERRQ(ierr);
548           ierr = PetscHashIJKLIterSet(faceTable, iter, face);CHKERRQ(ierr);
549           ierr = DMPlexInsertCone(idm, c, cf, face++);CHKERRQ(ierr);
550         } else {
551           const PetscInt *cone;
552           PetscInt        coneSize, ornt, i, j, f;
553 
554           ierr = PetscHashIJKLIterGet(faceTable, iter, &f);CHKERRQ(ierr);
555           ierr = DMPlexInsertCone(idm, c, cf, f);CHKERRQ(ierr);
556           /* Orient face: Do not allow reverse orientation at the first vertex */
557           ierr = DMPlexGetConeSize(idm, f, &coneSize);CHKERRQ(ierr);
558           ierr = DMPlexGetCone(idm, f, &cone);CHKERRQ(ierr);
559           if (coneSize != faceSize) SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Invalid number of face vertices %D for face %D should be %D", coneSize, f, faceSize);
560           /* - First find the initial vertex */
561           for (i = 0; i < faceSize; ++i) if (cellFace[0] == cone[i]) break;
562           /* - Try forward comparison */
563           for (j = 0; j < faceSize; ++j) if (cellFace[j] != cone[(i+j)%faceSize]) break;
564           if (j == faceSize) {
565             if ((faceSize == 2) && (i == 1)) ornt = -2;
566             else                             ornt = i;
567           } else {
568             /* - Try backward comparison */
569             for (j = 0; j < faceSize; ++j) if (cellFace[j] != cone[(i+faceSize-j)%faceSize]) break;
570             if (j == faceSize) {
571               if (i == 0) ornt = -faceSize;
572               else        ornt = -i;
573             } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Could not determine face orientation");
574           }
575           ierr = DMPlexInsertConeOrientation(idm, c, cf, ornt);CHKERRQ(ierr);
576         }
577       }
578       if (c < pMax) {
579         ierr = DMPlexRestoreFaces_Internal(dm, cellDim, c, &numCellFaces, &faceSize, &cellFaces);CHKERRQ(ierr);
580       } else {
581         ierr = DMPlexRestoreRawFacesHybrid_Internal(dm, cellDim, coneSizeH, NULL, NULL, NULL, NULL, &cellFaces);CHKERRQ(ierr);
582       }
583     }
584   }
585   /* Second pass for hybrid meshes: orient hybrid faces */
586   for (c = pMax; c < pEnd[cellDepth]; ++c) {
587     const PetscInt *cellFaces, *cone;
588     PetscInt        numCellFaces, numCellFacesN, faceSize, cf, coneSize;
589 
590     ierr = DMPlexGetConeSize(dm, c, &coneSize);CHKERRQ(ierr);
591     ierr = DMPlexGetCone(dm, c, &cone);CHKERRQ(ierr);
592     ierr = DMPlexGetRawFacesHybrid_Internal(dm, cellDim, coneSize, cone, &numCellFaces, &numCellFacesN, &faceSize, &cellFaces);CHKERRQ(ierr);
593     if (numCellFaces != numCellFacesH) SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_SUP, "Unexpected hybrid numCellFaces %D != %D", numCellFaces, numCellFacesH);
594     faceSize = PetscMax(faceSize, -faceSize);
595     for (cf = numCellFacesN; cf < numCellFaces; ++cf) { /* These are the hybrid faces */
596       const PetscInt   *cellFace = &cellFaces[cf*faceSize];
597       PetscHashIJKLKey key;
598       PetscHashIter    iter;
599       PetscBool        missing;
600       PetscInt         faceSizeH = faceSize;
601 
602       if (faceSize == 2) {
603         key.i = PetscMin(cellFace[0], cellFace[1]);
604         key.j = PetscMax(cellFace[0], cellFace[1]);
605         key.k = PETSC_MAX_INT;
606         key.l = PETSC_MAX_INT;
607       } else {
608         key.i = cellFace[0];
609         key.j = cellFace[1];
610         key.k = cellFace[2];
611         key.l = faceSize > 3 ? (cellFace[3] < 0 ? faceSizeH = 3, PETSC_MAX_INT : cellFace[3]) : PETSC_MAX_INT;
612         ierr  = PetscSortInt(faceSize, (PetscInt *) &key);CHKERRQ(ierr);
613       }
614       if (faceSizeH != faceSizeAllH) SETERRQ4(PETSC_COMM_SELF, PETSC_ERR_SUP, "Unexpected number of vertices for hybrid face %D of point %D -> %D != %D", cf, c, faceSizeH, faceSizeAllH);
615       ierr = PetscHashIJKLPut(faceTable, key, &iter, &missing);CHKERRQ(ierr);
616       if (missing) {
617         ierr = DMPlexSetCone(idm, face, cellFace);CHKERRQ(ierr);
618         ierr = PetscHashIJKLIterSet(faceTable, iter, face);CHKERRQ(ierr);
619         ierr = DMPlexInsertCone(idm, c, cf, face++);CHKERRQ(ierr);
620       } else {
621         const PetscInt *cone;
622         PetscInt        coneSize, ornt, i, j, f;
623 
624         ierr = PetscHashIJKLIterGet(faceTable, iter, &f);CHKERRQ(ierr);
625         ierr = DMPlexInsertCone(idm, c, cf, f);CHKERRQ(ierr);
626         /* Orient face: Do not allow reverse orientation at the first vertex */
627         ierr = DMPlexGetConeSize(idm, f, &coneSize);CHKERRQ(ierr);
628         ierr = DMPlexGetCone(idm, f, &cone);CHKERRQ(ierr);
629         if (coneSize != faceSizeH) SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Invalid number of face vertices %D for face %D should be %D", coneSize, f, faceSizeH);
630         /* - First find the initial vertex */
631         for (i = 0; i < faceSizeH; ++i) if (cellFace[0] == cone[i]) break;
632         /* - Try forward comparison */
633         for (j = 0; j < faceSizeH; ++j) if (cellFace[j] != cone[(i+j)%faceSizeH]) break;
634         if (j == faceSizeH) {
635           if ((faceSizeH == 2) && (i == 1)) ornt = -2;
636           else                             ornt = i;
637         } else {
638           /* - Try backward comparison */
639           for (j = 0; j < faceSizeH; ++j) if (cellFace[j] != cone[(i+faceSizeH-j)%faceSizeH]) break;
640           if (j == faceSizeH) {
641             if (i == 0) ornt = -faceSizeH;
642             else        ornt = -i;
643           } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Could not determine face orientation");
644         }
645         ierr = DMPlexInsertConeOrientation(idm, c, cf, ornt);CHKERRQ(ierr);
646       }
647     }
648     ierr = DMPlexRestoreRawFacesHybrid_Internal(dm, cellDim, coneSize, cone, &numCellFaces, &numCellFacesN, &faceSize, &cellFaces);CHKERRQ(ierr);
649   }
650   if (face != pEnd[faceDepth]) SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Invalid number of faces %D should be %D", face-pStart[faceDepth], pEnd[faceDepth]-pStart[faceDepth]);
651   ierr = PetscFree2(pStart,pEnd);CHKERRQ(ierr);
652   ierr = PetscHashIJKLDestroy(&faceTable);CHKERRQ(ierr);
653   ierr = PetscFree2(pStart,pEnd);CHKERRQ(ierr);
654   ierr = DMPlexSetHybridBounds(idm, cMax, fMax, eMax, vMax);CHKERRQ(ierr);
655   ierr = DMPlexSymmetrize(idm);CHKERRQ(ierr);
656   ierr = DMPlexStratify(idm);CHKERRQ(ierr);
657   PetscFunctionReturn(0);
658 }
659 
660 PetscErrorCode DMPlexOrientCell(DM dm, PetscInt p, PetscInt masterConeSize, const PetscInt masterCone[])
661 {
662   PetscInt c, coneSize;
663   PetscInt start1;
664   PetscBool reverse1;
665   const PetscInt *cone;
666   PetscErrorCode ierr;
667 
668   PetscFunctionBegin;
669   ierr = DMPlexGetConeSize(dm, p, &coneSize);CHKERRQ(ierr);
670   if (!coneSize) PetscFunctionReturn(0); /* do nothing for points with no cone */
671   ierr = DMPlexGetCone(dm, p, &cone);CHKERRQ(ierr);
672   ierr = DMPlexFixFaceOrientations_Orient_Private(coneSize, masterConeSize, masterCone, cone, &start1, &reverse1);CHKERRQ(ierr);
673 #if defined(PETSC_USE_DEBUG)
674   if (PetscUnlikely(cone[start1] != masterCone[0])) SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_PLIB, "The algorithm above is wrong as cone[%d] = %d != %d = masterCone[0]", start1, cone[start1], masterCone[0]);
675 #endif
676   ierr = DMPlexOrientCell_Internal(dm, p, start1, reverse1);CHKERRQ(ierr);
677 #if defined(PETSC_USE_DEBUG)
678   ierr = DMPlexGetCone(dm, p, &cone);CHKERRQ(ierr);
679   for (c = 0; c < 2; c++) {
680     if (PetscUnlikely(cone[c] != masterCone[c])) SETERRQ4(PETSC_COMM_SELF, PETSC_ERR_PLIB, "The algorithm above is wrong as cone[%d] = %d != %d = masterCone[%d]", c, cone[c], masterCone[c], c);
681   }
682 #endif
683   PetscFunctionReturn(0);
684 }
685 
686 PetscErrorCode DMPlexOrientCell_Internal(DM dm, PetscInt p, PetscInt start1, PetscInt reverse1)
687 {
688   PetscInt i, j, k, maxConeSize, coneSize, coneConeSize, supportSize, supportConeSize;
689   PetscInt start0, start;
690   PetscBool reverse0, reverse;
691   PetscInt newornt;
692   const PetscInt *cone, *support, *supportCone, *ornts;
693   PetscInt *newcone, *newornts;
694   PetscErrorCode ierr;
695 
696   PetscFunctionBegin;
697   if (!start1 && !reverse1) PetscFunctionReturn(0);
698   ierr = DMPlexGetConeSize(dm, p, &coneSize);CHKERRQ(ierr);
699   if (!coneSize) PetscFunctionReturn(0); /* do nothing for points with no cone */
700   ierr = DMPlexGetCone(dm, p, &cone);CHKERRQ(ierr);
701   ierr = DMPlexGetMaxSizes(dm, &maxConeSize, NULL);CHKERRQ(ierr);
702   /* permute p's cone and orientations */
703   ierr = DMPlexGetConeOrientation(dm, p, &ornts);CHKERRQ(ierr);
704   ierr = DMGetWorkArray(dm, maxConeSize, MPIU_INT, &newcone);CHKERRQ(ierr);
705   ierr = DMGetWorkArray(dm, maxConeSize, MPIU_INT, &newornts);CHKERRQ(ierr);
706   ierr = DMPlexFixFaceOrientations_Permute_Private(coneSize, cone, start1, reverse1, newcone);CHKERRQ(ierr);
707   ierr = DMPlexFixFaceOrientations_Permute_Private(coneSize, ornts, start1, reverse1, newornts);CHKERRQ(ierr);
708   /* if direction of p (face) is flipped, flip also p's cone points (edges) */
709   if (reverse1) {
710     for (i=0; i<coneSize; i++) {
711       ierr = DMPlexGetConeSize(dm, cone[i], &coneConeSize);CHKERRQ(ierr);
712       ierr = DMPlexFixFaceOrientations_Translate_Private(newornts[i], &start0, &reverse0);CHKERRQ(ierr);
713       ierr = DMPlexFixFaceOrientations_Combine_Private(coneConeSize, start0, reverse0, 1, PETSC_FALSE, &start, &reverse);CHKERRQ(ierr);
714       ierr = DMPlexFixFaceOrientations_TranslateBack_Private(coneConeSize, start, reverse, &newornts[i]);CHKERRQ(ierr);
715     }
716   }
717   ierr = DMPlexSetConeOrientation(dm, p, newornts);CHKERRQ(ierr);
718   /* fix oriention of p within cones of p's support points */
719   ierr = DMPlexGetSupport(dm, p, &support);CHKERRQ(ierr);
720   ierr = DMPlexGetSupportSize(dm, p, &supportSize);CHKERRQ(ierr);
721   for (j=0; j<supportSize; j++) {
722     ierr = DMPlexGetCone(dm, support[j], &supportCone);CHKERRQ(ierr);
723     ierr = DMPlexGetConeSize(dm, support[j], &supportConeSize);CHKERRQ(ierr);
724     ierr = DMPlexGetConeOrientation(dm, support[j], &ornts);CHKERRQ(ierr);
725     for (k=0; k<supportConeSize; k++) {
726       if (supportCone[k] != p) continue;
727       ierr = DMPlexFixFaceOrientations_Translate_Private(ornts[k], &start0, &reverse0);CHKERRQ(ierr);
728       ierr = DMPlexFixFaceOrientations_Combine_Private(coneSize, start0, reverse0, start1, reverse1, &start, &reverse);CHKERRQ(ierr);
729       ierr = DMPlexFixFaceOrientations_TranslateBack_Private(coneSize, start, reverse, &newornt);CHKERRQ(ierr);
730       ierr = DMPlexInsertConeOrientation(dm, support[j], k, newornt);CHKERRQ(ierr);
731     }
732   }
733   /* rewrite cone */
734   ierr = DMPlexSetCone(dm, p, newcone);CHKERRQ(ierr);
735   ierr = DMRestoreWorkArray(dm, maxConeSize, MPIU_INT, &newcone);CHKERRQ(ierr);
736   ierr = DMRestoreWorkArray(dm, maxConeSize, MPIU_INT, &newornts);CHKERRQ(ierr);
737   PetscFunctionReturn(0);
738 }
739 
740 static PetscErrorCode SortRmineRremoteByRemote_Private(PetscSF sf, PetscInt *rmine1[], PetscInt *rremote1[])
741 {
742   PetscInt            nleaves;
743   PetscInt            nranks;
744   const PetscMPIInt   *ranks;
745   const PetscInt      *roffset, *rmine, *rremote;
746   PetscInt            n, o, r;
747   PetscErrorCode      ierr;
748 
749   PetscFunctionBegin;
750   ierr = PetscSFGetRanks(sf, &nranks, &ranks, &roffset, &rmine, &rremote);CHKERRQ(ierr);
751   nleaves = roffset[nranks];
752   ierr = PetscMalloc2(nleaves, rmine1, nleaves, rremote1);CHKERRQ(ierr);
753   for (r=0; r<nranks; r++) {
754     /* simultaneously sort rank-wise portions of rmine & rremote by values in rremote
755        - to unify order with the other side */
756     o = roffset[r];
757     n = roffset[r+1] - o;
758     ierr = PetscMemcpy(&(*rmine1)[o], &rmine[o], n*sizeof(PetscInt));CHKERRQ(ierr);
759     ierr = PetscMemcpy(&(*rremote1)[o], &rremote[o], n*sizeof(PetscInt));CHKERRQ(ierr);
760     ierr = PetscSortIntWithArray(n, &(*rremote1)[o], &(*rmine1)[o]);CHKERRQ(ierr);
761   }
762   PetscFunctionReturn(0);
763 }
764 
765 PetscErrorCode DMPlexOrientInterface(DM dm)
766 {
767   PetscSF           sf;
768   PetscInt          (*roots)[2], (*leaves)[2];
769   PetscMPIInt       (*rootsRanks)[2], (*leavesRanks)[2];
770   const PetscInt    *locals;
771   const PetscSFNode *remotes;
772   PetscInt           nroots, nleaves, p, c;
773   PetscInt           nranks, n, o, r;
774   const PetscMPIInt *ranks;
775   const PetscInt    *roffset;
776   PetscInt          *rmine1, *rremote1; /* rmine and rremote copies simultaneously sorted by rank and rremote */
777   const PetscInt    *cone;
778   PetscInt           coneSize, ind0;
779   MPI_Comm           comm;
780   PetscMPIInt        rank;
781   PetscInt           debug = 0;
782   PetscErrorCode     ierr;
783 
784   PetscFunctionBegin;
785   ierr = DMGetPointSF(dm, &sf);CHKERRQ(ierr);
786   ierr = PetscSFGetGraph(sf, &nroots, &nleaves, &locals, &remotes);CHKERRQ(ierr);
787   if (nroots < 0) PetscFunctionReturn(0);
788   ierr = PetscSFSetUp(sf);CHKERRQ(ierr);
789   ierr = PetscSFGetRanks(sf, &nranks, &ranks, &roffset, NULL, NULL);CHKERRQ(ierr);
790 #if defined(PETSC_USE_DEBUG)
791   ierr = DMViewFromOptions(dm, NULL, "-before_fix_dm_view");CHKERRQ(ierr);
792   ierr = DMPlexCheckPointSF(dm);CHKERRQ(ierr);
793 #endif
794   ierr = SortRmineRremoteByRemote_Private(sf, &rmine1, &rremote1);CHKERRQ(ierr);
795   ierr = PetscMalloc4(nroots, &roots, nroots, &leaves, nroots, &rootsRanks, nroots, &leavesRanks);CHKERRQ(ierr);
796   ierr = PetscObjectGetComm((PetscObject) dm, &comm);CHKERRQ(ierr);
797   ierr = MPI_Comm_rank(comm, &rank);CHKERRQ(ierr);
798   if (debug && rank == 0) {ierr = PetscSynchronizedPrintf(comm, "Roots\n");CHKERRQ(ierr);}
799   for (p = 0; p < nroots; ++p) {
800     ierr = DMPlexGetConeSize(dm, p, &coneSize);CHKERRQ(ierr);
801     ierr = DMPlexGetCone(dm, p, &cone);CHKERRQ(ierr);
802     /* Translate all points to root numbering */
803     for (c = 0; c < 2; c++) {
804       if (coneSize > 1) {
805         ierr = PetscFindInt(cone[c], nleaves, locals, &ind0);CHKERRQ(ierr);
806         if (ind0 < 0) {
807           roots[p][c] = cone[c];
808           rootsRanks[p][c] = rank;
809         } else {
810           roots[p][c] = remotes[ind0].index;
811           rootsRanks[p][c] = remotes[ind0].rank;
812         }
813       } else {
814         roots[p][c] = -1;
815         rootsRanks[p][c] = -1;
816       }
817     }
818   }
819   if (debug) {
820     for (p = 0; p < nroots; ++p) {
821       ierr = DMPlexGetConeSize(dm, p, &coneSize);CHKERRQ(ierr);
822       ierr = DMPlexGetCone(dm, p, &cone);CHKERRQ(ierr);
823       if (coneSize > 1) {
824         ierr = PetscSynchronizedPrintf(comm, "[%d]  %D: cone=[%D %D] roots=[%D %D] rootsRanks=[%D %D]\n", rank, p, cone[0], cone[1], roots[p][0], roots[p][1], rootsRanks[p][0], rootsRanks[p][1]);CHKERRQ(ierr);
825       }
826     }
827     ierr = PetscSynchronizedFlush(comm, NULL);CHKERRQ(ierr);
828   }
829   for (p = 0; p < nroots; ++p) {
830     for (c = 0; c < 2; c++) {
831       leaves[p][c] = -2;
832       leavesRanks[p][c] = -2;
833     }
834   }
835   ierr = PetscSFBcastBegin(sf, MPIU_2INT, roots, leaves);CHKERRQ(ierr);
836   ierr = PetscSFBcastBegin(sf, MPI_2INT, rootsRanks, leavesRanks);CHKERRQ(ierr);
837   ierr = PetscSFBcastEnd(sf, MPIU_2INT, roots, leaves);CHKERRQ(ierr);
838   ierr = PetscSFBcastEnd(sf, MPI_2INT, rootsRanks, leavesRanks);CHKERRQ(ierr);
839   if (debug) {ierr = PetscSynchronizedFlush(comm, NULL);CHKERRQ(ierr);}
840   if (debug && rank == 0) {ierr = PetscSynchronizedPrintf(comm, "Referred leaves\n");CHKERRQ(ierr);}
841   for (p = 0; p < nroots; ++p) {
842     if (leaves[p][0] < 0) continue;
843     ierr = DMPlexGetConeSize(dm, p, &coneSize);CHKERRQ(ierr);
844     ierr = DMPlexGetCone(dm, p, &cone);CHKERRQ(ierr);
845     if (debug) {ierr = PetscSynchronizedPrintf(comm, "[%d]  %D: cone=[%D %D] leaves=[%D %D] roots=[%D %D] leavesRanks=[%D %D] rootsRanks=[%D %D]\n", rank, p, cone[0], cone[1], leaves[p][0], leaves[p][1], roots[p][0], roots[p][1], leavesRanks[p][0], leavesRanks[p][1], rootsRanks[p][0], rootsRanks[p][1]);CHKERRQ(ierr);}
846     if ((leaves[p][0] != roots[p][0]) || (leaves[p][1] != roots[p][1]) || (leavesRanks[p][0] != rootsRanks[p][0]) || (leavesRanks[p][0] != rootsRanks[p][0])) {
847       PetscInt masterCone[2];
848       /* Translate these two cone points back to leave numbering */
849       for (c = 0; c < 2; c++) {
850         if (leavesRanks[p][c] == rank) SETERRQ1(PETSC_COMM_SELF, PETSC_ERR_PLIB, "this should never happen - remote rank of point %D is the same rank",leavesRanks[p][c]);
851         /* Find index of rank leavesRanks[p][c] among remote ranks */
852         /* No need for PetscMPIIntCast because these integers were originally cast from PetscMPIInt. */
853         ierr = PetscFindMPIInt((PetscMPIInt)leavesRanks[p][c], nranks, ranks, &r);CHKERRQ(ierr);
854         if (PetscUnlikely(r < 0)) SETERRQ1(PETSC_COMM_SELF, PETSC_ERR_PLIB, "this should never happen - rank %D not found among remote ranks",leavesRanks[p][c]);
855         /* Find point leaves[p][c] among remote points aimed at rank leavesRanks[p][c] */
856         o = roffset[r];
857         n = roffset[r+1] - o;
858         ierr = PetscFindInt(leaves[p][c], n, &rremote1[o], &ind0);CHKERRQ(ierr);
859         if (PetscUnlikely(ind0 < 0)) SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_PLIB, "No cone point of %D is connected to (%D, %D) - it seems there is missing connection in point SF!",p,ranks[r],leaves[p][c]);
860         /* Get the corresponding local point */
861         masterCone[c] = rmine1[o+ind0];CHKERRQ(ierr);
862       }
863       if (debug) {ierr = PetscSynchronizedPrintf(comm, "[%d]  %D: masterCone=[%D %D]\n", rank, p, masterCone[0], masterCone[1]);CHKERRQ(ierr);}
864       /* Vaclav's note: Here we only compare first 2 points of the cone. Full cone size would lead to stronger self-checking. */
865       ierr = DMPlexOrientCell(dm, p, 2, masterCone);CHKERRQ(ierr);
866     }
867   }
868 #if defined(PETSC_USE_DEBUG)
869   ierr = DMViewFromOptions(dm, NULL, "-after_fix_dm_view");CHKERRQ(ierr);
870   for (r = 0; r < nleaves; ++r) {
871     p = locals[r];
872     ierr = DMPlexGetConeSize(dm, p, &coneSize);CHKERRQ(ierr);
873     if (!coneSize) continue;
874     ierr = DMPlexGetCone(dm, p, &cone);CHKERRQ(ierr);
875     for (c = 0; c < 2; c++) {
876       ierr = PetscFindInt(cone[c], nleaves, locals, &ind0);CHKERRQ(ierr);
877       if (ind0 < 0) SETERRQ3(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Point SF contains %D but is missing its cone point cone[%D] = %D!", p, c, cone[c]);
878       if (leaves[p][c] != remotes[ind0].index || leavesRanks[p][c] != remotes[ind0].rank) {
879         if (leavesRanks[p][c] == rank) {
880           PetscInt ind1;
881           ierr = PetscFindInt(leaves[p][c], nleaves, locals, &ind1);CHKERRQ(ierr);
882           if (ind1 < 0) {
883             SETERRQ8(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Point %D = locals[%d]: cone[%D]=%D --> (%D, %D) differs from the enforced (%D, %D). The latter was not even found among the local SF points - it is probably broken!", p, r, c, cone[c], remotes[ind0].rank, remotes[ind0].index, leavesRanks[p][c], leaves[p][c]);
884           } else {
885             SETERRQ9(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Point %D = locals[%d]: cone[%D]=%D --> (%D, %D) differs from the enforced %D --> (%D, %D). Is the algorithm above or the point SF broken?", p, r, c, cone[c], remotes[ind0].rank, remotes[ind0].index, leaves[p][c], remotes[ind1].rank, remotes[ind1].index);
886           }
887         } else {
888           SETERRQ8(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Point %D = locals[%d]: cone[%D]=%D --> (%D, %D) differs from the enforced (%D, %D). Is the algorithm above or the point SF broken?", p, r, c, cone[c], remotes[ind0].rank, remotes[ind0].index, leavesRanks[p][c], leaves[p][c]);
889         }
890       }
891     }
892   }
893 #endif
894   if (debug) {ierr = PetscSynchronizedFlush(comm, NULL);CHKERRQ(ierr);}
895   ierr = PetscFree4(roots, leaves, rootsRanks, leavesRanks);CHKERRQ(ierr);
896   PetscFunctionReturn(0);
897 }
898 
899 /* This interpolates the PointSF in parallel following local interpolation */
900 static PetscErrorCode DMPlexInterpolatePointSF(DM dm, PetscSF pointSF, PetscInt depth)
901 {
902   PetscMPIInt        size, rank;
903   PetscInt           p, c, d, dof, offset;
904   PetscInt           numLeaves, numRoots, candidatesSize, candidatesRemoteSize;
905   const PetscInt    *localPoints;
906   const PetscSFNode *remotePoints;
907   PetscSFNode       *candidates, *candidatesRemote, *claims;
908   PetscSection       candidateSection, candidateSectionRemote, claimSection;
909   PetscHMapI         leafhash;
910   PetscHMapIJ        roothash;
911   PetscHashIJKey     key;
912   PetscErrorCode     ierr;
913 
914   PetscFunctionBegin;
915   ierr = MPI_Comm_size(PetscObjectComm((PetscObject) dm), &size);CHKERRQ(ierr);
916   ierr = MPI_Comm_rank(PetscObjectComm((PetscObject) dm), &rank);CHKERRQ(ierr);
917   ierr = PetscSFGetGraph(pointSF, &numRoots, &numLeaves, &localPoints, &remotePoints);CHKERRQ(ierr);
918   if (size < 2 || numRoots < 0) PetscFunctionReturn(0);
919   ierr = PetscLogEventBegin(DMPLEX_InterpolateSF,dm,0,0,0);CHKERRQ(ierr);
920   /* Build hashes of points in the SF for efficient lookup */
921   ierr = PetscHMapICreate(&leafhash);CHKERRQ(ierr);
922   ierr = PetscHMapIJCreate(&roothash);CHKERRQ(ierr);
923   for (p = 0; p < numLeaves; ++p) {
924     ierr = PetscHMapISet(leafhash, localPoints[p], p);CHKERRQ(ierr);
925     key.i = remotePoints[p].index;
926     key.j = remotePoints[p].rank;
927     ierr = PetscHMapIJSet(roothash, key, p);CHKERRQ(ierr);
928   }
929   /* Build a section / SFNode array of candidate points in the single-level adjacency of leaves,
930      where each candidate is defined by the root entry for the other vertex that defines the edge. */
931   ierr = PetscSectionCreate(PetscObjectComm((PetscObject) dm), &candidateSection);CHKERRQ(ierr);
932   ierr = PetscSectionSetChart(candidateSection, 0, numRoots);CHKERRQ(ierr);
933   {
934     PetscInt leaf, root, idx, a, *adj = NULL;
935     for (p = 0; p < numLeaves; ++p) {
936       PetscInt adjSize = PETSC_DETERMINE;
937       ierr = DMPlexGetAdjacency_Internal(dm, localPoints[p], PETSC_FALSE, PETSC_FALSE, PETSC_FALSE, &adjSize, &adj);CHKERRQ(ierr);
938       for (a = 0; a < adjSize; ++a) {
939         ierr = PetscHMapIGet(leafhash, adj[a], &leaf);CHKERRQ(ierr);
940         if (leaf >= 0) {ierr = PetscSectionAddDof(candidateSection, localPoints[p], 1);CHKERRQ(ierr);}
941       }
942     }
943     ierr = PetscSectionSetUp(candidateSection);CHKERRQ(ierr);
944     ierr = PetscSectionGetStorageSize(candidateSection, &candidatesSize);CHKERRQ(ierr);
945     ierr = PetscMalloc1(candidatesSize, &candidates);CHKERRQ(ierr);
946     for (p = 0; p < numLeaves; ++p) {
947       PetscInt adjSize = PETSC_DETERMINE;
948       ierr = PetscSectionGetOffset(candidateSection, localPoints[p], &offset);CHKERRQ(ierr);
949       ierr = DMPlexGetAdjacency_Internal(dm, localPoints[p], PETSC_FALSE, PETSC_FALSE, PETSC_FALSE, &adjSize, &adj);CHKERRQ(ierr);
950       for (idx = 0, a = 0; a < adjSize; ++a) {
951         ierr = PetscHMapIGet(leafhash, adj[a], &root);CHKERRQ(ierr);
952         if (root >= 0) candidates[offset+idx++] = remotePoints[root];
953       }
954     }
955     ierr = PetscFree(adj);CHKERRQ(ierr);
956   }
957   /* Gather candidate section / array pair into the root partition via inverse(multi(pointSF)). */
958   {
959     PetscSF   sfMulti, sfInverse, sfCandidates;
960     PetscInt *remoteOffsets;
961     ierr = PetscSFGetMultiSF(pointSF, &sfMulti);CHKERRQ(ierr);
962     ierr = PetscSFCreateInverseSF(sfMulti, &sfInverse);CHKERRQ(ierr);
963     ierr = PetscSectionCreate(PetscObjectComm((PetscObject) dm), &candidateSectionRemote);CHKERRQ(ierr);
964     ierr = PetscSFDistributeSection(sfInverse, candidateSection, &remoteOffsets, candidateSectionRemote);CHKERRQ(ierr);
965     ierr = PetscSFCreateSectionSF(sfInverse, candidateSection, remoteOffsets, candidateSectionRemote, &sfCandidates);CHKERRQ(ierr);
966     ierr = PetscSectionGetStorageSize(candidateSectionRemote, &candidatesRemoteSize);CHKERRQ(ierr);
967     ierr = PetscMalloc1(candidatesRemoteSize, &candidatesRemote);CHKERRQ(ierr);
968     ierr = PetscSFBcastBegin(sfCandidates, MPIU_2INT, candidates, candidatesRemote);CHKERRQ(ierr);
969     ierr = PetscSFBcastEnd(sfCandidates, MPIU_2INT, candidates, candidatesRemote);CHKERRQ(ierr);
970     ierr = PetscSFDestroy(&sfInverse);CHKERRQ(ierr);
971     ierr = PetscSFDestroy(&sfCandidates);CHKERRQ(ierr);
972     ierr = PetscFree(remoteOffsets);CHKERRQ(ierr);
973   }
974   /* Walk local roots and check for each remote candidate whether we know all required points,
975      either from owning it or having a root entry in the point SF. If we do we place a claim
976      by replacing the vertex number with our edge ID. */
977   {
978     PetscInt        idx, root, joinSize, vertices[2];
979     const PetscInt *rootdegree, *join = NULL;
980     ierr = PetscSFComputeDegreeBegin(pointSF, &rootdegree);CHKERRQ(ierr);
981     ierr = PetscSFComputeDegreeEnd(pointSF, &rootdegree);CHKERRQ(ierr);
982     /* Loop remote edge connections and put in a claim if both vertices are known */
983     for (idx = 0, p = 0; p < numRoots; ++p) {
984       for (d = 0; d < rootdegree[p]; ++d) {
985         ierr = PetscSectionGetDof(candidateSectionRemote, idx, &dof);CHKERRQ(ierr);
986         ierr = PetscSectionGetOffset(candidateSectionRemote, idx, &offset);CHKERRQ(ierr);
987         for (c = 0; c < dof; ++c) {
988           /* We own both vertices, so we claim the edge by replacing vertex with edge */
989           if (candidatesRemote[offset+c].rank == rank) {
990             vertices[0] = p; vertices[1] = candidatesRemote[offset+c].index;
991             ierr = DMPlexGetJoin(dm, 2, vertices, &joinSize, &join);CHKERRQ(ierr);
992             if (joinSize == 1) candidatesRemote[offset+c].index = join[0];
993             ierr = DMPlexRestoreJoin(dm, 2, vertices, &joinSize, &join);CHKERRQ(ierr);
994             continue;
995           }
996           /* If we own one vertex and share a root with the other, we claim it */
997           key.i = candidatesRemote[offset+c].index;
998           key.j = candidatesRemote[offset+c].rank;
999           ierr = PetscHMapIJGet(roothash, key, &root);CHKERRQ(ierr);
1000           if (root >= 0) {
1001             vertices[0] = p; vertices[1] = localPoints[root];
1002             ierr = DMPlexGetJoin(dm, 2, vertices, &joinSize, &join);CHKERRQ(ierr);
1003             if (joinSize == 1) {
1004               candidatesRemote[offset+c].index = join[0];
1005               candidatesRemote[offset+c].rank = rank;
1006             }
1007             ierr = DMPlexRestoreJoin(dm, 2, vertices, &joinSize, &join);CHKERRQ(ierr);
1008           }
1009         }
1010         idx++;
1011       }
1012     }
1013   }
1014   /* Push claims back to receiver via the MultiSF and derive new pointSF mapping on receiver */
1015   {
1016     PetscSF         sfMulti, sfClaims, sfPointNew;
1017     PetscHMapI      claimshash;
1018     PetscInt        size, pStart, pEnd, root, joinSize, numLocalNew;
1019     PetscInt       *remoteOffsets, *localPointsNew, vertices[2];
1020     const PetscInt *join = NULL;
1021     PetscSFNode    *remotePointsNew;
1022     ierr = PetscSFGetMultiSF(pointSF, &sfMulti);CHKERRQ(ierr);
1023     ierr = PetscSectionCreate(PetscObjectComm((PetscObject) dm), &claimSection);CHKERRQ(ierr);
1024     ierr = PetscSFDistributeSection(sfMulti, candidateSectionRemote, &remoteOffsets, claimSection);CHKERRQ(ierr);
1025     ierr = PetscSFCreateSectionSF(sfMulti, candidateSectionRemote, remoteOffsets, claimSection, &sfClaims);CHKERRQ(ierr);
1026     ierr = PetscSectionGetStorageSize(claimSection, &size);CHKERRQ(ierr);
1027     ierr = PetscMalloc1(size, &claims);CHKERRQ(ierr);
1028     ierr = PetscSFBcastBegin(sfClaims, MPIU_2INT, candidatesRemote, claims);CHKERRQ(ierr);
1029     ierr = PetscSFBcastEnd(sfClaims, MPIU_2INT, candidatesRemote, claims);CHKERRQ(ierr);
1030     ierr = PetscSFDestroy(&sfClaims);CHKERRQ(ierr);
1031     ierr = PetscFree(remoteOffsets);CHKERRQ(ierr);
1032     /* Walk the original section of local supports and add an SF entry for each updated item */
1033     ierr = PetscHMapICreate(&claimshash);CHKERRQ(ierr);
1034     for (p = 0; p < numRoots; ++p) {
1035       ierr = PetscSectionGetDof(candidateSection, p, &dof);CHKERRQ(ierr);
1036       ierr = PetscSectionGetOffset(candidateSection, p, &offset);CHKERRQ(ierr);
1037       for (d = 0; d < dof; ++d) {
1038         if (candidates[offset+d].index != claims[offset+d].index) {
1039           key.i = candidates[offset+d].index;
1040           key.j = candidates[offset+d].rank;
1041           ierr = PetscHMapIJGet(roothash, key, &root);CHKERRQ(ierr);
1042           if (root >= 0) {
1043             vertices[0] = p; vertices[1] = localPoints[root];
1044             ierr = DMPlexGetJoin(dm, 2, vertices, &joinSize, &join);CHKERRQ(ierr);
1045             if (joinSize == 1) {ierr = PetscHMapISet(claimshash, join[0], offset+d);CHKERRQ(ierr);}
1046             ierr = DMPlexRestoreJoin(dm, 2, vertices, &joinSize, &join);CHKERRQ(ierr);
1047           }
1048         }
1049       }
1050     }
1051     /* Create new pointSF from hashed claims */
1052     ierr = PetscHMapIGetSize(claimshash, &numLocalNew);CHKERRQ(ierr);
1053     ierr = DMPlexGetChart(dm, &pStart, &pEnd);CHKERRQ(ierr);
1054     ierr = PetscMalloc1(numLeaves + numLocalNew, &localPointsNew);CHKERRQ(ierr);
1055     ierr = PetscMalloc1(numLeaves + numLocalNew, &remotePointsNew);CHKERRQ(ierr);
1056     for (p = 0; p < numLeaves; ++p) {
1057       localPointsNew[p] = localPoints[p];
1058       remotePointsNew[p].index = remotePoints[p].index;
1059       remotePointsNew[p].rank  = remotePoints[p].rank;
1060     }
1061     p = numLeaves;
1062     ierr = PetscHMapIGetKeys(claimshash, &p, localPointsNew);CHKERRQ(ierr);
1063     ierr = PetscSortInt(numLocalNew, &localPointsNew[numLeaves]);CHKERRQ(ierr);
1064     for (p = numLeaves; p < numLeaves + numLocalNew; ++p) {
1065       ierr = PetscHMapIGet(claimshash, localPointsNew[p], &offset);CHKERRQ(ierr);
1066       remotePointsNew[p] = claims[offset];
1067     }
1068     ierr = PetscSFCreate(PetscObjectComm((PetscObject) dm), &sfPointNew);CHKERRQ(ierr);
1069     ierr = PetscSFSetGraph(sfPointNew, pEnd-pStart, numLeaves+numLocalNew, localPointsNew, PETSC_OWN_POINTER, remotePointsNew, PETSC_OWN_POINTER);CHKERRQ(ierr);
1070     ierr = DMSetPointSF(dm, sfPointNew);CHKERRQ(ierr);
1071     ierr = PetscSFDestroy(&sfPointNew);CHKERRQ(ierr);
1072     ierr = PetscHMapIDestroy(&claimshash);CHKERRQ(ierr);
1073   }
1074   ierr = PetscHMapIDestroy(&leafhash);CHKERRQ(ierr);
1075   ierr = PetscHMapIJDestroy(&roothash);CHKERRQ(ierr);
1076   ierr = PetscSectionDestroy(&candidateSection);CHKERRQ(ierr);
1077   ierr = PetscSectionDestroy(&candidateSectionRemote);CHKERRQ(ierr);
1078   ierr = PetscSectionDestroy(&claimSection);CHKERRQ(ierr);
1079   ierr = PetscFree(candidates);CHKERRQ(ierr);
1080   ierr = PetscFree(candidatesRemote);CHKERRQ(ierr);
1081   ierr = PetscFree(claims);CHKERRQ(ierr);
1082   ierr = PetscLogEventEnd(DMPLEX_InterpolateSF,dm,0,0,0);CHKERRQ(ierr);
1083   PetscFunctionReturn(0);
1084 }
1085 
1086 /*@C
1087   DMPlexInterpolate - Take in a cell-vertex mesh and return one with all intermediate faces, edges, etc.
1088 
1089   Collective on DM
1090 
1091   Input Parameters:
1092 + dm - The DMPlex object with only cells and vertices
1093 - dmInt - The interpolated DM
1094 
1095   Output Parameter:
1096 . dmInt - The complete DMPlex object
1097 
1098   Level: intermediate
1099 
1100   Notes:
1101     It does not copy over the coordinates.
1102 
1103 .keywords: mesh
1104 .seealso: DMPlexUninterpolate(), DMPlexCreateFromCellList(), DMPlexCopyCoordinates()
1105 @*/
1106 PetscErrorCode DMPlexInterpolate(DM dm, DM *dmInt)
1107 {
1108   DM             idm, odm = dm;
1109   PetscSF        sfPoint;
1110   PetscInt       depth, dim, d;
1111   const char    *name;
1112   PetscBool      flg=PETSC_TRUE;
1113   PetscErrorCode ierr;
1114 
1115   PetscFunctionBegin;
1116   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
1117   PetscValidPointer(dmInt, 2);
1118   ierr = PetscLogEventBegin(DMPLEX_Interpolate,dm,0,0,0);CHKERRQ(ierr);
1119   ierr = DMPlexGetDepth(dm, &depth);CHKERRQ(ierr);
1120   ierr = DMGetDimension(dm, &dim);CHKERRQ(ierr);
1121   if ((depth == dim) || (dim <= 1)) {
1122     ierr = PetscObjectReference((PetscObject) dm);CHKERRQ(ierr);
1123     idm  = dm;
1124   } else {
1125     for (d = 1; d < dim; ++d) {
1126       /* Create interpolated mesh */
1127       ierr = DMCreate(PetscObjectComm((PetscObject)dm), &idm);CHKERRQ(ierr);
1128       ierr = DMSetType(idm, DMPLEX);CHKERRQ(ierr);
1129       ierr = DMSetDimension(idm, dim);CHKERRQ(ierr);
1130       if (depth > 0) {
1131         ierr = DMPlexInterpolateFaces_Internal(odm, 1, idm);CHKERRQ(ierr);
1132         ierr = DMGetPointSF(odm, &sfPoint);CHKERRQ(ierr);
1133         ierr = DMPlexInterpolatePointSF(idm, sfPoint, depth);CHKERRQ(ierr);
1134       }
1135       if (odm != dm) {ierr = DMDestroy(&odm);CHKERRQ(ierr);}
1136       odm = idm;
1137     }
1138     ierr = PetscObjectGetName((PetscObject) dm,  &name);CHKERRQ(ierr);
1139     ierr = PetscObjectSetName((PetscObject) idm,  name);CHKERRQ(ierr);
1140     ierr = DMPlexCopyCoordinates(dm, idm);CHKERRQ(ierr);
1141     ierr = DMCopyLabels(dm, idm);CHKERRQ(ierr);
1142     ierr = PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_interpolate_orient_interfaces", &flg, NULL);CHKERRQ(ierr);
1143     if (flg) {ierr = DMPlexOrientInterface(idm);CHKERRQ(ierr);}
1144   }
1145   {
1146     PetscBool            isper;
1147     const PetscReal      *maxCell, *L;
1148     const DMBoundaryType *bd;
1149 
1150     ierr = DMGetPeriodicity(dm,&isper,&maxCell,&L,&bd);CHKERRQ(ierr);
1151     ierr = DMSetPeriodicity(idm,isper,maxCell,L,bd);CHKERRQ(ierr);
1152   }
1153   *dmInt = idm;
1154   ierr = PetscLogEventEnd(DMPLEX_Interpolate,dm,0,0,0);CHKERRQ(ierr);
1155   PetscFunctionReturn(0);
1156 }
1157 
1158 /*@
1159   DMPlexCopyCoordinates - Copy coordinates from one mesh to another with the same vertices
1160 
1161   Collective on DM
1162 
1163   Input Parameter:
1164 . dmA - The DMPlex object with initial coordinates
1165 
1166   Output Parameter:
1167 . dmB - The DMPlex object with copied coordinates
1168 
1169   Level: intermediate
1170 
1171   Note: This is typically used when adding pieces other than vertices to a mesh
1172 
1173 .keywords: mesh
1174 .seealso: DMCopyLabels(), DMGetCoordinates(), DMGetCoordinatesLocal(), DMGetCoordinateDM(), DMGetCoordinateSection()
1175 @*/
1176 PetscErrorCode DMPlexCopyCoordinates(DM dmA, DM dmB)
1177 {
1178   Vec            coordinatesA, coordinatesB;
1179   VecType        vtype;
1180   PetscSection   coordSectionA, coordSectionB;
1181   PetscScalar   *coordsA, *coordsB;
1182   PetscInt       spaceDim, Nf, vStartA, vStartB, vEndA, vEndB, coordSizeB, v, d;
1183   PetscInt       cStartA, cEndA, cStartB, cEndB, cS, cE;
1184   PetscBool      lc = PETSC_FALSE;
1185   PetscErrorCode ierr;
1186 
1187   PetscFunctionBegin;
1188   PetscValidHeaderSpecific(dmA, DM_CLASSID, 1);
1189   PetscValidHeaderSpecific(dmB, DM_CLASSID, 2);
1190   if (dmA == dmB) PetscFunctionReturn(0);
1191   ierr = DMPlexGetDepthStratum(dmA, 0, &vStartA, &vEndA);CHKERRQ(ierr);
1192   ierr = DMPlexGetDepthStratum(dmB, 0, &vStartB, &vEndB);CHKERRQ(ierr);
1193   if ((vEndA-vStartA) != (vEndB-vStartB)) SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "The number of vertices in first DM %d != %d in the second DM", vEndA-vStartA, vEndB-vStartB);
1194   ierr = DMPlexGetHeightStratum(dmA, 0, &cStartA, &cEndA);CHKERRQ(ierr);
1195   ierr = DMPlexGetHeightStratum(dmB, 0, &cStartB, &cEndB);CHKERRQ(ierr);
1196   ierr = DMGetCoordinateSection(dmA, &coordSectionA);CHKERRQ(ierr);
1197   ierr = DMGetCoordinateSection(dmB, &coordSectionB);CHKERRQ(ierr);
1198   if (coordSectionA == coordSectionB) PetscFunctionReturn(0);
1199   ierr = PetscSectionGetNumFields(coordSectionA, &Nf);CHKERRQ(ierr);
1200   if (!Nf) PetscFunctionReturn(0);
1201   if (Nf > 1) SETERRQ1(PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "The number of coordinate fields must be 1, not %D", Nf);
1202   if (!coordSectionB) {
1203     PetscInt dim;
1204 
1205     ierr = PetscSectionCreate(PetscObjectComm((PetscObject) coordSectionA), &coordSectionB);CHKERRQ(ierr);
1206     ierr = DMGetCoordinateDim(dmA, &dim);CHKERRQ(ierr);
1207     ierr = DMSetCoordinateSection(dmB, dim, coordSectionB);CHKERRQ(ierr);
1208     ierr = PetscObjectDereference((PetscObject) coordSectionB);CHKERRQ(ierr);
1209   }
1210   ierr = PetscSectionSetNumFields(coordSectionB, 1);CHKERRQ(ierr);
1211   ierr = PetscSectionGetFieldComponents(coordSectionA, 0, &spaceDim);CHKERRQ(ierr);
1212   ierr = PetscSectionSetFieldComponents(coordSectionB, 0, spaceDim);CHKERRQ(ierr);
1213   ierr = PetscSectionGetChart(coordSectionA, &cS, &cE);CHKERRQ(ierr);
1214   if (cStartA <= cS && cS < cEndA) { /* localized coordinates */
1215     if ((cEndA-cStartA) != (cEndB-cStartB)) SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "The number of cellls in first DM %d != %d in the second DM", cEndA-cStartA, cEndB-cStartB);
1216     cS = cS - cStartA + cStartB;
1217     cE = vEndB;
1218     lc = PETSC_TRUE;
1219   } else {
1220     cS = vStartB;
1221     cE = vEndB;
1222   }
1223   ierr = PetscSectionSetChart(coordSectionB, cS, cE);CHKERRQ(ierr);
1224   for (v = vStartB; v < vEndB; ++v) {
1225     ierr = PetscSectionSetDof(coordSectionB, v, spaceDim);CHKERRQ(ierr);
1226     ierr = PetscSectionSetFieldDof(coordSectionB, v, 0, spaceDim);CHKERRQ(ierr);
1227   }
1228   if (lc) { /* localized coordinates */
1229     PetscInt c;
1230 
1231     for (c = cS-cStartB; c < cEndB-cStartB; c++) {
1232       PetscInt dof;
1233 
1234       ierr = PetscSectionGetDof(coordSectionA, c + cStartA, &dof);CHKERRQ(ierr);
1235       ierr = PetscSectionSetDof(coordSectionB, c + cStartB, dof);CHKERRQ(ierr);
1236       ierr = PetscSectionSetFieldDof(coordSectionB, c + cStartB, 0, dof);CHKERRQ(ierr);
1237     }
1238   }
1239   ierr = PetscSectionSetUp(coordSectionB);CHKERRQ(ierr);
1240   ierr = PetscSectionGetStorageSize(coordSectionB, &coordSizeB);CHKERRQ(ierr);
1241   ierr = DMGetCoordinatesLocal(dmA, &coordinatesA);CHKERRQ(ierr);
1242   ierr = VecCreate(PETSC_COMM_SELF, &coordinatesB);CHKERRQ(ierr);
1243   ierr = PetscObjectSetName((PetscObject) coordinatesB, "coordinates");CHKERRQ(ierr);
1244   ierr = VecSetSizes(coordinatesB, coordSizeB, PETSC_DETERMINE);CHKERRQ(ierr);
1245   ierr = VecGetBlockSize(coordinatesA, &d);CHKERRQ(ierr);
1246   ierr = VecSetBlockSize(coordinatesB, d);CHKERRQ(ierr);
1247   ierr = VecGetType(coordinatesA, &vtype);CHKERRQ(ierr);
1248   ierr = VecSetType(coordinatesB, vtype);CHKERRQ(ierr);
1249   ierr = VecGetArray(coordinatesA, &coordsA);CHKERRQ(ierr);
1250   ierr = VecGetArray(coordinatesB, &coordsB);CHKERRQ(ierr);
1251   for (v = 0; v < vEndB-vStartB; ++v) {
1252     PetscInt offA, offB;
1253 
1254     ierr = PetscSectionGetOffset(coordSectionA, v + vStartA, &offA);CHKERRQ(ierr);
1255     ierr = PetscSectionGetOffset(coordSectionB, v + vStartB, &offB);CHKERRQ(ierr);
1256     for (d = 0; d < spaceDim; ++d) {
1257       coordsB[offB+d] = coordsA[offA+d];
1258     }
1259   }
1260   if (lc) { /* localized coordinates */
1261     PetscInt c;
1262 
1263     for (c = cS-cStartB; c < cEndB-cStartB; c++) {
1264       PetscInt dof, offA, offB;
1265 
1266       ierr = PetscSectionGetOffset(coordSectionA, c + cStartA, &offA);CHKERRQ(ierr);
1267       ierr = PetscSectionGetOffset(coordSectionB, c + cStartB, &offB);CHKERRQ(ierr);
1268       ierr = PetscSectionGetDof(coordSectionA, c + cStartA, &dof);CHKERRQ(ierr);
1269       ierr = PetscMemcpy(coordsB + offB,coordsA + offA,dof*sizeof(*coordsB));CHKERRQ(ierr);
1270     }
1271   }
1272   ierr = VecRestoreArray(coordinatesA, &coordsA);CHKERRQ(ierr);
1273   ierr = VecRestoreArray(coordinatesB, &coordsB);CHKERRQ(ierr);
1274   ierr = DMSetCoordinatesLocal(dmB, coordinatesB);CHKERRQ(ierr);
1275   ierr = VecDestroy(&coordinatesB);CHKERRQ(ierr);
1276   PetscFunctionReturn(0);
1277 }
1278 
1279 /*@
1280   DMPlexUninterpolate - Take in a mesh with all intermediate faces, edges, etc. and return a cell-vertex mesh
1281 
1282   Collective on DM
1283 
1284   Input Parameter:
1285 . dm - The complete DMPlex object
1286 
1287   Output Parameter:
1288 . dmUnint - The DMPlex object with only cells and vertices
1289 
1290   Level: intermediate
1291 
1292   Notes:
1293     It does not copy over the coordinates.
1294 
1295 .keywords: mesh
1296 .seealso: DMPlexInterpolate(), DMPlexCreateFromCellList(), DMPlexCopyCoordinates()
1297 @*/
1298 PetscErrorCode DMPlexUninterpolate(DM dm, DM *dmUnint)
1299 {
1300   DM             udm;
1301   PetscInt       dim, vStart, vEnd, cStart, cEnd, cMax, c, maxConeSize = 0, *cone;
1302   PetscErrorCode ierr;
1303 
1304   PetscFunctionBegin;
1305   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
1306   PetscValidPointer(dmUnint, 2);
1307   ierr = DMGetDimension(dm, &dim);CHKERRQ(ierr);
1308   if (dim <= 1) {
1309     ierr = PetscObjectReference((PetscObject) dm);CHKERRQ(ierr);
1310     *dmUnint = dm;
1311     PetscFunctionReturn(0);
1312   }
1313   ierr = DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd);CHKERRQ(ierr);
1314   ierr = DMPlexGetHeightStratum(dm, 0, &cStart, &cEnd);CHKERRQ(ierr);
1315   ierr = DMPlexGetHybridBounds(dm, &cMax, NULL, NULL, NULL);CHKERRQ(ierr);
1316   ierr = DMCreate(PetscObjectComm((PetscObject) dm), &udm);CHKERRQ(ierr);
1317   ierr = DMSetType(udm, DMPLEX);CHKERRQ(ierr);
1318   ierr = DMSetDimension(udm, dim);CHKERRQ(ierr);
1319   ierr = DMPlexSetChart(udm, cStart, vEnd);CHKERRQ(ierr);
1320   for (c = cStart; c < cEnd; ++c) {
1321     PetscInt *closure = NULL, closureSize, cl, coneSize = 0;
1322 
1323     ierr = DMPlexGetTransitiveClosure(dm, c, PETSC_TRUE, &closureSize, &closure);CHKERRQ(ierr);
1324     for (cl = 0; cl < closureSize*2; cl += 2) {
1325       const PetscInt p = closure[cl];
1326 
1327       if ((p >= vStart) && (p < vEnd)) ++coneSize;
1328     }
1329     ierr = DMPlexRestoreTransitiveClosure(dm, c, PETSC_TRUE, &closureSize, &closure);CHKERRQ(ierr);
1330     ierr = DMPlexSetConeSize(udm, c, coneSize);CHKERRQ(ierr);
1331     maxConeSize = PetscMax(maxConeSize, coneSize);
1332   }
1333   ierr = DMSetUp(udm);CHKERRQ(ierr);
1334   ierr = PetscMalloc1(maxConeSize, &cone);CHKERRQ(ierr);
1335   for (c = cStart; c < cEnd; ++c) {
1336     PetscInt *closure = NULL, closureSize, cl, coneSize = 0;
1337 
1338     ierr = DMPlexGetTransitiveClosure(dm, c, PETSC_TRUE, &closureSize, &closure);CHKERRQ(ierr);
1339     for (cl = 0; cl < closureSize*2; cl += 2) {
1340       const PetscInt p = closure[cl];
1341 
1342       if ((p >= vStart) && (p < vEnd)) cone[coneSize++] = p;
1343     }
1344     ierr = DMPlexRestoreTransitiveClosure(dm, c, PETSC_TRUE, &closureSize, &closure);CHKERRQ(ierr);
1345     ierr = DMPlexSetCone(udm, c, cone);CHKERRQ(ierr);
1346   }
1347   ierr = PetscFree(cone);CHKERRQ(ierr);
1348   ierr = DMPlexSetHybridBounds(udm, cMax, PETSC_DETERMINE, PETSC_DETERMINE, PETSC_DETERMINE);CHKERRQ(ierr);
1349   ierr = DMPlexSymmetrize(udm);CHKERRQ(ierr);
1350   ierr = DMPlexStratify(udm);CHKERRQ(ierr);
1351   /* Reduce SF */
1352   {
1353     PetscSF            sfPoint, sfPointUn;
1354     const PetscSFNode *remotePoints;
1355     const PetscInt    *localPoints;
1356     PetscSFNode       *remotePointsUn;
1357     PetscInt          *localPointsUn;
1358     PetscInt           vEnd, numRoots, numLeaves, l;
1359     PetscInt           numLeavesUn = 0, n = 0;
1360     PetscErrorCode     ierr;
1361 
1362     /* Get original SF information */
1363     ierr = DMGetPointSF(dm, &sfPoint);CHKERRQ(ierr);
1364     ierr = DMGetPointSF(udm, &sfPointUn);CHKERRQ(ierr);
1365     ierr = DMPlexGetDepthStratum(dm, 0, NULL, &vEnd);CHKERRQ(ierr);
1366     ierr = PetscSFGetGraph(sfPoint, &numRoots, &numLeaves, &localPoints, &remotePoints);CHKERRQ(ierr);
1367     /* Allocate space for cells and vertices */
1368     for (l = 0; l < numLeaves; ++l) if (localPoints[l] < vEnd) numLeavesUn++;
1369     /* Fill in leaves */
1370     if (vEnd >= 0) {
1371       ierr = PetscMalloc1(numLeavesUn, &remotePointsUn);CHKERRQ(ierr);
1372       ierr = PetscMalloc1(numLeavesUn, &localPointsUn);CHKERRQ(ierr);
1373       for (l = 0; l < numLeaves; l++) {
1374         if (localPoints[l] < vEnd) {
1375           localPointsUn[n]        = localPoints[l];
1376           remotePointsUn[n].rank  = remotePoints[l].rank;
1377           remotePointsUn[n].index = remotePoints[l].index;
1378           ++n;
1379         }
1380       }
1381       if (n != numLeavesUn) SETERRQ2(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Inconsistent number of leaves %d != %d", n, numLeavesUn);
1382       ierr = PetscSFSetGraph(sfPointUn, vEnd, numLeavesUn, localPointsUn, PETSC_OWN_POINTER, remotePointsUn, PETSC_OWN_POINTER);CHKERRQ(ierr);
1383     }
1384   }
1385   {
1386     PetscBool            isper;
1387     const PetscReal      *maxCell, *L;
1388     const DMBoundaryType *bd;
1389 
1390     ierr = DMGetPeriodicity(dm,&isper,&maxCell,&L,&bd);CHKERRQ(ierr);
1391     ierr = DMSetPeriodicity(udm,isper,maxCell,L,bd);CHKERRQ(ierr);
1392   }
1393 
1394   *dmUnint = udm;
1395   PetscFunctionReturn(0);
1396 }
1397