xref: /petsc/src/dm/impls/plex/tutorials/ex11.c (revision 64eb36536758ba5fde9eda0d4d7f84c5f43dcef0)
1 static char help[] = "Mesh Orientation Tutorial\n\n";
2 
3 #include <petscdmplex.h>
4 #include <petscdmplextransform.h>
5 
6 typedef struct {
7   PetscBool genArr;        /* Generate all possible cell arrangements */
8   PetscBool refArr;        /* Refine all possible cell arrangements */
9   PetscBool printTable;    /* Print the CAyley table */
10   PetscInt  orntBounds[2]; /* Bounds for the orientation check */
11   PetscInt  numOrnt;       /* Number of specific orientations specified, or -1 for all orientations */
12   PetscInt  ornts[48];     /* Specific orientations if specified */
13   PetscInt  initOrnt;      /* Initial orientation for starting mesh */
14 } AppCtx;
15 
16 static PetscErrorCode ProcessOptions(MPI_Comm comm, AppCtx *options)
17 {
18   PetscInt       n = 2;
19   PetscBool      flg;
20 
21   PetscFunctionBeginUser;
22   options->genArr        = PETSC_FALSE;
23   options->refArr        = PETSC_FALSE;
24   options->printTable    = PETSC_FALSE;
25   options->orntBounds[0] = PETSC_MIN_INT;
26   options->orntBounds[1] = PETSC_MAX_INT;
27   options->numOrnt       = -1;
28   options->initOrnt      = 0;
29 
30   PetscOptionsBegin(comm, "", "Mesh Orientation Tutorials Options", "DMPLEX");
31   PetscCall(PetscOptionsBool("-gen_arrangements", "Flag for generating all arrangements of the cell", "ex11.c", options->genArr, &options->genArr, NULL));
32   PetscCall(PetscOptionsBool("-ref_arrangements", "Flag for refining all arrangements of the cell", "ex11.c", options->refArr, &options->refArr, NULL));
33   PetscCall(PetscOptionsBool("-print_table", "Print the Cayley table", "ex11.c", options->printTable, &options->printTable, NULL));
34   PetscCall(PetscOptionsIntArray("-ornt_bounds", "Bounds for orientation checks", "ex11.c", options->orntBounds, &n, NULL));
35   n    = 48;
36   PetscCall(PetscOptionsIntArray("-ornts", "Specific orientations for checks", "ex11.c", options->ornts, &n, &flg));
37   if (flg) {
38     options->numOrnt = n;
39     PetscCall(PetscSortInt(n, options->ornts));
40   }
41   PetscCall(PetscOptionsInt("-init_ornt", "Initial orientation for starting mesh", "ex11.c", options->initOrnt, &options->initOrnt, NULL));
42   PetscOptionsEnd();
43   PetscFunctionReturn(0);
44 }
45 
46 static PetscBool ignoreOrnt(AppCtx *user, PetscInt o)
47 {
48   PetscInt       loc;
49   PetscErrorCode ierr;
50 
51   if (user->numOrnt < 0) return PETSC_FALSE;
52   ierr = PetscFindInt(o, user->numOrnt, user->ornts, &loc);
53   if (loc < 0 || ierr)   return PETSC_TRUE;
54   return PETSC_FALSE;
55 }
56 
57 static PetscErrorCode CreateMesh(MPI_Comm comm, AppCtx *user, DM *dm)
58 {
59   PetscFunctionBeginUser;
60   PetscCall(DMCreate(comm, dm));
61   PetscCall(DMSetType(*dm, DMPLEX));
62   PetscCall(DMSetFromOptions(*dm));
63   PetscCall(DMViewFromOptions(*dm, NULL, "-dm_view"));
64   PetscFunctionReturn(0);
65 }
66 
67 static PetscErrorCode CheckCellVertices(DM dm, PetscInt cell, PetscInt o)
68 {
69   DMPolytopeType  ct;
70   const PetscInt *arrVerts;
71   PetscInt       *closure = NULL;
72   PetscInt        Ncl, cl, Nv, vStart, vEnd, v;
73   MPI_Comm        comm;
74 
75   PetscFunctionBeginUser;
76   PetscCall(PetscObjectGetComm((PetscObject) dm, &comm));
77   PetscCall(DMPlexGetCellType(dm, cell, &ct));
78   PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
79   PetscCall(DMPlexGetTransitiveClosure(dm, cell, PETSC_TRUE, &Ncl, &closure));
80   for (cl = 0, Nv = 0; cl < Ncl*2; cl += 2) {
81     const PetscInt vertex = closure[cl];
82 
83     if (vertex < vStart || vertex >= vEnd) continue;
84     closure[Nv++] = vertex;
85   }
86   PetscCheck(Nv == DMPolytopeTypeGetNumVertices(ct),comm, PETSC_ERR_ARG_WRONG, "Cell %D has %D vertices != %D vertices in a %s", cell, Nv, DMPolytopeTypeGetNumVertices(ct), DMPolytopeTypes[ct]);
87   arrVerts = DMPolytopeTypeGetVertexArrangment(ct, o);
88   for (v = 0; v < Nv; ++v) {
89     PetscCheck(closure[v] == arrVerts[v]+vStart,comm, PETSC_ERR_ARG_WRONG, "Cell %D vertex[%D]: %D should be %D for arrangement %D", cell, v, closure[v], arrVerts[v]+vStart, o);
90   }
91   PetscCall(DMPlexRestoreTransitiveClosure(dm, cell, PETSC_TRUE, &Ncl, &closure));
92   PetscFunctionReturn(0);
93 }
94 
95 /* Transform cell with group operation o */
96 static PetscErrorCode ReorientCell(DM dm, PetscInt cell, PetscInt o, PetscBool swapCoords)
97 {
98   DM              cdm;
99   Vec             coordinates;
100   PetscScalar    *coords, *ccoords = NULL;
101   PetscInt       *closure = NULL;
102   PetscInt        cdim, d, Nc, Ncl, cl, vStart, vEnd, Nv;
103 
104   PetscFunctionBegin;
105   /* Change vertex coordinates so that it plots as we expect */
106   PetscCall(DMGetCoordinateDM(dm, &cdm));
107   PetscCall(DMGetCoordinateDim(dm, &cdim));
108   PetscCall(DMGetCoordinatesLocal(dm, &coordinates));
109   PetscCall(DMPlexVecGetClosure(cdm, NULL, coordinates, cell, &Nc, &ccoords));
110   /* Reorient cone */
111   PetscCall(DMPlexOrientPoint(dm, cell, o));
112   /* Finish resetting coordinates */
113   if (swapCoords) {
114     PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
115     PetscCall(VecGetArrayWrite(coordinates, &coords));
116     PetscCall(DMPlexGetTransitiveClosure(dm, cell, PETSC_TRUE, &Ncl, &closure));
117     for (cl = 0, Nv = 0; cl < Ncl*2; cl += 2) {
118       const PetscInt vertex = closure[cl];
119       PetscScalar   *vcoords;
120 
121       if (vertex < vStart || vertex >= vEnd) continue;
122       PetscCall(DMPlexPointLocalRef(cdm, vertex, coords, &vcoords));
123       for (d = 0; d < cdim; ++d) vcoords[d] = ccoords[Nv*cdim + d];
124       ++Nv;
125     }
126     PetscCall(DMPlexRestoreTransitiveClosure(dm, cell, PETSC_TRUE, &Ncl, &closure));
127     PetscCall(VecRestoreArrayWrite(coordinates, &coords));
128   }
129   PetscCall(DMPlexVecRestoreClosure(cdm, NULL, coordinates, cell, &Nc, &ccoords));
130   PetscFunctionReturn(0);
131 }
132 
133 static PetscErrorCode GenerateArrangments(DM dm, AppCtx *user)
134 {
135   DM             odm;
136   DMPolytopeType ct;
137   PetscInt       No, o;
138   const char    *name;
139 
140   PetscFunctionBeginUser;
141   if (!user->genArr) PetscFunctionReturn(0);
142   PetscCall(PetscObjectGetName((PetscObject) dm, &name));
143   PetscCall(DMPlexGetCellType(dm, 0, &ct));
144   No   = DMPolytopeTypeGetNumArrangments(ct)/2;
145   for (o = PetscMax(-No, user->orntBounds[0]); o < PetscMin(No, user->orntBounds[1]); ++o) {
146     if (ignoreOrnt(user, o)) continue;
147     PetscCall(CreateMesh(PetscObjectComm((PetscObject) dm), user, &odm));
148     PetscCall(ReorientCell(odm, 0, o, PETSC_TRUE));
149     PetscCall(PetscPrintf(PetscObjectComm((PetscObject) dm), "%s orientation %D\n", name, o));
150     PetscCall(DMViewFromOptions(odm, NULL, "-gen_dm_view"));
151     PetscCall(CheckCellVertices(odm, 0, o));
152     PetscCall(DMDestroy(&odm));
153   }
154   PetscFunctionReturn(0);
155 }
156 
157 static PetscErrorCode VerifyCayleyTable(DM dm, AppCtx *user)
158 {
159   DM              dm1, dm2;
160   DMPolytopeType  ct;
161   const PetscInt *refcone, *cone;
162   PetscInt        No, o1, o2, o3, o4;
163   PetscBool       equal;
164   const char     *name;
165 
166   PetscFunctionBeginUser;
167   if (!user->genArr) PetscFunctionReturn(0);
168   PetscCall(PetscObjectGetName((PetscObject) dm, &name));
169   PetscCall(DMPlexGetCellType(dm, 0, &ct));
170   PetscCall(DMPlexGetCone(dm, 0, &refcone));
171   No   = DMPolytopeTypeGetNumArrangments(ct)/2;
172   if (user->printTable) PetscCall(PetscPrintf(PETSC_COMM_SELF, "Cayley Table for %s\n", DMPolytopeTypes[ct]));
173   for (o1 = PetscMax(-No, user->orntBounds[0]); o1 < PetscMin(No, user->orntBounds[1]); ++o1) {
174     for (o2 = PetscMax(-No, user->orntBounds[0]); o2 < PetscMin(No, user->orntBounds[1]); ++o2) {
175       PetscCall(CreateMesh(PetscObjectComm((PetscObject) dm), user, &dm1));
176       PetscCall(DMPlexOrientPoint(dm1, 0, o2));
177       PetscCall(DMPlexCheckFaces(dm1, 0));
178       PetscCall(DMPlexOrientPoint(dm1, 0, o1));
179       PetscCall(DMPlexCheckFaces(dm1, 0));
180       o3   = DMPolytopeTypeComposeOrientation(ct, o1, o2);
181       /* First verification */
182       PetscCall(CreateMesh(PetscObjectComm((PetscObject) dm), user, &dm2));
183       PetscCall(DMPlexOrientPoint(dm2, 0, o3));
184       PetscCall(DMPlexCheckFaces(dm2, 0));
185       PetscCall(DMPlexEqual(dm1, dm2, &equal));
186       if (!equal) {
187         PetscCall(DMViewFromOptions(dm1, NULL, "-error_dm_view"));
188         PetscCall(DMViewFromOptions(dm2, NULL, "-error_dm_view"));
189         SETERRQ(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Cayley table error for %s: %D * %D != %D", DMPolytopeTypes[ct], o1, o2, o3);
190       }
191       /* Second verification */
192       PetscCall(DMPlexGetCone(dm1, 0, &cone));
193       PetscCall(DMPolytopeGetOrientation(ct, refcone, cone, &o4));
194       if (user->printTable) PetscCall(PetscPrintf(PETSC_COMM_SELF, "%D, ", o4));
195       PetscCheck(o3 == o4,PETSC_COMM_SELF, PETSC_ERR_PLIB, "Cayley table error for %s: %D * %D = %D != %D", DMPolytopeTypes[ct], o1, o2, o3, o4);
196       PetscCall(DMDestroy(&dm1));
197       PetscCall(DMDestroy(&dm2));
198     }
199     if (user->printTable) PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
200   }
201   PetscFunctionReturn(0);
202 }
203 
204 static PetscErrorCode VerifyInverse(DM dm, AppCtx *user)
205 {
206   DM              dm1, dm2;
207   DMPolytopeType  ct;
208   const PetscInt *refcone, *cone;
209   PetscInt        No, o, oi, o2;
210   PetscBool       equal;
211   const char     *name;
212 
213   PetscFunctionBeginUser;
214   if (!user->genArr) PetscFunctionReturn(0);
215   PetscCall(PetscObjectGetName((PetscObject) dm, &name));
216   PetscCall(DMPlexGetCellType(dm, 0, &ct));
217   PetscCall(DMPlexGetCone(dm, 0, &refcone));
218   No   = DMPolytopeTypeGetNumArrangments(ct)/2;
219   if (user->printTable) PetscCall(PetscPrintf(PETSC_COMM_SELF, "Inverse table for %s\n", DMPolytopeTypes[ct]));
220   for (o = PetscMax(-No, user->orntBounds[0]); o < PetscMin(No, user->orntBounds[1]); ++o) {
221     if (ignoreOrnt(user, o)) continue;
222     oi   = DMPolytopeTypeComposeOrientationInv(ct, 0, o);
223     PetscCall(CreateMesh(PetscObjectComm((PetscObject) dm), user, &dm1));
224     PetscCall(DMPlexOrientPoint(dm1, 0, o));
225     PetscCall(DMPlexCheckFaces(dm1, 0));
226     PetscCall(DMPlexOrientPoint(dm1, 0, oi));
227     PetscCall(DMPlexCheckFaces(dm1, 0));
228     /* First verification */
229     PetscCall(CreateMesh(PetscObjectComm((PetscObject) dm), user, &dm2));
230     PetscCall(DMPlexEqual(dm1, dm2, &equal));
231     if (!equal) {
232       PetscCall(DMViewFromOptions(dm1, NULL, "-error_dm_view"));
233       PetscCall(DMViewFromOptions(dm2, NULL, "-error_dm_view"));
234       SETERRQ(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Inverse error for %s: %D * %D != 0", DMPolytopeTypes[ct], o, oi);
235     }
236     /* Second verification */
237     PetscCall(DMPlexGetCone(dm1, 0, &cone));
238     PetscCall(DMPolytopeGetOrientation(ct, refcone, cone, &o2));
239     if (user->printTable) PetscCall(PetscPrintf(PETSC_COMM_SELF, "%D, ", oi));
240     PetscCheck(o2 == 0,PETSC_COMM_SELF, PETSC_ERR_PLIB, "Inverse error for %s: %D * %D = %D != 0", DMPolytopeTypes[ct], o, oi, o2);
241     PetscCall(DMDestroy(&dm1));
242     PetscCall(DMDestroy(&dm2));
243   }
244   if (user->printTable) PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
245   PetscFunctionReturn(0);
246 }
247 
248 /* Suppose that point p has the same arrangement as o from canonical, compare the subcells to canonical subcells */
249 static PetscErrorCode CheckSubcells(DM dm, DM odm, PetscInt p, PetscInt o, AppCtx *user)
250 {
251   DMPlexTransform tr, otr;
252   DMPolytopeType  ct;
253   DMPolytopeType *rct;
254   const PetscInt *cone, *ornt, *ocone, *oornt;
255   PetscInt       *rsize, *rcone, *rornt;
256   PetscInt        Nct, n, oi, debug = 0;
257 
258   PetscFunctionBeginUser;
259   PetscCall(DMPlexTransformCreate(PetscObjectComm((PetscObject) dm), &tr));
260   PetscCall(DMPlexTransformSetDM(tr, dm));
261   PetscCall(DMPlexTransformSetFromOptions(tr));
262   PetscCall(DMPlexTransformSetUp(tr));
263 
264   PetscCall(DMPlexTransformCreate(PetscObjectComm((PetscObject) odm), &otr));
265   PetscCall(DMPlexTransformSetDM(otr, odm));
266   PetscCall(DMPlexTransformSetFromOptions(otr));
267   PetscCall(DMPlexTransformSetUp(otr));
268 
269   PetscCall(DMPlexGetCellType(dm, p, &ct));
270   PetscCall(DMPlexGetCone(dm, p, &cone));
271   PetscCall(DMPlexGetConeOrientation(dm, p, &ornt));
272   PetscCall(DMPlexGetCone(odm, p, &ocone));
273   PetscCall(DMPlexGetConeOrientation(odm, p, &oornt));
274   oi   = DMPolytopeTypeComposeOrientationInv(ct, 0, o);
275   if (user->printTable) PetscCall(PetscPrintf(PETSC_COMM_SELF, "Orientation %D\n", oi));
276 
277   PetscCall(DMPlexTransformCellTransform(tr, ct, p, NULL, &Nct, &rct, &rsize, &rcone, &rornt));
278   for (n = 0; n < Nct; ++n) {
279     DMPolytopeType ctNew = rct[n];
280     PetscInt       r, ro;
281 
282     if (debug) PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Checking type %s\n", DMPolytopeTypes[ctNew]));
283     for (r = 0; r < rsize[n]; ++r) {
284       const PetscInt *qcone, *qornt, *oqcone, *oqornt;
285       PetscInt        pNew, opNew, oo, pr, fo;
286       PetscBool       restore = PETSC_TRUE;
287 
288       PetscCall(DMPlexTransformGetTargetPoint(tr, ct, ctNew, p, r, &pNew));
289       PetscCall(DMPlexTransformGetCone(tr, pNew, &qcone, &qornt));
290       if (debug) {
291         PetscInt c;
292 
293         PetscCall(PetscPrintf(PETSC_COMM_SELF, "    Checking replica %D (%D)\n      Original Cone", r, pNew));
294         for (c = 0; c < DMPolytopeTypeGetConeSize(ctNew); ++c) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %D (%D)", qcone[c], qornt[c]));
295         PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
296       }
297       for (ro = 0; ro < rsize[n]; ++ro) {
298         PetscBool found;
299 
300         PetscCall(DMPlexTransformGetTargetPoint(otr, ct, ctNew, p, ro, &opNew));
301         PetscCall(DMPlexTransformGetConeOriented(otr, opNew, o, &oqcone, &oqornt));
302         PetscCall(DMPolytopeMatchOrientation(ctNew, oqcone, qcone, &oo, &found));
303         if (found) break;
304         PetscCall(DMPlexTransformRestoreCone(otr, pNew, &oqcone, &oqornt));
305       }
306       if (debug) {
307         PetscInt c;
308 
309         PetscCall(PetscPrintf(PETSC_COMM_SELF, "    Checking transform replica %D (%D) (%D)\n      Transform Cone", ro, opNew, o));
310         for (c = 0; c < DMPolytopeTypeGetConeSize(ctNew); ++c) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %D (%D)", oqcone[c], oqornt[c]));
311         PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
312         PetscCall(PetscPrintf(PETSC_COMM_SELF, "    Matched %D\n", oo));
313       }
314       if (ro == rsize[n]) {
315         /* The tetrahedron has 3 pairs of opposing edges, and any pair can be connected by the interior segment */
316         if (ct == DM_POLYTOPE_TETRAHEDRON) {
317           /* The segment in a tetrahedron does not map into itself under the group action */
318           if (ctNew == DM_POLYTOPE_SEGMENT) {restore = PETSC_FALSE; ro = r; oo = 0;}
319           /* The last four interior faces do not map into themselves under the group action */
320           if (r > 3 && ctNew == DM_POLYTOPE_TRIANGLE) {restore = PETSC_FALSE; ro = r; oo = 0;}
321           /* The last four interior faces do not map into themselves under the group action */
322           if (r > 3 && ctNew == DM_POLYTOPE_TETRAHEDRON) {restore = PETSC_FALSE; ro = r; oo = 0;}
323         }
324         PetscCheck(!restore,PETSC_COMM_SELF, PETSC_ERR_PLIB, "Unable to find matching %s %D orientation for cell orientation %D", DMPolytopeTypes[ctNew], r, o);
325       }
326       if (user->printTable) PetscCall(PetscPrintf(PETSC_COMM_SELF, "%D, %D, ", ro, oo));
327       PetscCall(DMPlexTransformGetSubcellOrientation(tr, ct, p, oi, ctNew, r, 0, &pr, &fo));
328       if (!user->printTable) {
329         PetscCheck(pr == ro,PETSC_COMM_SELF, PETSC_ERR_PLIB, "Choose wrong replica %D != %D", pr, ro);
330         PetscCheck(fo == oo,PETSC_COMM_SELF, PETSC_ERR_PLIB, "Choose wrong orientation %D != %D", fo, oo);
331       }
332       PetscCall(DMPlexTransformRestoreCone(tr, pNew, &qcone, &qornt));
333       if (restore) PetscCall(DMPlexTransformRestoreCone(otr, pNew, &oqcone, &oqornt));
334     }
335     if (user->printTable) PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
336   }
337   PetscCall(DMPlexTransformDestroy(&tr));
338   PetscCall(DMPlexTransformDestroy(&otr));
339   PetscFunctionReturn(0);
340 }
341 
342 static PetscErrorCode RefineArrangments(DM dm, AppCtx *user)
343 {
344   DM             odm, rdm;
345   DMPolytopeType ct;
346   PetscInt       No, o;
347   const char    *name;
348 
349   PetscFunctionBeginUser;
350   if (!user->refArr) PetscFunctionReturn(0);
351   PetscCall(PetscObjectGetName((PetscObject) dm, &name));
352   PetscCall(DMPlexGetCellType(dm, 0, &ct));
353   No   = DMPolytopeTypeGetNumArrangments(ct)/2;
354   for (o = PetscMax(-No, user->orntBounds[0]); o < PetscMin(No, user->orntBounds[1]); ++o) {
355     if (ignoreOrnt(user, o)) continue;
356     PetscCall(CreateMesh(PetscObjectComm((PetscObject) dm), user, &odm));
357     if (user->initOrnt) PetscCall(ReorientCell(odm, 0, user->initOrnt, PETSC_FALSE));
358     PetscCall(ReorientCell(odm, 0, o, PETSC_TRUE));
359     PetscCall(DMViewFromOptions(odm, NULL, "-orig_dm_view"));
360     PetscCall(DMRefine(odm, MPI_COMM_NULL, &rdm));
361     PetscCall(DMSetFromOptions(rdm));
362     PetscCall(PetscPrintf(PetscObjectComm((PetscObject) dm), "%s orientation %D\n", name, o));
363     PetscCall(DMViewFromOptions(rdm, NULL, "-ref_dm_view"));
364     PetscCall(CheckSubcells(dm, odm, 0, o, user));
365     PetscCall(DMDestroy(&odm));
366     PetscCall(DMDestroy(&rdm));
367   }
368   PetscFunctionReturn(0);
369 }
370 
371 int main(int argc, char **argv)
372 {
373   DM             dm;
374   AppCtx         user;
375 
376   PetscCall(PetscInitialize(&argc, &argv, NULL, help));
377   PetscCall(ProcessOptions(PETSC_COMM_WORLD, &user));
378   PetscCall(CreateMesh(PETSC_COMM_WORLD, &user, &dm));
379   if (user.initOrnt) {
380     PetscCall(ReorientCell(dm, 0, user.initOrnt, PETSC_FALSE));
381     PetscCall(DMViewFromOptions(dm, NULL, "-ornt_dm_view"));
382   }
383   PetscCall(GenerateArrangments(dm, &user));
384   PetscCall(VerifyCayleyTable(dm, &user));
385   PetscCall(VerifyInverse(dm, &user));
386   PetscCall(RefineArrangments(dm, &user));
387   PetscCall(DMDestroy(&dm));
388   PetscCall(PetscFinalize());
389   return 0;
390 }
391 
392 /*TEST
393 
394   testset:
395     args: -dm_coord_space 0 -dm_plex_reference_cell_domain -gen_arrangements \
396           -gen_dm_view ::ascii_latex -dm_plex_view_tikzscale 0.5
397 
398     test:
399       suffix: segment
400       args: -dm_plex_cell segment \
401             -dm_plex_view_numbers_depth 1,0 -dm_plex_view_colors_depth 1,0
402 
403     test:
404       suffix: triangle
405       args: -dm_plex_cell triangle \
406             -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0
407 
408     test:
409       suffix: quadrilateral
410       args: -dm_plex_cell quadrilateral \
411             -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0
412 
413     test:
414       suffix: tensor_segment
415       args: -dm_plex_cell tensor_quad \
416             -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0
417 
418     test:
419       suffix: tetrahedron
420       args: -dm_plex_cell tetrahedron \
421             -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0
422 
423     test:
424       suffix: hexahedron
425       args: -dm_plex_cell hexahedron \
426             -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0 -dm_plex_view_tikzscale 0.3
427 
428     test:
429       suffix: triangular_prism
430       args: -dm_plex_cell triangular_prism \
431             -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0
432 
433     test:
434       suffix: tensor_triangular_prism
435       args: -dm_plex_cell tensor_triangular_prism \
436             -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0
437 
438     test:
439       suffix: tensor_quadrilateral_prism
440       args: -dm_plex_cell tensor_quadrilateral_prism \
441             -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0
442 
443     test:
444       suffix: pyramid
445       args: -dm_plex_cell pyramid \
446             -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0
447 
448   testset:
449     args: -dm_coord_space 0 -dm_plex_reference_cell_domain -ref_arrangements -dm_plex_check_all \
450           -ref_dm_view ::ascii_latex -dm_plex_view_tikzscale 1.0
451 
452     test:
453       suffix: ref_segment
454       args: -dm_plex_cell segment \
455             -dm_plex_view_numbers_depth 1,0 -dm_plex_view_colors_depth 1,0
456 
457     test:
458       suffix: ref_triangle
459       args: -dm_plex_cell triangle \
460             -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0
461 
462     test:
463       suffix: ref_quadrilateral
464       args: -dm_plex_cell quadrilateral \
465             -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0
466 
467     test:
468       suffix: ref_tensor_segment
469       args: -dm_plex_cell tensor_quad \
470             -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0
471 
472     test:
473       suffix: ref_tetrahedron
474       args: -dm_plex_cell tetrahedron \
475             -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0
476 
477     test:
478       suffix: ref_hexahedron
479       args: -dm_plex_cell hexahedron \
480             -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0
481 
482     test:
483       suffix: ref_triangular_prism
484       args: -dm_plex_cell triangular_prism \
485             -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0
486 
487     test:
488       suffix: ref_tensor_triangular_prism
489       args: -dm_plex_cell tensor_triangular_prism \
490             -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0
491 
492     test:
493       suffix: ref_tensor_quadrilateral_prism
494       args: -dm_plex_cell tensor_quadrilateral_prism \
495             -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0
496 
497   # ToBox should recreate the coordinate space since the cell shape changes
498   testset:
499     args: -dm_coord_space 0 -dm_plex_transform_type refine_tobox -ref_arrangements -dm_plex_check_all
500 
501     test:
502       suffix: tobox_triangle
503       args: -dm_plex_reference_cell_domain -dm_plex_cell triangle \
504             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0 -dm_plex_view_tikzscale 1.0
505 
506     test:
507       suffix: tobox_tensor_segment
508       args: -dm_plex_reference_cell_domain -dm_plex_cell tensor_quad \
509             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0 -dm_plex_view_tikzscale 1.0
510 
511     test:
512       suffix: tobox_tetrahedron
513       args: -dm_plex_reference_cell_domain -dm_plex_cell tetrahedron \
514             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0 -dm_plex_view_tikzscale 1.0
515 
516     test:
517       suffix: tobox_triangular_prism
518       args: -dm_plex_reference_cell_domain -dm_plex_cell triangular_prism \
519             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0 -dm_plex_view_tikzscale 1.0
520 
521     test:
522       suffix: tobox_tensor_triangular_prism
523       args: -dm_plex_reference_cell_domain -dm_plex_cell tensor_triangular_prism \
524             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0 -dm_plex_view_tikzscale 1.0
525 
526     test:
527       suffix: tobox_tensor_quadrilateral_prism
528       args: -dm_plex_reference_cell_domain -dm_plex_cell tensor_quadrilateral_prism \
529             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0 -dm_plex_view_tikzscale 1.0
530 
531   testset:
532     args: -dm_coord_space 0 -dm_plex_transform_type refine_alfeld -ref_arrangements -dm_plex_check_all
533 
534     test:
535       suffix: alfeld_triangle
536       args: -dm_plex_reference_cell_domain -dm_plex_cell triangle \
537             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0 -dm_plex_view_tikzscale 1.0
538 
539     test:
540       suffix: alfeld_tetrahedron
541       args: -dm_plex_reference_cell_domain -dm_plex_cell tetrahedron \
542             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0 -dm_plex_view_tikzscale 1.0
543 
544   testset:
545     args: -dm_plex_transform_type refine_sbr -ref_arrangements -dm_plex_check_all
546 
547     # This splits edge 1 of the triangle, and reflects about the added edge
548     test:
549       suffix: sbr_triangle_0
550       args: -dm_plex_reference_cell_domain -dm_plex_cell triangle -dm_plex_transform_sbr_ref_cell 5 -ornts -2,0 \
551             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0 -dm_plex_view_tikzscale 1.0
552 
553     # This splits edge 0 of the triangle, and reflects about the added edge
554     test:
555       suffix: sbr_triangle_1
556       args: -dm_plex_reference_cell_domain -dm_plex_cell triangle -dm_plex_transform_sbr_ref_cell 5 -init_ornt 1 -ornts -3,0 \
557             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0 -dm_plex_view_tikzscale 1.0
558 
559     # This splits edge 2 of the triangle, and reflects about the added edge
560     test:
561       suffix: sbr_triangle_2
562       args: -dm_plex_reference_cell_domain -dm_plex_cell triangle -dm_plex_transform_sbr_ref_cell 5 -init_ornt 2 -ornts -1,0 \
563             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0 -dm_plex_view_tikzscale 1.0
564 
565     # This splits edges 1 and 2 of the triangle
566     test:
567       suffix: sbr_triangle_3
568       args: -dm_plex_reference_cell_domain -dm_plex_cell triangle -dm_plex_transform_sbr_ref_cell 5,6 -ornts 0 \
569             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0 -dm_plex_view_tikzscale 1.0
570 
571     # This splits edges 1 and 0 of the triangle
572     test:
573       suffix: sbr_triangle_4
574       args: -dm_plex_reference_cell_domain -dm_plex_cell triangle -dm_plex_transform_sbr_ref_cell 4,5 -ornts 0 \
575             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0 -dm_plex_view_tikzscale 1.0
576 
577     # This splits edges 0 and 1 of the triangle
578     test:
579       suffix: sbr_triangle_5
580       args: -dm_plex_reference_cell_domain -dm_plex_cell triangle -dm_plex_transform_sbr_ref_cell 5,6 -init_ornt 1 -ornts 0 \
581             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0 -dm_plex_view_tikzscale 1.0
582 
583     # This splits edges 0 and 2 of the triangle
584     test:
585       suffix: sbr_triangle_6
586       args: -dm_plex_reference_cell_domain -dm_plex_cell triangle -dm_plex_transform_sbr_ref_cell 4,5 -init_ornt 1 -ornts 0 \
587             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0 -dm_plex_view_tikzscale 1.0
588 
589     # This splits edges 2 and 0 of the triangle
590     test:
591       suffix: sbr_triangle_7
592       args: -dm_plex_reference_cell_domain -dm_plex_cell triangle -dm_plex_transform_sbr_ref_cell 5,6 -init_ornt 2 -ornts 0 \
593             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0 -dm_plex_view_tikzscale 1.0
594 
595     # This splits edges 2 and 1 of the triangle
596     test:
597       suffix: sbr_triangle_8
598       args: -dm_plex_reference_cell_domain -dm_plex_cell triangle -dm_plex_transform_sbr_ref_cell 4,5 -init_ornt 2 -ornts 0 \
599             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0 -dm_plex_view_tikzscale 1.0
600 
601   testset:
602     args: -dm_plex_transform_type refine_boundary_layer -dm_plex_transform_bl_splits 2 -ref_arrangements -dm_plex_check_all
603 
604     test:
605       suffix: bl_tensor_segment
606       args: -dm_plex_reference_cell_domain -dm_plex_cell tensor_quad \
607             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,1,0 -dm_plex_view_colors_depth 1,1,0 -dm_plex_view_tikzscale 1.0
608 
609     # The subcell check is broken because at orientation 3, the internal triangles do not get properly permuted for the check
610     test:
611       suffix: bl_tensor_triangular_prism
612       requires: TODO
613       args: -dm_plex_reference_cell_domain -dm_plex_cell tensor_triangular_prism \
614             -ref_dm_view ::ascii_latex -dm_plex_view_numbers_depth 1,0,0,0 -dm_plex_view_colors_depth 1,0,0,0 -dm_plex_view_tikzscale 1.0
615 
616 TEST*/
617