xref: /petsc/src/dm/impls/plex/plexcreate.c (revision 6c51210d6fe569640322ed0c7dbbeebbc0acc2ef)
1552f7358SJed Brown #define PETSCDM_DLL
2af0996ceSBarry Smith #include <petsc/private/dmpleximpl.h> /*I   "petscdmplex.h"   I*/
3e8f14785SLisandro Dalcin #include <petsc/private/hashseti.h>   /*I   "petscdmplex.h"   I*/
40c312b8eSJed Brown #include <petscsf.h>
54663dae6SJed Brown #include <petscdmplextransform.h>
69f6c5813SMatthew G. Knepley #include <petscdmlabelephemeral.h>
7b7f5c055SJed Brown #include <petsc/private/kernels/blockmatmult.h>
8b7f5c055SJed Brown #include <petsc/private/kernels/blockinvert.h>
9552f7358SJed Brown 
10708be2fdSJed Brown PetscLogEvent DMPLEX_CreateFromFile, DMPLEX_CreateFromOptions, DMPLEX_BuildFromCellList, DMPLEX_BuildCoordinatesFromCellList;
1158cd63d5SVaclav Hapla 
129318fe57SMatthew G. Knepley /* External function declarations here */
139318fe57SMatthew G. Knepley static PetscErrorCode DMInitialize_Plex(DM dm);
149318fe57SMatthew G. Knepley 
15e600fa54SMatthew G. Knepley /* This copies internal things in the Plex structure that we generally want when making a new, related Plex */
16d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCopy_Internal(DM dmin, PetscBool copyPeriodicity, PetscBool copyOverlap, DM dmout)
17d71ae5a4SJacob Faibussowitsch {
184fb89dddSMatthew G. Knepley   const PetscReal         *maxCell, *Lstart, *L;
1912a88998SMatthew G. Knepley   VecType                  vecType;
2012a88998SMatthew G. Knepley   MatType                  matType;
215962854dSMatthew G. Knepley   PetscBool                dist, useCeed;
226bc1bd01Sksagiyam   DMPlexReorderDefaultFlag reorder;
23e600fa54SMatthew G. Knepley 
24e600fa54SMatthew G. Knepley   PetscFunctionBegin;
2512a88998SMatthew G. Knepley   PetscCall(DMGetVecType(dmin, &vecType));
2612a88998SMatthew G. Knepley   PetscCall(DMSetVecType(dmout, vecType));
2712a88998SMatthew G. Knepley   PetscCall(DMGetMatType(dmin, &matType));
2812a88998SMatthew G. Knepley   PetscCall(DMSetMatType(dmout, matType));
29e600fa54SMatthew G. Knepley   if (copyPeriodicity) {
304fb89dddSMatthew G. Knepley     PetscCall(DMGetPeriodicity(dmin, &maxCell, &Lstart, &L));
314fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dmout, maxCell, Lstart, L));
32e600fa54SMatthew G. Knepley   }
339566063dSJacob Faibussowitsch   PetscCall(DMPlexDistributeGetDefault(dmin, &dist));
349566063dSJacob Faibussowitsch   PetscCall(DMPlexDistributeSetDefault(dmout, dist));
356bc1bd01Sksagiyam   PetscCall(DMPlexReorderGetDefault(dmin, &reorder));
366bc1bd01Sksagiyam   PetscCall(DMPlexReorderSetDefault(dmout, reorder));
375962854dSMatthew G. Knepley   PetscCall(DMPlexGetUseCeed(dmin, &useCeed));
385962854dSMatthew G. Knepley   PetscCall(DMPlexSetUseCeed(dmout, useCeed));
39e600fa54SMatthew G. Knepley   ((DM_Plex *)dmout->data)->useHashLocation = ((DM_Plex *)dmin->data)->useHashLocation;
405962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printSetValues  = ((DM_Plex *)dmin->data)->printSetValues;
415962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printFEM        = ((DM_Plex *)dmin->data)->printFEM;
425962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printFVM        = ((DM_Plex *)dmin->data)->printFVM;
435962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printL2         = ((DM_Plex *)dmin->data)->printL2;
445962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printLocate     = ((DM_Plex *)dmin->data)->printLocate;
455962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printTol        = ((DM_Plex *)dmin->data)->printTol;
461baa6e33SBarry Smith   if (copyOverlap) PetscCall(DMPlexSetOverlap_Plex(dmout, dmin, 0));
473ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
48e600fa54SMatthew G. Knepley }
49e600fa54SMatthew G. Knepley 
509318fe57SMatthew G. Knepley /* Replace dm with the contents of ndm, and then destroy ndm
519318fe57SMatthew G. Knepley    - Share the DM_Plex structure
529318fe57SMatthew G. Knepley    - Share the coordinates
539318fe57SMatthew G. Knepley    - Share the SF
549318fe57SMatthew G. Knepley */
55d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexReplace_Internal(DM dm, DM *ndm)
56d71ae5a4SJacob Faibussowitsch {
579318fe57SMatthew G. Knepley   PetscSF          sf;
589318fe57SMatthew G. Knepley   DM               dmNew = *ndm, coordDM, coarseDM;
599318fe57SMatthew G. Knepley   Vec              coords;
604fb89dddSMatthew G. Knepley   const PetscReal *maxCell, *Lstart, *L;
619318fe57SMatthew G. Knepley   PetscInt         dim, cdim;
629318fe57SMatthew G. Knepley 
639318fe57SMatthew G. Knepley   PetscFunctionBegin;
649318fe57SMatthew G. Knepley   if (dm == dmNew) {
659566063dSJacob Faibussowitsch     PetscCall(DMDestroy(ndm));
663ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
679318fe57SMatthew G. Knepley   }
689318fe57SMatthew G. Knepley   dm->setupcalled = dmNew->setupcalled;
699566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dmNew, &dim));
709566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
719566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dmNew, &cdim));
729566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, cdim));
739566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dmNew, &sf));
749566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dm, sf));
759566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dmNew, &coordDM));
769566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dmNew, &coords));
779566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDM(dm, coordDM));
789566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coords));
796858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dmNew, &coordDM));
806858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocal(dmNew, &coords));
816858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinateDM(dm, coordDM));
826858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinatesLocal(dm, coords));
839318fe57SMatthew G. Knepley   /* Do not want to create the coordinate field if it does not already exist, so do not call DMGetCoordinateField() */
846858538eSMatthew G. Knepley   PetscCall(DMFieldDestroy(&dm->coordinates[0].field));
856858538eSMatthew G. Knepley   dm->coordinates[0].field            = dmNew->coordinates[0].field;
8661a622f3SMatthew G. Knepley   ((DM_Plex *)dmNew->data)->coordFunc = ((DM_Plex *)dm->data)->coordFunc;
874fb89dddSMatthew G. Knepley   PetscCall(DMGetPeriodicity(dmNew, &maxCell, &Lstart, &L));
884fb89dddSMatthew G. Knepley   PetscCall(DMSetPeriodicity(dm, maxCell, Lstart, L));
896925d1c4SMatthew G. Knepley   PetscCall(DMPlexGetGlobalToNaturalSF(dmNew, &sf));
906925d1c4SMatthew G. Knepley   PetscCall(DMPlexSetGlobalToNaturalSF(dm, sf));
919566063dSJacob Faibussowitsch   PetscCall(DMDestroy_Plex(dm));
929566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(dm));
939318fe57SMatthew G. Knepley   dm->data = dmNew->data;
949318fe57SMatthew G. Knepley   ((DM_Plex *)dmNew->data)->refct++;
955f06a3ddSJed Brown   PetscCall(DMPlexGetIsoperiodicFaceSF(dm, &sf));
965f06a3ddSJed Brown   PetscCall(DMPlexSetIsoperiodicFaceSF(dm, sf)); // for the compose function effect on dm
979566063dSJacob Faibussowitsch   PetscCall(DMDestroyLabelLinkList_Internal(dm));
989566063dSJacob Faibussowitsch   PetscCall(DMCopyLabels(dmNew, dm, PETSC_OWN_POINTER, PETSC_TRUE, DM_COPY_LABELS_FAIL));
999566063dSJacob Faibussowitsch   PetscCall(DMGetCoarseDM(dmNew, &coarseDM));
1009566063dSJacob Faibussowitsch   PetscCall(DMSetCoarseDM(dm, coarseDM));
1019566063dSJacob Faibussowitsch   PetscCall(DMDestroy(ndm));
1023ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1039318fe57SMatthew G. Knepley }
1049318fe57SMatthew G. Knepley 
1059318fe57SMatthew G. Knepley /* Swap dm with the contents of dmNew
1069318fe57SMatthew G. Knepley    - Swap the DM_Plex structure
1079318fe57SMatthew G. Knepley    - Swap the coordinates
1089318fe57SMatthew G. Knepley    - Swap the point PetscSF
1099318fe57SMatthew G. Knepley */
110d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexSwap_Static(DM dmA, DM dmB)
111d71ae5a4SJacob Faibussowitsch {
1129318fe57SMatthew G. Knepley   DM          coordDMA, coordDMB;
1139318fe57SMatthew G. Knepley   Vec         coordsA, coordsB;
1149318fe57SMatthew G. Knepley   PetscSF     sfA, sfB;
1159318fe57SMatthew G. Knepley   DMField     fieldTmp;
1169318fe57SMatthew G. Knepley   void       *tmp;
1179318fe57SMatthew G. Knepley   DMLabelLink listTmp;
1189318fe57SMatthew G. Knepley   DMLabel     depthTmp;
1199318fe57SMatthew G. Knepley   PetscInt    tmpI;
1209318fe57SMatthew G. Knepley 
1219318fe57SMatthew G. Knepley   PetscFunctionBegin;
1223ba16761SJacob Faibussowitsch   if (dmA == dmB) PetscFunctionReturn(PETSC_SUCCESS);
1239566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dmA, &sfA));
1249566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dmB, &sfB));
1259566063dSJacob Faibussowitsch   PetscCall(PetscObjectReference((PetscObject)sfA));
1269566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dmA, sfB));
1279566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dmB, sfA));
1289566063dSJacob Faibussowitsch   PetscCall(PetscObjectDereference((PetscObject)sfA));
1299318fe57SMatthew G. Knepley 
1309566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dmA, &coordDMA));
1319566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dmB, &coordDMB));
1329566063dSJacob Faibussowitsch   PetscCall(PetscObjectReference((PetscObject)coordDMA));
1339566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDM(dmA, coordDMB));
1349566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDM(dmB, coordDMA));
1359566063dSJacob Faibussowitsch   PetscCall(PetscObjectDereference((PetscObject)coordDMA));
1369318fe57SMatthew G. Knepley 
1379566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dmA, &coordsA));
1389566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dmB, &coordsB));
1399566063dSJacob Faibussowitsch   PetscCall(PetscObjectReference((PetscObject)coordsA));
1409566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dmA, coordsB));
1419566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dmB, coordsA));
1429566063dSJacob Faibussowitsch   PetscCall(PetscObjectDereference((PetscObject)coordsA));
1439318fe57SMatthew G. Knepley 
1446858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dmA, &coordDMA));
1456858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dmB, &coordDMB));
1466858538eSMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)coordDMA));
1476858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinateDM(dmA, coordDMB));
1486858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinateDM(dmB, coordDMA));
1496858538eSMatthew G. Knepley   PetscCall(PetscObjectDereference((PetscObject)coordDMA));
1506858538eSMatthew G. Knepley 
1516858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocal(dmA, &coordsA));
1526858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocal(dmB, &coordsB));
1536858538eSMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)coordsA));
1546858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinatesLocal(dmA, coordsB));
1556858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinatesLocal(dmB, coordsA));
1566858538eSMatthew G. Knepley   PetscCall(PetscObjectDereference((PetscObject)coordsA));
1576858538eSMatthew G. Knepley 
1586858538eSMatthew G. Knepley   fieldTmp                  = dmA->coordinates[0].field;
1596858538eSMatthew G. Knepley   dmA->coordinates[0].field = dmB->coordinates[0].field;
1606858538eSMatthew G. Knepley   dmB->coordinates[0].field = fieldTmp;
1616858538eSMatthew G. Knepley   fieldTmp                  = dmA->coordinates[1].field;
1626858538eSMatthew G. Knepley   dmA->coordinates[1].field = dmB->coordinates[1].field;
1636858538eSMatthew G. Knepley   dmB->coordinates[1].field = fieldTmp;
1649318fe57SMatthew G. Knepley   tmp                       = dmA->data;
1659318fe57SMatthew G. Knepley   dmA->data                 = dmB->data;
1669318fe57SMatthew G. Knepley   dmB->data                 = tmp;
1679318fe57SMatthew G. Knepley   listTmp                   = dmA->labels;
1689318fe57SMatthew G. Knepley   dmA->labels               = dmB->labels;
1699318fe57SMatthew G. Knepley   dmB->labels               = listTmp;
1709318fe57SMatthew G. Knepley   depthTmp                  = dmA->depthLabel;
1719318fe57SMatthew G. Knepley   dmA->depthLabel           = dmB->depthLabel;
1729318fe57SMatthew G. Knepley   dmB->depthLabel           = depthTmp;
1739318fe57SMatthew G. Knepley   depthTmp                  = dmA->celltypeLabel;
1749318fe57SMatthew G. Knepley   dmA->celltypeLabel        = dmB->celltypeLabel;
1759318fe57SMatthew G. Knepley   dmB->celltypeLabel        = depthTmp;
1769318fe57SMatthew G. Knepley   tmpI                      = dmA->levelup;
1779318fe57SMatthew G. Knepley   dmA->levelup              = dmB->levelup;
1789318fe57SMatthew G. Knepley   dmB->levelup              = tmpI;
1793ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1809318fe57SMatthew G. Knepley }
1819318fe57SMatthew G. Knepley 
1823431e603SJed Brown PetscErrorCode DMPlexInterpolateInPlace_Internal(DM dm)
183d71ae5a4SJacob Faibussowitsch {
1849318fe57SMatthew G. Knepley   DM idm;
1859318fe57SMatthew G. Knepley 
1869318fe57SMatthew G. Knepley   PetscFunctionBegin;
1879566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolate(dm, &idm));
1889566063dSJacob Faibussowitsch   PetscCall(DMPlexCopyCoordinates(dm, idm));
18969d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &idm));
1903ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1919318fe57SMatthew G. Knepley }
1929318fe57SMatthew G. Knepley 
1939318fe57SMatthew G. Knepley /*@C
1949318fe57SMatthew G. Knepley   DMPlexCreateCoordinateSpace - Creates a finite element space for the coordinates
1959318fe57SMatthew G. Knepley 
19620f4b53cSBarry Smith   Collective
1979318fe57SMatthew G. Knepley 
1989318fe57SMatthew G. Knepley   Input Parameters:
19960225df5SJacob Faibussowitsch + dm        - The `DMPLEX`
20020f4b53cSBarry Smith . degree    - The degree of the finite element or `PETSC_DECIDE`
201e44f6aebSMatthew G. Knepley . project   - Flag to project current coordinates into the space
2029318fe57SMatthew G. Knepley - coordFunc - An optional function to map new points from refinement to the surface
2039318fe57SMatthew G. Knepley 
2049318fe57SMatthew G. Knepley   Level: advanced
2059318fe57SMatthew G. Knepley 
2061cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `PetscPointFunc`, `PetscFECreateLagrange()`, `DMGetCoordinateDM()`
2079318fe57SMatthew G. Knepley @*/
208e44f6aebSMatthew G. Knepley PetscErrorCode DMPlexCreateCoordinateSpace(DM dm, PetscInt degree, PetscBool project, PetscPointFunc coordFunc)
209d71ae5a4SJacob Faibussowitsch {
2109318fe57SMatthew G. Knepley   DM_Plex *mesh = (DM_Plex *)dm->data;
211e44f6aebSMatthew G. Knepley   PetscFE  fe   = NULL;
2129318fe57SMatthew G. Knepley   DM       cdm;
2139318fe57SMatthew G. Knepley   PetscInt dim, dE, qorder;
2149318fe57SMatthew G. Knepley 
215e44f6aebSMatthew G. Knepley   PetscFunctionBegin;
2169566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
2179566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &dE));
2189318fe57SMatthew G. Knepley   qorder = degree;
219e44f6aebSMatthew G. Knepley   PetscCall(DMGetCoordinateDM(dm, &cdm));
220d0609cedSBarry Smith   PetscObjectOptionsBegin((PetscObject)cdm);
221dc431b0cSMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-default_quadrature_order", "Quadrature order is one less than quadrature points per edge", "DMPlexCreateCoordinateSpace", qorder, &qorder, NULL, 0));
222d0609cedSBarry Smith   PetscOptionsEnd();
223e44f6aebSMatthew G. Knepley   if (degree >= 0) {
224e44f6aebSMatthew G. Knepley     DMPolytopeType ct = DM_POLYTOPE_UNKNOWN;
225e44f6aebSMatthew G. Knepley     PetscInt       cStart, cEnd, gct;
226dc431b0cSMatthew G. Knepley 
227dc431b0cSMatthew G. Knepley     PetscCall(DMPlexGetHeightStratum(dm, 0, &cStart, &cEnd));
228dc431b0cSMatthew G. Knepley     if (cEnd > cStart) PetscCall(DMPlexGetCellType(dm, cStart, &ct));
229e44f6aebSMatthew G. Knepley     gct = (PetscInt)ct;
230e44f6aebSMatthew G. Knepley     PetscCall(MPIU_Allreduce(MPI_IN_PLACE, &gct, 1, MPIU_INT, MPI_MIN, PetscObjectComm((PetscObject)dm)));
231e44f6aebSMatthew G. Knepley     ct = (DMPolytopeType)gct;
232e44f6aebSMatthew G. Knepley     // Work around current bug in PetscDualSpaceSetUp_Lagrange()
233e44f6aebSMatthew G. Knepley     //   Can be seen in plex_tutorials-ex10_1
234e44f6aebSMatthew G. Knepley     if (ct != DM_POLYTOPE_SEG_PRISM_TENSOR && ct != DM_POLYTOPE_TRI_PRISM_TENSOR && ct != DM_POLYTOPE_QUAD_PRISM_TENSOR) PetscCall(PetscFECreateLagrangeByCell(PETSC_COMM_SELF, dim, dE, ct, degree, qorder, &fe));
2354f9ab2b4SJed Brown   }
236e44f6aebSMatthew G. Knepley   PetscCall(DMSetCoordinateDisc(dm, fe, project));
2379566063dSJacob Faibussowitsch   PetscCall(PetscFEDestroy(&fe));
2389318fe57SMatthew G. Knepley   mesh->coordFunc = coordFunc;
2393ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2409318fe57SMatthew G. Knepley }
2419318fe57SMatthew G. Knepley 
2421df5d5c5SMatthew G. Knepley /*@
2431df5d5c5SMatthew G. Knepley   DMPlexCreateDoublet - Creates a mesh of two cells of the specified type, optionally with later refinement.
2441df5d5c5SMatthew G. Knepley 
245d083f849SBarry Smith   Collective
2461df5d5c5SMatthew G. Knepley 
2471df5d5c5SMatthew G. Knepley   Input Parameters:
248a1cb98faSBarry Smith + comm            - The communicator for the `DM` object
2491df5d5c5SMatthew G. Knepley . dim             - The spatial dimension
2501df5d5c5SMatthew G. Knepley . simplex         - Flag for simplicial cells, otherwise they are tensor product cells
2511df5d5c5SMatthew G. Knepley . interpolate     - Flag to create intermediate mesh pieces (edges, faces)
2521df5d5c5SMatthew G. Knepley - refinementLimit - A nonzero number indicates the largest admissible volume for a refined cell
2531df5d5c5SMatthew G. Knepley 
2541df5d5c5SMatthew G. Knepley   Output Parameter:
25560225df5SJacob Faibussowitsch . newdm - The `DM` object
2561df5d5c5SMatthew G. Knepley 
2571df5d5c5SMatthew G. Knepley   Level: beginner
2581df5d5c5SMatthew G. Knepley 
2591cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMSetType()`, `DMCreate()`
2601df5d5c5SMatthew G. Knepley @*/
261d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateDoublet(MPI_Comm comm, PetscInt dim, PetscBool simplex, PetscBool interpolate, PetscReal refinementLimit, DM *newdm)
262d71ae5a4SJacob Faibussowitsch {
2631df5d5c5SMatthew G. Knepley   DM          dm;
2641df5d5c5SMatthew G. Knepley   PetscMPIInt rank;
2651df5d5c5SMatthew G. Knepley 
2661df5d5c5SMatthew G. Knepley   PetscFunctionBegin;
2679566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, &dm));
2689566063dSJacob Faibussowitsch   PetscCall(DMSetType(dm, DMPLEX));
2699566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
27046139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
2719566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
272ce78fa2fSMatthew G. Knepley   switch (dim) {
273ce78fa2fSMatthew G. Knepley   case 2:
2749566063dSJacob Faibussowitsch     if (simplex) PetscCall(PetscObjectSetName((PetscObject)dm, "triangular"));
2759566063dSJacob Faibussowitsch     else PetscCall(PetscObjectSetName((PetscObject)dm, "quadrilateral"));
276ce78fa2fSMatthew G. Knepley     break;
277ce78fa2fSMatthew G. Knepley   case 3:
2789566063dSJacob Faibussowitsch     if (simplex) PetscCall(PetscObjectSetName((PetscObject)dm, "tetrahedral"));
2799566063dSJacob Faibussowitsch     else PetscCall(PetscObjectSetName((PetscObject)dm, "hexahedral"));
280ce78fa2fSMatthew G. Knepley     break;
281d71ae5a4SJacob Faibussowitsch   default:
282d71ae5a4SJacob Faibussowitsch     SETERRQ(comm, PETSC_ERR_ARG_OUTOFRANGE, "Cannot make meshes for dimension %" PetscInt_FMT, dim);
283ce78fa2fSMatthew G. Knepley   }
2841df5d5c5SMatthew G. Knepley   if (rank) {
2851df5d5c5SMatthew G. Knepley     PetscInt numPoints[2] = {0, 0};
2869566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, NULL, NULL, NULL, NULL));
2871df5d5c5SMatthew G. Knepley   } else {
2881df5d5c5SMatthew G. Knepley     switch (dim) {
2891df5d5c5SMatthew G. Knepley     case 2:
2901df5d5c5SMatthew G. Knepley       if (simplex) {
2911df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]        = {4, 2};
2921df5d5c5SMatthew G. Knepley         PetscInt    coneSize[6]         = {3, 3, 0, 0, 0, 0};
2931df5d5c5SMatthew G. Knepley         PetscInt    cones[6]            = {2, 3, 4, 5, 4, 3};
2941df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
2951df5d5c5SMatthew G. Knepley         PetscScalar vertexCoords[8]     = {-0.5, 0.5, 0.0, 0.0, 0.0, 1.0, 0.5, 0.5};
2961df5d5c5SMatthew G. Knepley 
2979566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
2981df5d5c5SMatthew G. Knepley       } else {
2991df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]        = {6, 2};
3001df5d5c5SMatthew G. Knepley         PetscInt    coneSize[8]         = {4, 4, 0, 0, 0, 0, 0, 0};
3011df5d5c5SMatthew G. Knepley         PetscInt    cones[8]            = {2, 3, 4, 5, 3, 6, 7, 4};
3021df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
3031df5d5c5SMatthew G. Knepley         PetscScalar vertexCoords[12]    = {-1.0, -0.5, 0.0, -0.5, 0.0, 0.5, -1.0, 0.5, 1.0, -0.5, 1.0, 0.5};
3041df5d5c5SMatthew G. Knepley 
3059566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
3061df5d5c5SMatthew G. Knepley       }
3071df5d5c5SMatthew G. Knepley       break;
3081df5d5c5SMatthew G. Knepley     case 3:
3091df5d5c5SMatthew G. Knepley       if (simplex) {
3101df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]        = {5, 2};
3111df5d5c5SMatthew G. Knepley         PetscInt    coneSize[7]         = {4, 4, 0, 0, 0, 0, 0};
3121df5d5c5SMatthew G. Knepley         PetscInt    cones[8]            = {4, 3, 5, 2, 5, 3, 4, 6};
3131df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
3141df5d5c5SMatthew G. Knepley         PetscScalar vertexCoords[15]    = {-1.0, 0.0, 0.0, 0.0, -1.0, 0.0, 0.0, 0.0, 1.0, 0.0, 1.0, 0.0, 1.0, 0.0, 0.0};
3151df5d5c5SMatthew G. Knepley 
3169566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
3171df5d5c5SMatthew G. Knepley       } else {
3181df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]         = {12, 2};
3191df5d5c5SMatthew G. Knepley         PetscInt    coneSize[14]         = {8, 8, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
3201df5d5c5SMatthew G. Knepley         PetscInt    cones[16]            = {2, 3, 4, 5, 6, 7, 8, 9, 5, 4, 10, 11, 7, 12, 13, 8};
3211df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[16] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
3229371c9d4SSatish Balay         PetscScalar vertexCoords[36]     = {-1.0, -0.5, -0.5, -1.0, 0.5, -0.5, 0.0, 0.5, -0.5, 0.0, -0.5, -0.5, -1.0, -0.5, 0.5, 0.0, -0.5, 0.5, 0.0, 0.5, 0.5, -1.0, 0.5, 0.5, 1.0, 0.5, -0.5, 1.0, -0.5, -0.5, 1.0, -0.5, 0.5, 1.0, 0.5, 0.5};
3231df5d5c5SMatthew G. Knepley 
3249566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
3251df5d5c5SMatthew G. Knepley       }
3261df5d5c5SMatthew G. Knepley       break;
327d71ae5a4SJacob Faibussowitsch     default:
328d71ae5a4SJacob Faibussowitsch       SETERRQ(comm, PETSC_ERR_ARG_OUTOFRANGE, "Cannot make meshes for dimension %" PetscInt_FMT, dim);
3291df5d5c5SMatthew G. Knepley     }
3301df5d5c5SMatthew G. Knepley   }
33146139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
3321df5d5c5SMatthew G. Knepley   *newdm = dm;
3331df5d5c5SMatthew G. Knepley   if (refinementLimit > 0.0) {
3341df5d5c5SMatthew G. Knepley     DM          rdm;
3351df5d5c5SMatthew G. Knepley     const char *name;
3361df5d5c5SMatthew G. Knepley 
3379566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementUniform(*newdm, PETSC_FALSE));
3389566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementLimit(*newdm, refinementLimit));
3399566063dSJacob Faibussowitsch     PetscCall(DMRefine(*newdm, comm, &rdm));
3409566063dSJacob Faibussowitsch     PetscCall(PetscObjectGetName((PetscObject)*newdm, &name));
3419566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)rdm, name));
3429566063dSJacob Faibussowitsch     PetscCall(DMDestroy(newdm));
3431df5d5c5SMatthew G. Knepley     *newdm = rdm;
3441df5d5c5SMatthew G. Knepley   }
3451df5d5c5SMatthew G. Knepley   if (interpolate) {
3465fd9971aSMatthew G. Knepley     DM idm;
3471df5d5c5SMatthew G. Knepley 
3489566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*newdm, &idm));
3499566063dSJacob Faibussowitsch     PetscCall(DMDestroy(newdm));
3501df5d5c5SMatthew G. Knepley     *newdm = idm;
3511df5d5c5SMatthew G. Knepley   }
3523ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3531df5d5c5SMatthew G. Knepley }
3541df5d5c5SMatthew G. Knepley 
355d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Tensor_1D_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[])
356d71ae5a4SJacob Faibussowitsch {
3579318fe57SMatthew G. Knepley   const PetscInt numVertices    = 2;
3589318fe57SMatthew G. Knepley   PetscInt       markerRight    = 1;
3599318fe57SMatthew G. Knepley   PetscInt       markerLeft     = 1;
3609318fe57SMatthew G. Knepley   PetscBool      markerSeparate = PETSC_FALSE;
3619318fe57SMatthew G. Knepley   Vec            coordinates;
3629318fe57SMatthew G. Knepley   PetscSection   coordSection;
3639318fe57SMatthew G. Knepley   PetscScalar   *coords;
3649318fe57SMatthew G. Knepley   PetscInt       coordSize;
3659318fe57SMatthew G. Knepley   PetscMPIInt    rank;
3669318fe57SMatthew G. Knepley   PetscInt       cdim = 1, v;
367552f7358SJed Brown 
3689318fe57SMatthew G. Knepley   PetscFunctionBegin;
3699566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
3709318fe57SMatthew G. Knepley   if (markerSeparate) {
3719318fe57SMatthew G. Knepley     markerRight = 2;
3729318fe57SMatthew G. Knepley     markerLeft  = 1;
3739318fe57SMatthew G. Knepley   }
3749566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
375c5853193SPierre Jolivet   if (rank == 0) {
3769566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numVertices));
3779566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
3789566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", 0, markerLeft));
3799566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", 1, markerRight));
3809318fe57SMatthew G. Knepley   }
3819566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
3829566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
3839318fe57SMatthew G. Knepley   /* Build coordinates */
3849566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, cdim));
3859566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
3869566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
3879566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, 0, numVertices));
3889566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, cdim));
3899318fe57SMatthew G. Knepley   for (v = 0; v < numVertices; ++v) {
3909566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, cdim));
3919566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, cdim));
3929318fe57SMatthew G. Knepley   }
3939566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
3949566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
3959566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
3969566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
3979566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
3989566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, cdim));
3999566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
4009566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
4019318fe57SMatthew G. Knepley   coords[0] = lower[0];
4029318fe57SMatthew G. Knepley   coords[1] = upper[0];
4039566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
4049566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
4059566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
4063ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4079318fe57SMatthew G. Knepley }
40826492d91SMatthew G. Knepley 
409d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Tensor_2D_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[])
410d71ae5a4SJacob Faibussowitsch {
4111df21d24SMatthew G. Knepley   const PetscInt numVertices    = (edges[0] + 1) * (edges[1] + 1);
4121df21d24SMatthew G. Knepley   const PetscInt numEdges       = edges[0] * (edges[1] + 1) + (edges[0] + 1) * edges[1];
413552f7358SJed Brown   PetscInt       markerTop      = 1;
414552f7358SJed Brown   PetscInt       markerBottom   = 1;
415552f7358SJed Brown   PetscInt       markerRight    = 1;
416552f7358SJed Brown   PetscInt       markerLeft     = 1;
417552f7358SJed Brown   PetscBool      markerSeparate = PETSC_FALSE;
418552f7358SJed Brown   Vec            coordinates;
419552f7358SJed Brown   PetscSection   coordSection;
420552f7358SJed Brown   PetscScalar   *coords;
421552f7358SJed Brown   PetscInt       coordSize;
422552f7358SJed Brown   PetscMPIInt    rank;
423552f7358SJed Brown   PetscInt       v, vx, vy;
424552f7358SJed Brown 
425552f7358SJed Brown   PetscFunctionBegin;
4269566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
427552f7358SJed Brown   if (markerSeparate) {
4281df21d24SMatthew G. Knepley     markerTop    = 3;
4291df21d24SMatthew G. Knepley     markerBottom = 1;
4301df21d24SMatthew G. Knepley     markerRight  = 2;
4311df21d24SMatthew G. Knepley     markerLeft   = 4;
432552f7358SJed Brown   }
4339566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
434dd400576SPatrick Sanan   if (rank == 0) {
435552f7358SJed Brown     PetscInt e, ex, ey;
436552f7358SJed Brown 
4379566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numEdges + numVertices));
43848a46eb9SPierre Jolivet     for (e = 0; e < numEdges; ++e) PetscCall(DMPlexSetConeSize(dm, e, 2));
4399566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
440552f7358SJed Brown     for (vx = 0; vx <= edges[0]; vx++) {
441552f7358SJed Brown       for (ey = 0; ey < edges[1]; ey++) {
442552f7358SJed Brown         PetscInt edge   = vx * edges[1] + ey + edges[0] * (edges[1] + 1);
443552f7358SJed Brown         PetscInt vertex = ey * (edges[0] + 1) + vx + numEdges;
444da80777bSKarl Rupp         PetscInt cone[2];
445552f7358SJed Brown 
4469371c9d4SSatish Balay         cone[0] = vertex;
4479371c9d4SSatish Balay         cone[1] = vertex + edges[0] + 1;
4489566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, edge, cone));
449552f7358SJed Brown         if (vx == edges[0]) {
4509566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
4519566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
452552f7358SJed Brown           if (ey == edges[1] - 1) {
4539566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
4549566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerRight));
455552f7358SJed Brown           }
456552f7358SJed Brown         } else if (vx == 0) {
4579566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
4589566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
459552f7358SJed Brown           if (ey == edges[1] - 1) {
4609566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
4619566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerLeft));
462552f7358SJed Brown           }
463552f7358SJed Brown         }
464552f7358SJed Brown       }
465552f7358SJed Brown     }
466552f7358SJed Brown     for (vy = 0; vy <= edges[1]; vy++) {
467552f7358SJed Brown       for (ex = 0; ex < edges[0]; ex++) {
468552f7358SJed Brown         PetscInt edge   = vy * edges[0] + ex;
469552f7358SJed Brown         PetscInt vertex = vy * (edges[0] + 1) + ex + numEdges;
470da80777bSKarl Rupp         PetscInt cone[2];
471552f7358SJed Brown 
4729371c9d4SSatish Balay         cone[0] = vertex;
4739371c9d4SSatish Balay         cone[1] = vertex + 1;
4749566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, edge, cone));
475552f7358SJed Brown         if (vy == edges[1]) {
4769566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
4779566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
478552f7358SJed Brown           if (ex == edges[0] - 1) {
4799566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
4809566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerTop));
481552f7358SJed Brown           }
482552f7358SJed Brown         } else if (vy == 0) {
4839566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
4849566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
485552f7358SJed Brown           if (ex == edges[0] - 1) {
4869566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
4879566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerBottom));
488552f7358SJed Brown           }
489552f7358SJed Brown         }
490552f7358SJed Brown       }
491552f7358SJed Brown     }
492552f7358SJed Brown   }
4939566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
4949566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
495552f7358SJed Brown   /* Build coordinates */
4969566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, 2));
4979566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
4989566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
4999566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, numEdges, numEdges + numVertices));
5009566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, 2));
501552f7358SJed Brown   for (v = numEdges; v < numEdges + numVertices; ++v) {
5029566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, 2));
5039566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, 2));
504552f7358SJed Brown   }
5059566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
5069566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
5079566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
5089566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
5099566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
5109566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, 2));
5119566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
5129566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
513552f7358SJed Brown   for (vy = 0; vy <= edges[1]; ++vy) {
514552f7358SJed Brown     for (vx = 0; vx <= edges[0]; ++vx) {
515552f7358SJed Brown       coords[(vy * (edges[0] + 1) + vx) * 2 + 0] = lower[0] + ((upper[0] - lower[0]) / edges[0]) * vx;
516552f7358SJed Brown       coords[(vy * (edges[0] + 1) + vx) * 2 + 1] = lower[1] + ((upper[1] - lower[1]) / edges[1]) * vy;
517552f7358SJed Brown     }
518552f7358SJed Brown   }
5199566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
5209566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
5219566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
5223ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
523552f7358SJed Brown }
524552f7358SJed Brown 
525d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Tensor_3D_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt faces[])
526d71ae5a4SJacob Faibussowitsch {
5279e8abbc3SMichael Lange   PetscInt     vertices[3], numVertices;
5287b59f5a9SMichael Lange   PetscInt     numFaces       = 2 * faces[0] * faces[1] + 2 * faces[1] * faces[2] + 2 * faces[0] * faces[2];
529c2df9bbfSMatthew G. Knepley   PetscInt     markerTop      = 1;
530c2df9bbfSMatthew G. Knepley   PetscInt     markerBottom   = 1;
531c2df9bbfSMatthew G. Knepley   PetscInt     markerFront    = 1;
532c2df9bbfSMatthew G. Knepley   PetscInt     markerBack     = 1;
533c2df9bbfSMatthew G. Knepley   PetscInt     markerRight    = 1;
534c2df9bbfSMatthew G. Knepley   PetscInt     markerLeft     = 1;
535c2df9bbfSMatthew G. Knepley   PetscBool    markerSeparate = PETSC_FALSE;
536552f7358SJed Brown   Vec          coordinates;
537552f7358SJed Brown   PetscSection coordSection;
538552f7358SJed Brown   PetscScalar *coords;
539552f7358SJed Brown   PetscInt     coordSize;
540552f7358SJed Brown   PetscMPIInt  rank;
541552f7358SJed Brown   PetscInt     v, vx, vy, vz;
5427b59f5a9SMichael Lange   PetscInt     voffset, iface = 0, cone[4];
543552f7358SJed Brown 
544552f7358SJed Brown   PetscFunctionBegin;
5451dca8a05SBarry Smith   PetscCheck(faces[0] >= 1 && faces[1] >= 1 && faces[2] >= 1, PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Must have at least 1 face per side");
5469566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
547c2df9bbfSMatthew G. Knepley   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
548c2df9bbfSMatthew G. Knepley   if (markerSeparate) {
549c2df9bbfSMatthew G. Knepley     markerBottom = 1;
550c2df9bbfSMatthew G. Knepley     markerTop    = 2;
551c2df9bbfSMatthew G. Knepley     markerFront  = 3;
552c2df9bbfSMatthew G. Knepley     markerBack   = 4;
553c2df9bbfSMatthew G. Knepley     markerRight  = 5;
554c2df9bbfSMatthew G. Knepley     markerLeft   = 6;
555c2df9bbfSMatthew G. Knepley   }
5569371c9d4SSatish Balay   vertices[0] = faces[0] + 1;
5579371c9d4SSatish Balay   vertices[1] = faces[1] + 1;
5589371c9d4SSatish Balay   vertices[2] = faces[2] + 1;
5599e8abbc3SMichael Lange   numVertices = vertices[0] * vertices[1] * vertices[2];
560dd400576SPatrick Sanan   if (rank == 0) {
561552f7358SJed Brown     PetscInt f;
562552f7358SJed Brown 
5639566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numFaces + numVertices));
56448a46eb9SPierre Jolivet     for (f = 0; f < numFaces; ++f) PetscCall(DMPlexSetConeSize(dm, f, 4));
5659566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
5667b59f5a9SMichael Lange 
5677b59f5a9SMichael Lange     /* Side 0 (Top) */
5687b59f5a9SMichael Lange     for (vy = 0; vy < faces[1]; vy++) {
5697b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
5707b59f5a9SMichael Lange         voffset = numFaces + vertices[0] * vertices[1] * (vertices[2] - 1) + vy * vertices[0] + vx;
5719371c9d4SSatish Balay         cone[0] = voffset;
5729371c9d4SSatish Balay         cone[1] = voffset + 1;
5739371c9d4SSatish Balay         cone[2] = voffset + vertices[0] + 1;
5749371c9d4SSatish Balay         cone[3] = voffset + vertices[0];
5759566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
576c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerTop));
577c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerTop));
578c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerTop));
579c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerTop));
580c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 1, markerTop));
5817b59f5a9SMichael Lange         iface++;
582552f7358SJed Brown       }
583552f7358SJed Brown     }
5847b59f5a9SMichael Lange 
5857b59f5a9SMichael Lange     /* Side 1 (Bottom) */
5867b59f5a9SMichael Lange     for (vy = 0; vy < faces[1]; vy++) {
5877b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
5887b59f5a9SMichael Lange         voffset = numFaces + vy * (faces[0] + 1) + vx;
5899371c9d4SSatish Balay         cone[0] = voffset + 1;
5909371c9d4SSatish Balay         cone[1] = voffset;
5919371c9d4SSatish Balay         cone[2] = voffset + vertices[0];
5929371c9d4SSatish Balay         cone[3] = voffset + vertices[0] + 1;
5939566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
594c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerBottom));
595c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerBottom));
596c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerBottom));
597c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerBottom));
598c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 1, markerBottom));
5997b59f5a9SMichael Lange         iface++;
600552f7358SJed Brown       }
601552f7358SJed Brown     }
6027b59f5a9SMichael Lange 
6037b59f5a9SMichael Lange     /* Side 2 (Front) */
6047b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
6057b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
6067b59f5a9SMichael Lange         voffset = numFaces + vz * vertices[0] * vertices[1] + vx;
6079371c9d4SSatish Balay         cone[0] = voffset;
6089371c9d4SSatish Balay         cone[1] = voffset + 1;
6099371c9d4SSatish Balay         cone[2] = voffset + vertices[0] * vertices[1] + 1;
6109371c9d4SSatish Balay         cone[3] = voffset + vertices[0] * vertices[1];
6119566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
612c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerFront));
613c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerFront));
614c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerFront));
615c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 0, markerFront));
616c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 1, markerFront));
6177b59f5a9SMichael Lange         iface++;
618552f7358SJed Brown       }
6197b59f5a9SMichael Lange     }
6207b59f5a9SMichael Lange 
6217b59f5a9SMichael Lange     /* Side 3 (Back) */
6227b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
6237b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
6247b59f5a9SMichael Lange         voffset = numFaces + vz * vertices[0] * vertices[1] + vertices[0] * (vertices[1] - 1) + vx;
6259371c9d4SSatish Balay         cone[0] = voffset + vertices[0] * vertices[1];
6269371c9d4SSatish Balay         cone[1] = voffset + vertices[0] * vertices[1] + 1;
6279371c9d4SSatish Balay         cone[2] = voffset + 1;
6289371c9d4SSatish Balay         cone[3] = voffset;
6299566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
630c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerBack));
631c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerBack));
632c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerBack));
633c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 0, markerBack));
634c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 1, markerBack));
6357b59f5a9SMichael Lange         iface++;
6367b59f5a9SMichael Lange       }
6377b59f5a9SMichael Lange     }
6387b59f5a9SMichael Lange 
6397b59f5a9SMichael Lange     /* Side 4 (Left) */
6407b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
6417b59f5a9SMichael Lange       for (vy = 0; vy < faces[1]; vy++) {
6427b59f5a9SMichael Lange         voffset = numFaces + vz * vertices[0] * vertices[1] + vy * vertices[0];
6439371c9d4SSatish Balay         cone[0] = voffset;
6449371c9d4SSatish Balay         cone[1] = voffset + vertices[0] * vertices[1];
6459371c9d4SSatish Balay         cone[2] = voffset + vertices[0] * vertices[1] + vertices[0];
6469371c9d4SSatish Balay         cone[3] = voffset + vertices[0];
6479566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
648c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerLeft));
649c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerLeft));
650c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerLeft));
651c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[1] + 0, markerLeft));
652c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + vertices[0], markerLeft));
6537b59f5a9SMichael Lange         iface++;
6547b59f5a9SMichael Lange       }
6557b59f5a9SMichael Lange     }
6567b59f5a9SMichael Lange 
6577b59f5a9SMichael Lange     /* Side 5 (Right) */
6587b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
6597b59f5a9SMichael Lange       for (vy = 0; vy < faces[1]; vy++) {
660aab5bcd8SJed Brown         voffset = numFaces + vz * vertices[0] * vertices[1] + vy * vertices[0] + faces[0];
6619371c9d4SSatish Balay         cone[0] = voffset + vertices[0] * vertices[1];
6629371c9d4SSatish Balay         cone[1] = voffset;
6639371c9d4SSatish Balay         cone[2] = voffset + vertices[0];
6649371c9d4SSatish Balay         cone[3] = voffset + vertices[0] * vertices[1] + vertices[0];
6659566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
666c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerRight));
667c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerRight));
668c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerRight));
669c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 0, markerRight));
670c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + vertices[0], markerRight));
6717b59f5a9SMichael Lange         iface++;
6727b59f5a9SMichael Lange       }
673552f7358SJed Brown     }
674552f7358SJed Brown   }
6759566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
6769566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
677552f7358SJed Brown   /* Build coordinates */
6789566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, 3));
6799566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
6809566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
6819566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, numFaces, numFaces + numVertices));
6829566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, 3));
683552f7358SJed Brown   for (v = numFaces; v < numFaces + numVertices; ++v) {
6849566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, 3));
6859566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, 3));
686552f7358SJed Brown   }
6879566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
6889566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
6899566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
6909566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
6919566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
6929566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, 3));
6939566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
6949566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
695552f7358SJed Brown   for (vz = 0; vz <= faces[2]; ++vz) {
696552f7358SJed Brown     for (vy = 0; vy <= faces[1]; ++vy) {
697552f7358SJed Brown       for (vx = 0; vx <= faces[0]; ++vx) {
698552f7358SJed Brown         coords[((vz * (faces[1] + 1) + vy) * (faces[0] + 1) + vx) * 3 + 0] = lower[0] + ((upper[0] - lower[0]) / faces[0]) * vx;
699552f7358SJed Brown         coords[((vz * (faces[1] + 1) + vy) * (faces[0] + 1) + vx) * 3 + 1] = lower[1] + ((upper[1] - lower[1]) / faces[1]) * vy;
700552f7358SJed Brown         coords[((vz * (faces[1] + 1) + vy) * (faces[0] + 1) + vx) * 3 + 2] = lower[2] + ((upper[2] - lower[2]) / faces[2]) * vz;
701552f7358SJed Brown       }
702552f7358SJed Brown     }
703552f7358SJed Brown   }
7049566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
7059566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
7069566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
7073ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
708552f7358SJed Brown }
709552f7358SJed Brown 
710d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Internal(DM dm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], PetscBool interpolate)
711d71ae5a4SJacob Faibussowitsch {
7129318fe57SMatthew G. Knepley   PetscFunctionBegin;
7139318fe57SMatthew G. Knepley   PetscValidLogicalCollectiveInt(dm, dim, 2);
71446139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
7159566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim - 1));
7169566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, dim));
7179318fe57SMatthew G. Knepley   switch (dim) {
718d71ae5a4SJacob Faibussowitsch   case 1:
719d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexCreateBoxSurfaceMesh_Tensor_1D_Internal(dm, lower, upper, faces));
720d71ae5a4SJacob Faibussowitsch     break;
721d71ae5a4SJacob Faibussowitsch   case 2:
722d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexCreateBoxSurfaceMesh_Tensor_2D_Internal(dm, lower, upper, faces));
723d71ae5a4SJacob Faibussowitsch     break;
724d71ae5a4SJacob Faibussowitsch   case 3:
725d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexCreateBoxSurfaceMesh_Tensor_3D_Internal(dm, lower, upper, faces));
726d71ae5a4SJacob Faibussowitsch     break;
727d71ae5a4SJacob Faibussowitsch   default:
728d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Dimension not supported: %" PetscInt_FMT, dim);
7299318fe57SMatthew G. Knepley   }
73046139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
7319566063dSJacob Faibussowitsch   if (interpolate) PetscCall(DMPlexInterpolateInPlace_Internal(dm));
7323ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
7339318fe57SMatthew G. Knepley }
7349318fe57SMatthew G. Knepley 
7359318fe57SMatthew G. Knepley /*@C
7369318fe57SMatthew G. Knepley   DMPlexCreateBoxSurfaceMesh - Creates a mesh on the surface of the tensor product of unit intervals (box) using tensor cells (hexahedra).
7379318fe57SMatthew G. Knepley 
7389318fe57SMatthew G. Knepley   Collective
7399318fe57SMatthew G. Knepley 
7409318fe57SMatthew G. Knepley   Input Parameters:
741a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
74220f4b53cSBarry Smith . dim         - The spatial dimension of the box, so the resulting mesh is has dimension `dim`-1
74320f4b53cSBarry Smith . faces       - Number of faces per dimension, or `NULL` for (1,) in 1D and (2, 2) in 2D and (1, 1, 1) in 3D
74420f4b53cSBarry Smith . lower       - The lower left corner, or `NULL` for (0, 0, 0)
74520f4b53cSBarry Smith . upper       - The upper right corner, or `NULL` for (1, 1, 1)
7469318fe57SMatthew G. Knepley - interpolate - Flag to create intermediate mesh pieces (edges, faces)
7479318fe57SMatthew G. Knepley 
7489318fe57SMatthew G. Knepley   Output Parameter:
749a1cb98faSBarry Smith . dm - The `DM` object
7509318fe57SMatthew G. Knepley 
7519318fe57SMatthew G. Knepley   Level: beginner
7529318fe57SMatthew G. Knepley 
7531cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMSetFromOptions()`, `DMPlexCreateBoxMesh()`, `DMPlexCreateFromFile()`, `DMSetType()`, `DMCreate()`
7549318fe57SMatthew G. Knepley @*/
755d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateBoxSurfaceMesh(MPI_Comm comm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], PetscBool interpolate, DM *dm)
756d71ae5a4SJacob Faibussowitsch {
7579318fe57SMatthew G. Knepley   PetscInt  fac[3] = {1, 1, 1};
7589318fe57SMatthew G. Knepley   PetscReal low[3] = {0, 0, 0};
7599318fe57SMatthew G. Knepley   PetscReal upp[3] = {1, 1, 1};
7609318fe57SMatthew G. Knepley 
7619318fe57SMatthew G. Knepley   PetscFunctionBegin;
7629566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
7639566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
7649566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBoxSurfaceMesh_Internal(*dm, dim, faces ? faces : fac, lower ? lower : low, upper ? upper : upp, interpolate));
7653ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
7669318fe57SMatthew G. Knepley }
7679318fe57SMatthew G. Knepley 
768d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateLineMesh_Internal(DM dm, PetscInt segments, PetscReal lower, PetscReal upper, DMBoundaryType bd)
769d71ae5a4SJacob Faibussowitsch {
770fdbf62faSLisandro Dalcin   PetscInt     i, fStart, fEnd, numCells = 0, numVerts = 0;
771fdbf62faSLisandro Dalcin   PetscInt     numPoints[2], *coneSize, *cones, *coneOrientations;
772fdbf62faSLisandro Dalcin   PetscScalar *vertexCoords;
773fdbf62faSLisandro Dalcin   PetscReal    L, maxCell;
774fdbf62faSLisandro Dalcin   PetscBool    markerSeparate = PETSC_FALSE;
775fdbf62faSLisandro Dalcin   PetscInt     markerLeft = 1, faceMarkerLeft = 1;
776fdbf62faSLisandro Dalcin   PetscInt     markerRight = 1, faceMarkerRight = 2;
777fdbf62faSLisandro Dalcin   PetscBool    wrap = (bd == DM_BOUNDARY_PERIODIC || bd == DM_BOUNDARY_TWIST) ? PETSC_TRUE : PETSC_FALSE;
778fdbf62faSLisandro Dalcin   PetscMPIInt  rank;
779fdbf62faSLisandro Dalcin 
780fdbf62faSLisandro Dalcin   PetscFunctionBegin;
7814f572ea9SToby Isaac   PetscAssertPointer(dm, 1);
782fdbf62faSLisandro Dalcin 
7839566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, 1));
7849566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "marker"));
7859566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "Face Sets"));
786fdbf62faSLisandro Dalcin 
7879566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
788dd400576SPatrick Sanan   if (rank == 0) numCells = segments;
789dd400576SPatrick Sanan   if (rank == 0) numVerts = segments + (wrap ? 0 : 1);
790fdbf62faSLisandro Dalcin 
7919371c9d4SSatish Balay   numPoints[0] = numVerts;
7929371c9d4SSatish Balay   numPoints[1] = numCells;
7939566063dSJacob Faibussowitsch   PetscCall(PetscMalloc4(numCells + numVerts, &coneSize, numCells * 2, &cones, numCells + numVerts, &coneOrientations, numVerts, &vertexCoords));
7949566063dSJacob Faibussowitsch   PetscCall(PetscArrayzero(coneOrientations, numCells + numVerts));
795ad540459SPierre Jolivet   for (i = 0; i < numCells; ++i) coneSize[i] = 2;
796ad540459SPierre Jolivet   for (i = 0; i < numVerts; ++i) coneSize[numCells + i] = 0;
7979371c9d4SSatish Balay   for (i = 0; i < numCells; ++i) {
7989371c9d4SSatish Balay     cones[2 * i]     = numCells + i % numVerts;
7999371c9d4SSatish Balay     cones[2 * i + 1] = numCells + (i + 1) % numVerts;
8009371c9d4SSatish Balay   }
801ad540459SPierre Jolivet   for (i = 0; i < numVerts; ++i) vertexCoords[i] = lower + (upper - lower) * ((PetscReal)i / (PetscReal)numCells);
8029566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
8039566063dSJacob Faibussowitsch   PetscCall(PetscFree4(coneSize, cones, coneOrientations, vertexCoords));
804fdbf62faSLisandro Dalcin 
8059566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
8069371c9d4SSatish Balay   if (markerSeparate) {
8079371c9d4SSatish Balay     markerLeft  = faceMarkerLeft;
8089371c9d4SSatish Balay     markerRight = faceMarkerRight;
8099371c9d4SSatish Balay   }
810dd400576SPatrick Sanan   if (!wrap && rank == 0) {
8119566063dSJacob Faibussowitsch     PetscCall(DMPlexGetHeightStratum(dm, 1, &fStart, &fEnd));
8129566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", fStart, markerLeft));
8139566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", fEnd - 1, markerRight));
8149566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "Face Sets", fStart, faceMarkerLeft));
8159566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "Face Sets", fEnd - 1, faceMarkerRight));
816fdbf62faSLisandro Dalcin   }
817fdbf62faSLisandro Dalcin   if (wrap) {
818fdbf62faSLisandro Dalcin     L       = upper - lower;
819fdbf62faSLisandro Dalcin     maxCell = (PetscReal)1.1 * (L / (PetscReal)PetscMax(1, segments));
8204fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dm, &maxCell, &lower, &L));
821fdbf62faSLisandro Dalcin   }
8229566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
8233ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
824fdbf62faSLisandro Dalcin }
825fdbf62faSLisandro Dalcin 
826d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxMesh_Simplex_Internal(DM dm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[], PetscBool interpolate)
827d71ae5a4SJacob Faibussowitsch {
8289318fe57SMatthew G. Knepley   DM      boundary, vol;
829c22d3578SMatthew G. Knepley   DMLabel bdlabel;
830d6218766SMatthew G. Knepley 
831d6218766SMatthew G. Knepley   PetscFunctionBegin;
8324f572ea9SToby Isaac   PetscAssertPointer(dm, 1);
833c22d3578SMatthew G. Knepley   for (PetscInt i = 0; i < dim; ++i) PetscCheck(periodicity[i] == DM_BOUNDARY_NONE, PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Periodicity is not supported for simplex meshes");
8349566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &boundary));
8359566063dSJacob Faibussowitsch   PetscCall(DMSetType(boundary, DMPLEX));
8369566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBoxSurfaceMesh_Internal(boundary, dim, faces, lower, upper, PETSC_FALSE));
8379566063dSJacob Faibussowitsch   PetscCall(DMPlexGenerate(boundary, NULL, interpolate, &vol));
838c22d3578SMatthew G. Knepley   PetscCall(DMGetLabel(vol, "marker", &bdlabel));
839c22d3578SMatthew G. Knepley   if (bdlabel) PetscCall(DMPlexLabelComplete(vol, bdlabel));
8405de52c6dSVaclav Hapla   PetscCall(DMPlexCopy_Internal(dm, PETSC_TRUE, PETSC_FALSE, vol));
84169d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
8429566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&boundary));
8433ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
844d6218766SMatthew G. Knepley }
845d6218766SMatthew G. Knepley 
846d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateCubeMesh_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[], DMBoundaryType bdX, DMBoundaryType bdY, DMBoundaryType bdZ)
847d71ae5a4SJacob Faibussowitsch {
848ed0e4b50SMatthew G. Knepley   DMLabel     cutLabel  = NULL;
849f4eb4c5dSMatthew G. Knepley   PetscInt    markerTop = 1, faceMarkerTop = 1;
850f4eb4c5dSMatthew G. Knepley   PetscInt    markerBottom = 1, faceMarkerBottom = 1;
851f4eb4c5dSMatthew G. Knepley   PetscInt    markerFront = 1, faceMarkerFront = 1;
852f4eb4c5dSMatthew G. Knepley   PetscInt    markerBack = 1, faceMarkerBack = 1;
853f4eb4c5dSMatthew G. Knepley   PetscInt    markerRight = 1, faceMarkerRight = 1;
854f4eb4c5dSMatthew G. Knepley   PetscInt    markerLeft = 1, faceMarkerLeft = 1;
8553dfda0b1SToby Isaac   PetscInt    dim;
856d8211ee3SMatthew G. Knepley   PetscBool   markerSeparate = PETSC_FALSE, cutMarker = PETSC_FALSE;
8573dfda0b1SToby Isaac   PetscMPIInt rank;
8583dfda0b1SToby Isaac 
8593dfda0b1SToby Isaac   PetscFunctionBegin;
8609566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
8619566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
8629566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "marker"));
8639566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "Face Sets"));
8649566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_periodic_cut", &cutMarker, NULL));
8659371c9d4SSatish Balay   if (bdX == DM_BOUNDARY_PERIODIC || bdX == DM_BOUNDARY_TWIST || bdY == DM_BOUNDARY_PERIODIC || bdY == DM_BOUNDARY_TWIST || bdZ == DM_BOUNDARY_PERIODIC || bdZ == DM_BOUNDARY_TWIST) {
8669371c9d4SSatish Balay     if (cutMarker) {
8679371c9d4SSatish Balay       PetscCall(DMCreateLabel(dm, "periodic_cut"));
8689371c9d4SSatish Balay       PetscCall(DMGetLabel(dm, "periodic_cut", &cutLabel));
8699371c9d4SSatish Balay     }
870d8211ee3SMatthew G. Knepley   }
8713dfda0b1SToby Isaac   switch (dim) {
8723dfda0b1SToby Isaac   case 2:
873f4eb4c5dSMatthew G. Knepley     faceMarkerTop    = 3;
874f4eb4c5dSMatthew G. Knepley     faceMarkerBottom = 1;
875f4eb4c5dSMatthew G. Knepley     faceMarkerRight  = 2;
876f4eb4c5dSMatthew G. Knepley     faceMarkerLeft   = 4;
8773dfda0b1SToby Isaac     break;
8783dfda0b1SToby Isaac   case 3:
879f4eb4c5dSMatthew G. Knepley     faceMarkerBottom = 1;
880f4eb4c5dSMatthew G. Knepley     faceMarkerTop    = 2;
881f4eb4c5dSMatthew G. Knepley     faceMarkerFront  = 3;
882f4eb4c5dSMatthew G. Knepley     faceMarkerBack   = 4;
883f4eb4c5dSMatthew G. Knepley     faceMarkerRight  = 5;
884f4eb4c5dSMatthew G. Knepley     faceMarkerLeft   = 6;
8853dfda0b1SToby Isaac     break;
886d71ae5a4SJacob Faibussowitsch   default:
887d71ae5a4SJacob Faibussowitsch     SETERRQ(PETSC_COMM_SELF, PETSC_ERR_SUP, "Dimension %" PetscInt_FMT " not supported", dim);
8883dfda0b1SToby Isaac   }
8899566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
890f4eb4c5dSMatthew G. Knepley   if (markerSeparate) {
891f4eb4c5dSMatthew G. Knepley     markerBottom = faceMarkerBottom;
892f4eb4c5dSMatthew G. Knepley     markerTop    = faceMarkerTop;
893f4eb4c5dSMatthew G. Knepley     markerFront  = faceMarkerFront;
894f4eb4c5dSMatthew G. Knepley     markerBack   = faceMarkerBack;
895f4eb4c5dSMatthew G. Knepley     markerRight  = faceMarkerRight;
896f4eb4c5dSMatthew G. Knepley     markerLeft   = faceMarkerLeft;
8973dfda0b1SToby Isaac   }
8983dfda0b1SToby Isaac   {
899dd400576SPatrick Sanan     const PetscInt numXEdges    = rank == 0 ? edges[0] : 0;
900dd400576SPatrick Sanan     const PetscInt numYEdges    = rank == 0 ? edges[1] : 0;
901dd400576SPatrick Sanan     const PetscInt numZEdges    = rank == 0 ? edges[2] : 0;
902dd400576SPatrick Sanan     const PetscInt numXVertices = rank == 0 ? (bdX == DM_BOUNDARY_PERIODIC || bdX == DM_BOUNDARY_TWIST ? edges[0] : edges[0] + 1) : 0;
903dd400576SPatrick Sanan     const PetscInt numYVertices = rank == 0 ? (bdY == DM_BOUNDARY_PERIODIC || bdY == DM_BOUNDARY_TWIST ? edges[1] : edges[1] + 1) : 0;
904dd400576SPatrick Sanan     const PetscInt numZVertices = rank == 0 ? (bdZ == DM_BOUNDARY_PERIODIC || bdZ == DM_BOUNDARY_TWIST ? edges[2] : edges[2] + 1) : 0;
9053dfda0b1SToby Isaac     const PetscInt numCells     = numXEdges * numYEdges * numZEdges;
9063dfda0b1SToby Isaac     const PetscInt numXFaces    = numYEdges * numZEdges;
9073dfda0b1SToby Isaac     const PetscInt numYFaces    = numXEdges * numZEdges;
9083dfda0b1SToby Isaac     const PetscInt numZFaces    = numXEdges * numYEdges;
9093dfda0b1SToby Isaac     const PetscInt numTotXFaces = numXVertices * numXFaces;
9103dfda0b1SToby Isaac     const PetscInt numTotYFaces = numYVertices * numYFaces;
9113dfda0b1SToby Isaac     const PetscInt numTotZFaces = numZVertices * numZFaces;
9123dfda0b1SToby Isaac     const PetscInt numFaces     = numTotXFaces + numTotYFaces + numTotZFaces;
9133dfda0b1SToby Isaac     const PetscInt numTotXEdges = numXEdges * numYVertices * numZVertices;
9143dfda0b1SToby Isaac     const PetscInt numTotYEdges = numYEdges * numXVertices * numZVertices;
9153dfda0b1SToby Isaac     const PetscInt numTotZEdges = numZEdges * numXVertices * numYVertices;
9163dfda0b1SToby Isaac     const PetscInt numVertices  = numXVertices * numYVertices * numZVertices;
9173dfda0b1SToby Isaac     const PetscInt numEdges     = numTotXEdges + numTotYEdges + numTotZEdges;
9183dfda0b1SToby Isaac     const PetscInt firstVertex  = (dim == 2) ? numFaces : numCells;
9193dfda0b1SToby Isaac     const PetscInt firstXFace   = (dim == 2) ? 0 : numCells + numVertices;
9203dfda0b1SToby Isaac     const PetscInt firstYFace   = firstXFace + numTotXFaces;
9213dfda0b1SToby Isaac     const PetscInt firstZFace   = firstYFace + numTotYFaces;
9223dfda0b1SToby Isaac     const PetscInt firstXEdge   = numCells + numFaces + numVertices;
9233dfda0b1SToby Isaac     const PetscInt firstYEdge   = firstXEdge + numTotXEdges;
9243dfda0b1SToby Isaac     const PetscInt firstZEdge   = firstYEdge + numTotYEdges;
9253dfda0b1SToby Isaac     Vec            coordinates;
9263dfda0b1SToby Isaac     PetscSection   coordSection;
9273dfda0b1SToby Isaac     PetscScalar   *coords;
9283dfda0b1SToby Isaac     PetscInt       coordSize;
9293dfda0b1SToby Isaac     PetscInt       v, vx, vy, vz;
9303dfda0b1SToby Isaac     PetscInt       c, f, fx, fy, fz, e, ex, ey, ez;
9313dfda0b1SToby Isaac 
9329566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numCells + numFaces + numEdges + numVertices));
93348a46eb9SPierre Jolivet     for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 6));
93448a46eb9SPierre Jolivet     for (f = firstXFace; f < firstXFace + numFaces; ++f) PetscCall(DMPlexSetConeSize(dm, f, 4));
93548a46eb9SPierre Jolivet     for (e = firstXEdge; e < firstXEdge + numEdges; ++e) PetscCall(DMPlexSetConeSize(dm, e, 2));
9369566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
9373dfda0b1SToby Isaac     /* Build cells */
9383dfda0b1SToby Isaac     for (fz = 0; fz < numZEdges; ++fz) {
9393dfda0b1SToby Isaac       for (fy = 0; fy < numYEdges; ++fy) {
9403dfda0b1SToby Isaac         for (fx = 0; fx < numXEdges; ++fx) {
9413dfda0b1SToby Isaac           PetscInt cell  = (fz * numYEdges + fy) * numXEdges + fx;
9423dfda0b1SToby Isaac           PetscInt faceB = firstZFace + (fy * numXEdges + fx) * numZVertices + fz;
9433dfda0b1SToby Isaac           PetscInt faceT = firstZFace + (fy * numXEdges + fx) * numZVertices + ((fz + 1) % numZVertices);
9443dfda0b1SToby Isaac           PetscInt faceF = firstYFace + (fz * numXEdges + fx) * numYVertices + fy;
9453dfda0b1SToby Isaac           PetscInt faceK = firstYFace + (fz * numXEdges + fx) * numYVertices + ((fy + 1) % numYVertices);
9463dfda0b1SToby Isaac           PetscInt faceL = firstXFace + (fz * numYEdges + fy) * numXVertices + fx;
9473dfda0b1SToby Isaac           PetscInt faceR = firstXFace + (fz * numYEdges + fy) * numXVertices + ((fx + 1) % numXVertices);
9483dfda0b1SToby Isaac           /* B,  T,  F,  K,  R,  L */
949b5a892a1SMatthew G. Knepley           PetscInt ornt[6] = {-2, 0, 0, -3, 0, -2}; /* ??? */
95042206facSLisandro Dalcin           PetscInt cone[6];
9513dfda0b1SToby Isaac 
9523dfda0b1SToby Isaac           /* no boundary twisting in 3D */
9539371c9d4SSatish Balay           cone[0] = faceB;
9549371c9d4SSatish Balay           cone[1] = faceT;
9559371c9d4SSatish Balay           cone[2] = faceF;
9569371c9d4SSatish Balay           cone[3] = faceK;
9579371c9d4SSatish Balay           cone[4] = faceR;
9589371c9d4SSatish Balay           cone[5] = faceL;
9599566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, cell, cone));
9609566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, cell, ornt));
9619566063dSJacob Faibussowitsch           if (bdX != DM_BOUNDARY_NONE && fx == numXEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, cell, 2));
9629566063dSJacob Faibussowitsch           if (bdY != DM_BOUNDARY_NONE && fy == numYEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, cell, 2));
9639566063dSJacob Faibussowitsch           if (bdZ != DM_BOUNDARY_NONE && fz == numZEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, cell, 2));
9643dfda0b1SToby Isaac         }
9653dfda0b1SToby Isaac       }
9663dfda0b1SToby Isaac     }
9673dfda0b1SToby Isaac     /* Build x faces */
9683dfda0b1SToby Isaac     for (fz = 0; fz < numZEdges; ++fz) {
9693dfda0b1SToby Isaac       for (fy = 0; fy < numYEdges; ++fy) {
9703dfda0b1SToby Isaac         for (fx = 0; fx < numXVertices; ++fx) {
9713dfda0b1SToby Isaac           PetscInt face    = firstXFace + (fz * numYEdges + fy) * numXVertices + fx;
9723dfda0b1SToby Isaac           PetscInt edgeL   = firstZEdge + (fy * numXVertices + fx) * numZEdges + fz;
9733dfda0b1SToby Isaac           PetscInt edgeR   = firstZEdge + (((fy + 1) % numYVertices) * numXVertices + fx) * numZEdges + fz;
9743dfda0b1SToby Isaac           PetscInt edgeB   = firstYEdge + (fz * numXVertices + fx) * numYEdges + fy;
9753dfda0b1SToby Isaac           PetscInt edgeT   = firstYEdge + (((fz + 1) % numZVertices) * numXVertices + fx) * numYEdges + fy;
976b5a892a1SMatthew G. Knepley           PetscInt ornt[4] = {0, 0, -1, -1};
9773dfda0b1SToby Isaac           PetscInt cone[4];
9783dfda0b1SToby Isaac 
9793dfda0b1SToby Isaac           if (dim == 3) {
9803dfda0b1SToby Isaac             /* markers */
9813dfda0b1SToby Isaac             if (bdX != DM_BOUNDARY_PERIODIC) {
9823dfda0b1SToby Isaac               if (fx == numXVertices - 1) {
9839566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerRight));
9849566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerRight));
9859371c9d4SSatish Balay               } else if (fx == 0) {
9869566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerLeft));
9879566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerLeft));
9883dfda0b1SToby Isaac               }
9893dfda0b1SToby Isaac             }
9903dfda0b1SToby Isaac           }
9919371c9d4SSatish Balay           cone[0] = edgeB;
9929371c9d4SSatish Balay           cone[1] = edgeR;
9939371c9d4SSatish Balay           cone[2] = edgeT;
9949371c9d4SSatish Balay           cone[3] = edgeL;
9959566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, face, cone));
9969566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, face, ornt));
9973dfda0b1SToby Isaac         }
9983dfda0b1SToby Isaac       }
9993dfda0b1SToby Isaac     }
10003dfda0b1SToby Isaac     /* Build y faces */
10013dfda0b1SToby Isaac     for (fz = 0; fz < numZEdges; ++fz) {
100242206facSLisandro Dalcin       for (fx = 0; fx < numXEdges; ++fx) {
10033dfda0b1SToby Isaac         for (fy = 0; fy < numYVertices; ++fy) {
10043dfda0b1SToby Isaac           PetscInt face    = firstYFace + (fz * numXEdges + fx) * numYVertices + fy;
10053dfda0b1SToby Isaac           PetscInt edgeL   = firstZEdge + (fy * numXVertices + fx) * numZEdges + fz;
10063dfda0b1SToby Isaac           PetscInt edgeR   = firstZEdge + (fy * numXVertices + ((fx + 1) % numXVertices)) * numZEdges + fz;
10073dfda0b1SToby Isaac           PetscInt edgeB   = firstXEdge + (fz * numYVertices + fy) * numXEdges + fx;
10083dfda0b1SToby Isaac           PetscInt edgeT   = firstXEdge + (((fz + 1) % numZVertices) * numYVertices + fy) * numXEdges + fx;
1009b5a892a1SMatthew G. Knepley           PetscInt ornt[4] = {0, 0, -1, -1};
10103dfda0b1SToby Isaac           PetscInt cone[4];
10113dfda0b1SToby Isaac 
10123dfda0b1SToby Isaac           if (dim == 3) {
10133dfda0b1SToby Isaac             /* markers */
10143dfda0b1SToby Isaac             if (bdY != DM_BOUNDARY_PERIODIC) {
10153dfda0b1SToby Isaac               if (fy == numYVertices - 1) {
10169566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerBack));
10179566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerBack));
10189371c9d4SSatish Balay               } else if (fy == 0) {
10199566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerFront));
10209566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerFront));
10213dfda0b1SToby Isaac               }
10223dfda0b1SToby Isaac             }
10233dfda0b1SToby Isaac           }
10249371c9d4SSatish Balay           cone[0] = edgeB;
10259371c9d4SSatish Balay           cone[1] = edgeR;
10269371c9d4SSatish Balay           cone[2] = edgeT;
10279371c9d4SSatish Balay           cone[3] = edgeL;
10289566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, face, cone));
10299566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, face, ornt));
10303dfda0b1SToby Isaac         }
10313dfda0b1SToby Isaac       }
10323dfda0b1SToby Isaac     }
10333dfda0b1SToby Isaac     /* Build z faces */
10343dfda0b1SToby Isaac     for (fy = 0; fy < numYEdges; ++fy) {
10353dfda0b1SToby Isaac       for (fx = 0; fx < numXEdges; ++fx) {
10363dfda0b1SToby Isaac         for (fz = 0; fz < numZVertices; fz++) {
10373dfda0b1SToby Isaac           PetscInt face    = firstZFace + (fy * numXEdges + fx) * numZVertices + fz;
10383dfda0b1SToby Isaac           PetscInt edgeL   = firstYEdge + (fz * numXVertices + fx) * numYEdges + fy;
10393dfda0b1SToby Isaac           PetscInt edgeR   = firstYEdge + (fz * numXVertices + ((fx + 1) % numXVertices)) * numYEdges + fy;
10403dfda0b1SToby Isaac           PetscInt edgeB   = firstXEdge + (fz * numYVertices + fy) * numXEdges + fx;
10413dfda0b1SToby Isaac           PetscInt edgeT   = firstXEdge + (fz * numYVertices + ((fy + 1) % numYVertices)) * numXEdges + fx;
1042b5a892a1SMatthew G. Knepley           PetscInt ornt[4] = {0, 0, -1, -1};
10433dfda0b1SToby Isaac           PetscInt cone[4];
10443dfda0b1SToby Isaac 
10453dfda0b1SToby Isaac           if (dim == 2) {
10469371c9d4SSatish Balay             if (bdX == DM_BOUNDARY_TWIST && fx == numXEdges - 1) {
10479371c9d4SSatish Balay               edgeR += numYEdges - 1 - 2 * fy;
10489371c9d4SSatish Balay               ornt[1] = -1;
10499371c9d4SSatish Balay             }
10509371c9d4SSatish Balay             if (bdY == DM_BOUNDARY_TWIST && fy == numYEdges - 1) {
10519371c9d4SSatish Balay               edgeT += numXEdges - 1 - 2 * fx;
10529371c9d4SSatish Balay               ornt[2] = 0;
10539371c9d4SSatish Balay             }
10549566063dSJacob Faibussowitsch             if (bdX != DM_BOUNDARY_NONE && fx == numXEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, face, 2));
10559566063dSJacob Faibussowitsch             if (bdY != DM_BOUNDARY_NONE && fy == numYEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, face, 2));
1056d1c88043SMatthew G. Knepley           } else {
10573dfda0b1SToby Isaac             /* markers */
10583dfda0b1SToby Isaac             if (bdZ != DM_BOUNDARY_PERIODIC) {
10593dfda0b1SToby Isaac               if (fz == numZVertices - 1) {
10609566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerTop));
10619566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerTop));
10629371c9d4SSatish Balay               } else if (fz == 0) {
10639566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerBottom));
10649566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerBottom));
10653dfda0b1SToby Isaac               }
10663dfda0b1SToby Isaac             }
10673dfda0b1SToby Isaac           }
10689371c9d4SSatish Balay           cone[0] = edgeB;
10699371c9d4SSatish Balay           cone[1] = edgeR;
10709371c9d4SSatish Balay           cone[2] = edgeT;
10719371c9d4SSatish Balay           cone[3] = edgeL;
10729566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, face, cone));
10739566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, face, ornt));
10743dfda0b1SToby Isaac         }
10753dfda0b1SToby Isaac       }
10763dfda0b1SToby Isaac     }
10773dfda0b1SToby Isaac     /* Build Z edges*/
10783dfda0b1SToby Isaac     for (vy = 0; vy < numYVertices; vy++) {
10793dfda0b1SToby Isaac       for (vx = 0; vx < numXVertices; vx++) {
10803dfda0b1SToby Isaac         for (ez = 0; ez < numZEdges; ez++) {
10813dfda0b1SToby Isaac           const PetscInt edge    = firstZEdge + (vy * numXVertices + vx) * numZEdges + ez;
10823dfda0b1SToby Isaac           const PetscInt vertexB = firstVertex + (ez * numYVertices + vy) * numXVertices + vx;
10833dfda0b1SToby Isaac           const PetscInt vertexT = firstVertex + (((ez + 1) % numZVertices) * numYVertices + vy) * numXVertices + vx;
10843dfda0b1SToby Isaac           PetscInt       cone[2];
10853dfda0b1SToby Isaac 
10869371c9d4SSatish Balay           cone[0] = vertexB;
10879371c9d4SSatish Balay           cone[1] = vertexT;
1088c2df9bbfSMatthew G. Knepley           PetscCall(DMPlexSetCone(dm, edge, cone));
10893dfda0b1SToby Isaac           if (dim == 3) {
10903dfda0b1SToby Isaac             if (bdX != DM_BOUNDARY_PERIODIC) {
10913dfda0b1SToby Isaac               if (vx == numXVertices - 1) {
10929566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
1093c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
1094c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
1095c2df9bbfSMatthew G. Knepley               } else if (vx == 0) {
10969566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
1097c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
1098c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
10993dfda0b1SToby Isaac               }
11003dfda0b1SToby Isaac             }
11013dfda0b1SToby Isaac             if (bdY != DM_BOUNDARY_PERIODIC) {
11023dfda0b1SToby Isaac               if (vy == numYVertices - 1) {
11039566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBack));
1104c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBack));
1105c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBack));
1106c2df9bbfSMatthew G. Knepley               } else if (vy == 0) {
11079566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerFront));
1108c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerFront));
1109c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerFront));
11103dfda0b1SToby Isaac               }
11113dfda0b1SToby Isaac             }
11123dfda0b1SToby Isaac           }
11133dfda0b1SToby Isaac         }
11143dfda0b1SToby Isaac       }
11153dfda0b1SToby Isaac     }
11163dfda0b1SToby Isaac     /* Build Y edges*/
11173dfda0b1SToby Isaac     for (vz = 0; vz < numZVertices; vz++) {
11183dfda0b1SToby Isaac       for (vx = 0; vx < numXVertices; vx++) {
11193dfda0b1SToby Isaac         for (ey = 0; ey < numYEdges; ey++) {
11203dfda0b1SToby Isaac           const PetscInt nextv   = (dim == 2 && bdY == DM_BOUNDARY_TWIST && ey == numYEdges - 1) ? (numXVertices - vx - 1) : (vz * numYVertices + ((ey + 1) % numYVertices)) * numXVertices + vx;
11213dfda0b1SToby Isaac           const PetscInt edge    = firstYEdge + (vz * numXVertices + vx) * numYEdges + ey;
11223dfda0b1SToby Isaac           const PetscInt vertexF = firstVertex + (vz * numYVertices + ey) * numXVertices + vx;
11233dfda0b1SToby Isaac           const PetscInt vertexK = firstVertex + nextv;
11243dfda0b1SToby Isaac           PetscInt       cone[2];
11253dfda0b1SToby Isaac 
11269371c9d4SSatish Balay           cone[0] = vertexF;
11279371c9d4SSatish Balay           cone[1] = vertexK;
11289566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, edge, cone));
11293dfda0b1SToby Isaac           if (dim == 2) {
11303dfda0b1SToby Isaac             if ((bdX != DM_BOUNDARY_PERIODIC) && (bdX != DM_BOUNDARY_TWIST)) {
11313dfda0b1SToby Isaac               if (vx == numXVertices - 1) {
11329566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerRight));
11339566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
11349566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
1135c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
1136d8211ee3SMatthew G. Knepley               } else if (vx == 0) {
11379566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerLeft));
11389566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
11399566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
1140c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
11413dfda0b1SToby Isaac               }
1142d8211ee3SMatthew G. Knepley             } else {
11434c67ea77SStefano Zampini               if (vx == 0 && cutLabel) {
11449566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, edge, 1));
11459566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, cone[0], 1));
1146c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMLabelSetValue(cutLabel, cone[1], 1));
11473dfda0b1SToby Isaac               }
1148d8211ee3SMatthew G. Knepley             }
1149d8211ee3SMatthew G. Knepley           } else {
11503dfda0b1SToby Isaac             if (bdX != DM_BOUNDARY_PERIODIC) {
11513dfda0b1SToby Isaac               if (vx == numXVertices - 1) {
11529566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
1153c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
1154c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
1155d8211ee3SMatthew G. Knepley               } else if (vx == 0) {
11569566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
1157c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
1158c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
11593dfda0b1SToby Isaac               }
11603dfda0b1SToby Isaac             }
11613dfda0b1SToby Isaac             if (bdZ != DM_BOUNDARY_PERIODIC) {
11623dfda0b1SToby Isaac               if (vz == numZVertices - 1) {
11639566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
1164c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
1165c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
1166d8211ee3SMatthew G. Knepley               } else if (vz == 0) {
11679566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
1168c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
1169c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
11703dfda0b1SToby Isaac               }
11713dfda0b1SToby Isaac             }
11723dfda0b1SToby Isaac           }
11733dfda0b1SToby Isaac         }
11743dfda0b1SToby Isaac       }
11753dfda0b1SToby Isaac     }
11763dfda0b1SToby Isaac     /* Build X edges*/
11773dfda0b1SToby Isaac     for (vz = 0; vz < numZVertices; vz++) {
11783dfda0b1SToby Isaac       for (vy = 0; vy < numYVertices; vy++) {
11793dfda0b1SToby Isaac         for (ex = 0; ex < numXEdges; ex++) {
11803dfda0b1SToby Isaac           const PetscInt nextv   = (dim == 2 && bdX == DM_BOUNDARY_TWIST && ex == numXEdges - 1) ? (numYVertices - vy - 1) * numXVertices : (vz * numYVertices + vy) * numXVertices + (ex + 1) % numXVertices;
11813dfda0b1SToby Isaac           const PetscInt edge    = firstXEdge + (vz * numYVertices + vy) * numXEdges + ex;
11823dfda0b1SToby Isaac           const PetscInt vertexL = firstVertex + (vz * numYVertices + vy) * numXVertices + ex;
11833dfda0b1SToby Isaac           const PetscInt vertexR = firstVertex + nextv;
11843dfda0b1SToby Isaac           PetscInt       cone[2];
11853dfda0b1SToby Isaac 
11869371c9d4SSatish Balay           cone[0] = vertexL;
11879371c9d4SSatish Balay           cone[1] = vertexR;
11889566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, edge, cone));
11893dfda0b1SToby Isaac           if (dim == 2) {
11903dfda0b1SToby Isaac             if ((bdY != DM_BOUNDARY_PERIODIC) && (bdY != DM_BOUNDARY_TWIST)) {
11913dfda0b1SToby Isaac               if (vy == numYVertices - 1) {
11929566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerTop));
11939566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
11949566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
1195c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
1196d8211ee3SMatthew G. Knepley               } else if (vy == 0) {
11979566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerBottom));
11989566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
11999566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
1200c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
12013dfda0b1SToby Isaac               }
1202d8211ee3SMatthew G. Knepley             } else {
12034c67ea77SStefano Zampini               if (vy == 0 && cutLabel) {
12049566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, edge, 1));
12059566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, cone[0], 1));
1206c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMLabelSetValue(cutLabel, cone[1], 1));
12073dfda0b1SToby Isaac               }
1208d8211ee3SMatthew G. Knepley             }
1209d8211ee3SMatthew G. Knepley           } else {
12103dfda0b1SToby Isaac             if (bdY != DM_BOUNDARY_PERIODIC) {
12113dfda0b1SToby Isaac               if (vy == numYVertices - 1) {
12129566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBack));
1213c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBack));
1214c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBack));
1215c2df9bbfSMatthew G. Knepley               } else if (vy == 0) {
12169566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerFront));
1217c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerFront));
1218c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerFront));
12193dfda0b1SToby Isaac               }
12203dfda0b1SToby Isaac             }
12213dfda0b1SToby Isaac             if (bdZ != DM_BOUNDARY_PERIODIC) {
12223dfda0b1SToby Isaac               if (vz == numZVertices - 1) {
12239566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
1224c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
1225c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
1226c2df9bbfSMatthew G. Knepley               } else if (vz == 0) {
12279566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
1228c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
1229c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
12303dfda0b1SToby Isaac               }
12313dfda0b1SToby Isaac             }
12323dfda0b1SToby Isaac           }
12333dfda0b1SToby Isaac         }
12343dfda0b1SToby Isaac       }
12353dfda0b1SToby Isaac     }
12369566063dSJacob Faibussowitsch     PetscCall(DMPlexSymmetrize(dm));
12379566063dSJacob Faibussowitsch     PetscCall(DMPlexStratify(dm));
12383dfda0b1SToby Isaac     /* Build coordinates */
12399566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &coordSection));
12409566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetNumFields(coordSection, 1));
12419566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
12429566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numVertices));
12433dfda0b1SToby Isaac     for (v = firstVertex; v < firstVertex + numVertices; ++v) {
12449566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetDof(coordSection, v, dim));
12459566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
12463dfda0b1SToby Isaac     }
12479566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetUp(coordSection));
12489566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
12499566063dSJacob Faibussowitsch     PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
12509566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
12519566063dSJacob Faibussowitsch     PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
12529566063dSJacob Faibussowitsch     PetscCall(VecSetBlockSize(coordinates, dim));
12539566063dSJacob Faibussowitsch     PetscCall(VecSetType(coordinates, VECSTANDARD));
12549566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
12553dfda0b1SToby Isaac     for (vz = 0; vz < numZVertices; ++vz) {
12563dfda0b1SToby Isaac       for (vy = 0; vy < numYVertices; ++vy) {
12573dfda0b1SToby Isaac         for (vx = 0; vx < numXVertices; ++vx) {
12583dfda0b1SToby Isaac           coords[((vz * numYVertices + vy) * numXVertices + vx) * dim + 0] = lower[0] + ((upper[0] - lower[0]) / numXEdges) * vx;
12593dfda0b1SToby Isaac           coords[((vz * numYVertices + vy) * numXVertices + vx) * dim + 1] = lower[1] + ((upper[1] - lower[1]) / numYEdges) * vy;
1260ad540459SPierre Jolivet           if (dim == 3) coords[((vz * numYVertices + vy) * numXVertices + vx) * dim + 2] = lower[2] + ((upper[2] - lower[2]) / numZEdges) * vz;
12613dfda0b1SToby Isaac         }
12623dfda0b1SToby Isaac       }
12633dfda0b1SToby Isaac     }
12649566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(coordinates, &coords));
12659566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, coordinates));
12669566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&coordinates));
12673dfda0b1SToby Isaac   }
12683ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
12693dfda0b1SToby Isaac }
12703dfda0b1SToby Isaac 
1271d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxMesh_Tensor_Internal(DM dm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[])
1272d71ae5a4SJacob Faibussowitsch {
12739318fe57SMatthew G. Knepley   DMBoundaryType bdt[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
12749318fe57SMatthew G. Knepley   PetscInt       fac[3] = {0, 0, 0}, d;
1275552f7358SJed Brown 
1276552f7358SJed Brown   PetscFunctionBegin;
12774f572ea9SToby Isaac   PetscAssertPointer(dm, 1);
12789318fe57SMatthew G. Knepley   PetscValidLogicalCollectiveInt(dm, dim, 2);
12799566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
12809371c9d4SSatish Balay   for (d = 0; d < dim; ++d) {
12819371c9d4SSatish Balay     fac[d] = faces[d];
12829371c9d4SSatish Balay     bdt[d] = periodicity[d];
12839371c9d4SSatish Balay   }
12849566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateCubeMesh_Internal(dm, lower, upper, fac, bdt[0], bdt[1], bdt[2]));
12859371c9d4SSatish Balay   if (periodicity[0] == DM_BOUNDARY_PERIODIC || periodicity[0] == DM_BOUNDARY_TWIST || periodicity[1] == DM_BOUNDARY_PERIODIC || periodicity[1] == DM_BOUNDARY_TWIST || (dim > 2 && (periodicity[2] == DM_BOUNDARY_PERIODIC || periodicity[2] == DM_BOUNDARY_TWIST))) {
12866858538eSMatthew G. Knepley     PetscReal L[3]       = {-1., -1., 0.};
12876858538eSMatthew G. Knepley     PetscReal maxCell[3] = {-1., -1., 0.};
1288552f7358SJed Brown 
12899318fe57SMatthew G. Knepley     for (d = 0; d < dim; ++d) {
12906858538eSMatthew G. Knepley       if (periodicity[d] != DM_BOUNDARY_NONE) {
12919318fe57SMatthew G. Knepley         L[d]       = upper[d] - lower[d];
12929318fe57SMatthew G. Knepley         maxCell[d] = 1.1 * (L[d] / PetscMax(1, faces[d]));
1293768d5fceSMatthew G. Knepley       }
12946858538eSMatthew G. Knepley     }
12954fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dm, maxCell, lower, L));
1296768d5fceSMatthew G. Knepley   }
12979566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
12983ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
12999318fe57SMatthew G. Knepley }
13009318fe57SMatthew G. Knepley 
13015dca41c3SJed Brown static PetscErrorCode DMPlexCreateBoxMesh_Internal(DM dm, DMPlexShape shape, PetscInt dim, PetscBool simplex, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[], PetscBool interpolate)
1302d71ae5a4SJacob Faibussowitsch {
13039318fe57SMatthew G. Knepley   PetscFunctionBegin;
130446139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
13055dca41c3SJed Brown   if (shape == DM_SHAPE_ZBOX) PetscCall(DMPlexCreateBoxMesh_Tensor_SFC_Internal(dm, dim, faces, lower, upper, periodicity, interpolate));
13066725e60dSJed Brown   else if (dim == 1) PetscCall(DMPlexCreateLineMesh_Internal(dm, faces[0], lower[0], upper[0], periodicity[0]));
13079566063dSJacob Faibussowitsch   else if (simplex) PetscCall(DMPlexCreateBoxMesh_Simplex_Internal(dm, dim, faces, lower, upper, periodicity, interpolate));
13089566063dSJacob Faibussowitsch   else PetscCall(DMPlexCreateBoxMesh_Tensor_Internal(dm, dim, faces, lower, upper, periodicity));
13099318fe57SMatthew G. Knepley   if (!interpolate && dim > 1 && !simplex) {
1310768d5fceSMatthew G. Knepley     DM udm;
1311768d5fceSMatthew G. Knepley 
13129566063dSJacob Faibussowitsch     PetscCall(DMPlexUninterpolate(dm, &udm));
13139566063dSJacob Faibussowitsch     PetscCall(DMPlexCopyCoordinates(dm, udm));
131469d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &udm));
1315768d5fceSMatthew G. Knepley   }
131646139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
13173ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1318c8c68bd8SToby Isaac }
1319c8c68bd8SToby Isaac 
1320768d5fceSMatthew G. Knepley /*@C
1321768d5fceSMatthew G. Knepley   DMPlexCreateBoxMesh - Creates a mesh on the tensor product of unit intervals (box) using simplices or tensor cells (hexahedra).
1322768d5fceSMatthew G. Knepley 
1323d083f849SBarry Smith   Collective
1324768d5fceSMatthew G. Knepley 
1325768d5fceSMatthew G. Knepley   Input Parameters:
1326a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
1327768d5fceSMatthew G. Knepley . dim         - The spatial dimension
1328a1cb98faSBarry Smith . simplex     - `PETSC_TRUE` for simplices, `PETSC_FALSE` for tensor cells
132920f4b53cSBarry Smith . faces       - Number of faces per dimension, or `NULL` for (1,) in 1D and (2, 2) in 2D and (1, 1, 1) in 3D
133020f4b53cSBarry Smith . lower       - The lower left corner, or `NULL` for (0, 0, 0)
133120f4b53cSBarry Smith . upper       - The upper right corner, or `NULL` for (1, 1, 1)
133220f4b53cSBarry Smith . periodicity - The boundary type for the X,Y,Z direction, or `NULL` for `DM_BOUNDARY_NONE`
1333768d5fceSMatthew G. Knepley - interpolate - Flag to create intermediate mesh pieces (edges, faces)
1334768d5fceSMatthew G. Knepley 
1335768d5fceSMatthew G. Knepley   Output Parameter:
1336a1cb98faSBarry Smith . dm - The `DM` object
1337768d5fceSMatthew G. Knepley 
1338768d5fceSMatthew G. Knepley   Level: beginner
1339768d5fceSMatthew G. Knepley 
1340a1cb98faSBarry Smith   Note:
1341a1cb98faSBarry Smith   To customize this mesh using options, use
1342a1cb98faSBarry Smith .vb
1343a1cb98faSBarry Smith   DMCreate(comm, &dm);
1344a1cb98faSBarry Smith   DMSetType(dm, DMPLEX);
1345a1cb98faSBarry Smith   DMSetFromOptions(dm);
1346a1cb98faSBarry Smith .ve
1347a1cb98faSBarry Smith   and use the options in `DMSetFromOptions()`.
1348a1cb98faSBarry Smith 
1349a4e35b19SJacob Faibussowitsch   Here is the numbering returned for 2 faces in each direction for tensor cells\:
1350a1cb98faSBarry Smith .vb
1351a1cb98faSBarry Smith  10---17---11---18----12
1352a1cb98faSBarry Smith   |         |         |
1353a1cb98faSBarry Smith   |         |         |
1354a1cb98faSBarry Smith  20    2   22    3    24
1355a1cb98faSBarry Smith   |         |         |
1356a1cb98faSBarry Smith   |         |         |
1357a1cb98faSBarry Smith   7---15----8---16----9
1358a1cb98faSBarry Smith   |         |         |
1359a1cb98faSBarry Smith   |         |         |
1360a1cb98faSBarry Smith  19    0   21    1   23
1361a1cb98faSBarry Smith   |         |         |
1362a1cb98faSBarry Smith   |         |         |
1363a1cb98faSBarry Smith   4---13----5---14----6
1364a1cb98faSBarry Smith .ve
1365a1cb98faSBarry Smith   and for simplicial cells
1366a1cb98faSBarry Smith .vb
1367a1cb98faSBarry Smith  14----8---15----9----16
1368a1cb98faSBarry Smith   |\     5  |\      7 |
1369a1cb98faSBarry Smith   | \       | \       |
1370a1cb98faSBarry Smith  13   2    14    3    15
1371a1cb98faSBarry Smith   | 4   \   | 6   \   |
1372a1cb98faSBarry Smith   |       \ |       \ |
1373a1cb98faSBarry Smith  11----6---12----7----13
1374a1cb98faSBarry Smith   |\        |\        |
1375a1cb98faSBarry Smith   | \    1  | \     3 |
1376a1cb98faSBarry Smith  10   0    11    1    12
1377a1cb98faSBarry Smith   | 0   \   | 2   \   |
1378a1cb98faSBarry Smith   |       \ |       \ |
1379a1cb98faSBarry Smith   8----4----9----5----10
1380a1cb98faSBarry Smith .ve
1381a1cb98faSBarry Smith 
13821cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMSetFromOptions()`, `DMPlexCreateFromFile()`, `DMPlexCreateHexCylinderMesh()`, `DMSetType()`, `DMCreate()`
1383768d5fceSMatthew G. Knepley @*/
1384d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateBoxMesh(MPI_Comm comm, PetscInt dim, PetscBool simplex, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[], PetscBool interpolate, DM *dm)
1385d71ae5a4SJacob Faibussowitsch {
13869318fe57SMatthew G. Knepley   PetscInt       fac[3] = {1, 1, 1};
1387fdbf62faSLisandro Dalcin   PetscReal      low[3] = {0, 0, 0};
1388fdbf62faSLisandro Dalcin   PetscReal      upp[3] = {1, 1, 1};
1389fdbf62faSLisandro Dalcin   DMBoundaryType bdt[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
1390552f7358SJed Brown 
1391768d5fceSMatthew G. Knepley   PetscFunctionBegin;
13929566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
13939566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
13945dca41c3SJed Brown   PetscCall(DMPlexCreateBoxMesh_Internal(*dm, DM_SHAPE_BOX, dim, simplex, faces ? faces : fac, lower ? lower : low, upper ? upper : upp, periodicity ? periodicity : bdt, interpolate));
13957ff04441SMatthew G. Knepley   if (periodicity) PetscCall(DMLocalizeCoordinates(*dm));
13963ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
13979318fe57SMatthew G. Knepley }
1398fdbf62faSLisandro Dalcin 
1399d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateWedgeBoxMesh_Internal(DM dm, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[])
1400d71ae5a4SJacob Faibussowitsch {
14019318fe57SMatthew G. Knepley   DM       bdm, vol;
14029318fe57SMatthew G. Knepley   PetscInt i;
14039318fe57SMatthew G. Knepley 
14049318fe57SMatthew G. Knepley   PetscFunctionBegin;
14051fcf445aSMatthew G. Knepley   // TODO Now we can support periodicity
140608401ef6SPierre Jolivet   for (i = 0; i < 3; ++i) PetscCheck(periodicity[i] == DM_BOUNDARY_NONE, PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Periodicity not yet supported");
14079566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &bdm));
14089566063dSJacob Faibussowitsch   PetscCall(DMSetType(bdm, DMPLEX));
14099566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(bdm, 2));
141046139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, bdm, 0, 0, 0));
14119566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBoxMesh_Simplex_Internal(bdm, 2, faces, lower, upper, periodicity, PETSC_TRUE));
14121fcf445aSMatthew G. Knepley   PetscCall(DMPlexExtrude(bdm, faces[2], upper[2] - lower[2], PETSC_TRUE, PETSC_FALSE, PETSC_FALSE, NULL, NULL, &vol));
141346139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, bdm, 0, 0, 0));
14149566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&bdm));
141569d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
14169318fe57SMatthew G. Knepley   if (lower[2] != 0.0) {
14179318fe57SMatthew G. Knepley     Vec          v;
14189318fe57SMatthew G. Knepley     PetscScalar *x;
14199318fe57SMatthew G. Knepley     PetscInt     cDim, n;
14209318fe57SMatthew G. Knepley 
14219566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinatesLocal(dm, &v));
14229566063dSJacob Faibussowitsch     PetscCall(VecGetBlockSize(v, &cDim));
14239566063dSJacob Faibussowitsch     PetscCall(VecGetLocalSize(v, &n));
14249566063dSJacob Faibussowitsch     PetscCall(VecGetArray(v, &x));
14259318fe57SMatthew G. Knepley     x += cDim;
14269318fe57SMatthew G. Knepley     for (i = 0; i < n; i += cDim) x[i] += lower[2];
14279566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(v, &x));
14289566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, v));
14299318fe57SMatthew G. Knepley   }
14303ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1431552f7358SJed Brown }
1432552f7358SJed Brown 
143300dabe28SStefano Zampini /*@
143400dabe28SStefano Zampini   DMPlexCreateWedgeBoxMesh - Creates a 3-D mesh tesselating the (x,y) plane and extruding in the third direction using wedge cells.
143500dabe28SStefano Zampini 
1436d083f849SBarry Smith   Collective
143700dabe28SStefano Zampini 
143800dabe28SStefano Zampini   Input Parameters:
1439a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
144020f4b53cSBarry Smith . faces       - Number of faces per dimension, or `NULL` for (1, 1, 1)
144120f4b53cSBarry Smith . lower       - The lower left corner, or `NULL` for (0, 0, 0)
144220f4b53cSBarry Smith . upper       - The upper right corner, or `NULL` for (1, 1, 1)
144320f4b53cSBarry Smith . periodicity - The boundary type for the X,Y,Z direction, or `NULL` for `DM_BOUNDARY_NONE`
1444a1cb98faSBarry Smith . orderHeight - If `PETSC_TRUE`, orders the extruded cells in the height first. Otherwise, orders the cell on the layers first
144500dabe28SStefano Zampini - interpolate - Flag to create intermediate mesh pieces (edges, faces)
144600dabe28SStefano Zampini 
144700dabe28SStefano Zampini   Output Parameter:
1448a1cb98faSBarry Smith . dm - The `DM` object
144900dabe28SStefano Zampini 
145000dabe28SStefano Zampini   Level: beginner
145100dabe28SStefano Zampini 
14521cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateHexCylinderMesh()`, `DMPlexCreateWedgeCylinderMesh()`, `DMExtrude()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
145300dabe28SStefano Zampini @*/
1454d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateWedgeBoxMesh(MPI_Comm comm, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[], PetscBool orderHeight, PetscBool interpolate, DM *dm)
1455d71ae5a4SJacob Faibussowitsch {
14569318fe57SMatthew G. Knepley   PetscInt       fac[3] = {1, 1, 1};
145700dabe28SStefano Zampini   PetscReal      low[3] = {0, 0, 0};
145800dabe28SStefano Zampini   PetscReal      upp[3] = {1, 1, 1};
145900dabe28SStefano Zampini   DMBoundaryType bdt[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
146000dabe28SStefano Zampini 
146100dabe28SStefano Zampini   PetscFunctionBegin;
14629566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
14639566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
14649566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateWedgeBoxMesh_Internal(*dm, faces ? faces : fac, lower ? lower : low, upper ? upper : upp, periodicity ? periodicity : bdt));
1465d410b0cfSMatthew G. Knepley   if (!interpolate) {
1466d410b0cfSMatthew G. Knepley     DM udm;
146700dabe28SStefano Zampini 
14689566063dSJacob Faibussowitsch     PetscCall(DMPlexUninterpolate(*dm, &udm));
146969d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(*dm, &udm));
147000dabe28SStefano Zampini   }
14717ff04441SMatthew G. Knepley   if (periodicity) PetscCall(DMLocalizeCoordinates(*dm));
14723ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
147300dabe28SStefano Zampini }
147400dabe28SStefano Zampini 
1475cfb853baSMatthew G. Knepley /*
1476cfb853baSMatthew G. Knepley   DMPlexTensorPointLexicographic_Private - Returns all tuples of size 'len' with nonnegative integers that are all less than or equal to 'max' for that dimension.
1477cfb853baSMatthew G. Knepley 
1478cfb853baSMatthew G. Knepley   Input Parameters:
1479cfb853baSMatthew G. Knepley + len - The length of the tuple
1480cfb853baSMatthew G. Knepley . max - The maximum for each dimension, so values are in [0, max)
1481cfb853baSMatthew G. Knepley - tup - A tuple of length len+1: tup[len] > 0 indicates a stopping condition
1482cfb853baSMatthew G. Knepley 
1483cfb853baSMatthew G. Knepley   Output Parameter:
148420f4b53cSBarry Smith . tup - A tuple of `len` integers whose entries are at most `max`
1485cfb853baSMatthew G. Knepley 
1486cfb853baSMatthew G. Knepley   Level: developer
1487cfb853baSMatthew G. Knepley 
148820f4b53cSBarry Smith   Note:
148920f4b53cSBarry Smith   Ordering is lexicographic with lowest index as least significant in ordering.
149020f4b53cSBarry Smith   e.g. for len == 2 and max == 2, this will return, in order, {0,0}, {1,0}, {2,0}, {0,1}, {1,1}, {2,1}, {0,2}, {1,2}, {2,2}.
149120f4b53cSBarry Smith 
1492cfb853baSMatthew G. Knepley .seealso: PetscDualSpaceTensorPointLexicographic_Internal(), PetscDualSpaceLatticePointLexicographic_Internal()
1493cfb853baSMatthew G. Knepley */
1494cfb853baSMatthew G. Knepley static PetscErrorCode DMPlexTensorPointLexicographic_Private(PetscInt len, const PetscInt max[], PetscInt tup[])
1495cfb853baSMatthew G. Knepley {
1496cfb853baSMatthew G. Knepley   PetscInt i;
1497cfb853baSMatthew G. Knepley 
1498cfb853baSMatthew G. Knepley   PetscFunctionBegin;
1499cfb853baSMatthew G. Knepley   for (i = 0; i < len; ++i) {
1500cfb853baSMatthew G. Knepley     if (tup[i] < max[i] - 1) {
1501cfb853baSMatthew G. Knepley       break;
1502cfb853baSMatthew G. Knepley     } else {
1503cfb853baSMatthew G. Knepley       tup[i] = 0;
1504cfb853baSMatthew G. Knepley     }
1505cfb853baSMatthew G. Knepley   }
1506cfb853baSMatthew G. Knepley   if (i == len) tup[i - 1] = max[i - 1];
1507cfb853baSMatthew G. Knepley   else ++tup[i];
15083ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1509cfb853baSMatthew G. Knepley }
1510cfb853baSMatthew G. Knepley 
1511cfb853baSMatthew G. Knepley static PetscInt TupleToIndex_Private(PetscInt len, const PetscInt max[], const PetscInt tup[])
1512cfb853baSMatthew G. Knepley {
1513cfb853baSMatthew G. Knepley   PetscInt i, idx = tup[len - 1];
1514cfb853baSMatthew G. Knepley 
1515cfb853baSMatthew G. Knepley   for (i = len - 2; i >= 0; --i) {
1516cfb853baSMatthew G. Knepley     idx *= max[i];
1517cfb853baSMatthew G. Knepley     idx += tup[i];
1518cfb853baSMatthew G. Knepley   }
1519cfb853baSMatthew G. Knepley   return idx;
1520cfb853baSMatthew G. Knepley }
1521cfb853baSMatthew G. Knepley 
1522cfb853baSMatthew G. Knepley static PetscErrorCode DestroyExtent_Private(void *extent)
1523cfb853baSMatthew G. Knepley {
1524cfb853baSMatthew G. Knepley   return PetscFree(extent);
1525cfb853baSMatthew G. Knepley }
1526cfb853baSMatthew G. Knepley 
1527cfb853baSMatthew G. Knepley static PetscErrorCode DMPlexCreateHypercubicMesh_Internal(DM dm, PetscInt dim, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[], const DMBoundaryType bd[])
1528cfb853baSMatthew G. Knepley {
1529cfb853baSMatthew G. Knepley   Vec          coordinates;
1530cfb853baSMatthew G. Knepley   PetscSection coordSection;
1531cfb853baSMatthew G. Knepley   DMLabel      cutLabel    = NULL;
1532cfb853baSMatthew G. Knepley   PetscBool    cutMarker   = PETSC_FALSE;
1533cfb853baSMatthew G. Knepley   PetscBool    periodic    = PETSC_FALSE;
1534cfb853baSMatthew G. Knepley   PetscInt     numCells    = 1, c;
1535cfb853baSMatthew G. Knepley   PetscInt     numVertices = 1, v;
1536cfb853baSMatthew G. Knepley   PetscScalar *coords;
1537cfb853baSMatthew G. Knepley   PetscInt    *vertices, *vert, *vtmp, *supp, cone[2];
1538cfb853baSMatthew G. Knepley   PetscInt     d, e, cell = 0, coordSize;
1539cfb853baSMatthew G. Knepley   PetscMPIInt  rank;
1540cfb853baSMatthew G. Knepley 
1541cfb853baSMatthew G. Knepley   PetscFunctionBegin;
1542cfb853baSMatthew G. Knepley   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
1543cfb853baSMatthew G. Knepley   PetscCall(DMSetDimension(dm, dim));
1544cfb853baSMatthew G. Knepley   PetscCall(PetscCalloc4(dim, &vertices, dim, &vert, dim, &vtmp, 2 * dim, &supp));
1545cfb853baSMatthew G. Knepley   PetscCall(DMCreateLabel(dm, "marker"));
1546cfb853baSMatthew G. Knepley   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_periodic_cut", &cutMarker, NULL));
1547cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) periodic = (periodic || bd[d] == DM_BOUNDARY_PERIODIC) ? PETSC_TRUE : PETSC_FALSE;
1548cfb853baSMatthew G. Knepley   if (periodic && cutMarker) {
1549cfb853baSMatthew G. Knepley     PetscCall(DMCreateLabel(dm, "periodic_cut"));
1550cfb853baSMatthew G. Knepley     PetscCall(DMGetLabel(dm, "periodic_cut", &cutLabel));
1551cfb853baSMatthew G. Knepley   }
1552cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) PetscCheck(bd[d] == DM_BOUNDARY_PERIODIC, PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Hypercubic mesh must be periodic now");
1553cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) {
1554cfb853baSMatthew G. Knepley     vertices[d] = edges[d];
1555cfb853baSMatthew G. Knepley     numVertices *= vertices[d];
1556cfb853baSMatthew G. Knepley   }
1557cfb853baSMatthew G. Knepley   numCells = numVertices * dim;
1558cfb853baSMatthew G. Knepley   PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
1559cfb853baSMatthew G. Knepley   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, 2));
1560cfb853baSMatthew G. Knepley   for (v = numCells; v < numCells + numVertices; ++v) PetscCall(DMPlexSetSupportSize(dm, v, 2 * dim));
1561cfb853baSMatthew G. Knepley   /* TODO Loop over boundary and reset support sizes */
1562cfb853baSMatthew G. Knepley   PetscCall(DMSetUp(dm)); /* Allocate space for cones and supports */
1563cfb853baSMatthew G. Knepley   /* Build cell cones and vertex supports */
1564cfb853baSMatthew G. Knepley   PetscCall(DMCreateLabel(dm, "celltype"));
1565cfb853baSMatthew G. Knepley   while (vert[dim - 1] < vertices[dim - 1]) {
1566cfb853baSMatthew G. Knepley     const PetscInt vertex = TupleToIndex_Private(dim, vertices, vert) + numCells;
1567cfb853baSMatthew G. Knepley     PetscInt       s      = 0;
1568cfb853baSMatthew G. Knepley 
15693ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "Vertex %" PetscInt_FMT ":", vertex));
15703ba16761SJacob Faibussowitsch     for (d = 0; d < dim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %" PetscInt_FMT, vert[d]));
15713ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
1572cfb853baSMatthew G. Knepley     PetscCall(DMPlexSetCellType(dm, vertex, DM_POLYTOPE_POINT));
1573cfb853baSMatthew G. Knepley     for (d = 0; d < dim; ++d) {
1574cfb853baSMatthew G. Knepley       for (e = 0; e < dim; ++e) vtmp[e] = vert[e];
1575cfb853baSMatthew G. Knepley       vtmp[d] = (vert[d] + 1) % vertices[d];
1576cfb853baSMatthew G. Knepley       cone[0] = vertex;
1577cfb853baSMatthew G. Knepley       cone[1] = TupleToIndex_Private(dim, vertices, vtmp) + numCells;
15783ba16761SJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Vertex %" PetscInt_FMT ":", cone[1]));
15793ba16761SJacob Faibussowitsch       for (e = 0; e < dim; ++e) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %" PetscInt_FMT, vtmp[e]));
15803ba16761SJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
1581cfb853baSMatthew G. Knepley       PetscCall(DMPlexSetCone(dm, cell, cone));
1582cfb853baSMatthew G. Knepley       PetscCall(DMPlexSetCellType(dm, cell, DM_POLYTOPE_SEGMENT));
15833ba16761SJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Edge %" PetscInt_FMT " (%" PetscInt_FMT " %" PetscInt_FMT ")\n", cell, cone[0], cone[1]));
1584cfb853baSMatthew G. Knepley       ++cell;
1585cfb853baSMatthew G. Knepley     }
1586cfb853baSMatthew G. Knepley     for (d = 0; d < dim; ++d) {
1587cfb853baSMatthew G. Knepley       for (e = 0; e < dim; ++e) vtmp[e] = vert[e];
1588cfb853baSMatthew G. Knepley       vtmp[d]   = (vert[d] + vertices[d] - 1) % vertices[d];
1589cfb853baSMatthew G. Knepley       supp[s++] = TupleToIndex_Private(dim, vertices, vtmp) * dim + d;
1590cfb853baSMatthew G. Knepley       supp[s++] = (vertex - numCells) * dim + d;
1591cfb853baSMatthew G. Knepley       PetscCall(DMPlexSetSupport(dm, vertex, supp));
1592cfb853baSMatthew G. Knepley     }
1593cfb853baSMatthew G. Knepley     PetscCall(DMPlexTensorPointLexicographic_Private(dim, vertices, vert));
1594cfb853baSMatthew G. Knepley   }
1595cfb853baSMatthew G. Knepley   PetscCall(DMPlexStratify(dm));
1596cfb853baSMatthew G. Knepley   /* Build coordinates */
1597cfb853baSMatthew G. Knepley   PetscCall(DMGetCoordinateSection(dm, &coordSection));
1598cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetNumFields(coordSection, 1));
1599cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
1600cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetChart(coordSection, numCells, numCells + numVertices));
1601cfb853baSMatthew G. Knepley   for (v = numCells; v < numCells + numVertices; ++v) {
1602cfb853baSMatthew G. Knepley     PetscCall(PetscSectionSetDof(coordSection, v, dim));
1603cfb853baSMatthew G. Knepley     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
1604cfb853baSMatthew G. Knepley   }
1605cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetUp(coordSection));
1606cfb853baSMatthew G. Knepley   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
1607cfb853baSMatthew G. Knepley   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
1608cfb853baSMatthew G. Knepley   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
1609cfb853baSMatthew G. Knepley   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
1610cfb853baSMatthew G. Knepley   PetscCall(VecSetBlockSize(coordinates, dim));
1611cfb853baSMatthew G. Knepley   PetscCall(VecSetType(coordinates, VECSTANDARD));
1612cfb853baSMatthew G. Knepley   PetscCall(VecGetArray(coordinates, &coords));
1613cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) vert[d] = 0;
1614cfb853baSMatthew G. Knepley   while (vert[dim - 1] < vertices[dim - 1]) {
1615cfb853baSMatthew G. Knepley     const PetscInt vertex = TupleToIndex_Private(dim, vertices, vert);
1616cfb853baSMatthew G. Knepley 
1617cfb853baSMatthew G. Knepley     for (d = 0; d < dim; ++d) coords[vertex * dim + d] = lower[d] + ((upper[d] - lower[d]) / vertices[d]) * vert[d];
16183ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "Vertex %" PetscInt_FMT ":", vertex));
16193ba16761SJacob Faibussowitsch     for (d = 0; d < dim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %" PetscInt_FMT, vert[d]));
16203ba16761SJacob Faibussowitsch     for (d = 0; d < dim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %g", (double)PetscRealPart(coords[vertex * dim + d])));
16213ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
1622cfb853baSMatthew G. Knepley     PetscCall(DMPlexTensorPointLexicographic_Private(dim, vertices, vert));
1623cfb853baSMatthew G. Knepley   }
1624cfb853baSMatthew G. Knepley   PetscCall(VecRestoreArray(coordinates, &coords));
1625cfb853baSMatthew G. Knepley   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
1626cfb853baSMatthew G. Knepley   PetscCall(VecDestroy(&coordinates));
1627cfb853baSMatthew G. Knepley   PetscCall(PetscFree4(vertices, vert, vtmp, supp));
1628cfb853baSMatthew G. Knepley   //PetscCall(DMSetPeriodicity(dm, NULL, lower, upper));
1629cfb853baSMatthew G. Knepley   // Attach the extent
1630cfb853baSMatthew G. Knepley   {
1631cfb853baSMatthew G. Knepley     PetscContainer c;
1632cfb853baSMatthew G. Knepley     PetscInt      *extent;
1633cfb853baSMatthew G. Knepley 
1634cfb853baSMatthew G. Knepley     PetscCall(PetscMalloc1(dim, &extent));
1635cfb853baSMatthew G. Knepley     for (PetscInt d = 0; d < dim; ++d) extent[d] = edges[d];
1636cfb853baSMatthew G. Knepley     PetscCall(PetscContainerCreate(PETSC_COMM_SELF, &c));
1637cfb853baSMatthew G. Knepley     PetscCall(PetscContainerSetUserDestroy(c, DestroyExtent_Private));
1638cfb853baSMatthew G. Knepley     PetscCall(PetscContainerSetPointer(c, extent));
1639cfb853baSMatthew G. Knepley     PetscCall(PetscObjectCompose((PetscObject)dm, "_extent", (PetscObject)c));
1640cfb853baSMatthew G. Knepley     PetscCall(PetscContainerDestroy(&c));
1641cfb853baSMatthew G. Knepley   }
16423ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1643cfb853baSMatthew G. Knepley }
1644cfb853baSMatthew G. Knepley 
1645cfb853baSMatthew G. Knepley /*@C
1646aaa8cc7dSPierre Jolivet   DMPlexCreateHypercubicMesh - Creates a periodic mesh on the tensor product of unit intervals using only vertices and edges.
1647cfb853baSMatthew G. Knepley 
1648cfb853baSMatthew G. Knepley   Collective
1649cfb853baSMatthew G. Knepley 
1650cfb853baSMatthew G. Knepley   Input Parameters:
1651cfb853baSMatthew G. Knepley + comm  - The communicator for the DM object
1652cfb853baSMatthew G. Knepley . dim   - The spatial dimension
165320f4b53cSBarry Smith . edges - Number of edges per dimension, or `NULL` for (1,) in 1D and (2, 2) in 2D and (1, 1, 1) in 3D
165420f4b53cSBarry Smith . lower - The lower left corner, or `NULL` for (0, 0, 0)
165520f4b53cSBarry Smith - upper - The upper right corner, or `NULL` for (1, 1, 1)
1656cfb853baSMatthew G. Knepley 
1657cfb853baSMatthew G. Knepley   Output Parameter:
1658cfb853baSMatthew G. Knepley . dm - The DM object
1659cfb853baSMatthew G. Knepley 
166020f4b53cSBarry Smith   Level: beginner
166120f4b53cSBarry Smith 
166220f4b53cSBarry Smith   Note:
166320f4b53cSBarry Smith   If you want to customize this mesh using options, you just need to
166420f4b53cSBarry Smith .vb
166520f4b53cSBarry Smith   DMCreate(comm, &dm);
166620f4b53cSBarry Smith   DMSetType(dm, DMPLEX);
166720f4b53cSBarry Smith   DMSetFromOptions(dm);
166820f4b53cSBarry Smith .ve
166920f4b53cSBarry Smith   and use the options on the `DMSetFromOptions()` page.
1670cfb853baSMatthew G. Knepley 
1671cfb853baSMatthew G. Knepley   The vertices are numbered is lexicographic order, and the dim edges exiting a vertex in the positive orthant are number consecutively,
167220f4b53cSBarry Smith .vb
167320f4b53cSBarry Smith  18--0-19--2-20--4-18
167420f4b53cSBarry Smith   |     |     |     |
167520f4b53cSBarry Smith  13    15    17    13
167620f4b53cSBarry Smith   |     |     |     |
167720f4b53cSBarry Smith  24-12-25-14-26-16-24
167820f4b53cSBarry Smith   |     |     |     |
167920f4b53cSBarry Smith   7     9    11     7
168020f4b53cSBarry Smith   |     |     |     |
168120f4b53cSBarry Smith  21--6-22--8-23-10-21
168220f4b53cSBarry Smith   |     |     |     |
168320f4b53cSBarry Smith   1     3     5     1
168420f4b53cSBarry Smith   |     |     |     |
168520f4b53cSBarry Smith  18--0-19--2-20--4-18
168620f4b53cSBarry Smith .ve
1687cfb853baSMatthew G. Knepley 
168876fbde31SPierre Jolivet .seealso: `DMSetFromOptions()`, `DMPlexCreateFromFile()`, `DMPlexCreateHexCylinderMesh()`, `DMSetType()`, `DMCreate()`
1689cfb853baSMatthew G. Knepley @*/
1690cfb853baSMatthew G. Knepley PetscErrorCode DMPlexCreateHypercubicMesh(MPI_Comm comm, PetscInt dim, const PetscInt edges[], const PetscReal lower[], const PetscReal upper[], DM *dm)
1691cfb853baSMatthew G. Knepley {
1692cfb853baSMatthew G. Knepley   PetscInt       *edg;
1693cfb853baSMatthew G. Knepley   PetscReal      *low, *upp;
1694cfb853baSMatthew G. Knepley   DMBoundaryType *bdt;
1695cfb853baSMatthew G. Knepley   PetscInt        d;
1696cfb853baSMatthew G. Knepley 
1697cfb853baSMatthew G. Knepley   PetscFunctionBegin;
1698cfb853baSMatthew G. Knepley   PetscCall(DMCreate(comm, dm));
1699cfb853baSMatthew G. Knepley   PetscCall(DMSetType(*dm, DMPLEX));
1700cfb853baSMatthew G. Knepley   PetscCall(PetscMalloc4(dim, &edg, dim, &low, dim, &upp, dim, &bdt));
1701cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) {
1702cfb853baSMatthew G. Knepley     edg[d] = edges ? edges[d] : 1;
1703cfb853baSMatthew G. Knepley     low[d] = lower ? lower[d] : 0.;
1704cfb853baSMatthew G. Knepley     upp[d] = upper ? upper[d] : 1.;
1705cfb853baSMatthew G. Knepley     bdt[d] = DM_BOUNDARY_PERIODIC;
1706cfb853baSMatthew G. Knepley   }
1707cfb853baSMatthew G. Knepley   PetscCall(DMPlexCreateHypercubicMesh_Internal(*dm, dim, low, upp, edg, bdt));
1708cfb853baSMatthew G. Knepley   PetscCall(PetscFree4(edg, low, upp, bdt));
17093ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1710cfb853baSMatthew G. Knepley }
1711cfb853baSMatthew G. Knepley 
1712a9074c1eSMatthew G. Knepley /*@C
1713a1cb98faSBarry Smith   DMPlexSetOptionsPrefix - Sets the prefix used for searching for all `DM` options in the database.
1714a9074c1eSMatthew G. Knepley 
171520f4b53cSBarry Smith   Logically Collective
1716a9074c1eSMatthew G. Knepley 
1717a9074c1eSMatthew G. Knepley   Input Parameters:
171820f4b53cSBarry Smith + dm     - the `DM` context
1719a9074c1eSMatthew G. Knepley - prefix - the prefix to prepend to all option names
1720a9074c1eSMatthew G. Knepley 
1721a1cb98faSBarry Smith   Level: advanced
1722a1cb98faSBarry Smith 
1723a1cb98faSBarry Smith   Note:
1724a9074c1eSMatthew G. Knepley   A hyphen (-) must NOT be given at the beginning of the prefix name.
1725a9074c1eSMatthew G. Knepley   The first character of all runtime options is AUTOMATICALLY the hyphen.
1726a9074c1eSMatthew G. Knepley 
17271cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `SNESSetFromOptions()`
1728a9074c1eSMatthew G. Knepley @*/
1729d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexSetOptionsPrefix(DM dm, const char prefix[])
1730d71ae5a4SJacob Faibussowitsch {
1731a9074c1eSMatthew G. Knepley   DM_Plex *mesh = (DM_Plex *)dm->data;
1732a9074c1eSMatthew G. Knepley 
1733a9074c1eSMatthew G. Knepley   PetscFunctionBegin;
1734a9074c1eSMatthew G. Knepley   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
17359566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)dm, prefix));
17369566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)mesh->partitioner, prefix));
17373ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1738a9074c1eSMatthew G. Knepley }
1739a9074c1eSMatthew G. Knepley 
17409318fe57SMatthew G. Knepley /* Remap geometry to cylinder
174161a622f3SMatthew G. Knepley    TODO: This only works for a single refinement, then it is broken
174261a622f3SMatthew G. Knepley 
17439318fe57SMatthew G. Knepley      Interior square: Linear interpolation is correct
17449318fe57SMatthew G. Knepley      The other cells all have vertices on rays from the origin. We want to uniformly expand the spacing
17459318fe57SMatthew G. Knepley      such that the last vertex is on the unit circle. So the closest and farthest vertices are at distance
17460510c589SMatthew G. Knepley 
17479318fe57SMatthew G. Knepley        phi     = arctan(y/x)
17489318fe57SMatthew G. Knepley        d_close = sqrt(1/8 + 1/4 sin^2(phi))
17499318fe57SMatthew G. Knepley        d_far   = sqrt(1/2 + sin^2(phi))
17500510c589SMatthew G. Knepley 
17519318fe57SMatthew G. Knepley      so we remap them using
17520510c589SMatthew G. Knepley 
17539318fe57SMatthew G. Knepley        x_new = x_close + (x - x_close) (1 - d_close) / (d_far - d_close)
17549318fe57SMatthew G. Knepley        y_new = y_close + (y - y_close) (1 - d_close) / (d_far - d_close)
17550510c589SMatthew G. Knepley 
17569318fe57SMatthew G. Knepley      If pi/4 < phi < 3pi/4 or -3pi/4 < phi < -pi/4, then we switch x and y.
17579318fe57SMatthew G. Knepley */
1758d71ae5a4SJacob Faibussowitsch static void snapToCylinder(PetscInt dim, PetscInt Nf, PetscInt NfAux, const PetscInt uOff[], const PetscInt uOff_x[], const PetscScalar u[], const PetscScalar u_t[], const PetscScalar u_x[], const PetscInt aOff[], const PetscInt aOff_x[], const PetscScalar a[], const PetscScalar a_t[], const PetscScalar a_x[], PetscReal t, const PetscReal x[], PetscInt numConstants, const PetscScalar constants[], PetscScalar f0[])
1759d71ae5a4SJacob Faibussowitsch {
17609318fe57SMatthew G. Knepley   const PetscReal dis = 1.0 / PetscSqrtReal(2.0);
17619318fe57SMatthew G. Knepley   const PetscReal ds2 = 0.5 * dis;
176222cc497dSMatthew G. Knepley 
17639318fe57SMatthew G. Knepley   if ((PetscAbsScalar(u[0]) <= ds2) && (PetscAbsScalar(u[1]) <= ds2)) {
17649318fe57SMatthew G. Knepley     f0[0] = u[0];
17659318fe57SMatthew G. Knepley     f0[1] = u[1];
17669318fe57SMatthew G. Knepley   } else {
17679318fe57SMatthew G. Knepley     PetscReal phi, sinp, cosp, dc, df, x, y, xc, yc;
17680510c589SMatthew G. Knepley 
17699318fe57SMatthew G. Knepley     x    = PetscRealPart(u[0]);
17709318fe57SMatthew G. Knepley     y    = PetscRealPart(u[1]);
17719318fe57SMatthew G. Knepley     phi  = PetscAtan2Real(y, x);
17729318fe57SMatthew G. Knepley     sinp = PetscSinReal(phi);
17739318fe57SMatthew G. Knepley     cosp = PetscCosReal(phi);
17749318fe57SMatthew G. Knepley     if ((PetscAbsReal(phi) > PETSC_PI / 4.0) && (PetscAbsReal(phi) < 3.0 * PETSC_PI / 4.0)) {
17759318fe57SMatthew G. Knepley       dc = PetscAbsReal(ds2 / sinp);
17769318fe57SMatthew G. Knepley       df = PetscAbsReal(dis / sinp);
17779318fe57SMatthew G. Knepley       xc = ds2 * x / PetscAbsReal(y);
17789318fe57SMatthew G. Knepley       yc = ds2 * PetscSignReal(y);
17799318fe57SMatthew G. Knepley     } else {
17809318fe57SMatthew G. Knepley       dc = PetscAbsReal(ds2 / cosp);
17819318fe57SMatthew G. Knepley       df = PetscAbsReal(dis / cosp);
17829318fe57SMatthew G. Knepley       xc = ds2 * PetscSignReal(x);
17839318fe57SMatthew G. Knepley       yc = ds2 * y / PetscAbsReal(x);
17849318fe57SMatthew G. Knepley     }
17859318fe57SMatthew G. Knepley     f0[0] = xc + (u[0] - xc) * (1.0 - dc) / (df - dc);
17869318fe57SMatthew G. Knepley     f0[1] = yc + (u[1] - yc) * (1.0 - dc) / (df - dc);
17879318fe57SMatthew G. Knepley   }
17889318fe57SMatthew G. Knepley   f0[2] = u[2];
17899318fe57SMatthew G. Knepley }
17900510c589SMatthew G. Knepley 
1791d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateHexCylinderMesh_Internal(DM dm, DMBoundaryType periodicZ)
1792d71ae5a4SJacob Faibussowitsch {
17930510c589SMatthew G. Knepley   const PetscInt dim = 3;
17949318fe57SMatthew G. Knepley   PetscInt       numCells, numVertices;
1795d8c47e87SMatthew G. Knepley   PetscMPIInt    rank;
17960510c589SMatthew G. Knepley 
17970510c589SMatthew G. Knepley   PetscFunctionBegin;
179846139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
17999566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
18009566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
18010510c589SMatthew G. Knepley   /* Create topology */
18020510c589SMatthew G. Knepley   {
18030510c589SMatthew G. Knepley     PetscInt cone[8], c;
18040510c589SMatthew G. Knepley 
1805dd400576SPatrick Sanan     numCells    = rank == 0 ? 5 : 0;
1806dd400576SPatrick Sanan     numVertices = rank == 0 ? 16 : 0;
1807006a8963SMatthew G. Knepley     if (periodicZ == DM_BOUNDARY_PERIODIC) {
1808ae8bcbbbSMatthew G. Knepley       numCells *= 3;
1809dd400576SPatrick Sanan       numVertices = rank == 0 ? 24 : 0;
1810006a8963SMatthew G. Knepley     }
18119566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
18129566063dSJacob Faibussowitsch     for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 8));
18139566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm));
1814dd400576SPatrick Sanan     if (rank == 0) {
1815006a8963SMatthew G. Knepley       if (periodicZ == DM_BOUNDARY_PERIODIC) {
18169371c9d4SSatish Balay         cone[0] = 15;
18179371c9d4SSatish Balay         cone[1] = 18;
18189371c9d4SSatish Balay         cone[2] = 17;
18199371c9d4SSatish Balay         cone[3] = 16;
18209371c9d4SSatish Balay         cone[4] = 31;
18219371c9d4SSatish Balay         cone[5] = 32;
18229371c9d4SSatish Balay         cone[6] = 33;
18239371c9d4SSatish Balay         cone[7] = 34;
18249566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
18259371c9d4SSatish Balay         cone[0] = 16;
18269371c9d4SSatish Balay         cone[1] = 17;
18279371c9d4SSatish Balay         cone[2] = 24;
18289371c9d4SSatish Balay         cone[3] = 23;
18299371c9d4SSatish Balay         cone[4] = 32;
18309371c9d4SSatish Balay         cone[5] = 36;
18319371c9d4SSatish Balay         cone[6] = 37;
18329371c9d4SSatish Balay         cone[7] = 33; /* 22 25 26 21 */
18339566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
18349371c9d4SSatish Balay         cone[0] = 18;
18359371c9d4SSatish Balay         cone[1] = 27;
18369371c9d4SSatish Balay         cone[2] = 24;
18379371c9d4SSatish Balay         cone[3] = 17;
18389371c9d4SSatish Balay         cone[4] = 34;
18399371c9d4SSatish Balay         cone[5] = 33;
18409371c9d4SSatish Balay         cone[6] = 37;
18419371c9d4SSatish Balay         cone[7] = 38;
18429566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
18439371c9d4SSatish Balay         cone[0] = 29;
18449371c9d4SSatish Balay         cone[1] = 27;
18459371c9d4SSatish Balay         cone[2] = 18;
18469371c9d4SSatish Balay         cone[3] = 15;
18479371c9d4SSatish Balay         cone[4] = 35;
18489371c9d4SSatish Balay         cone[5] = 31;
18499371c9d4SSatish Balay         cone[6] = 34;
18509371c9d4SSatish Balay         cone[7] = 38;
18519566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
18529371c9d4SSatish Balay         cone[0] = 29;
18539371c9d4SSatish Balay         cone[1] = 15;
18549371c9d4SSatish Balay         cone[2] = 16;
18559371c9d4SSatish Balay         cone[3] = 23;
18569371c9d4SSatish Balay         cone[4] = 35;
18579371c9d4SSatish Balay         cone[5] = 36;
18589371c9d4SSatish Balay         cone[6] = 32;
18599371c9d4SSatish Balay         cone[7] = 31;
18609566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
1861006a8963SMatthew G. Knepley 
18629371c9d4SSatish Balay         cone[0] = 31;
18639371c9d4SSatish Balay         cone[1] = 34;
18649371c9d4SSatish Balay         cone[2] = 33;
18659371c9d4SSatish Balay         cone[3] = 32;
18669371c9d4SSatish Balay         cone[4] = 19;
18679371c9d4SSatish Balay         cone[5] = 22;
18689371c9d4SSatish Balay         cone[6] = 21;
18699371c9d4SSatish Balay         cone[7] = 20;
18709566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 5, cone));
18719371c9d4SSatish Balay         cone[0] = 32;
18729371c9d4SSatish Balay         cone[1] = 33;
18739371c9d4SSatish Balay         cone[2] = 37;
18749371c9d4SSatish Balay         cone[3] = 36;
18759371c9d4SSatish Balay         cone[4] = 22;
18769371c9d4SSatish Balay         cone[5] = 25;
18779371c9d4SSatish Balay         cone[6] = 26;
18789371c9d4SSatish Balay         cone[7] = 21;
18799566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 6, cone));
18809371c9d4SSatish Balay         cone[0] = 34;
18819371c9d4SSatish Balay         cone[1] = 38;
18829371c9d4SSatish Balay         cone[2] = 37;
18839371c9d4SSatish Balay         cone[3] = 33;
18849371c9d4SSatish Balay         cone[4] = 20;
18859371c9d4SSatish Balay         cone[5] = 21;
18869371c9d4SSatish Balay         cone[6] = 26;
18879371c9d4SSatish Balay         cone[7] = 28;
18889566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 7, cone));
18899371c9d4SSatish Balay         cone[0] = 35;
18909371c9d4SSatish Balay         cone[1] = 38;
18919371c9d4SSatish Balay         cone[2] = 34;
18929371c9d4SSatish Balay         cone[3] = 31;
18939371c9d4SSatish Balay         cone[4] = 30;
18949371c9d4SSatish Balay         cone[5] = 19;
18959371c9d4SSatish Balay         cone[6] = 20;
18969371c9d4SSatish Balay         cone[7] = 28;
18979566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 8, cone));
18989371c9d4SSatish Balay         cone[0] = 35;
18999371c9d4SSatish Balay         cone[1] = 31;
19009371c9d4SSatish Balay         cone[2] = 32;
19019371c9d4SSatish Balay         cone[3] = 36;
19029371c9d4SSatish Balay         cone[4] = 30;
19039371c9d4SSatish Balay         cone[5] = 25;
19049371c9d4SSatish Balay         cone[6] = 22;
19059371c9d4SSatish Balay         cone[7] = 19;
19069566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 9, cone));
1907ae8bcbbbSMatthew G. Knepley 
19089371c9d4SSatish Balay         cone[0] = 19;
19099371c9d4SSatish Balay         cone[1] = 20;
19109371c9d4SSatish Balay         cone[2] = 21;
19119371c9d4SSatish Balay         cone[3] = 22;
19129371c9d4SSatish Balay         cone[4] = 15;
19139371c9d4SSatish Balay         cone[5] = 16;
19149371c9d4SSatish Balay         cone[6] = 17;
19159371c9d4SSatish Balay         cone[7] = 18;
19169566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 10, cone));
19179371c9d4SSatish Balay         cone[0] = 22;
19189371c9d4SSatish Balay         cone[1] = 21;
19199371c9d4SSatish Balay         cone[2] = 26;
19209371c9d4SSatish Balay         cone[3] = 25;
19219371c9d4SSatish Balay         cone[4] = 16;
19229371c9d4SSatish Balay         cone[5] = 23;
19239371c9d4SSatish Balay         cone[6] = 24;
19249371c9d4SSatish Balay         cone[7] = 17;
19259566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 11, cone));
19269371c9d4SSatish Balay         cone[0] = 20;
19279371c9d4SSatish Balay         cone[1] = 28;
19289371c9d4SSatish Balay         cone[2] = 26;
19299371c9d4SSatish Balay         cone[3] = 21;
19309371c9d4SSatish Balay         cone[4] = 18;
19319371c9d4SSatish Balay         cone[5] = 17;
19329371c9d4SSatish Balay         cone[6] = 24;
19339371c9d4SSatish Balay         cone[7] = 27;
19349566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 12, cone));
19359371c9d4SSatish Balay         cone[0] = 30;
19369371c9d4SSatish Balay         cone[1] = 28;
19379371c9d4SSatish Balay         cone[2] = 20;
19389371c9d4SSatish Balay         cone[3] = 19;
19399371c9d4SSatish Balay         cone[4] = 29;
19409371c9d4SSatish Balay         cone[5] = 15;
19419371c9d4SSatish Balay         cone[6] = 18;
19429371c9d4SSatish Balay         cone[7] = 27;
19439566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 13, cone));
19449371c9d4SSatish Balay         cone[0] = 30;
19459371c9d4SSatish Balay         cone[1] = 19;
19469371c9d4SSatish Balay         cone[2] = 22;
19479371c9d4SSatish Balay         cone[3] = 25;
19489371c9d4SSatish Balay         cone[4] = 29;
19499371c9d4SSatish Balay         cone[5] = 23;
19509371c9d4SSatish Balay         cone[6] = 16;
19519371c9d4SSatish Balay         cone[7] = 15;
19529566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 14, cone));
1953006a8963SMatthew G. Knepley       } else {
19549371c9d4SSatish Balay         cone[0] = 5;
19559371c9d4SSatish Balay         cone[1] = 8;
19569371c9d4SSatish Balay         cone[2] = 7;
19579371c9d4SSatish Balay         cone[3] = 6;
19589371c9d4SSatish Balay         cone[4] = 9;
19599371c9d4SSatish Balay         cone[5] = 12;
19609371c9d4SSatish Balay         cone[6] = 11;
19619371c9d4SSatish Balay         cone[7] = 10;
19629566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
19639371c9d4SSatish Balay         cone[0] = 6;
19649371c9d4SSatish Balay         cone[1] = 7;
19659371c9d4SSatish Balay         cone[2] = 14;
19669371c9d4SSatish Balay         cone[3] = 13;
19679371c9d4SSatish Balay         cone[4] = 12;
19689371c9d4SSatish Balay         cone[5] = 15;
19699371c9d4SSatish Balay         cone[6] = 16;
19709371c9d4SSatish Balay         cone[7] = 11;
19719566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
19729371c9d4SSatish Balay         cone[0] = 8;
19739371c9d4SSatish Balay         cone[1] = 17;
19749371c9d4SSatish Balay         cone[2] = 14;
19759371c9d4SSatish Balay         cone[3] = 7;
19769371c9d4SSatish Balay         cone[4] = 10;
19779371c9d4SSatish Balay         cone[5] = 11;
19789371c9d4SSatish Balay         cone[6] = 16;
19799371c9d4SSatish Balay         cone[7] = 18;
19809566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
19819371c9d4SSatish Balay         cone[0] = 19;
19829371c9d4SSatish Balay         cone[1] = 17;
19839371c9d4SSatish Balay         cone[2] = 8;
19849371c9d4SSatish Balay         cone[3] = 5;
19859371c9d4SSatish Balay         cone[4] = 20;
19869371c9d4SSatish Balay         cone[5] = 9;
19879371c9d4SSatish Balay         cone[6] = 10;
19889371c9d4SSatish Balay         cone[7] = 18;
19899566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
19909371c9d4SSatish Balay         cone[0] = 19;
19919371c9d4SSatish Balay         cone[1] = 5;
19929371c9d4SSatish Balay         cone[2] = 6;
19939371c9d4SSatish Balay         cone[3] = 13;
19949371c9d4SSatish Balay         cone[4] = 20;
19959371c9d4SSatish Balay         cone[5] = 15;
19969371c9d4SSatish Balay         cone[6] = 12;
19979371c9d4SSatish Balay         cone[7] = 9;
19989566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
1999006a8963SMatthew G. Knepley       }
2000d8c47e87SMatthew G. Knepley     }
20019566063dSJacob Faibussowitsch     PetscCall(DMPlexSymmetrize(dm));
20029566063dSJacob Faibussowitsch     PetscCall(DMPlexStratify(dm));
20030510c589SMatthew G. Knepley   }
2004dbc1dc17SMatthew G. Knepley   /* Create cube geometry */
20050510c589SMatthew G. Knepley   {
20060510c589SMatthew G. Knepley     Vec             coordinates;
20070510c589SMatthew G. Knepley     PetscSection    coordSection;
20080510c589SMatthew G. Knepley     PetscScalar    *coords;
20090510c589SMatthew G. Knepley     PetscInt        coordSize, v;
20100510c589SMatthew G. Knepley     const PetscReal dis = 1.0 / PetscSqrtReal(2.0);
20110510c589SMatthew G. Knepley     const PetscReal ds2 = dis / 2.0;
20120510c589SMatthew G. Knepley 
20130510c589SMatthew G. Knepley     /* Build coordinates */
20149566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &coordSection));
20159566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetNumFields(coordSection, 1));
20169566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
20179566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetChart(coordSection, numCells, numCells + numVertices));
20180510c589SMatthew G. Knepley     for (v = numCells; v < numCells + numVertices; ++v) {
20199566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetDof(coordSection, v, dim));
20209566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
20210510c589SMatthew G. Knepley     }
20229566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetUp(coordSection));
20239566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
20249566063dSJacob Faibussowitsch     PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
20259566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
20269566063dSJacob Faibussowitsch     PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
20279566063dSJacob Faibussowitsch     PetscCall(VecSetBlockSize(coordinates, dim));
20289566063dSJacob Faibussowitsch     PetscCall(VecSetType(coordinates, VECSTANDARD));
20299566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
2030dd400576SPatrick Sanan     if (rank == 0) {
20319371c9d4SSatish Balay       coords[0 * dim + 0]  = -ds2;
20329371c9d4SSatish Balay       coords[0 * dim + 1]  = -ds2;
20339371c9d4SSatish Balay       coords[0 * dim + 2]  = 0.0;
20349371c9d4SSatish Balay       coords[1 * dim + 0]  = ds2;
20359371c9d4SSatish Balay       coords[1 * dim + 1]  = -ds2;
20369371c9d4SSatish Balay       coords[1 * dim + 2]  = 0.0;
20379371c9d4SSatish Balay       coords[2 * dim + 0]  = ds2;
20389371c9d4SSatish Balay       coords[2 * dim + 1]  = ds2;
20399371c9d4SSatish Balay       coords[2 * dim + 2]  = 0.0;
20409371c9d4SSatish Balay       coords[3 * dim + 0]  = -ds2;
20419371c9d4SSatish Balay       coords[3 * dim + 1]  = ds2;
20429371c9d4SSatish Balay       coords[3 * dim + 2]  = 0.0;
20439371c9d4SSatish Balay       coords[4 * dim + 0]  = -ds2;
20449371c9d4SSatish Balay       coords[4 * dim + 1]  = -ds2;
20459371c9d4SSatish Balay       coords[4 * dim + 2]  = 1.0;
20469371c9d4SSatish Balay       coords[5 * dim + 0]  = -ds2;
20479371c9d4SSatish Balay       coords[5 * dim + 1]  = ds2;
20489371c9d4SSatish Balay       coords[5 * dim + 2]  = 1.0;
20499371c9d4SSatish Balay       coords[6 * dim + 0]  = ds2;
20509371c9d4SSatish Balay       coords[6 * dim + 1]  = ds2;
20519371c9d4SSatish Balay       coords[6 * dim + 2]  = 1.0;
20529371c9d4SSatish Balay       coords[7 * dim + 0]  = ds2;
20539371c9d4SSatish Balay       coords[7 * dim + 1]  = -ds2;
20549371c9d4SSatish Balay       coords[7 * dim + 2]  = 1.0;
20559371c9d4SSatish Balay       coords[8 * dim + 0]  = dis;
20569371c9d4SSatish Balay       coords[8 * dim + 1]  = -dis;
20579371c9d4SSatish Balay       coords[8 * dim + 2]  = 0.0;
20589371c9d4SSatish Balay       coords[9 * dim + 0]  = dis;
20599371c9d4SSatish Balay       coords[9 * dim + 1]  = dis;
20609371c9d4SSatish Balay       coords[9 * dim + 2]  = 0.0;
20619371c9d4SSatish Balay       coords[10 * dim + 0] = dis;
20629371c9d4SSatish Balay       coords[10 * dim + 1] = -dis;
20639371c9d4SSatish Balay       coords[10 * dim + 2] = 1.0;
20649371c9d4SSatish Balay       coords[11 * dim + 0] = dis;
20659371c9d4SSatish Balay       coords[11 * dim + 1] = dis;
20669371c9d4SSatish Balay       coords[11 * dim + 2] = 1.0;
20679371c9d4SSatish Balay       coords[12 * dim + 0] = -dis;
20689371c9d4SSatish Balay       coords[12 * dim + 1] = dis;
20699371c9d4SSatish Balay       coords[12 * dim + 2] = 0.0;
20709371c9d4SSatish Balay       coords[13 * dim + 0] = -dis;
20719371c9d4SSatish Balay       coords[13 * dim + 1] = dis;
20729371c9d4SSatish Balay       coords[13 * dim + 2] = 1.0;
20739371c9d4SSatish Balay       coords[14 * dim + 0] = -dis;
20749371c9d4SSatish Balay       coords[14 * dim + 1] = -dis;
20759371c9d4SSatish Balay       coords[14 * dim + 2] = 0.0;
20769371c9d4SSatish Balay       coords[15 * dim + 0] = -dis;
20779371c9d4SSatish Balay       coords[15 * dim + 1] = -dis;
20789371c9d4SSatish Balay       coords[15 * dim + 2] = 1.0;
2079ae8bcbbbSMatthew G. Knepley       if (periodicZ == DM_BOUNDARY_PERIODIC) {
20809371c9d4SSatish Balay         /* 15 31 19 */ coords[16 * dim + 0] = -ds2;
20819371c9d4SSatish Balay         coords[16 * dim + 1]                = -ds2;
20829371c9d4SSatish Balay         coords[16 * dim + 2]                = 0.5;
20839371c9d4SSatish Balay         /* 16 32 22 */ coords[17 * dim + 0] = ds2;
20849371c9d4SSatish Balay         coords[17 * dim + 1]                = -ds2;
20859371c9d4SSatish Balay         coords[17 * dim + 2]                = 0.5;
20869371c9d4SSatish Balay         /* 17 33 21 */ coords[18 * dim + 0] = ds2;
20879371c9d4SSatish Balay         coords[18 * dim + 1]                = ds2;
20889371c9d4SSatish Balay         coords[18 * dim + 2]                = 0.5;
20899371c9d4SSatish Balay         /* 18 34 20 */ coords[19 * dim + 0] = -ds2;
20909371c9d4SSatish Balay         coords[19 * dim + 1]                = ds2;
20919371c9d4SSatish Balay         coords[19 * dim + 2]                = 0.5;
20929371c9d4SSatish Balay         /* 29 35 30 */ coords[20 * dim + 0] = -dis;
20939371c9d4SSatish Balay         coords[20 * dim + 1]                = -dis;
20949371c9d4SSatish Balay         coords[20 * dim + 2]                = 0.5;
20959371c9d4SSatish Balay         /* 23 36 25 */ coords[21 * dim + 0] = dis;
20969371c9d4SSatish Balay         coords[21 * dim + 1]                = -dis;
20979371c9d4SSatish Balay         coords[21 * dim + 2]                = 0.5;
20989371c9d4SSatish Balay         /* 24 37 26 */ coords[22 * dim + 0] = dis;
20999371c9d4SSatish Balay         coords[22 * dim + 1]                = dis;
21009371c9d4SSatish Balay         coords[22 * dim + 2]                = 0.5;
21019371c9d4SSatish Balay         /* 27 38 28 */ coords[23 * dim + 0] = -dis;
21029371c9d4SSatish Balay         coords[23 * dim + 1]                = dis;
21039371c9d4SSatish Balay         coords[23 * dim + 2]                = 0.5;
2104ae8bcbbbSMatthew G. Knepley       }
2105d8c47e87SMatthew G. Knepley     }
21069566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(coordinates, &coords));
21079566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, coordinates));
21089566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&coordinates));
21090510c589SMatthew G. Knepley   }
2110006a8963SMatthew G. Knepley   /* Create periodicity */
2111006a8963SMatthew G. Knepley   if (periodicZ == DM_BOUNDARY_PERIODIC || periodicZ == DM_BOUNDARY_TWIST) {
21126858538eSMatthew G. Knepley     PetscReal L[3]       = {-1., -1., 0.};
21136858538eSMatthew G. Knepley     PetscReal maxCell[3] = {-1., -1., 0.};
2114006a8963SMatthew G. Knepley     PetscReal lower[3]   = {0.0, 0.0, 0.0};
2115ae8bcbbbSMatthew G. Knepley     PetscReal upper[3]   = {1.0, 1.0, 1.5};
21166858538eSMatthew G. Knepley     PetscInt  numZCells  = 3;
2117006a8963SMatthew G. Knepley 
21186858538eSMatthew G. Knepley     L[2]       = upper[2] - lower[2];
21196858538eSMatthew G. Knepley     maxCell[2] = 1.1 * (L[2] / numZCells);
21204fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dm, maxCell, lower, L));
2121006a8963SMatthew G. Knepley   }
2122dbc1dc17SMatthew G. Knepley   {
21239318fe57SMatthew G. Knepley     DM          cdm;
21249318fe57SMatthew G. Knepley     PetscDS     cds;
21259318fe57SMatthew G. Knepley     PetscScalar c[2] = {1.0, 1.0};
2126dbc1dc17SMatthew G. Knepley 
2127e44f6aebSMatthew G. Knepley     PetscCall(DMPlexCreateCoordinateSpace(dm, 1, PETSC_TRUE, snapToCylinder));
21289566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
21299566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
21309566063dSJacob Faibussowitsch     PetscCall(PetscDSSetConstants(cds, 2, c));
2131dbc1dc17SMatthew G. Knepley   }
213246139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
213346139095SJed Brown 
21349318fe57SMatthew G. Knepley   /* Wait for coordinate creation before doing in-place modification */
21359566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolateInPlace_Internal(dm));
21363ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
21370510c589SMatthew G. Knepley }
21380510c589SMatthew G. Knepley 
213924119c2aSMatthew G. Knepley /*@
21409318fe57SMatthew G. Knepley   DMPlexCreateHexCylinderMesh - Creates a mesh on the tensor product of the unit interval with the circle (cylinder) using hexahedra.
214124119c2aSMatthew G. Knepley 
2142d083f849SBarry Smith   Collective
214324119c2aSMatthew G. Knepley 
214424119c2aSMatthew G. Knepley   Input Parameters:
2145a1cb98faSBarry Smith + comm      - The communicator for the `DM` object
21469318fe57SMatthew G. Knepley - periodicZ - The boundary type for the Z direction
214724119c2aSMatthew G. Knepley 
214824119c2aSMatthew G. Knepley   Output Parameter:
214920f4b53cSBarry Smith . dm - The `DM` object
215024119c2aSMatthew G. Knepley 
215124119c2aSMatthew G. Knepley   Level: beginner
215224119c2aSMatthew G. Knepley 
2153a1cb98faSBarry Smith   Note:
2154a4e35b19SJacob Faibussowitsch   Here is the output numbering looking from the bottom of the cylinder\:
2155a1cb98faSBarry Smith .vb
2156a1cb98faSBarry Smith        17-----14
2157a1cb98faSBarry Smith         |     |
2158a1cb98faSBarry Smith         |  2  |
2159a1cb98faSBarry Smith         |     |
2160a1cb98faSBarry Smith  17-----8-----7-----14
2161a1cb98faSBarry Smith   |     |     |     |
2162a1cb98faSBarry Smith   |  3  |  0  |  1  |
2163a1cb98faSBarry Smith   |     |     |     |
2164a1cb98faSBarry Smith  19-----5-----6-----13
2165a1cb98faSBarry Smith         |     |
2166a1cb98faSBarry Smith         |  4  |
2167a1cb98faSBarry Smith         |     |
2168a1cb98faSBarry Smith        19-----13
2169a1cb98faSBarry Smith 
2170a1cb98faSBarry Smith  and up through the top
2171a1cb98faSBarry Smith 
2172a1cb98faSBarry Smith        18-----16
2173a1cb98faSBarry Smith         |     |
2174a1cb98faSBarry Smith         |  2  |
2175a1cb98faSBarry Smith         |     |
2176a1cb98faSBarry Smith  18----10----11-----16
2177a1cb98faSBarry Smith   |     |     |     |
2178a1cb98faSBarry Smith   |  3  |  0  |  1  |
2179a1cb98faSBarry Smith   |     |     |     |
2180a1cb98faSBarry Smith  20-----9----12-----15
2181a1cb98faSBarry Smith         |     |
2182a1cb98faSBarry Smith         |  4  |
2183a1cb98faSBarry Smith         |     |
2184a1cb98faSBarry Smith        20-----15
2185a1cb98faSBarry Smith .ve
2186a1cb98faSBarry Smith 
21871cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
218824119c2aSMatthew G. Knepley @*/
2189d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateHexCylinderMesh(MPI_Comm comm, DMBoundaryType periodicZ, DM *dm)
2190d71ae5a4SJacob Faibussowitsch {
21919318fe57SMatthew G. Knepley   PetscFunctionBegin;
21924f572ea9SToby Isaac   PetscAssertPointer(dm, 3);
21939566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
21949566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
21959566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateHexCylinderMesh_Internal(*dm, periodicZ));
21963ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
21979318fe57SMatthew G. Knepley }
21989318fe57SMatthew G. Knepley 
2199d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateWedgeCylinderMesh_Internal(DM dm, PetscInt n, PetscBool interpolate)
2200d71ae5a4SJacob Faibussowitsch {
220124119c2aSMatthew G. Knepley   const PetscInt dim = 3;
2202412e9a14SMatthew G. Knepley   PetscInt       numCells, numVertices, v;
22039fe9f049SMatthew G. Knepley   PetscMPIInt    rank;
220424119c2aSMatthew G. Knepley 
220524119c2aSMatthew G. Knepley   PetscFunctionBegin;
220663a3b9bcSJacob Faibussowitsch   PetscCheck(n >= 0, PetscObjectComm((PetscObject)dm), PETSC_ERR_ARG_OUTOFRANGE, "Number of wedges %" PetscInt_FMT " cannot be negative", n);
220746139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
22089566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
22099566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
2210412e9a14SMatthew G. Knepley   /* Must create the celltype label here so that we do not automatically try to compute the types */
22119566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "celltype"));
221224119c2aSMatthew G. Knepley   /* Create topology */
221324119c2aSMatthew G. Knepley   {
221424119c2aSMatthew G. Knepley     PetscInt cone[6], c;
221524119c2aSMatthew G. Knepley 
2216dd400576SPatrick Sanan     numCells    = rank == 0 ? n : 0;
2217dd400576SPatrick Sanan     numVertices = rank == 0 ? 2 * (n + 1) : 0;
22189566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
22199566063dSJacob Faibussowitsch     for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 6));
22209566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm));
222124119c2aSMatthew G. Knepley     for (c = 0; c < numCells; c++) {
22229371c9d4SSatish Balay       cone[0] = c + n * 1;
22239371c9d4SSatish Balay       cone[1] = (c + 1) % n + n * 1;
22249371c9d4SSatish Balay       cone[2] = 0 + 3 * n;
22259371c9d4SSatish Balay       cone[3] = c + n * 2;
22269371c9d4SSatish Balay       cone[4] = (c + 1) % n + n * 2;
22279371c9d4SSatish Balay       cone[5] = 1 + 3 * n;
22289566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCone(dm, c, cone));
22299566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCellType(dm, c, DM_POLYTOPE_TRI_PRISM_TENSOR));
223024119c2aSMatthew G. Knepley     }
22319566063dSJacob Faibussowitsch     PetscCall(DMPlexSymmetrize(dm));
22329566063dSJacob Faibussowitsch     PetscCall(DMPlexStratify(dm));
223324119c2aSMatthew G. Knepley   }
223448a46eb9SPierre Jolivet   for (v = numCells; v < numCells + numVertices; ++v) PetscCall(DMPlexSetCellType(dm, v, DM_POLYTOPE_POINT));
223524119c2aSMatthew G. Knepley   /* Create cylinder geometry */
223624119c2aSMatthew G. Knepley   {
223724119c2aSMatthew G. Knepley     Vec          coordinates;
223824119c2aSMatthew G. Knepley     PetscSection coordSection;
223924119c2aSMatthew G. Knepley     PetscScalar *coords;
2240412e9a14SMatthew G. Knepley     PetscInt     coordSize, c;
224124119c2aSMatthew G. Knepley 
224224119c2aSMatthew G. Knepley     /* Build coordinates */
22439566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &coordSection));
22449566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetNumFields(coordSection, 1));
22459566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
22469566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetChart(coordSection, numCells, numCells + numVertices));
224724119c2aSMatthew G. Knepley     for (v = numCells; v < numCells + numVertices; ++v) {
22489566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetDof(coordSection, v, dim));
22499566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
225024119c2aSMatthew G. Knepley     }
22519566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetUp(coordSection));
22529566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
22539566063dSJacob Faibussowitsch     PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
22549566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
22559566063dSJacob Faibussowitsch     PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
22569566063dSJacob Faibussowitsch     PetscCall(VecSetBlockSize(coordinates, dim));
22579566063dSJacob Faibussowitsch     PetscCall(VecSetType(coordinates, VECSTANDARD));
22589566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
225924119c2aSMatthew G. Knepley     for (c = 0; c < numCells; c++) {
22609371c9d4SSatish Balay       coords[(c + 0 * n) * dim + 0] = PetscCosReal(2.0 * c * PETSC_PI / n);
22619371c9d4SSatish Balay       coords[(c + 0 * n) * dim + 1] = PetscSinReal(2.0 * c * PETSC_PI / n);
22629371c9d4SSatish Balay       coords[(c + 0 * n) * dim + 2] = 1.0;
22639371c9d4SSatish Balay       coords[(c + 1 * n) * dim + 0] = PetscCosReal(2.0 * c * PETSC_PI / n);
22649371c9d4SSatish Balay       coords[(c + 1 * n) * dim + 1] = PetscSinReal(2.0 * c * PETSC_PI / n);
22659371c9d4SSatish Balay       coords[(c + 1 * n) * dim + 2] = 0.0;
226624119c2aSMatthew G. Knepley     }
2267dd400576SPatrick Sanan     if (rank == 0) {
22689371c9d4SSatish Balay       coords[(2 * n + 0) * dim + 0] = 0.0;
22699371c9d4SSatish Balay       coords[(2 * n + 0) * dim + 1] = 0.0;
22709371c9d4SSatish Balay       coords[(2 * n + 0) * dim + 2] = 1.0;
22719371c9d4SSatish Balay       coords[(2 * n + 1) * dim + 0] = 0.0;
22729371c9d4SSatish Balay       coords[(2 * n + 1) * dim + 1] = 0.0;
22739371c9d4SSatish Balay       coords[(2 * n + 1) * dim + 2] = 0.0;
22749fe9f049SMatthew G. Knepley     }
22759566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(coordinates, &coords));
22769566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, coordinates));
22779566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&coordinates));
227824119c2aSMatthew G. Knepley   }
227946139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
22809318fe57SMatthew G. Knepley   /* Interpolate */
22819566063dSJacob Faibussowitsch   if (interpolate) PetscCall(DMPlexInterpolateInPlace_Internal(dm));
22823ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
22839318fe57SMatthew G. Knepley }
22849318fe57SMatthew G. Knepley 
22859318fe57SMatthew G. Knepley /*@
22869318fe57SMatthew G. Knepley   DMPlexCreateWedgeCylinderMesh - Creates a mesh on the tensor product of the unit interval with the circle (cylinder) using wedges.
22879318fe57SMatthew G. Knepley 
22889318fe57SMatthew G. Knepley   Collective
22899318fe57SMatthew G. Knepley 
22909318fe57SMatthew G. Knepley   Input Parameters:
2291a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
22929318fe57SMatthew G. Knepley . n           - The number of wedges around the origin
22939318fe57SMatthew G. Knepley - interpolate - Create edges and faces
22949318fe57SMatthew G. Knepley 
22959318fe57SMatthew G. Knepley   Output Parameter:
2296a1cb98faSBarry Smith . dm - The `DM` object
22979318fe57SMatthew G. Knepley 
22989318fe57SMatthew G. Knepley   Level: beginner
22999318fe57SMatthew G. Knepley 
23001cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateHexCylinderMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
23019318fe57SMatthew G. Knepley @*/
2302d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateWedgeCylinderMesh(MPI_Comm comm, PetscInt n, PetscBool interpolate, DM *dm)
2303d71ae5a4SJacob Faibussowitsch {
23049318fe57SMatthew G. Knepley   PetscFunctionBegin;
23054f572ea9SToby Isaac   PetscAssertPointer(dm, 4);
23069566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
23079566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
23089566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateWedgeCylinderMesh_Internal(*dm, n, interpolate));
23093ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
231024119c2aSMatthew G. Knepley }
231124119c2aSMatthew G. Knepley 
2312d71ae5a4SJacob Faibussowitsch static inline PetscReal DiffNormReal(PetscInt dim, const PetscReal x[], const PetscReal y[])
2313d71ae5a4SJacob Faibussowitsch {
231465a81367SMatthew G. Knepley   PetscReal prod = 0.0;
231565a81367SMatthew G. Knepley   PetscInt  i;
231665a81367SMatthew G. Knepley   for (i = 0; i < dim; ++i) prod += PetscSqr(x[i] - y[i]);
231765a81367SMatthew G. Knepley   return PetscSqrtReal(prod);
231865a81367SMatthew G. Knepley }
2319d71ae5a4SJacob Faibussowitsch static inline PetscReal DotReal(PetscInt dim, const PetscReal x[], const PetscReal y[])
2320d71ae5a4SJacob Faibussowitsch {
232165a81367SMatthew G. Knepley   PetscReal prod = 0.0;
232265a81367SMatthew G. Knepley   PetscInt  i;
232365a81367SMatthew G. Knepley   for (i = 0; i < dim; ++i) prod += x[i] * y[i];
232465a81367SMatthew G. Knepley   return prod;
232565a81367SMatthew G. Knepley }
232665a81367SMatthew G. Knepley 
232751a74b61SMatthew G. Knepley /* The first constant is the sphere radius */
2328d71ae5a4SJacob Faibussowitsch static void snapToSphere(PetscInt dim, PetscInt Nf, PetscInt NfAux, const PetscInt uOff[], const PetscInt uOff_x[], const PetscScalar u[], const PetscScalar u_t[], const PetscScalar u_x[], const PetscInt aOff[], const PetscInt aOff_x[], const PetscScalar a[], const PetscScalar a_t[], const PetscScalar a_x[], PetscReal t, const PetscReal x[], PetscInt numConstants, const PetscScalar constants[], PetscScalar f0[])
2329d71ae5a4SJacob Faibussowitsch {
233051a74b61SMatthew G. Knepley   PetscReal r     = PetscRealPart(constants[0]);
233151a74b61SMatthew G. Knepley   PetscReal norm2 = 0.0, fac;
233251a74b61SMatthew G. Knepley   PetscInt  n     = uOff[1] - uOff[0], d;
233351a74b61SMatthew G. Knepley 
233451a74b61SMatthew G. Knepley   for (d = 0; d < n; ++d) norm2 += PetscSqr(PetscRealPart(u[d]));
233551a74b61SMatthew G. Knepley   fac = r / PetscSqrtReal(norm2);
233651a74b61SMatthew G. Knepley   for (d = 0; d < n; ++d) f0[d] = u[d] * fac;
233751a74b61SMatthew G. Knepley }
233851a74b61SMatthew G. Knepley 
2339d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateSphereMesh_Internal(DM dm, PetscInt dim, PetscBool simplex, PetscReal R)
2340d71ae5a4SJacob Faibussowitsch {
234165a81367SMatthew G. Knepley   const PetscInt embedDim = dim + 1;
234265a81367SMatthew G. Knepley   PetscSection   coordSection;
234365a81367SMatthew G. Knepley   Vec            coordinates;
234465a81367SMatthew G. Knepley   PetscScalar   *coords;
234565a81367SMatthew G. Knepley   PetscReal     *coordsIn;
234607c565c5SJose E. Roman   PetscInt       numCells, numEdges, numVerts = 0, firstVertex = 0, v, firstEdge, coordSize, d, e;
234765a81367SMatthew G. Knepley   PetscMPIInt    rank;
234865a81367SMatthew G. Knepley 
234965a81367SMatthew G. Knepley   PetscFunctionBegin;
23509318fe57SMatthew G. Knepley   PetscValidLogicalCollectiveBool(dm, simplex, 3);
235146139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
23529566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
23539566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, dim + 1));
23549566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
235565a81367SMatthew G. Knepley   switch (dim) {
23565c344501SMatthew G. Knepley   case 1:
23575c344501SMatthew G. Knepley     numCells = 16;
23585c344501SMatthew G. Knepley     numVerts = numCells;
23595c344501SMatthew G. Knepley 
23605c344501SMatthew G. Knepley     // Build Topology
23615c344501SMatthew G. Knepley     PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
23625c344501SMatthew G. Knepley     for (PetscInt c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
23635c344501SMatthew G. Knepley     PetscCall(DMSetUp(dm));
23645c344501SMatthew G. Knepley     for (PetscInt c = 0; c < numCells; ++c) {
23655c344501SMatthew G. Knepley       PetscInt cone[2];
23665c344501SMatthew G. Knepley 
23675c344501SMatthew G. Knepley       cone[0] = c + numCells;
23685c344501SMatthew G. Knepley       cone[1] = (c + 1) % numVerts + numCells;
23695c344501SMatthew G. Knepley       PetscCall(DMPlexSetCone(dm, c, cone));
23705c344501SMatthew G. Knepley     }
23715c344501SMatthew G. Knepley     PetscCall(DMPlexSymmetrize(dm));
23725c344501SMatthew G. Knepley     PetscCall(DMPlexStratify(dm));
23735c344501SMatthew G. Knepley     PetscCall(PetscMalloc1(numVerts * embedDim, &coordsIn));
23745c344501SMatthew G. Knepley     for (PetscInt v = 0; v < numVerts; ++v) {
23755c344501SMatthew G. Knepley       const PetscReal rad = 2. * PETSC_PI * v / numVerts;
23765c344501SMatthew G. Knepley 
23775c344501SMatthew G. Knepley       coordsIn[v * embedDim + 0] = PetscCosReal(rad);
23785c344501SMatthew G. Knepley       coordsIn[v * embedDim + 1] = PetscSinReal(rad);
23795c344501SMatthew G. Knepley     }
23805c344501SMatthew G. Knepley     break;
238165a81367SMatthew G. Knepley   case 2:
238265a81367SMatthew G. Knepley     if (simplex) {
238351a74b61SMatthew G. Knepley       const PetscReal radius    = PetscSqrtReal(1 + PETSC_PHI * PETSC_PHI) / (1.0 + PETSC_PHI);
238451a74b61SMatthew G. Knepley       const PetscReal edgeLen   = 2.0 / (1.0 + PETSC_PHI) * (R / radius);
238565a81367SMatthew G. Knepley       const PetscInt  degree    = 5;
238651a74b61SMatthew G. Knepley       PetscReal       vertex[3] = {0.0, 1.0 / (1.0 + PETSC_PHI), PETSC_PHI / (1.0 + PETSC_PHI)};
238765a81367SMatthew G. Knepley       PetscInt        s[3]      = {1, 1, 1};
238865a81367SMatthew G. Knepley       PetscInt        cone[3];
238907c565c5SJose E. Roman       PetscInt       *graph;
239065a81367SMatthew G. Knepley 
23919371c9d4SSatish Balay       vertex[0] *= R / radius;
23929371c9d4SSatish Balay       vertex[1] *= R / radius;
23939371c9d4SSatish Balay       vertex[2] *= R / radius;
2394dd400576SPatrick Sanan       numCells    = rank == 0 ? 20 : 0;
2395dd400576SPatrick Sanan       numVerts    = rank == 0 ? 12 : 0;
239665a81367SMatthew G. Knepley       firstVertex = numCells;
239751a74b61SMatthew G. Knepley       /* Use icosahedron, which for a R-sphere has coordinates which are all cyclic permutations of
239865a81367SMatthew G. Knepley 
239965a81367SMatthew G. Knepley            (0, \pm 1/\phi+1, \pm \phi/\phi+1)
240065a81367SMatthew G. Knepley 
240165a81367SMatthew G. Knepley          where \phi^2 - \phi - 1 = 0, meaning \phi is the golden ratio \frac{1 + \sqrt{5}}{2}. The edge
240251a74b61SMatthew G. Knepley          length is then given by 2/(1+\phi) = 2 * 0.38197 = 0.76393.
240365a81367SMatthew G. Knepley       */
240465a81367SMatthew G. Knepley       /* Construct vertices */
24059566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2406dd400576SPatrick Sanan       if (rank == 0) {
240707c565c5SJose E. Roman         for (PetscInt p = 0, i = 0; p < embedDim; ++p) {
240865a81367SMatthew G. Knepley           for (s[1] = -1; s[1] < 2; s[1] += 2) {
240965a81367SMatthew G. Knepley             for (s[2] = -1; s[2] < 2; s[2] += 2) {
241065a81367SMatthew G. Knepley               for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[(d + p) % embedDim] * vertex[(d + p) % embedDim];
241165a81367SMatthew G. Knepley               ++i;
241265a81367SMatthew G. Knepley             }
241365a81367SMatthew G. Knepley           }
241465a81367SMatthew G. Knepley         }
241545da822fSValeria Barra       }
241665a81367SMatthew G. Knepley       /* Construct graph */
24179566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * numVerts, &graph));
241807c565c5SJose E. Roman       for (PetscInt i = 0; i < numVerts; ++i) {
241907c565c5SJose E. Roman         PetscInt k = 0;
242007c565c5SJose E. Roman         for (PetscInt j = 0; j < numVerts; ++j) {
24219371c9d4SSatish Balay           if (PetscAbsReal(DiffNormReal(embedDim, &coordsIn[i * embedDim], &coordsIn[j * embedDim]) - edgeLen) < PETSC_SMALL) {
24229371c9d4SSatish Balay             graph[i * numVerts + j] = 1;
24239371c9d4SSatish Balay             ++k;
24249371c9d4SSatish Balay           }
242565a81367SMatthew G. Knepley         }
242663a3b9bcSJacob Faibussowitsch         PetscCheck(k == degree, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid icosahedron, vertex %" PetscInt_FMT " degree %" PetscInt_FMT " != %" PetscInt_FMT, i, k, degree);
242765a81367SMatthew G. Knepley       }
242865a81367SMatthew G. Knepley       /* Build Topology */
24299566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
243007c565c5SJose E. Roman       for (PetscInt c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
24319566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
243265a81367SMatthew G. Knepley       /* Cells */
243307c565c5SJose E. Roman       for (PetscInt i = 0, c = 0; i < numVerts; ++i) {
243407c565c5SJose E. Roman         for (PetscInt j = 0; j < i; ++j) {
243507c565c5SJose E. Roman           for (PetscInt k = 0; k < j; ++k) {
243665a81367SMatthew G. Knepley             if (graph[i * numVerts + j] && graph[j * numVerts + k] && graph[k * numVerts + i]) {
24379371c9d4SSatish Balay               cone[0] = firstVertex + i;
24389371c9d4SSatish Balay               cone[1] = firstVertex + j;
24399371c9d4SSatish Balay               cone[2] = firstVertex + k;
244065a81367SMatthew G. Knepley               /* Check orientation */
244165a81367SMatthew G. Knepley               {
24429371c9d4SSatish Balay                 const PetscInt epsilon[3][3][3] = {
24439371c9d4SSatish Balay                   {{0, 0, 0},  {0, 0, 1},  {0, -1, 0}},
24449371c9d4SSatish Balay                   {{0, 0, -1}, {0, 0, 0},  {1, 0, 0} },
24459371c9d4SSatish Balay                   {{0, 1, 0},  {-1, 0, 0}, {0, 0, 0} }
24469371c9d4SSatish Balay                 };
244765a81367SMatthew G. Knepley                 PetscReal normal[3];
244865a81367SMatthew G. Knepley                 PetscInt  e, f;
244965a81367SMatthew G. Knepley 
245065a81367SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) {
245165a81367SMatthew G. Knepley                   normal[d] = 0.0;
245265a81367SMatthew G. Knepley                   for (e = 0; e < embedDim; ++e) {
2453ad540459SPierre Jolivet                     for (f = 0; f < embedDim; ++f) normal[d] += epsilon[d][e][f] * (coordsIn[j * embedDim + e] - coordsIn[i * embedDim + e]) * (coordsIn[k * embedDim + f] - coordsIn[i * embedDim + f]);
245465a81367SMatthew G. Knepley                   }
245565a81367SMatthew G. Knepley                 }
24569371c9d4SSatish Balay                 if (DotReal(embedDim, normal, &coordsIn[i * embedDim]) < 0) {
24579371c9d4SSatish Balay                   PetscInt tmp = cone[1];
24589371c9d4SSatish Balay                   cone[1]      = cone[2];
24599371c9d4SSatish Balay                   cone[2]      = tmp;
246065a81367SMatthew G. Knepley                 }
246165a81367SMatthew G. Knepley               }
24629566063dSJacob Faibussowitsch               PetscCall(DMPlexSetCone(dm, c++, cone));
246365a81367SMatthew G. Knepley             }
246465a81367SMatthew G. Knepley           }
246565a81367SMatthew G. Knepley         }
246665a81367SMatthew G. Knepley       }
24679566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
24689566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
24699566063dSJacob Faibussowitsch       PetscCall(PetscFree(graph));
247065a81367SMatthew G. Knepley     } else {
24712829fed8SMatthew G. Knepley       /*
24722829fed8SMatthew G. Knepley         12-21--13
24732829fed8SMatthew G. Knepley          |     |
24742829fed8SMatthew G. Knepley         25  4  24
24752829fed8SMatthew G. Knepley          |     |
24762829fed8SMatthew G. Knepley   12-25--9-16--8-24--13
24772829fed8SMatthew G. Knepley    |     |     |     |
24782829fed8SMatthew G. Knepley   23  5 17  0 15  3  22
24792829fed8SMatthew G. Knepley    |     |     |     |
24802829fed8SMatthew G. Knepley   10-20--6-14--7-19--11
24812829fed8SMatthew G. Knepley          |     |
24822829fed8SMatthew G. Knepley         20  1  19
24832829fed8SMatthew G. Knepley          |     |
24842829fed8SMatthew G. Knepley         10-18--11
24852829fed8SMatthew G. Knepley          |     |
24862829fed8SMatthew G. Knepley         23  2  22
24872829fed8SMatthew G. Knepley          |     |
24882829fed8SMatthew G. Knepley         12-21--13
24892829fed8SMatthew G. Knepley        */
24902829fed8SMatthew G. Knepley       PetscInt cone[4], ornt[4];
24912829fed8SMatthew G. Knepley 
2492dd400576SPatrick Sanan       numCells    = rank == 0 ? 6 : 0;
2493dd400576SPatrick Sanan       numEdges    = rank == 0 ? 12 : 0;
2494dd400576SPatrick Sanan       numVerts    = rank == 0 ? 8 : 0;
249565a81367SMatthew G. Knepley       firstVertex = numCells;
249665a81367SMatthew G. Knepley       firstEdge   = numCells + numVerts;
24972829fed8SMatthew G. Knepley       /* Build Topology */
24989566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numEdges + numVerts));
249907c565c5SJose E. Roman       for (PetscInt c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 4));
250048a46eb9SPierre Jolivet       for (e = firstEdge; e < firstEdge + numEdges; ++e) PetscCall(DMPlexSetConeSize(dm, e, 2));
25019566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
2502dd400576SPatrick Sanan       if (rank == 0) {
25032829fed8SMatthew G. Knepley         /* Cell 0 */
25049371c9d4SSatish Balay         cone[0] = 14;
25059371c9d4SSatish Balay         cone[1] = 15;
25069371c9d4SSatish Balay         cone[2] = 16;
25079371c9d4SSatish Balay         cone[3] = 17;
25089566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
25099371c9d4SSatish Balay         ornt[0] = 0;
25109371c9d4SSatish Balay         ornt[1] = 0;
25119371c9d4SSatish Balay         ornt[2] = 0;
25129371c9d4SSatish Balay         ornt[3] = 0;
25139566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 0, ornt));
25142829fed8SMatthew G. Knepley         /* Cell 1 */
25159371c9d4SSatish Balay         cone[0] = 18;
25169371c9d4SSatish Balay         cone[1] = 19;
25179371c9d4SSatish Balay         cone[2] = 14;
25189371c9d4SSatish Balay         cone[3] = 20;
25199566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
25209371c9d4SSatish Balay         ornt[0] = 0;
25219371c9d4SSatish Balay         ornt[1] = 0;
25229371c9d4SSatish Balay         ornt[2] = -1;
25239371c9d4SSatish Balay         ornt[3] = 0;
25249566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 1, ornt));
25252829fed8SMatthew G. Knepley         /* Cell 2 */
25269371c9d4SSatish Balay         cone[0] = 21;
25279371c9d4SSatish Balay         cone[1] = 22;
25289371c9d4SSatish Balay         cone[2] = 18;
25299371c9d4SSatish Balay         cone[3] = 23;
25309566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
25319371c9d4SSatish Balay         ornt[0] = 0;
25329371c9d4SSatish Balay         ornt[1] = 0;
25339371c9d4SSatish Balay         ornt[2] = -1;
25349371c9d4SSatish Balay         ornt[3] = 0;
25359566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 2, ornt));
25362829fed8SMatthew G. Knepley         /* Cell 3 */
25379371c9d4SSatish Balay         cone[0] = 19;
25389371c9d4SSatish Balay         cone[1] = 22;
25399371c9d4SSatish Balay         cone[2] = 24;
25409371c9d4SSatish Balay         cone[3] = 15;
25419566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
25429371c9d4SSatish Balay         ornt[0] = -1;
25439371c9d4SSatish Balay         ornt[1] = -1;
25449371c9d4SSatish Balay         ornt[2] = 0;
25459371c9d4SSatish Balay         ornt[3] = -1;
25469566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 3, ornt));
25472829fed8SMatthew G. Knepley         /* Cell 4 */
25489371c9d4SSatish Balay         cone[0] = 16;
25499371c9d4SSatish Balay         cone[1] = 24;
25509371c9d4SSatish Balay         cone[2] = 21;
25519371c9d4SSatish Balay         cone[3] = 25;
25529566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
25539371c9d4SSatish Balay         ornt[0] = -1;
25549371c9d4SSatish Balay         ornt[1] = -1;
25559371c9d4SSatish Balay         ornt[2] = -1;
25569371c9d4SSatish Balay         ornt[3] = 0;
25579566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 4, ornt));
25582829fed8SMatthew G. Knepley         /* Cell 5 */
25599371c9d4SSatish Balay         cone[0] = 20;
25609371c9d4SSatish Balay         cone[1] = 17;
25619371c9d4SSatish Balay         cone[2] = 25;
25629371c9d4SSatish Balay         cone[3] = 23;
25639566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 5, cone));
25649371c9d4SSatish Balay         ornt[0] = -1;
25659371c9d4SSatish Balay         ornt[1] = -1;
25669371c9d4SSatish Balay         ornt[2] = -1;
25679371c9d4SSatish Balay         ornt[3] = -1;
25689566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 5, ornt));
25692829fed8SMatthew G. Knepley         /* Edges */
25709371c9d4SSatish Balay         cone[0] = 6;
25719371c9d4SSatish Balay         cone[1] = 7;
25729566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 14, cone));
25739371c9d4SSatish Balay         cone[0] = 7;
25749371c9d4SSatish Balay         cone[1] = 8;
25759566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 15, cone));
25769371c9d4SSatish Balay         cone[0] = 8;
25779371c9d4SSatish Balay         cone[1] = 9;
25789566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 16, cone));
25799371c9d4SSatish Balay         cone[0] = 9;
25809371c9d4SSatish Balay         cone[1] = 6;
25819566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 17, cone));
25829371c9d4SSatish Balay         cone[0] = 10;
25839371c9d4SSatish Balay         cone[1] = 11;
25849566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 18, cone));
25859371c9d4SSatish Balay         cone[0] = 11;
25869371c9d4SSatish Balay         cone[1] = 7;
25879566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 19, cone));
25889371c9d4SSatish Balay         cone[0] = 6;
25899371c9d4SSatish Balay         cone[1] = 10;
25909566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 20, cone));
25919371c9d4SSatish Balay         cone[0] = 12;
25929371c9d4SSatish Balay         cone[1] = 13;
25939566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 21, cone));
25949371c9d4SSatish Balay         cone[0] = 13;
25959371c9d4SSatish Balay         cone[1] = 11;
25969566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 22, cone));
25979371c9d4SSatish Balay         cone[0] = 10;
25989371c9d4SSatish Balay         cone[1] = 12;
25999566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 23, cone));
26009371c9d4SSatish Balay         cone[0] = 13;
26019371c9d4SSatish Balay         cone[1] = 8;
26029566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 24, cone));
26039371c9d4SSatish Balay         cone[0] = 12;
26049371c9d4SSatish Balay         cone[1] = 9;
26059566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 25, cone));
260645da822fSValeria Barra       }
26079566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
26089566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
26092829fed8SMatthew G. Knepley       /* Build coordinates */
26109566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2611dd400576SPatrick Sanan       if (rank == 0) {
26129371c9d4SSatish Balay         coordsIn[0 * embedDim + 0] = -R;
26139371c9d4SSatish Balay         coordsIn[0 * embedDim + 1] = R;
26149371c9d4SSatish Balay         coordsIn[0 * embedDim + 2] = -R;
26159371c9d4SSatish Balay         coordsIn[1 * embedDim + 0] = R;
26169371c9d4SSatish Balay         coordsIn[1 * embedDim + 1] = R;
26179371c9d4SSatish Balay         coordsIn[1 * embedDim + 2] = -R;
26189371c9d4SSatish Balay         coordsIn[2 * embedDim + 0] = R;
26199371c9d4SSatish Balay         coordsIn[2 * embedDim + 1] = -R;
26209371c9d4SSatish Balay         coordsIn[2 * embedDim + 2] = -R;
26219371c9d4SSatish Balay         coordsIn[3 * embedDim + 0] = -R;
26229371c9d4SSatish Balay         coordsIn[3 * embedDim + 1] = -R;
26239371c9d4SSatish Balay         coordsIn[3 * embedDim + 2] = -R;
26249371c9d4SSatish Balay         coordsIn[4 * embedDim + 0] = -R;
26259371c9d4SSatish Balay         coordsIn[4 * embedDim + 1] = R;
26269371c9d4SSatish Balay         coordsIn[4 * embedDim + 2] = R;
26279371c9d4SSatish Balay         coordsIn[5 * embedDim + 0] = R;
26289371c9d4SSatish Balay         coordsIn[5 * embedDim + 1] = R;
26299371c9d4SSatish Balay         coordsIn[5 * embedDim + 2] = R;
26309371c9d4SSatish Balay         coordsIn[6 * embedDim + 0] = -R;
26319371c9d4SSatish Balay         coordsIn[6 * embedDim + 1] = -R;
26329371c9d4SSatish Balay         coordsIn[6 * embedDim + 2] = R;
26339371c9d4SSatish Balay         coordsIn[7 * embedDim + 0] = R;
26349371c9d4SSatish Balay         coordsIn[7 * embedDim + 1] = -R;
26359371c9d4SSatish Balay         coordsIn[7 * embedDim + 2] = R;
263665a81367SMatthew G. Knepley       }
263745da822fSValeria Barra     }
263865a81367SMatthew G. Knepley     break;
263965a81367SMatthew G. Knepley   case 3:
2640116ded15SMatthew G. Knepley     if (simplex) {
2641116ded15SMatthew G. Knepley       const PetscReal edgeLen         = 1.0 / PETSC_PHI;
264251a74b61SMatthew G. Knepley       PetscReal       vertexA[4]      = {0.5, 0.5, 0.5, 0.5};
264351a74b61SMatthew G. Knepley       PetscReal       vertexB[4]      = {1.0, 0.0, 0.0, 0.0};
264451a74b61SMatthew G. Knepley       PetscReal       vertexC[4]      = {0.5, 0.5 * PETSC_PHI, 0.5 / PETSC_PHI, 0.0};
2645116ded15SMatthew G. Knepley       const PetscInt  degree          = 12;
2646116ded15SMatthew G. Knepley       PetscInt        s[4]            = {1, 1, 1};
26479371c9d4SSatish Balay       PetscInt        evenPerm[12][4] = {
26489371c9d4SSatish Balay         {0, 1, 2, 3},
26499371c9d4SSatish Balay         {0, 2, 3, 1},
26509371c9d4SSatish Balay         {0, 3, 1, 2},
26519371c9d4SSatish Balay         {1, 0, 3, 2},
26529371c9d4SSatish Balay         {1, 2, 0, 3},
26539371c9d4SSatish Balay         {1, 3, 2, 0},
26549371c9d4SSatish Balay         {2, 0, 1, 3},
26559371c9d4SSatish Balay         {2, 1, 3, 0},
26569371c9d4SSatish Balay         {2, 3, 0, 1},
26579371c9d4SSatish Balay         {3, 0, 2, 1},
26589371c9d4SSatish Balay         {3, 1, 0, 2},
26599371c9d4SSatish Balay         {3, 2, 1, 0}
26609371c9d4SSatish Balay       };
2661116ded15SMatthew G. Knepley       PetscInt  cone[4];
2662116ded15SMatthew G. Knepley       PetscInt *graph, p, i, j, k, l;
2663116ded15SMatthew G. Knepley 
26649371c9d4SSatish Balay       vertexA[0] *= R;
26659371c9d4SSatish Balay       vertexA[1] *= R;
26669371c9d4SSatish Balay       vertexA[2] *= R;
26679371c9d4SSatish Balay       vertexA[3] *= R;
26689371c9d4SSatish Balay       vertexB[0] *= R;
26699371c9d4SSatish Balay       vertexB[1] *= R;
26709371c9d4SSatish Balay       vertexB[2] *= R;
26719371c9d4SSatish Balay       vertexB[3] *= R;
26729371c9d4SSatish Balay       vertexC[0] *= R;
26739371c9d4SSatish Balay       vertexC[1] *= R;
26749371c9d4SSatish Balay       vertexC[2] *= R;
26759371c9d4SSatish Balay       vertexC[3] *= R;
2676dd400576SPatrick Sanan       numCells    = rank == 0 ? 600 : 0;
2677dd400576SPatrick Sanan       numVerts    = rank == 0 ? 120 : 0;
2678116ded15SMatthew G. Knepley       firstVertex = numCells;
2679116ded15SMatthew G. Knepley       /* Use the 600-cell, which for a unit sphere has coordinates which are
2680116ded15SMatthew G. Knepley 
2681116ded15SMatthew G. Knepley            1/2 (\pm 1, \pm 1,    \pm 1, \pm 1)                          16
2682116ded15SMatthew G. Knepley                (\pm 1,    0,       0,      0)  all cyclic permutations   8
2683116ded15SMatthew G. Knepley            1/2 (\pm 1, \pm phi, \pm 1/phi, 0)  all even permutations    96
2684116ded15SMatthew G. Knepley 
2685116ded15SMatthew G. Knepley          where \phi^2 - \phi - 1 = 0, meaning \phi is the golden ratio \frac{1 + \sqrt{5}}{2}. The edge
26866333ae4fSvaleriabarra          length is then given by 1/\phi = 0.61803.
2687116ded15SMatthew G. Knepley 
2688116ded15SMatthew G. Knepley          http://buzzard.pugetsound.edu/sage-practice/ch03s03.html
2689116ded15SMatthew G. Knepley          http://mathworld.wolfram.com/600-Cell.html
2690116ded15SMatthew G. Knepley       */
2691116ded15SMatthew G. Knepley       /* Construct vertices */
26929566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2693116ded15SMatthew G. Knepley       i = 0;
2694dd400576SPatrick Sanan       if (rank == 0) {
2695116ded15SMatthew G. Knepley         for (s[0] = -1; s[0] < 2; s[0] += 2) {
2696116ded15SMatthew G. Knepley           for (s[1] = -1; s[1] < 2; s[1] += 2) {
2697116ded15SMatthew G. Knepley             for (s[2] = -1; s[2] < 2; s[2] += 2) {
2698116ded15SMatthew G. Knepley               for (s[3] = -1; s[3] < 2; s[3] += 2) {
2699116ded15SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[d] * vertexA[d];
2700116ded15SMatthew G. Knepley                 ++i;
2701116ded15SMatthew G. Knepley               }
2702116ded15SMatthew G. Knepley             }
2703116ded15SMatthew G. Knepley           }
2704116ded15SMatthew G. Knepley         }
2705116ded15SMatthew G. Knepley         for (p = 0; p < embedDim; ++p) {
2706116ded15SMatthew G. Knepley           s[1] = s[2] = s[3] = 1;
2707116ded15SMatthew G. Knepley           for (s[0] = -1; s[0] < 2; s[0] += 2) {
2708116ded15SMatthew G. Knepley             for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[(d + p) % embedDim] * vertexB[(d + p) % embedDim];
2709116ded15SMatthew G. Knepley             ++i;
2710116ded15SMatthew G. Knepley           }
2711116ded15SMatthew G. Knepley         }
2712116ded15SMatthew G. Knepley         for (p = 0; p < 12; ++p) {
2713116ded15SMatthew G. Knepley           s[3] = 1;
2714116ded15SMatthew G. Knepley           for (s[0] = -1; s[0] < 2; s[0] += 2) {
2715116ded15SMatthew G. Knepley             for (s[1] = -1; s[1] < 2; s[1] += 2) {
2716116ded15SMatthew G. Knepley               for (s[2] = -1; s[2] < 2; s[2] += 2) {
2717116ded15SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[evenPerm[p][d]] * vertexC[evenPerm[p][d]];
2718116ded15SMatthew G. Knepley                 ++i;
2719116ded15SMatthew G. Knepley               }
2720116ded15SMatthew G. Knepley             }
2721116ded15SMatthew G. Knepley           }
2722116ded15SMatthew G. Knepley         }
272345da822fSValeria Barra       }
272463a3b9bcSJacob Faibussowitsch       PetscCheck(i == numVerts, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid 600-cell, vertices %" PetscInt_FMT " != %" PetscInt_FMT, i, numVerts);
2725116ded15SMatthew G. Knepley       /* Construct graph */
27269566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * numVerts, &graph));
2727116ded15SMatthew G. Knepley       for (i = 0; i < numVerts; ++i) {
2728116ded15SMatthew G. Knepley         for (j = 0, k = 0; j < numVerts; ++j) {
27299371c9d4SSatish Balay           if (PetscAbsReal(DiffNormReal(embedDim, &coordsIn[i * embedDim], &coordsIn[j * embedDim]) - edgeLen) < PETSC_SMALL) {
27309371c9d4SSatish Balay             graph[i * numVerts + j] = 1;
27319371c9d4SSatish Balay             ++k;
27329371c9d4SSatish Balay           }
2733116ded15SMatthew G. Knepley         }
273463a3b9bcSJacob Faibussowitsch         PetscCheck(k == degree, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid 600-cell, vertex %" PetscInt_FMT " degree %" PetscInt_FMT " != %" PetscInt_FMT, i, k, degree);
2735116ded15SMatthew G. Knepley       }
2736116ded15SMatthew G. Knepley       /* Build Topology */
27379566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
273807c565c5SJose E. Roman       for (PetscInt c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
27399566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
2740116ded15SMatthew G. Knepley       /* Cells */
2741dd400576SPatrick Sanan       if (rank == 0) {
274207c565c5SJose E. Roman         for (PetscInt i = 0, c = 0; i < numVerts; ++i) {
2743116ded15SMatthew G. Knepley           for (j = 0; j < i; ++j) {
2744116ded15SMatthew G. Knepley             for (k = 0; k < j; ++k) {
2745116ded15SMatthew G. Knepley               for (l = 0; l < k; ++l) {
27469371c9d4SSatish Balay                 if (graph[i * numVerts + j] && graph[j * numVerts + k] && graph[k * numVerts + i] && graph[l * numVerts + i] && graph[l * numVerts + j] && graph[l * numVerts + k]) {
27479371c9d4SSatish Balay                   cone[0] = firstVertex + i;
27489371c9d4SSatish Balay                   cone[1] = firstVertex + j;
27499371c9d4SSatish Balay                   cone[2] = firstVertex + k;
27509371c9d4SSatish Balay                   cone[3] = firstVertex + l;
2751116ded15SMatthew G. Knepley                   /* Check orientation: https://ef.gy/linear-algebra:normal-vectors-in-higher-dimensional-spaces */
2752116ded15SMatthew G. Knepley                   {
27539371c9d4SSatish Balay                     const PetscInt epsilon[4][4][4][4] = {
27549371c9d4SSatish Balay                       {{{0, 0, 0, 0}, {0, 0, 0, 0}, {0, 0, 0, 0}, {0, 0, 0, 0}},  {{0, 0, 0, 0}, {0, 0, 0, 0}, {0, 0, 0, 1}, {0, 0, -1, 0}}, {{0, 0, 0, 0}, {0, 0, 0, -1}, {0, 0, 0, 0}, {0, 1, 0, 0}}, {{0, 0, 0, 0}, {0, 0, 1, 0}, {0, -1, 0, 0}, {0, 0, 0, 0}}},
2755116ded15SMatthew G. Knepley 
27569371c9d4SSatish Balay                       {{{0, 0, 0, 0}, {0, 0, 0, 0}, {0, 0, 0, -1}, {0, 0, 1, 0}}, {{0, 0, 0, 0}, {0, 0, 0, 0}, {0, 0, 0, 0}, {0, 0, 0, 0}},  {{0, 0, 0, 1}, {0, 0, 0, 0}, {0, 0, 0, 0}, {-1, 0, 0, 0}}, {{0, 0, -1, 0}, {0, 0, 0, 0}, {1, 0, 0, 0}, {0, 0, 0, 0}}},
2757116ded15SMatthew G. Knepley 
27589371c9d4SSatish Balay                       {{{0, 0, 0, 0}, {0, 0, 0, 1}, {0, 0, 0, 0}, {0, -1, 0, 0}}, {{0, 0, 0, -1}, {0, 0, 0, 0}, {0, 0, 0, 0}, {1, 0, 0, 0}}, {{0, 0, 0, 0}, {0, 0, 0, 0}, {0, 0, 0, 0}, {0, 0, 0, 0}},  {{0, 1, 0, 0}, {-1, 0, 0, 0}, {0, 0, 0, 0}, {0, 0, 0, 0}}},
2759116ded15SMatthew G. Knepley 
27609371c9d4SSatish Balay                       {{{0, 0, 0, 0}, {0, 0, -1, 0}, {0, 1, 0, 0}, {0, 0, 0, 0}}, {{0, 0, 1, 0}, {0, 0, 0, 0}, {-1, 0, 0, 0}, {0, 0, 0, 0}}, {{0, -1, 0, 0}, {1, 0, 0, 0}, {0, 0, 0, 0}, {0, 0, 0, 0}}, {{0, 0, 0, 0}, {0, 0, 0, 0}, {0, 0, 0, 0}, {0, 0, 0, 0}} }
27619371c9d4SSatish Balay                     };
2762116ded15SMatthew G. Knepley                     PetscReal normal[4];
2763116ded15SMatthew G. Knepley                     PetscInt  e, f, g;
2764116ded15SMatthew G. Knepley 
2765116ded15SMatthew G. Knepley                     for (d = 0; d < embedDim; ++d) {
2766116ded15SMatthew G. Knepley                       normal[d] = 0.0;
2767116ded15SMatthew G. Knepley                       for (e = 0; e < embedDim; ++e) {
2768116ded15SMatthew G. Knepley                         for (f = 0; f < embedDim; ++f) {
2769116ded15SMatthew G. Knepley                           for (g = 0; g < embedDim; ++g) {
2770116ded15SMatthew G. Knepley                             normal[d] += epsilon[d][e][f][g] * (coordsIn[j * embedDim + e] - coordsIn[i * embedDim + e]) * (coordsIn[k * embedDim + f] - coordsIn[i * embedDim + f]) * (coordsIn[l * embedDim + f] - coordsIn[i * embedDim + f]);
2771116ded15SMatthew G. Knepley                           }
2772116ded15SMatthew G. Knepley                         }
2773116ded15SMatthew G. Knepley                       }
2774116ded15SMatthew G. Knepley                     }
27759371c9d4SSatish Balay                     if (DotReal(embedDim, normal, &coordsIn[i * embedDim]) < 0) {
27769371c9d4SSatish Balay                       PetscInt tmp = cone[1];
27779371c9d4SSatish Balay                       cone[1]      = cone[2];
27789371c9d4SSatish Balay                       cone[2]      = tmp;
27799371c9d4SSatish Balay                     }
2780116ded15SMatthew G. Knepley                   }
27819566063dSJacob Faibussowitsch                   PetscCall(DMPlexSetCone(dm, c++, cone));
2782116ded15SMatthew G. Knepley                 }
2783116ded15SMatthew G. Knepley               }
2784116ded15SMatthew G. Knepley             }
2785116ded15SMatthew G. Knepley           }
2786116ded15SMatthew G. Knepley         }
278745da822fSValeria Barra       }
27889566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
27899566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
27909566063dSJacob Faibussowitsch       PetscCall(PetscFree(graph));
2791116ded15SMatthew G. Knepley     }
2792f4d061e9SPierre Jolivet     break;
2793d71ae5a4SJacob Faibussowitsch   default:
2794d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Unsupported dimension for sphere: %" PetscInt_FMT, dim);
279565a81367SMatthew G. Knepley   }
279665a81367SMatthew G. Knepley   /* Create coordinates */
27979566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
27989566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
27999566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, embedDim));
28009566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numVerts));
28012829fed8SMatthew G. Knepley   for (v = firstVertex; v < firstVertex + numVerts; ++v) {
28029566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, embedDim));
28039566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, embedDim));
28042829fed8SMatthew G. Knepley   }
28059566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
28069566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
28079566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
28089566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, embedDim));
28099566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
28109566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
28119566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
28129566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
28139371c9d4SSatish Balay   for (v = 0; v < numVerts; ++v)
2814ad540459SPierre Jolivet     for (d = 0; d < embedDim; ++d) coords[v * embedDim + d] = coordsIn[v * embedDim + d];
28159566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
28169566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
28179566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
28189566063dSJacob Faibussowitsch   PetscCall(PetscFree(coordsIn));
281951a74b61SMatthew G. Knepley   {
282051a74b61SMatthew G. Knepley     DM          cdm;
282151a74b61SMatthew G. Knepley     PetscDS     cds;
28229318fe57SMatthew G. Knepley     PetscScalar c = R;
282351a74b61SMatthew G. Knepley 
2824e44f6aebSMatthew G. Knepley     PetscCall(DMPlexCreateCoordinateSpace(dm, 1, PETSC_TRUE, snapToSphere));
28259566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
28269566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
28279566063dSJacob Faibussowitsch     PetscCall(PetscDSSetConstants(cds, 1, &c));
282851a74b61SMatthew G. Knepley   }
282946139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
28309318fe57SMatthew G. Knepley   /* Wait for coordinate creation before doing in-place modification */
28319566063dSJacob Faibussowitsch   if (simplex) PetscCall(DMPlexInterpolateInPlace_Internal(dm));
28323ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
28339318fe57SMatthew G. Knepley }
28349318fe57SMatthew G. Knepley 
2835b7f5c055SJed Brown typedef void (*TPSEvaluateFunc)(const PetscReal[], PetscReal *, PetscReal[], PetscReal (*)[3]);
2836b7f5c055SJed Brown 
2837b7f5c055SJed Brown /*
2838b7f5c055SJed Brown  The Schwarz P implicit surface is
2839b7f5c055SJed Brown 
2840b7f5c055SJed Brown      f(x) = cos(x0) + cos(x1) + cos(x2) = 0
2841b7f5c055SJed Brown */
2842d71ae5a4SJacob Faibussowitsch static void TPSEvaluate_SchwarzP(const PetscReal y[3], PetscReal *f, PetscReal grad[], PetscReal (*hess)[3])
2843d71ae5a4SJacob Faibussowitsch {
2844b7f5c055SJed Brown   PetscReal c[3] = {PetscCosReal(y[0] * PETSC_PI), PetscCosReal(y[1] * PETSC_PI), PetscCosReal(y[2] * PETSC_PI)};
2845b7f5c055SJed Brown   PetscReal g[3] = {-PetscSinReal(y[0] * PETSC_PI), -PetscSinReal(y[1] * PETSC_PI), -PetscSinReal(y[2] * PETSC_PI)};
2846b7f5c055SJed Brown   f[0]           = c[0] + c[1] + c[2];
2847b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) {
2848b7f5c055SJed Brown     grad[i] = PETSC_PI * g[i];
2849ad540459SPierre Jolivet     for (PetscInt j = 0; j < 3; j++) hess[i][j] = (i == j) ? -PetscSqr(PETSC_PI) * c[i] : 0.;
2850b7f5c055SJed Brown   }
2851b7f5c055SJed Brown }
2852b7f5c055SJed Brown 
28534663dae6SJed Brown // u[] is a tentative normal on input. Replace with the implicit function gradient in the same direction
2854d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSExtrudeNormalFunc_SchwarzP(PetscInt dim, PetscReal time, const PetscReal x[], PetscInt r, PetscScalar u[], void *ctx)
2855d71ae5a4SJacob Faibussowitsch {
2856ad540459SPierre Jolivet   for (PetscInt i = 0; i < 3; i++) u[i] = -PETSC_PI * PetscSinReal(x[i] * PETSC_PI);
28573ba16761SJacob Faibussowitsch   return PETSC_SUCCESS;
28584663dae6SJed Brown }
28594663dae6SJed Brown 
2860b7f5c055SJed Brown /*
2861b7f5c055SJed Brown  The Gyroid implicit surface is
2862b7f5c055SJed Brown 
2863b7f5c055SJed Brown  f(x,y,z) = sin(pi * x) * cos (pi * (y + 1/2))  + sin(pi * (y + 1/2)) * cos(pi * (z + 1/4)) + sin(pi * (z + 1/4)) * cos(pi * x)
2864b7f5c055SJed Brown 
2865b7f5c055SJed Brown */
2866d71ae5a4SJacob Faibussowitsch static void TPSEvaluate_Gyroid(const PetscReal y[3], PetscReal *f, PetscReal grad[], PetscReal (*hess)[3])
2867d71ae5a4SJacob Faibussowitsch {
2868b7f5c055SJed Brown   PetscReal s[3] = {PetscSinReal(PETSC_PI * y[0]), PetscSinReal(PETSC_PI * (y[1] + .5)), PetscSinReal(PETSC_PI * (y[2] + .25))};
2869b7f5c055SJed Brown   PetscReal c[3] = {PetscCosReal(PETSC_PI * y[0]), PetscCosReal(PETSC_PI * (y[1] + .5)), PetscCosReal(PETSC_PI * (y[2] + .25))};
2870b7f5c055SJed Brown   f[0]           = s[0] * c[1] + s[1] * c[2] + s[2] * c[0];
2871b7f5c055SJed Brown   grad[0]        = PETSC_PI * (c[0] * c[1] - s[2] * s[0]);
2872b7f5c055SJed Brown   grad[1]        = PETSC_PI * (c[1] * c[2] - s[0] * s[1]);
2873b7f5c055SJed Brown   grad[2]        = PETSC_PI * (c[2] * c[0] - s[1] * s[2]);
2874b7f5c055SJed Brown   hess[0][0]     = -PetscSqr(PETSC_PI) * (s[0] * c[1] + s[2] * c[0]);
2875b7f5c055SJed Brown   hess[0][1]     = -PetscSqr(PETSC_PI) * (c[0] * s[1]);
2876b7f5c055SJed Brown   hess[0][2]     = -PetscSqr(PETSC_PI) * (c[2] * s[0]);
2877b7f5c055SJed Brown   hess[1][0]     = -PetscSqr(PETSC_PI) * (s[1] * c[2] + s[0] * c[1]);
2878b7f5c055SJed Brown   hess[1][1]     = -PetscSqr(PETSC_PI) * (c[1] * s[2]);
2879b7f5c055SJed Brown   hess[2][2]     = -PetscSqr(PETSC_PI) * (c[0] * s[1]);
2880b7f5c055SJed Brown   hess[2][0]     = -PetscSqr(PETSC_PI) * (s[2] * c[0] + s[1] * c[2]);
2881b7f5c055SJed Brown   hess[2][1]     = -PetscSqr(PETSC_PI) * (c[2] * s[0]);
2882b7f5c055SJed Brown   hess[2][2]     = -PetscSqr(PETSC_PI) * (c[1] * s[2]);
2883b7f5c055SJed Brown }
2884b7f5c055SJed Brown 
28854663dae6SJed Brown // u[] is a tentative normal on input. Replace with the implicit function gradient in the same direction
2886d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSExtrudeNormalFunc_Gyroid(PetscInt dim, PetscReal time, const PetscReal x[], PetscInt r, PetscScalar u[], void *ctx)
2887d71ae5a4SJacob Faibussowitsch {
28884663dae6SJed Brown   PetscReal s[3] = {PetscSinReal(PETSC_PI * x[0]), PetscSinReal(PETSC_PI * (x[1] + .5)), PetscSinReal(PETSC_PI * (x[2] + .25))};
28894663dae6SJed Brown   PetscReal c[3] = {PetscCosReal(PETSC_PI * x[0]), PetscCosReal(PETSC_PI * (x[1] + .5)), PetscCosReal(PETSC_PI * (x[2] + .25))};
28904663dae6SJed Brown   u[0]           = PETSC_PI * (c[0] * c[1] - s[2] * s[0]);
28914663dae6SJed Brown   u[1]           = PETSC_PI * (c[1] * c[2] - s[0] * s[1]);
28924663dae6SJed Brown   u[2]           = PETSC_PI * (c[2] * c[0] - s[1] * s[2]);
28933ba16761SJacob Faibussowitsch   return PETSC_SUCCESS;
28944663dae6SJed Brown }
28954663dae6SJed Brown 
2896b7f5c055SJed Brown /*
2897b7f5c055SJed Brown    We wish to solve
2898b7f5c055SJed Brown 
2899b7f5c055SJed Brown          min_y || y - x ||^2  subject to f(y) = 0
2900b7f5c055SJed Brown 
2901b7f5c055SJed Brown    Let g(y) = grad(f).  The minimization problem is equivalent to asking to satisfy
2902b7f5c055SJed Brown    f(y) = 0 and (y-x) is parallel to g(y).  We do this by using Householder QR to obtain a basis for the
2903b7f5c055SJed Brown    tangent space and ask for both components in the tangent space to be zero.
2904b7f5c055SJed Brown 
2905b7f5c055SJed Brown    Take g to be a column vector and compute the "full QR" factorization Q R = g,
2906b7f5c055SJed Brown    where Q = I - 2 n n^T is a symmetric orthogonal matrix.
2907b7f5c055SJed Brown    The first column of Q is parallel to g so the remaining two columns span the null space.
2908b7f5c055SJed Brown    Let Qn = Q[:,1:] be those remaining columns.  Then Qn Qn^T is an orthogonal projector into the tangent space.
2909da81f932SPierre Jolivet    Since Q is symmetric, this is equivalent to multiplying by Q and taking the last two entries.
2910b7f5c055SJed Brown    In total, we have a system of 3 equations in 3 unknowns:
2911b7f5c055SJed Brown 
2912b7f5c055SJed Brown      f(y) = 0                       1 equation
2913b7f5c055SJed Brown      Qn^T (y - x) = 0               2 equations
2914b7f5c055SJed Brown 
2915b7f5c055SJed Brown    Here, we compute the residual and Jacobian of this system.
2916b7f5c055SJed Brown */
2917d71ae5a4SJacob Faibussowitsch static void TPSNearestPointResJac(TPSEvaluateFunc feval, const PetscScalar x[], const PetscScalar y[], PetscScalar res[], PetscScalar J[])
2918d71ae5a4SJacob Faibussowitsch {
2919b7f5c055SJed Brown   PetscReal yreal[3] = {PetscRealPart(y[0]), PetscRealPart(y[1]), PetscRealPart(y[2])};
2920b7f5c055SJed Brown   PetscReal d[3]     = {PetscRealPart(y[0] - x[0]), PetscRealPart(y[1] - x[1]), PetscRealPart(y[2] - x[2])};
29212f0490c0SSatish Balay   PetscReal f, grad[3], n[3], norm, norm_y[3], nd, nd_y[3], sign;
29229371c9d4SSatish Balay   PetscReal n_y[3][3] = {
29239371c9d4SSatish Balay     {0, 0, 0},
29249371c9d4SSatish Balay     {0, 0, 0},
29259371c9d4SSatish Balay     {0, 0, 0}
29269371c9d4SSatish Balay   };
2927b7f5c055SJed Brown 
2928b7f5c055SJed Brown   feval(yreal, &f, grad, n_y);
2929b7f5c055SJed Brown 
2930b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) n[i] = grad[i];
2931b7f5c055SJed Brown   norm = PetscSqrtReal(PetscSqr(n[0]) + PetscSqr(n[1]) + PetscSqr(n[2]));
2932ad540459SPierre Jolivet   for (PetscInt i = 0; i < 3; i++) norm_y[i] = 1. / norm * n[i] * n_y[i][i];
2933b7f5c055SJed Brown 
2934b7f5c055SJed Brown   // Define the Householder reflector
2935b7f5c055SJed Brown   sign = n[0] >= 0 ? 1. : -1.;
2936b7f5c055SJed Brown   n[0] += norm * sign;
2937b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) n_y[0][i] += norm_y[i] * sign;
2938b7f5c055SJed Brown 
2939b7f5c055SJed Brown   norm      = PetscSqrtReal(PetscSqr(n[0]) + PetscSqr(n[1]) + PetscSqr(n[2]));
2940b7f5c055SJed Brown   norm_y[0] = 1. / norm * (n[0] * n_y[0][0]);
2941b7f5c055SJed Brown   norm_y[1] = 1. / norm * (n[0] * n_y[0][1] + n[1] * n_y[1][1]);
2942b7f5c055SJed Brown   norm_y[2] = 1. / norm * (n[0] * n_y[0][2] + n[2] * n_y[2][2]);
2943b7f5c055SJed Brown 
2944b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) {
2945b7f5c055SJed Brown     n[i] /= norm;
2946b7f5c055SJed Brown     for (PetscInt j = 0; j < 3; j++) {
2947b7f5c055SJed Brown       // note that n[i] is n_old[i]/norm when executing the code below
2948b7f5c055SJed Brown       n_y[i][j] = n_y[i][j] / norm - n[i] / norm * norm_y[j];
2949b7f5c055SJed Brown     }
2950b7f5c055SJed Brown   }
2951b7f5c055SJed Brown 
2952b7f5c055SJed Brown   nd = n[0] * d[0] + n[1] * d[1] + n[2] * d[2];
2953b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) nd_y[i] = n[i] + n_y[0][i] * d[0] + n_y[1][i] * d[1] + n_y[2][i] * d[2];
2954b7f5c055SJed Brown 
2955b7f5c055SJed Brown   res[0] = f;
2956b7f5c055SJed Brown   res[1] = d[1] - 2 * n[1] * nd;
2957b7f5c055SJed Brown   res[2] = d[2] - 2 * n[2] * nd;
2958b7f5c055SJed Brown   // J[j][i] is J_{ij} (column major)
2959b7f5c055SJed Brown   for (PetscInt j = 0; j < 3; j++) {
2960b7f5c055SJed Brown     J[0 + j * 3] = grad[j];
2961b7f5c055SJed Brown     J[1 + j * 3] = (j == 1) * 1. - 2 * (n_y[1][j] * nd + n[1] * nd_y[j]);
2962b7f5c055SJed Brown     J[2 + j * 3] = (j == 2) * 1. - 2 * (n_y[2][j] * nd + n[2] * nd_y[j]);
2963b7f5c055SJed Brown   }
2964b7f5c055SJed Brown }
2965b7f5c055SJed Brown 
2966b7f5c055SJed Brown /*
2967b7f5c055SJed Brown    Project x to the nearest point on the implicit surface using Newton's method.
2968b7f5c055SJed Brown */
2969d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSNearestPoint(TPSEvaluateFunc feval, PetscScalar x[])
2970d71ae5a4SJacob Faibussowitsch {
2971b7f5c055SJed Brown   PetscScalar y[3] = {x[0], x[1], x[2]}; // Initial guess
2972b7f5c055SJed Brown 
2973b7f5c055SJed Brown   PetscFunctionBegin;
2974b7f5c055SJed Brown   for (PetscInt iter = 0; iter < 10; iter++) {
2975b7f5c055SJed Brown     PetscScalar res[3], J[9];
2976b7f5c055SJed Brown     PetscReal   resnorm;
2977b7f5c055SJed Brown     TPSNearestPointResJac(feval, x, y, res, J);
2978b7f5c055SJed Brown     resnorm = PetscSqrtReal(PetscSqr(PetscRealPart(res[0])) + PetscSqr(PetscRealPart(res[1])) + PetscSqr(PetscRealPart(res[2])));
2979b7f5c055SJed Brown     if (0) { // Turn on this monitor if you need to confirm quadratic convergence
298063a3b9bcSJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "[%" PetscInt_FMT "] res [%g %g %g]\n", iter, (double)PetscRealPart(res[0]), (double)PetscRealPart(res[1]), (double)PetscRealPart(res[2])));
2981b7f5c055SJed Brown     }
2982b7f5c055SJed Brown     if (resnorm < PETSC_SMALL) break;
2983b7f5c055SJed Brown 
2984b7f5c055SJed Brown     // Take the Newton step
29859566063dSJacob Faibussowitsch     PetscCall(PetscKernel_A_gets_inverse_A_3(J, 0., PETSC_FALSE, NULL));
2986b7f5c055SJed Brown     PetscKernel_v_gets_v_minus_A_times_w_3(y, J, res);
2987b7f5c055SJed Brown   }
2988b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) x[i] = y[i];
29893ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2990b7f5c055SJed Brown }
2991b7f5c055SJed Brown 
2992b7f5c055SJed Brown const char *const DMPlexTPSTypes[] = {"SCHWARZ_P", "GYROID", "DMPlexTPSType", "DMPLEX_TPS_", NULL};
2993b7f5c055SJed Brown 
2994d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateTPSMesh_Internal(DM dm, DMPlexTPSType tpstype, const PetscInt extent[], const DMBoundaryType periodic[], PetscBool tps_distribute, PetscInt refinements, PetscInt layers, PetscReal thickness)
2995d71ae5a4SJacob Faibussowitsch {
2996b7f5c055SJed Brown   PetscMPIInt rank;
2997b7f5c055SJed Brown   PetscInt    topoDim = 2, spaceDim = 3, numFaces = 0, numVertices = 0, numEdges = 0;
2998b7f5c055SJed Brown   PetscInt(*edges)[2] = NULL, *edgeSets = NULL;
2999b7f5c055SJed Brown   PetscInt            *cells_flat = NULL;
3000b7f5c055SJed Brown   PetscReal           *vtxCoords  = NULL;
3001b7f5c055SJed Brown   TPSEvaluateFunc      evalFunc   = NULL;
30024663dae6SJed Brown   PetscSimplePointFunc normalFunc = NULL;
3003b7f5c055SJed Brown   DMLabel              label;
3004b7f5c055SJed Brown 
3005b7f5c055SJed Brown   PetscFunctionBegin;
300646139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
30079566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
300863a3b9bcSJacob Faibussowitsch   PetscCheck((layers != 0) ^ (thickness == 0.), PetscObjectComm((PetscObject)dm), PETSC_ERR_ARG_INCOMP, "Layers %" PetscInt_FMT " must be nonzero iff thickness %g is nonzero", layers, (double)thickness);
3009b7f5c055SJed Brown   switch (tpstype) {
3010b7f5c055SJed Brown   case DMPLEX_TPS_SCHWARZ_P:
3011b7f5c055SJed Brown     PetscCheck(!periodic || (periodic[0] == DM_BOUNDARY_NONE && periodic[1] == DM_BOUNDARY_NONE && periodic[2] == DM_BOUNDARY_NONE), PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Schwarz P does not support periodic meshes");
3012c5853193SPierre Jolivet     if (rank == 0) {
3013b7f5c055SJed Brown       PetscInt(*cells)[6][4][4] = NULL; // [junction, junction-face, cell, conn]
3014b7f5c055SJed Brown       PetscInt  Njunctions = 0, Ncuts = 0, Npipes[3], vcount;
3015b7f5c055SJed Brown       PetscReal L = 1;
3016b7f5c055SJed Brown 
3017b7f5c055SJed Brown       Npipes[0]   = (extent[0] + 1) * extent[1] * extent[2];
3018b7f5c055SJed Brown       Npipes[1]   = extent[0] * (extent[1] + 1) * extent[2];
3019b7f5c055SJed Brown       Npipes[2]   = extent[0] * extent[1] * (extent[2] + 1);
3020b7f5c055SJed Brown       Njunctions  = extent[0] * extent[1] * extent[2];
3021b7f5c055SJed Brown       Ncuts       = 2 * (extent[0] * extent[1] + extent[1] * extent[2] + extent[2] * extent[0]);
3022b7f5c055SJed Brown       numVertices = 4 * (Npipes[0] + Npipes[1] + Npipes[2]) + 8 * Njunctions;
30239566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(3 * numVertices, &vtxCoords));
30249566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Njunctions, &cells));
30259566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Ncuts * 4, &edges));
30269566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Ncuts * 4, &edgeSets));
3027b7f5c055SJed Brown       // x-normal pipes
3028b7f5c055SJed Brown       vcount = 0;
3029b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0] + 1; i++) {
3030b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3031b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3032b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3033b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * i - 1) * L;
3034b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * j * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3035b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * k * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3036b7f5c055SJed Brown             }
3037b7f5c055SJed Brown           }
3038b7f5c055SJed Brown         }
3039b7f5c055SJed Brown       }
3040b7f5c055SJed Brown       // y-normal pipes
3041b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3042b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1] + 1; j++) {
3043b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3044b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3045b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * i * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3046b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * j - 1) * L;
3047b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * k * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3048b7f5c055SJed Brown             }
3049b7f5c055SJed Brown           }
3050b7f5c055SJed Brown         }
3051b7f5c055SJed Brown       }
3052b7f5c055SJed Brown       // z-normal pipes
3053b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3054b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3055b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2] + 1; k++) {
3056b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3057b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * i * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3058b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * j * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3059b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * k - 1) * L;
3060b7f5c055SJed Brown             }
3061b7f5c055SJed Brown           }
3062b7f5c055SJed Brown         }
3063b7f5c055SJed Brown       }
3064b7f5c055SJed Brown       // junctions
3065b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3066b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3067b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3068b7f5c055SJed Brown             const PetscInt J = (i * extent[1] + j) * extent[2] + k, Jvoff = (Npipes[0] + Npipes[1] + Npipes[2]) * 4 + J * 8;
3069b7f5c055SJed Brown             PetscCheck(vcount / 3 == Jvoff, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Unexpected vertex count");
3070b7f5c055SJed Brown             for (PetscInt ii = 0; ii < 2; ii++) {
3071b7f5c055SJed Brown               for (PetscInt jj = 0; jj < 2; jj++) {
3072b7f5c055SJed Brown                 for (PetscInt kk = 0; kk < 2; kk++) {
3073b7f5c055SJed Brown                   double Ls           = (1 - sqrt(2) / 4) * L;
3074b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * i * L + (2 * ii - 1) * Ls;
3075b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * j * L + (2 * jj - 1) * Ls;
3076b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * k * L + (2 * kk - 1) * Ls;
3077b7f5c055SJed Brown                 }
3078b7f5c055SJed Brown               }
3079b7f5c055SJed Brown             }
3080b7f5c055SJed Brown             const PetscInt jfaces[3][2][4] = {
3081b7f5c055SJed Brown               {{3, 1, 0, 2}, {7, 5, 4, 6}}, // x-aligned
3082b7f5c055SJed Brown               {{5, 4, 0, 1}, {7, 6, 2, 3}}, // y-aligned
3083b7f5c055SJed Brown               {{6, 2, 0, 4}, {7, 3, 1, 5}}  // z-aligned
3084b7f5c055SJed Brown             };
3085b7f5c055SJed Brown             const PetscInt pipe_lo[3] = {// vertex numbers of pipes
30869371c9d4SSatish Balay                                          ((i * extent[1] + j) * extent[2] + k) * 4, ((i * (extent[1] + 1) + j) * extent[2] + k + Npipes[0]) * 4, ((i * extent[1] + j) * (extent[2] + 1) + k + Npipes[0] + Npipes[1]) * 4};
3087b7f5c055SJed Brown             const PetscInt pipe_hi[3] = {// vertex numbers of pipes
30889371c9d4SSatish Balay                                          (((i + 1) * extent[1] + j) * extent[2] + k) * 4, ((i * (extent[1] + 1) + j + 1) * extent[2] + k + Npipes[0]) * 4, ((i * extent[1] + j) * (extent[2] + 1) + k + 1 + Npipes[0] + Npipes[1]) * 4};
3089b7f5c055SJed Brown             for (PetscInt dir = 0; dir < 3; dir++) { // x,y,z
3090b7f5c055SJed Brown               const PetscInt ijk[3] = {i, j, k};
3091b7f5c055SJed Brown               for (PetscInt l = 0; l < 4; l++) { // rotations
3092b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][0] = pipe_lo[dir] + l;
3093b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][1] = Jvoff + jfaces[dir][0][l];
3094b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][2] = Jvoff + jfaces[dir][0][(l - 1 + 4) % 4];
3095b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][3] = pipe_lo[dir] + (l - 1 + 4) % 4;
3096b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][0] = Jvoff + jfaces[dir][1][l];
3097b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][1] = pipe_hi[dir] + l;
3098b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][2] = pipe_hi[dir] + (l - 1 + 4) % 4;
3099b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][3] = Jvoff + jfaces[dir][1][(l - 1 + 4) % 4];
3100b7f5c055SJed Brown                 if (ijk[dir] == 0) {
3101b7f5c055SJed Brown                   edges[numEdges][0] = pipe_lo[dir] + l;
3102b7f5c055SJed Brown                   edges[numEdges][1] = pipe_lo[dir] + (l + 1) % 4;
3103b7f5c055SJed Brown                   edgeSets[numEdges] = dir * 2 + 1;
3104b7f5c055SJed Brown                   numEdges++;
3105b7f5c055SJed Brown                 }
3106b7f5c055SJed Brown                 if (ijk[dir] + 1 == extent[dir]) {
3107b7f5c055SJed Brown                   edges[numEdges][0] = pipe_hi[dir] + l;
3108b7f5c055SJed Brown                   edges[numEdges][1] = pipe_hi[dir] + (l + 1) % 4;
3109b7f5c055SJed Brown                   edgeSets[numEdges] = dir * 2 + 2;
3110b7f5c055SJed Brown                   numEdges++;
3111b7f5c055SJed Brown                 }
3112b7f5c055SJed Brown               }
3113b7f5c055SJed Brown             }
3114b7f5c055SJed Brown           }
3115b7f5c055SJed Brown         }
3116b7f5c055SJed Brown       }
311763a3b9bcSJacob Faibussowitsch       PetscCheck(numEdges == Ncuts * 4, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Edge count %" PetscInt_FMT " incompatible with number of cuts %" PetscInt_FMT, numEdges, Ncuts);
3118b7f5c055SJed Brown       numFaces   = 24 * Njunctions;
3119b7f5c055SJed Brown       cells_flat = cells[0][0][0];
3120b7f5c055SJed Brown     }
3121b7f5c055SJed Brown     evalFunc   = TPSEvaluate_SchwarzP;
31224663dae6SJed Brown     normalFunc = TPSExtrudeNormalFunc_SchwarzP;
3123b7f5c055SJed Brown     break;
3124b7f5c055SJed Brown   case DMPLEX_TPS_GYROID:
3125c5853193SPierre Jolivet     if (rank == 0) {
3126b7f5c055SJed Brown       // This is a coarse mesh approximation of the gyroid shifted to being the zero of the level set
3127b7f5c055SJed Brown       //
3128b7f5c055SJed Brown       //     sin(pi*x)*cos(pi*(y+1/2)) + sin(pi*(y+1/2))*cos(pi*(z+1/4)) + sin(pi*(z+1/4))*cos(x)
3129b7f5c055SJed Brown       //
3130b7f5c055SJed Brown       // on the cell [0,2]^3.
3131b7f5c055SJed Brown       //
3132b7f5c055SJed Brown       // Think about dividing that cell into four columns, and focus on the column [0,1]x[0,1]x[0,2].
3133b7f5c055SJed Brown       // If you looked at the gyroid in that column at different slices of z you would see that it kind of spins
3134b7f5c055SJed Brown       // like a boomerang:
3135b7f5c055SJed Brown       //
3136b7f5c055SJed Brown       //     z = 0          z = 1/4        z = 1/2        z = 3/4     //
3137b7f5c055SJed Brown       //     -----          -------        -------        -------     //
3138b7f5c055SJed Brown       //                                                              //
3139b7f5c055SJed Brown       //     +       +      +       +      +       +      +   \   +   //
3140b7f5c055SJed Brown       //      \                                   /            \      //
3141b7f5c055SJed Brown       //       \            `-_   _-'            /              }     //
3142b7f5c055SJed Brown       //        *-_            `-'            _-'              /      //
3143b7f5c055SJed Brown       //     +     `-+      +       +      +-'     +      +   /   +   //
3144b7f5c055SJed Brown       //                                                              //
3145b7f5c055SJed Brown       //                                                              //
3146b7f5c055SJed Brown       //     z = 1          z = 5/4        z = 3/2        z = 7/4     //
3147b7f5c055SJed Brown       //     -----          -------        -------        -------     //
3148b7f5c055SJed Brown       //                                                              //
3149b7f5c055SJed Brown       //     +-_     +      +       +      +     _-+      +   /   +   //
3150b7f5c055SJed Brown       //        `-_            _-_            _-`            /        //
3151b7f5c055SJed Brown       //           \        _-'   `-_        /              {         //
3152b7f5c055SJed Brown       //            \                       /                \        //
3153b7f5c055SJed Brown       //     +       +      +       +      +       +      +   \   +   //
3154b7f5c055SJed Brown       //
3155b7f5c055SJed Brown       //
3156b7f5c055SJed Brown       // This course mesh approximates each of these slices by two line segments,
3157b7f5c055SJed Brown       // and then connects the segments in consecutive layers with quadrilateral faces.
3158b7f5c055SJed Brown       // All of the end points of the segments are multiples of 1/4 except for the
3159b7f5c055SJed Brown       // point * in the picture for z = 0 above and the similar points in other layers.
3160b7f5c055SJed Brown       // That point is at (gamma, gamma, 0), where gamma is calculated below.
3161b7f5c055SJed Brown       //
3162b7f5c055SJed Brown       // The column  [1,2]x[1,2]x[0,2] looks the same as this column;
3163b7f5c055SJed Brown       // The columns [1,2]x[0,1]x[0,2] and [0,1]x[1,2]x[0,2] are mirror images.
3164b7f5c055SJed Brown       //
3165b7f5c055SJed Brown       // As for how this method turned into the names given to the vertices:
3166b7f5c055SJed Brown       // that was not systematic, it was just the way it worked out in my handwritten notes.
3167b7f5c055SJed Brown 
3168b7f5c055SJed Brown       PetscInt facesPerBlock = 64;
3169b7f5c055SJed Brown       PetscInt vertsPerBlock = 56;
3170b7f5c055SJed Brown       PetscInt extentPlus[3];
3171b7f5c055SJed Brown       PetscInt numBlocks, numBlocksPlus;
31729371c9d4SSatish Balay       const PetscInt A = 0, B = 1, C = 2, D = 3, E = 4, F = 5, G = 6, H = 7, II = 8, J = 9, K = 10, L = 11, M = 12, N = 13, O = 14, P = 15, Q = 16, R = 17, S = 18, T = 19, U = 20, V = 21, W = 22, X = 23, Y = 24, Z = 25, Ap = 26, Bp = 27, Cp = 28, Dp = 29, Ep = 30, Fp = 31, Gp = 32, Hp = 33, Ip = 34, Jp = 35, Kp = 36, Lp = 37, Mp = 38, Np = 39, Op = 40, Pp = 41, Qp = 42, Rp = 43, Sp = 44, Tp = 45, Up = 46, Vp = 47, Wp = 48, Xp = 49, Yp = 50, Zp = 51, Aq = 52, Bq = 53, Cq = 54, Dq = 55;
31739371c9d4SSatish Balay       const PetscInt pattern[64][4] = {
31749371c9d4SSatish Balay   /* face to vertex within the coarse discretization of a single gyroid block */
3175b7f5c055SJed Brown   /* layer 0 */
31769371c9d4SSatish Balay         {A,           C,           K,           G          },
31779371c9d4SSatish Balay         {C,           B,           II,          K          },
31789371c9d4SSatish Balay         {D,           A,           H,           L          },
31799371c9d4SSatish Balay         {B + 56 * 1,  D,           L,           J          },
31809371c9d4SSatish Balay         {E,           B + 56 * 1,  J,           N          },
31819371c9d4SSatish Balay         {A + 56 * 2,  E,           N,           H + 56 * 2 },
31829371c9d4SSatish Balay         {F,           A + 56 * 2,  G + 56 * 2,  M          },
31839371c9d4SSatish Balay         {B,           F,           M,           II         },
3184b7f5c055SJed Brown  /* layer 1 */
31859371c9d4SSatish Balay         {G,           K,           Q,           O          },
31869371c9d4SSatish Balay         {K,           II,          P,           Q          },
31879371c9d4SSatish Balay         {L,           H,           O + 56 * 1,  R          },
31889371c9d4SSatish Balay         {J,           L,           R,           P          },
31899371c9d4SSatish Balay         {N,           J,           P,           S          },
31909371c9d4SSatish Balay         {H + 56 * 2,  N,           S,           O + 56 * 3 },
31919371c9d4SSatish Balay         {M,           G + 56 * 2,  O + 56 * 2,  T          },
31929371c9d4SSatish Balay         {II,          M,           T,           P          },
3193b7f5c055SJed Brown  /* layer 2 */
31949371c9d4SSatish Balay         {O,           Q,           Y,           U          },
31959371c9d4SSatish Balay         {Q,           P,           W,           Y          },
31969371c9d4SSatish Balay         {R,           O + 56 * 1,  U + 56 * 1,  Ap         },
31979371c9d4SSatish Balay         {P,           R,           Ap,          W          },
31989371c9d4SSatish Balay         {S,           P,           X,           Bp         },
31999371c9d4SSatish Balay         {O + 56 * 3,  S,           Bp,          V + 56 * 1 },
32009371c9d4SSatish Balay         {T,           O + 56 * 2,  V,           Z          },
32019371c9d4SSatish Balay         {P,           T,           Z,           X          },
3202b7f5c055SJed Brown  /* layer 3 */
32039371c9d4SSatish Balay         {U,           Y,           Ep,          Dp         },
32049371c9d4SSatish Balay         {Y,           W,           Cp,          Ep         },
32059371c9d4SSatish Balay         {Ap,          U + 56 * 1,  Dp + 56 * 1, Gp         },
32069371c9d4SSatish Balay         {W,           Ap,          Gp,          Cp         },
32079371c9d4SSatish Balay         {Bp,          X,           Cp + 56 * 2, Fp         },
32089371c9d4SSatish Balay         {V + 56 * 1,  Bp,          Fp,          Dp + 56 * 1},
32099371c9d4SSatish Balay         {Z,           V,           Dp,          Hp         },
32109371c9d4SSatish Balay         {X,           Z,           Hp,          Cp + 56 * 2},
3211b7f5c055SJed Brown  /* layer 4 */
32129371c9d4SSatish Balay         {Dp,          Ep,          Mp,          Kp         },
32139371c9d4SSatish Balay         {Ep,          Cp,          Ip,          Mp         },
32149371c9d4SSatish Balay         {Gp,          Dp + 56 * 1, Lp,          Np         },
32159371c9d4SSatish Balay         {Cp,          Gp,          Np,          Jp         },
32169371c9d4SSatish Balay         {Fp,          Cp + 56 * 2, Jp + 56 * 2, Pp         },
32179371c9d4SSatish Balay         {Dp + 56 * 1, Fp,          Pp,          Lp         },
32189371c9d4SSatish Balay         {Hp,          Dp,          Kp,          Op         },
32199371c9d4SSatish Balay         {Cp + 56 * 2, Hp,          Op,          Ip + 56 * 2},
3220b7f5c055SJed Brown  /* layer 5 */
32219371c9d4SSatish Balay         {Kp,          Mp,          Sp,          Rp         },
32229371c9d4SSatish Balay         {Mp,          Ip,          Qp,          Sp         },
32239371c9d4SSatish Balay         {Np,          Lp,          Rp,          Tp         },
32249371c9d4SSatish Balay         {Jp,          Np,          Tp,          Qp + 56 * 1},
32259371c9d4SSatish Balay         {Pp,          Jp + 56 * 2, Qp + 56 * 3, Up         },
32269371c9d4SSatish Balay         {Lp,          Pp,          Up,          Rp         },
32279371c9d4SSatish Balay         {Op,          Kp,          Rp,          Vp         },
32289371c9d4SSatish Balay         {Ip + 56 * 2, Op,          Vp,          Qp + 56 * 2},
3229b7f5c055SJed Brown  /* layer 6 */
32309371c9d4SSatish Balay         {Rp,          Sp,          Aq,          Yp         },
32319371c9d4SSatish Balay         {Sp,          Qp,          Wp,          Aq         },
32329371c9d4SSatish Balay         {Tp,          Rp,          Yp,          Cq         },
32339371c9d4SSatish Balay         {Qp + 56 * 1, Tp,          Cq,          Wp + 56 * 1},
32349371c9d4SSatish Balay         {Up,          Qp + 56 * 3, Xp + 56 * 1, Dq         },
32359371c9d4SSatish Balay         {Rp,          Up,          Dq,          Zp         },
32369371c9d4SSatish Balay         {Vp,          Rp,          Zp,          Bq         },
32379371c9d4SSatish Balay         {Qp + 56 * 2, Vp,          Bq,          Xp         },
3238b7f5c055SJed Brown  /* layer 7 (the top is the periodic image of the bottom of layer 0) */
32399371c9d4SSatish Balay         {Yp,          Aq,          C + 56 * 4,  A + 56 * 4 },
32409371c9d4SSatish Balay         {Aq,          Wp,          B + 56 * 4,  C + 56 * 4 },
32419371c9d4SSatish Balay         {Cq,          Yp,          A + 56 * 4,  D + 56 * 4 },
32429371c9d4SSatish Balay         {Wp + 56 * 1, Cq,          D + 56 * 4,  B + 56 * 5 },
32439371c9d4SSatish Balay         {Dq,          Xp + 56 * 1, B + 56 * 5,  E + 56 * 4 },
32449371c9d4SSatish Balay         {Zp,          Dq,          E + 56 * 4,  A + 56 * 6 },
32459371c9d4SSatish Balay         {Bq,          Zp,          A + 56 * 6,  F + 56 * 4 },
32469371c9d4SSatish Balay         {Xp,          Bq,          F + 56 * 4,  B + 56 * 4 }
3247b7f5c055SJed Brown       };
3248b7f5c055SJed Brown       const PetscReal gamma                = PetscAcosReal((PetscSqrtReal(3.) - 1.) / PetscSqrtReal(2.)) / PETSC_PI;
32499371c9d4SSatish Balay       const PetscReal patternCoords[56][3] = {
3250bee3fc89SBarry Smith         {1.,        0.,        0.  }, /* A  */
3251bee3fc89SBarry Smith         {0.,        1.,        0.  }, /* B  */
3252bee3fc89SBarry Smith         {gamma,     gamma,     0.  }, /* C  */
3253bee3fc89SBarry Smith         {1 + gamma, 1 - gamma, 0.  }, /* D  */
3254bee3fc89SBarry Smith         {2 - gamma, 2 - gamma, 0.  }, /* E  */
3255bee3fc89SBarry Smith         {1 - gamma, 1 + gamma, 0.  }, /* F  */
3256b7f5c055SJed Brown 
3257bee3fc89SBarry Smith         {.5,        0,         .25 }, /* G  */
3258bee3fc89SBarry Smith         {1.5,       0.,        .25 }, /* H  */
3259bee3fc89SBarry Smith         {.5,        1.,        .25 }, /* II */
3260bee3fc89SBarry Smith         {1.5,       1.,        .25 }, /* J  */
3261bee3fc89SBarry Smith         {.25,       .5,        .25 }, /* K  */
3262bee3fc89SBarry Smith         {1.25,      .5,        .25 }, /* L  */
3263bee3fc89SBarry Smith         {.75,       1.5,       .25 }, /* M  */
3264bee3fc89SBarry Smith         {1.75,      1.5,       .25 }, /* N  */
3265b7f5c055SJed Brown 
3266bee3fc89SBarry Smith         {0.,        0.,        .5  }, /* O  */
3267bee3fc89SBarry Smith         {1.,        1.,        .5  }, /* P  */
3268bee3fc89SBarry Smith         {gamma,     1 - gamma, .5  }, /* Q  */
3269bee3fc89SBarry Smith         {1 + gamma, gamma,     .5  }, /* R  */
3270bee3fc89SBarry Smith         {2 - gamma, 1 + gamma, .5  }, /* S  */
3271bee3fc89SBarry Smith         {1 - gamma, 2 - gamma, .5  }, /* T  */
3272b7f5c055SJed Brown 
3273bee3fc89SBarry Smith         {0.,        .5,        .75 }, /* U  */
3274bee3fc89SBarry Smith         {0.,        1.5,       .75 }, /* V  */
3275bee3fc89SBarry Smith         {1.,        .5,        .75 }, /* W  */
3276bee3fc89SBarry Smith         {1.,        1.5,       .75 }, /* X  */
3277bee3fc89SBarry Smith         {.5,        .75,       .75 }, /* Y  */
3278bee3fc89SBarry Smith         {.5,        1.75,      .75 }, /* Z  */
3279bee3fc89SBarry Smith         {1.5,       .25,       .75 }, /* Ap */
3280bee3fc89SBarry Smith         {1.5,       1.25,      .75 }, /* Bp */
3281b7f5c055SJed Brown 
3282bee3fc89SBarry Smith         {1.,        0.,        1.  }, /* Cp */
3283bee3fc89SBarry Smith         {0.,        1.,        1.  }, /* Dp */
3284bee3fc89SBarry Smith         {1 - gamma, 1 - gamma, 1.  }, /* Ep */
3285bee3fc89SBarry Smith         {1 + gamma, 1 + gamma, 1.  }, /* Fp */
3286bee3fc89SBarry Smith         {2 - gamma, gamma,     1.  }, /* Gp */
3287bee3fc89SBarry Smith         {gamma,     2 - gamma, 1.  }, /* Hp */
3288b7f5c055SJed Brown 
3289bee3fc89SBarry Smith         {.5,        0.,        1.25}, /* Ip */
3290bee3fc89SBarry Smith         {1.5,       0.,        1.25}, /* Jp */
3291bee3fc89SBarry Smith         {.5,        1.,        1.25}, /* Kp */
3292bee3fc89SBarry Smith         {1.5,       1.,        1.25}, /* Lp */
3293bee3fc89SBarry Smith         {.75,       .5,        1.25}, /* Mp */
3294bee3fc89SBarry Smith         {1.75,      .5,        1.25}, /* Np */
3295bee3fc89SBarry Smith         {.25,       1.5,       1.25}, /* Op */
3296bee3fc89SBarry Smith         {1.25,      1.5,       1.25}, /* Pp */
3297b7f5c055SJed Brown 
3298bee3fc89SBarry Smith         {0.,        0.,        1.5 }, /* Qp */
3299bee3fc89SBarry Smith         {1.,        1.,        1.5 }, /* Rp */
3300bee3fc89SBarry Smith         {1 - gamma, gamma,     1.5 }, /* Sp */
3301bee3fc89SBarry Smith         {2 - gamma, 1 - gamma, 1.5 }, /* Tp */
3302bee3fc89SBarry Smith         {1 + gamma, 2 - gamma, 1.5 }, /* Up */
3303bee3fc89SBarry Smith         {gamma,     1 + gamma, 1.5 }, /* Vp */
3304b7f5c055SJed Brown 
3305bee3fc89SBarry Smith         {0.,        .5,        1.75}, /* Wp */
3306bee3fc89SBarry Smith         {0.,        1.5,       1.75}, /* Xp */
3307bee3fc89SBarry Smith         {1.,        .5,        1.75}, /* Yp */
3308bee3fc89SBarry Smith         {1.,        1.5,       1.75}, /* Zp */
3309bee3fc89SBarry Smith         {.5,        .25,       1.75}, /* Aq */
3310bee3fc89SBarry Smith         {.5,        1.25,      1.75}, /* Bq */
3311bee3fc89SBarry Smith         {1.5,       .75,       1.75}, /* Cq */
3312bee3fc89SBarry Smith         {1.5,       1.75,      1.75}, /* Dq */
3313b7f5c055SJed Brown       };
3314b7f5c055SJed Brown       PetscInt(*cells)[64][4] = NULL;
3315b7f5c055SJed Brown       PetscBool *seen;
3316b7f5c055SJed Brown       PetscInt  *vertToTrueVert;
3317b7f5c055SJed Brown       PetscInt   count;
3318b7f5c055SJed Brown 
3319b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) extentPlus[i] = extent[i] + 1;
3320b7f5c055SJed Brown       numBlocks = 1;
3321b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) numBlocks *= extent[i];
3322b7f5c055SJed Brown       numBlocksPlus = 1;
3323b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) numBlocksPlus *= extentPlus[i];
3324b7f5c055SJed Brown       numFaces = numBlocks * facesPerBlock;
33259566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numBlocks, &cells));
33269566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numBlocksPlus * vertsPerBlock, &seen));
3327b7f5c055SJed Brown       for (PetscInt k = 0; k < extent[2]; k++) {
3328b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3329b7f5c055SJed Brown           for (PetscInt i = 0; i < extent[0]; i++) {
3330b7f5c055SJed Brown             for (PetscInt f = 0; f < facesPerBlock; f++) {
3331b7f5c055SJed Brown               for (PetscInt v = 0; v < 4; v++) {
3332b7f5c055SJed Brown                 PetscInt vertRaw     = pattern[f][v];
3333b7f5c055SJed Brown                 PetscInt blockidx    = vertRaw / 56;
3334b7f5c055SJed Brown                 PetscInt patternvert = vertRaw % 56;
3335b7f5c055SJed Brown                 PetscInt xplus       = (blockidx & 1);
3336b7f5c055SJed Brown                 PetscInt yplus       = (blockidx & 2) >> 1;
3337b7f5c055SJed Brown                 PetscInt zplus       = (blockidx & 4) >> 2;
3338b7f5c055SJed Brown                 PetscInt zcoord      = (periodic && periodic[2] == DM_BOUNDARY_PERIODIC) ? ((k + zplus) % extent[2]) : (k + zplus);
3339b7f5c055SJed Brown                 PetscInt ycoord      = (periodic && periodic[1] == DM_BOUNDARY_PERIODIC) ? ((j + yplus) % extent[1]) : (j + yplus);
3340b7f5c055SJed Brown                 PetscInt xcoord      = (periodic && periodic[0] == DM_BOUNDARY_PERIODIC) ? ((i + xplus) % extent[0]) : (i + xplus);
3341b7f5c055SJed Brown                 PetscInt vert        = ((zcoord * extentPlus[1] + ycoord) * extentPlus[0] + xcoord) * 56 + patternvert;
3342b7f5c055SJed Brown 
3343b7f5c055SJed Brown                 cells[(k * extent[1] + j) * extent[0] + i][f][v] = vert;
3344b7f5c055SJed Brown                 seen[vert]                                       = PETSC_TRUE;
3345b7f5c055SJed Brown               }
3346b7f5c055SJed Brown             }
3347b7f5c055SJed Brown           }
3348b7f5c055SJed Brown         }
3349b7f5c055SJed Brown       }
33509371c9d4SSatish Balay       for (PetscInt i = 0; i < numBlocksPlus * vertsPerBlock; i++)
33519371c9d4SSatish Balay         if (seen[i]) numVertices++;
3352b7f5c055SJed Brown       count = 0;
33539566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numBlocksPlus * vertsPerBlock, &vertToTrueVert));
33549566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numVertices * 3, &vtxCoords));
3355b7f5c055SJed Brown       for (PetscInt i = 0; i < numBlocksPlus * vertsPerBlock; i++) vertToTrueVert[i] = -1;
3356b7f5c055SJed Brown       for (PetscInt k = 0; k < extentPlus[2]; k++) {
3357b7f5c055SJed Brown         for (PetscInt j = 0; j < extentPlus[1]; j++) {
3358b7f5c055SJed Brown           for (PetscInt i = 0; i < extentPlus[0]; i++) {
3359b7f5c055SJed Brown             for (PetscInt v = 0; v < vertsPerBlock; v++) {
3360b7f5c055SJed Brown               PetscInt vIdx = ((k * extentPlus[1] + j) * extentPlus[0] + i) * vertsPerBlock + v;
3361b7f5c055SJed Brown 
3362b7f5c055SJed Brown               if (seen[vIdx]) {
3363b7f5c055SJed Brown                 PetscInt thisVert;
3364b7f5c055SJed Brown 
3365b7f5c055SJed Brown                 vertToTrueVert[vIdx] = thisVert = count++;
3366b7f5c055SJed Brown 
3367b7f5c055SJed Brown                 for (PetscInt d = 0; d < 3; d++) vtxCoords[3 * thisVert + d] = patternCoords[v][d];
3368b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 0] += i * 2;
3369b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 1] += j * 2;
3370b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 2] += k * 2;
3371b7f5c055SJed Brown               }
3372b7f5c055SJed Brown             }
3373b7f5c055SJed Brown           }
3374b7f5c055SJed Brown         }
3375b7f5c055SJed Brown       }
3376b7f5c055SJed Brown       for (PetscInt i = 0; i < numBlocks; i++) {
3377b7f5c055SJed Brown         for (PetscInt f = 0; f < facesPerBlock; f++) {
3378ad540459SPierre Jolivet           for (PetscInt v = 0; v < 4; v++) cells[i][f][v] = vertToTrueVert[cells[i][f][v]];
3379b7f5c055SJed Brown         }
3380b7f5c055SJed Brown       }
33819566063dSJacob Faibussowitsch       PetscCall(PetscFree(vertToTrueVert));
33829566063dSJacob Faibussowitsch       PetscCall(PetscFree(seen));
3383b7f5c055SJed Brown       cells_flat = cells[0][0];
3384b7f5c055SJed Brown       numEdges   = 0;
3385b7f5c055SJed Brown       for (PetscInt i = 0; i < numFaces; i++) {
3386b7f5c055SJed Brown         for (PetscInt e = 0; e < 4; e++) {
3387b7f5c055SJed Brown           PetscInt         ev[]       = {cells_flat[i * 4 + e], cells_flat[i * 4 + ((e + 1) % 4)]};
3388b7f5c055SJed Brown           const PetscReal *evCoords[] = {&vtxCoords[3 * ev[0]], &vtxCoords[3 * ev[1]]};
3389b7f5c055SJed Brown 
3390b7f5c055SJed Brown           for (PetscInt d = 0; d < 3; d++) {
3391b7f5c055SJed Brown             if (!periodic || periodic[0] != DM_BOUNDARY_PERIODIC) {
3392b7f5c055SJed Brown               if (evCoords[0][d] == 0. && evCoords[1][d] == 0.) numEdges++;
3393b7f5c055SJed Brown               if (evCoords[0][d] == 2. * extent[d] && evCoords[1][d] == 2. * extent[d]) numEdges++;
3394b7f5c055SJed Brown             }
3395b7f5c055SJed Brown           }
3396b7f5c055SJed Brown         }
3397b7f5c055SJed Brown       }
33989566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numEdges, &edges));
33999566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numEdges, &edgeSets));
3400b7f5c055SJed Brown       for (PetscInt edge = 0, i = 0; i < numFaces; i++) {
3401b7f5c055SJed Brown         for (PetscInt e = 0; e < 4; e++) {
3402b7f5c055SJed Brown           PetscInt         ev[]       = {cells_flat[i * 4 + e], cells_flat[i * 4 + ((e + 1) % 4)]};
3403b7f5c055SJed Brown           const PetscReal *evCoords[] = {&vtxCoords[3 * ev[0]], &vtxCoords[3 * ev[1]]};
3404b7f5c055SJed Brown 
3405b7f5c055SJed Brown           for (PetscInt d = 0; d < 3; d++) {
3406b7f5c055SJed Brown             if (!periodic || periodic[d] != DM_BOUNDARY_PERIODIC) {
3407b7f5c055SJed Brown               if (evCoords[0][d] == 0. && evCoords[1][d] == 0.) {
3408b7f5c055SJed Brown                 edges[edge][0]   = ev[0];
3409b7f5c055SJed Brown                 edges[edge][1]   = ev[1];
3410b7f5c055SJed Brown                 edgeSets[edge++] = 2 * d;
3411b7f5c055SJed Brown               }
3412b7f5c055SJed Brown               if (evCoords[0][d] == 2. * extent[d] && evCoords[1][d] == 2. * extent[d]) {
3413b7f5c055SJed Brown                 edges[edge][0]   = ev[0];
3414b7f5c055SJed Brown                 edges[edge][1]   = ev[1];
3415b7f5c055SJed Brown                 edgeSets[edge++] = 2 * d + 1;
3416b7f5c055SJed Brown               }
3417b7f5c055SJed Brown             }
3418b7f5c055SJed Brown           }
3419b7f5c055SJed Brown         }
3420b7f5c055SJed Brown       }
3421b7f5c055SJed Brown     }
3422b7f5c055SJed Brown     evalFunc   = TPSEvaluate_Gyroid;
34234663dae6SJed Brown     normalFunc = TPSExtrudeNormalFunc_Gyroid;
3424b7f5c055SJed Brown     break;
3425b7f5c055SJed Brown   }
3426b7f5c055SJed Brown 
34279566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, topoDim));
3428c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildFromCellList(dm, numFaces, numVertices, 4, cells_flat));
34299566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildFromCellList(dm, 0, 0, 0, NULL));
34309566063dSJacob Faibussowitsch   PetscCall(PetscFree(cells_flat));
3431b7f5c055SJed Brown   {
3432b7f5c055SJed Brown     DM idm;
34339566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(dm, &idm));
343469d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &idm));
3435b7f5c055SJed Brown   }
3436c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildCoordinatesFromCellList(dm, spaceDim, vtxCoords));
34379566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildCoordinatesFromCellList(dm, spaceDim, NULL));
34389566063dSJacob Faibussowitsch   PetscCall(PetscFree(vtxCoords));
3439b7f5c055SJed Brown 
34409566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "Face Sets"));
34419566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "Face Sets", &label));
3442b7f5c055SJed Brown   for (PetscInt e = 0; e < numEdges; e++) {
3443b7f5c055SJed Brown     PetscInt        njoin;
3444b7f5c055SJed Brown     const PetscInt *join, verts[] = {numFaces + edges[e][0], numFaces + edges[e][1]};
34459566063dSJacob Faibussowitsch     PetscCall(DMPlexGetJoin(dm, 2, verts, &njoin, &join));
344663a3b9bcSJacob Faibussowitsch     PetscCheck(njoin == 1, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Expected unique join of vertices %" PetscInt_FMT " and %" PetscInt_FMT, edges[e][0], edges[e][1]);
34479566063dSJacob Faibussowitsch     PetscCall(DMLabelSetValue(label, join[0], edgeSets[e]));
34489566063dSJacob Faibussowitsch     PetscCall(DMPlexRestoreJoin(dm, 2, verts, &njoin, &join));
3449b7f5c055SJed Brown   }
34509566063dSJacob Faibussowitsch   PetscCall(PetscFree(edges));
34519566063dSJacob Faibussowitsch   PetscCall(PetscFree(edgeSets));
34521436d7faSJed Brown   if (tps_distribute) {
34531436d7faSJed Brown     DM               pdm = NULL;
34541436d7faSJed Brown     PetscPartitioner part;
34551436d7faSJed Brown 
34569566063dSJacob Faibussowitsch     PetscCall(DMPlexGetPartitioner(dm, &part));
34579566063dSJacob Faibussowitsch     PetscCall(PetscPartitionerSetFromOptions(part));
34589566063dSJacob Faibussowitsch     PetscCall(DMPlexDistribute(dm, 0, NULL, &pdm));
345948a46eb9SPierre Jolivet     if (pdm) PetscCall(DMPlexReplace_Internal(dm, &pdm));
34601436d7faSJed Brown     // Do not auto-distribute again
34619566063dSJacob Faibussowitsch     PetscCall(DMPlexDistributeSetDefault(dm, PETSC_FALSE));
34621436d7faSJed Brown   }
3463b7f5c055SJed Brown 
34649566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
3465b7f5c055SJed Brown   for (PetscInt refine = 0; refine < refinements; refine++) {
3466b7f5c055SJed Brown     PetscInt     m;
3467b7f5c055SJed Brown     DM           dmf;
3468b7f5c055SJed Brown     Vec          X;
3469b7f5c055SJed Brown     PetscScalar *x;
34709566063dSJacob Faibussowitsch     PetscCall(DMRefine(dm, MPI_COMM_NULL, &dmf));
347169d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmf));
3472b7f5c055SJed Brown 
34739566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinatesLocal(dm, &X));
34749566063dSJacob Faibussowitsch     PetscCall(VecGetLocalSize(X, &m));
34759566063dSJacob Faibussowitsch     PetscCall(VecGetArray(X, &x));
347648a46eb9SPierre Jolivet     for (PetscInt i = 0; i < m; i += 3) PetscCall(TPSNearestPoint(evalFunc, &x[i]));
34779566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(X, &x));
3478b7f5c055SJed Brown   }
3479b7f5c055SJed Brown 
3480b7f5c055SJed Brown   // Face Sets has already been propagated to new vertices during refinement; this propagates to the initial vertices.
34819566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "Face Sets", &label));
34829566063dSJacob Faibussowitsch   PetscCall(DMPlexLabelComplete(dm, label));
3483b7f5c055SJed Brown 
348446139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
348546139095SJed Brown 
3486b7f5c055SJed Brown   if (thickness > 0) {
34874663dae6SJed Brown     DM              edm, cdm, ecdm;
34884663dae6SJed Brown     DMPlexTransform tr;
34894663dae6SJed Brown     const char     *prefix;
34904663dae6SJed Brown     PetscOptions    options;
34914663dae6SJed Brown     // Code from DMPlexExtrude
34924663dae6SJed Brown     PetscCall(DMPlexTransformCreate(PetscObjectComm((PetscObject)dm), &tr));
34934663dae6SJed Brown     PetscCall(DMPlexTransformSetDM(tr, dm));
34944663dae6SJed Brown     PetscCall(DMPlexTransformSetType(tr, DMPLEXEXTRUDE));
34954663dae6SJed Brown     PetscCall(PetscObjectGetOptionsPrefix((PetscObject)dm, &prefix));
34964663dae6SJed Brown     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)tr, prefix));
34974663dae6SJed Brown     PetscCall(PetscObjectGetOptions((PetscObject)dm, &options));
34984663dae6SJed Brown     PetscCall(PetscObjectSetOptions((PetscObject)tr, options));
34994663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetLayers(tr, layers));
35004663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetThickness(tr, thickness));
35014663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetTensor(tr, PETSC_FALSE));
35024663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetSymmetric(tr, PETSC_TRUE));
35034663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetNormalFunction(tr, normalFunc));
35044663dae6SJed Brown     PetscCall(DMPlexTransformSetFromOptions(tr));
35054663dae6SJed Brown     PetscCall(PetscObjectSetOptions((PetscObject)tr, NULL));
35064663dae6SJed Brown     PetscCall(DMPlexTransformSetUp(tr));
35074663dae6SJed Brown     PetscCall(PetscObjectViewFromOptions((PetscObject)tr, NULL, "-dm_plex_tps_transform_view"));
35084663dae6SJed Brown     PetscCall(DMPlexTransformApply(tr, dm, &edm));
35094663dae6SJed Brown     PetscCall(DMCopyDisc(dm, edm));
35104663dae6SJed Brown     PetscCall(DMGetCoordinateDM(dm, &cdm));
35114663dae6SJed Brown     PetscCall(DMGetCoordinateDM(edm, &ecdm));
35124663dae6SJed Brown     PetscCall(DMCopyDisc(cdm, ecdm));
35134663dae6SJed Brown     PetscCall(DMPlexTransformCreateDiscLabels(tr, edm));
35144663dae6SJed Brown     PetscCall(DMPlexTransformDestroy(&tr));
35154663dae6SJed Brown     if (edm) {
35164663dae6SJed Brown       ((DM_Plex *)edm->data)->printFEM    = ((DM_Plex *)dm->data)->printFEM;
35174663dae6SJed Brown       ((DM_Plex *)edm->data)->printL2     = ((DM_Plex *)dm->data)->printL2;
3518f5867de0SMatthew G. Knepley       ((DM_Plex *)edm->data)->printLocate = ((DM_Plex *)dm->data)->printLocate;
35194663dae6SJed Brown     }
352069d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &edm));
3521b7f5c055SJed Brown   }
35223ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3523b7f5c055SJed Brown }
3524b7f5c055SJed Brown 
3525b7f5c055SJed Brown /*@
3526b7f5c055SJed Brown   DMPlexCreateTPSMesh - Create a distributed, interpolated mesh of a triply-periodic surface
3527b7f5c055SJed Brown 
3528b7f5c055SJed Brown   Collective
3529b7f5c055SJed Brown 
3530b7f5c055SJed Brown   Input Parameters:
3531a1cb98faSBarry Smith + comm           - The communicator for the `DM` object
3532b7f5c055SJed Brown . tpstype        - Type of triply-periodic surface
3533b7f5c055SJed Brown . extent         - Array of length 3 containing number of periods in each direction
353420f4b53cSBarry Smith . periodic       - array of length 3 with periodicity, or `NULL` for non-periodic
35351436d7faSJed Brown . tps_distribute - Distribute 2D manifold mesh prior to refinement and extrusion (more scalable)
3536817da375SSatish Balay . refinements    - Number of factor-of-2 refinements of 2D manifold mesh
35371436d7faSJed Brown . layers         - Number of cell layers extruded in normal direction
3538817da375SSatish Balay - thickness      - Thickness in normal direction
3539b7f5c055SJed Brown 
3540b7f5c055SJed Brown   Output Parameter:
3541a1cb98faSBarry Smith . dm - The `DM` object
3542a1cb98faSBarry Smith 
3543a1cb98faSBarry Smith   Level: beginner
3544b7f5c055SJed Brown 
3545b7f5c055SJed Brown   Notes:
3546b7f5c055SJed Brown   This meshes the surface of the Schwarz P or Gyroid surfaces.  Schwarz P is is the simplest member of the triply-periodic minimal surfaces.
3547b7f5c055SJed Brown   https://en.wikipedia.org/wiki/Schwarz_minimal_surface#Schwarz_P_(%22Primitive%22) and can be cut with "clean" boundaries.
3548b7f5c055SJed Brown   The Gyroid (https://en.wikipedia.org/wiki/Gyroid) is another triply-periodic minimal surface with applications in additive manufacturing; it is much more difficult to "cut" since there are no planes of symmetry.
3549b7f5c055SJed Brown   Our implementation creates a very coarse mesh of the surface and refines (by 4-way splitting) as many times as requested.
3550b7f5c055SJed Brown   On each refinement, all vertices are projected to their nearest point on the surface.
3551b7f5c055SJed Brown   This projection could readily be extended to related surfaces.
3552b7f5c055SJed Brown 
3553b7f5c055SJed Brown   The face (edge) sets for the Schwarz P surface are numbered 1(-x), 2(+x), 3(-y), 4(+y), 5(-z), 6(+z).
355420f4b53cSBarry Smith   When the mesh is refined, "Face Sets" contain the new vertices (created during refinement).  Use `DMPlexLabelComplete()` to propagate to coarse-level vertices.
3555b7f5c055SJed Brown 
355660225df5SJacob Faibussowitsch   Developer Notes:
3557b7f5c055SJed Brown   The Gyroid mesh does not currently mark boundary sets.
3558b7f5c055SJed Brown 
3559a1cb98faSBarry Smith   References:
3560a1cb98faSBarry Smith . * - Maskery et al, Insights into the mechanical properties of several triply periodic minimal surface lattice structures made by polymer additive manufacturing, 2017.
3561a1cb98faSBarry Smith   https://doi.org/10.1016/j.polymer.2017.11.049
3562b7f5c055SJed Brown 
35631cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateSphereMesh()`, `DMSetType()`, `DMCreate()`
3564b7f5c055SJed Brown @*/
3565d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateTPSMesh(MPI_Comm comm, DMPlexTPSType tpstype, const PetscInt extent[], const DMBoundaryType periodic[], PetscBool tps_distribute, PetscInt refinements, PetscInt layers, PetscReal thickness, DM *dm)
3566d71ae5a4SJacob Faibussowitsch {
3567b7f5c055SJed Brown   PetscFunctionBegin;
35689566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
35699566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
35709566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateTPSMesh_Internal(*dm, tpstype, extent, periodic, tps_distribute, refinements, layers, thickness));
35713ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3572b7f5c055SJed Brown }
3573b7f5c055SJed Brown 
35749318fe57SMatthew G. Knepley /*@
35759318fe57SMatthew G. Knepley   DMPlexCreateSphereMesh - Creates a mesh on the d-dimensional sphere, S^d.
35769318fe57SMatthew G. Knepley 
35779318fe57SMatthew G. Knepley   Collective
35789318fe57SMatthew G. Knepley 
35799318fe57SMatthew G. Knepley   Input Parameters:
3580a1cb98faSBarry Smith + comm    - The communicator for the `DM` object
35819318fe57SMatthew G. Knepley . dim     - The dimension
35829318fe57SMatthew G. Knepley . simplex - Use simplices, or tensor product cells
35839318fe57SMatthew G. Knepley - R       - The radius
35849318fe57SMatthew G. Knepley 
35859318fe57SMatthew G. Knepley   Output Parameter:
3586a1cb98faSBarry Smith . dm - The `DM` object
35879318fe57SMatthew G. Knepley 
35889318fe57SMatthew G. Knepley   Level: beginner
35899318fe57SMatthew G. Knepley 
35901cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBallMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
35919318fe57SMatthew G. Knepley @*/
3592d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateSphereMesh(MPI_Comm comm, PetscInt dim, PetscBool simplex, PetscReal R, DM *dm)
3593d71ae5a4SJacob Faibussowitsch {
35949318fe57SMatthew G. Knepley   PetscFunctionBegin;
35954f572ea9SToby Isaac   PetscAssertPointer(dm, 5);
35969566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
35979566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
35989566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateSphereMesh_Internal(*dm, dim, simplex, R));
35993ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
36009318fe57SMatthew G. Knepley }
36019318fe57SMatthew G. Knepley 
3602d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBallMesh_Internal(DM dm, PetscInt dim, PetscReal R)
3603d71ae5a4SJacob Faibussowitsch {
36049318fe57SMatthew G. Knepley   DM      sdm, vol;
36059318fe57SMatthew G. Knepley   DMLabel bdlabel;
36069318fe57SMatthew G. Knepley 
36079318fe57SMatthew G. Knepley   PetscFunctionBegin;
36089566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &sdm));
36099566063dSJacob Faibussowitsch   PetscCall(DMSetType(sdm, DMPLEX));
36109566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)sdm, "bd_"));
36119566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateSphereMesh_Internal(sdm, dim - 1, PETSC_TRUE, R));
36129566063dSJacob Faibussowitsch   PetscCall(DMSetFromOptions(sdm));
36139566063dSJacob Faibussowitsch   PetscCall(DMViewFromOptions(sdm, NULL, "-dm_view"));
36149566063dSJacob Faibussowitsch   PetscCall(DMPlexGenerate(sdm, NULL, PETSC_TRUE, &vol));
36159566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&sdm));
361669d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
36179566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "marker"));
36189566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "marker", &bdlabel));
36199566063dSJacob Faibussowitsch   PetscCall(DMPlexMarkBoundaryFaces(dm, PETSC_DETERMINE, bdlabel));
36209566063dSJacob Faibussowitsch   PetscCall(DMPlexLabelComplete(dm, bdlabel));
36213ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
362251a74b61SMatthew G. Knepley }
362351a74b61SMatthew G. Knepley 
362451a74b61SMatthew G. Knepley /*@
362551a74b61SMatthew G. Knepley   DMPlexCreateBallMesh - Creates a simplex mesh on the d-dimensional ball, B^d.
362651a74b61SMatthew G. Knepley 
362751a74b61SMatthew G. Knepley   Collective
362851a74b61SMatthew G. Knepley 
362951a74b61SMatthew G. Knepley   Input Parameters:
3630a1cb98faSBarry Smith + comm - The communicator for the `DM` object
363151a74b61SMatthew G. Knepley . dim  - The dimension
363251a74b61SMatthew G. Knepley - R    - The radius
363351a74b61SMatthew G. Knepley 
363451a74b61SMatthew G. Knepley   Output Parameter:
3635a1cb98faSBarry Smith . dm - The `DM` object
363651a74b61SMatthew G. Knepley 
3637a1cb98faSBarry Smith   Options Database Key:
363860225df5SJacob Faibussowitsch . bd_dm_refine - This will refine the surface mesh preserving the sphere geometry
363951a74b61SMatthew G. Knepley 
364051a74b61SMatthew G. Knepley   Level: beginner
364151a74b61SMatthew G. Knepley 
36421cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateSphereMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
364351a74b61SMatthew G. Knepley @*/
3644d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateBallMesh(MPI_Comm comm, PetscInt dim, PetscReal R, DM *dm)
3645d71ae5a4SJacob Faibussowitsch {
364651a74b61SMatthew G. Knepley   PetscFunctionBegin;
36479566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
36489566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
36499566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBallMesh_Internal(*dm, dim, R));
36503ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
36512829fed8SMatthew G. Knepley }
36522829fed8SMatthew G. Knepley 
3653d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateReferenceCell_Internal(DM rdm, DMPolytopeType ct)
3654d71ae5a4SJacob Faibussowitsch {
36550a6ba040SMatthew G. Knepley   PetscFunctionBegin;
36569318fe57SMatthew G. Knepley   switch (ct) {
36579371c9d4SSatish Balay   case DM_POLYTOPE_POINT: {
36589318fe57SMatthew G. Knepley     PetscInt    numPoints[1]        = {1};
36599318fe57SMatthew G. Knepley     PetscInt    coneSize[1]         = {0};
36609318fe57SMatthew G. Knepley     PetscInt    cones[1]            = {0};
36619318fe57SMatthew G. Knepley     PetscInt    coneOrientations[1] = {0};
36629318fe57SMatthew G. Knepley     PetscScalar vertexCoords[1]     = {0.0};
36639318fe57SMatthew G. Knepley 
36649566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 0));
36659566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 0, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36669371c9d4SSatish Balay   } break;
36679371c9d4SSatish Balay   case DM_POLYTOPE_SEGMENT: {
36689318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {2, 1};
36699318fe57SMatthew G. Knepley     PetscInt    coneSize[3]         = {2, 0, 0};
36709318fe57SMatthew G. Knepley     PetscInt    cones[2]            = {1, 2};
36719318fe57SMatthew G. Knepley     PetscInt    coneOrientations[2] = {0, 0};
36729318fe57SMatthew G. Knepley     PetscScalar vertexCoords[2]     = {-1.0, 1.0};
36739318fe57SMatthew G. Knepley 
36749566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 1));
36759566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36769371c9d4SSatish Balay   } break;
36779371c9d4SSatish Balay   case DM_POLYTOPE_POINT_PRISM_TENSOR: {
3678b5a892a1SMatthew G. Knepley     PetscInt    numPoints[2]        = {2, 1};
3679b5a892a1SMatthew G. Knepley     PetscInt    coneSize[3]         = {2, 0, 0};
3680b5a892a1SMatthew G. Knepley     PetscInt    cones[2]            = {1, 2};
3681b5a892a1SMatthew G. Knepley     PetscInt    coneOrientations[2] = {0, 0};
3682b5a892a1SMatthew G. Knepley     PetscScalar vertexCoords[2]     = {-1.0, 1.0};
3683b5a892a1SMatthew G. Knepley 
36849566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 1));
36859566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36869371c9d4SSatish Balay   } break;
36879371c9d4SSatish Balay   case DM_POLYTOPE_TRIANGLE: {
36889318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {3, 1};
36899318fe57SMatthew G. Knepley     PetscInt    coneSize[4]         = {3, 0, 0, 0};
36909318fe57SMatthew G. Knepley     PetscInt    cones[3]            = {1, 2, 3};
36919318fe57SMatthew G. Knepley     PetscInt    coneOrientations[3] = {0, 0, 0};
36929318fe57SMatthew G. Knepley     PetscScalar vertexCoords[6]     = {-1.0, -1.0, 1.0, -1.0, -1.0, 1.0};
36939318fe57SMatthew G. Knepley 
36949566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
36959566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36969371c9d4SSatish Balay   } break;
36979371c9d4SSatish Balay   case DM_POLYTOPE_QUADRILATERAL: {
36989318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
36999318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
37009318fe57SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
37019318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
37029318fe57SMatthew G. Knepley     PetscScalar vertexCoords[8]     = {-1.0, -1.0, 1.0, -1.0, 1.0, 1.0, -1.0, 1.0};
37039318fe57SMatthew G. Knepley 
37049566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
37059566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37069371c9d4SSatish Balay   } break;
37079371c9d4SSatish Balay   case DM_POLYTOPE_SEG_PRISM_TENSOR: {
37089318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
37099318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
37109318fe57SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
37119318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
37129318fe57SMatthew G. Knepley     PetscScalar vertexCoords[8]     = {-1.0, -1.0, 1.0, -1.0, -1.0, 1.0, 1.0, 1.0};
37139318fe57SMatthew G. Knepley 
37149566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
37159566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37169371c9d4SSatish Balay   } break;
37179371c9d4SSatish Balay   case DM_POLYTOPE_TETRAHEDRON: {
37189318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
37199318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
3720f0edb160SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
37219318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
3722f0edb160SMatthew G. Knepley     PetscScalar vertexCoords[12]    = {-1.0, -1.0, -1.0, -1.0, 1.0, -1.0, 1.0, -1.0, -1.0, -1.0, -1.0, 1.0};
37239318fe57SMatthew G. Knepley 
37249566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37259566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37269371c9d4SSatish Balay   } break;
37279371c9d4SSatish Balay   case DM_POLYTOPE_HEXAHEDRON: {
37289318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {8, 1};
37299318fe57SMatthew G. Knepley     PetscInt    coneSize[9]         = {8, 0, 0, 0, 0, 0, 0, 0, 0};
3730f0edb160SMatthew G. Knepley     PetscInt    cones[8]            = {1, 2, 3, 4, 5, 6, 7, 8};
37319318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
37329371c9d4SSatish Balay     PetscScalar vertexCoords[24]    = {-1.0, -1.0, -1.0, -1.0, 1.0, -1.0, 1.0, 1.0, -1.0, 1.0, -1.0, -1.0, -1.0, -1.0, 1.0, 1.0, -1.0, 1.0, 1.0, 1.0, 1.0, -1.0, 1.0, 1.0};
37339318fe57SMatthew G. Knepley 
37349566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37359566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37369371c9d4SSatish Balay   } break;
37379371c9d4SSatish Balay   case DM_POLYTOPE_TRI_PRISM: {
37389318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {6, 1};
37399318fe57SMatthew G. Knepley     PetscInt    coneSize[7]         = {6, 0, 0, 0, 0, 0, 0};
3740f0edb160SMatthew G. Knepley     PetscInt    cones[6]            = {1, 2, 3, 4, 5, 6};
37419318fe57SMatthew G. Knepley     PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
37429371c9d4SSatish Balay     PetscScalar vertexCoords[18]    = {-1.0, -1.0, -1.0, -1.0, 1.0, -1.0, 1.0, -1.0, -1.0, -1.0, -1.0, 1.0, 1.0, -1.0, 1.0, -1.0, 1.0, 1.0};
37439318fe57SMatthew G. Knepley 
37449566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37459566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37469371c9d4SSatish Balay   } break;
37479371c9d4SSatish Balay   case DM_POLYTOPE_TRI_PRISM_TENSOR: {
37489318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {6, 1};
37499318fe57SMatthew G. Knepley     PetscInt    coneSize[7]         = {6, 0, 0, 0, 0, 0, 0};
37509318fe57SMatthew G. Knepley     PetscInt    cones[6]            = {1, 2, 3, 4, 5, 6};
37519318fe57SMatthew G. Knepley     PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
37529371c9d4SSatish Balay     PetscScalar vertexCoords[18]    = {-1.0, -1.0, -1.0, 1.0, -1.0, -1.0, -1.0, 1.0, -1.0, -1.0, -1.0, 1.0, 1.0, -1.0, 1.0, -1.0, 1.0, 1.0};
37539318fe57SMatthew G. Knepley 
37549566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37559566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37569371c9d4SSatish Balay   } break;
37579371c9d4SSatish Balay   case DM_POLYTOPE_QUAD_PRISM_TENSOR: {
37589318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {8, 1};
37599318fe57SMatthew G. Knepley     PetscInt    coneSize[9]         = {8, 0, 0, 0, 0, 0, 0, 0, 0};
37609318fe57SMatthew G. Knepley     PetscInt    cones[8]            = {1, 2, 3, 4, 5, 6, 7, 8};
37619318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
37629371c9d4SSatish Balay     PetscScalar vertexCoords[24]    = {-1.0, -1.0, -1.0, 1.0, -1.0, -1.0, 1.0, 1.0, -1.0, -1.0, 1.0, -1.0, -1.0, -1.0, 1.0, 1.0, -1.0, 1.0, 1.0, 1.0, 1.0, -1.0, 1.0, 1.0};
37639318fe57SMatthew G. Knepley 
37649566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37659566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37669371c9d4SSatish Balay   } break;
37679371c9d4SSatish Balay   case DM_POLYTOPE_PYRAMID: {
37689318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {5, 1};
37699318fe57SMatthew G. Knepley     PetscInt    coneSize[6]         = {5, 0, 0, 0, 0, 0};
3770f0edb160SMatthew G. Knepley     PetscInt    cones[5]            = {1, 2, 3, 4, 5};
37719318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
37729371c9d4SSatish Balay     PetscScalar vertexCoords[24]    = {-1.0, -1.0, -1.0, -1.0, 1.0, -1.0, 1.0, 1.0, -1.0, 1.0, -1.0, -1.0, 0.0, 0.0, 1.0};
37739318fe57SMatthew G. Knepley 
37749566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37759566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37769371c9d4SSatish Balay   } break;
3777d71ae5a4SJacob Faibussowitsch   default:
3778d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)rdm), PETSC_ERR_ARG_WRONG, "Cannot create reference cell for cell type %s", DMPolytopeTypes[ct]);
37799318fe57SMatthew G. Knepley   }
37809318fe57SMatthew G. Knepley   {
37819318fe57SMatthew G. Knepley     PetscInt Nv, v;
37829318fe57SMatthew G. Knepley 
37839318fe57SMatthew G. Knepley     /* Must create the celltype label here so that we do not automatically try to compute the types */
37849566063dSJacob Faibussowitsch     PetscCall(DMCreateLabel(rdm, "celltype"));
37859566063dSJacob Faibussowitsch     PetscCall(DMPlexSetCellType(rdm, 0, ct));
37869566063dSJacob Faibussowitsch     PetscCall(DMPlexGetChart(rdm, NULL, &Nv));
37879566063dSJacob Faibussowitsch     for (v = 1; v < Nv; ++v) PetscCall(DMPlexSetCellType(rdm, v, DM_POLYTOPE_POINT));
37889318fe57SMatthew G. Knepley   }
37899566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolateInPlace_Internal(rdm));
37909566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)rdm, DMPolytopeTypes[ct]));
37913ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
37920a6ba040SMatthew G. Knepley }
37930a6ba040SMatthew G. Knepley 
37949318fe57SMatthew G. Knepley /*@
3795a1cb98faSBarry Smith   DMPlexCreateReferenceCell - Create a `DMPLEX` with the appropriate FEM reference cell
37969318fe57SMatthew G. Knepley 
37979318fe57SMatthew G. Knepley   Collective
37989318fe57SMatthew G. Knepley 
37999318fe57SMatthew G. Knepley   Input Parameters:
38009318fe57SMatthew G. Knepley + comm - The communicator
38019318fe57SMatthew G. Knepley - ct   - The cell type of the reference cell
38029318fe57SMatthew G. Knepley 
38039318fe57SMatthew G. Knepley   Output Parameter:
38049318fe57SMatthew G. Knepley . refdm - The reference cell
38059318fe57SMatthew G. Knepley 
38069318fe57SMatthew G. Knepley   Level: intermediate
38079318fe57SMatthew G. Knepley 
380842747ad1SJacob Faibussowitsch .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBoxMesh()`
38099318fe57SMatthew G. Knepley @*/
3810d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateReferenceCell(MPI_Comm comm, DMPolytopeType ct, DM *refdm)
3811d71ae5a4SJacob Faibussowitsch {
38120a6ba040SMatthew G. Knepley   PetscFunctionBegin;
38139566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, refdm));
38149566063dSJacob Faibussowitsch   PetscCall(DMSetType(*refdm, DMPLEX));
38159566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateReferenceCell_Internal(*refdm, ct));
38163ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
38179318fe57SMatthew G. Knepley }
381879a015ccSMatthew G. Knepley 
3819d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoundaryLabel_Private(DM dm, const char name[])
3820d71ae5a4SJacob Faibussowitsch {
38219318fe57SMatthew G. Knepley   DM        plex;
38229318fe57SMatthew G. Knepley   DMLabel   label;
38239318fe57SMatthew G. Knepley   PetscBool hasLabel;
38240a6ba040SMatthew G. Knepley 
3825c22d3578SMatthew G. Knepley   PetscFunctionBegin;
38269566063dSJacob Faibussowitsch   PetscCall(DMHasLabel(dm, name, &hasLabel));
38273ba16761SJacob Faibussowitsch   if (hasLabel) PetscFunctionReturn(PETSC_SUCCESS);
38289566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, name));
38299566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, name, &label));
38309566063dSJacob Faibussowitsch   PetscCall(DMConvert(dm, DMPLEX, &plex));
38319566063dSJacob Faibussowitsch   PetscCall(DMPlexMarkBoundaryFaces(plex, 1, label));
38321c8afea9SMatthew G. Knepley   PetscCall(DMPlexLabelComplete(plex, label));
38339566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&plex));
38343ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
38359318fe57SMatthew G. Knepley }
3836acdc6f61SToby Isaac 
3837669647acSMatthew G. Knepley /*
3838669647acSMatthew G. Knepley   We use the last coordinate as the radius, the inner radius is lower[dim-1] and the outer radius is upper[dim-1]. Then we map the first coordinate around the circle.
3839669647acSMatthew G. Knepley 
3840669647acSMatthew G. Knepley     (x, y) -> (r, theta) = (x[1], (x[0] - lower[0]) * 2\pi/(upper[0] - lower[0]))
3841669647acSMatthew G. Knepley */
3842d71ae5a4SJacob Faibussowitsch static void boxToAnnulus(PetscInt dim, PetscInt Nf, PetscInt NfAux, const PetscInt uOff[], const PetscInt uOff_x[], const PetscScalar u[], const PetscScalar u_t[], const PetscScalar u_x[], const PetscInt aOff[], const PetscInt aOff_x[], const PetscScalar a[], const PetscScalar a_t[], const PetscScalar a_x[], PetscReal t, const PetscReal x[], PetscInt numConstants, const PetscScalar constants[], PetscScalar f0[])
3843d71ae5a4SJacob Faibussowitsch {
3844669647acSMatthew G. Knepley   const PetscReal low = PetscRealPart(constants[0]);
3845669647acSMatthew G. Knepley   const PetscReal upp = PetscRealPart(constants[1]);
3846669647acSMatthew G. Knepley   const PetscReal r   = PetscRealPart(u[1]);
3847669647acSMatthew G. Knepley   const PetscReal th  = 2. * PETSC_PI * (PetscRealPart(u[0]) - low) / (upp - low);
3848669647acSMatthew G. Knepley 
3849669647acSMatthew G. Knepley   f0[0] = r * PetscCosReal(th);
3850669647acSMatthew G. Knepley   f0[1] = r * PetscSinReal(th);
3851669647acSMatthew G. Knepley }
3852669647acSMatthew G. Knepley 
38535dca41c3SJed Brown const char *const DMPlexShapes[] = {"box", "box_surface", "ball", "sphere", "cylinder", "schwarz_p", "gyroid", "doublet", "annulus", "hypercubic", "zbox", "unknown", "DMPlexShape", "DM_SHAPE_", NULL};
38549318fe57SMatthew G. Knepley 
3855d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateFromOptions_Internal(PetscOptionItems *PetscOptionsObject, PetscBool *useCoordSpace, DM dm)
3856d71ae5a4SJacob Faibussowitsch {
38579318fe57SMatthew G. Knepley   DMPlexShape    shape   = DM_SHAPE_BOX;
38589318fe57SMatthew G. Knepley   DMPolytopeType cell    = DM_POLYTOPE_TRIANGLE;
38599318fe57SMatthew G. Knepley   PetscInt       dim     = 2;
38609318fe57SMatthew G. Knepley   PetscBool      simplex = PETSC_TRUE, interpolate = PETSC_TRUE, adjCone = PETSC_FALSE, adjClosure = PETSC_TRUE, refDomain = PETSC_FALSE;
3861cd7e8a5eSksagiyam   PetscBool      flg, flg2, fflg, bdfflg, nameflg;
38629318fe57SMatthew G. Knepley   MPI_Comm       comm;
3863ed5e4e85SVaclav Hapla   char           filename[PETSC_MAX_PATH_LEN]   = "<unspecified>";
3864ed5e4e85SVaclav Hapla   char           bdFilename[PETSC_MAX_PATH_LEN] = "<unspecified>";
3865ed5e4e85SVaclav Hapla   char           plexname[PETSC_MAX_PATH_LEN]   = "";
38669318fe57SMatthew G. Knepley 
38679318fe57SMatthew G. Knepley   PetscFunctionBegin;
3868708be2fdSJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_CreateFromOptions, dm, 0, 0, 0));
38699566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)dm, &comm));
38709318fe57SMatthew G. Knepley   /* TODO Turn this into a registration interface */
38719566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_filename", "File containing a mesh", "DMPlexCreateFromFile", filename, filename, sizeof(filename), &fflg));
38729566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_boundary_filename", "File containing a mesh boundary", "DMPlexCreateFromFile", bdFilename, bdFilename, sizeof(bdFilename), &bdfflg));
38739566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_name", "Name of the mesh in the file", "DMPlexCreateFromFile", plexname, plexname, sizeof(plexname), &nameflg));
38749566063dSJacob Faibussowitsch   PetscCall(PetscOptionsEnum("-dm_plex_cell", "Cell shape", "", DMPolytopeTypes, (PetscEnum)cell, (PetscEnum *)&cell, NULL));
38759566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_reference_cell_domain", "Use a reference cell domain", "", refDomain, &refDomain, NULL));
38769566063dSJacob Faibussowitsch   PetscCall(PetscOptionsEnum("-dm_plex_shape", "Shape for built-in mesh", "", DMPlexShapes, (PetscEnum)shape, (PetscEnum *)&shape, &flg));
38779566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_plex_dim", "Topological dimension of the mesh", "DMGetDimension", dim, &dim, &flg, 0));
3878cfb853baSMatthew G. Knepley   PetscCheck(dim >= 0, comm, PETSC_ERR_ARG_OUTOFRANGE, "Dimension %" PetscInt_FMT " should be in [0, infinity)", dim);
38799566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_simplex", "Mesh cell shape", "", simplex, &simplex, &flg));
38809566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_interpolate", "Flag to create edges and faces automatically", "", interpolate, &interpolate, &flg));
38819566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_adj_cone", "Set adjacency direction", "DMSetBasicAdjacency", adjCone, &adjCone, &flg));
38829566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_adj_closure", "Set adjacency size", "DMSetBasicAdjacency", adjClosure, &adjClosure, &flg2));
38839566063dSJacob Faibussowitsch   if (flg || flg2) PetscCall(DMSetBasicAdjacency(dm, adjCone, adjClosure));
38849318fe57SMatthew G. Knepley 
388561a622f3SMatthew G. Knepley   switch (cell) {
388661a622f3SMatthew G. Knepley   case DM_POLYTOPE_POINT:
388761a622f3SMatthew G. Knepley   case DM_POLYTOPE_SEGMENT:
388861a622f3SMatthew G. Knepley   case DM_POLYTOPE_POINT_PRISM_TENSOR:
388961a622f3SMatthew G. Knepley   case DM_POLYTOPE_TRIANGLE:
389061a622f3SMatthew G. Knepley   case DM_POLYTOPE_QUADRILATERAL:
389161a622f3SMatthew G. Knepley   case DM_POLYTOPE_TETRAHEDRON:
3892d71ae5a4SJacob Faibussowitsch   case DM_POLYTOPE_HEXAHEDRON:
3893d71ae5a4SJacob Faibussowitsch     *useCoordSpace = PETSC_TRUE;
3894d71ae5a4SJacob Faibussowitsch     break;
3895d71ae5a4SJacob Faibussowitsch   default:
3896d71ae5a4SJacob Faibussowitsch     *useCoordSpace = PETSC_FALSE;
3897d71ae5a4SJacob Faibussowitsch     break;
389861a622f3SMatthew G. Knepley   }
389961a622f3SMatthew G. Knepley 
39009318fe57SMatthew G. Knepley   if (fflg) {
39019318fe57SMatthew G. Knepley     DM dmnew;
39029318fe57SMatthew G. Knepley 
39039566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromFile(PetscObjectComm((PetscObject)dm), filename, plexname, interpolate, &dmnew));
39045de52c6dSVaclav Hapla     PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
390569d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmnew));
39069318fe57SMatthew G. Knepley   } else if (refDomain) {
39079566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateReferenceCell_Internal(dm, cell));
39089318fe57SMatthew G. Knepley   } else if (bdfflg) {
39099318fe57SMatthew G. Knepley     DM bdm, dmnew;
39109318fe57SMatthew G. Knepley 
39119566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromFile(PetscObjectComm((PetscObject)dm), bdFilename, plexname, interpolate, &bdm));
39129566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)bdm, "bd_"));
39139566063dSJacob Faibussowitsch     PetscCall(DMSetFromOptions(bdm));
39149566063dSJacob Faibussowitsch     PetscCall(DMPlexGenerate(bdm, NULL, interpolate, &dmnew));
39159566063dSJacob Faibussowitsch     PetscCall(DMDestroy(&bdm));
39165de52c6dSVaclav Hapla     PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
391769d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmnew));
39189318fe57SMatthew G. Knepley   } else {
39199566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)dm, DMPlexShapes[shape]));
39209318fe57SMatthew G. Knepley     switch (shape) {
3921669647acSMatthew G. Knepley     case DM_SHAPE_BOX:
39225dca41c3SJed Brown     case DM_SHAPE_ZBOX:
3923669647acSMatthew G. Knepley     case DM_SHAPE_ANNULUS: {
39249318fe57SMatthew G. Knepley       PetscInt       faces[3]  = {0, 0, 0};
39259318fe57SMatthew G. Knepley       PetscReal      lower[3]  = {0, 0, 0};
39269318fe57SMatthew G. Knepley       PetscReal      upper[3]  = {1, 1, 1};
39279318fe57SMatthew G. Knepley       DMBoundaryType bdt[3]    = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
3928669647acSMatthew G. Knepley       PetscBool      isAnnular = shape == DM_SHAPE_ANNULUS ? PETSC_TRUE : PETSC_FALSE;
39299318fe57SMatthew G. Knepley       PetscInt       i, n;
39309318fe57SMatthew G. Knepley 
39319318fe57SMatthew G. Knepley       n = dim;
39329318fe57SMatthew G. Knepley       for (i = 0; i < dim; ++i) faces[i] = (dim == 1 ? 1 : 4 - dim);
39339566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", faces, &n, &flg));
39349318fe57SMatthew G. Knepley       n = 3;
39359566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
393663a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Lower box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
39379318fe57SMatthew G. Knepley       n = 3;
39389566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
393963a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Upper box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
39409318fe57SMatthew G. Knepley       n = 3;
39419566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnumArray("-dm_plex_box_bd", "Boundary type for each dimension", "", DMBoundaryTypes, (PetscEnum *)bdt, &n, &flg));
394263a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Box boundary types had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
3943669647acSMatthew G. Knepley 
3944669647acSMatthew G. Knepley       PetscCheck(!isAnnular || dim == 2, comm, PETSC_ERR_ARG_OUTOFRANGE, "Only two dimensional annuli have been implemented");
3945669647acSMatthew G. Knepley       if (isAnnular)
3946669647acSMatthew G. Knepley         for (i = 0; i < dim - 1; ++i) bdt[i] = DM_BOUNDARY_PERIODIC;
3947669647acSMatthew G. Knepley 
39489318fe57SMatthew G. Knepley       switch (cell) {
394961a622f3SMatthew G. Knepley       case DM_POLYTOPE_TRI_PRISM_TENSOR:
39509566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateWedgeBoxMesh_Internal(dm, faces, lower, upper, bdt));
3951d410b0cfSMatthew G. Knepley         if (!interpolate) {
3952d410b0cfSMatthew G. Knepley           DM udm;
3953d410b0cfSMatthew G. Knepley 
39549566063dSJacob Faibussowitsch           PetscCall(DMPlexUninterpolate(dm, &udm));
395569d8a87bSksagiyam           PetscCall(DMPlexReplace_Internal(dm, &udm));
3956d410b0cfSMatthew G. Knepley         }
39579318fe57SMatthew G. Knepley         break;
3958d71ae5a4SJacob Faibussowitsch       default:
39595dca41c3SJed Brown         PetscCall(DMPlexCreateBoxMesh_Internal(dm, shape, dim, simplex, faces, lower, upper, bdt, interpolate));
3960d71ae5a4SJacob Faibussowitsch         break;
39619318fe57SMatthew G. Knepley       }
3962669647acSMatthew G. Knepley       if (isAnnular) {
3963669647acSMatthew G. Knepley         DM          cdm;
3964669647acSMatthew G. Knepley         PetscDS     cds;
3965669647acSMatthew G. Knepley         PetscScalar bounds[2] = {lower[0], upper[0]};
3966669647acSMatthew G. Knepley 
3967669647acSMatthew G. Knepley         // Fix coordinates for annular region
3968669647acSMatthew G. Knepley         PetscCall(DMSetPeriodicity(dm, NULL, NULL, NULL));
3969669647acSMatthew G. Knepley         PetscCall(DMSetCellCoordinatesLocal(dm, NULL));
3970669647acSMatthew G. Knepley         PetscCall(DMSetCellCoordinates(dm, NULL));
3971e44f6aebSMatthew G. Knepley         PetscCall(DMPlexCreateCoordinateSpace(dm, 1, PETSC_TRUE, NULL));
3972669647acSMatthew G. Knepley         PetscCall(DMGetCoordinateDM(dm, &cdm));
3973669647acSMatthew G. Knepley         PetscCall(DMGetDS(cdm, &cds));
3974669647acSMatthew G. Knepley         PetscCall(PetscDSSetConstants(cds, 2, bounds));
3975669647acSMatthew G. Knepley         PetscCall(DMPlexRemapGeometry(dm, 0.0, boxToAnnulus));
3976669647acSMatthew G. Knepley       }
39779371c9d4SSatish Balay     } break;
39789371c9d4SSatish Balay     case DM_SHAPE_BOX_SURFACE: {
39799318fe57SMatthew G. Knepley       PetscInt  faces[3] = {0, 0, 0};
39809318fe57SMatthew G. Knepley       PetscReal lower[3] = {0, 0, 0};
39819318fe57SMatthew G. Knepley       PetscReal upper[3] = {1, 1, 1};
39829318fe57SMatthew G. Knepley       PetscInt  i, n;
39839318fe57SMatthew G. Knepley 
39849318fe57SMatthew G. Knepley       n = dim + 1;
39859318fe57SMatthew G. Knepley       for (i = 0; i < dim + 1; ++i) faces[i] = (dim + 1 == 1 ? 1 : 4 - (dim + 1));
39869566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", faces, &n, &flg));
39879318fe57SMatthew G. Knepley       n = 3;
39889566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
398963a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim + 1), comm, PETSC_ERR_ARG_SIZ, "Lower box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim + 1);
39909318fe57SMatthew G. Knepley       n = 3;
39919566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
399263a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim + 1), comm, PETSC_ERR_ARG_SIZ, "Upper box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim + 1);
39939566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateBoxSurfaceMesh_Internal(dm, dim + 1, faces, lower, upper, interpolate));
39949371c9d4SSatish Balay     } break;
39959371c9d4SSatish Balay     case DM_SHAPE_SPHERE: {
39969318fe57SMatthew G. Knepley       PetscReal R = 1.0;
39979318fe57SMatthew G. Knepley 
39989566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_sphere_radius", "Radius of the sphere", "", R, &R, &flg));
39999566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateSphereMesh_Internal(dm, dim, simplex, R));
40009371c9d4SSatish Balay     } break;
40019371c9d4SSatish Balay     case DM_SHAPE_BALL: {
40029318fe57SMatthew G. Knepley       PetscReal R = 1.0;
40039318fe57SMatthew G. Knepley 
40049566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_ball_radius", "Radius of the ball", "", R, &R, &flg));
40059566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateBallMesh_Internal(dm, dim, R));
40069371c9d4SSatish Balay     } break;
40079371c9d4SSatish Balay     case DM_SHAPE_CYLINDER: {
40089318fe57SMatthew G. Knepley       DMBoundaryType bdt = DM_BOUNDARY_NONE;
40099318fe57SMatthew G. Knepley       PetscInt       Nw  = 6;
40109318fe57SMatthew G. Knepley 
40119566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnum("-dm_plex_cylinder_bd", "Boundary type in the z direction", "", DMBoundaryTypes, (PetscEnum)bdt, (PetscEnum *)&bdt, NULL));
40129566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_cylinder_num_wedges", "Number of wedges around the cylinder", "", Nw, &Nw, NULL));
40139318fe57SMatthew G. Knepley       switch (cell) {
4014d71ae5a4SJacob Faibussowitsch       case DM_POLYTOPE_TRI_PRISM_TENSOR:
4015d71ae5a4SJacob Faibussowitsch         PetscCall(DMPlexCreateWedgeCylinderMesh_Internal(dm, Nw, interpolate));
4016d71ae5a4SJacob Faibussowitsch         break;
4017d71ae5a4SJacob Faibussowitsch       default:
4018d71ae5a4SJacob Faibussowitsch         PetscCall(DMPlexCreateHexCylinderMesh_Internal(dm, bdt));
4019d71ae5a4SJacob Faibussowitsch         break;
40209318fe57SMatthew G. Knepley       }
40219371c9d4SSatish Balay     } break;
4022b7f5c055SJed Brown     case DM_SHAPE_SCHWARZ_P: // fallthrough
40239371c9d4SSatish Balay     case DM_SHAPE_GYROID: {
4024b7f5c055SJed Brown       PetscInt       extent[3] = {1, 1, 1}, refine = 0, layers = 0, three;
4025b7f5c055SJed Brown       PetscReal      thickness   = 0.;
4026b7f5c055SJed Brown       DMBoundaryType periodic[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
4027b7f5c055SJed Brown       DMPlexTPSType  tps_type    = shape == DM_SHAPE_SCHWARZ_P ? DMPLEX_TPS_SCHWARZ_P : DMPLEX_TPS_GYROID;
40281436d7faSJed Brown       PetscBool      tps_distribute;
40299566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_tps_extent", "Number of replicas for each of three dimensions", NULL, extent, (three = 3, &three), NULL));
40309566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_tps_refine", "Number of refinements", NULL, refine, &refine, NULL));
40319566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnumArray("-dm_plex_tps_periodic", "Periodicity in each of three dimensions", NULL, DMBoundaryTypes, (PetscEnum *)periodic, (three = 3, &three), NULL));
40329566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_tps_layers", "Number of layers in volumetric extrusion (or zero to not extrude)", NULL, layers, &layers, NULL));
40339566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_tps_thickness", "Thickness of volumetric extrusion", NULL, thickness, &thickness, NULL));
40349566063dSJacob Faibussowitsch       PetscCall(DMPlexDistributeGetDefault(dm, &tps_distribute));
40359566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_tps_distribute", "Distribute the 2D mesh prior to refinement and extrusion", NULL, tps_distribute, &tps_distribute, NULL));
40369566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateTPSMesh_Internal(dm, tps_type, extent, periodic, tps_distribute, refine, layers, thickness));
40379371c9d4SSatish Balay     } break;
40389371c9d4SSatish Balay     case DM_SHAPE_DOUBLET: {
403905bd46c0SStefano Zampini       DM        dmnew;
404005bd46c0SStefano Zampini       PetscReal rl = 0.0;
404105bd46c0SStefano Zampini 
404205bd46c0SStefano Zampini       PetscCall(PetscOptionsReal("-dm_plex_doublet_refinementlimit", "Refinement limit", NULL, rl, &rl, NULL));
404305bd46c0SStefano Zampini       PetscCall(DMPlexCreateDoublet(PetscObjectComm((PetscObject)dm), dim, simplex, interpolate, rl, &dmnew));
40445de52c6dSVaclav Hapla       PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
404569d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &dmnew));
40469371c9d4SSatish Balay     } break;
4047cfb853baSMatthew G. Knepley     case DM_SHAPE_HYPERCUBIC: {
4048cfb853baSMatthew G. Knepley       PetscInt       *edges;
4049cfb853baSMatthew G. Knepley       PetscReal      *lower, *upper;
4050cfb853baSMatthew G. Knepley       DMBoundaryType *bdt;
4051cfb853baSMatthew G. Knepley       PetscInt        n, d;
4052cfb853baSMatthew G. Knepley 
4053cfb853baSMatthew G. Knepley       *useCoordSpace = PETSC_FALSE;
4054cfb853baSMatthew G. Knepley       PetscCall(PetscMalloc4(dim, &edges, dim, &lower, dim, &upper, dim, &bdt));
4055cfb853baSMatthew G. Knepley       for (d = 0; d < dim; ++d) {
4056cfb853baSMatthew G. Knepley         edges[d] = 1;
4057cfb853baSMatthew G. Knepley         lower[d] = 0.;
4058cfb853baSMatthew G. Knepley         upper[d] = 1.;
4059cfb853baSMatthew G. Knepley         bdt[d]   = DM_BOUNDARY_PERIODIC;
4060cfb853baSMatthew G. Knepley       }
4061cfb853baSMatthew G. Knepley       n = dim;
4062cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", edges, &n, &flg));
4063cfb853baSMatthew G. Knepley       n = dim;
4064cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
4065cfb853baSMatthew G. Knepley       PetscCheck(!flg || n == dim, comm, PETSC_ERR_ARG_SIZ, "Lower box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
4066cfb853baSMatthew G. Knepley       n = dim;
4067cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
4068cfb853baSMatthew G. Knepley       PetscCheck(!flg || n == dim, comm, PETSC_ERR_ARG_SIZ, "Upper box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
4069cfb853baSMatthew G. Knepley       n = dim;
4070cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsEnumArray("-dm_plex_box_bd", "Boundary type for each dimension", "", DMBoundaryTypes, (PetscEnum *)bdt, &n, &flg));
4071cfb853baSMatthew G. Knepley       PetscCheck(!flg || n == dim, comm, PETSC_ERR_ARG_SIZ, "Box boundary types had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
4072cfb853baSMatthew G. Knepley       PetscCall(DMPlexCreateHypercubicMesh_Internal(dm, dim, lower, upper, edges, bdt));
4073cfb853baSMatthew G. Knepley       PetscCall(PetscFree4(edges, lower, upper, bdt));
4074cfb853baSMatthew G. Knepley     } break;
4075d71ae5a4SJacob Faibussowitsch     default:
4076d71ae5a4SJacob Faibussowitsch       SETERRQ(comm, PETSC_ERR_SUP, "Domain shape %s is unsupported", DMPlexShapes[shape]);
40779318fe57SMatthew G. Knepley     }
40789318fe57SMatthew G. Knepley   }
40799566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
408048a46eb9SPierre Jolivet   if (!((PetscObject)dm)->name && nameflg) PetscCall(PetscObjectSetName((PetscObject)dm, plexname));
4081708be2fdSJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_CreateFromOptions, dm, 0, 0, 0));
40823ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
40830a6ba040SMatthew G. Knepley }
40840a6ba040SMatthew G. Knepley 
4085d71ae5a4SJacob Faibussowitsch PetscErrorCode DMSetFromOptions_NonRefinement_Plex(DM dm, PetscOptionItems *PetscOptionsObject)
4086d71ae5a4SJacob Faibussowitsch {
40870a6ba040SMatthew G. Knepley   DM_Plex  *mesh = (DM_Plex *)dm->data;
40887f9d8d6cSVaclav Hapla   PetscBool flg, flg2;
40899318fe57SMatthew G. Knepley   char      bdLabel[PETSC_MAX_PATH_LEN];
40900a6ba040SMatthew G. Knepley 
40910a6ba040SMatthew G. Knepley   PetscFunctionBegin;
40920a6ba040SMatthew G. Knepley   /* Handle viewing */
40939566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_print_set_values", "Output all set values info", "DMPlexMatSetClosure", PETSC_FALSE, &mesh->printSetValues, NULL));
40945962854dSMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_fem", "Debug output level for all fem computations", "DMPlexSNESComputeResidualFEM", 0, &mesh->printFEM, NULL, 0));
40955962854dSMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_fvm", "Debug output level for all fvm computations", "DMPlexSNESComputeResidualFVM", 0, &mesh->printFVM, NULL, 0));
40969566063dSJacob Faibussowitsch   PetscCall(PetscOptionsReal("-dm_plex_print_tol", "Tolerance for FEM output", "DMPlexSNESComputeResidualFEM", mesh->printTol, &mesh->printTol, NULL));
40979566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_l2", "Debug output level all L2 diff computations", "DMComputeL2Diff", 0, &mesh->printL2, NULL, 0));
4098f5867de0SMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_locate", "Debug output level all point location computations", "DMLocatePoints", 0, &mesh->printLocate, NULL, 0));
40999566063dSJacob Faibussowitsch   PetscCall(DMMonitorSetFromOptions(dm, "-dm_plex_monitor_throughput", "Monitor the simulation throughput", "DMPlexMonitorThroughput", DMPlexMonitorThroughput, NULL, &flg));
41009566063dSJacob Faibussowitsch   if (flg) PetscCall(PetscLogDefaultBegin());
41019318fe57SMatthew G. Knepley   /* Labeling */
41029566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_boundary_label", "Label to mark the mesh boundary", "", bdLabel, bdLabel, sizeof(bdLabel), &flg));
41039566063dSJacob Faibussowitsch   if (flg) PetscCall(DMPlexCreateBoundaryLabel_Private(dm, bdLabel));
4104953fc75cSMatthew G. Knepley   /* Point Location */
41059566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_hash_location", "Use grid hashing for point location", "DMInterpolate", PETSC_FALSE, &mesh->useHashLocation, NULL));
41060848f4b5SMatthew G. Knepley   /* Partitioning and distribution */
41079566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_partition_balance", "Attempt to evenly divide points on partition boundary between processes", "DMPlexSetPartitionBalance", PETSC_FALSE, &mesh->partitionBalance, NULL));
41082e62ab5aSMatthew G. Knepley   /* Generation and remeshing */
41099566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_remesh_bd", "Allow changes to the boundary on remeshing", "DMAdapt", PETSC_FALSE, &mesh->remeshBd, NULL));
4110b29cfa1cSToby Isaac   /* Projection behavior */
4111d5b43468SJose E. Roman   PetscCall(PetscOptionsBoundedInt("-dm_plex_max_projection_height", "Maximum mesh point height used to project locally", "DMPlexSetMaxProjectionHeight", 0, &mesh->maxProjectionHeight, NULL, 0));
41129566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_regular_refinement", "Use special nested projection algorithm for regular refinement", "DMPlexSetRegularRefinement", mesh->regularRefinement, &mesh->regularRefinement, NULL));
4113f12cf164SMatthew G. Knepley   /* Checking structure */
4114f12cf164SMatthew G. Knepley   {
41157f9d8d6cSVaclav Hapla     PetscBool all = PETSC_FALSE;
4116f12cf164SMatthew G. Knepley 
41177f9d8d6cSVaclav Hapla     PetscCall(PetscOptionsBool("-dm_plex_check_all", "Perform all basic checks", "DMPlexCheck", PETSC_FALSE, &all, NULL));
41187f9d8d6cSVaclav Hapla     if (all) {
41197f9d8d6cSVaclav Hapla       PetscCall(DMPlexCheck(dm));
41207f9d8d6cSVaclav Hapla     } else {
41219566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_symmetry", "Check that the adjacency information in the mesh is symmetric", "DMPlexCheckSymmetry", PETSC_FALSE, &flg, &flg2));
41227f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckSymmetry(dm));
41239566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_skeleton", "Check that each cell has the correct number of vertices (only for homogeneous simplex or tensor meshes)", "DMPlexCheckSkeleton", PETSC_FALSE, &flg, &flg2));
41247f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckSkeleton(dm, 0));
41259566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_faces", "Check that the faces of each cell give a vertex order this is consistent with what we expect from the cell type", "DMPlexCheckFaces", PETSC_FALSE, &flg, &flg2));
41267f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckFaces(dm, 0));
41279566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_geometry", "Check that cells have positive volume", "DMPlexCheckGeometry", PETSC_FALSE, &flg, &flg2));
41287f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckGeometry(dm));
41299566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_pointsf", "Check some necessary conditions for PointSF", "DMPlexCheckPointSF", PETSC_FALSE, &flg, &flg2));
4130d7d32a9aSMatthew G. Knepley       if (flg && flg2) PetscCall(DMPlexCheckPointSF(dm, NULL, PETSC_FALSE));
41319566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_interface_cones", "Check points on inter-partition interfaces have conforming order of cone points", "DMPlexCheckInterfaceCones", PETSC_FALSE, &flg, &flg2));
41327f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckInterfaceCones(dm));
41337f9d8d6cSVaclav Hapla     }
41349566063dSJacob Faibussowitsch     PetscCall(PetscOptionsBool("-dm_plex_check_cell_shape", "Check cell shape", "DMPlexCheckCellShape", PETSC_FALSE, &flg, &flg2));
41359566063dSJacob Faibussowitsch     if (flg && flg2) PetscCall(DMPlexCheckCellShape(dm, PETSC_TRUE, PETSC_DETERMINE));
4136f12cf164SMatthew G. Knepley   }
41379318fe57SMatthew G. Knepley   {
41389318fe57SMatthew G. Knepley     PetscReal scale = 1.0;
41394f3833eaSMatthew G. Knepley 
41409566063dSJacob Faibussowitsch     PetscCall(PetscOptionsReal("-dm_plex_scale", "Scale factor for mesh coordinates", "DMPlexScale", scale, &scale, &flg));
41419318fe57SMatthew G. Knepley     if (flg) {
41429318fe57SMatthew G. Knepley       Vec coordinates, coordinatesLocal;
41439318fe57SMatthew G. Knepley 
41449566063dSJacob Faibussowitsch       PetscCall(DMGetCoordinates(dm, &coordinates));
41459566063dSJacob Faibussowitsch       PetscCall(DMGetCoordinatesLocal(dm, &coordinatesLocal));
41469566063dSJacob Faibussowitsch       PetscCall(VecScale(coordinates, scale));
41479566063dSJacob Faibussowitsch       PetscCall(VecScale(coordinatesLocal, scale));
41489318fe57SMatthew G. Knepley     }
41499318fe57SMatthew G. Knepley   }
41509566063dSJacob Faibussowitsch   PetscCall(PetscPartitionerSetFromOptions(mesh->partitioner));
41513ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
415268d4fef7SMatthew G. Knepley }
415368d4fef7SMatthew G. Knepley 
4154d71ae5a4SJacob Faibussowitsch PetscErrorCode DMSetFromOptions_Overlap_Plex(DM dm, PetscOptionItems *PetscOptionsObject, PetscInt *overlap)
4155d71ae5a4SJacob Faibussowitsch {
4156c506a872SMatthew G. Knepley   PetscInt  numOvLabels = 16, numOvExLabels = 16;
4157c506a872SMatthew G. Knepley   char     *ovLabelNames[16], *ovExLabelNames[16];
4158c506a872SMatthew G. Knepley   PetscInt  numOvValues = 16, numOvExValues = 16, l;
4159c506a872SMatthew G. Knepley   PetscBool flg;
4160c506a872SMatthew G. Knepley 
4161c506a872SMatthew G. Knepley   PetscFunctionBegin;
4162c506a872SMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_distribute_overlap", "The size of the overlap halo", "DMPlexDistribute", *overlap, overlap, NULL, 0));
4163c506a872SMatthew G. Knepley   PetscCall(PetscOptionsStringArray("-dm_distribute_overlap_labels", "List of overlap label names", "DMPlexDistribute", ovLabelNames, &numOvLabels, &flg));
4164c506a872SMatthew G. Knepley   if (!flg) numOvLabels = 0;
4165c506a872SMatthew G. Knepley   if (numOvLabels) {
4166c506a872SMatthew G. Knepley     ((DM_Plex *)dm->data)->numOvLabels = numOvLabels;
4167c506a872SMatthew G. Knepley     for (l = 0; l < numOvLabels; ++l) {
4168c506a872SMatthew G. Knepley       PetscCall(DMGetLabel(dm, ovLabelNames[l], &((DM_Plex *)dm->data)->ovLabels[l]));
4169c506a872SMatthew G. Knepley       PetscCheck(((DM_Plex *)dm->data)->ovLabels[l], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid label name %s", ovLabelNames[l]);
4170c506a872SMatthew G. Knepley       PetscCall(PetscFree(ovLabelNames[l]));
4171c506a872SMatthew G. Knepley     }
4172c506a872SMatthew G. Knepley     PetscCall(PetscOptionsIntArray("-dm_distribute_overlap_values", "List of overlap label values", "DMPlexDistribute", ((DM_Plex *)dm->data)->ovValues, &numOvValues, &flg));
4173c506a872SMatthew G. Knepley     if (!flg) numOvValues = 0;
4174c506a872SMatthew G. Knepley     PetscCheck(numOvLabels == numOvValues, PETSC_COMM_SELF, PETSC_ERR_ARG_INCOMP, "The number of labels %" PetscInt_FMT " must match the number of values %" PetscInt_FMT, numOvLabels, numOvValues);
4175c506a872SMatthew G. Knepley 
4176c506a872SMatthew G. Knepley     PetscCall(PetscOptionsStringArray("-dm_distribute_overlap_exclude_labels", "List of overlap exclude label names", "DMPlexDistribute", ovExLabelNames, &numOvExLabels, &flg));
4177c506a872SMatthew G. Knepley     if (!flg) numOvExLabels = 0;
4178c506a872SMatthew G. Knepley     ((DM_Plex *)dm->data)->numOvExLabels = numOvExLabels;
4179c506a872SMatthew G. Knepley     for (l = 0; l < numOvExLabels; ++l) {
4180c506a872SMatthew G. Knepley       PetscCall(DMGetLabel(dm, ovExLabelNames[l], &((DM_Plex *)dm->data)->ovExLabels[l]));
4181c506a872SMatthew G. Knepley       PetscCheck(((DM_Plex *)dm->data)->ovExLabels[l], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid label name %s", ovExLabelNames[l]);
4182c506a872SMatthew G. Knepley       PetscCall(PetscFree(ovExLabelNames[l]));
4183c506a872SMatthew G. Knepley     }
4184c506a872SMatthew G. Knepley     PetscCall(PetscOptionsIntArray("-dm_distribute_overlap_exclude_values", "List of overlap exclude label values", "DMPlexDistribute", ((DM_Plex *)dm->data)->ovExValues, &numOvExValues, &flg));
4185c506a872SMatthew G. Knepley     if (!flg) numOvExValues = 0;
4186c506a872SMatthew G. Knepley     PetscCheck(numOvExLabels == numOvExValues, PETSC_COMM_SELF, PETSC_ERR_ARG_INCOMP, "The number of exclude labels %" PetscInt_FMT " must match the number of values %" PetscInt_FMT, numOvExLabels, numOvExValues);
4187c506a872SMatthew G. Knepley   }
41883ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4189c506a872SMatthew G. Knepley }
4190c506a872SMatthew G. Knepley 
4191d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMSetFromOptions_Plex(DM dm, PetscOptionItems *PetscOptionsObject)
4192d71ae5a4SJacob Faibussowitsch {
4193bdf63967SMatthew G. Knepley   PetscFunctionList        ordlist;
4194bdf63967SMatthew G. Knepley   char                     oname[256];
4195a286e215SMatthew G. Knepley   DMPlexReorderDefaultFlag reorder;
4196d410b0cfSMatthew G. Knepley   PetscReal                volume    = -1.0;
41979318fe57SMatthew G. Knepley   PetscInt                 prerefine = 0, refine = 0, r, coarsen = 0, overlap = 0, extLayers = 0, dim;
4198a286e215SMatthew G. Knepley   PetscBool uniformOrig = PETSC_FALSE, created = PETSC_FALSE, uniform = PETSC_TRUE, distribute, saveSF = PETSC_FALSE, interpolate = PETSC_TRUE, coordSpace = PETSC_TRUE, remap = PETSC_TRUE, ghostCells = PETSC_FALSE, isHierarchy, ignoreModel = PETSC_FALSE, flg;
419968d4fef7SMatthew G. Knepley 
420068d4fef7SMatthew G. Knepley   PetscFunctionBegin;
4201d0609cedSBarry Smith   PetscOptionsHeadBegin(PetscOptionsObject, "DMPlex Options");
4202dd4c3f67SMatthew G. Knepley   if (dm->cloneOpts) goto non_refine;
42039318fe57SMatthew G. Knepley   /* Handle automatic creation */
42049566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
42056bc1bd01Sksagiyam   if (dim < 0) {
42066bc1bd01Sksagiyam     PetscCall(DMPlexCreateFromOptions_Internal(PetscOptionsObject, &coordSpace, dm));
42076bc1bd01Sksagiyam     created = PETSC_TRUE;
42086bc1bd01Sksagiyam   }
42096bc1bd01Sksagiyam   PetscCall(DMGetDimension(dm, &dim));
4210d89e6e46SMatthew G. Knepley   /* Handle interpolation before distribution */
42119566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_interpolate_pre", "Flag to interpolate mesh before distribution", "", interpolate, &interpolate, &flg));
4212d89e6e46SMatthew G. Knepley   if (flg) {
4213d89e6e46SMatthew G. Knepley     DMPlexInterpolatedFlag interpolated;
4214d89e6e46SMatthew G. Knepley 
42159566063dSJacob Faibussowitsch     PetscCall(DMPlexIsInterpolated(dm, &interpolated));
4216d89e6e46SMatthew G. Knepley     if (interpolated == DMPLEX_INTERPOLATED_FULL && !interpolate) {
4217d89e6e46SMatthew G. Knepley       DM udm;
4218d89e6e46SMatthew G. Knepley 
42199566063dSJacob Faibussowitsch       PetscCall(DMPlexUninterpolate(dm, &udm));
422069d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &udm));
4221d89e6e46SMatthew G. Knepley     } else if (interpolated != DMPLEX_INTERPOLATED_FULL && interpolate) {
4222d89e6e46SMatthew G. Knepley       DM idm;
4223d89e6e46SMatthew G. Knepley 
42249566063dSJacob Faibussowitsch       PetscCall(DMPlexInterpolate(dm, &idm));
422569d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &idm));
4226d89e6e46SMatthew G. Knepley     }
4227d89e6e46SMatthew G. Knepley   }
42289b44eab4SMatthew G. Knepley   /* Handle DMPlex refinement before distribution */
42299566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_ignore_model", "Flag to ignore the geometry model when refining", "DMCreate", ignoreModel, &ignoreModel, &flg));
4230ad540459SPierre Jolivet   if (flg) ((DM_Plex *)dm->data)->ignoreModel = ignoreModel;
42319566063dSJacob Faibussowitsch   PetscCall(DMPlexGetRefinementUniform(dm, &uniformOrig));
42329566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine_pre", "The number of refinements before distribution", "DMCreate", prerefine, &prerefine, NULL, 0));
42339566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_remap_pre", "Flag to control coordinate remapping", "DMCreate", remap, &remap, NULL));
42349566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_uniform_pre", "Flag for uniform refinement before distribution", "DMCreate", uniform, &uniform, &flg));
42359566063dSJacob Faibussowitsch   if (flg) PetscCall(DMPlexSetRefinementUniform(dm, uniform));
42369566063dSJacob Faibussowitsch   PetscCall(PetscOptionsReal("-dm_refine_volume_limit_pre", "The maximum cell volume after refinement before distribution", "DMCreate", volume, &volume, &flg));
42379318fe57SMatthew G. Knepley   if (flg) {
42389566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementUniform(dm, PETSC_FALSE));
42399566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementLimit(dm, volume));
42409318fe57SMatthew G. Knepley     prerefine = PetscMax(prerefine, 1);
42419318fe57SMatthew G. Knepley   }
42429b44eab4SMatthew G. Knepley   for (r = 0; r < prerefine; ++r) {
42439b44eab4SMatthew G. Knepley     DM             rdm;
42449b44eab4SMatthew G. Knepley     PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
42459b44eab4SMatthew G. Knepley 
4246dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
42479566063dSJacob Faibussowitsch     PetscCall(DMRefine(dm, PetscObjectComm((PetscObject)dm), &rdm));
424869d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &rdm));
4249dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
425061a622f3SMatthew G. Knepley     if (coordFunc && remap) {
42519566063dSJacob Faibussowitsch       PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
42529b44eab4SMatthew G. Knepley       ((DM_Plex *)dm->data)->coordFunc = coordFunc;
42539b44eab4SMatthew G. Knepley     }
42549b44eab4SMatthew G. Knepley   }
42559566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, uniformOrig));
42569318fe57SMatthew G. Knepley   /* Handle DMPlex extrusion before distribution */
42579566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_extrude", "The number of layers to extrude", "", extLayers, &extLayers, NULL, 0));
42589318fe57SMatthew G. Knepley   if (extLayers) {
42599318fe57SMatthew G. Knepley     DM edm;
42609318fe57SMatthew G. Knepley 
42619566063dSJacob Faibussowitsch     PetscCall(DMExtrude(dm, extLayers, &edm));
426269d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &edm));
426348d16a33SMatthew G. Knepley     ((DM_Plex *)dm->data)->coordFunc = NULL;
4264dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4265d410b0cfSMatthew G. Knepley     extLayers = 0;
42665e17fc22SAidan Hamilton     PetscCall(DMGetDimension(dm, &dim));
42679318fe57SMatthew G. Knepley   }
4268bdf63967SMatthew G. Knepley   /* Handle DMPlex reordering before distribution */
42696bc1bd01Sksagiyam   PetscCall(DMPlexReorderGetDefault(dm, &reorder));
42709566063dSJacob Faibussowitsch   PetscCall(MatGetOrderingList(&ordlist));
42716bc1bd01Sksagiyam   PetscCall(PetscStrncpy(oname, MATORDERINGNATURAL, sizeof(oname)));
42729566063dSJacob Faibussowitsch   PetscCall(PetscOptionsFList("-dm_plex_reorder", "Set mesh reordering type", "DMPlexGetOrdering", ordlist, MATORDERINGNATURAL, oname, sizeof(oname), &flg));
42736bc1bd01Sksagiyam   if (reorder == DMPLEX_REORDER_DEFAULT_TRUE || flg) {
4274bdf63967SMatthew G. Knepley     DM pdm;
4275bdf63967SMatthew G. Knepley     IS perm;
4276bdf63967SMatthew G. Knepley 
42779566063dSJacob Faibussowitsch     PetscCall(DMPlexGetOrdering(dm, oname, NULL, &perm));
42789566063dSJacob Faibussowitsch     PetscCall(DMPlexPermute(dm, perm, &pdm));
42799566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&perm));
428069d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &pdm));
4281dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4282bdf63967SMatthew G. Knepley   }
42839b44eab4SMatthew G. Knepley   /* Handle DMPlex distribution */
42849566063dSJacob Faibussowitsch   PetscCall(DMPlexDistributeGetDefault(dm, &distribute));
4285c506a872SMatthew G. Knepley   PetscCall(PetscOptionsBool("-dm_distribute", "Flag to redistribute a mesh among processes", "DMPlexDistribute", distribute, &distribute, NULL));
4286a286e215SMatthew G. Knepley   PetscCall(PetscOptionsBool("-dm_distribute_save_sf", "Flag to save the migration SF", "DMPlexSetMigrationSF", saveSF, &saveSF, NULL));
4287dbbe0bcdSBarry Smith   PetscCall(DMSetFromOptions_Overlap_Plex(dm, PetscOptionsObject, &overlap));
42889b44eab4SMatthew G. Knepley   if (distribute) {
42899b44eab4SMatthew G. Knepley     DM               pdm = NULL;
42909b44eab4SMatthew G. Knepley     PetscPartitioner part;
4291a286e215SMatthew G. Knepley     PetscSF          sfMigration;
42929b44eab4SMatthew G. Knepley 
42939566063dSJacob Faibussowitsch     PetscCall(DMPlexGetPartitioner(dm, &part));
42949566063dSJacob Faibussowitsch     PetscCall(PetscPartitionerSetFromOptions(part));
4295a286e215SMatthew G. Knepley     PetscCall(DMPlexDistribute(dm, overlap, &sfMigration, &pdm));
429648a46eb9SPierre Jolivet     if (pdm) PetscCall(DMPlexReplace_Internal(dm, &pdm));
4297a286e215SMatthew G. Knepley     if (saveSF) PetscCall(DMPlexSetMigrationSF(dm, sfMigration));
4298a286e215SMatthew G. Knepley     PetscCall(PetscSFDestroy(&sfMigration));
42999b44eab4SMatthew G. Knepley   }
4300d2b2dc1eSMatthew G. Knepley   /* Must check CEED options before creating function space for coordinates */
4301d2b2dc1eSMatthew G. Knepley   {
4302d2b2dc1eSMatthew G. Knepley     PetscBool useCeed = PETSC_FALSE, flg;
4303d2b2dc1eSMatthew G. Knepley 
4304d2b2dc1eSMatthew G. Knepley     PetscCall(PetscOptionsBool("-dm_plex_use_ceed", "Use LibCEED as the FEM backend", "DMPlexSetUseCeed", useCeed, &useCeed, &flg));
4305d2b2dc1eSMatthew G. Knepley     if (flg) PetscCall(DMPlexSetUseCeed(dm, useCeed));
4306d2b2dc1eSMatthew G. Knepley   }
43079318fe57SMatthew G. Knepley   /* Create coordinate space */
43089318fe57SMatthew G. Knepley   if (created) {
430961a622f3SMatthew G. Knepley     DM_Plex  *mesh   = (DM_Plex *)dm->data;
4310e44f6aebSMatthew G. Knepley     PetscInt  degree = 1, deg;
43115515ebd3SMatthew G. Knepley     PetscInt  height = 0;
43125515ebd3SMatthew G. Knepley     DM        cdm;
43136858538eSMatthew G. Knepley     PetscBool flg;
43149318fe57SMatthew G. Knepley 
43159566063dSJacob Faibussowitsch     PetscCall(PetscOptionsBool("-dm_coord_space", "Use an FEM space for coordinates", "", coordSpace, &coordSpace, &flg));
43169566063dSJacob Faibussowitsch     PetscCall(PetscOptionsInt("-dm_coord_petscspace_degree", "FEM degree for coordinate space", "", degree, &degree, NULL));
4317e44f6aebSMatthew G. Knepley     PetscCall(DMGetCoordinateDegree_Internal(dm, &deg));
4318e44f6aebSMatthew G. Knepley     if (coordSpace && deg <= 1) PetscCall(DMPlexCreateCoordinateSpace(dm, degree, PETSC_TRUE, mesh->coordFunc));
43195515ebd3SMatthew G. Knepley     PetscCall(DMGetCoordinateDM(dm, &cdm));
432061a622f3SMatthew G. Knepley     if (flg && !coordSpace) {
432161a622f3SMatthew G. Knepley       PetscDS      cds;
432261a622f3SMatthew G. Knepley       PetscObject  obj;
432361a622f3SMatthew G. Knepley       PetscClassId id;
432461a622f3SMatthew G. Knepley 
43259566063dSJacob Faibussowitsch       PetscCall(DMGetDS(cdm, &cds));
43269566063dSJacob Faibussowitsch       PetscCall(PetscDSGetDiscretization(cds, 0, &obj));
43279566063dSJacob Faibussowitsch       PetscCall(PetscObjectGetClassId(obj, &id));
432861a622f3SMatthew G. Knepley       if (id == PETSCFE_CLASSID) {
432961a622f3SMatthew G. Knepley         PetscContainer dummy;
433061a622f3SMatthew G. Knepley 
43319566063dSJacob Faibussowitsch         PetscCall(PetscContainerCreate(PETSC_COMM_SELF, &dummy));
43329566063dSJacob Faibussowitsch         PetscCall(PetscObjectSetName((PetscObject)dummy, "coordinates"));
43339566063dSJacob Faibussowitsch         PetscCall(DMSetField(cdm, 0, NULL, (PetscObject)dummy));
43349566063dSJacob Faibussowitsch         PetscCall(PetscContainerDestroy(&dummy));
43359566063dSJacob Faibussowitsch         PetscCall(DMClearDS(cdm));
433661a622f3SMatthew G. Knepley       }
433761a622f3SMatthew G. Knepley       mesh->coordFunc = NULL;
433861a622f3SMatthew G. Knepley     }
43396858538eSMatthew G. Knepley     PetscCall(PetscOptionsBool("-dm_sparse_localize", "Localize only necessary cells", "", dm->sparseLocalize, &dm->sparseLocalize, &flg));
43405515ebd3SMatthew G. Knepley     PetscCall(PetscOptionsInt("-dm_localize_height", "Localize edges and faces in addition to cells", "", height, &height, &flg));
43415515ebd3SMatthew G. Knepley     if (flg) PetscCall(DMPlexSetMaxProjectionHeight(cdm, height));
43429566063dSJacob Faibussowitsch     PetscCall(DMLocalizeCoordinates(dm));
43439318fe57SMatthew G. Knepley   }
434468d4fef7SMatthew G. Knepley   /* Handle DMPlex refinement */
434561a622f3SMatthew G. Knepley   remap = PETSC_TRUE;
43469566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine", "The number of uniform refinements", "DMCreate", refine, &refine, NULL, 0));
43479566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_remap", "Flag to control coordinate remapping", "DMCreate", remap, &remap, NULL));
43489566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine_hierarchy", "The number of uniform refinements", "DMCreate", refine, &refine, &isHierarchy, 0));
43499566063dSJacob Faibussowitsch   if (refine) PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
435068d4fef7SMatthew G. Knepley   if (refine && isHierarchy) {
4351acdc6f61SToby Isaac     DM *dms, coarseDM;
435268d4fef7SMatthew G. Knepley 
43539566063dSJacob Faibussowitsch     PetscCall(DMGetCoarseDM(dm, &coarseDM));
43549566063dSJacob Faibussowitsch     PetscCall(PetscObjectReference((PetscObject)coarseDM));
43559566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(refine, &dms));
43569566063dSJacob Faibussowitsch     PetscCall(DMRefineHierarchy(dm, refine, dms));
435768d4fef7SMatthew G. Knepley     /* Total hack since we do not pass in a pointer */
43589566063dSJacob Faibussowitsch     PetscCall(DMPlexSwap_Static(dm, dms[refine - 1]));
435968d4fef7SMatthew G. Knepley     if (refine == 1) {
43609566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dm, dms[0]));
43619566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dm, PETSC_TRUE));
436268d4fef7SMatthew G. Knepley     } else {
43639566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dm, dms[refine - 2]));
43649566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dm, PETSC_TRUE));
43659566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dms[0], dms[refine - 1]));
43669566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dms[0], PETSC_TRUE));
436768d4fef7SMatthew G. Knepley     }
43689566063dSJacob Faibussowitsch     PetscCall(DMSetCoarseDM(dms[refine - 1], coarseDM));
43699566063dSJacob Faibussowitsch     PetscCall(PetscObjectDereference((PetscObject)coarseDM));
437068d4fef7SMatthew G. Knepley     /* Free DMs */
437168d4fef7SMatthew G. Knepley     for (r = 0; r < refine; ++r) {
4372dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dms[r], PetscOptionsObject));
43739566063dSJacob Faibussowitsch       PetscCall(DMDestroy(&dms[r]));
437468d4fef7SMatthew G. Knepley     }
43759566063dSJacob Faibussowitsch     PetscCall(PetscFree(dms));
437668d4fef7SMatthew G. Knepley   } else {
437768d4fef7SMatthew G. Knepley     for (r = 0; r < refine; ++r) {
43789318fe57SMatthew G. Knepley       DM             rdm;
437951a74b61SMatthew G. Knepley       PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
438068d4fef7SMatthew G. Knepley 
4381dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
43829566063dSJacob Faibussowitsch       PetscCall(DMRefine(dm, PetscObjectComm((PetscObject)dm), &rdm));
438368d4fef7SMatthew G. Knepley       /* Total hack since we do not pass in a pointer */
438469d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &rdm));
4385dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
438661a622f3SMatthew G. Knepley       if (coordFunc && remap) {
43879566063dSJacob Faibussowitsch         PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
438851a74b61SMatthew G. Knepley         ((DM_Plex *)dm->data)->coordFunc = coordFunc;
438951a74b61SMatthew G. Knepley       }
439068d4fef7SMatthew G. Knepley     }
439168d4fef7SMatthew G. Knepley   }
43923cf6fe12SMatthew G. Knepley   /* Handle DMPlex coarsening */
43939566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_coarsen", "Coarsen the mesh", "DMCreate", coarsen, &coarsen, NULL, 0));
43949566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_coarsen_hierarchy", "The number of coarsenings", "DMCreate", coarsen, &coarsen, &isHierarchy, 0));
4395b653a561SMatthew G. Knepley   if (coarsen && isHierarchy) {
4396b653a561SMatthew G. Knepley     DM *dms;
4397b653a561SMatthew G. Knepley 
43989566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(coarsen, &dms));
43999566063dSJacob Faibussowitsch     PetscCall(DMCoarsenHierarchy(dm, coarsen, dms));
4400b653a561SMatthew G. Knepley     /* Free DMs */
4401b653a561SMatthew G. Knepley     for (r = 0; r < coarsen; ++r) {
4402dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dms[r], PetscOptionsObject));
44039566063dSJacob Faibussowitsch       PetscCall(DMDestroy(&dms[r]));
4404b653a561SMatthew G. Knepley     }
44059566063dSJacob Faibussowitsch     PetscCall(PetscFree(dms));
4406b653a561SMatthew G. Knepley   } else {
4407b653a561SMatthew G. Knepley     for (r = 0; r < coarsen; ++r) {
44089318fe57SMatthew G. Knepley       DM             cdm;
44099318fe57SMatthew G. Knepley       PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
44103cf6fe12SMatthew G. Knepley 
4411dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
44129566063dSJacob Faibussowitsch       PetscCall(DMCoarsen(dm, PetscObjectComm((PetscObject)dm), &cdm));
44133cf6fe12SMatthew G. Knepley       /* Total hack since we do not pass in a pointer */
441469d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &cdm));
4415dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
44169318fe57SMatthew G. Knepley       if (coordFunc) {
44179566063dSJacob Faibussowitsch         PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
44189318fe57SMatthew G. Knepley         ((DM_Plex *)dm->data)->coordFunc = coordFunc;
44199318fe57SMatthew G. Knepley       }
44203cf6fe12SMatthew G. Knepley     }
4421b653a561SMatthew G. Knepley   }
4422909dfd52SMatthew G. Knepley   /* Handle ghost cells */
44239566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_create_fv_ghost_cells", "Flag to create finite volume ghost cells on the boundary", "DMCreate", ghostCells, &ghostCells, NULL));
4424909dfd52SMatthew G. Knepley   if (ghostCells) {
4425909dfd52SMatthew G. Knepley     DM   gdm;
4426909dfd52SMatthew G. Knepley     char lname[PETSC_MAX_PATH_LEN];
4427909dfd52SMatthew G. Knepley 
4428909dfd52SMatthew G. Knepley     lname[0] = '\0';
44299566063dSJacob Faibussowitsch     PetscCall(PetscOptionsString("-dm_plex_fv_ghost_cells_label", "Label name for ghost cells boundary", "DMCreate", lname, lname, sizeof(lname), &flg));
44309566063dSJacob Faibussowitsch     PetscCall(DMPlexConstructGhostCells(dm, flg ? lname : NULL, NULL, &gdm));
443169d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &gdm));
4432909dfd52SMatthew G. Knepley   }
44336913077dSMatthew G. Knepley   /* Handle 1D order */
44346bc1bd01Sksagiyam   if (reorder != DMPLEX_REORDER_DEFAULT_FALSE && dim == 1) {
44356913077dSMatthew G. Knepley     DM           cdm, rdm;
44366913077dSMatthew G. Knepley     PetscDS      cds;
44376913077dSMatthew G. Knepley     PetscObject  obj;
44386913077dSMatthew G. Knepley     PetscClassId id = PETSC_OBJECT_CLASSID;
44396913077dSMatthew G. Knepley     IS           perm;
44406bc1bd01Sksagiyam     PetscInt     Nf;
44416913077dSMatthew G. Knepley     PetscBool    distributed;
44426913077dSMatthew G. Knepley 
44439566063dSJacob Faibussowitsch     PetscCall(DMPlexIsDistributed(dm, &distributed));
44449566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
44459566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
44469566063dSJacob Faibussowitsch     PetscCall(PetscDSGetNumFields(cds, &Nf));
44476913077dSMatthew G. Knepley     if (Nf) {
44489566063dSJacob Faibussowitsch       PetscCall(PetscDSGetDiscretization(cds, 0, &obj));
44499566063dSJacob Faibussowitsch       PetscCall(PetscObjectGetClassId(obj, &id));
44506913077dSMatthew G. Knepley     }
44516bc1bd01Sksagiyam     if (!distributed && id != PETSCFE_CLASSID) {
44529566063dSJacob Faibussowitsch       PetscCall(DMPlexGetOrdering1D(dm, &perm));
44539566063dSJacob Faibussowitsch       PetscCall(DMPlexPermute(dm, perm, &rdm));
445469d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &rdm));
44559566063dSJacob Faibussowitsch       PetscCall(ISDestroy(&perm));
44566913077dSMatthew G. Knepley     }
44576913077dSMatthew G. Knepley   }
44583cf6fe12SMatthew G. Knepley /* Handle */
4459dd4c3f67SMatthew G. Knepley non_refine:
4460dbbe0bcdSBarry Smith   PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4461d0609cedSBarry Smith   PetscOptionsHeadEnd();
44623ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
44630a6ba040SMatthew G. Knepley }
44640a6ba040SMatthew G. Knepley 
4465d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMCreateGlobalVector_Plex(DM dm, Vec *vec)
4466d71ae5a4SJacob Faibussowitsch {
4467552f7358SJed Brown   PetscFunctionBegin;
44689566063dSJacob Faibussowitsch   PetscCall(DMCreateGlobalVector_Section_Private(dm, vec));
44699566063dSJacob Faibussowitsch   /* PetscCall(VecSetOperation(*vec, VECOP_DUPLICATE, (void(*)(void)) VecDuplicate_MPI_DM)); */
44709566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEW, (void (*)(void))VecView_Plex));
44719566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEWNATIVE, (void (*)(void))VecView_Plex_Native));
44729566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOAD, (void (*)(void))VecLoad_Plex));
44739566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOADNATIVE, (void (*)(void))VecLoad_Plex_Native));
44743ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4475552f7358SJed Brown }
4476552f7358SJed Brown 
4477d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMCreateLocalVector_Plex(DM dm, Vec *vec)
4478d71ae5a4SJacob Faibussowitsch {
4479552f7358SJed Brown   PetscFunctionBegin;
44809566063dSJacob Faibussowitsch   PetscCall(DMCreateLocalVector_Section_Private(dm, vec));
44819566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEW, (void (*)(void))VecView_Plex_Local));
44829566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOAD, (void (*)(void))VecLoad_Plex_Local));
44833ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4484552f7358SJed Brown }
4485552f7358SJed Brown 
4486d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMGetDimPoints_Plex(DM dm, PetscInt dim, PetscInt *pStart, PetscInt *pEnd)
4487d71ae5a4SJacob Faibussowitsch {
4488793f3fe5SMatthew G. Knepley   PetscInt depth, d;
4489793f3fe5SMatthew G. Knepley 
4490793f3fe5SMatthew G. Knepley   PetscFunctionBegin;
44919566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepth(dm, &depth));
4492793f3fe5SMatthew G. Knepley   if (depth == 1) {
44939566063dSJacob Faibussowitsch     PetscCall(DMGetDimension(dm, &d));
44949566063dSJacob Faibussowitsch     if (dim == 0) PetscCall(DMPlexGetDepthStratum(dm, dim, pStart, pEnd));
44959566063dSJacob Faibussowitsch     else if (dim == d) PetscCall(DMPlexGetDepthStratum(dm, 1, pStart, pEnd));
44969371c9d4SSatish Balay     else {
44979371c9d4SSatish Balay       *pStart = 0;
44989371c9d4SSatish Balay       *pEnd   = 0;
44999371c9d4SSatish Balay     }
4500793f3fe5SMatthew G. Knepley   } else {
45019566063dSJacob Faibussowitsch     PetscCall(DMPlexGetDepthStratum(dm, dim, pStart, pEnd));
4502793f3fe5SMatthew G. Knepley   }
45033ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4504793f3fe5SMatthew G. Knepley }
4505793f3fe5SMatthew G. Knepley 
4506d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMGetNeighbors_Plex(DM dm, PetscInt *nranks, const PetscMPIInt *ranks[])
4507d71ae5a4SJacob Faibussowitsch {
4508502a2867SDave May   PetscSF            sf;
45090a19bb7dSprj-   PetscInt           niranks, njranks, n;
45100a19bb7dSprj-   const PetscMPIInt *iranks, *jranks;
45110a19bb7dSprj-   DM_Plex           *data = (DM_Plex *)dm->data;
4512502a2867SDave May 
45132f356facSMatthew G. Knepley   PetscFunctionBegin;
45149566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dm, &sf));
45150a19bb7dSprj-   if (!data->neighbors) {
45169566063dSJacob Faibussowitsch     PetscCall(PetscSFSetUp(sf));
45179566063dSJacob Faibussowitsch     PetscCall(PetscSFGetRootRanks(sf, &njranks, &jranks, NULL, NULL, NULL));
45189566063dSJacob Faibussowitsch     PetscCall(PetscSFGetLeafRanks(sf, &niranks, &iranks, NULL, NULL));
45199566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(njranks + niranks + 1, &data->neighbors));
45209566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(data->neighbors + 1, jranks, njranks));
45219566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(data->neighbors + njranks + 1, iranks, niranks));
45220a19bb7dSprj-     n = njranks + niranks;
45239566063dSJacob Faibussowitsch     PetscCall(PetscSortRemoveDupsMPIInt(&n, data->neighbors + 1));
45240a19bb7dSprj-     /* The following cast should never fail: can't have more neighbors than PETSC_MPI_INT_MAX */
45259566063dSJacob Faibussowitsch     PetscCall(PetscMPIIntCast(n, data->neighbors));
45260a19bb7dSprj-   }
45270a19bb7dSprj-   if (nranks) *nranks = data->neighbors[0];
45280a19bb7dSprj-   if (ranks) {
45290a19bb7dSprj-     if (data->neighbors[0]) *ranks = data->neighbors + 1;
45300a19bb7dSprj-     else *ranks = NULL;
45310a19bb7dSprj-   }
45323ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4533502a2867SDave May }
4534502a2867SDave May 
45351eb70e55SToby Isaac PETSC_INTERN PetscErrorCode DMInterpolateSolution_Plex(DM, DM, Mat, Vec, Vec);
45361eb70e55SToby Isaac 
4537d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMInitialize_Plex(DM dm)
4538d71ae5a4SJacob Faibussowitsch {
4539552f7358SJed Brown   PetscFunctionBegin;
4540552f7358SJed Brown   dm->ops->view                      = DMView_Plex;
45412c40f234SMatthew G. Knepley   dm->ops->load                      = DMLoad_Plex;
4542552f7358SJed Brown   dm->ops->setfromoptions            = DMSetFromOptions_Plex;
454338221697SMatthew G. Knepley   dm->ops->clone                     = DMClone_Plex;
4544552f7358SJed Brown   dm->ops->setup                     = DMSetUp_Plex;
45451bb6d2a8SBarry Smith   dm->ops->createlocalsection        = DMCreateLocalSection_Plex;
454666ad2231SToby Isaac   dm->ops->createdefaultconstraints  = DMCreateDefaultConstraints_Plex;
4547552f7358SJed Brown   dm->ops->createglobalvector        = DMCreateGlobalVector_Plex;
4548552f7358SJed Brown   dm->ops->createlocalvector         = DMCreateLocalVector_Plex;
4549184d77edSJed Brown   dm->ops->getlocaltoglobalmapping   = NULL;
45500298fd71SBarry Smith   dm->ops->createfieldis             = NULL;
4551552f7358SJed Brown   dm->ops->createcoordinatedm        = DMCreateCoordinateDM_Plex;
4552f19dbd58SToby Isaac   dm->ops->createcoordinatefield     = DMCreateCoordinateField_Plex;
45530a6ba040SMatthew G. Knepley   dm->ops->getcoloring               = NULL;
4554552f7358SJed Brown   dm->ops->creatematrix              = DMCreateMatrix_Plex;
4555bceba477SMatthew G. Knepley   dm->ops->createinterpolation       = DMCreateInterpolation_Plex;
4556bd041c0cSMatthew G. Knepley   dm->ops->createmassmatrix          = DMCreateMassMatrix_Plex;
4557b4937a87SMatthew G. Knepley   dm->ops->createmassmatrixlumped    = DMCreateMassMatrixLumped_Plex;
45585a84ad33SLisandro Dalcin   dm->ops->createinjection           = DMCreateInjection_Plex;
4559552f7358SJed Brown   dm->ops->refine                    = DMRefine_Plex;
45600a6ba040SMatthew G. Knepley   dm->ops->coarsen                   = DMCoarsen_Plex;
45610a6ba040SMatthew G. Knepley   dm->ops->refinehierarchy           = DMRefineHierarchy_Plex;
4562b653a561SMatthew G. Knepley   dm->ops->coarsenhierarchy          = DMCoarsenHierarchy_Plex;
4563d410b0cfSMatthew G. Knepley   dm->ops->extrude                   = DMExtrude_Plex;
45640298fd71SBarry Smith   dm->ops->globaltolocalbegin        = NULL;
45650298fd71SBarry Smith   dm->ops->globaltolocalend          = NULL;
45660298fd71SBarry Smith   dm->ops->localtoglobalbegin        = NULL;
45670298fd71SBarry Smith   dm->ops->localtoglobalend          = NULL;
4568552f7358SJed Brown   dm->ops->destroy                   = DMDestroy_Plex;
4569552f7358SJed Brown   dm->ops->createsubdm               = DMCreateSubDM_Plex;
45702adcc780SMatthew G. Knepley   dm->ops->createsuperdm             = DMCreateSuperDM_Plex;
4571793f3fe5SMatthew G. Knepley   dm->ops->getdimpoints              = DMGetDimPoints_Plex;
4572552f7358SJed Brown   dm->ops->locatepoints              = DMLocatePoints_Plex;
45730709b2feSToby Isaac   dm->ops->projectfunctionlocal      = DMProjectFunctionLocal_Plex;
45740709b2feSToby Isaac   dm->ops->projectfunctionlabellocal = DMProjectFunctionLabelLocal_Plex;
4575bfc4295aSToby Isaac   dm->ops->projectfieldlocal         = DMProjectFieldLocal_Plex;
45768c6c5593SMatthew G. Knepley   dm->ops->projectfieldlabellocal    = DMProjectFieldLabelLocal_Plex;
4577ece3a9fcSMatthew G. Knepley   dm->ops->projectbdfieldlabellocal  = DMProjectBdFieldLabelLocal_Plex;
45780709b2feSToby Isaac   dm->ops->computel2diff             = DMComputeL2Diff_Plex;
4579b698f381SToby Isaac   dm->ops->computel2gradientdiff     = DMComputeL2GradientDiff_Plex;
45802a16baeaSToby Isaac   dm->ops->computel2fielddiff        = DMComputeL2FieldDiff_Plex;
458128d58a37SPierre Jolivet   dm->ops->getneighbors              = DMGetNeighbors_Plex;
45829566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexInsertBoundaryValues_C", DMPlexInsertBoundaryValues_Plex));
4583*6c51210dSStefano Zampini   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexInsertTimeDerivativeBoundaryValues_C", DMPlexInsertTimeDerivativeBoundaryValues_Plex));
45849566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMSetUpGLVisViewer_C", DMSetUpGLVisViewer_Plex));
45859566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMCreateNeumannOverlap_C", DMCreateNeumannOverlap_Plex));
45869566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetOverlap_C", DMPlexGetOverlap_Plex));
45879566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexDistributeGetDefault_C", DMPlexDistributeGetDefault_Plex));
45889566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexDistributeSetDefault_C", DMPlexDistributeSetDefault_Plex));
45896bc1bd01Sksagiyam   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexReorderGetDefault_C", DMPlexReorderGetDefault_Plex));
45906bc1bd01Sksagiyam   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexReorderSetDefault_C", DMPlexReorderSetDefault_Plex));
45919566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMInterpolateSolution_C", DMInterpolateSolution_Plex));
4592c506a872SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetOverlap_C", DMPlexGetOverlap_Plex));
4593c506a872SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexSetOverlap_C", DMPlexSetOverlap_Plex));
4594d2b2dc1eSMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetUseCeed_C", DMPlexGetUseCeed_Plex));
4595d2b2dc1eSMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexSetUseCeed_C", DMPlexSetUseCeed_Plex));
45963ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4597552f7358SJed Brown }
4598552f7358SJed Brown 
4599d71ae5a4SJacob Faibussowitsch PETSC_INTERN PetscErrorCode DMClone_Plex(DM dm, DM *newdm)
4600d71ae5a4SJacob Faibussowitsch {
460163a16f15SMatthew G. Knepley   DM_Plex *mesh = (DM_Plex *)dm->data;
46026725e60dSJed Brown   PetscSF  face_sf;
460363a16f15SMatthew G. Knepley 
460463a16f15SMatthew G. Knepley   PetscFunctionBegin;
460563a16f15SMatthew G. Knepley   mesh->refct++;
460663a16f15SMatthew G. Knepley   (*newdm)->data = mesh;
46075f06a3ddSJed Brown   PetscCall(DMPlexGetIsoperiodicFaceSF(dm, &face_sf));
46085f06a3ddSJed Brown   PetscCall(DMPlexSetIsoperiodicFaceSF(*newdm, face_sf));
46099566063dSJacob Faibussowitsch   PetscCall(PetscObjectChangeTypeName((PetscObject)*newdm, DMPLEX));
46109566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(*newdm));
46113ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
461263a16f15SMatthew G. Knepley }
461363a16f15SMatthew G. Knepley 
46148818961aSMatthew G Knepley /*MC
4615a1cb98faSBarry Smith   DMPLEX = "plex" - A `DM` object that encapsulates an unstructured mesh, or CW Complex, which can be expressed using a Hasse Diagram.
461620f4b53cSBarry Smith                     In the local representation, `Vec`s contain all unknowns in the interior and shared boundary. This is
46178818961aSMatthew G Knepley                     specified by a PetscSection object. Ownership in the global representation is determined by
4618a1cb98faSBarry Smith                     ownership of the underlying `DMPLEX` points. This is specified by another `PetscSection` object.
46198818961aSMatthew G Knepley 
4620e5893cccSMatthew G. Knepley   Options Database Keys:
4621250712c9SMatthew G. Knepley + -dm_refine_pre                     - Refine mesh before distribution
4622250712c9SMatthew G. Knepley + -dm_refine_uniform_pre             - Choose uniform or generator-based refinement
4623250712c9SMatthew G. Knepley + -dm_refine_volume_limit_pre        - Cell volume limit after pre-refinement using generator
4624250712c9SMatthew G. Knepley . -dm_distribute                     - Distribute mesh across processes
4625250712c9SMatthew G. Knepley . -dm_distribute_overlap             - Number of cells to overlap for distribution
4626250712c9SMatthew G. Knepley . -dm_refine                         - Refine mesh after distribution
4627250712c9SMatthew G. Knepley . -dm_plex_hash_location             - Use grid hashing for point location
4628ddce0771SMatthew G. Knepley . -dm_plex_hash_box_faces <n,m,p>    - The number of divisions in each direction of the grid hash
4629f12cf164SMatthew G. Knepley . -dm_plex_partition_balance         - Attempt to evenly divide points on partition boundary between processes
4630f12cf164SMatthew G. Knepley . -dm_plex_remesh_bd                 - Allow changes to the boundary on remeshing
4631d5b43468SJose E. Roman . -dm_plex_max_projection_height     - Maximum mesh point height used to project locally
4632f12cf164SMatthew G. Knepley . -dm_plex_regular_refinement        - Use special nested projection algorithm for regular refinement
4633aaa8cc7dSPierre Jolivet . -dm_plex_check_all                 - Perform all checks below
4634f12cf164SMatthew G. Knepley . -dm_plex_check_symmetry            - Check that the adjacency information in the mesh is symmetric
4635f12cf164SMatthew G. Knepley . -dm_plex_check_skeleton <celltype> - Check that each cell has the correct number of vertices
4636f12cf164SMatthew G. Knepley . -dm_plex_check_faces <celltype>    - Check that the faces of each cell give a vertex order this is consistent with what we expect from the cell type
4637f12cf164SMatthew G. Knepley . -dm_plex_check_geometry            - Check that cells have positive volume
4638f12cf164SMatthew G. Knepley . -dm_view :mesh.tex:ascii_latex     - View the mesh in LaTeX/TikZ
4639e5893cccSMatthew G. Knepley . -dm_plex_view_scale <num>          - Scale the TikZ
46405962854dSMatthew G. Knepley . -dm_plex_print_fem <num>           - View FEM assembly information, such as element vectors and matrices
46415962854dSMatthew G. Knepley - -dm_plex_print_fvm <num>           - View FVM assembly information, such as flux updates
4642e5893cccSMatthew G. Knepley 
46438818961aSMatthew G Knepley   Level: intermediate
46448818961aSMatthew G Knepley 
46451cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMType`, `DMPlexCreate()`, `DMCreate()`, `DMSetType()`, `PetscSection`
46468818961aSMatthew G Knepley M*/
46478818961aSMatthew G Knepley 
4648d71ae5a4SJacob Faibussowitsch PETSC_EXTERN PetscErrorCode DMCreate_Plex(DM dm)
4649d71ae5a4SJacob Faibussowitsch {
4650552f7358SJed Brown   DM_Plex *mesh;
4651412e9a14SMatthew G. Knepley   PetscInt unit;
4652552f7358SJed Brown 
4653552f7358SJed Brown   PetscFunctionBegin;
4654f39ec787SMatthew G. Knepley   PetscCall(PetscCitationsRegister(PlexCitation, &Plexcite));
4655552f7358SJed Brown   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
46564dfa11a4SJacob Faibussowitsch   PetscCall(PetscNew(&mesh));
4657552f7358SJed Brown   dm->data = mesh;
4658552f7358SJed Brown 
4659552f7358SJed Brown   mesh->refct = 1;
46609566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &mesh->coneSection));
46619566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &mesh->supportSection));
4662552f7358SJed Brown   mesh->refinementUniform      = PETSC_TRUE;
4663552f7358SJed Brown   mesh->refinementLimit        = -1.0;
4664e600fa54SMatthew G. Knepley   mesh->distDefault            = PETSC_TRUE;
46656bc1bd01Sksagiyam   mesh->reorderDefault         = DMPLEX_REORDER_DEFAULT_NOTSET;
46661d1f2f2aSksagiyam   mesh->distributionName       = NULL;
46677d0f5628SVaclav Hapla   mesh->interpolated           = DMPLEX_INTERPOLATED_INVALID;
46687d0f5628SVaclav Hapla   mesh->interpolatedCollective = DMPLEX_INTERPOLATED_INVALID;
4669552f7358SJed Brown 
46709566063dSJacob Faibussowitsch   PetscCall(PetscPartitionerCreate(PetscObjectComm((PetscObject)dm), &mesh->partitioner));
46712e62ab5aSMatthew G. Knepley   mesh->remeshBd = PETSC_FALSE;
4672d9deefdfSMatthew G. Knepley 
46738865f1eaSKarl Rupp   for (unit = 0; unit < NUM_PETSC_UNITS; ++unit) mesh->scale[unit] = 1.0;
4674552f7358SJed Brown 
4675df0420ecSMatthew G. Knepley   mesh->depthState    = -1;
4676ba2698f1SMatthew G. Knepley   mesh->celltypeState = -1;
46776113b454SMatthew G. Knepley   mesh->printTol      = 1.0e-10;
4678552f7358SJed Brown 
46799566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(dm));
46803ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4681552f7358SJed Brown }
4682552f7358SJed Brown 
4683552f7358SJed Brown /*@
4684a1cb98faSBarry Smith   DMPlexCreate - Creates a `DMPLEX` object, which encapsulates an unstructured mesh, or CW complex, which can be expressed using a Hasse Diagram.
4685552f7358SJed Brown 
4686d083f849SBarry Smith   Collective
4687552f7358SJed Brown 
4688552f7358SJed Brown   Input Parameter:
4689a1cb98faSBarry Smith . comm - The communicator for the `DMPLEX` object
4690552f7358SJed Brown 
4691552f7358SJed Brown   Output Parameter:
4692a1cb98faSBarry Smith . mesh - The `DMPLEX` object
4693552f7358SJed Brown 
4694552f7358SJed Brown   Level: beginner
4695552f7358SJed Brown 
469642747ad1SJacob Faibussowitsch .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMType`, `DMCreate()`, `DMSetType()`
4697552f7358SJed Brown @*/
4698d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreate(MPI_Comm comm, DM *mesh)
4699d71ae5a4SJacob Faibussowitsch {
4700552f7358SJed Brown   PetscFunctionBegin;
47014f572ea9SToby Isaac   PetscAssertPointer(mesh, 2);
47029566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, mesh));
47039566063dSJacob Faibussowitsch   PetscCall(DMSetType(*mesh, DMPLEX));
47043ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4705552f7358SJed Brown }
4706552f7358SJed Brown 
4707b09969d6SVaclav Hapla /*@C
4708a1cb98faSBarry Smith   DMPlexBuildFromCellListParallel - Build distributed `DMPLEX` topology from a list of vertices for each cell (common mesh generator output)
4709a1cb98faSBarry Smith 
471020f4b53cSBarry Smith   Collective; No Fortran Support
4711b09969d6SVaclav Hapla 
4712b09969d6SVaclav Hapla   Input Parameters:
4713a1cb98faSBarry Smith + dm          - The `DM`
4714b09969d6SVaclav Hapla . numCells    - The number of cells owned by this process
4715a1cb98faSBarry Smith . numVertices - The number of vertices to be owned by this process, or `PETSC_DECIDE`
4716a1cb98faSBarry Smith . NVertices   - The global number of vertices, or `PETSC_DETERMINE`
4717b09969d6SVaclav Hapla . numCorners  - The number of vertices for each cell
47185e488331SVaclav Hapla - cells       - An array of numCells*numCorners numbers, the global vertex numbers for each cell
4719b09969d6SVaclav Hapla 
4720be8c289dSNicolas Barral   Output Parameters:
4721a1cb98faSBarry Smith + vertexSF         - (Optional) `PetscSF` describing complete vertex ownership
4722be8c289dSNicolas Barral - verticesAdjSaved - (Optional) vertex adjacency array
4723b09969d6SVaclav Hapla 
4724b09969d6SVaclav Hapla   Level: advanced
4725b09969d6SVaclav Hapla 
4726a1cb98faSBarry Smith   Notes:
4727a1cb98faSBarry Smith   Two triangles sharing a face
4728a1cb98faSBarry Smith .vb
4729a1cb98faSBarry Smith 
4730a1cb98faSBarry Smith         2
4731a1cb98faSBarry Smith       / | \
4732a1cb98faSBarry Smith      /  |  \
4733a1cb98faSBarry Smith     /   |   \
4734a1cb98faSBarry Smith    0  0 | 1  3
4735a1cb98faSBarry Smith     \   |   /
4736a1cb98faSBarry Smith      \  |  /
4737a1cb98faSBarry Smith       \ | /
4738a1cb98faSBarry Smith         1
4739a1cb98faSBarry Smith .ve
4740a1cb98faSBarry Smith   would have input
4741a1cb98faSBarry Smith .vb
4742a1cb98faSBarry Smith   numCells = 2, numVertices = 4
4743a1cb98faSBarry Smith   cells = [0 1 2  1 3 2]
4744a1cb98faSBarry Smith .ve
4745a1cb98faSBarry Smith   which would result in the `DMPLEX`
4746a1cb98faSBarry Smith .vb
4747a1cb98faSBarry Smith 
4748a1cb98faSBarry Smith         4
4749a1cb98faSBarry Smith       / | \
4750a1cb98faSBarry Smith      /  |  \
4751a1cb98faSBarry Smith     /   |   \
4752a1cb98faSBarry Smith    2  0 | 1  5
4753a1cb98faSBarry Smith     \   |   /
4754a1cb98faSBarry Smith      \  |  /
4755a1cb98faSBarry Smith       \ | /
4756a1cb98faSBarry Smith         3
4757a1cb98faSBarry Smith .ve
4758a1cb98faSBarry Smith 
4759a1cb98faSBarry Smith   Vertices are implicitly numbered consecutively 0,...,NVertices.
4760a1cb98faSBarry Smith   Each rank owns a chunk of numVertices consecutive vertices.
4761a1cb98faSBarry Smith   If numVertices is `PETSC_DECIDE`, PETSc will distribute them as evenly as possible using PetscLayout.
4762a1cb98faSBarry Smith   If NVertices is `PETSC_DETERMINE` and numVertices is PETSC_DECIDE, NVertices is computed by PETSc as the maximum vertex index in cells + 1.
4763a1cb98faSBarry Smith   If only NVertices is `PETSC_DETERMINE`, it is computed as the sum of numVertices over all ranks.
4764a1cb98faSBarry Smith 
4765a1cb98faSBarry Smith   The cell distribution is arbitrary non-overlapping, independent of the vertex distribution.
4766a1cb98faSBarry Smith 
47671cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildFromCellList()`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildCoordinatesFromCellListParallel()`,
4768a1cb98faSBarry Smith           `PetscSF`
4769b09969d6SVaclav Hapla @*/
4770d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildFromCellListParallel(DM dm, PetscInt numCells, PetscInt numVertices, PetscInt NVertices, PetscInt numCorners, const PetscInt cells[], PetscSF *vertexSF, PetscInt **verticesAdjSaved)
4771d71ae5a4SJacob Faibussowitsch {
47722464107aSksagiyam   PetscSF     sfPoint;
47732464107aSksagiyam   PetscLayout layout;
477482fb893eSVaclav Hapla   PetscInt    numVerticesAdj, *verticesAdj, *cones, c, p;
4775a47d0d45SMatthew G. Knepley 
4776a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
477725b6865aSVaclav Hapla   PetscValidLogicalCollectiveInt(dm, NVertices, 4);
47789566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
477925b6865aSVaclav Hapla   /* Get/check global number of vertices */
478025b6865aSVaclav Hapla   {
478125b6865aSVaclav Hapla     PetscInt       NVerticesInCells, i;
478225b6865aSVaclav Hapla     const PetscInt len = numCells * numCorners;
478325b6865aSVaclav Hapla 
478425b6865aSVaclav Hapla     /* NVerticesInCells = max(cells) + 1 */
478525b6865aSVaclav Hapla     NVerticesInCells = PETSC_MIN_INT;
47869371c9d4SSatish Balay     for (i = 0; i < len; i++)
47879371c9d4SSatish Balay       if (cells[i] > NVerticesInCells) NVerticesInCells = cells[i];
478825b6865aSVaclav Hapla     ++NVerticesInCells;
4789712fec58SPierre Jolivet     PetscCall(MPIU_Allreduce(MPI_IN_PLACE, &NVerticesInCells, 1, MPIU_INT, MPI_MAX, PetscObjectComm((PetscObject)dm)));
479025b6865aSVaclav Hapla 
479125b6865aSVaclav Hapla     if (numVertices == PETSC_DECIDE && NVertices == PETSC_DECIDE) NVertices = NVerticesInCells;
47929371c9d4SSatish Balay     else
47939371c9d4SSatish Balay       PetscCheck(NVertices == PETSC_DECIDE || NVertices >= NVerticesInCells, PetscObjectComm((PetscObject)dm), PETSC_ERR_ARG_WRONG, "Specified global number of vertices %" PetscInt_FMT " must be greater than or equal to the number of vertices in cells %" PetscInt_FMT, NVertices, NVerticesInCells);
479425b6865aSVaclav Hapla   }
47959079aca8SVaclav Hapla   /* Count locally unique vertices */
47969079aca8SVaclav Hapla   {
47979079aca8SVaclav Hapla     PetscHSetI vhash;
47989079aca8SVaclav Hapla     PetscInt   off = 0;
47999079aca8SVaclav Hapla 
48009566063dSJacob Faibussowitsch     PetscCall(PetscHSetICreate(&vhash));
4801a47d0d45SMatthew G. Knepley     for (c = 0; c < numCells; ++c) {
480248a46eb9SPierre Jolivet       for (p = 0; p < numCorners; ++p) PetscCall(PetscHSetIAdd(vhash, cells[c * numCorners + p]));
4803a47d0d45SMatthew G. Knepley     }
48049566063dSJacob Faibussowitsch     PetscCall(PetscHSetIGetSize(vhash, &numVerticesAdj));
48059566063dSJacob Faibussowitsch     if (!verticesAdjSaved) PetscCall(PetscMalloc1(numVerticesAdj, &verticesAdj));
4806ad540459SPierre Jolivet     else verticesAdj = *verticesAdjSaved;
48079566063dSJacob Faibussowitsch     PetscCall(PetscHSetIGetElems(vhash, &off, verticesAdj));
48089566063dSJacob Faibussowitsch     PetscCall(PetscHSetIDestroy(&vhash));
480963a3b9bcSJacob Faibussowitsch     PetscCheck(off == numVerticesAdj, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid number of local vertices %" PetscInt_FMT " should be %" PetscInt_FMT, off, numVerticesAdj);
4810a47d0d45SMatthew G. Knepley   }
48119566063dSJacob Faibussowitsch   PetscCall(PetscSortInt(numVerticesAdj, verticesAdj));
4812a47d0d45SMatthew G. Knepley   /* Create cones */
48139566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, 0, numCells + numVerticesAdj));
48149566063dSJacob Faibussowitsch   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, numCorners));
48159566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm));
48169566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCones(dm, &cones));
4817a47d0d45SMatthew G. Knepley   for (c = 0; c < numCells; ++c) {
4818a47d0d45SMatthew G. Knepley     for (p = 0; p < numCorners; ++p) {
4819a47d0d45SMatthew G. Knepley       const PetscInt gv = cells[c * numCorners + p];
4820a47d0d45SMatthew G. Knepley       PetscInt       lv;
4821a47d0d45SMatthew G. Knepley 
48229079aca8SVaclav Hapla       /* Positions within verticesAdj form 0-based local vertex numbering;
48239079aca8SVaclav Hapla          we need to shift it by numCells to get correct DAG points (cells go first) */
48249566063dSJacob Faibussowitsch       PetscCall(PetscFindInt(gv, numVerticesAdj, verticesAdj, &lv));
482563a3b9bcSJacob Faibussowitsch       PetscCheck(lv >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Could not find global vertex %" PetscInt_FMT " in local connectivity", gv);
4826961cfab0SVaclav Hapla       cones[c * numCorners + p] = lv + numCells;
4827a47d0d45SMatthew G. Knepley     }
4828a47d0d45SMatthew G. Knepley   }
48292464107aSksagiyam   /* Build point sf */
48309566063dSJacob Faibussowitsch   PetscCall(PetscLayoutCreate(PetscObjectComm((PetscObject)dm), &layout));
48319566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetSize(layout, NVertices));
48329566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetLocalSize(layout, numVertices));
48339566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetBlockSize(layout, 1));
48349566063dSJacob Faibussowitsch   PetscCall(PetscSFCreateByMatchingIndices(layout, numVerticesAdj, verticesAdj, NULL, numCells, numVerticesAdj, verticesAdj, NULL, numCells, vertexSF, &sfPoint));
48359566063dSJacob Faibussowitsch   PetscCall(PetscLayoutDestroy(&layout));
48369566063dSJacob Faibussowitsch   if (!verticesAdjSaved) PetscCall(PetscFree(verticesAdj));
48379566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)sfPoint, "point SF"));
48382464107aSksagiyam   if (dm->sf) {
48392464107aSksagiyam     const char *prefix;
48402464107aSksagiyam 
48419566063dSJacob Faibussowitsch     PetscCall(PetscObjectGetOptionsPrefix((PetscObject)dm->sf, &prefix));
48429566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)sfPoint, prefix));
48432464107aSksagiyam   }
48449566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dm, sfPoint));
48459566063dSJacob Faibussowitsch   PetscCall(PetscSFDestroy(&sfPoint));
48469566063dSJacob Faibussowitsch   if (vertexSF) PetscCall(PetscObjectSetName((PetscObject)(*vertexSF), "Vertex Ownership SF"));
4847a47d0d45SMatthew G. Knepley   /* Fill in the rest of the topology structure */
48489566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
48499566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
48509566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
48513ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4852a47d0d45SMatthew G. Knepley }
4853a47d0d45SMatthew G. Knepley 
4854b09969d6SVaclav Hapla /*@C
4855a1cb98faSBarry Smith   DMPlexBuildCoordinatesFromCellListParallel - Build `DM` coordinates from a list of coordinates for each owned vertex (common mesh generator output)
4856a1cb98faSBarry Smith 
485720f4b53cSBarry Smith   Collective; No Fortran Support
4858b09969d6SVaclav Hapla 
4859b09969d6SVaclav Hapla   Input Parameters:
4860a1cb98faSBarry Smith + dm           - The `DM`
4861b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
4862a1cb98faSBarry Smith . sfVert       - `PetscSF` describing complete vertex ownership
4863b09969d6SVaclav Hapla - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
4864b09969d6SVaclav Hapla 
4865b09969d6SVaclav Hapla   Level: advanced
4866b09969d6SVaclav Hapla 
48671cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildFromCellListParallel()`
4868b09969d6SVaclav Hapla @*/
4869d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildCoordinatesFromCellListParallel(DM dm, PetscInt spaceDim, PetscSF sfVert, const PetscReal vertexCoords[])
4870d71ae5a4SJacob Faibussowitsch {
4871a47d0d45SMatthew G. Knepley   PetscSection coordSection;
4872a47d0d45SMatthew G. Knepley   Vec          coordinates;
4873a47d0d45SMatthew G. Knepley   PetscScalar *coords;
48741edcf0b2SVaclav Hapla   PetscInt     numVertices, numVerticesAdj, coordSize, v, vStart, vEnd;
4875a47d0d45SMatthew G. Knepley 
4876a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
48779566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
48789566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
48791dca8a05SBarry Smith   PetscCheck(vStart >= 0 && vEnd >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "DM is not set up properly. DMPlexBuildFromCellList() should be called first.");
48809566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, spaceDim));
48819566063dSJacob Faibussowitsch   PetscCall(PetscSFGetGraph(sfVert, &numVertices, &numVerticesAdj, NULL, NULL));
48821dca8a05SBarry Smith   PetscCheck(vEnd - vStart == numVerticesAdj, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Supplied sfVert has wrong number of leaves = %" PetscInt_FMT " != %" PetscInt_FMT " = vEnd - vStart", numVerticesAdj, vEnd - vStart);
48839566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
48849566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
48859566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, spaceDim));
48869566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, vStart, vEnd));
48871edcf0b2SVaclav Hapla   for (v = vStart; v < vEnd; ++v) {
48889566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, spaceDim));
48899566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, spaceDim));
4890a47d0d45SMatthew G. Knepley   }
48919566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
48929566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
48939566063dSJacob Faibussowitsch   PetscCall(VecCreate(PetscObjectComm((PetscObject)dm), &coordinates));
48949566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, spaceDim));
48959566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
48969566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
48979566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
48989566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
4899a47d0d45SMatthew G. Knepley   {
4900a47d0d45SMatthew G. Knepley     MPI_Datatype coordtype;
4901a47d0d45SMatthew G. Knepley 
4902a47d0d45SMatthew G. Knepley     /* Need a temp buffer for coords if we have complex/single */
49039566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_contiguous(spaceDim, MPIU_SCALAR, &coordtype));
49049566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_commit(&coordtype));
490521016a8bSBarry Smith #if defined(PETSC_USE_COMPLEX)
490621016a8bSBarry Smith     {
490721016a8bSBarry Smith       PetscScalar *svertexCoords;
490821016a8bSBarry Smith       PetscInt     i;
49099566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numVertices * spaceDim, &svertexCoords));
49103612f820SVaclav Hapla       for (i = 0; i < numVertices * spaceDim; i++) svertexCoords[i] = vertexCoords[i];
49119566063dSJacob Faibussowitsch       PetscCall(PetscSFBcastBegin(sfVert, coordtype, svertexCoords, coords, MPI_REPLACE));
49129566063dSJacob Faibussowitsch       PetscCall(PetscSFBcastEnd(sfVert, coordtype, svertexCoords, coords, MPI_REPLACE));
49139566063dSJacob Faibussowitsch       PetscCall(PetscFree(svertexCoords));
491421016a8bSBarry Smith     }
491521016a8bSBarry Smith #else
49169566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastBegin(sfVert, coordtype, vertexCoords, coords, MPI_REPLACE));
49179566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastEnd(sfVert, coordtype, vertexCoords, coords, MPI_REPLACE));
491821016a8bSBarry Smith #endif
49199566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_free(&coordtype));
4920a47d0d45SMatthew G. Knepley   }
49219566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
49229566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
49239566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
49249566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
49253ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4926a47d0d45SMatthew G. Knepley }
4927a47d0d45SMatthew G. Knepley 
4928c3edce3dSSatish Balay /*@
4929a1cb98faSBarry Smith   DMPlexCreateFromCellListParallelPetsc - Create distributed `DMPLEX` from a list of vertices for each cell (common mesh generator output)
4930a1cb98faSBarry Smith 
4931a1cb98faSBarry Smith   Collective
4932a47d0d45SMatthew G. Knepley 
4933a47d0d45SMatthew G. Knepley   Input Parameters:
4934a47d0d45SMatthew G. Knepley + comm         - The communicator
4935a47d0d45SMatthew G. Knepley . dim          - The topological dimension of the mesh
4936a47d0d45SMatthew G. Knepley . numCells     - The number of cells owned by this process
4937a1cb98faSBarry Smith . numVertices  - The number of vertices owned by this process, or `PETSC_DECIDE`
4938a1cb98faSBarry Smith . NVertices    - The global number of vertices, or `PETSC_DECIDE`
4939a47d0d45SMatthew G. Knepley . numCorners   - The number of vertices for each cell
4940a47d0d45SMatthew G. Knepley . interpolate  - Flag indicating that intermediate mesh entities (faces, edges) should be created automatically
4941a47d0d45SMatthew G. Knepley . cells        - An array of numCells*numCorners numbers, the global vertex numbers for each cell
4942a47d0d45SMatthew G. Knepley . spaceDim     - The spatial dimension used for coordinates
4943a47d0d45SMatthew G. Knepley - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
4944a47d0d45SMatthew G. Knepley 
4945d8d19677SJose E. Roman   Output Parameters:
4946a1cb98faSBarry Smith + dm          - The `DM`
4947a1cb98faSBarry Smith . vertexSF    - (Optional) `PetscSF` describing complete vertex ownership
494860225df5SJacob Faibussowitsch - verticesAdj - (Optional) vertex adjacency array
4949a47d0d45SMatthew G. Knepley 
4950b09969d6SVaclav Hapla   Level: intermediate
4951a47d0d45SMatthew G. Knepley 
4952a1cb98faSBarry Smith   Notes:
4953a1cb98faSBarry Smith   This function is just a convenient sequence of `DMCreate()`, `DMSetType()`, `DMSetDimension()`,
4954a1cb98faSBarry Smith   `DMPlexBuildFromCellListParallel()`, `DMPlexInterpolate()`, `DMPlexBuildCoordinatesFromCellListParallel()`
4955a1cb98faSBarry Smith 
4956a1cb98faSBarry Smith   See `DMPlexBuildFromCellListParallel()` for an example and details about the topology-related parameters.
4957a1cb98faSBarry Smith 
4958a1cb98faSBarry Smith   See `DMPlexBuildCoordinatesFromCellListParallel()` for details about the geometry-related parameters.
4959a1cb98faSBarry Smith 
49601cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListPetsc()`, `DMPlexBuildFromCellListParallel()`, `DMPlexBuildCoordinatesFromCellListParallel()`, `DMPlexCreateFromDAG()`, `DMPlexCreate()`
4961a47d0d45SMatthew G. Knepley @*/
4962d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateFromCellListParallelPetsc(MPI_Comm comm, PetscInt dim, PetscInt numCells, PetscInt numVertices, PetscInt NVertices, PetscInt numCorners, PetscBool interpolate, const PetscInt cells[], PetscInt spaceDim, const PetscReal vertexCoords[], PetscSF *vertexSF, PetscInt **verticesAdj, DM *dm)
4963d71ae5a4SJacob Faibussowitsch {
4964a47d0d45SMatthew G. Knepley   PetscSF sfVert;
4965a47d0d45SMatthew G. Knepley 
4966a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
49679566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
49689566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
4969a47d0d45SMatthew G. Knepley   PetscValidLogicalCollectiveInt(*dm, dim, 2);
4970064a246eSJacob Faibussowitsch   PetscValidLogicalCollectiveInt(*dm, spaceDim, 9);
49719566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
49729566063dSJacob Faibussowitsch   PetscCall(DMPlexBuildFromCellListParallel(*dm, numCells, numVertices, NVertices, numCorners, cells, &sfVert, verticesAdj));
4973a47d0d45SMatthew G. Knepley   if (interpolate) {
49745fd9971aSMatthew G. Knepley     DM idm;
4975a47d0d45SMatthew G. Knepley 
49769566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
49779566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
4978a47d0d45SMatthew G. Knepley     *dm = idm;
4979a47d0d45SMatthew G. Knepley   }
49809566063dSJacob Faibussowitsch   PetscCall(DMPlexBuildCoordinatesFromCellListParallel(*dm, spaceDim, sfVert, vertexCoords));
498118d54ad4SMichael Lange   if (vertexSF) *vertexSF = sfVert;
49829566063dSJacob Faibussowitsch   else PetscCall(PetscSFDestroy(&sfVert));
49833ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4984a47d0d45SMatthew G. Knepley }
4985a47d0d45SMatthew G. Knepley 
4986b09969d6SVaclav Hapla /*@C
4987a1cb98faSBarry Smith   DMPlexBuildFromCellList - Build `DMPLEX` topology from a list of vertices for each cell (common mesh generator output)
4988a1cb98faSBarry Smith 
498920f4b53cSBarry Smith   Collective; No Fortran Support
49909298eaa6SMatthew G Knepley 
49919298eaa6SMatthew G Knepley   Input Parameters:
4992a1cb98faSBarry Smith + dm          - The `DM`
4993b09969d6SVaclav Hapla . numCells    - The number of cells owned by this process
4994a1cb98faSBarry Smith . numVertices - The number of vertices owned by this process, or `PETSC_DETERMINE`
49959298eaa6SMatthew G Knepley . numCorners  - The number of vertices for each cell
49965e488331SVaclav Hapla - cells       - An array of numCells*numCorners numbers, the global vertex numbers for each cell
49979298eaa6SMatthew G Knepley 
4998b09969d6SVaclav Hapla   Level: advanced
49999298eaa6SMatthew G Knepley 
5000b09969d6SVaclav Hapla   Notes:
5001b09969d6SVaclav Hapla   Two triangles sharing a face
5002a1cb98faSBarry Smith .vb
50039298eaa6SMatthew G Knepley 
5004a1cb98faSBarry Smith         2
5005a1cb98faSBarry Smith       / | \
5006a1cb98faSBarry Smith      /  |  \
5007a1cb98faSBarry Smith     /   |   \
5008a1cb98faSBarry Smith    0  0 | 1  3
5009a1cb98faSBarry Smith     \   |   /
5010a1cb98faSBarry Smith      \  |  /
5011a1cb98faSBarry Smith       \ | /
5012a1cb98faSBarry Smith         1
5013a1cb98faSBarry Smith .ve
5014a1cb98faSBarry Smith   would have input
5015a1cb98faSBarry Smith .vb
5016a1cb98faSBarry Smith   numCells = 2, numVertices = 4
5017a1cb98faSBarry Smith   cells = [0 1 2  1 3 2]
5018a1cb98faSBarry Smith .ve
5019a1cb98faSBarry Smith   which would result in the `DMPLEX`
5020a1cb98faSBarry Smith .vb
5021a1cb98faSBarry Smith 
5022a1cb98faSBarry Smith         4
5023a1cb98faSBarry Smith       / | \
5024a1cb98faSBarry Smith      /  |  \
5025a1cb98faSBarry Smith     /   |   \
5026a1cb98faSBarry Smith    2  0 | 1  5
5027a1cb98faSBarry Smith     \   |   /
5028a1cb98faSBarry Smith      \  |  /
5029a1cb98faSBarry Smith       \ | /
5030a1cb98faSBarry Smith         3
5031a1cb98faSBarry Smith .ve
5032a1cb98faSBarry Smith 
5033a1cb98faSBarry Smith   If numVertices is `PETSC_DETERMINE`, it is computed by PETSc as the maximum vertex index in cells + 1.
503425b6865aSVaclav Hapla 
50351cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildFromCellListParallel()`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromCellListPetsc()`
5036b09969d6SVaclav Hapla @*/
5037d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildFromCellList(DM dm, PetscInt numCells, PetscInt numVertices, PetscInt numCorners, const PetscInt cells[])
5038d71ae5a4SJacob Faibussowitsch {
5039961cfab0SVaclav Hapla   PetscInt *cones, c, p, dim;
5040b09969d6SVaclav Hapla 
5041b09969d6SVaclav Hapla   PetscFunctionBegin;
50429566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
50439566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
504425b6865aSVaclav Hapla   /* Get/check global number of vertices */
504525b6865aSVaclav Hapla   {
504625b6865aSVaclav Hapla     PetscInt       NVerticesInCells, i;
504725b6865aSVaclav Hapla     const PetscInt len = numCells * numCorners;
504825b6865aSVaclav Hapla 
504925b6865aSVaclav Hapla     /* NVerticesInCells = max(cells) + 1 */
505025b6865aSVaclav Hapla     NVerticesInCells = PETSC_MIN_INT;
50519371c9d4SSatish Balay     for (i = 0; i < len; i++)
50529371c9d4SSatish Balay       if (cells[i] > NVerticesInCells) NVerticesInCells = cells[i];
505325b6865aSVaclav Hapla     ++NVerticesInCells;
505425b6865aSVaclav Hapla 
505525b6865aSVaclav Hapla     if (numVertices == PETSC_DECIDE) numVertices = NVerticesInCells;
50569371c9d4SSatish Balay     else
50579371c9d4SSatish Balay       PetscCheck(numVertices >= NVerticesInCells, PetscObjectComm((PetscObject)dm), PETSC_ERR_ARG_WRONG, "Specified number of vertices %" PetscInt_FMT " must be greater than or equal to the number of vertices in cells %" PetscInt_FMT, numVertices, NVerticesInCells);
505825b6865aSVaclav Hapla   }
50599566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
506048a46eb9SPierre Jolivet   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, numCorners));
50619566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm));
50629566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCones(dm, &cones));
5063b09969d6SVaclav Hapla   for (c = 0; c < numCells; ++c) {
5064ad540459SPierre Jolivet     for (p = 0; p < numCorners; ++p) cones[c * numCorners + p] = cells[c * numCorners + p] + numCells;
5065b09969d6SVaclav Hapla   }
50669566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
50679566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
50689566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
50693ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5070b09969d6SVaclav Hapla }
5071b09969d6SVaclav Hapla 
5072b09969d6SVaclav Hapla /*@C
5073a1cb98faSBarry Smith   DMPlexBuildCoordinatesFromCellList - Build `DM` coordinates from a list of coordinates for each owned vertex (common mesh generator output)
5074a1cb98faSBarry Smith 
507520f4b53cSBarry Smith   Collective; No Fortran Support
5076b09969d6SVaclav Hapla 
5077b09969d6SVaclav Hapla   Input Parameters:
5078a1cb98faSBarry Smith + dm           - The `DM`
5079b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
5080b09969d6SVaclav Hapla - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
5081b09969d6SVaclav Hapla 
5082b09969d6SVaclav Hapla   Level: advanced
5083b09969d6SVaclav Hapla 
50841cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildCoordinatesFromCellListParallel()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexBuildFromCellList()`
5085b09969d6SVaclav Hapla @*/
5086d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildCoordinatesFromCellList(DM dm, PetscInt spaceDim, const PetscReal vertexCoords[])
5087d71ae5a4SJacob Faibussowitsch {
5088b09969d6SVaclav Hapla   PetscSection coordSection;
5089b09969d6SVaclav Hapla   Vec          coordinates;
5090b09969d6SVaclav Hapla   DM           cdm;
5091b09969d6SVaclav Hapla   PetscScalar *coords;
50921edcf0b2SVaclav Hapla   PetscInt     v, vStart, vEnd, d;
5093b09969d6SVaclav Hapla 
5094b09969d6SVaclav Hapla   PetscFunctionBegin;
50959566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
50969566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
50971dca8a05SBarry Smith   PetscCheck(vStart >= 0 && vEnd >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "DM is not set up properly. DMPlexBuildFromCellList() should be called first.");
50989566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, spaceDim));
50999566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
51009566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
51019566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, spaceDim));
51029566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, vStart, vEnd));
51031edcf0b2SVaclav Hapla   for (v = vStart; v < vEnd; ++v) {
51049566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, spaceDim));
51059566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, spaceDim));
5106b09969d6SVaclav Hapla   }
51079566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
5108b09969d6SVaclav Hapla 
51099566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dm, &cdm));
51109566063dSJacob Faibussowitsch   PetscCall(DMCreateLocalVector(cdm, &coordinates));
51119566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, spaceDim));
51129566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
51139566063dSJacob Faibussowitsch   PetscCall(VecGetArrayWrite(coordinates, &coords));
51141edcf0b2SVaclav Hapla   for (v = 0; v < vEnd - vStart; ++v) {
5115ad540459SPierre Jolivet     for (d = 0; d < spaceDim; ++d) coords[v * spaceDim + d] = vertexCoords[v * spaceDim + d];
5116b09969d6SVaclav Hapla   }
51179566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayWrite(coordinates, &coords));
51189566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
51199566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
51209566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
51213ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5122b09969d6SVaclav Hapla }
5123b09969d6SVaclav Hapla 
5124b09969d6SVaclav Hapla /*@
5125a1cb98faSBarry Smith   DMPlexCreateFromCellListPetsc - Create `DMPLEX` from a list of vertices for each cell (common mesh generator output), but only process 0 takes in the input
51263df08285SMatthew G. Knepley 
5127a1cb98faSBarry Smith   Collective
5128b09969d6SVaclav Hapla 
5129b09969d6SVaclav Hapla   Input Parameters:
5130b09969d6SVaclav Hapla + comm         - The communicator
5131b09969d6SVaclav Hapla . dim          - The topological dimension of the mesh
51323df08285SMatthew G. Knepley . numCells     - The number of cells, only on process 0
5133a1cb98faSBarry Smith . numVertices  - The number of vertices owned by this process, or `PETSC_DECIDE`, only on process 0
51343df08285SMatthew G. Knepley . numCorners   - The number of vertices for each cell, only on process 0
5135b09969d6SVaclav Hapla . interpolate  - Flag indicating that intermediate mesh entities (faces, edges) should be created automatically
51363df08285SMatthew G. Knepley . cells        - An array of numCells*numCorners numbers, the vertices for each cell, only on process 0
5137b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
51383df08285SMatthew G. Knepley - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex, only on process 0
5139b09969d6SVaclav Hapla 
5140b09969d6SVaclav Hapla   Output Parameter:
5141a1cb98faSBarry Smith . dm - The `DM`, which only has points on process 0
514225b6865aSVaclav Hapla 
5143b09969d6SVaclav Hapla   Level: intermediate
5144b09969d6SVaclav Hapla 
5145a1cb98faSBarry Smith   Notes:
5146a1cb98faSBarry Smith   This function is just a convenient sequence of `DMCreate()`, `DMSetType()`, `DMSetDimension()`, `DMPlexBuildFromCellList()`,
5147a1cb98faSBarry Smith   `DMPlexInterpolate()`, `DMPlexBuildCoordinatesFromCellList()`
5148a1cb98faSBarry Smith 
5149a1cb98faSBarry Smith   See `DMPlexBuildFromCellList()` for an example and details about the topology-related parameters.
5150a1cb98faSBarry Smith   See `DMPlexBuildCoordinatesFromCellList()` for details about the geometry-related parameters.
5151a1cb98faSBarry Smith   See `DMPlexCreateFromCellListParallelPetsc()` for parallel input
5152a1cb98faSBarry Smith 
51531cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildFromCellList()`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromDAG()`, `DMPlexCreate()`
51549298eaa6SMatthew G Knepley @*/
5155d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateFromCellListPetsc(MPI_Comm comm, PetscInt dim, PetscInt numCells, PetscInt numVertices, PetscInt numCorners, PetscBool interpolate, const PetscInt cells[], PetscInt spaceDim, const PetscReal vertexCoords[], DM *dm)
5156d71ae5a4SJacob Faibussowitsch {
51573df08285SMatthew G. Knepley   PetscMPIInt rank;
51589298eaa6SMatthew G Knepley 
51599298eaa6SMatthew G Knepley   PetscFunctionBegin;
516028b400f6SJacob Faibussowitsch   PetscCheck(dim, comm, PETSC_ERR_ARG_OUTOFRANGE, "This is not appropriate for 0-dimensional meshes. Consider either creating the DM using DMPlexCreateFromDAG(), by hand, or using DMSwarm.");
51619566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
51629566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
51639566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
51649566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
5165c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildFromCellList(*dm, numCells, numVertices, numCorners, cells));
51669566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildFromCellList(*dm, 0, 0, 0, NULL));
51679298eaa6SMatthew G Knepley   if (interpolate) {
51685fd9971aSMatthew G. Knepley     DM idm;
51699298eaa6SMatthew G Knepley 
51709566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
51719566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
51729298eaa6SMatthew G Knepley     *dm = idm;
51739298eaa6SMatthew G Knepley   }
5174c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildCoordinatesFromCellList(*dm, spaceDim, vertexCoords));
51759566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildCoordinatesFromCellList(*dm, spaceDim, NULL));
51763ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
51779298eaa6SMatthew G Knepley }
51789298eaa6SMatthew G Knepley 
5179939f6067SMatthew G. Knepley /*@
518020f4b53cSBarry Smith   DMPlexCreateFromDAG - This takes as input the adjacency-list representation of the Directed Acyclic Graph (Hasse Diagram) encoding a mesh, and produces a `DM`
5181939f6067SMatthew G. Knepley 
5182939f6067SMatthew G. Knepley   Input Parameters:
518320f4b53cSBarry Smith + dm               - The empty `DM` object, usually from `DMCreate()` and `DMSetDimension()`
5184939f6067SMatthew G. Knepley . depth            - The depth of the DAG
518520f4b53cSBarry Smith . numPoints        - Array of size depth + 1 containing the number of points at each `depth`
5186939f6067SMatthew G. Knepley . coneSize         - The cone size of each point
5187939f6067SMatthew G. Knepley . cones            - The concatenation of the cone points for each point, the cone list must be oriented correctly for each point
5188939f6067SMatthew G. Knepley . coneOrientations - The orientation of each cone point
518920f4b53cSBarry Smith - vertexCoords     - An array of `numPoints`[0]*spacedim numbers representing the coordinates of each vertex, with spacedim the value set via `DMSetCoordinateDim()`
5190939f6067SMatthew G. Knepley 
5191939f6067SMatthew G. Knepley   Output Parameter:
519220f4b53cSBarry Smith . dm - The `DM`
519320f4b53cSBarry Smith 
519420f4b53cSBarry Smith   Level: advanced
5195939f6067SMatthew G. Knepley 
5196a1cb98faSBarry Smith   Note:
5197a1cb98faSBarry Smith   Two triangles sharing a face would have input
5198a1cb98faSBarry Smith .vb
5199a1cb98faSBarry Smith   depth = 1, numPoints = [4 2], coneSize = [3 3 0 0 0 0]
5200a1cb98faSBarry Smith   cones = [2 3 4  3 5 4], coneOrientations = [0 0 0  0 0 0]
5201a1cb98faSBarry Smith  vertexCoords = [-1.0 0.0  0.0 -1.0  0.0 1.0  1.0 0.0]
5202a1cb98faSBarry Smith .ve
5203939f6067SMatthew G. Knepley   which would result in the DMPlex
5204a1cb98faSBarry Smith .vb
5205a1cb98faSBarry Smith         4
5206a1cb98faSBarry Smith       / | \
5207a1cb98faSBarry Smith      /  |  \
5208a1cb98faSBarry Smith     /   |   \
5209a1cb98faSBarry Smith    2  0 | 1  5
5210a1cb98faSBarry Smith     \   |   /
5211a1cb98faSBarry Smith      \  |  /
5212a1cb98faSBarry Smith       \ | /
5213a1cb98faSBarry Smith         3
5214a1cb98faSBarry Smith .ve
5215a1cb98faSBarry Smith   Notice that all points are numbered consecutively, unlike `DMPlexCreateFromCellListPetsc()`
5216939f6067SMatthew G. Knepley 
52171cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`
5218939f6067SMatthew G. Knepley @*/
5219d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateFromDAG(DM dm, PetscInt depth, const PetscInt numPoints[], const PetscInt coneSize[], const PetscInt cones[], const PetscInt coneOrientations[], const PetscScalar vertexCoords[])
5220d71ae5a4SJacob Faibussowitsch {
52219298eaa6SMatthew G Knepley   Vec          coordinates;
52229298eaa6SMatthew G Knepley   PetscSection coordSection;
52239298eaa6SMatthew G Knepley   PetscScalar *coords;
5224811e8653SToby Isaac   PetscInt     coordSize, firstVertex = -1, pStart = 0, pEnd = 0, p, v, dim, dimEmbed, d, off;
52259298eaa6SMatthew G Knepley 
52269298eaa6SMatthew G Knepley   PetscFunctionBegin;
52279566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
52289566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &dimEmbed));
522963a3b9bcSJacob Faibussowitsch   PetscCheck(dimEmbed >= dim, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Embedding dimension %" PetscInt_FMT " cannot be less than intrinsic dimension %" PetscInt_FMT, dimEmbed, dim);
52309298eaa6SMatthew G Knepley   for (d = 0; d <= depth; ++d) pEnd += numPoints[d];
52319566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, pStart, pEnd));
52329298eaa6SMatthew G Knepley   for (p = pStart; p < pEnd; ++p) {
52339566063dSJacob Faibussowitsch     PetscCall(DMPlexSetConeSize(dm, p, coneSize[p - pStart]));
5234ad540459SPierre Jolivet     if (firstVertex < 0 && !coneSize[p - pStart]) firstVertex = p - pStart;
523597e052ccSToby Isaac   }
52361dca8a05SBarry Smith   PetscCheck(firstVertex >= 0 || !numPoints[0], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Expected %" PetscInt_FMT " vertices but could not find any", numPoints[0]);
52379566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm)); /* Allocate space for cones */
52389298eaa6SMatthew G Knepley   for (p = pStart, off = 0; p < pEnd; off += coneSize[p - pStart], ++p) {
52399566063dSJacob Faibussowitsch     PetscCall(DMPlexSetCone(dm, p, &cones[off]));
52409566063dSJacob Faibussowitsch     PetscCall(DMPlexSetConeOrientation(dm, p, &coneOrientations[off]));
52419298eaa6SMatthew G Knepley   }
52429566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
52439566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
52449298eaa6SMatthew G Knepley   /* Build coordinates */
52459566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
52469566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
52479566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dimEmbed));
52489566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numPoints[0]));
52499298eaa6SMatthew G Knepley   for (v = firstVertex; v < firstVertex + numPoints[0]; ++v) {
52509566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, dimEmbed));
52519566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dimEmbed));
52529298eaa6SMatthew G Knepley   }
52539566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
52549566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
52559566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
52569566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
52579566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
52589566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, dimEmbed));
52599566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
52609318fe57SMatthew G. Knepley   if (vertexCoords) {
52619566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
52629298eaa6SMatthew G Knepley     for (v = 0; v < numPoints[0]; ++v) {
52639298eaa6SMatthew G Knepley       PetscInt off;
52649298eaa6SMatthew G Knepley 
52659566063dSJacob Faibussowitsch       PetscCall(PetscSectionGetOffset(coordSection, v + firstVertex, &off));
5266ad540459SPierre Jolivet       for (d = 0; d < dimEmbed; ++d) coords[off + d] = vertexCoords[v * dimEmbed + d];
52679298eaa6SMatthew G Knepley     }
52689318fe57SMatthew G. Knepley   }
52699566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
52709566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
52719566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
52723ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
52739298eaa6SMatthew G Knepley }
52748415267dSToby Isaac 
5275a4e35b19SJacob Faibussowitsch /*
5276a1cb98faSBarry Smith   DMPlexCreateCellVertexFromFile - Create a `DMPLEX` mesh from a simple cell-vertex file.
5277a1cb98faSBarry Smith 
5278a1cb98faSBarry Smith   Collective
52798ca92349SMatthew G. Knepley 
52808ca92349SMatthew G. Knepley + comm        - The MPI communicator
52818ca92349SMatthew G. Knepley . filename    - Name of the .dat file
52828ca92349SMatthew G. Knepley - interpolate - Create faces and edges in the mesh
52838ca92349SMatthew G. Knepley 
52848ca92349SMatthew G. Knepley   Output Parameter:
5285a1cb98faSBarry Smith . dm  - The `DM` object representing the mesh
52868ca92349SMatthew G. Knepley 
52878ca92349SMatthew G. Knepley   Level: beginner
52888ca92349SMatthew G. Knepley 
5289a1cb98faSBarry Smith   Note:
5290a1cb98faSBarry Smith   The format is the simplest possible:
5291a1cb98faSBarry Smith .vb
5292a1cb98faSBarry Smith   Ne
5293a1cb98faSBarry Smith   v0 v1 ... vk
5294a1cb98faSBarry Smith   Nv
5295a1cb98faSBarry Smith   x y z marker
5296a1cb98faSBarry Smith .ve
5297a1cb98faSBarry Smith 
5298a1cb98faSBarry Smith   Developer Note:
5299a1cb98faSBarry Smith   Should use a `PetscViewer` not a filename
5300a1cb98faSBarry Smith 
53016afe31f6SMartin Diehl .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromFile()`, `DMPlexCreateGmsh()`, `DMPlexCreate()`
5302a4e35b19SJacob Faibussowitsch */
5303ff6a9541SJacob Faibussowitsch static PetscErrorCode DMPlexCreateCellVertexFromFile(MPI_Comm comm, const char filename[], PetscBool interpolate, DM *dm)
5304d71ae5a4SJacob Faibussowitsch {
53058ca92349SMatthew G. Knepley   DMLabel      marker;
53068ca92349SMatthew G. Knepley   PetscViewer  viewer;
53078ca92349SMatthew G. Knepley   Vec          coordinates;
53088ca92349SMatthew G. Knepley   PetscSection coordSection;
53098ca92349SMatthew G. Knepley   PetscScalar *coords;
53108ca92349SMatthew G. Knepley   char         line[PETSC_MAX_PATH_LEN];
53118ca92349SMatthew G. Knepley   PetscInt     dim = 3, cdim = 3, coordSize, v, c, d;
53128ca92349SMatthew G. Knepley   PetscMPIInt  rank;
5313f8d5e320SMatthew G. Knepley   int          snum, Nv, Nc, Ncn, Nl;
53148ca92349SMatthew G. Knepley 
53158ca92349SMatthew G. Knepley   PetscFunctionBegin;
53169566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
53179566063dSJacob Faibussowitsch   PetscCall(PetscViewerCreate(comm, &viewer));
53189566063dSJacob Faibussowitsch   PetscCall(PetscViewerSetType(viewer, PETSCVIEWERASCII));
53199566063dSJacob Faibussowitsch   PetscCall(PetscViewerFileSetMode(viewer, FILE_MODE_READ));
53209566063dSJacob Faibussowitsch   PetscCall(PetscViewerFileSetName(viewer, filename));
5321dd400576SPatrick Sanan   if (rank == 0) {
53229566063dSJacob Faibussowitsch     PetscCall(PetscViewerRead(viewer, line, 4, NULL, PETSC_STRING));
5323f8d5e320SMatthew G. Knepley     snum = sscanf(line, "%d %d %d %d", &Nc, &Nv, &Ncn, &Nl);
532408401ef6SPierre Jolivet     PetscCheck(snum == 4, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
532525ce1634SJed Brown   } else {
5326f8d5e320SMatthew G. Knepley     Nc = Nv = Ncn = Nl = 0;
53278ca92349SMatthew G. Knepley   }
53289566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
53299566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
53309566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(*dm, 0, Nc + Nv));
53319566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
53329566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(*dm, cdim));
53338ca92349SMatthew G. Knepley   /* Read topology */
5334dd400576SPatrick Sanan   if (rank == 0) {
5335f8d5e320SMatthew G. Knepley     char     format[PETSC_MAX_PATH_LEN];
5336f8d5e320SMatthew G. Knepley     PetscInt cone[8];
53378ca92349SMatthew G. Knepley     int      vbuf[8], v;
53388ca92349SMatthew G. Knepley 
53399371c9d4SSatish Balay     for (c = 0; c < Ncn; ++c) {
53409371c9d4SSatish Balay       format[c * 3 + 0] = '%';
53419371c9d4SSatish Balay       format[c * 3 + 1] = 'd';
53429371c9d4SSatish Balay       format[c * 3 + 2] = ' ';
53439371c9d4SSatish Balay     }
5344f8d5e320SMatthew G. Knepley     format[Ncn * 3 - 1] = '\0';
53459566063dSJacob Faibussowitsch     for (c = 0; c < Nc; ++c) PetscCall(DMPlexSetConeSize(*dm, c, Ncn));
53469566063dSJacob Faibussowitsch     PetscCall(DMSetUp(*dm));
53478ca92349SMatthew G. Knepley     for (c = 0; c < Nc; ++c) {
53489566063dSJacob Faibussowitsch       PetscCall(PetscViewerRead(viewer, line, Ncn, NULL, PETSC_STRING));
5349f8d5e320SMatthew G. Knepley       switch (Ncn) {
5350d71ae5a4SJacob Faibussowitsch       case 2:
5351d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1]);
5352d71ae5a4SJacob Faibussowitsch         break;
5353d71ae5a4SJacob Faibussowitsch       case 3:
5354d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2]);
5355d71ae5a4SJacob Faibussowitsch         break;
5356d71ae5a4SJacob Faibussowitsch       case 4:
5357d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3]);
5358d71ae5a4SJacob Faibussowitsch         break;
5359d71ae5a4SJacob Faibussowitsch       case 6:
5360d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3], &vbuf[4], &vbuf[5]);
5361d71ae5a4SJacob Faibussowitsch         break;
5362d71ae5a4SJacob Faibussowitsch       case 8:
5363d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3], &vbuf[4], &vbuf[5], &vbuf[6], &vbuf[7]);
5364d71ae5a4SJacob Faibussowitsch         break;
5365d71ae5a4SJacob Faibussowitsch       default:
5366d71ae5a4SJacob Faibussowitsch         SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "No cell shape with %d vertices", Ncn);
5367f8d5e320SMatthew G. Knepley       }
536808401ef6SPierre Jolivet       PetscCheck(snum == Ncn, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
5369f8d5e320SMatthew G. Knepley       for (v = 0; v < Ncn; ++v) cone[v] = vbuf[v] + Nc;
53708ca92349SMatthew G. Knepley       /* Hexahedra are inverted */
5371f8d5e320SMatthew G. Knepley       if (Ncn == 8) {
53728ca92349SMatthew G. Knepley         PetscInt tmp = cone[1];
53738ca92349SMatthew G. Knepley         cone[1]      = cone[3];
53748ca92349SMatthew G. Knepley         cone[3]      = tmp;
53758ca92349SMatthew G. Knepley       }
53769566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCone(*dm, c, cone));
53778ca92349SMatthew G. Knepley     }
53788ca92349SMatthew G. Knepley   }
53799566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(*dm));
53809566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(*dm));
53818ca92349SMatthew G. Knepley   /* Read coordinates */
53829566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(*dm, &coordSection));
53839566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
53849566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, cdim));
53859566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, Nc, Nc + Nv));
53868ca92349SMatthew G. Knepley   for (v = Nc; v < Nc + Nv; ++v) {
53879566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, cdim));
53889566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, cdim));
53898ca92349SMatthew G. Knepley   }
53909566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
53919566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
53929566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
53939566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
53949566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
53959566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, cdim));
53969566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
53979566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
5398dd400576SPatrick Sanan   if (rank == 0) {
5399f8d5e320SMatthew G. Knepley     char   format[PETSC_MAX_PATH_LEN];
54008ca92349SMatthew G. Knepley     double x[3];
5401f8d5e320SMatthew G. Knepley     int    l, val[3];
54028ca92349SMatthew G. Knepley 
5403f8d5e320SMatthew G. Knepley     if (Nl) {
54049371c9d4SSatish Balay       for (l = 0; l < Nl; ++l) {
54059371c9d4SSatish Balay         format[l * 3 + 0] = '%';
54069371c9d4SSatish Balay         format[l * 3 + 1] = 'd';
54079371c9d4SSatish Balay         format[l * 3 + 2] = ' ';
54089371c9d4SSatish Balay       }
5409f8d5e320SMatthew G. Knepley       format[Nl * 3 - 1] = '\0';
54109566063dSJacob Faibussowitsch       PetscCall(DMCreateLabel(*dm, "marker"));
54119566063dSJacob Faibussowitsch       PetscCall(DMGetLabel(*dm, "marker", &marker));
5412f8d5e320SMatthew G. Knepley     }
54138ca92349SMatthew G. Knepley     for (v = 0; v < Nv; ++v) {
54149566063dSJacob Faibussowitsch       PetscCall(PetscViewerRead(viewer, line, 3 + Nl, NULL, PETSC_STRING));
5415f8d5e320SMatthew G. Knepley       snum = sscanf(line, "%lg %lg %lg", &x[0], &x[1], &x[2]);
541608401ef6SPierre Jolivet       PetscCheck(snum == 3, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
5417f8d5e320SMatthew G. Knepley       switch (Nl) {
5418d71ae5a4SJacob Faibussowitsch       case 0:
5419d71ae5a4SJacob Faibussowitsch         snum = 0;
5420d71ae5a4SJacob Faibussowitsch         break;
5421d71ae5a4SJacob Faibussowitsch       case 1:
5422d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0]);
5423d71ae5a4SJacob Faibussowitsch         break;
5424d71ae5a4SJacob Faibussowitsch       case 2:
5425d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0], &val[1]);
5426d71ae5a4SJacob Faibussowitsch         break;
5427d71ae5a4SJacob Faibussowitsch       case 3:
5428d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0], &val[1], &val[2]);
5429d71ae5a4SJacob Faibussowitsch         break;
5430d71ae5a4SJacob Faibussowitsch       default:
5431d71ae5a4SJacob Faibussowitsch         SETERRQ(PETSC_COMM_SELF, PETSC_ERR_SUP, "Request support for %d labels", Nl);
5432f8d5e320SMatthew G. Knepley       }
543308401ef6SPierre Jolivet       PetscCheck(snum == Nl, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
54348ca92349SMatthew G. Knepley       for (d = 0; d < cdim; ++d) coords[v * cdim + d] = x[d];
54359566063dSJacob Faibussowitsch       for (l = 0; l < Nl; ++l) PetscCall(DMLabelSetValue(marker, v + Nc, val[l]));
54368ca92349SMatthew G. Knepley     }
54378ca92349SMatthew G. Knepley   }
54389566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
54399566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(*dm, coordinates));
54409566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
54419566063dSJacob Faibussowitsch   PetscCall(PetscViewerDestroy(&viewer));
54428ca92349SMatthew G. Knepley   if (interpolate) {
54438ca92349SMatthew G. Knepley     DM      idm;
54448ca92349SMatthew G. Knepley     DMLabel bdlabel;
54458ca92349SMatthew G. Knepley 
54469566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
54479566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
54488ca92349SMatthew G. Knepley     *dm = idm;
54498ca92349SMatthew G. Knepley 
5450f8d5e320SMatthew G. Knepley     if (!Nl) {
54519566063dSJacob Faibussowitsch       PetscCall(DMCreateLabel(*dm, "marker"));
54529566063dSJacob Faibussowitsch       PetscCall(DMGetLabel(*dm, "marker", &bdlabel));
54539566063dSJacob Faibussowitsch       PetscCall(DMPlexMarkBoundaryFaces(*dm, PETSC_DETERMINE, bdlabel));
54549566063dSJacob Faibussowitsch       PetscCall(DMPlexLabelComplete(*dm, bdlabel));
54558ca92349SMatthew G. Knepley     }
5456f8d5e320SMatthew G. Knepley   }
54573ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
54588ca92349SMatthew G. Knepley }
54598ca92349SMatthew G. Knepley 
54608ca92349SMatthew G. Knepley /*@C
5461a1cb98faSBarry Smith   DMPlexCreateFromFile - This takes a filename and produces a `DM`
5462a1cb98faSBarry Smith 
5463a1cb98faSBarry Smith   Collective
5464ca522641SMatthew G. Knepley 
5465ca522641SMatthew G. Knepley   Input Parameters:
5466ca522641SMatthew G. Knepley + comm        - The communicator
5467ca522641SMatthew G. Knepley . filename    - A file name
5468a1cb98faSBarry Smith . plexname    - The object name of the resulting `DM`, also used for intra-datafile lookup by some formats
5469ca522641SMatthew G. Knepley - interpolate - Flag to create intermediate mesh pieces (edges, faces)
5470ca522641SMatthew G. Knepley 
5471ca522641SMatthew G. Knepley   Output Parameter:
5472a1cb98faSBarry Smith . dm - The `DM`
5473ca522641SMatthew G. Knepley 
5474a1cb98faSBarry Smith   Options Database Key:
5475a1cb98faSBarry Smith . -dm_plex_create_from_hdf5_xdmf - use the `PETSC_VIEWER_HDF5_XDMF` format for reading HDF5
547602ef0d99SVaclav Hapla 
547737fdd005SBarry Smith   Use `-dm_plex_create_ prefix` to pass options to the internal `PetscViewer`, e.g.
5478bca97951SVaclav Hapla $ -dm_plex_create_viewer_hdf5_collective
5479bca97951SVaclav Hapla 
5480ca522641SMatthew G. Knepley   Level: beginner
5481ca522641SMatthew G. Knepley 
5482a1cb98faSBarry Smith   Notes:
5483a1cb98faSBarry Smith   Using `PETSCVIEWERHDF5` type with `PETSC_VIEWER_HDF5_PETSC` format, one can save multiple `DMPLEX`
5484a1cb98faSBarry Smith   meshes in a single HDF5 file. This in turn requires one to name the `DMPLEX` object with `PetscObjectSetName()`
5485a1cb98faSBarry Smith   before saving it with `DMView()` and before loading it with `DMLoad()` for identification of the mesh object.
5486a1cb98faSBarry Smith   The input parameter name is thus used to name the `DMPLEX` object when `DMPlexCreateFromFile()` internally
5487a1cb98faSBarry Smith   calls `DMLoad()`. Currently, name is ignored for other viewer types and/or formats.
5488a1cb98faSBarry Smith 
54891cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromDAG()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`, `PetscObjectSetName()`, `DMView()`, `DMLoad()`
5490ca522641SMatthew G. Knepley @*/
5491d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateFromFile(MPI_Comm comm, const char filename[], const char plexname[], PetscBool interpolate, DM *dm)
5492d71ae5a4SJacob Faibussowitsch {
5493ef3a5affSJacob Faibussowitsch   const char  extGmsh[]      = ".msh";
5494ef3a5affSJacob Faibussowitsch   const char  extGmsh2[]     = ".msh2";
5495ef3a5affSJacob Faibussowitsch   const char  extGmsh4[]     = ".msh4";
5496ef3a5affSJacob Faibussowitsch   const char  extCGNS[]      = ".cgns";
5497ef3a5affSJacob Faibussowitsch   const char  extExodus[]    = ".exo";
5498ef3a5affSJacob Faibussowitsch   const char  extExodus_e[]  = ".e";
5499ef3a5affSJacob Faibussowitsch   const char  extGenesis[]   = ".gen";
5500ef3a5affSJacob Faibussowitsch   const char  extFluent[]    = ".cas";
5501ef3a5affSJacob Faibussowitsch   const char  extHDF5[]      = ".h5";
55026f2c871aSStefano Zampini   const char  extXDMFHDF5[]  = ".xdmf.h5";
5503ef3a5affSJacob Faibussowitsch   const char  extPLY[]       = ".ply";
5504ef3a5affSJacob Faibussowitsch   const char  extEGADSLite[] = ".egadslite";
5505ef3a5affSJacob Faibussowitsch   const char  extEGADS[]     = ".egads";
5506ef3a5affSJacob Faibussowitsch   const char  extIGES[]      = ".igs";
5507ef3a5affSJacob Faibussowitsch   const char  extSTEP[]      = ".stp";
5508ef3a5affSJacob Faibussowitsch   const char  extCV[]        = ".dat";
5509ca522641SMatthew G. Knepley   size_t      len;
55106afe31f6SMartin Diehl   PetscBool   isGmsh, isGmsh2, isGmsh4, isCGNS, isExodus, isGenesis, isFluent, isHDF5, isPLY, isEGADSLite, isEGADS, isIGES, isSTEP, isCV, isXDMFHDF5;
5511ca522641SMatthew G. Knepley   PetscMPIInt rank;
5512ca522641SMatthew G. Knepley 
5513ca522641SMatthew G. Knepley   PetscFunctionBegin;
55144f572ea9SToby Isaac   PetscAssertPointer(filename, 2);
55154f572ea9SToby Isaac   if (plexname) PetscAssertPointer(plexname, 3);
55164f572ea9SToby Isaac   PetscAssertPointer(dm, 5);
55179566063dSJacob Faibussowitsch   PetscCall(DMInitializePackage());
55189566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_CreateFromFile, 0, 0, 0, 0));
55199566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
55209566063dSJacob Faibussowitsch   PetscCall(PetscStrlen(filename, &len));
552128b400f6SJacob Faibussowitsch   PetscCheck(len, comm, PETSC_ERR_ARG_WRONG, "Filename must be a valid path");
5522ef3a5affSJacob Faibussowitsch 
55239371c9d4SSatish Balay #define CheckExtension(extension__, is_extension__) \
55249371c9d4SSatish Balay   do { \
5525274aaeaaSJacob Faibussowitsch     PetscAssert(sizeof(extension__), comm, PETSC_ERR_PLIB, "Zero-size extension: %s", extension__); \
5526274aaeaaSJacob Faibussowitsch     /* don't count the null-terminator at the end */ \
5527274aaeaaSJacob Faibussowitsch     const size_t ext_len = sizeof(extension__) - 1; \
5528274aaeaaSJacob Faibussowitsch     if (len < ext_len) { \
5529ef3a5affSJacob Faibussowitsch       is_extension__ = PETSC_FALSE; \
5530ef3a5affSJacob Faibussowitsch     } else { \
5531274aaeaaSJacob Faibussowitsch       PetscCall(PetscStrncmp(filename + len - ext_len, extension__, ext_len, &is_extension__)); \
5532ef3a5affSJacob Faibussowitsch     } \
5533ef3a5affSJacob Faibussowitsch   } while (0)
5534ef3a5affSJacob Faibussowitsch 
5535ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh, isGmsh);
5536ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh2, isGmsh2);
5537ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh4, isGmsh4);
5538ef3a5affSJacob Faibussowitsch   CheckExtension(extCGNS, isCGNS);
5539ef3a5affSJacob Faibussowitsch   CheckExtension(extExodus, isExodus);
5540ef3a5affSJacob Faibussowitsch   if (!isExodus) CheckExtension(extExodus_e, isExodus);
5541ef3a5affSJacob Faibussowitsch   CheckExtension(extGenesis, isGenesis);
5542ef3a5affSJacob Faibussowitsch   CheckExtension(extFluent, isFluent);
5543ef3a5affSJacob Faibussowitsch   CheckExtension(extHDF5, isHDF5);
5544ef3a5affSJacob Faibussowitsch   CheckExtension(extPLY, isPLY);
5545ef3a5affSJacob Faibussowitsch   CheckExtension(extEGADSLite, isEGADSLite);
5546ef3a5affSJacob Faibussowitsch   CheckExtension(extEGADS, isEGADS);
5547ef3a5affSJacob Faibussowitsch   CheckExtension(extIGES, isIGES);
5548ef3a5affSJacob Faibussowitsch   CheckExtension(extSTEP, isSTEP);
5549ef3a5affSJacob Faibussowitsch   CheckExtension(extCV, isCV);
55506f2c871aSStefano Zampini   CheckExtension(extXDMFHDF5, isXDMFHDF5);
5551ef3a5affSJacob Faibussowitsch 
5552ef3a5affSJacob Faibussowitsch #undef CheckExtension
5553ef3a5affSJacob Faibussowitsch 
5554de78e4feSLisandro Dalcin   if (isGmsh || isGmsh2 || isGmsh4) {
55559566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateGmshFromFile(comm, filename, interpolate, dm));
5556ca522641SMatthew G. Knepley   } else if (isCGNS) {
55579566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateCGNSFromFile(comm, filename, interpolate, dm));
555890c68965SMatthew G. Knepley   } else if (isExodus || isGenesis) {
55599566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateExodusFromFile(comm, filename, interpolate, dm));
55602f0bd6dcSMichael Lange   } else if (isFluent) {
55619566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFluentFromFile(comm, filename, interpolate, dm));
5562cc2f8f65SMatthew G. Knepley   } else if (isHDF5) {
5563cc2f8f65SMatthew G. Knepley     PetscViewer viewer;
5564cc2f8f65SMatthew G. Knepley 
556543b242b4SVaclav Hapla     /* PETSC_VIEWER_HDF5_XDMF is used if the filename ends with .xdmf.h5, or if -dm_plex_create_from_hdf5_xdmf option is present */
55666f2c871aSStefano Zampini     PetscCall(PetscOptionsGetBool(NULL, NULL, "-dm_plex_create_from_hdf5_xdmf", &isXDMFHDF5, NULL));
55679566063dSJacob Faibussowitsch     PetscCall(PetscViewerCreate(comm, &viewer));
55689566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetType(viewer, PETSCVIEWERHDF5));
55699566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetOptionsPrefix(viewer, "dm_plex_create_"));
55709566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetFromOptions(viewer));
55719566063dSJacob Faibussowitsch     PetscCall(PetscViewerFileSetMode(viewer, FILE_MODE_READ));
55729566063dSJacob Faibussowitsch     PetscCall(PetscViewerFileSetName(viewer, filename));
5573cd7e8a5eSksagiyam 
55749566063dSJacob Faibussowitsch     PetscCall(DMCreate(comm, dm));
55759566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)(*dm), plexname));
55769566063dSJacob Faibussowitsch     PetscCall(DMSetType(*dm, DMPLEX));
55776f2c871aSStefano Zampini     if (isXDMFHDF5) PetscCall(PetscViewerPushFormat(viewer, PETSC_VIEWER_HDF5_XDMF));
55789566063dSJacob Faibussowitsch     PetscCall(DMLoad(*dm, viewer));
55796f2c871aSStefano Zampini     if (isXDMFHDF5) PetscCall(PetscViewerPopFormat(viewer));
55809566063dSJacob Faibussowitsch     PetscCall(PetscViewerDestroy(&viewer));
55815fd9971aSMatthew G. Knepley 
55825fd9971aSMatthew G. Knepley     if (interpolate) {
55835fd9971aSMatthew G. Knepley       DM idm;
55845fd9971aSMatthew G. Knepley 
55859566063dSJacob Faibussowitsch       PetscCall(DMPlexInterpolate(*dm, &idm));
55869566063dSJacob Faibussowitsch       PetscCall(DMDestroy(dm));
55875fd9971aSMatthew G. Knepley       *dm = idm;
55885fd9971aSMatthew G. Knepley     }
5589f2801cd6SMatthew G. Knepley   } else if (isPLY) {
55909566063dSJacob Faibussowitsch     PetscCall(DMPlexCreatePLYFromFile(comm, filename, interpolate, dm));
5591c1cad2e7SMatthew G. Knepley   } else if (isEGADSLite || isEGADS || isIGES || isSTEP) {
55929566063dSJacob Faibussowitsch     if (isEGADSLite) PetscCall(DMPlexCreateEGADSLiteFromFile(comm, filename, dm));
55939566063dSJacob Faibussowitsch     else PetscCall(DMPlexCreateEGADSFromFile(comm, filename, dm));
55947bee2925SMatthew Knepley     if (!interpolate) {
55957bee2925SMatthew Knepley       DM udm;
55967bee2925SMatthew Knepley 
55979566063dSJacob Faibussowitsch       PetscCall(DMPlexUninterpolate(*dm, &udm));
55989566063dSJacob Faibussowitsch       PetscCall(DMDestroy(dm));
55997bee2925SMatthew Knepley       *dm = udm;
56007bee2925SMatthew Knepley     }
56018ca92349SMatthew G. Knepley   } else if (isCV) {
56029566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateCellVertexFromFile(comm, filename, interpolate, dm));
560398921bdaSJacob Faibussowitsch   } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Cannot load file %s: unrecognized extension", filename);
56049566063dSJacob Faibussowitsch   PetscCall(PetscStrlen(plexname, &len));
56059566063dSJacob Faibussowitsch   if (len) PetscCall(PetscObjectSetName((PetscObject)(*dm), plexname));
56069566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_CreateFromFile, 0, 0, 0, 0));
56073ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5608ca522641SMatthew G. Knepley }
560912b8a6daSStefano Zampini 
56109f6c5813SMatthew G. Knepley /*@C
56119f6c5813SMatthew G. Knepley   DMPlexCreateEphemeral - This takes a `DMPlexTransform` and a base `DMPlex` and produces an ephemeral `DM`, meaning one that is created on the fly in response to queries.
56129f6c5813SMatthew G. Knepley 
56130528010dSStefano Zampini   Input Parameters:
56140528010dSStefano Zampini + tr     - The `DMPlexTransform`
56150528010dSStefano Zampini - prefix - An options prefix, or NULL
56169f6c5813SMatthew G. Knepley 
56179f6c5813SMatthew G. Knepley   Output Parameter:
56189f6c5813SMatthew G. Knepley . dm - The `DM`
56199f6c5813SMatthew G. Knepley 
56209f6c5813SMatthew G. Knepley   Level: beginner
56219f6c5813SMatthew G. Knepley 
562220f4b53cSBarry Smith   Notes:
562320f4b53cSBarry Smith   An emphemeral mesh is one that is not stored concretely, as in the default `DMPLEX` implementation, but rather is produced on the fly in response to queries, using information from the transform and the base mesh.
562420f4b53cSBarry Smith 
56259f6c5813SMatthew G. Knepley .seealso: `DMPlexCreateFromFile`, `DMPlexCreateFromDAG()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`
56269f6c5813SMatthew G. Knepley @*/
56270528010dSStefano Zampini PetscErrorCode DMPlexCreateEphemeral(DMPlexTransform tr, const char prefix[], DM *dm)
56289f6c5813SMatthew G. Knepley {
56290528010dSStefano Zampini   DM           bdm, bcdm, cdm;
56300528010dSStefano Zampini   Vec          coordinates, coordinatesNew;
56310528010dSStefano Zampini   PetscSection cs;
56320528010dSStefano Zampini   PetscInt     dim, cdim, Nl;
56339f6c5813SMatthew G. Knepley 
56349f6c5813SMatthew G. Knepley   PetscFunctionBegin;
56359f6c5813SMatthew G. Knepley   PetscCall(DMCreate(PetscObjectComm((PetscObject)tr), dm));
56369f6c5813SMatthew G. Knepley   PetscCall(DMSetType(*dm, DMPLEX));
56370528010dSStefano Zampini   ((DM_Plex *)(*dm)->data)->interpolated = DMPLEX_INTERPOLATED_FULL;
56380528010dSStefano Zampini   // Handle coordinates
56390528010dSStefano Zampini   PetscCall(DMPlexTransformGetDM(tr, &bdm));
56400528010dSStefano Zampini   PetscCall(DMGetCoordinateDim(bdm, &cdim));
56410528010dSStefano Zampini   PetscCall(DMSetCoordinateDim(*dm, cdim));
56420528010dSStefano Zampini   PetscCall(DMGetDimension(bdm, &dim));
56430528010dSStefano Zampini   PetscCall(DMSetDimension(*dm, dim));
56440528010dSStefano Zampini   PetscCall(DMGetCoordinateDM(bdm, &bcdm));
56450528010dSStefano Zampini   PetscCall(DMGetCoordinateDM(*dm, &cdm));
56460528010dSStefano Zampini   PetscCall(DMCopyDisc(bcdm, cdm));
56470528010dSStefano Zampini   PetscCall(DMGetLocalSection(cdm, &cs));
56480528010dSStefano Zampini   PetscCall(PetscSectionSetNumFields(cs, 1));
56490528010dSStefano Zampini   PetscCall(PetscSectionSetFieldComponents(cs, 0, cdim));
56500528010dSStefano Zampini   PetscCall(DMGetCoordinatesLocal(bdm, &coordinates));
56510528010dSStefano Zampini   PetscCall(VecDuplicate(coordinates, &coordinatesNew));
56520528010dSStefano Zampini   PetscCall(VecCopy(coordinates, coordinatesNew));
56530528010dSStefano Zampini   PetscCall(DMSetCoordinatesLocal(*dm, coordinatesNew));
56540528010dSStefano Zampini   PetscCall(VecDestroy(&coordinatesNew));
56559f6c5813SMatthew G. Knepley 
56569f6c5813SMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)tr));
56579f6c5813SMatthew G. Knepley   PetscCall(DMPlexTransformDestroy(&((DM_Plex *)(*dm)->data)->tr));
56589f6c5813SMatthew G. Knepley   ((DM_Plex *)(*dm)->data)->tr = tr;
56590528010dSStefano Zampini   PetscCall(DMPlexDistributeSetDefault(*dm, PETSC_FALSE));
56600528010dSStefano Zampini   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)*dm, prefix));
56610528010dSStefano Zampini   PetscCall(DMSetFromOptions(*dm));
56629f6c5813SMatthew G. Knepley 
56639f6c5813SMatthew G. Knepley   PetscCall(DMGetNumLabels(bdm, &Nl));
56649f6c5813SMatthew G. Knepley   for (PetscInt l = 0; l < Nl; ++l) {
56659f6c5813SMatthew G. Knepley     DMLabel     label, labelNew;
56669f6c5813SMatthew G. Knepley     const char *lname;
56679f6c5813SMatthew G. Knepley     PetscBool   isDepth, isCellType;
56689f6c5813SMatthew G. Knepley 
56699f6c5813SMatthew G. Knepley     PetscCall(DMGetLabelName(bdm, l, &lname));
56709f6c5813SMatthew G. Knepley     PetscCall(PetscStrcmp(lname, "depth", &isDepth));
56719f6c5813SMatthew G. Knepley     if (isDepth) continue;
56729f6c5813SMatthew G. Knepley     PetscCall(PetscStrcmp(lname, "celltype", &isCellType));
56739f6c5813SMatthew G. Knepley     if (isCellType) continue;
56749f6c5813SMatthew G. Knepley     PetscCall(DMCreateLabel(*dm, lname));
56759f6c5813SMatthew G. Knepley     PetscCall(DMGetLabel(bdm, lname, &label));
56769f6c5813SMatthew G. Knepley     PetscCall(DMGetLabel(*dm, lname, &labelNew));
56779f6c5813SMatthew G. Knepley     PetscCall(DMLabelSetType(labelNew, DMLABELEPHEMERAL));
56789f6c5813SMatthew G. Knepley     PetscCall(DMLabelEphemeralSetLabel(labelNew, label));
56799f6c5813SMatthew G. Knepley     PetscCall(DMLabelEphemeralSetTransform(labelNew, tr));
56809f6c5813SMatthew G. Knepley     PetscCall(DMLabelSetUp(labelNew));
56819f6c5813SMatthew G. Knepley   }
56823ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
56839f6c5813SMatthew G. Knepley }
5684