xref: /petsc/src/dm/impls/plex/plexcreate.c (revision e44f6aeb0c7eee2716d50e70cd976c48a5d3c225)
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;
196858538eSMatthew G. Knepley   PetscBool                dist;
206bc1bd01Sksagiyam   DMPlexReorderDefaultFlag reorder;
21e600fa54SMatthew G. Knepley 
22e600fa54SMatthew G. Knepley   PetscFunctionBegin;
23e600fa54SMatthew G. Knepley   if (copyPeriodicity) {
244fb89dddSMatthew G. Knepley     PetscCall(DMGetPeriodicity(dmin, &maxCell, &Lstart, &L));
254fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dmout, maxCell, Lstart, L));
26e600fa54SMatthew G. Knepley   }
279566063dSJacob Faibussowitsch   PetscCall(DMPlexDistributeGetDefault(dmin, &dist));
289566063dSJacob Faibussowitsch   PetscCall(DMPlexDistributeSetDefault(dmout, dist));
296bc1bd01Sksagiyam   PetscCall(DMPlexReorderGetDefault(dmin, &reorder));
306bc1bd01Sksagiyam   PetscCall(DMPlexReorderSetDefault(dmout, reorder));
31e600fa54SMatthew G. Knepley   ((DM_Plex *)dmout->data)->useHashLocation = ((DM_Plex *)dmin->data)->useHashLocation;
321baa6e33SBarry Smith   if (copyOverlap) PetscCall(DMPlexSetOverlap_Plex(dmout, dmin, 0));
333ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
34e600fa54SMatthew G. Knepley }
35e600fa54SMatthew G. Knepley 
369318fe57SMatthew G. Knepley /* Replace dm with the contents of ndm, and then destroy ndm
379318fe57SMatthew G. Knepley    - Share the DM_Plex structure
389318fe57SMatthew G. Knepley    - Share the coordinates
399318fe57SMatthew G. Knepley    - Share the SF
409318fe57SMatthew G. Knepley */
41d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexReplace_Internal(DM dm, DM *ndm)
42d71ae5a4SJacob Faibussowitsch {
439318fe57SMatthew G. Knepley   PetscSF          sf;
449318fe57SMatthew G. Knepley   DM               dmNew = *ndm, coordDM, coarseDM;
459318fe57SMatthew G. Knepley   Vec              coords;
464fb89dddSMatthew G. Knepley   const PetscReal *maxCell, *Lstart, *L;
479318fe57SMatthew G. Knepley   PetscInt         dim, cdim;
489318fe57SMatthew G. Knepley 
499318fe57SMatthew G. Knepley   PetscFunctionBegin;
509318fe57SMatthew G. Knepley   if (dm == dmNew) {
519566063dSJacob Faibussowitsch     PetscCall(DMDestroy(ndm));
523ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
539318fe57SMatthew G. Knepley   }
549318fe57SMatthew G. Knepley   dm->setupcalled = dmNew->setupcalled;
559566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dmNew, &dim));
569566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
579566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dmNew, &cdim));
589566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, cdim));
599566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dmNew, &sf));
609566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dm, sf));
619566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dmNew, &coordDM));
629566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dmNew, &coords));
639566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDM(dm, coordDM));
649566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coords));
656858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dmNew, &coordDM));
666858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocal(dmNew, &coords));
676858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinateDM(dm, coordDM));
686858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinatesLocal(dm, coords));
699318fe57SMatthew G. Knepley   /* Do not want to create the coordinate field if it does not already exist, so do not call DMGetCoordinateField() */
706858538eSMatthew G. Knepley   PetscCall(DMFieldDestroy(&dm->coordinates[0].field));
716858538eSMatthew G. Knepley   dm->coordinates[0].field            = dmNew->coordinates[0].field;
7261a622f3SMatthew G. Knepley   ((DM_Plex *)dmNew->data)->coordFunc = ((DM_Plex *)dm->data)->coordFunc;
734fb89dddSMatthew G. Knepley   PetscCall(DMGetPeriodicity(dmNew, &maxCell, &Lstart, &L));
744fb89dddSMatthew G. Knepley   PetscCall(DMSetPeriodicity(dm, maxCell, Lstart, L));
759566063dSJacob Faibussowitsch   PetscCall(DMDestroy_Plex(dm));
769566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(dm));
779318fe57SMatthew G. Knepley   dm->data = dmNew->data;
789318fe57SMatthew G. Knepley   ((DM_Plex *)dmNew->data)->refct++;
795f06a3ddSJed Brown   PetscCall(DMPlexGetIsoperiodicFaceSF(dm, &sf));
805f06a3ddSJed Brown   PetscCall(DMPlexSetIsoperiodicFaceSF(dm, sf)); // for the compose function effect on dm
819566063dSJacob Faibussowitsch   PetscCall(DMDestroyLabelLinkList_Internal(dm));
829566063dSJacob Faibussowitsch   PetscCall(DMCopyLabels(dmNew, dm, PETSC_OWN_POINTER, PETSC_TRUE, DM_COPY_LABELS_FAIL));
839566063dSJacob Faibussowitsch   PetscCall(DMGetCoarseDM(dmNew, &coarseDM));
849566063dSJacob Faibussowitsch   PetscCall(DMSetCoarseDM(dm, coarseDM));
859566063dSJacob Faibussowitsch   PetscCall(DMDestroy(ndm));
863ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
879318fe57SMatthew G. Knepley }
889318fe57SMatthew G. Knepley 
899318fe57SMatthew G. Knepley /* Swap dm with the contents of dmNew
909318fe57SMatthew G. Knepley    - Swap the DM_Plex structure
919318fe57SMatthew G. Knepley    - Swap the coordinates
929318fe57SMatthew G. Knepley    - Swap the point PetscSF
939318fe57SMatthew G. Knepley */
94d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexSwap_Static(DM dmA, DM dmB)
95d71ae5a4SJacob Faibussowitsch {
969318fe57SMatthew G. Knepley   DM          coordDMA, coordDMB;
979318fe57SMatthew G. Knepley   Vec         coordsA, coordsB;
989318fe57SMatthew G. Knepley   PetscSF     sfA, sfB;
999318fe57SMatthew G. Knepley   DMField     fieldTmp;
1009318fe57SMatthew G. Knepley   void       *tmp;
1019318fe57SMatthew G. Knepley   DMLabelLink listTmp;
1029318fe57SMatthew G. Knepley   DMLabel     depthTmp;
1039318fe57SMatthew G. Knepley   PetscInt    tmpI;
1049318fe57SMatthew G. Knepley 
1059318fe57SMatthew G. Knepley   PetscFunctionBegin;
1063ba16761SJacob Faibussowitsch   if (dmA == dmB) PetscFunctionReturn(PETSC_SUCCESS);
1079566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dmA, &sfA));
1089566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dmB, &sfB));
1099566063dSJacob Faibussowitsch   PetscCall(PetscObjectReference((PetscObject)sfA));
1109566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dmA, sfB));
1119566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dmB, sfA));
1129566063dSJacob Faibussowitsch   PetscCall(PetscObjectDereference((PetscObject)sfA));
1139318fe57SMatthew G. Knepley 
1149566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dmA, &coordDMA));
1159566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dmB, &coordDMB));
1169566063dSJacob Faibussowitsch   PetscCall(PetscObjectReference((PetscObject)coordDMA));
1179566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDM(dmA, coordDMB));
1189566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDM(dmB, coordDMA));
1199566063dSJacob Faibussowitsch   PetscCall(PetscObjectDereference((PetscObject)coordDMA));
1209318fe57SMatthew G. Knepley 
1219566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dmA, &coordsA));
1229566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dmB, &coordsB));
1239566063dSJacob Faibussowitsch   PetscCall(PetscObjectReference((PetscObject)coordsA));
1249566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dmA, coordsB));
1259566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dmB, coordsA));
1269566063dSJacob Faibussowitsch   PetscCall(PetscObjectDereference((PetscObject)coordsA));
1279318fe57SMatthew G. Knepley 
1286858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dmA, &coordDMA));
1296858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dmB, &coordDMB));
1306858538eSMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)coordDMA));
1316858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinateDM(dmA, coordDMB));
1326858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinateDM(dmB, coordDMA));
1336858538eSMatthew G. Knepley   PetscCall(PetscObjectDereference((PetscObject)coordDMA));
1346858538eSMatthew G. Knepley 
1356858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocal(dmA, &coordsA));
1366858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocal(dmB, &coordsB));
1376858538eSMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)coordsA));
1386858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinatesLocal(dmA, coordsB));
1396858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinatesLocal(dmB, coordsA));
1406858538eSMatthew G. Knepley   PetscCall(PetscObjectDereference((PetscObject)coordsA));
1416858538eSMatthew G. Knepley 
1426858538eSMatthew G. Knepley   fieldTmp                  = dmA->coordinates[0].field;
1436858538eSMatthew G. Knepley   dmA->coordinates[0].field = dmB->coordinates[0].field;
1446858538eSMatthew G. Knepley   dmB->coordinates[0].field = fieldTmp;
1456858538eSMatthew G. Knepley   fieldTmp                  = dmA->coordinates[1].field;
1466858538eSMatthew G. Knepley   dmA->coordinates[1].field = dmB->coordinates[1].field;
1476858538eSMatthew G. Knepley   dmB->coordinates[1].field = fieldTmp;
1489318fe57SMatthew G. Knepley   tmp                       = dmA->data;
1499318fe57SMatthew G. Knepley   dmA->data                 = dmB->data;
1509318fe57SMatthew G. Knepley   dmB->data                 = tmp;
1519318fe57SMatthew G. Knepley   listTmp                   = dmA->labels;
1529318fe57SMatthew G. Knepley   dmA->labels               = dmB->labels;
1539318fe57SMatthew G. Knepley   dmB->labels               = listTmp;
1549318fe57SMatthew G. Knepley   depthTmp                  = dmA->depthLabel;
1559318fe57SMatthew G. Knepley   dmA->depthLabel           = dmB->depthLabel;
1569318fe57SMatthew G. Knepley   dmB->depthLabel           = depthTmp;
1579318fe57SMatthew G. Knepley   depthTmp                  = dmA->celltypeLabel;
1589318fe57SMatthew G. Knepley   dmA->celltypeLabel        = dmB->celltypeLabel;
1599318fe57SMatthew G. Knepley   dmB->celltypeLabel        = depthTmp;
1609318fe57SMatthew G. Knepley   tmpI                      = dmA->levelup;
1619318fe57SMatthew G. Knepley   dmA->levelup              = dmB->levelup;
1629318fe57SMatthew G. Knepley   dmB->levelup              = tmpI;
1633ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1649318fe57SMatthew G. Knepley }
1659318fe57SMatthew G. Knepley 
1663431e603SJed Brown PetscErrorCode DMPlexInterpolateInPlace_Internal(DM dm)
167d71ae5a4SJacob Faibussowitsch {
1689318fe57SMatthew G. Knepley   DM idm;
1699318fe57SMatthew G. Knepley 
1709318fe57SMatthew G. Knepley   PetscFunctionBegin;
1719566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolate(dm, &idm));
1729566063dSJacob Faibussowitsch   PetscCall(DMPlexCopyCoordinates(dm, idm));
17369d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &idm));
1743ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1759318fe57SMatthew G. Knepley }
1769318fe57SMatthew G. Knepley 
1779318fe57SMatthew G. Knepley /*@C
1789318fe57SMatthew G. Knepley   DMPlexCreateCoordinateSpace - Creates a finite element space for the coordinates
1799318fe57SMatthew G. Knepley 
18020f4b53cSBarry Smith   Collective
1819318fe57SMatthew G. Knepley 
1829318fe57SMatthew G. Knepley   Input Parameters:
18360225df5SJacob Faibussowitsch + dm        - The `DMPLEX`
18420f4b53cSBarry Smith . degree    - The degree of the finite element or `PETSC_DECIDE`
185*e44f6aebSMatthew G. Knepley . project   - Flag to project current coordinates into the space
1869318fe57SMatthew G. Knepley - coordFunc - An optional function to map new points from refinement to the surface
1879318fe57SMatthew G. Knepley 
1889318fe57SMatthew G. Knepley   Level: advanced
1899318fe57SMatthew G. Knepley 
1901cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `PetscPointFunc`, `PetscFECreateLagrange()`, `DMGetCoordinateDM()`
1919318fe57SMatthew G. Knepley @*/
192*e44f6aebSMatthew G. Knepley PetscErrorCode DMPlexCreateCoordinateSpace(DM dm, PetscInt degree, PetscBool project, PetscPointFunc coordFunc)
193d71ae5a4SJacob Faibussowitsch {
1949318fe57SMatthew G. Knepley   DM_Plex *mesh = (DM_Plex *)dm->data;
195*e44f6aebSMatthew G. Knepley   PetscFE  fe   = NULL;
1969318fe57SMatthew G. Knepley   DM       cdm;
1979318fe57SMatthew G. Knepley   PetscInt dim, dE, qorder;
1989318fe57SMatthew G. Knepley 
199*e44f6aebSMatthew G. Knepley   PetscFunctionBegin;
2009566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
2019566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &dE));
2029318fe57SMatthew G. Knepley   qorder = degree;
203*e44f6aebSMatthew G. Knepley   PetscCall(DMGetCoordinateDM(dm, &cdm));
204d0609cedSBarry Smith   PetscObjectOptionsBegin((PetscObject)cdm);
205dc431b0cSMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-default_quadrature_order", "Quadrature order is one less than quadrature points per edge", "DMPlexCreateCoordinateSpace", qorder, &qorder, NULL, 0));
206d0609cedSBarry Smith   PetscOptionsEnd();
207*e44f6aebSMatthew G. Knepley   if (degree >= 0) {
208*e44f6aebSMatthew G. Knepley     DMPolytopeType ct = DM_POLYTOPE_UNKNOWN;
209*e44f6aebSMatthew G. Knepley     PetscInt       cStart, cEnd, gct;
210dc431b0cSMatthew G. Knepley 
211dc431b0cSMatthew G. Knepley     PetscCall(DMPlexGetHeightStratum(dm, 0, &cStart, &cEnd));
212dc431b0cSMatthew G. Knepley     if (cEnd > cStart) PetscCall(DMPlexGetCellType(dm, cStart, &ct));
213*e44f6aebSMatthew G. Knepley     gct = (PetscInt)ct;
214*e44f6aebSMatthew G. Knepley     PetscCall(MPIU_Allreduce(MPI_IN_PLACE, &gct, 1, MPIU_INT, MPI_MIN, PetscObjectComm((PetscObject)dm)));
215*e44f6aebSMatthew G. Knepley     ct = (DMPolytopeType)gct;
216*e44f6aebSMatthew G. Knepley     // Work around current bug in PetscDualSpaceSetUp_Lagrange()
217*e44f6aebSMatthew G. Knepley     //   Can be seen in plex_tutorials-ex10_1
218*e44f6aebSMatthew 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));
2194f9ab2b4SJed Brown   }
220*e44f6aebSMatthew G. Knepley   PetscCall(DMSetCoordinateDisc(dm, fe, project));
2219566063dSJacob Faibussowitsch   PetscCall(PetscFEDestroy(&fe));
2229318fe57SMatthew G. Knepley   mesh->coordFunc = coordFunc;
2233ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2249318fe57SMatthew G. Knepley }
2259318fe57SMatthew G. Knepley 
2261df5d5c5SMatthew G. Knepley /*@
2271df5d5c5SMatthew G. Knepley   DMPlexCreateDoublet - Creates a mesh of two cells of the specified type, optionally with later refinement.
2281df5d5c5SMatthew G. Knepley 
229d083f849SBarry Smith   Collective
2301df5d5c5SMatthew G. Knepley 
2311df5d5c5SMatthew G. Knepley   Input Parameters:
232a1cb98faSBarry Smith + comm            - The communicator for the `DM` object
2331df5d5c5SMatthew G. Knepley . dim             - The spatial dimension
2341df5d5c5SMatthew G. Knepley . simplex         - Flag for simplicial cells, otherwise they are tensor product cells
2351df5d5c5SMatthew G. Knepley . interpolate     - Flag to create intermediate mesh pieces (edges, faces)
2361df5d5c5SMatthew G. Knepley - refinementLimit - A nonzero number indicates the largest admissible volume for a refined cell
2371df5d5c5SMatthew G. Knepley 
2381df5d5c5SMatthew G. Knepley   Output Parameter:
23960225df5SJacob Faibussowitsch . newdm - The `DM` object
2401df5d5c5SMatthew G. Knepley 
2411df5d5c5SMatthew G. Knepley   Level: beginner
2421df5d5c5SMatthew G. Knepley 
2431cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMSetType()`, `DMCreate()`
2441df5d5c5SMatthew G. Knepley @*/
245d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateDoublet(MPI_Comm comm, PetscInt dim, PetscBool simplex, PetscBool interpolate, PetscReal refinementLimit, DM *newdm)
246d71ae5a4SJacob Faibussowitsch {
2471df5d5c5SMatthew G. Knepley   DM          dm;
2481df5d5c5SMatthew G. Knepley   PetscMPIInt rank;
2491df5d5c5SMatthew G. Knepley 
2501df5d5c5SMatthew G. Knepley   PetscFunctionBegin;
2519566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, &dm));
2529566063dSJacob Faibussowitsch   PetscCall(DMSetType(dm, DMPLEX));
2539566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
25446139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
2559566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
256ce78fa2fSMatthew G. Knepley   switch (dim) {
257ce78fa2fSMatthew G. Knepley   case 2:
2589566063dSJacob Faibussowitsch     if (simplex) PetscCall(PetscObjectSetName((PetscObject)dm, "triangular"));
2599566063dSJacob Faibussowitsch     else PetscCall(PetscObjectSetName((PetscObject)dm, "quadrilateral"));
260ce78fa2fSMatthew G. Knepley     break;
261ce78fa2fSMatthew G. Knepley   case 3:
2629566063dSJacob Faibussowitsch     if (simplex) PetscCall(PetscObjectSetName((PetscObject)dm, "tetrahedral"));
2639566063dSJacob Faibussowitsch     else PetscCall(PetscObjectSetName((PetscObject)dm, "hexahedral"));
264ce78fa2fSMatthew G. Knepley     break;
265d71ae5a4SJacob Faibussowitsch   default:
266d71ae5a4SJacob Faibussowitsch     SETERRQ(comm, PETSC_ERR_ARG_OUTOFRANGE, "Cannot make meshes for dimension %" PetscInt_FMT, dim);
267ce78fa2fSMatthew G. Knepley   }
2681df5d5c5SMatthew G. Knepley   if (rank) {
2691df5d5c5SMatthew G. Knepley     PetscInt numPoints[2] = {0, 0};
2709566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, NULL, NULL, NULL, NULL));
2711df5d5c5SMatthew G. Knepley   } else {
2721df5d5c5SMatthew G. Knepley     switch (dim) {
2731df5d5c5SMatthew G. Knepley     case 2:
2741df5d5c5SMatthew G. Knepley       if (simplex) {
2751df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]        = {4, 2};
2761df5d5c5SMatthew G. Knepley         PetscInt    coneSize[6]         = {3, 3, 0, 0, 0, 0};
2771df5d5c5SMatthew G. Knepley         PetscInt    cones[6]            = {2, 3, 4, 5, 4, 3};
2781df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
2791df5d5c5SMatthew G. Knepley         PetscScalar vertexCoords[8]     = {-0.5, 0.5, 0.0, 0.0, 0.0, 1.0, 0.5, 0.5};
2801df5d5c5SMatthew G. Knepley 
2819566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
2821df5d5c5SMatthew G. Knepley       } else {
2831df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]        = {6, 2};
2841df5d5c5SMatthew G. Knepley         PetscInt    coneSize[8]         = {4, 4, 0, 0, 0, 0, 0, 0};
2851df5d5c5SMatthew G. Knepley         PetscInt    cones[8]            = {2, 3, 4, 5, 3, 6, 7, 4};
2861df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
2871df5d5c5SMatthew 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};
2881df5d5c5SMatthew G. Knepley 
2899566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
2901df5d5c5SMatthew G. Knepley       }
2911df5d5c5SMatthew G. Knepley       break;
2921df5d5c5SMatthew G. Knepley     case 3:
2931df5d5c5SMatthew G. Knepley       if (simplex) {
2941df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]        = {5, 2};
2951df5d5c5SMatthew G. Knepley         PetscInt    coneSize[7]         = {4, 4, 0, 0, 0, 0, 0};
2961df5d5c5SMatthew G. Knepley         PetscInt    cones[8]            = {4, 3, 5, 2, 5, 3, 4, 6};
2971df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
2981df5d5c5SMatthew 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};
2991df5d5c5SMatthew G. Knepley 
3009566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
3011df5d5c5SMatthew G. Knepley       } else {
3021df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]         = {12, 2};
3031df5d5c5SMatthew G. Knepley         PetscInt    coneSize[14]         = {8, 8, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
3041df5d5c5SMatthew G. Knepley         PetscInt    cones[16]            = {2, 3, 4, 5, 6, 7, 8, 9, 5, 4, 10, 11, 7, 12, 13, 8};
3051df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[16] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
3069371c9d4SSatish 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};
3071df5d5c5SMatthew G. Knepley 
3089566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
3091df5d5c5SMatthew G. Knepley       }
3101df5d5c5SMatthew G. Knepley       break;
311d71ae5a4SJacob Faibussowitsch     default:
312d71ae5a4SJacob Faibussowitsch       SETERRQ(comm, PETSC_ERR_ARG_OUTOFRANGE, "Cannot make meshes for dimension %" PetscInt_FMT, dim);
3131df5d5c5SMatthew G. Knepley     }
3141df5d5c5SMatthew G. Knepley   }
31546139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
3161df5d5c5SMatthew G. Knepley   *newdm = dm;
3171df5d5c5SMatthew G. Knepley   if (refinementLimit > 0.0) {
3181df5d5c5SMatthew G. Knepley     DM          rdm;
3191df5d5c5SMatthew G. Knepley     const char *name;
3201df5d5c5SMatthew G. Knepley 
3219566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementUniform(*newdm, PETSC_FALSE));
3229566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementLimit(*newdm, refinementLimit));
3239566063dSJacob Faibussowitsch     PetscCall(DMRefine(*newdm, comm, &rdm));
3249566063dSJacob Faibussowitsch     PetscCall(PetscObjectGetName((PetscObject)*newdm, &name));
3259566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)rdm, name));
3269566063dSJacob Faibussowitsch     PetscCall(DMDestroy(newdm));
3271df5d5c5SMatthew G. Knepley     *newdm = rdm;
3281df5d5c5SMatthew G. Knepley   }
3291df5d5c5SMatthew G. Knepley   if (interpolate) {
3305fd9971aSMatthew G. Knepley     DM idm;
3311df5d5c5SMatthew G. Knepley 
3329566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*newdm, &idm));
3339566063dSJacob Faibussowitsch     PetscCall(DMDestroy(newdm));
3341df5d5c5SMatthew G. Knepley     *newdm = idm;
3351df5d5c5SMatthew G. Knepley   }
3363ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3371df5d5c5SMatthew G. Knepley }
3381df5d5c5SMatthew G. Knepley 
339d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Tensor_1D_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[])
340d71ae5a4SJacob Faibussowitsch {
3419318fe57SMatthew G. Knepley   const PetscInt numVertices    = 2;
3429318fe57SMatthew G. Knepley   PetscInt       markerRight    = 1;
3439318fe57SMatthew G. Knepley   PetscInt       markerLeft     = 1;
3449318fe57SMatthew G. Knepley   PetscBool      markerSeparate = PETSC_FALSE;
3459318fe57SMatthew G. Knepley   Vec            coordinates;
3469318fe57SMatthew G. Knepley   PetscSection   coordSection;
3479318fe57SMatthew G. Knepley   PetscScalar   *coords;
3489318fe57SMatthew G. Knepley   PetscInt       coordSize;
3499318fe57SMatthew G. Knepley   PetscMPIInt    rank;
3509318fe57SMatthew G. Knepley   PetscInt       cdim = 1, v;
351552f7358SJed Brown 
3529318fe57SMatthew G. Knepley   PetscFunctionBegin;
3539566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
3549318fe57SMatthew G. Knepley   if (markerSeparate) {
3559318fe57SMatthew G. Knepley     markerRight = 2;
3569318fe57SMatthew G. Knepley     markerLeft  = 1;
3579318fe57SMatthew G. Knepley   }
3589566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
359c5853193SPierre Jolivet   if (rank == 0) {
3609566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numVertices));
3619566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
3629566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", 0, markerLeft));
3639566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", 1, markerRight));
3649318fe57SMatthew G. Knepley   }
3659566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
3669566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
3679318fe57SMatthew G. Knepley   /* Build coordinates */
3689566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, cdim));
3699566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
3709566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
3719566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, 0, numVertices));
3729566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, cdim));
3739318fe57SMatthew G. Knepley   for (v = 0; v < numVertices; ++v) {
3749566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, cdim));
3759566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, cdim));
3769318fe57SMatthew G. Knepley   }
3779566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
3789566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
3799566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
3809566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
3819566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
3829566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, cdim));
3839566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
3849566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
3859318fe57SMatthew G. Knepley   coords[0] = lower[0];
3869318fe57SMatthew G. Knepley   coords[1] = upper[0];
3879566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
3889566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
3899566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
3903ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3919318fe57SMatthew G. Knepley }
39226492d91SMatthew G. Knepley 
393d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Tensor_2D_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[])
394d71ae5a4SJacob Faibussowitsch {
3951df21d24SMatthew G. Knepley   const PetscInt numVertices    = (edges[0] + 1) * (edges[1] + 1);
3961df21d24SMatthew G. Knepley   const PetscInt numEdges       = edges[0] * (edges[1] + 1) + (edges[0] + 1) * edges[1];
397552f7358SJed Brown   PetscInt       markerTop      = 1;
398552f7358SJed Brown   PetscInt       markerBottom   = 1;
399552f7358SJed Brown   PetscInt       markerRight    = 1;
400552f7358SJed Brown   PetscInt       markerLeft     = 1;
401552f7358SJed Brown   PetscBool      markerSeparate = PETSC_FALSE;
402552f7358SJed Brown   Vec            coordinates;
403552f7358SJed Brown   PetscSection   coordSection;
404552f7358SJed Brown   PetscScalar   *coords;
405552f7358SJed Brown   PetscInt       coordSize;
406552f7358SJed Brown   PetscMPIInt    rank;
407552f7358SJed Brown   PetscInt       v, vx, vy;
408552f7358SJed Brown 
409552f7358SJed Brown   PetscFunctionBegin;
4109566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
411552f7358SJed Brown   if (markerSeparate) {
4121df21d24SMatthew G. Knepley     markerTop    = 3;
4131df21d24SMatthew G. Knepley     markerBottom = 1;
4141df21d24SMatthew G. Knepley     markerRight  = 2;
4151df21d24SMatthew G. Knepley     markerLeft   = 4;
416552f7358SJed Brown   }
4179566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
418dd400576SPatrick Sanan   if (rank == 0) {
419552f7358SJed Brown     PetscInt e, ex, ey;
420552f7358SJed Brown 
4219566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numEdges + numVertices));
42248a46eb9SPierre Jolivet     for (e = 0; e < numEdges; ++e) PetscCall(DMPlexSetConeSize(dm, e, 2));
4239566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
424552f7358SJed Brown     for (vx = 0; vx <= edges[0]; vx++) {
425552f7358SJed Brown       for (ey = 0; ey < edges[1]; ey++) {
426552f7358SJed Brown         PetscInt edge   = vx * edges[1] + ey + edges[0] * (edges[1] + 1);
427552f7358SJed Brown         PetscInt vertex = ey * (edges[0] + 1) + vx + numEdges;
428da80777bSKarl Rupp         PetscInt cone[2];
429552f7358SJed Brown 
4309371c9d4SSatish Balay         cone[0] = vertex;
4319371c9d4SSatish Balay         cone[1] = vertex + edges[0] + 1;
4329566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, edge, cone));
433552f7358SJed Brown         if (vx == edges[0]) {
4349566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
4359566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
436552f7358SJed Brown           if (ey == edges[1] - 1) {
4379566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
4389566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerRight));
439552f7358SJed Brown           }
440552f7358SJed Brown         } else if (vx == 0) {
4419566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
4429566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
443552f7358SJed Brown           if (ey == edges[1] - 1) {
4449566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
4459566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerLeft));
446552f7358SJed Brown           }
447552f7358SJed Brown         }
448552f7358SJed Brown       }
449552f7358SJed Brown     }
450552f7358SJed Brown     for (vy = 0; vy <= edges[1]; vy++) {
451552f7358SJed Brown       for (ex = 0; ex < edges[0]; ex++) {
452552f7358SJed Brown         PetscInt edge   = vy * edges[0] + ex;
453552f7358SJed Brown         PetscInt vertex = vy * (edges[0] + 1) + ex + numEdges;
454da80777bSKarl Rupp         PetscInt cone[2];
455552f7358SJed Brown 
4569371c9d4SSatish Balay         cone[0] = vertex;
4579371c9d4SSatish Balay         cone[1] = vertex + 1;
4589566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, edge, cone));
459552f7358SJed Brown         if (vy == edges[1]) {
4609566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
4619566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
462552f7358SJed Brown           if (ex == edges[0] - 1) {
4639566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
4649566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerTop));
465552f7358SJed Brown           }
466552f7358SJed Brown         } else if (vy == 0) {
4679566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
4689566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
469552f7358SJed Brown           if (ex == edges[0] - 1) {
4709566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
4719566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerBottom));
472552f7358SJed Brown           }
473552f7358SJed Brown         }
474552f7358SJed Brown       }
475552f7358SJed Brown     }
476552f7358SJed Brown   }
4779566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
4789566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
479552f7358SJed Brown   /* Build coordinates */
4809566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, 2));
4819566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
4829566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
4839566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, numEdges, numEdges + numVertices));
4849566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, 2));
485552f7358SJed Brown   for (v = numEdges; v < numEdges + numVertices; ++v) {
4869566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, 2));
4879566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, 2));
488552f7358SJed Brown   }
4899566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
4909566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
4919566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
4929566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
4939566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
4949566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, 2));
4959566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
4969566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
497552f7358SJed Brown   for (vy = 0; vy <= edges[1]; ++vy) {
498552f7358SJed Brown     for (vx = 0; vx <= edges[0]; ++vx) {
499552f7358SJed Brown       coords[(vy * (edges[0] + 1) + vx) * 2 + 0] = lower[0] + ((upper[0] - lower[0]) / edges[0]) * vx;
500552f7358SJed Brown       coords[(vy * (edges[0] + 1) + vx) * 2 + 1] = lower[1] + ((upper[1] - lower[1]) / edges[1]) * vy;
501552f7358SJed Brown     }
502552f7358SJed Brown   }
5039566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
5049566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
5059566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
5063ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
507552f7358SJed Brown }
508552f7358SJed Brown 
509d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Tensor_3D_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt faces[])
510d71ae5a4SJacob Faibussowitsch {
5119e8abbc3SMichael Lange   PetscInt     vertices[3], numVertices;
5127b59f5a9SMichael Lange   PetscInt     numFaces       = 2 * faces[0] * faces[1] + 2 * faces[1] * faces[2] + 2 * faces[0] * faces[2];
513c2df9bbfSMatthew G. Knepley   PetscInt     markerTop      = 1;
514c2df9bbfSMatthew G. Knepley   PetscInt     markerBottom   = 1;
515c2df9bbfSMatthew G. Knepley   PetscInt     markerFront    = 1;
516c2df9bbfSMatthew G. Knepley   PetscInt     markerBack     = 1;
517c2df9bbfSMatthew G. Knepley   PetscInt     markerRight    = 1;
518c2df9bbfSMatthew G. Knepley   PetscInt     markerLeft     = 1;
519c2df9bbfSMatthew G. Knepley   PetscBool    markerSeparate = PETSC_FALSE;
520552f7358SJed Brown   Vec          coordinates;
521552f7358SJed Brown   PetscSection coordSection;
522552f7358SJed Brown   PetscScalar *coords;
523552f7358SJed Brown   PetscInt     coordSize;
524552f7358SJed Brown   PetscMPIInt  rank;
525552f7358SJed Brown   PetscInt     v, vx, vy, vz;
5267b59f5a9SMichael Lange   PetscInt     voffset, iface = 0, cone[4];
527552f7358SJed Brown 
528552f7358SJed Brown   PetscFunctionBegin;
5291dca8a05SBarry 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");
5309566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
531c2df9bbfSMatthew G. Knepley   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
532c2df9bbfSMatthew G. Knepley   if (markerSeparate) {
533c2df9bbfSMatthew G. Knepley     markerBottom = 1;
534c2df9bbfSMatthew G. Knepley     markerTop    = 2;
535c2df9bbfSMatthew G. Knepley     markerFront  = 3;
536c2df9bbfSMatthew G. Knepley     markerBack   = 4;
537c2df9bbfSMatthew G. Knepley     markerRight  = 5;
538c2df9bbfSMatthew G. Knepley     markerLeft   = 6;
539c2df9bbfSMatthew G. Knepley   }
5409371c9d4SSatish Balay   vertices[0] = faces[0] + 1;
5419371c9d4SSatish Balay   vertices[1] = faces[1] + 1;
5429371c9d4SSatish Balay   vertices[2] = faces[2] + 1;
5439e8abbc3SMichael Lange   numVertices = vertices[0] * vertices[1] * vertices[2];
544dd400576SPatrick Sanan   if (rank == 0) {
545552f7358SJed Brown     PetscInt f;
546552f7358SJed Brown 
5479566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numFaces + numVertices));
54848a46eb9SPierre Jolivet     for (f = 0; f < numFaces; ++f) PetscCall(DMPlexSetConeSize(dm, f, 4));
5499566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
5507b59f5a9SMichael Lange 
5517b59f5a9SMichael Lange     /* Side 0 (Top) */
5527b59f5a9SMichael Lange     for (vy = 0; vy < faces[1]; vy++) {
5537b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
5547b59f5a9SMichael Lange         voffset = numFaces + vertices[0] * vertices[1] * (vertices[2] - 1) + vy * vertices[0] + vx;
5559371c9d4SSatish Balay         cone[0] = voffset;
5569371c9d4SSatish Balay         cone[1] = voffset + 1;
5579371c9d4SSatish Balay         cone[2] = voffset + vertices[0] + 1;
5589371c9d4SSatish Balay         cone[3] = voffset + vertices[0];
5599566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
560c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerTop));
561c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerTop));
562c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerTop));
563c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerTop));
564c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 1, markerTop));
5657b59f5a9SMichael Lange         iface++;
566552f7358SJed Brown       }
567552f7358SJed Brown     }
5687b59f5a9SMichael Lange 
5697b59f5a9SMichael Lange     /* Side 1 (Bottom) */
5707b59f5a9SMichael Lange     for (vy = 0; vy < faces[1]; vy++) {
5717b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
5727b59f5a9SMichael Lange         voffset = numFaces + vy * (faces[0] + 1) + vx;
5739371c9d4SSatish Balay         cone[0] = voffset + 1;
5749371c9d4SSatish Balay         cone[1] = voffset;
5759371c9d4SSatish Balay         cone[2] = voffset + vertices[0];
5769371c9d4SSatish Balay         cone[3] = voffset + vertices[0] + 1;
5779566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
578c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerBottom));
579c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerBottom));
580c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerBottom));
581c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerBottom));
582c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 1, markerBottom));
5837b59f5a9SMichael Lange         iface++;
584552f7358SJed Brown       }
585552f7358SJed Brown     }
5867b59f5a9SMichael Lange 
5877b59f5a9SMichael Lange     /* Side 2 (Front) */
5887b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
5897b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
5907b59f5a9SMichael Lange         voffset = numFaces + vz * vertices[0] * vertices[1] + vx;
5919371c9d4SSatish Balay         cone[0] = voffset;
5929371c9d4SSatish Balay         cone[1] = voffset + 1;
5939371c9d4SSatish Balay         cone[2] = voffset + vertices[0] * vertices[1] + 1;
5949371c9d4SSatish Balay         cone[3] = voffset + vertices[0] * vertices[1];
5959566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
596c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerFront));
597c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerFront));
598c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerFront));
599c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 0, markerFront));
600c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 1, markerFront));
6017b59f5a9SMichael Lange         iface++;
602552f7358SJed Brown       }
6037b59f5a9SMichael Lange     }
6047b59f5a9SMichael Lange 
6057b59f5a9SMichael Lange     /* Side 3 (Back) */
6067b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
6077b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
6087b59f5a9SMichael Lange         voffset = numFaces + vz * vertices[0] * vertices[1] + vertices[0] * (vertices[1] - 1) + vx;
6099371c9d4SSatish Balay         cone[0] = voffset + vertices[0] * vertices[1];
6109371c9d4SSatish Balay         cone[1] = voffset + vertices[0] * vertices[1] + 1;
6119371c9d4SSatish Balay         cone[2] = voffset + 1;
6129371c9d4SSatish Balay         cone[3] = voffset;
6139566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
614c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerBack));
615c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerBack));
616c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerBack));
617c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 0, markerBack));
618c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 1, markerBack));
6197b59f5a9SMichael Lange         iface++;
6207b59f5a9SMichael Lange       }
6217b59f5a9SMichael Lange     }
6227b59f5a9SMichael Lange 
6237b59f5a9SMichael Lange     /* Side 4 (Left) */
6247b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
6257b59f5a9SMichael Lange       for (vy = 0; vy < faces[1]; vy++) {
6267b59f5a9SMichael Lange         voffset = numFaces + vz * vertices[0] * vertices[1] + vy * vertices[0];
6279371c9d4SSatish Balay         cone[0] = voffset;
6289371c9d4SSatish Balay         cone[1] = voffset + vertices[0] * vertices[1];
6299371c9d4SSatish Balay         cone[2] = voffset + vertices[0] * vertices[1] + vertices[0];
6309371c9d4SSatish Balay         cone[3] = voffset + vertices[0];
6319566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
632c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerLeft));
633c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerLeft));
634c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerLeft));
635c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[1] + 0, markerLeft));
636c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + vertices[0], markerLeft));
6377b59f5a9SMichael Lange         iface++;
6387b59f5a9SMichael Lange       }
6397b59f5a9SMichael Lange     }
6407b59f5a9SMichael Lange 
6417b59f5a9SMichael Lange     /* Side 5 (Right) */
6427b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
6437b59f5a9SMichael Lange       for (vy = 0; vy < faces[1]; vy++) {
644aab5bcd8SJed Brown         voffset = numFaces + vz * vertices[0] * vertices[1] + vy * vertices[0] + faces[0];
6459371c9d4SSatish Balay         cone[0] = voffset + vertices[0] * vertices[1];
6469371c9d4SSatish Balay         cone[1] = voffset;
6479371c9d4SSatish Balay         cone[2] = voffset + vertices[0];
6489371c9d4SSatish Balay         cone[3] = voffset + vertices[0] * vertices[1] + vertices[0];
6499566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
650c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerRight));
651c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerRight));
652c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerRight));
653c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 0, markerRight));
654c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + vertices[0], markerRight));
6557b59f5a9SMichael Lange         iface++;
6567b59f5a9SMichael Lange       }
657552f7358SJed Brown     }
658552f7358SJed Brown   }
6599566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
6609566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
661552f7358SJed Brown   /* Build coordinates */
6629566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, 3));
6639566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
6649566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
6659566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, numFaces, numFaces + numVertices));
6669566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, 3));
667552f7358SJed Brown   for (v = numFaces; v < numFaces + numVertices; ++v) {
6689566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, 3));
6699566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, 3));
670552f7358SJed Brown   }
6719566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
6729566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
6739566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
6749566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
6759566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
6769566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, 3));
6779566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
6789566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
679552f7358SJed Brown   for (vz = 0; vz <= faces[2]; ++vz) {
680552f7358SJed Brown     for (vy = 0; vy <= faces[1]; ++vy) {
681552f7358SJed Brown       for (vx = 0; vx <= faces[0]; ++vx) {
682552f7358SJed Brown         coords[((vz * (faces[1] + 1) + vy) * (faces[0] + 1) + vx) * 3 + 0] = lower[0] + ((upper[0] - lower[0]) / faces[0]) * vx;
683552f7358SJed Brown         coords[((vz * (faces[1] + 1) + vy) * (faces[0] + 1) + vx) * 3 + 1] = lower[1] + ((upper[1] - lower[1]) / faces[1]) * vy;
684552f7358SJed Brown         coords[((vz * (faces[1] + 1) + vy) * (faces[0] + 1) + vx) * 3 + 2] = lower[2] + ((upper[2] - lower[2]) / faces[2]) * vz;
685552f7358SJed Brown       }
686552f7358SJed Brown     }
687552f7358SJed Brown   }
6889566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
6899566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
6909566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
6913ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
692552f7358SJed Brown }
693552f7358SJed Brown 
694d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Internal(DM dm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], PetscBool interpolate)
695d71ae5a4SJacob Faibussowitsch {
6969318fe57SMatthew G. Knepley   PetscFunctionBegin;
6979318fe57SMatthew G. Knepley   PetscValidLogicalCollectiveInt(dm, dim, 2);
69846139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
6999566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim - 1));
7009566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, dim));
7019318fe57SMatthew G. Knepley   switch (dim) {
702d71ae5a4SJacob Faibussowitsch   case 1:
703d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexCreateBoxSurfaceMesh_Tensor_1D_Internal(dm, lower, upper, faces));
704d71ae5a4SJacob Faibussowitsch     break;
705d71ae5a4SJacob Faibussowitsch   case 2:
706d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexCreateBoxSurfaceMesh_Tensor_2D_Internal(dm, lower, upper, faces));
707d71ae5a4SJacob Faibussowitsch     break;
708d71ae5a4SJacob Faibussowitsch   case 3:
709d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexCreateBoxSurfaceMesh_Tensor_3D_Internal(dm, lower, upper, faces));
710d71ae5a4SJacob Faibussowitsch     break;
711d71ae5a4SJacob Faibussowitsch   default:
712d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Dimension not supported: %" PetscInt_FMT, dim);
7139318fe57SMatthew G. Knepley   }
71446139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
7159566063dSJacob Faibussowitsch   if (interpolate) PetscCall(DMPlexInterpolateInPlace_Internal(dm));
7163ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
7179318fe57SMatthew G. Knepley }
7189318fe57SMatthew G. Knepley 
7199318fe57SMatthew G. Knepley /*@C
7209318fe57SMatthew G. Knepley   DMPlexCreateBoxSurfaceMesh - Creates a mesh on the surface of the tensor product of unit intervals (box) using tensor cells (hexahedra).
7219318fe57SMatthew G. Knepley 
7229318fe57SMatthew G. Knepley   Collective
7239318fe57SMatthew G. Knepley 
7249318fe57SMatthew G. Knepley   Input Parameters:
725a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
72620f4b53cSBarry Smith . dim         - The spatial dimension of the box, so the resulting mesh is has dimension `dim`-1
72720f4b53cSBarry Smith . faces       - Number of faces per dimension, or `NULL` for (1,) in 1D and (2, 2) in 2D and (1, 1, 1) in 3D
72820f4b53cSBarry Smith . lower       - The lower left corner, or `NULL` for (0, 0, 0)
72920f4b53cSBarry Smith . upper       - The upper right corner, or `NULL` for (1, 1, 1)
7309318fe57SMatthew G. Knepley - interpolate - Flag to create intermediate mesh pieces (edges, faces)
7319318fe57SMatthew G. Knepley 
7329318fe57SMatthew G. Knepley   Output Parameter:
733a1cb98faSBarry Smith . dm - The `DM` object
7349318fe57SMatthew G. Knepley 
7359318fe57SMatthew G. Knepley   Level: beginner
7369318fe57SMatthew G. Knepley 
7371cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMSetFromOptions()`, `DMPlexCreateBoxMesh()`, `DMPlexCreateFromFile()`, `DMSetType()`, `DMCreate()`
7389318fe57SMatthew G. Knepley @*/
739d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateBoxSurfaceMesh(MPI_Comm comm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], PetscBool interpolate, DM *dm)
740d71ae5a4SJacob Faibussowitsch {
7419318fe57SMatthew G. Knepley   PetscInt  fac[3] = {1, 1, 1};
7429318fe57SMatthew G. Knepley   PetscReal low[3] = {0, 0, 0};
7439318fe57SMatthew G. Knepley   PetscReal upp[3] = {1, 1, 1};
7449318fe57SMatthew G. Knepley 
7459318fe57SMatthew G. Knepley   PetscFunctionBegin;
7469566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
7479566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
7489566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBoxSurfaceMesh_Internal(*dm, dim, faces ? faces : fac, lower ? lower : low, upper ? upper : upp, interpolate));
7493ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
7509318fe57SMatthew G. Knepley }
7519318fe57SMatthew G. Knepley 
752d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateLineMesh_Internal(DM dm, PetscInt segments, PetscReal lower, PetscReal upper, DMBoundaryType bd)
753d71ae5a4SJacob Faibussowitsch {
754fdbf62faSLisandro Dalcin   PetscInt     i, fStart, fEnd, numCells = 0, numVerts = 0;
755fdbf62faSLisandro Dalcin   PetscInt     numPoints[2], *coneSize, *cones, *coneOrientations;
756fdbf62faSLisandro Dalcin   PetscScalar *vertexCoords;
757fdbf62faSLisandro Dalcin   PetscReal    L, maxCell;
758fdbf62faSLisandro Dalcin   PetscBool    markerSeparate = PETSC_FALSE;
759fdbf62faSLisandro Dalcin   PetscInt     markerLeft = 1, faceMarkerLeft = 1;
760fdbf62faSLisandro Dalcin   PetscInt     markerRight = 1, faceMarkerRight = 2;
761fdbf62faSLisandro Dalcin   PetscBool    wrap = (bd == DM_BOUNDARY_PERIODIC || bd == DM_BOUNDARY_TWIST) ? PETSC_TRUE : PETSC_FALSE;
762fdbf62faSLisandro Dalcin   PetscMPIInt  rank;
763fdbf62faSLisandro Dalcin 
764fdbf62faSLisandro Dalcin   PetscFunctionBegin;
7654f572ea9SToby Isaac   PetscAssertPointer(dm, 1);
766fdbf62faSLisandro Dalcin 
7679566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, 1));
7689566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "marker"));
7699566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "Face Sets"));
770fdbf62faSLisandro Dalcin 
7719566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
772dd400576SPatrick Sanan   if (rank == 0) numCells = segments;
773dd400576SPatrick Sanan   if (rank == 0) numVerts = segments + (wrap ? 0 : 1);
774fdbf62faSLisandro Dalcin 
7759371c9d4SSatish Balay   numPoints[0] = numVerts;
7769371c9d4SSatish Balay   numPoints[1] = numCells;
7779566063dSJacob Faibussowitsch   PetscCall(PetscMalloc4(numCells + numVerts, &coneSize, numCells * 2, &cones, numCells + numVerts, &coneOrientations, numVerts, &vertexCoords));
7789566063dSJacob Faibussowitsch   PetscCall(PetscArrayzero(coneOrientations, numCells + numVerts));
779ad540459SPierre Jolivet   for (i = 0; i < numCells; ++i) coneSize[i] = 2;
780ad540459SPierre Jolivet   for (i = 0; i < numVerts; ++i) coneSize[numCells + i] = 0;
7819371c9d4SSatish Balay   for (i = 0; i < numCells; ++i) {
7829371c9d4SSatish Balay     cones[2 * i]     = numCells + i % numVerts;
7839371c9d4SSatish Balay     cones[2 * i + 1] = numCells + (i + 1) % numVerts;
7849371c9d4SSatish Balay   }
785ad540459SPierre Jolivet   for (i = 0; i < numVerts; ++i) vertexCoords[i] = lower + (upper - lower) * ((PetscReal)i / (PetscReal)numCells);
7869566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
7879566063dSJacob Faibussowitsch   PetscCall(PetscFree4(coneSize, cones, coneOrientations, vertexCoords));
788fdbf62faSLisandro Dalcin 
7899566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
7909371c9d4SSatish Balay   if (markerSeparate) {
7919371c9d4SSatish Balay     markerLeft  = faceMarkerLeft;
7929371c9d4SSatish Balay     markerRight = faceMarkerRight;
7939371c9d4SSatish Balay   }
794dd400576SPatrick Sanan   if (!wrap && rank == 0) {
7959566063dSJacob Faibussowitsch     PetscCall(DMPlexGetHeightStratum(dm, 1, &fStart, &fEnd));
7969566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", fStart, markerLeft));
7979566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", fEnd - 1, markerRight));
7989566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "Face Sets", fStart, faceMarkerLeft));
7999566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "Face Sets", fEnd - 1, faceMarkerRight));
800fdbf62faSLisandro Dalcin   }
801fdbf62faSLisandro Dalcin   if (wrap) {
802fdbf62faSLisandro Dalcin     L       = upper - lower;
803fdbf62faSLisandro Dalcin     maxCell = (PetscReal)1.1 * (L / (PetscReal)PetscMax(1, segments));
8044fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dm, &maxCell, &lower, &L));
805fdbf62faSLisandro Dalcin   }
8069566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
8073ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
808fdbf62faSLisandro Dalcin }
809fdbf62faSLisandro Dalcin 
810d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxMesh_Simplex_Internal(DM dm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[], PetscBool interpolate)
811d71ae5a4SJacob Faibussowitsch {
8129318fe57SMatthew G. Knepley   DM      boundary, vol;
813c22d3578SMatthew G. Knepley   DMLabel bdlabel;
814d6218766SMatthew G. Knepley 
815d6218766SMatthew G. Knepley   PetscFunctionBegin;
8164f572ea9SToby Isaac   PetscAssertPointer(dm, 1);
817c22d3578SMatthew 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");
8189566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &boundary));
8199566063dSJacob Faibussowitsch   PetscCall(DMSetType(boundary, DMPLEX));
8209566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBoxSurfaceMesh_Internal(boundary, dim, faces, lower, upper, PETSC_FALSE));
8219566063dSJacob Faibussowitsch   PetscCall(DMPlexGenerate(boundary, NULL, interpolate, &vol));
822c22d3578SMatthew G. Knepley   PetscCall(DMGetLabel(vol, "marker", &bdlabel));
823c22d3578SMatthew G. Knepley   if (bdlabel) PetscCall(DMPlexLabelComplete(vol, bdlabel));
8245de52c6dSVaclav Hapla   PetscCall(DMPlexCopy_Internal(dm, PETSC_TRUE, PETSC_FALSE, vol));
82569d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
8269566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&boundary));
8273ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
828d6218766SMatthew G. Knepley }
829d6218766SMatthew G. Knepley 
830d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateCubeMesh_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[], DMBoundaryType bdX, DMBoundaryType bdY, DMBoundaryType bdZ)
831d71ae5a4SJacob Faibussowitsch {
832ed0e4b50SMatthew G. Knepley   DMLabel     cutLabel  = NULL;
833f4eb4c5dSMatthew G. Knepley   PetscInt    markerTop = 1, faceMarkerTop = 1;
834f4eb4c5dSMatthew G. Knepley   PetscInt    markerBottom = 1, faceMarkerBottom = 1;
835f4eb4c5dSMatthew G. Knepley   PetscInt    markerFront = 1, faceMarkerFront = 1;
836f4eb4c5dSMatthew G. Knepley   PetscInt    markerBack = 1, faceMarkerBack = 1;
837f4eb4c5dSMatthew G. Knepley   PetscInt    markerRight = 1, faceMarkerRight = 1;
838f4eb4c5dSMatthew G. Knepley   PetscInt    markerLeft = 1, faceMarkerLeft = 1;
8393dfda0b1SToby Isaac   PetscInt    dim;
840d8211ee3SMatthew G. Knepley   PetscBool   markerSeparate = PETSC_FALSE, cutMarker = PETSC_FALSE;
8413dfda0b1SToby Isaac   PetscMPIInt rank;
8423dfda0b1SToby Isaac 
8433dfda0b1SToby Isaac   PetscFunctionBegin;
8449566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
8459566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
8469566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "marker"));
8479566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "Face Sets"));
8489566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_periodic_cut", &cutMarker, NULL));
8499371c9d4SSatish 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) {
8509371c9d4SSatish Balay     if (cutMarker) {
8519371c9d4SSatish Balay       PetscCall(DMCreateLabel(dm, "periodic_cut"));
8529371c9d4SSatish Balay       PetscCall(DMGetLabel(dm, "periodic_cut", &cutLabel));
8539371c9d4SSatish Balay     }
854d8211ee3SMatthew G. Knepley   }
8553dfda0b1SToby Isaac   switch (dim) {
8563dfda0b1SToby Isaac   case 2:
857f4eb4c5dSMatthew G. Knepley     faceMarkerTop    = 3;
858f4eb4c5dSMatthew G. Knepley     faceMarkerBottom = 1;
859f4eb4c5dSMatthew G. Knepley     faceMarkerRight  = 2;
860f4eb4c5dSMatthew G. Knepley     faceMarkerLeft   = 4;
8613dfda0b1SToby Isaac     break;
8623dfda0b1SToby Isaac   case 3:
863f4eb4c5dSMatthew G. Knepley     faceMarkerBottom = 1;
864f4eb4c5dSMatthew G. Knepley     faceMarkerTop    = 2;
865f4eb4c5dSMatthew G. Knepley     faceMarkerFront  = 3;
866f4eb4c5dSMatthew G. Knepley     faceMarkerBack   = 4;
867f4eb4c5dSMatthew G. Knepley     faceMarkerRight  = 5;
868f4eb4c5dSMatthew G. Knepley     faceMarkerLeft   = 6;
8693dfda0b1SToby Isaac     break;
870d71ae5a4SJacob Faibussowitsch   default:
871d71ae5a4SJacob Faibussowitsch     SETERRQ(PETSC_COMM_SELF, PETSC_ERR_SUP, "Dimension %" PetscInt_FMT " not supported", dim);
8723dfda0b1SToby Isaac   }
8739566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
874f4eb4c5dSMatthew G. Knepley   if (markerSeparate) {
875f4eb4c5dSMatthew G. Knepley     markerBottom = faceMarkerBottom;
876f4eb4c5dSMatthew G. Knepley     markerTop    = faceMarkerTop;
877f4eb4c5dSMatthew G. Knepley     markerFront  = faceMarkerFront;
878f4eb4c5dSMatthew G. Knepley     markerBack   = faceMarkerBack;
879f4eb4c5dSMatthew G. Knepley     markerRight  = faceMarkerRight;
880f4eb4c5dSMatthew G. Knepley     markerLeft   = faceMarkerLeft;
8813dfda0b1SToby Isaac   }
8823dfda0b1SToby Isaac   {
883dd400576SPatrick Sanan     const PetscInt numXEdges    = rank == 0 ? edges[0] : 0;
884dd400576SPatrick Sanan     const PetscInt numYEdges    = rank == 0 ? edges[1] : 0;
885dd400576SPatrick Sanan     const PetscInt numZEdges    = rank == 0 ? edges[2] : 0;
886dd400576SPatrick Sanan     const PetscInt numXVertices = rank == 0 ? (bdX == DM_BOUNDARY_PERIODIC || bdX == DM_BOUNDARY_TWIST ? edges[0] : edges[0] + 1) : 0;
887dd400576SPatrick Sanan     const PetscInt numYVertices = rank == 0 ? (bdY == DM_BOUNDARY_PERIODIC || bdY == DM_BOUNDARY_TWIST ? edges[1] : edges[1] + 1) : 0;
888dd400576SPatrick Sanan     const PetscInt numZVertices = rank == 0 ? (bdZ == DM_BOUNDARY_PERIODIC || bdZ == DM_BOUNDARY_TWIST ? edges[2] : edges[2] + 1) : 0;
8893dfda0b1SToby Isaac     const PetscInt numCells     = numXEdges * numYEdges * numZEdges;
8903dfda0b1SToby Isaac     const PetscInt numXFaces    = numYEdges * numZEdges;
8913dfda0b1SToby Isaac     const PetscInt numYFaces    = numXEdges * numZEdges;
8923dfda0b1SToby Isaac     const PetscInt numZFaces    = numXEdges * numYEdges;
8933dfda0b1SToby Isaac     const PetscInt numTotXFaces = numXVertices * numXFaces;
8943dfda0b1SToby Isaac     const PetscInt numTotYFaces = numYVertices * numYFaces;
8953dfda0b1SToby Isaac     const PetscInt numTotZFaces = numZVertices * numZFaces;
8963dfda0b1SToby Isaac     const PetscInt numFaces     = numTotXFaces + numTotYFaces + numTotZFaces;
8973dfda0b1SToby Isaac     const PetscInt numTotXEdges = numXEdges * numYVertices * numZVertices;
8983dfda0b1SToby Isaac     const PetscInt numTotYEdges = numYEdges * numXVertices * numZVertices;
8993dfda0b1SToby Isaac     const PetscInt numTotZEdges = numZEdges * numXVertices * numYVertices;
9003dfda0b1SToby Isaac     const PetscInt numVertices  = numXVertices * numYVertices * numZVertices;
9013dfda0b1SToby Isaac     const PetscInt numEdges     = numTotXEdges + numTotYEdges + numTotZEdges;
9023dfda0b1SToby Isaac     const PetscInt firstVertex  = (dim == 2) ? numFaces : numCells;
9033dfda0b1SToby Isaac     const PetscInt firstXFace   = (dim == 2) ? 0 : numCells + numVertices;
9043dfda0b1SToby Isaac     const PetscInt firstYFace   = firstXFace + numTotXFaces;
9053dfda0b1SToby Isaac     const PetscInt firstZFace   = firstYFace + numTotYFaces;
9063dfda0b1SToby Isaac     const PetscInt firstXEdge   = numCells + numFaces + numVertices;
9073dfda0b1SToby Isaac     const PetscInt firstYEdge   = firstXEdge + numTotXEdges;
9083dfda0b1SToby Isaac     const PetscInt firstZEdge   = firstYEdge + numTotYEdges;
9093dfda0b1SToby Isaac     Vec            coordinates;
9103dfda0b1SToby Isaac     PetscSection   coordSection;
9113dfda0b1SToby Isaac     PetscScalar   *coords;
9123dfda0b1SToby Isaac     PetscInt       coordSize;
9133dfda0b1SToby Isaac     PetscInt       v, vx, vy, vz;
9143dfda0b1SToby Isaac     PetscInt       c, f, fx, fy, fz, e, ex, ey, ez;
9153dfda0b1SToby Isaac 
9169566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numCells + numFaces + numEdges + numVertices));
91748a46eb9SPierre Jolivet     for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 6));
91848a46eb9SPierre Jolivet     for (f = firstXFace; f < firstXFace + numFaces; ++f) PetscCall(DMPlexSetConeSize(dm, f, 4));
91948a46eb9SPierre Jolivet     for (e = firstXEdge; e < firstXEdge + numEdges; ++e) PetscCall(DMPlexSetConeSize(dm, e, 2));
9209566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
9213dfda0b1SToby Isaac     /* Build cells */
9223dfda0b1SToby Isaac     for (fz = 0; fz < numZEdges; ++fz) {
9233dfda0b1SToby Isaac       for (fy = 0; fy < numYEdges; ++fy) {
9243dfda0b1SToby Isaac         for (fx = 0; fx < numXEdges; ++fx) {
9253dfda0b1SToby Isaac           PetscInt cell  = (fz * numYEdges + fy) * numXEdges + fx;
9263dfda0b1SToby Isaac           PetscInt faceB = firstZFace + (fy * numXEdges + fx) * numZVertices + fz;
9273dfda0b1SToby Isaac           PetscInt faceT = firstZFace + (fy * numXEdges + fx) * numZVertices + ((fz + 1) % numZVertices);
9283dfda0b1SToby Isaac           PetscInt faceF = firstYFace + (fz * numXEdges + fx) * numYVertices + fy;
9293dfda0b1SToby Isaac           PetscInt faceK = firstYFace + (fz * numXEdges + fx) * numYVertices + ((fy + 1) % numYVertices);
9303dfda0b1SToby Isaac           PetscInt faceL = firstXFace + (fz * numYEdges + fy) * numXVertices + fx;
9313dfda0b1SToby Isaac           PetscInt faceR = firstXFace + (fz * numYEdges + fy) * numXVertices + ((fx + 1) % numXVertices);
9323dfda0b1SToby Isaac           /* B,  T,  F,  K,  R,  L */
933b5a892a1SMatthew G. Knepley           PetscInt ornt[6] = {-2, 0, 0, -3, 0, -2}; /* ??? */
93442206facSLisandro Dalcin           PetscInt cone[6];
9353dfda0b1SToby Isaac 
9363dfda0b1SToby Isaac           /* no boundary twisting in 3D */
9379371c9d4SSatish Balay           cone[0] = faceB;
9389371c9d4SSatish Balay           cone[1] = faceT;
9399371c9d4SSatish Balay           cone[2] = faceF;
9409371c9d4SSatish Balay           cone[3] = faceK;
9419371c9d4SSatish Balay           cone[4] = faceR;
9429371c9d4SSatish Balay           cone[5] = faceL;
9439566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, cell, cone));
9449566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, cell, ornt));
9459566063dSJacob Faibussowitsch           if (bdX != DM_BOUNDARY_NONE && fx == numXEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, cell, 2));
9469566063dSJacob Faibussowitsch           if (bdY != DM_BOUNDARY_NONE && fy == numYEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, cell, 2));
9479566063dSJacob Faibussowitsch           if (bdZ != DM_BOUNDARY_NONE && fz == numZEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, cell, 2));
9483dfda0b1SToby Isaac         }
9493dfda0b1SToby Isaac       }
9503dfda0b1SToby Isaac     }
9513dfda0b1SToby Isaac     /* Build x faces */
9523dfda0b1SToby Isaac     for (fz = 0; fz < numZEdges; ++fz) {
9533dfda0b1SToby Isaac       for (fy = 0; fy < numYEdges; ++fy) {
9543dfda0b1SToby Isaac         for (fx = 0; fx < numXVertices; ++fx) {
9553dfda0b1SToby Isaac           PetscInt face    = firstXFace + (fz * numYEdges + fy) * numXVertices + fx;
9563dfda0b1SToby Isaac           PetscInt edgeL   = firstZEdge + (fy * numXVertices + fx) * numZEdges + fz;
9573dfda0b1SToby Isaac           PetscInt edgeR   = firstZEdge + (((fy + 1) % numYVertices) * numXVertices + fx) * numZEdges + fz;
9583dfda0b1SToby Isaac           PetscInt edgeB   = firstYEdge + (fz * numXVertices + fx) * numYEdges + fy;
9593dfda0b1SToby Isaac           PetscInt edgeT   = firstYEdge + (((fz + 1) % numZVertices) * numXVertices + fx) * numYEdges + fy;
960b5a892a1SMatthew G. Knepley           PetscInt ornt[4] = {0, 0, -1, -1};
9613dfda0b1SToby Isaac           PetscInt cone[4];
9623dfda0b1SToby Isaac 
9633dfda0b1SToby Isaac           if (dim == 3) {
9643dfda0b1SToby Isaac             /* markers */
9653dfda0b1SToby Isaac             if (bdX != DM_BOUNDARY_PERIODIC) {
9663dfda0b1SToby Isaac               if (fx == numXVertices - 1) {
9679566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerRight));
9689566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerRight));
9699371c9d4SSatish Balay               } else if (fx == 0) {
9709566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerLeft));
9719566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerLeft));
9723dfda0b1SToby Isaac               }
9733dfda0b1SToby Isaac             }
9743dfda0b1SToby Isaac           }
9759371c9d4SSatish Balay           cone[0] = edgeB;
9769371c9d4SSatish Balay           cone[1] = edgeR;
9779371c9d4SSatish Balay           cone[2] = edgeT;
9789371c9d4SSatish Balay           cone[3] = edgeL;
9799566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, face, cone));
9809566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, face, ornt));
9813dfda0b1SToby Isaac         }
9823dfda0b1SToby Isaac       }
9833dfda0b1SToby Isaac     }
9843dfda0b1SToby Isaac     /* Build y faces */
9853dfda0b1SToby Isaac     for (fz = 0; fz < numZEdges; ++fz) {
98642206facSLisandro Dalcin       for (fx = 0; fx < numXEdges; ++fx) {
9873dfda0b1SToby Isaac         for (fy = 0; fy < numYVertices; ++fy) {
9883dfda0b1SToby Isaac           PetscInt face    = firstYFace + (fz * numXEdges + fx) * numYVertices + fy;
9893dfda0b1SToby Isaac           PetscInt edgeL   = firstZEdge + (fy * numXVertices + fx) * numZEdges + fz;
9903dfda0b1SToby Isaac           PetscInt edgeR   = firstZEdge + (fy * numXVertices + ((fx + 1) % numXVertices)) * numZEdges + fz;
9913dfda0b1SToby Isaac           PetscInt edgeB   = firstXEdge + (fz * numYVertices + fy) * numXEdges + fx;
9923dfda0b1SToby Isaac           PetscInt edgeT   = firstXEdge + (((fz + 1) % numZVertices) * numYVertices + fy) * numXEdges + fx;
993b5a892a1SMatthew G. Knepley           PetscInt ornt[4] = {0, 0, -1, -1};
9943dfda0b1SToby Isaac           PetscInt cone[4];
9953dfda0b1SToby Isaac 
9963dfda0b1SToby Isaac           if (dim == 3) {
9973dfda0b1SToby Isaac             /* markers */
9983dfda0b1SToby Isaac             if (bdY != DM_BOUNDARY_PERIODIC) {
9993dfda0b1SToby Isaac               if (fy == numYVertices - 1) {
10009566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerBack));
10019566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerBack));
10029371c9d4SSatish Balay               } else if (fy == 0) {
10039566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerFront));
10049566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerFront));
10053dfda0b1SToby Isaac               }
10063dfda0b1SToby Isaac             }
10073dfda0b1SToby Isaac           }
10089371c9d4SSatish Balay           cone[0] = edgeB;
10099371c9d4SSatish Balay           cone[1] = edgeR;
10109371c9d4SSatish Balay           cone[2] = edgeT;
10119371c9d4SSatish Balay           cone[3] = edgeL;
10129566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, face, cone));
10139566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, face, ornt));
10143dfda0b1SToby Isaac         }
10153dfda0b1SToby Isaac       }
10163dfda0b1SToby Isaac     }
10173dfda0b1SToby Isaac     /* Build z faces */
10183dfda0b1SToby Isaac     for (fy = 0; fy < numYEdges; ++fy) {
10193dfda0b1SToby Isaac       for (fx = 0; fx < numXEdges; ++fx) {
10203dfda0b1SToby Isaac         for (fz = 0; fz < numZVertices; fz++) {
10213dfda0b1SToby Isaac           PetscInt face    = firstZFace + (fy * numXEdges + fx) * numZVertices + fz;
10223dfda0b1SToby Isaac           PetscInt edgeL   = firstYEdge + (fz * numXVertices + fx) * numYEdges + fy;
10233dfda0b1SToby Isaac           PetscInt edgeR   = firstYEdge + (fz * numXVertices + ((fx + 1) % numXVertices)) * numYEdges + fy;
10243dfda0b1SToby Isaac           PetscInt edgeB   = firstXEdge + (fz * numYVertices + fy) * numXEdges + fx;
10253dfda0b1SToby Isaac           PetscInt edgeT   = firstXEdge + (fz * numYVertices + ((fy + 1) % numYVertices)) * numXEdges + fx;
1026b5a892a1SMatthew G. Knepley           PetscInt ornt[4] = {0, 0, -1, -1};
10273dfda0b1SToby Isaac           PetscInt cone[4];
10283dfda0b1SToby Isaac 
10293dfda0b1SToby Isaac           if (dim == 2) {
10309371c9d4SSatish Balay             if (bdX == DM_BOUNDARY_TWIST && fx == numXEdges - 1) {
10319371c9d4SSatish Balay               edgeR += numYEdges - 1 - 2 * fy;
10329371c9d4SSatish Balay               ornt[1] = -1;
10339371c9d4SSatish Balay             }
10349371c9d4SSatish Balay             if (bdY == DM_BOUNDARY_TWIST && fy == numYEdges - 1) {
10359371c9d4SSatish Balay               edgeT += numXEdges - 1 - 2 * fx;
10369371c9d4SSatish Balay               ornt[2] = 0;
10379371c9d4SSatish Balay             }
10389566063dSJacob Faibussowitsch             if (bdX != DM_BOUNDARY_NONE && fx == numXEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, face, 2));
10399566063dSJacob Faibussowitsch             if (bdY != DM_BOUNDARY_NONE && fy == numYEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, face, 2));
1040d1c88043SMatthew G. Knepley           } else {
10413dfda0b1SToby Isaac             /* markers */
10423dfda0b1SToby Isaac             if (bdZ != DM_BOUNDARY_PERIODIC) {
10433dfda0b1SToby Isaac               if (fz == numZVertices - 1) {
10449566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerTop));
10459566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerTop));
10469371c9d4SSatish Balay               } else if (fz == 0) {
10479566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerBottom));
10489566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerBottom));
10493dfda0b1SToby Isaac               }
10503dfda0b1SToby Isaac             }
10513dfda0b1SToby Isaac           }
10529371c9d4SSatish Balay           cone[0] = edgeB;
10539371c9d4SSatish Balay           cone[1] = edgeR;
10549371c9d4SSatish Balay           cone[2] = edgeT;
10559371c9d4SSatish Balay           cone[3] = edgeL;
10569566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, face, cone));
10579566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, face, ornt));
10583dfda0b1SToby Isaac         }
10593dfda0b1SToby Isaac       }
10603dfda0b1SToby Isaac     }
10613dfda0b1SToby Isaac     /* Build Z edges*/
10623dfda0b1SToby Isaac     for (vy = 0; vy < numYVertices; vy++) {
10633dfda0b1SToby Isaac       for (vx = 0; vx < numXVertices; vx++) {
10643dfda0b1SToby Isaac         for (ez = 0; ez < numZEdges; ez++) {
10653dfda0b1SToby Isaac           const PetscInt edge    = firstZEdge + (vy * numXVertices + vx) * numZEdges + ez;
10663dfda0b1SToby Isaac           const PetscInt vertexB = firstVertex + (ez * numYVertices + vy) * numXVertices + vx;
10673dfda0b1SToby Isaac           const PetscInt vertexT = firstVertex + (((ez + 1) % numZVertices) * numYVertices + vy) * numXVertices + vx;
10683dfda0b1SToby Isaac           PetscInt       cone[2];
10693dfda0b1SToby Isaac 
10709371c9d4SSatish Balay           cone[0] = vertexB;
10719371c9d4SSatish Balay           cone[1] = vertexT;
1072c2df9bbfSMatthew G. Knepley           PetscCall(DMPlexSetCone(dm, edge, cone));
10733dfda0b1SToby Isaac           if (dim == 3) {
10743dfda0b1SToby Isaac             if (bdX != DM_BOUNDARY_PERIODIC) {
10753dfda0b1SToby Isaac               if (vx == numXVertices - 1) {
10769566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
1077c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
1078c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
1079c2df9bbfSMatthew G. Knepley               } else if (vx == 0) {
10809566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
1081c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
1082c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
10833dfda0b1SToby Isaac               }
10843dfda0b1SToby Isaac             }
10853dfda0b1SToby Isaac             if (bdY != DM_BOUNDARY_PERIODIC) {
10863dfda0b1SToby Isaac               if (vy == numYVertices - 1) {
10879566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBack));
1088c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBack));
1089c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBack));
1090c2df9bbfSMatthew G. Knepley               } else if (vy == 0) {
10919566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerFront));
1092c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerFront));
1093c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerFront));
10943dfda0b1SToby Isaac               }
10953dfda0b1SToby Isaac             }
10963dfda0b1SToby Isaac           }
10973dfda0b1SToby Isaac         }
10983dfda0b1SToby Isaac       }
10993dfda0b1SToby Isaac     }
11003dfda0b1SToby Isaac     /* Build Y edges*/
11013dfda0b1SToby Isaac     for (vz = 0; vz < numZVertices; vz++) {
11023dfda0b1SToby Isaac       for (vx = 0; vx < numXVertices; vx++) {
11033dfda0b1SToby Isaac         for (ey = 0; ey < numYEdges; ey++) {
11043dfda0b1SToby Isaac           const PetscInt nextv   = (dim == 2 && bdY == DM_BOUNDARY_TWIST && ey == numYEdges - 1) ? (numXVertices - vx - 1) : (vz * numYVertices + ((ey + 1) % numYVertices)) * numXVertices + vx;
11053dfda0b1SToby Isaac           const PetscInt edge    = firstYEdge + (vz * numXVertices + vx) * numYEdges + ey;
11063dfda0b1SToby Isaac           const PetscInt vertexF = firstVertex + (vz * numYVertices + ey) * numXVertices + vx;
11073dfda0b1SToby Isaac           const PetscInt vertexK = firstVertex + nextv;
11083dfda0b1SToby Isaac           PetscInt       cone[2];
11093dfda0b1SToby Isaac 
11109371c9d4SSatish Balay           cone[0] = vertexF;
11119371c9d4SSatish Balay           cone[1] = vertexK;
11129566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, edge, cone));
11133dfda0b1SToby Isaac           if (dim == 2) {
11143dfda0b1SToby Isaac             if ((bdX != DM_BOUNDARY_PERIODIC) && (bdX != DM_BOUNDARY_TWIST)) {
11153dfda0b1SToby Isaac               if (vx == numXVertices - 1) {
11169566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerRight));
11179566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
11189566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
1119c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
1120d8211ee3SMatthew G. Knepley               } else if (vx == 0) {
11219566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerLeft));
11229566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
11239566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
1124c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
11253dfda0b1SToby Isaac               }
1126d8211ee3SMatthew G. Knepley             } else {
11274c67ea77SStefano Zampini               if (vx == 0 && cutLabel) {
11289566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, edge, 1));
11299566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, cone[0], 1));
1130c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMLabelSetValue(cutLabel, cone[1], 1));
11313dfda0b1SToby Isaac               }
1132d8211ee3SMatthew G. Knepley             }
1133d8211ee3SMatthew G. Knepley           } else {
11343dfda0b1SToby Isaac             if (bdX != DM_BOUNDARY_PERIODIC) {
11353dfda0b1SToby Isaac               if (vx == numXVertices - 1) {
11369566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
1137c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
1138c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
1139d8211ee3SMatthew G. Knepley               } else if (vx == 0) {
11409566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
1141c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
1142c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
11433dfda0b1SToby Isaac               }
11443dfda0b1SToby Isaac             }
11453dfda0b1SToby Isaac             if (bdZ != DM_BOUNDARY_PERIODIC) {
11463dfda0b1SToby Isaac               if (vz == numZVertices - 1) {
11479566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
1148c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
1149c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
1150d8211ee3SMatthew G. Knepley               } else if (vz == 0) {
11519566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
1152c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
1153c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
11543dfda0b1SToby Isaac               }
11553dfda0b1SToby Isaac             }
11563dfda0b1SToby Isaac           }
11573dfda0b1SToby Isaac         }
11583dfda0b1SToby Isaac       }
11593dfda0b1SToby Isaac     }
11603dfda0b1SToby Isaac     /* Build X edges*/
11613dfda0b1SToby Isaac     for (vz = 0; vz < numZVertices; vz++) {
11623dfda0b1SToby Isaac       for (vy = 0; vy < numYVertices; vy++) {
11633dfda0b1SToby Isaac         for (ex = 0; ex < numXEdges; ex++) {
11643dfda0b1SToby Isaac           const PetscInt nextv   = (dim == 2 && bdX == DM_BOUNDARY_TWIST && ex == numXEdges - 1) ? (numYVertices - vy - 1) * numXVertices : (vz * numYVertices + vy) * numXVertices + (ex + 1) % numXVertices;
11653dfda0b1SToby Isaac           const PetscInt edge    = firstXEdge + (vz * numYVertices + vy) * numXEdges + ex;
11663dfda0b1SToby Isaac           const PetscInt vertexL = firstVertex + (vz * numYVertices + vy) * numXVertices + ex;
11673dfda0b1SToby Isaac           const PetscInt vertexR = firstVertex + nextv;
11683dfda0b1SToby Isaac           PetscInt       cone[2];
11693dfda0b1SToby Isaac 
11709371c9d4SSatish Balay           cone[0] = vertexL;
11719371c9d4SSatish Balay           cone[1] = vertexR;
11729566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, edge, cone));
11733dfda0b1SToby Isaac           if (dim == 2) {
11743dfda0b1SToby Isaac             if ((bdY != DM_BOUNDARY_PERIODIC) && (bdY != DM_BOUNDARY_TWIST)) {
11753dfda0b1SToby Isaac               if (vy == numYVertices - 1) {
11769566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerTop));
11779566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
11789566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
1179c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
1180d8211ee3SMatthew G. Knepley               } else if (vy == 0) {
11819566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerBottom));
11829566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
11839566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
1184c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
11853dfda0b1SToby Isaac               }
1186d8211ee3SMatthew G. Knepley             } else {
11874c67ea77SStefano Zampini               if (vy == 0 && cutLabel) {
11889566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, edge, 1));
11899566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, cone[0], 1));
1190c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMLabelSetValue(cutLabel, cone[1], 1));
11913dfda0b1SToby Isaac               }
1192d8211ee3SMatthew G. Knepley             }
1193d8211ee3SMatthew G. Knepley           } else {
11943dfda0b1SToby Isaac             if (bdY != DM_BOUNDARY_PERIODIC) {
11953dfda0b1SToby Isaac               if (vy == numYVertices - 1) {
11969566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBack));
1197c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBack));
1198c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBack));
1199c2df9bbfSMatthew G. Knepley               } else if (vy == 0) {
12009566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerFront));
1201c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerFront));
1202c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerFront));
12033dfda0b1SToby Isaac               }
12043dfda0b1SToby Isaac             }
12053dfda0b1SToby Isaac             if (bdZ != DM_BOUNDARY_PERIODIC) {
12063dfda0b1SToby Isaac               if (vz == numZVertices - 1) {
12079566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
1208c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
1209c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
1210c2df9bbfSMatthew G. Knepley               } else if (vz == 0) {
12119566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
1212c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
1213c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
12143dfda0b1SToby Isaac               }
12153dfda0b1SToby Isaac             }
12163dfda0b1SToby Isaac           }
12173dfda0b1SToby Isaac         }
12183dfda0b1SToby Isaac       }
12193dfda0b1SToby Isaac     }
12209566063dSJacob Faibussowitsch     PetscCall(DMPlexSymmetrize(dm));
12219566063dSJacob Faibussowitsch     PetscCall(DMPlexStratify(dm));
12223dfda0b1SToby Isaac     /* Build coordinates */
12239566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &coordSection));
12249566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetNumFields(coordSection, 1));
12259566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
12269566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numVertices));
12273dfda0b1SToby Isaac     for (v = firstVertex; v < firstVertex + numVertices; ++v) {
12289566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetDof(coordSection, v, dim));
12299566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
12303dfda0b1SToby Isaac     }
12319566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetUp(coordSection));
12329566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
12339566063dSJacob Faibussowitsch     PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
12349566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
12359566063dSJacob Faibussowitsch     PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
12369566063dSJacob Faibussowitsch     PetscCall(VecSetBlockSize(coordinates, dim));
12379566063dSJacob Faibussowitsch     PetscCall(VecSetType(coordinates, VECSTANDARD));
12389566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
12393dfda0b1SToby Isaac     for (vz = 0; vz < numZVertices; ++vz) {
12403dfda0b1SToby Isaac       for (vy = 0; vy < numYVertices; ++vy) {
12413dfda0b1SToby Isaac         for (vx = 0; vx < numXVertices; ++vx) {
12423dfda0b1SToby Isaac           coords[((vz * numYVertices + vy) * numXVertices + vx) * dim + 0] = lower[0] + ((upper[0] - lower[0]) / numXEdges) * vx;
12433dfda0b1SToby Isaac           coords[((vz * numYVertices + vy) * numXVertices + vx) * dim + 1] = lower[1] + ((upper[1] - lower[1]) / numYEdges) * vy;
1244ad540459SPierre Jolivet           if (dim == 3) coords[((vz * numYVertices + vy) * numXVertices + vx) * dim + 2] = lower[2] + ((upper[2] - lower[2]) / numZEdges) * vz;
12453dfda0b1SToby Isaac         }
12463dfda0b1SToby Isaac       }
12473dfda0b1SToby Isaac     }
12489566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(coordinates, &coords));
12499566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, coordinates));
12509566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&coordinates));
12513dfda0b1SToby Isaac   }
12523ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
12533dfda0b1SToby Isaac }
12543dfda0b1SToby Isaac 
1255d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxMesh_Tensor_Internal(DM dm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[])
1256d71ae5a4SJacob Faibussowitsch {
12579318fe57SMatthew G. Knepley   DMBoundaryType bdt[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
12589318fe57SMatthew G. Knepley   PetscInt       fac[3] = {0, 0, 0}, d;
1259552f7358SJed Brown 
1260552f7358SJed Brown   PetscFunctionBegin;
12614f572ea9SToby Isaac   PetscAssertPointer(dm, 1);
12629318fe57SMatthew G. Knepley   PetscValidLogicalCollectiveInt(dm, dim, 2);
12639566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
12649371c9d4SSatish Balay   for (d = 0; d < dim; ++d) {
12659371c9d4SSatish Balay     fac[d] = faces[d];
12669371c9d4SSatish Balay     bdt[d] = periodicity[d];
12679371c9d4SSatish Balay   }
12689566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateCubeMesh_Internal(dm, lower, upper, fac, bdt[0], bdt[1], bdt[2]));
12699371c9d4SSatish 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))) {
12706858538eSMatthew G. Knepley     PetscReal L[3]       = {-1., -1., 0.};
12716858538eSMatthew G. Knepley     PetscReal maxCell[3] = {-1., -1., 0.};
1272552f7358SJed Brown 
12739318fe57SMatthew G. Knepley     for (d = 0; d < dim; ++d) {
12746858538eSMatthew G. Knepley       if (periodicity[d] != DM_BOUNDARY_NONE) {
12759318fe57SMatthew G. Knepley         L[d]       = upper[d] - lower[d];
12769318fe57SMatthew G. Knepley         maxCell[d] = 1.1 * (L[d] / PetscMax(1, faces[d]));
1277768d5fceSMatthew G. Knepley       }
12786858538eSMatthew G. Knepley     }
12794fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dm, maxCell, lower, L));
1280768d5fceSMatthew G. Knepley   }
12819566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
12823ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
12839318fe57SMatthew G. Knepley }
12849318fe57SMatthew G. Knepley 
12855dca41c3SJed 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)
1286d71ae5a4SJacob Faibussowitsch {
12879318fe57SMatthew G. Knepley   PetscFunctionBegin;
128846139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
12895dca41c3SJed Brown   if (shape == DM_SHAPE_ZBOX) PetscCall(DMPlexCreateBoxMesh_Tensor_SFC_Internal(dm, dim, faces, lower, upper, periodicity, interpolate));
12906725e60dSJed Brown   else if (dim == 1) PetscCall(DMPlexCreateLineMesh_Internal(dm, faces[0], lower[0], upper[0], periodicity[0]));
12919566063dSJacob Faibussowitsch   else if (simplex) PetscCall(DMPlexCreateBoxMesh_Simplex_Internal(dm, dim, faces, lower, upper, periodicity, interpolate));
12929566063dSJacob Faibussowitsch   else PetscCall(DMPlexCreateBoxMesh_Tensor_Internal(dm, dim, faces, lower, upper, periodicity));
12939318fe57SMatthew G. Knepley   if (!interpolate && dim > 1 && !simplex) {
1294768d5fceSMatthew G. Knepley     DM udm;
1295768d5fceSMatthew G. Knepley 
12969566063dSJacob Faibussowitsch     PetscCall(DMPlexUninterpolate(dm, &udm));
12979566063dSJacob Faibussowitsch     PetscCall(DMPlexCopyCoordinates(dm, udm));
129869d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &udm));
1299768d5fceSMatthew G. Knepley   }
130046139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
13013ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1302c8c68bd8SToby Isaac }
1303c8c68bd8SToby Isaac 
1304768d5fceSMatthew G. Knepley /*@C
1305768d5fceSMatthew G. Knepley   DMPlexCreateBoxMesh - Creates a mesh on the tensor product of unit intervals (box) using simplices or tensor cells (hexahedra).
1306768d5fceSMatthew G. Knepley 
1307d083f849SBarry Smith   Collective
1308768d5fceSMatthew G. Knepley 
1309768d5fceSMatthew G. Knepley   Input Parameters:
1310a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
1311768d5fceSMatthew G. Knepley . dim         - The spatial dimension
1312a1cb98faSBarry Smith . simplex     - `PETSC_TRUE` for simplices, `PETSC_FALSE` for tensor cells
131320f4b53cSBarry Smith . faces       - Number of faces per dimension, or `NULL` for (1,) in 1D and (2, 2) in 2D and (1, 1, 1) in 3D
131420f4b53cSBarry Smith . lower       - The lower left corner, or `NULL` for (0, 0, 0)
131520f4b53cSBarry Smith . upper       - The upper right corner, or `NULL` for (1, 1, 1)
131620f4b53cSBarry Smith . periodicity - The boundary type for the X,Y,Z direction, or `NULL` for `DM_BOUNDARY_NONE`
1317768d5fceSMatthew G. Knepley - interpolate - Flag to create intermediate mesh pieces (edges, faces)
1318768d5fceSMatthew G. Knepley 
1319768d5fceSMatthew G. Knepley   Output Parameter:
1320a1cb98faSBarry Smith . dm - The `DM` object
1321768d5fceSMatthew G. Knepley 
1322768d5fceSMatthew G. Knepley   Level: beginner
1323768d5fceSMatthew G. Knepley 
1324a1cb98faSBarry Smith   Note:
1325a1cb98faSBarry Smith   To customize this mesh using options, use
1326a1cb98faSBarry Smith .vb
1327a1cb98faSBarry Smith   DMCreate(comm, &dm);
1328a1cb98faSBarry Smith   DMSetType(dm, DMPLEX);
1329a1cb98faSBarry Smith   DMSetFromOptions(dm);
1330a1cb98faSBarry Smith .ve
1331a1cb98faSBarry Smith   and use the options in `DMSetFromOptions()`.
1332a1cb98faSBarry Smith 
1333a4e35b19SJacob Faibussowitsch   Here is the numbering returned for 2 faces in each direction for tensor cells\:
1334a1cb98faSBarry Smith .vb
1335a1cb98faSBarry Smith  10---17---11---18----12
1336a1cb98faSBarry Smith   |         |         |
1337a1cb98faSBarry Smith   |         |         |
1338a1cb98faSBarry Smith  20    2   22    3    24
1339a1cb98faSBarry Smith   |         |         |
1340a1cb98faSBarry Smith   |         |         |
1341a1cb98faSBarry Smith   7---15----8---16----9
1342a1cb98faSBarry Smith   |         |         |
1343a1cb98faSBarry Smith   |         |         |
1344a1cb98faSBarry Smith  19    0   21    1   23
1345a1cb98faSBarry Smith   |         |         |
1346a1cb98faSBarry Smith   |         |         |
1347a1cb98faSBarry Smith   4---13----5---14----6
1348a1cb98faSBarry Smith .ve
1349a1cb98faSBarry Smith   and for simplicial cells
1350a1cb98faSBarry Smith .vb
1351a1cb98faSBarry Smith  14----8---15----9----16
1352a1cb98faSBarry Smith   |\     5  |\      7 |
1353a1cb98faSBarry Smith   | \       | \       |
1354a1cb98faSBarry Smith  13   2    14    3    15
1355a1cb98faSBarry Smith   | 4   \   | 6   \   |
1356a1cb98faSBarry Smith   |       \ |       \ |
1357a1cb98faSBarry Smith  11----6---12----7----13
1358a1cb98faSBarry Smith   |\        |\        |
1359a1cb98faSBarry Smith   | \    1  | \     3 |
1360a1cb98faSBarry Smith  10   0    11    1    12
1361a1cb98faSBarry Smith   | 0   \   | 2   \   |
1362a1cb98faSBarry Smith   |       \ |       \ |
1363a1cb98faSBarry Smith   8----4----9----5----10
1364a1cb98faSBarry Smith .ve
1365a1cb98faSBarry Smith 
13661cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMSetFromOptions()`, `DMPlexCreateFromFile()`, `DMPlexCreateHexCylinderMesh()`, `DMSetType()`, `DMCreate()`
1367768d5fceSMatthew G. Knepley @*/
1368d71ae5a4SJacob 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)
1369d71ae5a4SJacob Faibussowitsch {
13709318fe57SMatthew G. Knepley   PetscInt       fac[3] = {1, 1, 1};
1371fdbf62faSLisandro Dalcin   PetscReal      low[3] = {0, 0, 0};
1372fdbf62faSLisandro Dalcin   PetscReal      upp[3] = {1, 1, 1};
1373fdbf62faSLisandro Dalcin   DMBoundaryType bdt[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
1374552f7358SJed Brown 
1375768d5fceSMatthew G. Knepley   PetscFunctionBegin;
13769566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
13779566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
13785dca41c3SJed Brown   PetscCall(DMPlexCreateBoxMesh_Internal(*dm, DM_SHAPE_BOX, dim, simplex, faces ? faces : fac, lower ? lower : low, upper ? upper : upp, periodicity ? periodicity : bdt, interpolate));
13797ff04441SMatthew G. Knepley   if (periodicity) PetscCall(DMLocalizeCoordinates(*dm));
13803ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
13819318fe57SMatthew G. Knepley }
1382fdbf62faSLisandro Dalcin 
1383d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateWedgeBoxMesh_Internal(DM dm, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[])
1384d71ae5a4SJacob Faibussowitsch {
13859318fe57SMatthew G. Knepley   DM       bdm, vol;
13869318fe57SMatthew G. Knepley   PetscInt i;
13879318fe57SMatthew G. Knepley 
13889318fe57SMatthew G. Knepley   PetscFunctionBegin;
13891fcf445aSMatthew G. Knepley   // TODO Now we can support periodicity
139008401ef6SPierre Jolivet   for (i = 0; i < 3; ++i) PetscCheck(periodicity[i] == DM_BOUNDARY_NONE, PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Periodicity not yet supported");
13919566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &bdm));
13929566063dSJacob Faibussowitsch   PetscCall(DMSetType(bdm, DMPLEX));
13939566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(bdm, 2));
139446139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, bdm, 0, 0, 0));
13959566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBoxMesh_Simplex_Internal(bdm, 2, faces, lower, upper, periodicity, PETSC_TRUE));
13961fcf445aSMatthew G. Knepley   PetscCall(DMPlexExtrude(bdm, faces[2], upper[2] - lower[2], PETSC_TRUE, PETSC_FALSE, PETSC_FALSE, NULL, NULL, &vol));
139746139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, bdm, 0, 0, 0));
13989566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&bdm));
139969d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
14009318fe57SMatthew G. Knepley   if (lower[2] != 0.0) {
14019318fe57SMatthew G. Knepley     Vec          v;
14029318fe57SMatthew G. Knepley     PetscScalar *x;
14039318fe57SMatthew G. Knepley     PetscInt     cDim, n;
14049318fe57SMatthew G. Knepley 
14059566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinatesLocal(dm, &v));
14069566063dSJacob Faibussowitsch     PetscCall(VecGetBlockSize(v, &cDim));
14079566063dSJacob Faibussowitsch     PetscCall(VecGetLocalSize(v, &n));
14089566063dSJacob Faibussowitsch     PetscCall(VecGetArray(v, &x));
14099318fe57SMatthew G. Knepley     x += cDim;
14109318fe57SMatthew G. Knepley     for (i = 0; i < n; i += cDim) x[i] += lower[2];
14119566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(v, &x));
14129566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, v));
14139318fe57SMatthew G. Knepley   }
14143ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1415552f7358SJed Brown }
1416552f7358SJed Brown 
141700dabe28SStefano Zampini /*@
141800dabe28SStefano Zampini   DMPlexCreateWedgeBoxMesh - Creates a 3-D mesh tesselating the (x,y) plane and extruding in the third direction using wedge cells.
141900dabe28SStefano Zampini 
1420d083f849SBarry Smith   Collective
142100dabe28SStefano Zampini 
142200dabe28SStefano Zampini   Input Parameters:
1423a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
142420f4b53cSBarry Smith . faces       - Number of faces per dimension, or `NULL` for (1, 1, 1)
142520f4b53cSBarry Smith . lower       - The lower left corner, or `NULL` for (0, 0, 0)
142620f4b53cSBarry Smith . upper       - The upper right corner, or `NULL` for (1, 1, 1)
142720f4b53cSBarry Smith . periodicity - The boundary type for the X,Y,Z direction, or `NULL` for `DM_BOUNDARY_NONE`
1428a1cb98faSBarry Smith . orderHeight - If `PETSC_TRUE`, orders the extruded cells in the height first. Otherwise, orders the cell on the layers first
142900dabe28SStefano Zampini - interpolate - Flag to create intermediate mesh pieces (edges, faces)
143000dabe28SStefano Zampini 
143100dabe28SStefano Zampini   Output Parameter:
1432a1cb98faSBarry Smith . dm - The `DM` object
143300dabe28SStefano Zampini 
143400dabe28SStefano Zampini   Level: beginner
143500dabe28SStefano Zampini 
14361cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateHexCylinderMesh()`, `DMPlexCreateWedgeCylinderMesh()`, `DMExtrude()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
143700dabe28SStefano Zampini @*/
1438d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateWedgeBoxMesh(MPI_Comm comm, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[], PetscBool orderHeight, PetscBool interpolate, DM *dm)
1439d71ae5a4SJacob Faibussowitsch {
14409318fe57SMatthew G. Knepley   PetscInt       fac[3] = {1, 1, 1};
144100dabe28SStefano Zampini   PetscReal      low[3] = {0, 0, 0};
144200dabe28SStefano Zampini   PetscReal      upp[3] = {1, 1, 1};
144300dabe28SStefano Zampini   DMBoundaryType bdt[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
144400dabe28SStefano Zampini 
144500dabe28SStefano Zampini   PetscFunctionBegin;
14469566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
14479566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
14489566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateWedgeBoxMesh_Internal(*dm, faces ? faces : fac, lower ? lower : low, upper ? upper : upp, periodicity ? periodicity : bdt));
1449d410b0cfSMatthew G. Knepley   if (!interpolate) {
1450d410b0cfSMatthew G. Knepley     DM udm;
145100dabe28SStefano Zampini 
14529566063dSJacob Faibussowitsch     PetscCall(DMPlexUninterpolate(*dm, &udm));
145369d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(*dm, &udm));
145400dabe28SStefano Zampini   }
14557ff04441SMatthew G. Knepley   if (periodicity) PetscCall(DMLocalizeCoordinates(*dm));
14563ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
145700dabe28SStefano Zampini }
145800dabe28SStefano Zampini 
1459cfb853baSMatthew G. Knepley /*
1460cfb853baSMatthew 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.
1461cfb853baSMatthew G. Knepley 
1462cfb853baSMatthew G. Knepley   Input Parameters:
1463cfb853baSMatthew G. Knepley + len - The length of the tuple
1464cfb853baSMatthew G. Knepley . max - The maximum for each dimension, so values are in [0, max)
1465cfb853baSMatthew G. Knepley - tup - A tuple of length len+1: tup[len] > 0 indicates a stopping condition
1466cfb853baSMatthew G. Knepley 
1467cfb853baSMatthew G. Knepley   Output Parameter:
146820f4b53cSBarry Smith . tup - A tuple of `len` integers whose entries are at most `max`
1469cfb853baSMatthew G. Knepley 
1470cfb853baSMatthew G. Knepley   Level: developer
1471cfb853baSMatthew G. Knepley 
147220f4b53cSBarry Smith   Note:
147320f4b53cSBarry Smith   Ordering is lexicographic with lowest index as least significant in ordering.
147420f4b53cSBarry 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}.
147520f4b53cSBarry Smith 
1476cfb853baSMatthew G. Knepley .seealso: PetscDualSpaceTensorPointLexicographic_Internal(), PetscDualSpaceLatticePointLexicographic_Internal()
1477cfb853baSMatthew G. Knepley */
1478cfb853baSMatthew G. Knepley static PetscErrorCode DMPlexTensorPointLexicographic_Private(PetscInt len, const PetscInt max[], PetscInt tup[])
1479cfb853baSMatthew G. Knepley {
1480cfb853baSMatthew G. Knepley   PetscInt i;
1481cfb853baSMatthew G. Knepley 
1482cfb853baSMatthew G. Knepley   PetscFunctionBegin;
1483cfb853baSMatthew G. Knepley   for (i = 0; i < len; ++i) {
1484cfb853baSMatthew G. Knepley     if (tup[i] < max[i] - 1) {
1485cfb853baSMatthew G. Knepley       break;
1486cfb853baSMatthew G. Knepley     } else {
1487cfb853baSMatthew G. Knepley       tup[i] = 0;
1488cfb853baSMatthew G. Knepley     }
1489cfb853baSMatthew G. Knepley   }
1490cfb853baSMatthew G. Knepley   if (i == len) tup[i - 1] = max[i - 1];
1491cfb853baSMatthew G. Knepley   else ++tup[i];
14923ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1493cfb853baSMatthew G. Knepley }
1494cfb853baSMatthew G. Knepley 
1495cfb853baSMatthew G. Knepley static PetscInt TupleToIndex_Private(PetscInt len, const PetscInt max[], const PetscInt tup[])
1496cfb853baSMatthew G. Knepley {
1497cfb853baSMatthew G. Knepley   PetscInt i, idx = tup[len - 1];
1498cfb853baSMatthew G. Knepley 
1499cfb853baSMatthew G. Knepley   for (i = len - 2; i >= 0; --i) {
1500cfb853baSMatthew G. Knepley     idx *= max[i];
1501cfb853baSMatthew G. Knepley     idx += tup[i];
1502cfb853baSMatthew G. Knepley   }
1503cfb853baSMatthew G. Knepley   return idx;
1504cfb853baSMatthew G. Knepley }
1505cfb853baSMatthew G. Knepley 
1506cfb853baSMatthew G. Knepley static PetscErrorCode DestroyExtent_Private(void *extent)
1507cfb853baSMatthew G. Knepley {
1508cfb853baSMatthew G. Knepley   return PetscFree(extent);
1509cfb853baSMatthew G. Knepley }
1510cfb853baSMatthew G. Knepley 
1511cfb853baSMatthew G. Knepley static PetscErrorCode DMPlexCreateHypercubicMesh_Internal(DM dm, PetscInt dim, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[], const DMBoundaryType bd[])
1512cfb853baSMatthew G. Knepley {
1513cfb853baSMatthew G. Knepley   Vec          coordinates;
1514cfb853baSMatthew G. Knepley   PetscSection coordSection;
1515cfb853baSMatthew G. Knepley   DMLabel      cutLabel    = NULL;
1516cfb853baSMatthew G. Knepley   PetscBool    cutMarker   = PETSC_FALSE;
1517cfb853baSMatthew G. Knepley   PetscBool    periodic    = PETSC_FALSE;
1518cfb853baSMatthew G. Knepley   PetscInt     numCells    = 1, c;
1519cfb853baSMatthew G. Knepley   PetscInt     numVertices = 1, v;
1520cfb853baSMatthew G. Knepley   PetscScalar *coords;
1521cfb853baSMatthew G. Knepley   PetscInt    *vertices, *vert, *vtmp, *supp, cone[2];
1522cfb853baSMatthew G. Knepley   PetscInt     d, e, cell = 0, coordSize;
1523cfb853baSMatthew G. Knepley   PetscMPIInt  rank;
1524cfb853baSMatthew G. Knepley 
1525cfb853baSMatthew G. Knepley   PetscFunctionBegin;
1526cfb853baSMatthew G. Knepley   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
1527cfb853baSMatthew G. Knepley   PetscCall(DMSetDimension(dm, dim));
1528cfb853baSMatthew G. Knepley   PetscCall(PetscCalloc4(dim, &vertices, dim, &vert, dim, &vtmp, 2 * dim, &supp));
1529cfb853baSMatthew G. Knepley   PetscCall(DMCreateLabel(dm, "marker"));
1530cfb853baSMatthew G. Knepley   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_periodic_cut", &cutMarker, NULL));
1531cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) periodic = (periodic || bd[d] == DM_BOUNDARY_PERIODIC) ? PETSC_TRUE : PETSC_FALSE;
1532cfb853baSMatthew G. Knepley   if (periodic && cutMarker) {
1533cfb853baSMatthew G. Knepley     PetscCall(DMCreateLabel(dm, "periodic_cut"));
1534cfb853baSMatthew G. Knepley     PetscCall(DMGetLabel(dm, "periodic_cut", &cutLabel));
1535cfb853baSMatthew G. Knepley   }
1536cfb853baSMatthew 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");
1537cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) {
1538cfb853baSMatthew G. Knepley     vertices[d] = edges[d];
1539cfb853baSMatthew G. Knepley     numVertices *= vertices[d];
1540cfb853baSMatthew G. Knepley   }
1541cfb853baSMatthew G. Knepley   numCells = numVertices * dim;
1542cfb853baSMatthew G. Knepley   PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
1543cfb853baSMatthew G. Knepley   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, 2));
1544cfb853baSMatthew G. Knepley   for (v = numCells; v < numCells + numVertices; ++v) PetscCall(DMPlexSetSupportSize(dm, v, 2 * dim));
1545cfb853baSMatthew G. Knepley   /* TODO Loop over boundary and reset support sizes */
1546cfb853baSMatthew G. Knepley   PetscCall(DMSetUp(dm)); /* Allocate space for cones and supports */
1547cfb853baSMatthew G. Knepley   /* Build cell cones and vertex supports */
1548cfb853baSMatthew G. Knepley   PetscCall(DMCreateLabel(dm, "celltype"));
1549cfb853baSMatthew G. Knepley   while (vert[dim - 1] < vertices[dim - 1]) {
1550cfb853baSMatthew G. Knepley     const PetscInt vertex = TupleToIndex_Private(dim, vertices, vert) + numCells;
1551cfb853baSMatthew G. Knepley     PetscInt       s      = 0;
1552cfb853baSMatthew G. Knepley 
15533ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "Vertex %" PetscInt_FMT ":", vertex));
15543ba16761SJacob Faibussowitsch     for (d = 0; d < dim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %" PetscInt_FMT, vert[d]));
15553ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
1556cfb853baSMatthew G. Knepley     PetscCall(DMPlexSetCellType(dm, vertex, DM_POLYTOPE_POINT));
1557cfb853baSMatthew G. Knepley     for (d = 0; d < dim; ++d) {
1558cfb853baSMatthew G. Knepley       for (e = 0; e < dim; ++e) vtmp[e] = vert[e];
1559cfb853baSMatthew G. Knepley       vtmp[d] = (vert[d] + 1) % vertices[d];
1560cfb853baSMatthew G. Knepley       cone[0] = vertex;
1561cfb853baSMatthew G. Knepley       cone[1] = TupleToIndex_Private(dim, vertices, vtmp) + numCells;
15623ba16761SJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Vertex %" PetscInt_FMT ":", cone[1]));
15633ba16761SJacob Faibussowitsch       for (e = 0; e < dim; ++e) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %" PetscInt_FMT, vtmp[e]));
15643ba16761SJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
1565cfb853baSMatthew G. Knepley       PetscCall(DMPlexSetCone(dm, cell, cone));
1566cfb853baSMatthew G. Knepley       PetscCall(DMPlexSetCellType(dm, cell, DM_POLYTOPE_SEGMENT));
15673ba16761SJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Edge %" PetscInt_FMT " (%" PetscInt_FMT " %" PetscInt_FMT ")\n", cell, cone[0], cone[1]));
1568cfb853baSMatthew G. Knepley       ++cell;
1569cfb853baSMatthew G. Knepley     }
1570cfb853baSMatthew G. Knepley     for (d = 0; d < dim; ++d) {
1571cfb853baSMatthew G. Knepley       for (e = 0; e < dim; ++e) vtmp[e] = vert[e];
1572cfb853baSMatthew G. Knepley       vtmp[d]   = (vert[d] + vertices[d] - 1) % vertices[d];
1573cfb853baSMatthew G. Knepley       supp[s++] = TupleToIndex_Private(dim, vertices, vtmp) * dim + d;
1574cfb853baSMatthew G. Knepley       supp[s++] = (vertex - numCells) * dim + d;
1575cfb853baSMatthew G. Knepley       PetscCall(DMPlexSetSupport(dm, vertex, supp));
1576cfb853baSMatthew G. Knepley     }
1577cfb853baSMatthew G. Knepley     PetscCall(DMPlexTensorPointLexicographic_Private(dim, vertices, vert));
1578cfb853baSMatthew G. Knepley   }
1579cfb853baSMatthew G. Knepley   PetscCall(DMPlexStratify(dm));
1580cfb853baSMatthew G. Knepley   /* Build coordinates */
1581cfb853baSMatthew G. Knepley   PetscCall(DMGetCoordinateSection(dm, &coordSection));
1582cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetNumFields(coordSection, 1));
1583cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
1584cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetChart(coordSection, numCells, numCells + numVertices));
1585cfb853baSMatthew G. Knepley   for (v = numCells; v < numCells + numVertices; ++v) {
1586cfb853baSMatthew G. Knepley     PetscCall(PetscSectionSetDof(coordSection, v, dim));
1587cfb853baSMatthew G. Knepley     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
1588cfb853baSMatthew G. Knepley   }
1589cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetUp(coordSection));
1590cfb853baSMatthew G. Knepley   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
1591cfb853baSMatthew G. Knepley   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
1592cfb853baSMatthew G. Knepley   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
1593cfb853baSMatthew G. Knepley   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
1594cfb853baSMatthew G. Knepley   PetscCall(VecSetBlockSize(coordinates, dim));
1595cfb853baSMatthew G. Knepley   PetscCall(VecSetType(coordinates, VECSTANDARD));
1596cfb853baSMatthew G. Knepley   PetscCall(VecGetArray(coordinates, &coords));
1597cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) vert[d] = 0;
1598cfb853baSMatthew G. Knepley   while (vert[dim - 1] < vertices[dim - 1]) {
1599cfb853baSMatthew G. Knepley     const PetscInt vertex = TupleToIndex_Private(dim, vertices, vert);
1600cfb853baSMatthew G. Knepley 
1601cfb853baSMatthew G. Knepley     for (d = 0; d < dim; ++d) coords[vertex * dim + d] = lower[d] + ((upper[d] - lower[d]) / vertices[d]) * vert[d];
16023ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "Vertex %" PetscInt_FMT ":", vertex));
16033ba16761SJacob Faibussowitsch     for (d = 0; d < dim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %" PetscInt_FMT, vert[d]));
16043ba16761SJacob Faibussowitsch     for (d = 0; d < dim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %g", (double)PetscRealPart(coords[vertex * dim + d])));
16053ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
1606cfb853baSMatthew G. Knepley     PetscCall(DMPlexTensorPointLexicographic_Private(dim, vertices, vert));
1607cfb853baSMatthew G. Knepley   }
1608cfb853baSMatthew G. Knepley   PetscCall(VecRestoreArray(coordinates, &coords));
1609cfb853baSMatthew G. Knepley   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
1610cfb853baSMatthew G. Knepley   PetscCall(VecDestroy(&coordinates));
1611cfb853baSMatthew G. Knepley   PetscCall(PetscFree4(vertices, vert, vtmp, supp));
1612cfb853baSMatthew G. Knepley   //PetscCall(DMSetPeriodicity(dm, NULL, lower, upper));
1613cfb853baSMatthew G. Knepley   // Attach the extent
1614cfb853baSMatthew G. Knepley   {
1615cfb853baSMatthew G. Knepley     PetscContainer c;
1616cfb853baSMatthew G. Knepley     PetscInt      *extent;
1617cfb853baSMatthew G. Knepley 
1618cfb853baSMatthew G. Knepley     PetscCall(PetscMalloc1(dim, &extent));
1619cfb853baSMatthew G. Knepley     for (PetscInt d = 0; d < dim; ++d) extent[d] = edges[d];
1620cfb853baSMatthew G. Knepley     PetscCall(PetscContainerCreate(PETSC_COMM_SELF, &c));
1621cfb853baSMatthew G. Knepley     PetscCall(PetscContainerSetUserDestroy(c, DestroyExtent_Private));
1622cfb853baSMatthew G. Knepley     PetscCall(PetscContainerSetPointer(c, extent));
1623cfb853baSMatthew G. Knepley     PetscCall(PetscObjectCompose((PetscObject)dm, "_extent", (PetscObject)c));
1624cfb853baSMatthew G. Knepley     PetscCall(PetscContainerDestroy(&c));
1625cfb853baSMatthew G. Knepley   }
16263ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1627cfb853baSMatthew G. Knepley }
1628cfb853baSMatthew G. Knepley 
1629cfb853baSMatthew G. Knepley /*@C
1630aaa8cc7dSPierre Jolivet   DMPlexCreateHypercubicMesh - Creates a periodic mesh on the tensor product of unit intervals using only vertices and edges.
1631cfb853baSMatthew G. Knepley 
1632cfb853baSMatthew G. Knepley   Collective
1633cfb853baSMatthew G. Knepley 
1634cfb853baSMatthew G. Knepley   Input Parameters:
1635cfb853baSMatthew G. Knepley + comm  - The communicator for the DM object
1636cfb853baSMatthew G. Knepley . dim   - The spatial dimension
163720f4b53cSBarry Smith . edges - Number of edges per dimension, or `NULL` for (1,) in 1D and (2, 2) in 2D and (1, 1, 1) in 3D
163820f4b53cSBarry Smith . lower - The lower left corner, or `NULL` for (0, 0, 0)
163920f4b53cSBarry Smith - upper - The upper right corner, or `NULL` for (1, 1, 1)
1640cfb853baSMatthew G. Knepley 
1641cfb853baSMatthew G. Knepley   Output Parameter:
1642cfb853baSMatthew G. Knepley . dm - The DM object
1643cfb853baSMatthew G. Knepley 
164420f4b53cSBarry Smith   Level: beginner
164520f4b53cSBarry Smith 
164620f4b53cSBarry Smith   Note:
164720f4b53cSBarry Smith   If you want to customize this mesh using options, you just need to
164820f4b53cSBarry Smith .vb
164920f4b53cSBarry Smith   DMCreate(comm, &dm);
165020f4b53cSBarry Smith   DMSetType(dm, DMPLEX);
165120f4b53cSBarry Smith   DMSetFromOptions(dm);
165220f4b53cSBarry Smith .ve
165320f4b53cSBarry Smith   and use the options on the `DMSetFromOptions()` page.
1654cfb853baSMatthew G. Knepley 
1655cfb853baSMatthew G. Knepley   The vertices are numbered is lexicographic order, and the dim edges exiting a vertex in the positive orthant are number consecutively,
165620f4b53cSBarry Smith .vb
165720f4b53cSBarry Smith  18--0-19--2-20--4-18
165820f4b53cSBarry Smith   |     |     |     |
165920f4b53cSBarry Smith  13    15    17    13
166020f4b53cSBarry Smith   |     |     |     |
166120f4b53cSBarry Smith  24-12-25-14-26-16-24
166220f4b53cSBarry Smith   |     |     |     |
166320f4b53cSBarry Smith   7     9    11     7
166420f4b53cSBarry Smith   |     |     |     |
166520f4b53cSBarry Smith  21--6-22--8-23-10-21
166620f4b53cSBarry Smith   |     |     |     |
166720f4b53cSBarry Smith   1     3     5     1
166820f4b53cSBarry Smith   |     |     |     |
166920f4b53cSBarry Smith  18--0-19--2-20--4-18
167020f4b53cSBarry Smith .ve
1671cfb853baSMatthew G. Knepley 
167276fbde31SPierre Jolivet .seealso: `DMSetFromOptions()`, `DMPlexCreateFromFile()`, `DMPlexCreateHexCylinderMesh()`, `DMSetType()`, `DMCreate()`
1673cfb853baSMatthew G. Knepley @*/
1674cfb853baSMatthew G. Knepley PetscErrorCode DMPlexCreateHypercubicMesh(MPI_Comm comm, PetscInt dim, const PetscInt edges[], const PetscReal lower[], const PetscReal upper[], DM *dm)
1675cfb853baSMatthew G. Knepley {
1676cfb853baSMatthew G. Knepley   PetscInt       *edg;
1677cfb853baSMatthew G. Knepley   PetscReal      *low, *upp;
1678cfb853baSMatthew G. Knepley   DMBoundaryType *bdt;
1679cfb853baSMatthew G. Knepley   PetscInt        d;
1680cfb853baSMatthew G. Knepley 
1681cfb853baSMatthew G. Knepley   PetscFunctionBegin;
1682cfb853baSMatthew G. Knepley   PetscCall(DMCreate(comm, dm));
1683cfb853baSMatthew G. Knepley   PetscCall(DMSetType(*dm, DMPLEX));
1684cfb853baSMatthew G. Knepley   PetscCall(PetscMalloc4(dim, &edg, dim, &low, dim, &upp, dim, &bdt));
1685cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) {
1686cfb853baSMatthew G. Knepley     edg[d] = edges ? edges[d] : 1;
1687cfb853baSMatthew G. Knepley     low[d] = lower ? lower[d] : 0.;
1688cfb853baSMatthew G. Knepley     upp[d] = upper ? upper[d] : 1.;
1689cfb853baSMatthew G. Knepley     bdt[d] = DM_BOUNDARY_PERIODIC;
1690cfb853baSMatthew G. Knepley   }
1691cfb853baSMatthew G. Knepley   PetscCall(DMPlexCreateHypercubicMesh_Internal(*dm, dim, low, upp, edg, bdt));
1692cfb853baSMatthew G. Knepley   PetscCall(PetscFree4(edg, low, upp, bdt));
16933ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1694cfb853baSMatthew G. Knepley }
1695cfb853baSMatthew G. Knepley 
1696a9074c1eSMatthew G. Knepley /*@C
1697a1cb98faSBarry Smith   DMPlexSetOptionsPrefix - Sets the prefix used for searching for all `DM` options in the database.
1698a9074c1eSMatthew G. Knepley 
169920f4b53cSBarry Smith   Logically Collective
1700a9074c1eSMatthew G. Knepley 
1701a9074c1eSMatthew G. Knepley   Input Parameters:
170220f4b53cSBarry Smith + dm     - the `DM` context
1703a9074c1eSMatthew G. Knepley - prefix - the prefix to prepend to all option names
1704a9074c1eSMatthew G. Knepley 
1705a1cb98faSBarry Smith   Level: advanced
1706a1cb98faSBarry Smith 
1707a1cb98faSBarry Smith   Note:
1708a9074c1eSMatthew G. Knepley   A hyphen (-) must NOT be given at the beginning of the prefix name.
1709a9074c1eSMatthew G. Knepley   The first character of all runtime options is AUTOMATICALLY the hyphen.
1710a9074c1eSMatthew G. Knepley 
17111cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `SNESSetFromOptions()`
1712a9074c1eSMatthew G. Knepley @*/
1713d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexSetOptionsPrefix(DM dm, const char prefix[])
1714d71ae5a4SJacob Faibussowitsch {
1715a9074c1eSMatthew G. Knepley   DM_Plex *mesh = (DM_Plex *)dm->data;
1716a9074c1eSMatthew G. Knepley 
1717a9074c1eSMatthew G. Knepley   PetscFunctionBegin;
1718a9074c1eSMatthew G. Knepley   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
17199566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)dm, prefix));
17209566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)mesh->partitioner, prefix));
17213ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1722a9074c1eSMatthew G. Knepley }
1723a9074c1eSMatthew G. Knepley 
17249318fe57SMatthew G. Knepley /* Remap geometry to cylinder
172561a622f3SMatthew G. Knepley    TODO: This only works for a single refinement, then it is broken
172661a622f3SMatthew G. Knepley 
17279318fe57SMatthew G. Knepley      Interior square: Linear interpolation is correct
17289318fe57SMatthew G. Knepley      The other cells all have vertices on rays from the origin. We want to uniformly expand the spacing
17299318fe57SMatthew G. Knepley      such that the last vertex is on the unit circle. So the closest and farthest vertices are at distance
17300510c589SMatthew G. Knepley 
17319318fe57SMatthew G. Knepley        phi     = arctan(y/x)
17329318fe57SMatthew G. Knepley        d_close = sqrt(1/8 + 1/4 sin^2(phi))
17339318fe57SMatthew G. Knepley        d_far   = sqrt(1/2 + sin^2(phi))
17340510c589SMatthew G. Knepley 
17359318fe57SMatthew G. Knepley      so we remap them using
17360510c589SMatthew G. Knepley 
17379318fe57SMatthew G. Knepley        x_new = x_close + (x - x_close) (1 - d_close) / (d_far - d_close)
17389318fe57SMatthew G. Knepley        y_new = y_close + (y - y_close) (1 - d_close) / (d_far - d_close)
17390510c589SMatthew G. Knepley 
17409318fe57SMatthew G. Knepley      If pi/4 < phi < 3pi/4 or -3pi/4 < phi < -pi/4, then we switch x and y.
17419318fe57SMatthew G. Knepley */
1742d71ae5a4SJacob 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[])
1743d71ae5a4SJacob Faibussowitsch {
17449318fe57SMatthew G. Knepley   const PetscReal dis = 1.0 / PetscSqrtReal(2.0);
17459318fe57SMatthew G. Knepley   const PetscReal ds2 = 0.5 * dis;
174622cc497dSMatthew G. Knepley 
17479318fe57SMatthew G. Knepley   if ((PetscAbsScalar(u[0]) <= ds2) && (PetscAbsScalar(u[1]) <= ds2)) {
17489318fe57SMatthew G. Knepley     f0[0] = u[0];
17499318fe57SMatthew G. Knepley     f0[1] = u[1];
17509318fe57SMatthew G. Knepley   } else {
17519318fe57SMatthew G. Knepley     PetscReal phi, sinp, cosp, dc, df, x, y, xc, yc;
17520510c589SMatthew G. Knepley 
17539318fe57SMatthew G. Knepley     x    = PetscRealPart(u[0]);
17549318fe57SMatthew G. Knepley     y    = PetscRealPart(u[1]);
17559318fe57SMatthew G. Knepley     phi  = PetscAtan2Real(y, x);
17569318fe57SMatthew G. Knepley     sinp = PetscSinReal(phi);
17579318fe57SMatthew G. Knepley     cosp = PetscCosReal(phi);
17589318fe57SMatthew G. Knepley     if ((PetscAbsReal(phi) > PETSC_PI / 4.0) && (PetscAbsReal(phi) < 3.0 * PETSC_PI / 4.0)) {
17599318fe57SMatthew G. Knepley       dc = PetscAbsReal(ds2 / sinp);
17609318fe57SMatthew G. Knepley       df = PetscAbsReal(dis / sinp);
17619318fe57SMatthew G. Knepley       xc = ds2 * x / PetscAbsReal(y);
17629318fe57SMatthew G. Knepley       yc = ds2 * PetscSignReal(y);
17639318fe57SMatthew G. Knepley     } else {
17649318fe57SMatthew G. Knepley       dc = PetscAbsReal(ds2 / cosp);
17659318fe57SMatthew G. Knepley       df = PetscAbsReal(dis / cosp);
17669318fe57SMatthew G. Knepley       xc = ds2 * PetscSignReal(x);
17679318fe57SMatthew G. Knepley       yc = ds2 * y / PetscAbsReal(x);
17689318fe57SMatthew G. Knepley     }
17699318fe57SMatthew G. Knepley     f0[0] = xc + (u[0] - xc) * (1.0 - dc) / (df - dc);
17709318fe57SMatthew G. Knepley     f0[1] = yc + (u[1] - yc) * (1.0 - dc) / (df - dc);
17719318fe57SMatthew G. Knepley   }
17729318fe57SMatthew G. Knepley   f0[2] = u[2];
17739318fe57SMatthew G. Knepley }
17740510c589SMatthew G. Knepley 
1775d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateHexCylinderMesh_Internal(DM dm, DMBoundaryType periodicZ)
1776d71ae5a4SJacob Faibussowitsch {
17770510c589SMatthew G. Knepley   const PetscInt dim = 3;
17789318fe57SMatthew G. Knepley   PetscInt       numCells, numVertices;
1779d8c47e87SMatthew G. Knepley   PetscMPIInt    rank;
17800510c589SMatthew G. Knepley 
17810510c589SMatthew G. Knepley   PetscFunctionBegin;
178246139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
17839566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
17849566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
17850510c589SMatthew G. Knepley   /* Create topology */
17860510c589SMatthew G. Knepley   {
17870510c589SMatthew G. Knepley     PetscInt cone[8], c;
17880510c589SMatthew G. Knepley 
1789dd400576SPatrick Sanan     numCells    = rank == 0 ? 5 : 0;
1790dd400576SPatrick Sanan     numVertices = rank == 0 ? 16 : 0;
1791006a8963SMatthew G. Knepley     if (periodicZ == DM_BOUNDARY_PERIODIC) {
1792ae8bcbbbSMatthew G. Knepley       numCells *= 3;
1793dd400576SPatrick Sanan       numVertices = rank == 0 ? 24 : 0;
1794006a8963SMatthew G. Knepley     }
17959566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
17969566063dSJacob Faibussowitsch     for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 8));
17979566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm));
1798dd400576SPatrick Sanan     if (rank == 0) {
1799006a8963SMatthew G. Knepley       if (periodicZ == DM_BOUNDARY_PERIODIC) {
18009371c9d4SSatish Balay         cone[0] = 15;
18019371c9d4SSatish Balay         cone[1] = 18;
18029371c9d4SSatish Balay         cone[2] = 17;
18039371c9d4SSatish Balay         cone[3] = 16;
18049371c9d4SSatish Balay         cone[4] = 31;
18059371c9d4SSatish Balay         cone[5] = 32;
18069371c9d4SSatish Balay         cone[6] = 33;
18079371c9d4SSatish Balay         cone[7] = 34;
18089566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
18099371c9d4SSatish Balay         cone[0] = 16;
18109371c9d4SSatish Balay         cone[1] = 17;
18119371c9d4SSatish Balay         cone[2] = 24;
18129371c9d4SSatish Balay         cone[3] = 23;
18139371c9d4SSatish Balay         cone[4] = 32;
18149371c9d4SSatish Balay         cone[5] = 36;
18159371c9d4SSatish Balay         cone[6] = 37;
18169371c9d4SSatish Balay         cone[7] = 33; /* 22 25 26 21 */
18179566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
18189371c9d4SSatish Balay         cone[0] = 18;
18199371c9d4SSatish Balay         cone[1] = 27;
18209371c9d4SSatish Balay         cone[2] = 24;
18219371c9d4SSatish Balay         cone[3] = 17;
18229371c9d4SSatish Balay         cone[4] = 34;
18239371c9d4SSatish Balay         cone[5] = 33;
18249371c9d4SSatish Balay         cone[6] = 37;
18259371c9d4SSatish Balay         cone[7] = 38;
18269566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
18279371c9d4SSatish Balay         cone[0] = 29;
18289371c9d4SSatish Balay         cone[1] = 27;
18299371c9d4SSatish Balay         cone[2] = 18;
18309371c9d4SSatish Balay         cone[3] = 15;
18319371c9d4SSatish Balay         cone[4] = 35;
18329371c9d4SSatish Balay         cone[5] = 31;
18339371c9d4SSatish Balay         cone[6] = 34;
18349371c9d4SSatish Balay         cone[7] = 38;
18359566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
18369371c9d4SSatish Balay         cone[0] = 29;
18379371c9d4SSatish Balay         cone[1] = 15;
18389371c9d4SSatish Balay         cone[2] = 16;
18399371c9d4SSatish Balay         cone[3] = 23;
18409371c9d4SSatish Balay         cone[4] = 35;
18419371c9d4SSatish Balay         cone[5] = 36;
18429371c9d4SSatish Balay         cone[6] = 32;
18439371c9d4SSatish Balay         cone[7] = 31;
18449566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
1845006a8963SMatthew G. Knepley 
18469371c9d4SSatish Balay         cone[0] = 31;
18479371c9d4SSatish Balay         cone[1] = 34;
18489371c9d4SSatish Balay         cone[2] = 33;
18499371c9d4SSatish Balay         cone[3] = 32;
18509371c9d4SSatish Balay         cone[4] = 19;
18519371c9d4SSatish Balay         cone[5] = 22;
18529371c9d4SSatish Balay         cone[6] = 21;
18539371c9d4SSatish Balay         cone[7] = 20;
18549566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 5, cone));
18559371c9d4SSatish Balay         cone[0] = 32;
18569371c9d4SSatish Balay         cone[1] = 33;
18579371c9d4SSatish Balay         cone[2] = 37;
18589371c9d4SSatish Balay         cone[3] = 36;
18599371c9d4SSatish Balay         cone[4] = 22;
18609371c9d4SSatish Balay         cone[5] = 25;
18619371c9d4SSatish Balay         cone[6] = 26;
18629371c9d4SSatish Balay         cone[7] = 21;
18639566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 6, cone));
18649371c9d4SSatish Balay         cone[0] = 34;
18659371c9d4SSatish Balay         cone[1] = 38;
18669371c9d4SSatish Balay         cone[2] = 37;
18679371c9d4SSatish Balay         cone[3] = 33;
18689371c9d4SSatish Balay         cone[4] = 20;
18699371c9d4SSatish Balay         cone[5] = 21;
18709371c9d4SSatish Balay         cone[6] = 26;
18719371c9d4SSatish Balay         cone[7] = 28;
18729566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 7, cone));
18739371c9d4SSatish Balay         cone[0] = 35;
18749371c9d4SSatish Balay         cone[1] = 38;
18759371c9d4SSatish Balay         cone[2] = 34;
18769371c9d4SSatish Balay         cone[3] = 31;
18779371c9d4SSatish Balay         cone[4] = 30;
18789371c9d4SSatish Balay         cone[5] = 19;
18799371c9d4SSatish Balay         cone[6] = 20;
18809371c9d4SSatish Balay         cone[7] = 28;
18819566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 8, cone));
18829371c9d4SSatish Balay         cone[0] = 35;
18839371c9d4SSatish Balay         cone[1] = 31;
18849371c9d4SSatish Balay         cone[2] = 32;
18859371c9d4SSatish Balay         cone[3] = 36;
18869371c9d4SSatish Balay         cone[4] = 30;
18879371c9d4SSatish Balay         cone[5] = 25;
18889371c9d4SSatish Balay         cone[6] = 22;
18899371c9d4SSatish Balay         cone[7] = 19;
18909566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 9, cone));
1891ae8bcbbbSMatthew G. Knepley 
18929371c9d4SSatish Balay         cone[0] = 19;
18939371c9d4SSatish Balay         cone[1] = 20;
18949371c9d4SSatish Balay         cone[2] = 21;
18959371c9d4SSatish Balay         cone[3] = 22;
18969371c9d4SSatish Balay         cone[4] = 15;
18979371c9d4SSatish Balay         cone[5] = 16;
18989371c9d4SSatish Balay         cone[6] = 17;
18999371c9d4SSatish Balay         cone[7] = 18;
19009566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 10, cone));
19019371c9d4SSatish Balay         cone[0] = 22;
19029371c9d4SSatish Balay         cone[1] = 21;
19039371c9d4SSatish Balay         cone[2] = 26;
19049371c9d4SSatish Balay         cone[3] = 25;
19059371c9d4SSatish Balay         cone[4] = 16;
19069371c9d4SSatish Balay         cone[5] = 23;
19079371c9d4SSatish Balay         cone[6] = 24;
19089371c9d4SSatish Balay         cone[7] = 17;
19099566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 11, cone));
19109371c9d4SSatish Balay         cone[0] = 20;
19119371c9d4SSatish Balay         cone[1] = 28;
19129371c9d4SSatish Balay         cone[2] = 26;
19139371c9d4SSatish Balay         cone[3] = 21;
19149371c9d4SSatish Balay         cone[4] = 18;
19159371c9d4SSatish Balay         cone[5] = 17;
19169371c9d4SSatish Balay         cone[6] = 24;
19179371c9d4SSatish Balay         cone[7] = 27;
19189566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 12, cone));
19199371c9d4SSatish Balay         cone[0] = 30;
19209371c9d4SSatish Balay         cone[1] = 28;
19219371c9d4SSatish Balay         cone[2] = 20;
19229371c9d4SSatish Balay         cone[3] = 19;
19239371c9d4SSatish Balay         cone[4] = 29;
19249371c9d4SSatish Balay         cone[5] = 15;
19259371c9d4SSatish Balay         cone[6] = 18;
19269371c9d4SSatish Balay         cone[7] = 27;
19279566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 13, cone));
19289371c9d4SSatish Balay         cone[0] = 30;
19299371c9d4SSatish Balay         cone[1] = 19;
19309371c9d4SSatish Balay         cone[2] = 22;
19319371c9d4SSatish Balay         cone[3] = 25;
19329371c9d4SSatish Balay         cone[4] = 29;
19339371c9d4SSatish Balay         cone[5] = 23;
19349371c9d4SSatish Balay         cone[6] = 16;
19359371c9d4SSatish Balay         cone[7] = 15;
19369566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 14, cone));
1937006a8963SMatthew G. Knepley       } else {
19389371c9d4SSatish Balay         cone[0] = 5;
19399371c9d4SSatish Balay         cone[1] = 8;
19409371c9d4SSatish Balay         cone[2] = 7;
19419371c9d4SSatish Balay         cone[3] = 6;
19429371c9d4SSatish Balay         cone[4] = 9;
19439371c9d4SSatish Balay         cone[5] = 12;
19449371c9d4SSatish Balay         cone[6] = 11;
19459371c9d4SSatish Balay         cone[7] = 10;
19469566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
19479371c9d4SSatish Balay         cone[0] = 6;
19489371c9d4SSatish Balay         cone[1] = 7;
19499371c9d4SSatish Balay         cone[2] = 14;
19509371c9d4SSatish Balay         cone[3] = 13;
19519371c9d4SSatish Balay         cone[4] = 12;
19529371c9d4SSatish Balay         cone[5] = 15;
19539371c9d4SSatish Balay         cone[6] = 16;
19549371c9d4SSatish Balay         cone[7] = 11;
19559566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
19569371c9d4SSatish Balay         cone[0] = 8;
19579371c9d4SSatish Balay         cone[1] = 17;
19589371c9d4SSatish Balay         cone[2] = 14;
19599371c9d4SSatish Balay         cone[3] = 7;
19609371c9d4SSatish Balay         cone[4] = 10;
19619371c9d4SSatish Balay         cone[5] = 11;
19629371c9d4SSatish Balay         cone[6] = 16;
19639371c9d4SSatish Balay         cone[7] = 18;
19649566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
19659371c9d4SSatish Balay         cone[0] = 19;
19669371c9d4SSatish Balay         cone[1] = 17;
19679371c9d4SSatish Balay         cone[2] = 8;
19689371c9d4SSatish Balay         cone[3] = 5;
19699371c9d4SSatish Balay         cone[4] = 20;
19709371c9d4SSatish Balay         cone[5] = 9;
19719371c9d4SSatish Balay         cone[6] = 10;
19729371c9d4SSatish Balay         cone[7] = 18;
19739566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
19749371c9d4SSatish Balay         cone[0] = 19;
19759371c9d4SSatish Balay         cone[1] = 5;
19769371c9d4SSatish Balay         cone[2] = 6;
19779371c9d4SSatish Balay         cone[3] = 13;
19789371c9d4SSatish Balay         cone[4] = 20;
19799371c9d4SSatish Balay         cone[5] = 15;
19809371c9d4SSatish Balay         cone[6] = 12;
19819371c9d4SSatish Balay         cone[7] = 9;
19829566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
1983006a8963SMatthew G. Knepley       }
1984d8c47e87SMatthew G. Knepley     }
19859566063dSJacob Faibussowitsch     PetscCall(DMPlexSymmetrize(dm));
19869566063dSJacob Faibussowitsch     PetscCall(DMPlexStratify(dm));
19870510c589SMatthew G. Knepley   }
1988dbc1dc17SMatthew G. Knepley   /* Create cube geometry */
19890510c589SMatthew G. Knepley   {
19900510c589SMatthew G. Knepley     Vec             coordinates;
19910510c589SMatthew G. Knepley     PetscSection    coordSection;
19920510c589SMatthew G. Knepley     PetscScalar    *coords;
19930510c589SMatthew G. Knepley     PetscInt        coordSize, v;
19940510c589SMatthew G. Knepley     const PetscReal dis = 1.0 / PetscSqrtReal(2.0);
19950510c589SMatthew G. Knepley     const PetscReal ds2 = dis / 2.0;
19960510c589SMatthew G. Knepley 
19970510c589SMatthew G. Knepley     /* Build coordinates */
19989566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &coordSection));
19999566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetNumFields(coordSection, 1));
20009566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
20019566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetChart(coordSection, numCells, numCells + numVertices));
20020510c589SMatthew G. Knepley     for (v = numCells; v < numCells + numVertices; ++v) {
20039566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetDof(coordSection, v, dim));
20049566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
20050510c589SMatthew G. Knepley     }
20069566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetUp(coordSection));
20079566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
20089566063dSJacob Faibussowitsch     PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
20099566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
20109566063dSJacob Faibussowitsch     PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
20119566063dSJacob Faibussowitsch     PetscCall(VecSetBlockSize(coordinates, dim));
20129566063dSJacob Faibussowitsch     PetscCall(VecSetType(coordinates, VECSTANDARD));
20139566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
2014dd400576SPatrick Sanan     if (rank == 0) {
20159371c9d4SSatish Balay       coords[0 * dim + 0]  = -ds2;
20169371c9d4SSatish Balay       coords[0 * dim + 1]  = -ds2;
20179371c9d4SSatish Balay       coords[0 * dim + 2]  = 0.0;
20189371c9d4SSatish Balay       coords[1 * dim + 0]  = ds2;
20199371c9d4SSatish Balay       coords[1 * dim + 1]  = -ds2;
20209371c9d4SSatish Balay       coords[1 * dim + 2]  = 0.0;
20219371c9d4SSatish Balay       coords[2 * dim + 0]  = ds2;
20229371c9d4SSatish Balay       coords[2 * dim + 1]  = ds2;
20239371c9d4SSatish Balay       coords[2 * dim + 2]  = 0.0;
20249371c9d4SSatish Balay       coords[3 * dim + 0]  = -ds2;
20259371c9d4SSatish Balay       coords[3 * dim + 1]  = ds2;
20269371c9d4SSatish Balay       coords[3 * dim + 2]  = 0.0;
20279371c9d4SSatish Balay       coords[4 * dim + 0]  = -ds2;
20289371c9d4SSatish Balay       coords[4 * dim + 1]  = -ds2;
20299371c9d4SSatish Balay       coords[4 * dim + 2]  = 1.0;
20309371c9d4SSatish Balay       coords[5 * dim + 0]  = -ds2;
20319371c9d4SSatish Balay       coords[5 * dim + 1]  = ds2;
20329371c9d4SSatish Balay       coords[5 * dim + 2]  = 1.0;
20339371c9d4SSatish Balay       coords[6 * dim + 0]  = ds2;
20349371c9d4SSatish Balay       coords[6 * dim + 1]  = ds2;
20359371c9d4SSatish Balay       coords[6 * dim + 2]  = 1.0;
20369371c9d4SSatish Balay       coords[7 * dim + 0]  = ds2;
20379371c9d4SSatish Balay       coords[7 * dim + 1]  = -ds2;
20389371c9d4SSatish Balay       coords[7 * dim + 2]  = 1.0;
20399371c9d4SSatish Balay       coords[8 * dim + 0]  = dis;
20409371c9d4SSatish Balay       coords[8 * dim + 1]  = -dis;
20419371c9d4SSatish Balay       coords[8 * dim + 2]  = 0.0;
20429371c9d4SSatish Balay       coords[9 * dim + 0]  = dis;
20439371c9d4SSatish Balay       coords[9 * dim + 1]  = dis;
20449371c9d4SSatish Balay       coords[9 * dim + 2]  = 0.0;
20459371c9d4SSatish Balay       coords[10 * dim + 0] = dis;
20469371c9d4SSatish Balay       coords[10 * dim + 1] = -dis;
20479371c9d4SSatish Balay       coords[10 * dim + 2] = 1.0;
20489371c9d4SSatish Balay       coords[11 * dim + 0] = dis;
20499371c9d4SSatish Balay       coords[11 * dim + 1] = dis;
20509371c9d4SSatish Balay       coords[11 * dim + 2] = 1.0;
20519371c9d4SSatish Balay       coords[12 * dim + 0] = -dis;
20529371c9d4SSatish Balay       coords[12 * dim + 1] = dis;
20539371c9d4SSatish Balay       coords[12 * dim + 2] = 0.0;
20549371c9d4SSatish Balay       coords[13 * dim + 0] = -dis;
20559371c9d4SSatish Balay       coords[13 * dim + 1] = dis;
20569371c9d4SSatish Balay       coords[13 * dim + 2] = 1.0;
20579371c9d4SSatish Balay       coords[14 * dim + 0] = -dis;
20589371c9d4SSatish Balay       coords[14 * dim + 1] = -dis;
20599371c9d4SSatish Balay       coords[14 * dim + 2] = 0.0;
20609371c9d4SSatish Balay       coords[15 * dim + 0] = -dis;
20619371c9d4SSatish Balay       coords[15 * dim + 1] = -dis;
20629371c9d4SSatish Balay       coords[15 * dim + 2] = 1.0;
2063ae8bcbbbSMatthew G. Knepley       if (periodicZ == DM_BOUNDARY_PERIODIC) {
20649371c9d4SSatish Balay         /* 15 31 19 */ coords[16 * dim + 0] = -ds2;
20659371c9d4SSatish Balay         coords[16 * dim + 1]                = -ds2;
20669371c9d4SSatish Balay         coords[16 * dim + 2]                = 0.5;
20679371c9d4SSatish Balay         /* 16 32 22 */ coords[17 * dim + 0] = ds2;
20689371c9d4SSatish Balay         coords[17 * dim + 1]                = -ds2;
20699371c9d4SSatish Balay         coords[17 * dim + 2]                = 0.5;
20709371c9d4SSatish Balay         /* 17 33 21 */ coords[18 * dim + 0] = ds2;
20719371c9d4SSatish Balay         coords[18 * dim + 1]                = ds2;
20729371c9d4SSatish Balay         coords[18 * dim + 2]                = 0.5;
20739371c9d4SSatish Balay         /* 18 34 20 */ coords[19 * dim + 0] = -ds2;
20749371c9d4SSatish Balay         coords[19 * dim + 1]                = ds2;
20759371c9d4SSatish Balay         coords[19 * dim + 2]                = 0.5;
20769371c9d4SSatish Balay         /* 29 35 30 */ coords[20 * dim + 0] = -dis;
20779371c9d4SSatish Balay         coords[20 * dim + 1]                = -dis;
20789371c9d4SSatish Balay         coords[20 * dim + 2]                = 0.5;
20799371c9d4SSatish Balay         /* 23 36 25 */ coords[21 * dim + 0] = dis;
20809371c9d4SSatish Balay         coords[21 * dim + 1]                = -dis;
20819371c9d4SSatish Balay         coords[21 * dim + 2]                = 0.5;
20829371c9d4SSatish Balay         /* 24 37 26 */ coords[22 * dim + 0] = dis;
20839371c9d4SSatish Balay         coords[22 * dim + 1]                = dis;
20849371c9d4SSatish Balay         coords[22 * dim + 2]                = 0.5;
20859371c9d4SSatish Balay         /* 27 38 28 */ coords[23 * dim + 0] = -dis;
20869371c9d4SSatish Balay         coords[23 * dim + 1]                = dis;
20879371c9d4SSatish Balay         coords[23 * dim + 2]                = 0.5;
2088ae8bcbbbSMatthew G. Knepley       }
2089d8c47e87SMatthew G. Knepley     }
20909566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(coordinates, &coords));
20919566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, coordinates));
20929566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&coordinates));
20930510c589SMatthew G. Knepley   }
2094006a8963SMatthew G. Knepley   /* Create periodicity */
2095006a8963SMatthew G. Knepley   if (periodicZ == DM_BOUNDARY_PERIODIC || periodicZ == DM_BOUNDARY_TWIST) {
20966858538eSMatthew G. Knepley     PetscReal L[3]       = {-1., -1., 0.};
20976858538eSMatthew G. Knepley     PetscReal maxCell[3] = {-1., -1., 0.};
2098006a8963SMatthew G. Knepley     PetscReal lower[3]   = {0.0, 0.0, 0.0};
2099ae8bcbbbSMatthew G. Knepley     PetscReal upper[3]   = {1.0, 1.0, 1.5};
21006858538eSMatthew G. Knepley     PetscInt  numZCells  = 3;
2101006a8963SMatthew G. Knepley 
21026858538eSMatthew G. Knepley     L[2]       = upper[2] - lower[2];
21036858538eSMatthew G. Knepley     maxCell[2] = 1.1 * (L[2] / numZCells);
21044fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dm, maxCell, lower, L));
2105006a8963SMatthew G. Knepley   }
2106dbc1dc17SMatthew G. Knepley   {
21079318fe57SMatthew G. Knepley     DM          cdm;
21089318fe57SMatthew G. Knepley     PetscDS     cds;
21099318fe57SMatthew G. Knepley     PetscScalar c[2] = {1.0, 1.0};
2110dbc1dc17SMatthew G. Knepley 
2111*e44f6aebSMatthew G. Knepley     PetscCall(DMPlexCreateCoordinateSpace(dm, 1, PETSC_TRUE, snapToCylinder));
21129566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
21139566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
21149566063dSJacob Faibussowitsch     PetscCall(PetscDSSetConstants(cds, 2, c));
2115dbc1dc17SMatthew G. Knepley   }
211646139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
211746139095SJed Brown 
21189318fe57SMatthew G. Knepley   /* Wait for coordinate creation before doing in-place modification */
21199566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolateInPlace_Internal(dm));
21203ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
21210510c589SMatthew G. Knepley }
21220510c589SMatthew G. Knepley 
212324119c2aSMatthew G. Knepley /*@
21249318fe57SMatthew G. Knepley   DMPlexCreateHexCylinderMesh - Creates a mesh on the tensor product of the unit interval with the circle (cylinder) using hexahedra.
212524119c2aSMatthew G. Knepley 
2126d083f849SBarry Smith   Collective
212724119c2aSMatthew G. Knepley 
212824119c2aSMatthew G. Knepley   Input Parameters:
2129a1cb98faSBarry Smith + comm      - The communicator for the `DM` object
21309318fe57SMatthew G. Knepley - periodicZ - The boundary type for the Z direction
213124119c2aSMatthew G. Knepley 
213224119c2aSMatthew G. Knepley   Output Parameter:
213320f4b53cSBarry Smith . dm - The `DM` object
213424119c2aSMatthew G. Knepley 
213524119c2aSMatthew G. Knepley   Level: beginner
213624119c2aSMatthew G. Knepley 
2137a1cb98faSBarry Smith   Note:
2138a4e35b19SJacob Faibussowitsch   Here is the output numbering looking from the bottom of the cylinder\:
2139a1cb98faSBarry Smith .vb
2140a1cb98faSBarry Smith        17-----14
2141a1cb98faSBarry Smith         |     |
2142a1cb98faSBarry Smith         |  2  |
2143a1cb98faSBarry Smith         |     |
2144a1cb98faSBarry Smith  17-----8-----7-----14
2145a1cb98faSBarry Smith   |     |     |     |
2146a1cb98faSBarry Smith   |  3  |  0  |  1  |
2147a1cb98faSBarry Smith   |     |     |     |
2148a1cb98faSBarry Smith  19-----5-----6-----13
2149a1cb98faSBarry Smith         |     |
2150a1cb98faSBarry Smith         |  4  |
2151a1cb98faSBarry Smith         |     |
2152a1cb98faSBarry Smith        19-----13
2153a1cb98faSBarry Smith 
2154a1cb98faSBarry Smith  and up through the top
2155a1cb98faSBarry Smith 
2156a1cb98faSBarry Smith        18-----16
2157a1cb98faSBarry Smith         |     |
2158a1cb98faSBarry Smith         |  2  |
2159a1cb98faSBarry Smith         |     |
2160a1cb98faSBarry Smith  18----10----11-----16
2161a1cb98faSBarry Smith   |     |     |     |
2162a1cb98faSBarry Smith   |  3  |  0  |  1  |
2163a1cb98faSBarry Smith   |     |     |     |
2164a1cb98faSBarry Smith  20-----9----12-----15
2165a1cb98faSBarry Smith         |     |
2166a1cb98faSBarry Smith         |  4  |
2167a1cb98faSBarry Smith         |     |
2168a1cb98faSBarry Smith        20-----15
2169a1cb98faSBarry Smith .ve
2170a1cb98faSBarry Smith 
21711cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
217224119c2aSMatthew G. Knepley @*/
2173d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateHexCylinderMesh(MPI_Comm comm, DMBoundaryType periodicZ, DM *dm)
2174d71ae5a4SJacob Faibussowitsch {
21759318fe57SMatthew G. Knepley   PetscFunctionBegin;
21764f572ea9SToby Isaac   PetscAssertPointer(dm, 3);
21779566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
21789566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
21799566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateHexCylinderMesh_Internal(*dm, periodicZ));
21803ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
21819318fe57SMatthew G. Knepley }
21829318fe57SMatthew G. Knepley 
2183d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateWedgeCylinderMesh_Internal(DM dm, PetscInt n, PetscBool interpolate)
2184d71ae5a4SJacob Faibussowitsch {
218524119c2aSMatthew G. Knepley   const PetscInt dim = 3;
2186412e9a14SMatthew G. Knepley   PetscInt       numCells, numVertices, v;
21879fe9f049SMatthew G. Knepley   PetscMPIInt    rank;
218824119c2aSMatthew G. Knepley 
218924119c2aSMatthew G. Knepley   PetscFunctionBegin;
219063a3b9bcSJacob Faibussowitsch   PetscCheck(n >= 0, PetscObjectComm((PetscObject)dm), PETSC_ERR_ARG_OUTOFRANGE, "Number of wedges %" PetscInt_FMT " cannot be negative", n);
219146139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
21929566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
21939566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
2194412e9a14SMatthew G. Knepley   /* Must create the celltype label here so that we do not automatically try to compute the types */
21959566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "celltype"));
219624119c2aSMatthew G. Knepley   /* Create topology */
219724119c2aSMatthew G. Knepley   {
219824119c2aSMatthew G. Knepley     PetscInt cone[6], c;
219924119c2aSMatthew G. Knepley 
2200dd400576SPatrick Sanan     numCells    = rank == 0 ? n : 0;
2201dd400576SPatrick Sanan     numVertices = rank == 0 ? 2 * (n + 1) : 0;
22029566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
22039566063dSJacob Faibussowitsch     for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 6));
22049566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm));
220524119c2aSMatthew G. Knepley     for (c = 0; c < numCells; c++) {
22069371c9d4SSatish Balay       cone[0] = c + n * 1;
22079371c9d4SSatish Balay       cone[1] = (c + 1) % n + n * 1;
22089371c9d4SSatish Balay       cone[2] = 0 + 3 * n;
22099371c9d4SSatish Balay       cone[3] = c + n * 2;
22109371c9d4SSatish Balay       cone[4] = (c + 1) % n + n * 2;
22119371c9d4SSatish Balay       cone[5] = 1 + 3 * n;
22129566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCone(dm, c, cone));
22139566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCellType(dm, c, DM_POLYTOPE_TRI_PRISM_TENSOR));
221424119c2aSMatthew G. Knepley     }
22159566063dSJacob Faibussowitsch     PetscCall(DMPlexSymmetrize(dm));
22169566063dSJacob Faibussowitsch     PetscCall(DMPlexStratify(dm));
221724119c2aSMatthew G. Knepley   }
221848a46eb9SPierre Jolivet   for (v = numCells; v < numCells + numVertices; ++v) PetscCall(DMPlexSetCellType(dm, v, DM_POLYTOPE_POINT));
221924119c2aSMatthew G. Knepley   /* Create cylinder geometry */
222024119c2aSMatthew G. Knepley   {
222124119c2aSMatthew G. Knepley     Vec          coordinates;
222224119c2aSMatthew G. Knepley     PetscSection coordSection;
222324119c2aSMatthew G. Knepley     PetscScalar *coords;
2224412e9a14SMatthew G. Knepley     PetscInt     coordSize, c;
222524119c2aSMatthew G. Knepley 
222624119c2aSMatthew G. Knepley     /* Build coordinates */
22279566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &coordSection));
22289566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetNumFields(coordSection, 1));
22299566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
22309566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetChart(coordSection, numCells, numCells + numVertices));
223124119c2aSMatthew G. Knepley     for (v = numCells; v < numCells + numVertices; ++v) {
22329566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetDof(coordSection, v, dim));
22339566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
223424119c2aSMatthew G. Knepley     }
22359566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetUp(coordSection));
22369566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
22379566063dSJacob Faibussowitsch     PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
22389566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
22399566063dSJacob Faibussowitsch     PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
22409566063dSJacob Faibussowitsch     PetscCall(VecSetBlockSize(coordinates, dim));
22419566063dSJacob Faibussowitsch     PetscCall(VecSetType(coordinates, VECSTANDARD));
22429566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
224324119c2aSMatthew G. Knepley     for (c = 0; c < numCells; c++) {
22449371c9d4SSatish Balay       coords[(c + 0 * n) * dim + 0] = PetscCosReal(2.0 * c * PETSC_PI / n);
22459371c9d4SSatish Balay       coords[(c + 0 * n) * dim + 1] = PetscSinReal(2.0 * c * PETSC_PI / n);
22469371c9d4SSatish Balay       coords[(c + 0 * n) * dim + 2] = 1.0;
22479371c9d4SSatish Balay       coords[(c + 1 * n) * dim + 0] = PetscCosReal(2.0 * c * PETSC_PI / n);
22489371c9d4SSatish Balay       coords[(c + 1 * n) * dim + 1] = PetscSinReal(2.0 * c * PETSC_PI / n);
22499371c9d4SSatish Balay       coords[(c + 1 * n) * dim + 2] = 0.0;
225024119c2aSMatthew G. Knepley     }
2251dd400576SPatrick Sanan     if (rank == 0) {
22529371c9d4SSatish Balay       coords[(2 * n + 0) * dim + 0] = 0.0;
22539371c9d4SSatish Balay       coords[(2 * n + 0) * dim + 1] = 0.0;
22549371c9d4SSatish Balay       coords[(2 * n + 0) * dim + 2] = 1.0;
22559371c9d4SSatish Balay       coords[(2 * n + 1) * dim + 0] = 0.0;
22569371c9d4SSatish Balay       coords[(2 * n + 1) * dim + 1] = 0.0;
22579371c9d4SSatish Balay       coords[(2 * n + 1) * dim + 2] = 0.0;
22589fe9f049SMatthew G. Knepley     }
22599566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(coordinates, &coords));
22609566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, coordinates));
22619566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&coordinates));
226224119c2aSMatthew G. Knepley   }
226346139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
22649318fe57SMatthew G. Knepley   /* Interpolate */
22659566063dSJacob Faibussowitsch   if (interpolate) PetscCall(DMPlexInterpolateInPlace_Internal(dm));
22663ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
22679318fe57SMatthew G. Knepley }
22689318fe57SMatthew G. Knepley 
22699318fe57SMatthew G. Knepley /*@
22709318fe57SMatthew G. Knepley   DMPlexCreateWedgeCylinderMesh - Creates a mesh on the tensor product of the unit interval with the circle (cylinder) using wedges.
22719318fe57SMatthew G. Knepley 
22729318fe57SMatthew G. Knepley   Collective
22739318fe57SMatthew G. Knepley 
22749318fe57SMatthew G. Knepley   Input Parameters:
2275a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
22769318fe57SMatthew G. Knepley . n           - The number of wedges around the origin
22779318fe57SMatthew G. Knepley - interpolate - Create edges and faces
22789318fe57SMatthew G. Knepley 
22799318fe57SMatthew G. Knepley   Output Parameter:
2280a1cb98faSBarry Smith . dm - The `DM` object
22819318fe57SMatthew G. Knepley 
22829318fe57SMatthew G. Knepley   Level: beginner
22839318fe57SMatthew G. Knepley 
22841cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateHexCylinderMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
22859318fe57SMatthew G. Knepley @*/
2286d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateWedgeCylinderMesh(MPI_Comm comm, PetscInt n, PetscBool interpolate, DM *dm)
2287d71ae5a4SJacob Faibussowitsch {
22889318fe57SMatthew G. Knepley   PetscFunctionBegin;
22894f572ea9SToby Isaac   PetscAssertPointer(dm, 4);
22909566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
22919566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
22929566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateWedgeCylinderMesh_Internal(*dm, n, interpolate));
22933ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
229424119c2aSMatthew G. Knepley }
229524119c2aSMatthew G. Knepley 
2296d71ae5a4SJacob Faibussowitsch static inline PetscReal DiffNormReal(PetscInt dim, const PetscReal x[], const PetscReal y[])
2297d71ae5a4SJacob Faibussowitsch {
229865a81367SMatthew G. Knepley   PetscReal prod = 0.0;
229965a81367SMatthew G. Knepley   PetscInt  i;
230065a81367SMatthew G. Knepley   for (i = 0; i < dim; ++i) prod += PetscSqr(x[i] - y[i]);
230165a81367SMatthew G. Knepley   return PetscSqrtReal(prod);
230265a81367SMatthew G. Knepley }
2303d71ae5a4SJacob Faibussowitsch static inline PetscReal DotReal(PetscInt dim, const PetscReal x[], const PetscReal y[])
2304d71ae5a4SJacob Faibussowitsch {
230565a81367SMatthew G. Knepley   PetscReal prod = 0.0;
230665a81367SMatthew G. Knepley   PetscInt  i;
230765a81367SMatthew G. Knepley   for (i = 0; i < dim; ++i) prod += x[i] * y[i];
230865a81367SMatthew G. Knepley   return prod;
230965a81367SMatthew G. Knepley }
231065a81367SMatthew G. Knepley 
231151a74b61SMatthew G. Knepley /* The first constant is the sphere radius */
2312d71ae5a4SJacob 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[])
2313d71ae5a4SJacob Faibussowitsch {
231451a74b61SMatthew G. Knepley   PetscReal r     = PetscRealPart(constants[0]);
231551a74b61SMatthew G. Knepley   PetscReal norm2 = 0.0, fac;
231651a74b61SMatthew G. Knepley   PetscInt  n     = uOff[1] - uOff[0], d;
231751a74b61SMatthew G. Knepley 
231851a74b61SMatthew G. Knepley   for (d = 0; d < n; ++d) norm2 += PetscSqr(PetscRealPart(u[d]));
231951a74b61SMatthew G. Knepley   fac = r / PetscSqrtReal(norm2);
232051a74b61SMatthew G. Knepley   for (d = 0; d < n; ++d) f0[d] = u[d] * fac;
232151a74b61SMatthew G. Knepley }
232251a74b61SMatthew G. Knepley 
2323d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateSphereMesh_Internal(DM dm, PetscInt dim, PetscBool simplex, PetscReal R)
2324d71ae5a4SJacob Faibussowitsch {
232565a81367SMatthew G. Knepley   const PetscInt embedDim = dim + 1;
232665a81367SMatthew G. Knepley   PetscSection   coordSection;
232765a81367SMatthew G. Knepley   Vec            coordinates;
232865a81367SMatthew G. Knepley   PetscScalar   *coords;
232965a81367SMatthew G. Knepley   PetscReal     *coordsIn;
2330064cae4fSPierre Jolivet   PetscInt       numCells, numEdges, numVerts = 0, firstVertex = 0, v, firstEdge, coordSize, d, c, e;
233165a81367SMatthew G. Knepley   PetscMPIInt    rank;
233265a81367SMatthew G. Knepley 
233365a81367SMatthew G. Knepley   PetscFunctionBegin;
23349318fe57SMatthew G. Knepley   PetscValidLogicalCollectiveBool(dm, simplex, 3);
233546139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
23369566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
23379566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, dim + 1));
23389566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
233965a81367SMatthew G. Knepley   switch (dim) {
234065a81367SMatthew G. Knepley   case 2:
234165a81367SMatthew G. Knepley     if (simplex) {
234251a74b61SMatthew G. Knepley       const PetscReal radius    = PetscSqrtReal(1 + PETSC_PHI * PETSC_PHI) / (1.0 + PETSC_PHI);
234351a74b61SMatthew G. Knepley       const PetscReal edgeLen   = 2.0 / (1.0 + PETSC_PHI) * (R / radius);
234465a81367SMatthew G. Knepley       const PetscInt  degree    = 5;
234551a74b61SMatthew G. Knepley       PetscReal       vertex[3] = {0.0, 1.0 / (1.0 + PETSC_PHI), PETSC_PHI / (1.0 + PETSC_PHI)};
234665a81367SMatthew G. Knepley       PetscInt        s[3]      = {1, 1, 1};
234765a81367SMatthew G. Knepley       PetscInt        cone[3];
234865a81367SMatthew G. Knepley       PetscInt       *graph, p, i, j, k;
234965a81367SMatthew G. Knepley 
23509371c9d4SSatish Balay       vertex[0] *= R / radius;
23519371c9d4SSatish Balay       vertex[1] *= R / radius;
23529371c9d4SSatish Balay       vertex[2] *= R / radius;
2353dd400576SPatrick Sanan       numCells    = rank == 0 ? 20 : 0;
2354dd400576SPatrick Sanan       numVerts    = rank == 0 ? 12 : 0;
235565a81367SMatthew G. Knepley       firstVertex = numCells;
235651a74b61SMatthew G. Knepley       /* Use icosahedron, which for a R-sphere has coordinates which are all cyclic permutations of
235765a81367SMatthew G. Knepley 
235865a81367SMatthew G. Knepley            (0, \pm 1/\phi+1, \pm \phi/\phi+1)
235965a81367SMatthew G. Knepley 
236065a81367SMatthew G. Knepley          where \phi^2 - \phi - 1 = 0, meaning \phi is the golden ratio \frac{1 + \sqrt{5}}{2}. The edge
236151a74b61SMatthew G. Knepley          length is then given by 2/(1+\phi) = 2 * 0.38197 = 0.76393.
236265a81367SMatthew G. Knepley       */
236365a81367SMatthew G. Knepley       /* Construct vertices */
23649566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2365dd400576SPatrick Sanan       if (rank == 0) {
236665a81367SMatthew G. Knepley         for (p = 0, i = 0; p < embedDim; ++p) {
236765a81367SMatthew G. Knepley           for (s[1] = -1; s[1] < 2; s[1] += 2) {
236865a81367SMatthew G. Knepley             for (s[2] = -1; s[2] < 2; s[2] += 2) {
236965a81367SMatthew G. Knepley               for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[(d + p) % embedDim] * vertex[(d + p) % embedDim];
237065a81367SMatthew G. Knepley               ++i;
237165a81367SMatthew G. Knepley             }
237265a81367SMatthew G. Knepley           }
237365a81367SMatthew G. Knepley         }
237445da822fSValeria Barra       }
237565a81367SMatthew G. Knepley       /* Construct graph */
23769566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * numVerts, &graph));
237765a81367SMatthew G. Knepley       for (i = 0; i < numVerts; ++i) {
237865a81367SMatthew G. Knepley         for (j = 0, k = 0; j < numVerts; ++j) {
23799371c9d4SSatish Balay           if (PetscAbsReal(DiffNormReal(embedDim, &coordsIn[i * embedDim], &coordsIn[j * embedDim]) - edgeLen) < PETSC_SMALL) {
23809371c9d4SSatish Balay             graph[i * numVerts + j] = 1;
23819371c9d4SSatish Balay             ++k;
23829371c9d4SSatish Balay           }
238365a81367SMatthew G. Knepley         }
238463a3b9bcSJacob Faibussowitsch         PetscCheck(k == degree, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid icosahedron, vertex %" PetscInt_FMT " degree %" PetscInt_FMT " != %" PetscInt_FMT, i, k, degree);
238565a81367SMatthew G. Knepley       }
238665a81367SMatthew G. Knepley       /* Build Topology */
23879566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
238848a46eb9SPierre Jolivet       for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
23899566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
239065a81367SMatthew G. Knepley       /* Cells */
239165a81367SMatthew G. Knepley       for (i = 0, c = 0; i < numVerts; ++i) {
239265a81367SMatthew G. Knepley         for (j = 0; j < i; ++j) {
239365a81367SMatthew G. Knepley           for (k = 0; k < j; ++k) {
239465a81367SMatthew G. Knepley             if (graph[i * numVerts + j] && graph[j * numVerts + k] && graph[k * numVerts + i]) {
23959371c9d4SSatish Balay               cone[0] = firstVertex + i;
23969371c9d4SSatish Balay               cone[1] = firstVertex + j;
23979371c9d4SSatish Balay               cone[2] = firstVertex + k;
239865a81367SMatthew G. Knepley               /* Check orientation */
239965a81367SMatthew G. Knepley               {
24009371c9d4SSatish Balay                 const PetscInt epsilon[3][3][3] = {
24019371c9d4SSatish Balay                   {{0, 0, 0},  {0, 0, 1},  {0, -1, 0}},
24029371c9d4SSatish Balay                   {{0, 0, -1}, {0, 0, 0},  {1, 0, 0} },
24039371c9d4SSatish Balay                   {{0, 1, 0},  {-1, 0, 0}, {0, 0, 0} }
24049371c9d4SSatish Balay                 };
240565a81367SMatthew G. Knepley                 PetscReal normal[3];
240665a81367SMatthew G. Knepley                 PetscInt  e, f;
240765a81367SMatthew G. Knepley 
240865a81367SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) {
240965a81367SMatthew G. Knepley                   normal[d] = 0.0;
241065a81367SMatthew G. Knepley                   for (e = 0; e < embedDim; ++e) {
2411ad540459SPierre 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]);
241265a81367SMatthew G. Knepley                   }
241365a81367SMatthew G. Knepley                 }
24149371c9d4SSatish Balay                 if (DotReal(embedDim, normal, &coordsIn[i * embedDim]) < 0) {
24159371c9d4SSatish Balay                   PetscInt tmp = cone[1];
24169371c9d4SSatish Balay                   cone[1]      = cone[2];
24179371c9d4SSatish Balay                   cone[2]      = tmp;
241865a81367SMatthew G. Knepley                 }
241965a81367SMatthew G. Knepley               }
24209566063dSJacob Faibussowitsch               PetscCall(DMPlexSetCone(dm, c++, cone));
242165a81367SMatthew G. Knepley             }
242265a81367SMatthew G. Knepley           }
242365a81367SMatthew G. Knepley         }
242465a81367SMatthew G. Knepley       }
24259566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
24269566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
24279566063dSJacob Faibussowitsch       PetscCall(PetscFree(graph));
242865a81367SMatthew G. Knepley     } else {
24292829fed8SMatthew G. Knepley       /*
24302829fed8SMatthew G. Knepley         12-21--13
24312829fed8SMatthew G. Knepley          |     |
24322829fed8SMatthew G. Knepley         25  4  24
24332829fed8SMatthew G. Knepley          |     |
24342829fed8SMatthew G. Knepley   12-25--9-16--8-24--13
24352829fed8SMatthew G. Knepley    |     |     |     |
24362829fed8SMatthew G. Knepley   23  5 17  0 15  3  22
24372829fed8SMatthew G. Knepley    |     |     |     |
24382829fed8SMatthew G. Knepley   10-20--6-14--7-19--11
24392829fed8SMatthew G. Knepley          |     |
24402829fed8SMatthew G. Knepley         20  1  19
24412829fed8SMatthew G. Knepley          |     |
24422829fed8SMatthew G. Knepley         10-18--11
24432829fed8SMatthew G. Knepley          |     |
24442829fed8SMatthew G. Knepley         23  2  22
24452829fed8SMatthew G. Knepley          |     |
24462829fed8SMatthew G. Knepley         12-21--13
24472829fed8SMatthew G. Knepley        */
24482829fed8SMatthew G. Knepley       PetscInt cone[4], ornt[4];
24492829fed8SMatthew G. Knepley 
2450dd400576SPatrick Sanan       numCells    = rank == 0 ? 6 : 0;
2451dd400576SPatrick Sanan       numEdges    = rank == 0 ? 12 : 0;
2452dd400576SPatrick Sanan       numVerts    = rank == 0 ? 8 : 0;
245365a81367SMatthew G. Knepley       firstVertex = numCells;
245465a81367SMatthew G. Knepley       firstEdge   = numCells + numVerts;
24552829fed8SMatthew G. Knepley       /* Build Topology */
24569566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numEdges + numVerts));
245748a46eb9SPierre Jolivet       for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 4));
245848a46eb9SPierre Jolivet       for (e = firstEdge; e < firstEdge + numEdges; ++e) PetscCall(DMPlexSetConeSize(dm, e, 2));
24599566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
2460dd400576SPatrick Sanan       if (rank == 0) {
24612829fed8SMatthew G. Knepley         /* Cell 0 */
24629371c9d4SSatish Balay         cone[0] = 14;
24639371c9d4SSatish Balay         cone[1] = 15;
24649371c9d4SSatish Balay         cone[2] = 16;
24659371c9d4SSatish Balay         cone[3] = 17;
24669566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
24679371c9d4SSatish Balay         ornt[0] = 0;
24689371c9d4SSatish Balay         ornt[1] = 0;
24699371c9d4SSatish Balay         ornt[2] = 0;
24709371c9d4SSatish Balay         ornt[3] = 0;
24719566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 0, ornt));
24722829fed8SMatthew G. Knepley         /* Cell 1 */
24739371c9d4SSatish Balay         cone[0] = 18;
24749371c9d4SSatish Balay         cone[1] = 19;
24759371c9d4SSatish Balay         cone[2] = 14;
24769371c9d4SSatish Balay         cone[3] = 20;
24779566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
24789371c9d4SSatish Balay         ornt[0] = 0;
24799371c9d4SSatish Balay         ornt[1] = 0;
24809371c9d4SSatish Balay         ornt[2] = -1;
24819371c9d4SSatish Balay         ornt[3] = 0;
24829566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 1, ornt));
24832829fed8SMatthew G. Knepley         /* Cell 2 */
24849371c9d4SSatish Balay         cone[0] = 21;
24859371c9d4SSatish Balay         cone[1] = 22;
24869371c9d4SSatish Balay         cone[2] = 18;
24879371c9d4SSatish Balay         cone[3] = 23;
24889566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
24899371c9d4SSatish Balay         ornt[0] = 0;
24909371c9d4SSatish Balay         ornt[1] = 0;
24919371c9d4SSatish Balay         ornt[2] = -1;
24929371c9d4SSatish Balay         ornt[3] = 0;
24939566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 2, ornt));
24942829fed8SMatthew G. Knepley         /* Cell 3 */
24959371c9d4SSatish Balay         cone[0] = 19;
24969371c9d4SSatish Balay         cone[1] = 22;
24979371c9d4SSatish Balay         cone[2] = 24;
24989371c9d4SSatish Balay         cone[3] = 15;
24999566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
25009371c9d4SSatish Balay         ornt[0] = -1;
25019371c9d4SSatish Balay         ornt[1] = -1;
25029371c9d4SSatish Balay         ornt[2] = 0;
25039371c9d4SSatish Balay         ornt[3] = -1;
25049566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 3, ornt));
25052829fed8SMatthew G. Knepley         /* Cell 4 */
25069371c9d4SSatish Balay         cone[0] = 16;
25079371c9d4SSatish Balay         cone[1] = 24;
25089371c9d4SSatish Balay         cone[2] = 21;
25099371c9d4SSatish Balay         cone[3] = 25;
25109566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
25119371c9d4SSatish Balay         ornt[0] = -1;
25129371c9d4SSatish Balay         ornt[1] = -1;
25139371c9d4SSatish Balay         ornt[2] = -1;
25149371c9d4SSatish Balay         ornt[3] = 0;
25159566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 4, ornt));
25162829fed8SMatthew G. Knepley         /* Cell 5 */
25179371c9d4SSatish Balay         cone[0] = 20;
25189371c9d4SSatish Balay         cone[1] = 17;
25199371c9d4SSatish Balay         cone[2] = 25;
25209371c9d4SSatish Balay         cone[3] = 23;
25219566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 5, cone));
25229371c9d4SSatish Balay         ornt[0] = -1;
25239371c9d4SSatish Balay         ornt[1] = -1;
25249371c9d4SSatish Balay         ornt[2] = -1;
25259371c9d4SSatish Balay         ornt[3] = -1;
25269566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 5, ornt));
25272829fed8SMatthew G. Knepley         /* Edges */
25289371c9d4SSatish Balay         cone[0] = 6;
25299371c9d4SSatish Balay         cone[1] = 7;
25309566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 14, cone));
25319371c9d4SSatish Balay         cone[0] = 7;
25329371c9d4SSatish Balay         cone[1] = 8;
25339566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 15, cone));
25349371c9d4SSatish Balay         cone[0] = 8;
25359371c9d4SSatish Balay         cone[1] = 9;
25369566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 16, cone));
25379371c9d4SSatish Balay         cone[0] = 9;
25389371c9d4SSatish Balay         cone[1] = 6;
25399566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 17, cone));
25409371c9d4SSatish Balay         cone[0] = 10;
25419371c9d4SSatish Balay         cone[1] = 11;
25429566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 18, cone));
25439371c9d4SSatish Balay         cone[0] = 11;
25449371c9d4SSatish Balay         cone[1] = 7;
25459566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 19, cone));
25469371c9d4SSatish Balay         cone[0] = 6;
25479371c9d4SSatish Balay         cone[1] = 10;
25489566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 20, cone));
25499371c9d4SSatish Balay         cone[0] = 12;
25509371c9d4SSatish Balay         cone[1] = 13;
25519566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 21, cone));
25529371c9d4SSatish Balay         cone[0] = 13;
25539371c9d4SSatish Balay         cone[1] = 11;
25549566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 22, cone));
25559371c9d4SSatish Balay         cone[0] = 10;
25569371c9d4SSatish Balay         cone[1] = 12;
25579566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 23, cone));
25589371c9d4SSatish Balay         cone[0] = 13;
25599371c9d4SSatish Balay         cone[1] = 8;
25609566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 24, cone));
25619371c9d4SSatish Balay         cone[0] = 12;
25629371c9d4SSatish Balay         cone[1] = 9;
25639566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 25, cone));
256445da822fSValeria Barra       }
25659566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
25669566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
25672829fed8SMatthew G. Knepley       /* Build coordinates */
25689566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2569dd400576SPatrick Sanan       if (rank == 0) {
25709371c9d4SSatish Balay         coordsIn[0 * embedDim + 0] = -R;
25719371c9d4SSatish Balay         coordsIn[0 * embedDim + 1] = R;
25729371c9d4SSatish Balay         coordsIn[0 * embedDim + 2] = -R;
25739371c9d4SSatish Balay         coordsIn[1 * embedDim + 0] = R;
25749371c9d4SSatish Balay         coordsIn[1 * embedDim + 1] = R;
25759371c9d4SSatish Balay         coordsIn[1 * embedDim + 2] = -R;
25769371c9d4SSatish Balay         coordsIn[2 * embedDim + 0] = R;
25779371c9d4SSatish Balay         coordsIn[2 * embedDim + 1] = -R;
25789371c9d4SSatish Balay         coordsIn[2 * embedDim + 2] = -R;
25799371c9d4SSatish Balay         coordsIn[3 * embedDim + 0] = -R;
25809371c9d4SSatish Balay         coordsIn[3 * embedDim + 1] = -R;
25819371c9d4SSatish Balay         coordsIn[3 * embedDim + 2] = -R;
25829371c9d4SSatish Balay         coordsIn[4 * embedDim + 0] = -R;
25839371c9d4SSatish Balay         coordsIn[4 * embedDim + 1] = R;
25849371c9d4SSatish Balay         coordsIn[4 * embedDim + 2] = R;
25859371c9d4SSatish Balay         coordsIn[5 * embedDim + 0] = R;
25869371c9d4SSatish Balay         coordsIn[5 * embedDim + 1] = R;
25879371c9d4SSatish Balay         coordsIn[5 * embedDim + 2] = R;
25889371c9d4SSatish Balay         coordsIn[6 * embedDim + 0] = -R;
25899371c9d4SSatish Balay         coordsIn[6 * embedDim + 1] = -R;
25909371c9d4SSatish Balay         coordsIn[6 * embedDim + 2] = R;
25919371c9d4SSatish Balay         coordsIn[7 * embedDim + 0] = R;
25929371c9d4SSatish Balay         coordsIn[7 * embedDim + 1] = -R;
25939371c9d4SSatish Balay         coordsIn[7 * embedDim + 2] = R;
259465a81367SMatthew G. Knepley       }
259545da822fSValeria Barra     }
259665a81367SMatthew G. Knepley     break;
259765a81367SMatthew G. Knepley   case 3:
2598116ded15SMatthew G. Knepley     if (simplex) {
2599116ded15SMatthew G. Knepley       const PetscReal edgeLen         = 1.0 / PETSC_PHI;
260051a74b61SMatthew G. Knepley       PetscReal       vertexA[4]      = {0.5, 0.5, 0.5, 0.5};
260151a74b61SMatthew G. Knepley       PetscReal       vertexB[4]      = {1.0, 0.0, 0.0, 0.0};
260251a74b61SMatthew G. Knepley       PetscReal       vertexC[4]      = {0.5, 0.5 * PETSC_PHI, 0.5 / PETSC_PHI, 0.0};
2603116ded15SMatthew G. Knepley       const PetscInt  degree          = 12;
2604116ded15SMatthew G. Knepley       PetscInt        s[4]            = {1, 1, 1};
26059371c9d4SSatish Balay       PetscInt        evenPerm[12][4] = {
26069371c9d4SSatish Balay         {0, 1, 2, 3},
26079371c9d4SSatish Balay         {0, 2, 3, 1},
26089371c9d4SSatish Balay         {0, 3, 1, 2},
26099371c9d4SSatish Balay         {1, 0, 3, 2},
26109371c9d4SSatish Balay         {1, 2, 0, 3},
26119371c9d4SSatish Balay         {1, 3, 2, 0},
26129371c9d4SSatish Balay         {2, 0, 1, 3},
26139371c9d4SSatish Balay         {2, 1, 3, 0},
26149371c9d4SSatish Balay         {2, 3, 0, 1},
26159371c9d4SSatish Balay         {3, 0, 2, 1},
26169371c9d4SSatish Balay         {3, 1, 0, 2},
26179371c9d4SSatish Balay         {3, 2, 1, 0}
26189371c9d4SSatish Balay       };
2619116ded15SMatthew G. Knepley       PetscInt  cone[4];
2620116ded15SMatthew G. Knepley       PetscInt *graph, p, i, j, k, l;
2621116ded15SMatthew G. Knepley 
26229371c9d4SSatish Balay       vertexA[0] *= R;
26239371c9d4SSatish Balay       vertexA[1] *= R;
26249371c9d4SSatish Balay       vertexA[2] *= R;
26259371c9d4SSatish Balay       vertexA[3] *= R;
26269371c9d4SSatish Balay       vertexB[0] *= R;
26279371c9d4SSatish Balay       vertexB[1] *= R;
26289371c9d4SSatish Balay       vertexB[2] *= R;
26299371c9d4SSatish Balay       vertexB[3] *= R;
26309371c9d4SSatish Balay       vertexC[0] *= R;
26319371c9d4SSatish Balay       vertexC[1] *= R;
26329371c9d4SSatish Balay       vertexC[2] *= R;
26339371c9d4SSatish Balay       vertexC[3] *= R;
2634dd400576SPatrick Sanan       numCells    = rank == 0 ? 600 : 0;
2635dd400576SPatrick Sanan       numVerts    = rank == 0 ? 120 : 0;
2636116ded15SMatthew G. Knepley       firstVertex = numCells;
2637116ded15SMatthew G. Knepley       /* Use the 600-cell, which for a unit sphere has coordinates which are
2638116ded15SMatthew G. Knepley 
2639116ded15SMatthew G. Knepley            1/2 (\pm 1, \pm 1,    \pm 1, \pm 1)                          16
2640116ded15SMatthew G. Knepley                (\pm 1,    0,       0,      0)  all cyclic permutations   8
2641116ded15SMatthew G. Knepley            1/2 (\pm 1, \pm phi, \pm 1/phi, 0)  all even permutations    96
2642116ded15SMatthew G. Knepley 
2643116ded15SMatthew G. Knepley          where \phi^2 - \phi - 1 = 0, meaning \phi is the golden ratio \frac{1 + \sqrt{5}}{2}. The edge
26446333ae4fSvaleriabarra          length is then given by 1/\phi = 0.61803.
2645116ded15SMatthew G. Knepley 
2646116ded15SMatthew G. Knepley          http://buzzard.pugetsound.edu/sage-practice/ch03s03.html
2647116ded15SMatthew G. Knepley          http://mathworld.wolfram.com/600-Cell.html
2648116ded15SMatthew G. Knepley       */
2649116ded15SMatthew G. Knepley       /* Construct vertices */
26509566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2651116ded15SMatthew G. Knepley       i = 0;
2652dd400576SPatrick Sanan       if (rank == 0) {
2653116ded15SMatthew G. Knepley         for (s[0] = -1; s[0] < 2; s[0] += 2) {
2654116ded15SMatthew G. Knepley           for (s[1] = -1; s[1] < 2; s[1] += 2) {
2655116ded15SMatthew G. Knepley             for (s[2] = -1; s[2] < 2; s[2] += 2) {
2656116ded15SMatthew G. Knepley               for (s[3] = -1; s[3] < 2; s[3] += 2) {
2657116ded15SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[d] * vertexA[d];
2658116ded15SMatthew G. Knepley                 ++i;
2659116ded15SMatthew G. Knepley               }
2660116ded15SMatthew G. Knepley             }
2661116ded15SMatthew G. Knepley           }
2662116ded15SMatthew G. Knepley         }
2663116ded15SMatthew G. Knepley         for (p = 0; p < embedDim; ++p) {
2664116ded15SMatthew G. Knepley           s[1] = s[2] = s[3] = 1;
2665116ded15SMatthew G. Knepley           for (s[0] = -1; s[0] < 2; s[0] += 2) {
2666116ded15SMatthew G. Knepley             for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[(d + p) % embedDim] * vertexB[(d + p) % embedDim];
2667116ded15SMatthew G. Knepley             ++i;
2668116ded15SMatthew G. Knepley           }
2669116ded15SMatthew G. Knepley         }
2670116ded15SMatthew G. Knepley         for (p = 0; p < 12; ++p) {
2671116ded15SMatthew G. Knepley           s[3] = 1;
2672116ded15SMatthew G. Knepley           for (s[0] = -1; s[0] < 2; s[0] += 2) {
2673116ded15SMatthew G. Knepley             for (s[1] = -1; s[1] < 2; s[1] += 2) {
2674116ded15SMatthew G. Knepley               for (s[2] = -1; s[2] < 2; s[2] += 2) {
2675116ded15SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[evenPerm[p][d]] * vertexC[evenPerm[p][d]];
2676116ded15SMatthew G. Knepley                 ++i;
2677116ded15SMatthew G. Knepley               }
2678116ded15SMatthew G. Knepley             }
2679116ded15SMatthew G. Knepley           }
2680116ded15SMatthew G. Knepley         }
268145da822fSValeria Barra       }
268263a3b9bcSJacob Faibussowitsch       PetscCheck(i == numVerts, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid 600-cell, vertices %" PetscInt_FMT " != %" PetscInt_FMT, i, numVerts);
2683116ded15SMatthew G. Knepley       /* Construct graph */
26849566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * numVerts, &graph));
2685116ded15SMatthew G. Knepley       for (i = 0; i < numVerts; ++i) {
2686116ded15SMatthew G. Knepley         for (j = 0, k = 0; j < numVerts; ++j) {
26879371c9d4SSatish Balay           if (PetscAbsReal(DiffNormReal(embedDim, &coordsIn[i * embedDim], &coordsIn[j * embedDim]) - edgeLen) < PETSC_SMALL) {
26889371c9d4SSatish Balay             graph[i * numVerts + j] = 1;
26899371c9d4SSatish Balay             ++k;
26909371c9d4SSatish Balay           }
2691116ded15SMatthew G. Knepley         }
269263a3b9bcSJacob Faibussowitsch         PetscCheck(k == degree, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid 600-cell, vertex %" PetscInt_FMT " degree %" PetscInt_FMT " != %" PetscInt_FMT, i, k, degree);
2693116ded15SMatthew G. Knepley       }
2694116ded15SMatthew G. Knepley       /* Build Topology */
26959566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
269648a46eb9SPierre Jolivet       for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
26979566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
2698116ded15SMatthew G. Knepley       /* Cells */
2699dd400576SPatrick Sanan       if (rank == 0) {
2700116ded15SMatthew G. Knepley         for (i = 0, c = 0; i < numVerts; ++i) {
2701116ded15SMatthew G. Knepley           for (j = 0; j < i; ++j) {
2702116ded15SMatthew G. Knepley             for (k = 0; k < j; ++k) {
2703116ded15SMatthew G. Knepley               for (l = 0; l < k; ++l) {
27049371c9d4SSatish 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]) {
27059371c9d4SSatish Balay                   cone[0] = firstVertex + i;
27069371c9d4SSatish Balay                   cone[1] = firstVertex + j;
27079371c9d4SSatish Balay                   cone[2] = firstVertex + k;
27089371c9d4SSatish Balay                   cone[3] = firstVertex + l;
2709116ded15SMatthew G. Knepley                   /* Check orientation: https://ef.gy/linear-algebra:normal-vectors-in-higher-dimensional-spaces */
2710116ded15SMatthew G. Knepley                   {
27119371c9d4SSatish Balay                     const PetscInt epsilon[4][4][4][4] = {
27129371c9d4SSatish 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}}},
2713116ded15SMatthew G. Knepley 
27149371c9d4SSatish 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}}},
2715116ded15SMatthew G. Knepley 
27169371c9d4SSatish 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}}},
2717116ded15SMatthew G. Knepley 
27189371c9d4SSatish 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}} }
27199371c9d4SSatish Balay                     };
2720116ded15SMatthew G. Knepley                     PetscReal normal[4];
2721116ded15SMatthew G. Knepley                     PetscInt  e, f, g;
2722116ded15SMatthew G. Knepley 
2723116ded15SMatthew G. Knepley                     for (d = 0; d < embedDim; ++d) {
2724116ded15SMatthew G. Knepley                       normal[d] = 0.0;
2725116ded15SMatthew G. Knepley                       for (e = 0; e < embedDim; ++e) {
2726116ded15SMatthew G. Knepley                         for (f = 0; f < embedDim; ++f) {
2727116ded15SMatthew G. Knepley                           for (g = 0; g < embedDim; ++g) {
2728116ded15SMatthew 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]);
2729116ded15SMatthew G. Knepley                           }
2730116ded15SMatthew G. Knepley                         }
2731116ded15SMatthew G. Knepley                       }
2732116ded15SMatthew G. Knepley                     }
27339371c9d4SSatish Balay                     if (DotReal(embedDim, normal, &coordsIn[i * embedDim]) < 0) {
27349371c9d4SSatish Balay                       PetscInt tmp = cone[1];
27359371c9d4SSatish Balay                       cone[1]      = cone[2];
27369371c9d4SSatish Balay                       cone[2]      = tmp;
27379371c9d4SSatish Balay                     }
2738116ded15SMatthew G. Knepley                   }
27399566063dSJacob Faibussowitsch                   PetscCall(DMPlexSetCone(dm, c++, cone));
2740116ded15SMatthew G. Knepley                 }
2741116ded15SMatthew G. Knepley               }
2742116ded15SMatthew G. Knepley             }
2743116ded15SMatthew G. Knepley           }
2744116ded15SMatthew G. Knepley         }
274545da822fSValeria Barra       }
27469566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
27479566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
27489566063dSJacob Faibussowitsch       PetscCall(PetscFree(graph));
2749116ded15SMatthew G. Knepley     }
2750f4d061e9SPierre Jolivet     break;
2751d71ae5a4SJacob Faibussowitsch   default:
2752d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Unsupported dimension for sphere: %" PetscInt_FMT, dim);
275365a81367SMatthew G. Knepley   }
275465a81367SMatthew G. Knepley   /* Create coordinates */
27559566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
27569566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
27579566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, embedDim));
27589566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numVerts));
27592829fed8SMatthew G. Knepley   for (v = firstVertex; v < firstVertex + numVerts; ++v) {
27609566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, embedDim));
27619566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, embedDim));
27622829fed8SMatthew G. Knepley   }
27639566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
27649566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
27659566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
27669566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, embedDim));
27679566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
27689566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
27699566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
27709566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
27719371c9d4SSatish Balay   for (v = 0; v < numVerts; ++v)
2772ad540459SPierre Jolivet     for (d = 0; d < embedDim; ++d) coords[v * embedDim + d] = coordsIn[v * embedDim + d];
27739566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
27749566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
27759566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
27769566063dSJacob Faibussowitsch   PetscCall(PetscFree(coordsIn));
277751a74b61SMatthew G. Knepley   {
277851a74b61SMatthew G. Knepley     DM          cdm;
277951a74b61SMatthew G. Knepley     PetscDS     cds;
27809318fe57SMatthew G. Knepley     PetscScalar c = R;
278151a74b61SMatthew G. Knepley 
2782*e44f6aebSMatthew G. Knepley     PetscCall(DMPlexCreateCoordinateSpace(dm, 1, PETSC_TRUE, snapToSphere));
27839566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
27849566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
27859566063dSJacob Faibussowitsch     PetscCall(PetscDSSetConstants(cds, 1, &c));
278651a74b61SMatthew G. Knepley   }
278746139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
27889318fe57SMatthew G. Knepley   /* Wait for coordinate creation before doing in-place modification */
27899566063dSJacob Faibussowitsch   if (simplex) PetscCall(DMPlexInterpolateInPlace_Internal(dm));
27903ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
27919318fe57SMatthew G. Knepley }
27929318fe57SMatthew G. Knepley 
2793b7f5c055SJed Brown typedef void (*TPSEvaluateFunc)(const PetscReal[], PetscReal *, PetscReal[], PetscReal (*)[3]);
2794b7f5c055SJed Brown 
2795b7f5c055SJed Brown /*
2796b7f5c055SJed Brown  The Schwarz P implicit surface is
2797b7f5c055SJed Brown 
2798b7f5c055SJed Brown      f(x) = cos(x0) + cos(x1) + cos(x2) = 0
2799b7f5c055SJed Brown */
2800d71ae5a4SJacob Faibussowitsch static void TPSEvaluate_SchwarzP(const PetscReal y[3], PetscReal *f, PetscReal grad[], PetscReal (*hess)[3])
2801d71ae5a4SJacob Faibussowitsch {
2802b7f5c055SJed Brown   PetscReal c[3] = {PetscCosReal(y[0] * PETSC_PI), PetscCosReal(y[1] * PETSC_PI), PetscCosReal(y[2] * PETSC_PI)};
2803b7f5c055SJed Brown   PetscReal g[3] = {-PetscSinReal(y[0] * PETSC_PI), -PetscSinReal(y[1] * PETSC_PI), -PetscSinReal(y[2] * PETSC_PI)};
2804b7f5c055SJed Brown   f[0]           = c[0] + c[1] + c[2];
2805b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) {
2806b7f5c055SJed Brown     grad[i] = PETSC_PI * g[i];
2807ad540459SPierre Jolivet     for (PetscInt j = 0; j < 3; j++) hess[i][j] = (i == j) ? -PetscSqr(PETSC_PI) * c[i] : 0.;
2808b7f5c055SJed Brown   }
2809b7f5c055SJed Brown }
2810b7f5c055SJed Brown 
28114663dae6SJed Brown // u[] is a tentative normal on input. Replace with the implicit function gradient in the same direction
2812d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSExtrudeNormalFunc_SchwarzP(PetscInt dim, PetscReal time, const PetscReal x[], PetscInt r, PetscScalar u[], void *ctx)
2813d71ae5a4SJacob Faibussowitsch {
2814ad540459SPierre Jolivet   for (PetscInt i = 0; i < 3; i++) u[i] = -PETSC_PI * PetscSinReal(x[i] * PETSC_PI);
28153ba16761SJacob Faibussowitsch   return PETSC_SUCCESS;
28164663dae6SJed Brown }
28174663dae6SJed Brown 
2818b7f5c055SJed Brown /*
2819b7f5c055SJed Brown  The Gyroid implicit surface is
2820b7f5c055SJed Brown 
2821b7f5c055SJed 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)
2822b7f5c055SJed Brown 
2823b7f5c055SJed Brown */
2824d71ae5a4SJacob Faibussowitsch static void TPSEvaluate_Gyroid(const PetscReal y[3], PetscReal *f, PetscReal grad[], PetscReal (*hess)[3])
2825d71ae5a4SJacob Faibussowitsch {
2826b7f5c055SJed Brown   PetscReal s[3] = {PetscSinReal(PETSC_PI * y[0]), PetscSinReal(PETSC_PI * (y[1] + .5)), PetscSinReal(PETSC_PI * (y[2] + .25))};
2827b7f5c055SJed Brown   PetscReal c[3] = {PetscCosReal(PETSC_PI * y[0]), PetscCosReal(PETSC_PI * (y[1] + .5)), PetscCosReal(PETSC_PI * (y[2] + .25))};
2828b7f5c055SJed Brown   f[0]           = s[0] * c[1] + s[1] * c[2] + s[2] * c[0];
2829b7f5c055SJed Brown   grad[0]        = PETSC_PI * (c[0] * c[1] - s[2] * s[0]);
2830b7f5c055SJed Brown   grad[1]        = PETSC_PI * (c[1] * c[2] - s[0] * s[1]);
2831b7f5c055SJed Brown   grad[2]        = PETSC_PI * (c[2] * c[0] - s[1] * s[2]);
2832b7f5c055SJed Brown   hess[0][0]     = -PetscSqr(PETSC_PI) * (s[0] * c[1] + s[2] * c[0]);
2833b7f5c055SJed Brown   hess[0][1]     = -PetscSqr(PETSC_PI) * (c[0] * s[1]);
2834b7f5c055SJed Brown   hess[0][2]     = -PetscSqr(PETSC_PI) * (c[2] * s[0]);
2835b7f5c055SJed Brown   hess[1][0]     = -PetscSqr(PETSC_PI) * (s[1] * c[2] + s[0] * c[1]);
2836b7f5c055SJed Brown   hess[1][1]     = -PetscSqr(PETSC_PI) * (c[1] * s[2]);
2837b7f5c055SJed Brown   hess[2][2]     = -PetscSqr(PETSC_PI) * (c[0] * s[1]);
2838b7f5c055SJed Brown   hess[2][0]     = -PetscSqr(PETSC_PI) * (s[2] * c[0] + s[1] * c[2]);
2839b7f5c055SJed Brown   hess[2][1]     = -PetscSqr(PETSC_PI) * (c[2] * s[0]);
2840b7f5c055SJed Brown   hess[2][2]     = -PetscSqr(PETSC_PI) * (c[1] * s[2]);
2841b7f5c055SJed Brown }
2842b7f5c055SJed Brown 
28434663dae6SJed Brown // u[] is a tentative normal on input. Replace with the implicit function gradient in the same direction
2844d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSExtrudeNormalFunc_Gyroid(PetscInt dim, PetscReal time, const PetscReal x[], PetscInt r, PetscScalar u[], void *ctx)
2845d71ae5a4SJacob Faibussowitsch {
28464663dae6SJed Brown   PetscReal s[3] = {PetscSinReal(PETSC_PI * x[0]), PetscSinReal(PETSC_PI * (x[1] + .5)), PetscSinReal(PETSC_PI * (x[2] + .25))};
28474663dae6SJed Brown   PetscReal c[3] = {PetscCosReal(PETSC_PI * x[0]), PetscCosReal(PETSC_PI * (x[1] + .5)), PetscCosReal(PETSC_PI * (x[2] + .25))};
28484663dae6SJed Brown   u[0]           = PETSC_PI * (c[0] * c[1] - s[2] * s[0]);
28494663dae6SJed Brown   u[1]           = PETSC_PI * (c[1] * c[2] - s[0] * s[1]);
28504663dae6SJed Brown   u[2]           = PETSC_PI * (c[2] * c[0] - s[1] * s[2]);
28513ba16761SJacob Faibussowitsch   return PETSC_SUCCESS;
28524663dae6SJed Brown }
28534663dae6SJed Brown 
2854b7f5c055SJed Brown /*
2855b7f5c055SJed Brown    We wish to solve
2856b7f5c055SJed Brown 
2857b7f5c055SJed Brown          min_y || y - x ||^2  subject to f(y) = 0
2858b7f5c055SJed Brown 
2859b7f5c055SJed Brown    Let g(y) = grad(f).  The minimization problem is equivalent to asking to satisfy
2860b7f5c055SJed 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
2861b7f5c055SJed Brown    tangent space and ask for both components in the tangent space to be zero.
2862b7f5c055SJed Brown 
2863b7f5c055SJed Brown    Take g to be a column vector and compute the "full QR" factorization Q R = g,
2864b7f5c055SJed Brown    where Q = I - 2 n n^T is a symmetric orthogonal matrix.
2865b7f5c055SJed Brown    The first column of Q is parallel to g so the remaining two columns span the null space.
2866b7f5c055SJed Brown    Let Qn = Q[:,1:] be those remaining columns.  Then Qn Qn^T is an orthogonal projector into the tangent space.
2867da81f932SPierre Jolivet    Since Q is symmetric, this is equivalent to multiplying by Q and taking the last two entries.
2868b7f5c055SJed Brown    In total, we have a system of 3 equations in 3 unknowns:
2869b7f5c055SJed Brown 
2870b7f5c055SJed Brown      f(y) = 0                       1 equation
2871b7f5c055SJed Brown      Qn^T (y - x) = 0               2 equations
2872b7f5c055SJed Brown 
2873b7f5c055SJed Brown    Here, we compute the residual and Jacobian of this system.
2874b7f5c055SJed Brown */
2875d71ae5a4SJacob Faibussowitsch static void TPSNearestPointResJac(TPSEvaluateFunc feval, const PetscScalar x[], const PetscScalar y[], PetscScalar res[], PetscScalar J[])
2876d71ae5a4SJacob Faibussowitsch {
2877b7f5c055SJed Brown   PetscReal yreal[3] = {PetscRealPart(y[0]), PetscRealPart(y[1]), PetscRealPart(y[2])};
2878b7f5c055SJed Brown   PetscReal d[3]     = {PetscRealPart(y[0] - x[0]), PetscRealPart(y[1] - x[1]), PetscRealPart(y[2] - x[2])};
28792f0490c0SSatish Balay   PetscReal f, grad[3], n[3], norm, norm_y[3], nd, nd_y[3], sign;
28809371c9d4SSatish Balay   PetscReal n_y[3][3] = {
28819371c9d4SSatish Balay     {0, 0, 0},
28829371c9d4SSatish Balay     {0, 0, 0},
28839371c9d4SSatish Balay     {0, 0, 0}
28849371c9d4SSatish Balay   };
2885b7f5c055SJed Brown 
2886b7f5c055SJed Brown   feval(yreal, &f, grad, n_y);
2887b7f5c055SJed Brown 
2888b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) n[i] = grad[i];
2889b7f5c055SJed Brown   norm = PetscSqrtReal(PetscSqr(n[0]) + PetscSqr(n[1]) + PetscSqr(n[2]));
2890ad540459SPierre Jolivet   for (PetscInt i = 0; i < 3; i++) norm_y[i] = 1. / norm * n[i] * n_y[i][i];
2891b7f5c055SJed Brown 
2892b7f5c055SJed Brown   // Define the Householder reflector
2893b7f5c055SJed Brown   sign = n[0] >= 0 ? 1. : -1.;
2894b7f5c055SJed Brown   n[0] += norm * sign;
2895b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) n_y[0][i] += norm_y[i] * sign;
2896b7f5c055SJed Brown 
2897b7f5c055SJed Brown   norm      = PetscSqrtReal(PetscSqr(n[0]) + PetscSqr(n[1]) + PetscSqr(n[2]));
2898b7f5c055SJed Brown   norm_y[0] = 1. / norm * (n[0] * n_y[0][0]);
2899b7f5c055SJed Brown   norm_y[1] = 1. / norm * (n[0] * n_y[0][1] + n[1] * n_y[1][1]);
2900b7f5c055SJed Brown   norm_y[2] = 1. / norm * (n[0] * n_y[0][2] + n[2] * n_y[2][2]);
2901b7f5c055SJed Brown 
2902b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) {
2903b7f5c055SJed Brown     n[i] /= norm;
2904b7f5c055SJed Brown     for (PetscInt j = 0; j < 3; j++) {
2905b7f5c055SJed Brown       // note that n[i] is n_old[i]/norm when executing the code below
2906b7f5c055SJed Brown       n_y[i][j] = n_y[i][j] / norm - n[i] / norm * norm_y[j];
2907b7f5c055SJed Brown     }
2908b7f5c055SJed Brown   }
2909b7f5c055SJed Brown 
2910b7f5c055SJed Brown   nd = n[0] * d[0] + n[1] * d[1] + n[2] * d[2];
2911b7f5c055SJed 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];
2912b7f5c055SJed Brown 
2913b7f5c055SJed Brown   res[0] = f;
2914b7f5c055SJed Brown   res[1] = d[1] - 2 * n[1] * nd;
2915b7f5c055SJed Brown   res[2] = d[2] - 2 * n[2] * nd;
2916b7f5c055SJed Brown   // J[j][i] is J_{ij} (column major)
2917b7f5c055SJed Brown   for (PetscInt j = 0; j < 3; j++) {
2918b7f5c055SJed Brown     J[0 + j * 3] = grad[j];
2919b7f5c055SJed Brown     J[1 + j * 3] = (j == 1) * 1. - 2 * (n_y[1][j] * nd + n[1] * nd_y[j]);
2920b7f5c055SJed Brown     J[2 + j * 3] = (j == 2) * 1. - 2 * (n_y[2][j] * nd + n[2] * nd_y[j]);
2921b7f5c055SJed Brown   }
2922b7f5c055SJed Brown }
2923b7f5c055SJed Brown 
2924b7f5c055SJed Brown /*
2925b7f5c055SJed Brown    Project x to the nearest point on the implicit surface using Newton's method.
2926b7f5c055SJed Brown */
2927d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSNearestPoint(TPSEvaluateFunc feval, PetscScalar x[])
2928d71ae5a4SJacob Faibussowitsch {
2929b7f5c055SJed Brown   PetscScalar y[3] = {x[0], x[1], x[2]}; // Initial guess
2930b7f5c055SJed Brown 
2931b7f5c055SJed Brown   PetscFunctionBegin;
2932b7f5c055SJed Brown   for (PetscInt iter = 0; iter < 10; iter++) {
2933b7f5c055SJed Brown     PetscScalar res[3], J[9];
2934b7f5c055SJed Brown     PetscReal   resnorm;
2935b7f5c055SJed Brown     TPSNearestPointResJac(feval, x, y, res, J);
2936b7f5c055SJed Brown     resnorm = PetscSqrtReal(PetscSqr(PetscRealPart(res[0])) + PetscSqr(PetscRealPart(res[1])) + PetscSqr(PetscRealPart(res[2])));
2937b7f5c055SJed Brown     if (0) { // Turn on this monitor if you need to confirm quadratic convergence
293863a3b9bcSJacob 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])));
2939b7f5c055SJed Brown     }
2940b7f5c055SJed Brown     if (resnorm < PETSC_SMALL) break;
2941b7f5c055SJed Brown 
2942b7f5c055SJed Brown     // Take the Newton step
29439566063dSJacob Faibussowitsch     PetscCall(PetscKernel_A_gets_inverse_A_3(J, 0., PETSC_FALSE, NULL));
2944b7f5c055SJed Brown     PetscKernel_v_gets_v_minus_A_times_w_3(y, J, res);
2945b7f5c055SJed Brown   }
2946b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) x[i] = y[i];
29473ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2948b7f5c055SJed Brown }
2949b7f5c055SJed Brown 
2950b7f5c055SJed Brown const char *const DMPlexTPSTypes[] = {"SCHWARZ_P", "GYROID", "DMPlexTPSType", "DMPLEX_TPS_", NULL};
2951b7f5c055SJed Brown 
2952d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateTPSMesh_Internal(DM dm, DMPlexTPSType tpstype, const PetscInt extent[], const DMBoundaryType periodic[], PetscBool tps_distribute, PetscInt refinements, PetscInt layers, PetscReal thickness)
2953d71ae5a4SJacob Faibussowitsch {
2954b7f5c055SJed Brown   PetscMPIInt rank;
2955b7f5c055SJed Brown   PetscInt    topoDim = 2, spaceDim = 3, numFaces = 0, numVertices = 0, numEdges = 0;
2956b7f5c055SJed Brown   PetscInt(*edges)[2] = NULL, *edgeSets = NULL;
2957b7f5c055SJed Brown   PetscInt            *cells_flat = NULL;
2958b7f5c055SJed Brown   PetscReal           *vtxCoords  = NULL;
2959b7f5c055SJed Brown   TPSEvaluateFunc      evalFunc   = NULL;
29604663dae6SJed Brown   PetscSimplePointFunc normalFunc = NULL;
2961b7f5c055SJed Brown   DMLabel              label;
2962b7f5c055SJed Brown 
2963b7f5c055SJed Brown   PetscFunctionBegin;
296446139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
29659566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
296663a3b9bcSJacob 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);
2967b7f5c055SJed Brown   switch (tpstype) {
2968b7f5c055SJed Brown   case DMPLEX_TPS_SCHWARZ_P:
2969b7f5c055SJed 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");
2970c5853193SPierre Jolivet     if (rank == 0) {
2971b7f5c055SJed Brown       PetscInt(*cells)[6][4][4] = NULL; // [junction, junction-face, cell, conn]
2972b7f5c055SJed Brown       PetscInt  Njunctions = 0, Ncuts = 0, Npipes[3], vcount;
2973b7f5c055SJed Brown       PetscReal L = 1;
2974b7f5c055SJed Brown 
2975b7f5c055SJed Brown       Npipes[0]   = (extent[0] + 1) * extent[1] * extent[2];
2976b7f5c055SJed Brown       Npipes[1]   = extent[0] * (extent[1] + 1) * extent[2];
2977b7f5c055SJed Brown       Npipes[2]   = extent[0] * extent[1] * (extent[2] + 1);
2978b7f5c055SJed Brown       Njunctions  = extent[0] * extent[1] * extent[2];
2979b7f5c055SJed Brown       Ncuts       = 2 * (extent[0] * extent[1] + extent[1] * extent[2] + extent[2] * extent[0]);
2980b7f5c055SJed Brown       numVertices = 4 * (Npipes[0] + Npipes[1] + Npipes[2]) + 8 * Njunctions;
29819566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(3 * numVertices, &vtxCoords));
29829566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Njunctions, &cells));
29839566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Ncuts * 4, &edges));
29849566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Ncuts * 4, &edgeSets));
2985b7f5c055SJed Brown       // x-normal pipes
2986b7f5c055SJed Brown       vcount = 0;
2987b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0] + 1; i++) {
2988b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
2989b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
2990b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
2991b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * i - 1) * L;
2992b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * j * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
2993b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * k * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
2994b7f5c055SJed Brown             }
2995b7f5c055SJed Brown           }
2996b7f5c055SJed Brown         }
2997b7f5c055SJed Brown       }
2998b7f5c055SJed Brown       // y-normal pipes
2999b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3000b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1] + 1; j++) {
3001b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3002b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3003b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * i * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3004b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * j - 1) * L;
3005b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * k * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3006b7f5c055SJed Brown             }
3007b7f5c055SJed Brown           }
3008b7f5c055SJed Brown         }
3009b7f5c055SJed Brown       }
3010b7f5c055SJed Brown       // z-normal pipes
3011b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3012b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3013b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2] + 1; k++) {
3014b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3015b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * i * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3016b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * j * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3017b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * k - 1) * L;
3018b7f5c055SJed Brown             }
3019b7f5c055SJed Brown           }
3020b7f5c055SJed Brown         }
3021b7f5c055SJed Brown       }
3022b7f5c055SJed Brown       // junctions
3023b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3024b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3025b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3026b7f5c055SJed Brown             const PetscInt J = (i * extent[1] + j) * extent[2] + k, Jvoff = (Npipes[0] + Npipes[1] + Npipes[2]) * 4 + J * 8;
3027b7f5c055SJed Brown             PetscCheck(vcount / 3 == Jvoff, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Unexpected vertex count");
3028b7f5c055SJed Brown             for (PetscInt ii = 0; ii < 2; ii++) {
3029b7f5c055SJed Brown               for (PetscInt jj = 0; jj < 2; jj++) {
3030b7f5c055SJed Brown                 for (PetscInt kk = 0; kk < 2; kk++) {
3031b7f5c055SJed Brown                   double Ls           = (1 - sqrt(2) / 4) * L;
3032b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * i * L + (2 * ii - 1) * Ls;
3033b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * j * L + (2 * jj - 1) * Ls;
3034b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * k * L + (2 * kk - 1) * Ls;
3035b7f5c055SJed Brown                 }
3036b7f5c055SJed Brown               }
3037b7f5c055SJed Brown             }
3038b7f5c055SJed Brown             const PetscInt jfaces[3][2][4] = {
3039b7f5c055SJed Brown               {{3, 1, 0, 2}, {7, 5, 4, 6}}, // x-aligned
3040b7f5c055SJed Brown               {{5, 4, 0, 1}, {7, 6, 2, 3}}, // y-aligned
3041b7f5c055SJed Brown               {{6, 2, 0, 4}, {7, 3, 1, 5}}  // z-aligned
3042b7f5c055SJed Brown             };
3043b7f5c055SJed Brown             const PetscInt pipe_lo[3] = {// vertex numbers of pipes
30449371c9d4SSatish 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};
3045b7f5c055SJed Brown             const PetscInt pipe_hi[3] = {// vertex numbers of pipes
30469371c9d4SSatish 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};
3047b7f5c055SJed Brown             for (PetscInt dir = 0; dir < 3; dir++) { // x,y,z
3048b7f5c055SJed Brown               const PetscInt ijk[3] = {i, j, k};
3049b7f5c055SJed Brown               for (PetscInt l = 0; l < 4; l++) { // rotations
3050b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][0] = pipe_lo[dir] + l;
3051b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][1] = Jvoff + jfaces[dir][0][l];
3052b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][2] = Jvoff + jfaces[dir][0][(l - 1 + 4) % 4];
3053b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][3] = pipe_lo[dir] + (l - 1 + 4) % 4;
3054b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][0] = Jvoff + jfaces[dir][1][l];
3055b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][1] = pipe_hi[dir] + l;
3056b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][2] = pipe_hi[dir] + (l - 1 + 4) % 4;
3057b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][3] = Jvoff + jfaces[dir][1][(l - 1 + 4) % 4];
3058b7f5c055SJed Brown                 if (ijk[dir] == 0) {
3059b7f5c055SJed Brown                   edges[numEdges][0] = pipe_lo[dir] + l;
3060b7f5c055SJed Brown                   edges[numEdges][1] = pipe_lo[dir] + (l + 1) % 4;
3061b7f5c055SJed Brown                   edgeSets[numEdges] = dir * 2 + 1;
3062b7f5c055SJed Brown                   numEdges++;
3063b7f5c055SJed Brown                 }
3064b7f5c055SJed Brown                 if (ijk[dir] + 1 == extent[dir]) {
3065b7f5c055SJed Brown                   edges[numEdges][0] = pipe_hi[dir] + l;
3066b7f5c055SJed Brown                   edges[numEdges][1] = pipe_hi[dir] + (l + 1) % 4;
3067b7f5c055SJed Brown                   edgeSets[numEdges] = dir * 2 + 2;
3068b7f5c055SJed Brown                   numEdges++;
3069b7f5c055SJed Brown                 }
3070b7f5c055SJed Brown               }
3071b7f5c055SJed Brown             }
3072b7f5c055SJed Brown           }
3073b7f5c055SJed Brown         }
3074b7f5c055SJed Brown       }
307563a3b9bcSJacob Faibussowitsch       PetscCheck(numEdges == Ncuts * 4, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Edge count %" PetscInt_FMT " incompatible with number of cuts %" PetscInt_FMT, numEdges, Ncuts);
3076b7f5c055SJed Brown       numFaces   = 24 * Njunctions;
3077b7f5c055SJed Brown       cells_flat = cells[0][0][0];
3078b7f5c055SJed Brown     }
3079b7f5c055SJed Brown     evalFunc   = TPSEvaluate_SchwarzP;
30804663dae6SJed Brown     normalFunc = TPSExtrudeNormalFunc_SchwarzP;
3081b7f5c055SJed Brown     break;
3082b7f5c055SJed Brown   case DMPLEX_TPS_GYROID:
3083c5853193SPierre Jolivet     if (rank == 0) {
3084b7f5c055SJed Brown       // This is a coarse mesh approximation of the gyroid shifted to being the zero of the level set
3085b7f5c055SJed Brown       //
3086b7f5c055SJed 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)
3087b7f5c055SJed Brown       //
3088b7f5c055SJed Brown       // on the cell [0,2]^3.
3089b7f5c055SJed Brown       //
3090b7f5c055SJed Brown       // Think about dividing that cell into four columns, and focus on the column [0,1]x[0,1]x[0,2].
3091b7f5c055SJed Brown       // If you looked at the gyroid in that column at different slices of z you would see that it kind of spins
3092b7f5c055SJed Brown       // like a boomerang:
3093b7f5c055SJed Brown       //
3094b7f5c055SJed Brown       //     z = 0          z = 1/4        z = 1/2        z = 3/4     //
3095b7f5c055SJed Brown       //     -----          -------        -------        -------     //
3096b7f5c055SJed Brown       //                                                              //
3097b7f5c055SJed Brown       //     +       +      +       +      +       +      +   \   +   //
3098b7f5c055SJed Brown       //      \                                   /            \      //
3099b7f5c055SJed Brown       //       \            `-_   _-'            /              }     //
3100b7f5c055SJed Brown       //        *-_            `-'            _-'              /      //
3101b7f5c055SJed Brown       //     +     `-+      +       +      +-'     +      +   /   +   //
3102b7f5c055SJed Brown       //                                                              //
3103b7f5c055SJed Brown       //                                                              //
3104b7f5c055SJed Brown       //     z = 1          z = 5/4        z = 3/2        z = 7/4     //
3105b7f5c055SJed Brown       //     -----          -------        -------        -------     //
3106b7f5c055SJed Brown       //                                                              //
3107b7f5c055SJed Brown       //     +-_     +      +       +      +     _-+      +   /   +   //
3108b7f5c055SJed Brown       //        `-_            _-_            _-`            /        //
3109b7f5c055SJed Brown       //           \        _-'   `-_        /              {         //
3110b7f5c055SJed Brown       //            \                       /                \        //
3111b7f5c055SJed Brown       //     +       +      +       +      +       +      +   \   +   //
3112b7f5c055SJed Brown       //
3113b7f5c055SJed Brown       //
3114b7f5c055SJed Brown       // This course mesh approximates each of these slices by two line segments,
3115b7f5c055SJed Brown       // and then connects the segments in consecutive layers with quadrilateral faces.
3116b7f5c055SJed Brown       // All of the end points of the segments are multiples of 1/4 except for the
3117b7f5c055SJed Brown       // point * in the picture for z = 0 above and the similar points in other layers.
3118b7f5c055SJed Brown       // That point is at (gamma, gamma, 0), where gamma is calculated below.
3119b7f5c055SJed Brown       //
3120b7f5c055SJed Brown       // The column  [1,2]x[1,2]x[0,2] looks the same as this column;
3121b7f5c055SJed Brown       // The columns [1,2]x[0,1]x[0,2] and [0,1]x[1,2]x[0,2] are mirror images.
3122b7f5c055SJed Brown       //
3123b7f5c055SJed Brown       // As for how this method turned into the names given to the vertices:
3124b7f5c055SJed Brown       // that was not systematic, it was just the way it worked out in my handwritten notes.
3125b7f5c055SJed Brown 
3126b7f5c055SJed Brown       PetscInt facesPerBlock = 64;
3127b7f5c055SJed Brown       PetscInt vertsPerBlock = 56;
3128b7f5c055SJed Brown       PetscInt extentPlus[3];
3129b7f5c055SJed Brown       PetscInt numBlocks, numBlocksPlus;
31309371c9d4SSatish 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;
31319371c9d4SSatish Balay       const PetscInt pattern[64][4] = {
31329371c9d4SSatish Balay   /* face to vertex within the coarse discretization of a single gyroid block */
3133b7f5c055SJed Brown   /* layer 0 */
31349371c9d4SSatish Balay         {A,           C,           K,           G          },
31359371c9d4SSatish Balay         {C,           B,           II,          K          },
31369371c9d4SSatish Balay         {D,           A,           H,           L          },
31379371c9d4SSatish Balay         {B + 56 * 1,  D,           L,           J          },
31389371c9d4SSatish Balay         {E,           B + 56 * 1,  J,           N          },
31399371c9d4SSatish Balay         {A + 56 * 2,  E,           N,           H + 56 * 2 },
31409371c9d4SSatish Balay         {F,           A + 56 * 2,  G + 56 * 2,  M          },
31419371c9d4SSatish Balay         {B,           F,           M,           II         },
3142b7f5c055SJed Brown  /* layer 1 */
31439371c9d4SSatish Balay         {G,           K,           Q,           O          },
31449371c9d4SSatish Balay         {K,           II,          P,           Q          },
31459371c9d4SSatish Balay         {L,           H,           O + 56 * 1,  R          },
31469371c9d4SSatish Balay         {J,           L,           R,           P          },
31479371c9d4SSatish Balay         {N,           J,           P,           S          },
31489371c9d4SSatish Balay         {H + 56 * 2,  N,           S,           O + 56 * 3 },
31499371c9d4SSatish Balay         {M,           G + 56 * 2,  O + 56 * 2,  T          },
31509371c9d4SSatish Balay         {II,          M,           T,           P          },
3151b7f5c055SJed Brown  /* layer 2 */
31529371c9d4SSatish Balay         {O,           Q,           Y,           U          },
31539371c9d4SSatish Balay         {Q,           P,           W,           Y          },
31549371c9d4SSatish Balay         {R,           O + 56 * 1,  U + 56 * 1,  Ap         },
31559371c9d4SSatish Balay         {P,           R,           Ap,          W          },
31569371c9d4SSatish Balay         {S,           P,           X,           Bp         },
31579371c9d4SSatish Balay         {O + 56 * 3,  S,           Bp,          V + 56 * 1 },
31589371c9d4SSatish Balay         {T,           O + 56 * 2,  V,           Z          },
31599371c9d4SSatish Balay         {P,           T,           Z,           X          },
3160b7f5c055SJed Brown  /* layer 3 */
31619371c9d4SSatish Balay         {U,           Y,           Ep,          Dp         },
31629371c9d4SSatish Balay         {Y,           W,           Cp,          Ep         },
31639371c9d4SSatish Balay         {Ap,          U + 56 * 1,  Dp + 56 * 1, Gp         },
31649371c9d4SSatish Balay         {W,           Ap,          Gp,          Cp         },
31659371c9d4SSatish Balay         {Bp,          X,           Cp + 56 * 2, Fp         },
31669371c9d4SSatish Balay         {V + 56 * 1,  Bp,          Fp,          Dp + 56 * 1},
31679371c9d4SSatish Balay         {Z,           V,           Dp,          Hp         },
31689371c9d4SSatish Balay         {X,           Z,           Hp,          Cp + 56 * 2},
3169b7f5c055SJed Brown  /* layer 4 */
31709371c9d4SSatish Balay         {Dp,          Ep,          Mp,          Kp         },
31719371c9d4SSatish Balay         {Ep,          Cp,          Ip,          Mp         },
31729371c9d4SSatish Balay         {Gp,          Dp + 56 * 1, Lp,          Np         },
31739371c9d4SSatish Balay         {Cp,          Gp,          Np,          Jp         },
31749371c9d4SSatish Balay         {Fp,          Cp + 56 * 2, Jp + 56 * 2, Pp         },
31759371c9d4SSatish Balay         {Dp + 56 * 1, Fp,          Pp,          Lp         },
31769371c9d4SSatish Balay         {Hp,          Dp,          Kp,          Op         },
31779371c9d4SSatish Balay         {Cp + 56 * 2, Hp,          Op,          Ip + 56 * 2},
3178b7f5c055SJed Brown  /* layer 5 */
31799371c9d4SSatish Balay         {Kp,          Mp,          Sp,          Rp         },
31809371c9d4SSatish Balay         {Mp,          Ip,          Qp,          Sp         },
31819371c9d4SSatish Balay         {Np,          Lp,          Rp,          Tp         },
31829371c9d4SSatish Balay         {Jp,          Np,          Tp,          Qp + 56 * 1},
31839371c9d4SSatish Balay         {Pp,          Jp + 56 * 2, Qp + 56 * 3, Up         },
31849371c9d4SSatish Balay         {Lp,          Pp,          Up,          Rp         },
31859371c9d4SSatish Balay         {Op,          Kp,          Rp,          Vp         },
31869371c9d4SSatish Balay         {Ip + 56 * 2, Op,          Vp,          Qp + 56 * 2},
3187b7f5c055SJed Brown  /* layer 6 */
31889371c9d4SSatish Balay         {Rp,          Sp,          Aq,          Yp         },
31899371c9d4SSatish Balay         {Sp,          Qp,          Wp,          Aq         },
31909371c9d4SSatish Balay         {Tp,          Rp,          Yp,          Cq         },
31919371c9d4SSatish Balay         {Qp + 56 * 1, Tp,          Cq,          Wp + 56 * 1},
31929371c9d4SSatish Balay         {Up,          Qp + 56 * 3, Xp + 56 * 1, Dq         },
31939371c9d4SSatish Balay         {Rp,          Up,          Dq,          Zp         },
31949371c9d4SSatish Balay         {Vp,          Rp,          Zp,          Bq         },
31959371c9d4SSatish Balay         {Qp + 56 * 2, Vp,          Bq,          Xp         },
3196b7f5c055SJed Brown  /* layer 7 (the top is the periodic image of the bottom of layer 0) */
31979371c9d4SSatish Balay         {Yp,          Aq,          C + 56 * 4,  A + 56 * 4 },
31989371c9d4SSatish Balay         {Aq,          Wp,          B + 56 * 4,  C + 56 * 4 },
31999371c9d4SSatish Balay         {Cq,          Yp,          A + 56 * 4,  D + 56 * 4 },
32009371c9d4SSatish Balay         {Wp + 56 * 1, Cq,          D + 56 * 4,  B + 56 * 5 },
32019371c9d4SSatish Balay         {Dq,          Xp + 56 * 1, B + 56 * 5,  E + 56 * 4 },
32029371c9d4SSatish Balay         {Zp,          Dq,          E + 56 * 4,  A + 56 * 6 },
32039371c9d4SSatish Balay         {Bq,          Zp,          A + 56 * 6,  F + 56 * 4 },
32049371c9d4SSatish Balay         {Xp,          Bq,          F + 56 * 4,  B + 56 * 4 }
3205b7f5c055SJed Brown       };
3206b7f5c055SJed Brown       const PetscReal gamma                = PetscAcosReal((PetscSqrtReal(3.) - 1.) / PetscSqrtReal(2.)) / PETSC_PI;
32079371c9d4SSatish Balay       const PetscReal patternCoords[56][3] = {
3208bee3fc89SBarry Smith         {1.,        0.,        0.  }, /* A  */
3209bee3fc89SBarry Smith         {0.,        1.,        0.  }, /* B  */
3210bee3fc89SBarry Smith         {gamma,     gamma,     0.  }, /* C  */
3211bee3fc89SBarry Smith         {1 + gamma, 1 - gamma, 0.  }, /* D  */
3212bee3fc89SBarry Smith         {2 - gamma, 2 - gamma, 0.  }, /* E  */
3213bee3fc89SBarry Smith         {1 - gamma, 1 + gamma, 0.  }, /* F  */
3214b7f5c055SJed Brown 
3215bee3fc89SBarry Smith         {.5,        0,         .25 }, /* G  */
3216bee3fc89SBarry Smith         {1.5,       0.,        .25 }, /* H  */
3217bee3fc89SBarry Smith         {.5,        1.,        .25 }, /* II */
3218bee3fc89SBarry Smith         {1.5,       1.,        .25 }, /* J  */
3219bee3fc89SBarry Smith         {.25,       .5,        .25 }, /* K  */
3220bee3fc89SBarry Smith         {1.25,      .5,        .25 }, /* L  */
3221bee3fc89SBarry Smith         {.75,       1.5,       .25 }, /* M  */
3222bee3fc89SBarry Smith         {1.75,      1.5,       .25 }, /* N  */
3223b7f5c055SJed Brown 
3224bee3fc89SBarry Smith         {0.,        0.,        .5  }, /* O  */
3225bee3fc89SBarry Smith         {1.,        1.,        .5  }, /* P  */
3226bee3fc89SBarry Smith         {gamma,     1 - gamma, .5  }, /* Q  */
3227bee3fc89SBarry Smith         {1 + gamma, gamma,     .5  }, /* R  */
3228bee3fc89SBarry Smith         {2 - gamma, 1 + gamma, .5  }, /* S  */
3229bee3fc89SBarry Smith         {1 - gamma, 2 - gamma, .5  }, /* T  */
3230b7f5c055SJed Brown 
3231bee3fc89SBarry Smith         {0.,        .5,        .75 }, /* U  */
3232bee3fc89SBarry Smith         {0.,        1.5,       .75 }, /* V  */
3233bee3fc89SBarry Smith         {1.,        .5,        .75 }, /* W  */
3234bee3fc89SBarry Smith         {1.,        1.5,       .75 }, /* X  */
3235bee3fc89SBarry Smith         {.5,        .75,       .75 }, /* Y  */
3236bee3fc89SBarry Smith         {.5,        1.75,      .75 }, /* Z  */
3237bee3fc89SBarry Smith         {1.5,       .25,       .75 }, /* Ap */
3238bee3fc89SBarry Smith         {1.5,       1.25,      .75 }, /* Bp */
3239b7f5c055SJed Brown 
3240bee3fc89SBarry Smith         {1.,        0.,        1.  }, /* Cp */
3241bee3fc89SBarry Smith         {0.,        1.,        1.  }, /* Dp */
3242bee3fc89SBarry Smith         {1 - gamma, 1 - gamma, 1.  }, /* Ep */
3243bee3fc89SBarry Smith         {1 + gamma, 1 + gamma, 1.  }, /* Fp */
3244bee3fc89SBarry Smith         {2 - gamma, gamma,     1.  }, /* Gp */
3245bee3fc89SBarry Smith         {gamma,     2 - gamma, 1.  }, /* Hp */
3246b7f5c055SJed Brown 
3247bee3fc89SBarry Smith         {.5,        0.,        1.25}, /* Ip */
3248bee3fc89SBarry Smith         {1.5,       0.,        1.25}, /* Jp */
3249bee3fc89SBarry Smith         {.5,        1.,        1.25}, /* Kp */
3250bee3fc89SBarry Smith         {1.5,       1.,        1.25}, /* Lp */
3251bee3fc89SBarry Smith         {.75,       .5,        1.25}, /* Mp */
3252bee3fc89SBarry Smith         {1.75,      .5,        1.25}, /* Np */
3253bee3fc89SBarry Smith         {.25,       1.5,       1.25}, /* Op */
3254bee3fc89SBarry Smith         {1.25,      1.5,       1.25}, /* Pp */
3255b7f5c055SJed Brown 
3256bee3fc89SBarry Smith         {0.,        0.,        1.5 }, /* Qp */
3257bee3fc89SBarry Smith         {1.,        1.,        1.5 }, /* Rp */
3258bee3fc89SBarry Smith         {1 - gamma, gamma,     1.5 }, /* Sp */
3259bee3fc89SBarry Smith         {2 - gamma, 1 - gamma, 1.5 }, /* Tp */
3260bee3fc89SBarry Smith         {1 + gamma, 2 - gamma, 1.5 }, /* Up */
3261bee3fc89SBarry Smith         {gamma,     1 + gamma, 1.5 }, /* Vp */
3262b7f5c055SJed Brown 
3263bee3fc89SBarry Smith         {0.,        .5,        1.75}, /* Wp */
3264bee3fc89SBarry Smith         {0.,        1.5,       1.75}, /* Xp */
3265bee3fc89SBarry Smith         {1.,        .5,        1.75}, /* Yp */
3266bee3fc89SBarry Smith         {1.,        1.5,       1.75}, /* Zp */
3267bee3fc89SBarry Smith         {.5,        .25,       1.75}, /* Aq */
3268bee3fc89SBarry Smith         {.5,        1.25,      1.75}, /* Bq */
3269bee3fc89SBarry Smith         {1.5,       .75,       1.75}, /* Cq */
3270bee3fc89SBarry Smith         {1.5,       1.75,      1.75}, /* Dq */
3271b7f5c055SJed Brown       };
3272b7f5c055SJed Brown       PetscInt(*cells)[64][4] = NULL;
3273b7f5c055SJed Brown       PetscBool *seen;
3274b7f5c055SJed Brown       PetscInt  *vertToTrueVert;
3275b7f5c055SJed Brown       PetscInt   count;
3276b7f5c055SJed Brown 
3277b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) extentPlus[i] = extent[i] + 1;
3278b7f5c055SJed Brown       numBlocks = 1;
3279b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) numBlocks *= extent[i];
3280b7f5c055SJed Brown       numBlocksPlus = 1;
3281b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) numBlocksPlus *= extentPlus[i];
3282b7f5c055SJed Brown       numFaces = numBlocks * facesPerBlock;
32839566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numBlocks, &cells));
32849566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numBlocksPlus * vertsPerBlock, &seen));
3285b7f5c055SJed Brown       for (PetscInt k = 0; k < extent[2]; k++) {
3286b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3287b7f5c055SJed Brown           for (PetscInt i = 0; i < extent[0]; i++) {
3288b7f5c055SJed Brown             for (PetscInt f = 0; f < facesPerBlock; f++) {
3289b7f5c055SJed Brown               for (PetscInt v = 0; v < 4; v++) {
3290b7f5c055SJed Brown                 PetscInt vertRaw     = pattern[f][v];
3291b7f5c055SJed Brown                 PetscInt blockidx    = vertRaw / 56;
3292b7f5c055SJed Brown                 PetscInt patternvert = vertRaw % 56;
3293b7f5c055SJed Brown                 PetscInt xplus       = (blockidx & 1);
3294b7f5c055SJed Brown                 PetscInt yplus       = (blockidx & 2) >> 1;
3295b7f5c055SJed Brown                 PetscInt zplus       = (blockidx & 4) >> 2;
3296b7f5c055SJed Brown                 PetscInt zcoord      = (periodic && periodic[2] == DM_BOUNDARY_PERIODIC) ? ((k + zplus) % extent[2]) : (k + zplus);
3297b7f5c055SJed Brown                 PetscInt ycoord      = (periodic && periodic[1] == DM_BOUNDARY_PERIODIC) ? ((j + yplus) % extent[1]) : (j + yplus);
3298b7f5c055SJed Brown                 PetscInt xcoord      = (periodic && periodic[0] == DM_BOUNDARY_PERIODIC) ? ((i + xplus) % extent[0]) : (i + xplus);
3299b7f5c055SJed Brown                 PetscInt vert        = ((zcoord * extentPlus[1] + ycoord) * extentPlus[0] + xcoord) * 56 + patternvert;
3300b7f5c055SJed Brown 
3301b7f5c055SJed Brown                 cells[(k * extent[1] + j) * extent[0] + i][f][v] = vert;
3302b7f5c055SJed Brown                 seen[vert]                                       = PETSC_TRUE;
3303b7f5c055SJed Brown               }
3304b7f5c055SJed Brown             }
3305b7f5c055SJed Brown           }
3306b7f5c055SJed Brown         }
3307b7f5c055SJed Brown       }
33089371c9d4SSatish Balay       for (PetscInt i = 0; i < numBlocksPlus * vertsPerBlock; i++)
33099371c9d4SSatish Balay         if (seen[i]) numVertices++;
3310b7f5c055SJed Brown       count = 0;
33119566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numBlocksPlus * vertsPerBlock, &vertToTrueVert));
33129566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numVertices * 3, &vtxCoords));
3313b7f5c055SJed Brown       for (PetscInt i = 0; i < numBlocksPlus * vertsPerBlock; i++) vertToTrueVert[i] = -1;
3314b7f5c055SJed Brown       for (PetscInt k = 0; k < extentPlus[2]; k++) {
3315b7f5c055SJed Brown         for (PetscInt j = 0; j < extentPlus[1]; j++) {
3316b7f5c055SJed Brown           for (PetscInt i = 0; i < extentPlus[0]; i++) {
3317b7f5c055SJed Brown             for (PetscInt v = 0; v < vertsPerBlock; v++) {
3318b7f5c055SJed Brown               PetscInt vIdx = ((k * extentPlus[1] + j) * extentPlus[0] + i) * vertsPerBlock + v;
3319b7f5c055SJed Brown 
3320b7f5c055SJed Brown               if (seen[vIdx]) {
3321b7f5c055SJed Brown                 PetscInt thisVert;
3322b7f5c055SJed Brown 
3323b7f5c055SJed Brown                 vertToTrueVert[vIdx] = thisVert = count++;
3324b7f5c055SJed Brown 
3325b7f5c055SJed Brown                 for (PetscInt d = 0; d < 3; d++) vtxCoords[3 * thisVert + d] = patternCoords[v][d];
3326b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 0] += i * 2;
3327b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 1] += j * 2;
3328b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 2] += k * 2;
3329b7f5c055SJed Brown               }
3330b7f5c055SJed Brown             }
3331b7f5c055SJed Brown           }
3332b7f5c055SJed Brown         }
3333b7f5c055SJed Brown       }
3334b7f5c055SJed Brown       for (PetscInt i = 0; i < numBlocks; i++) {
3335b7f5c055SJed Brown         for (PetscInt f = 0; f < facesPerBlock; f++) {
3336ad540459SPierre Jolivet           for (PetscInt v = 0; v < 4; v++) cells[i][f][v] = vertToTrueVert[cells[i][f][v]];
3337b7f5c055SJed Brown         }
3338b7f5c055SJed Brown       }
33399566063dSJacob Faibussowitsch       PetscCall(PetscFree(vertToTrueVert));
33409566063dSJacob Faibussowitsch       PetscCall(PetscFree(seen));
3341b7f5c055SJed Brown       cells_flat = cells[0][0];
3342b7f5c055SJed Brown       numEdges   = 0;
3343b7f5c055SJed Brown       for (PetscInt i = 0; i < numFaces; i++) {
3344b7f5c055SJed Brown         for (PetscInt e = 0; e < 4; e++) {
3345b7f5c055SJed Brown           PetscInt         ev[]       = {cells_flat[i * 4 + e], cells_flat[i * 4 + ((e + 1) % 4)]};
3346b7f5c055SJed Brown           const PetscReal *evCoords[] = {&vtxCoords[3 * ev[0]], &vtxCoords[3 * ev[1]]};
3347b7f5c055SJed Brown 
3348b7f5c055SJed Brown           for (PetscInt d = 0; d < 3; d++) {
3349b7f5c055SJed Brown             if (!periodic || periodic[0] != DM_BOUNDARY_PERIODIC) {
3350b7f5c055SJed Brown               if (evCoords[0][d] == 0. && evCoords[1][d] == 0.) numEdges++;
3351b7f5c055SJed Brown               if (evCoords[0][d] == 2. * extent[d] && evCoords[1][d] == 2. * extent[d]) numEdges++;
3352b7f5c055SJed Brown             }
3353b7f5c055SJed Brown           }
3354b7f5c055SJed Brown         }
3355b7f5c055SJed Brown       }
33569566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numEdges, &edges));
33579566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numEdges, &edgeSets));
3358b7f5c055SJed Brown       for (PetscInt edge = 0, i = 0; i < numFaces; i++) {
3359b7f5c055SJed Brown         for (PetscInt e = 0; e < 4; e++) {
3360b7f5c055SJed Brown           PetscInt         ev[]       = {cells_flat[i * 4 + e], cells_flat[i * 4 + ((e + 1) % 4)]};
3361b7f5c055SJed Brown           const PetscReal *evCoords[] = {&vtxCoords[3 * ev[0]], &vtxCoords[3 * ev[1]]};
3362b7f5c055SJed Brown 
3363b7f5c055SJed Brown           for (PetscInt d = 0; d < 3; d++) {
3364b7f5c055SJed Brown             if (!periodic || periodic[d] != DM_BOUNDARY_PERIODIC) {
3365b7f5c055SJed Brown               if (evCoords[0][d] == 0. && evCoords[1][d] == 0.) {
3366b7f5c055SJed Brown                 edges[edge][0]   = ev[0];
3367b7f5c055SJed Brown                 edges[edge][1]   = ev[1];
3368b7f5c055SJed Brown                 edgeSets[edge++] = 2 * d;
3369b7f5c055SJed Brown               }
3370b7f5c055SJed Brown               if (evCoords[0][d] == 2. * extent[d] && evCoords[1][d] == 2. * extent[d]) {
3371b7f5c055SJed Brown                 edges[edge][0]   = ev[0];
3372b7f5c055SJed Brown                 edges[edge][1]   = ev[1];
3373b7f5c055SJed Brown                 edgeSets[edge++] = 2 * d + 1;
3374b7f5c055SJed Brown               }
3375b7f5c055SJed Brown             }
3376b7f5c055SJed Brown           }
3377b7f5c055SJed Brown         }
3378b7f5c055SJed Brown       }
3379b7f5c055SJed Brown     }
3380b7f5c055SJed Brown     evalFunc   = TPSEvaluate_Gyroid;
33814663dae6SJed Brown     normalFunc = TPSExtrudeNormalFunc_Gyroid;
3382b7f5c055SJed Brown     break;
3383b7f5c055SJed Brown   }
3384b7f5c055SJed Brown 
33859566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, topoDim));
3386c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildFromCellList(dm, numFaces, numVertices, 4, cells_flat));
33879566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildFromCellList(dm, 0, 0, 0, NULL));
33889566063dSJacob Faibussowitsch   PetscCall(PetscFree(cells_flat));
3389b7f5c055SJed Brown   {
3390b7f5c055SJed Brown     DM idm;
33919566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(dm, &idm));
339269d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &idm));
3393b7f5c055SJed Brown   }
3394c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildCoordinatesFromCellList(dm, spaceDim, vtxCoords));
33959566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildCoordinatesFromCellList(dm, spaceDim, NULL));
33969566063dSJacob Faibussowitsch   PetscCall(PetscFree(vtxCoords));
3397b7f5c055SJed Brown 
33989566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "Face Sets"));
33999566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "Face Sets", &label));
3400b7f5c055SJed Brown   for (PetscInt e = 0; e < numEdges; e++) {
3401b7f5c055SJed Brown     PetscInt        njoin;
3402b7f5c055SJed Brown     const PetscInt *join, verts[] = {numFaces + edges[e][0], numFaces + edges[e][1]};
34039566063dSJacob Faibussowitsch     PetscCall(DMPlexGetJoin(dm, 2, verts, &njoin, &join));
340463a3b9bcSJacob 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]);
34059566063dSJacob Faibussowitsch     PetscCall(DMLabelSetValue(label, join[0], edgeSets[e]));
34069566063dSJacob Faibussowitsch     PetscCall(DMPlexRestoreJoin(dm, 2, verts, &njoin, &join));
3407b7f5c055SJed Brown   }
34089566063dSJacob Faibussowitsch   PetscCall(PetscFree(edges));
34099566063dSJacob Faibussowitsch   PetscCall(PetscFree(edgeSets));
34101436d7faSJed Brown   if (tps_distribute) {
34111436d7faSJed Brown     DM               pdm = NULL;
34121436d7faSJed Brown     PetscPartitioner part;
34131436d7faSJed Brown 
34149566063dSJacob Faibussowitsch     PetscCall(DMPlexGetPartitioner(dm, &part));
34159566063dSJacob Faibussowitsch     PetscCall(PetscPartitionerSetFromOptions(part));
34169566063dSJacob Faibussowitsch     PetscCall(DMPlexDistribute(dm, 0, NULL, &pdm));
341748a46eb9SPierre Jolivet     if (pdm) PetscCall(DMPlexReplace_Internal(dm, &pdm));
34181436d7faSJed Brown     // Do not auto-distribute again
34199566063dSJacob Faibussowitsch     PetscCall(DMPlexDistributeSetDefault(dm, PETSC_FALSE));
34201436d7faSJed Brown   }
3421b7f5c055SJed Brown 
34229566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
3423b7f5c055SJed Brown   for (PetscInt refine = 0; refine < refinements; refine++) {
3424b7f5c055SJed Brown     PetscInt     m;
3425b7f5c055SJed Brown     DM           dmf;
3426b7f5c055SJed Brown     Vec          X;
3427b7f5c055SJed Brown     PetscScalar *x;
34289566063dSJacob Faibussowitsch     PetscCall(DMRefine(dm, MPI_COMM_NULL, &dmf));
342969d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmf));
3430b7f5c055SJed Brown 
34319566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinatesLocal(dm, &X));
34329566063dSJacob Faibussowitsch     PetscCall(VecGetLocalSize(X, &m));
34339566063dSJacob Faibussowitsch     PetscCall(VecGetArray(X, &x));
343448a46eb9SPierre Jolivet     for (PetscInt i = 0; i < m; i += 3) PetscCall(TPSNearestPoint(evalFunc, &x[i]));
34359566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(X, &x));
3436b7f5c055SJed Brown   }
3437b7f5c055SJed Brown 
3438b7f5c055SJed Brown   // Face Sets has already been propagated to new vertices during refinement; this propagates to the initial vertices.
34399566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "Face Sets", &label));
34409566063dSJacob Faibussowitsch   PetscCall(DMPlexLabelComplete(dm, label));
3441b7f5c055SJed Brown 
344246139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
344346139095SJed Brown 
3444b7f5c055SJed Brown   if (thickness > 0) {
34454663dae6SJed Brown     DM              edm, cdm, ecdm;
34464663dae6SJed Brown     DMPlexTransform tr;
34474663dae6SJed Brown     const char     *prefix;
34484663dae6SJed Brown     PetscOptions    options;
34494663dae6SJed Brown     // Code from DMPlexExtrude
34504663dae6SJed Brown     PetscCall(DMPlexTransformCreate(PetscObjectComm((PetscObject)dm), &tr));
34514663dae6SJed Brown     PetscCall(DMPlexTransformSetDM(tr, dm));
34524663dae6SJed Brown     PetscCall(DMPlexTransformSetType(tr, DMPLEXEXTRUDE));
34534663dae6SJed Brown     PetscCall(PetscObjectGetOptionsPrefix((PetscObject)dm, &prefix));
34544663dae6SJed Brown     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)tr, prefix));
34554663dae6SJed Brown     PetscCall(PetscObjectGetOptions((PetscObject)dm, &options));
34564663dae6SJed Brown     PetscCall(PetscObjectSetOptions((PetscObject)tr, options));
34574663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetLayers(tr, layers));
34584663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetThickness(tr, thickness));
34594663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetTensor(tr, PETSC_FALSE));
34604663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetSymmetric(tr, PETSC_TRUE));
34614663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetNormalFunction(tr, normalFunc));
34624663dae6SJed Brown     PetscCall(DMPlexTransformSetFromOptions(tr));
34634663dae6SJed Brown     PetscCall(PetscObjectSetOptions((PetscObject)tr, NULL));
34644663dae6SJed Brown     PetscCall(DMPlexTransformSetUp(tr));
34654663dae6SJed Brown     PetscCall(PetscObjectViewFromOptions((PetscObject)tr, NULL, "-dm_plex_tps_transform_view"));
34664663dae6SJed Brown     PetscCall(DMPlexTransformApply(tr, dm, &edm));
34674663dae6SJed Brown     PetscCall(DMCopyDisc(dm, edm));
34684663dae6SJed Brown     PetscCall(DMGetCoordinateDM(dm, &cdm));
34694663dae6SJed Brown     PetscCall(DMGetCoordinateDM(edm, &ecdm));
34704663dae6SJed Brown     PetscCall(DMCopyDisc(cdm, ecdm));
34714663dae6SJed Brown     PetscCall(DMPlexTransformCreateDiscLabels(tr, edm));
34724663dae6SJed Brown     PetscCall(DMPlexTransformDestroy(&tr));
34734663dae6SJed Brown     if (edm) {
34744663dae6SJed Brown       ((DM_Plex *)edm->data)->printFEM    = ((DM_Plex *)dm->data)->printFEM;
34754663dae6SJed Brown       ((DM_Plex *)edm->data)->printL2     = ((DM_Plex *)dm->data)->printL2;
3476f5867de0SMatthew G. Knepley       ((DM_Plex *)edm->data)->printLocate = ((DM_Plex *)dm->data)->printLocate;
34774663dae6SJed Brown     }
347869d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &edm));
3479b7f5c055SJed Brown   }
34803ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3481b7f5c055SJed Brown }
3482b7f5c055SJed Brown 
3483b7f5c055SJed Brown /*@
3484b7f5c055SJed Brown   DMPlexCreateTPSMesh - Create a distributed, interpolated mesh of a triply-periodic surface
3485b7f5c055SJed Brown 
3486b7f5c055SJed Brown   Collective
3487b7f5c055SJed Brown 
3488b7f5c055SJed Brown   Input Parameters:
3489a1cb98faSBarry Smith + comm           - The communicator for the `DM` object
3490b7f5c055SJed Brown . tpstype        - Type of triply-periodic surface
3491b7f5c055SJed Brown . extent         - Array of length 3 containing number of periods in each direction
349220f4b53cSBarry Smith . periodic       - array of length 3 with periodicity, or `NULL` for non-periodic
34931436d7faSJed Brown . tps_distribute - Distribute 2D manifold mesh prior to refinement and extrusion (more scalable)
3494817da375SSatish Balay . refinements    - Number of factor-of-2 refinements of 2D manifold mesh
34951436d7faSJed Brown . layers         - Number of cell layers extruded in normal direction
3496817da375SSatish Balay - thickness      - Thickness in normal direction
3497b7f5c055SJed Brown 
3498b7f5c055SJed Brown   Output Parameter:
3499a1cb98faSBarry Smith . dm - The `DM` object
3500a1cb98faSBarry Smith 
3501a1cb98faSBarry Smith   Level: beginner
3502b7f5c055SJed Brown 
3503b7f5c055SJed Brown   Notes:
3504b7f5c055SJed 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.
3505b7f5c055SJed Brown   https://en.wikipedia.org/wiki/Schwarz_minimal_surface#Schwarz_P_(%22Primitive%22) and can be cut with "clean" boundaries.
3506b7f5c055SJed 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.
3507b7f5c055SJed Brown   Our implementation creates a very coarse mesh of the surface and refines (by 4-way splitting) as many times as requested.
3508b7f5c055SJed Brown   On each refinement, all vertices are projected to their nearest point on the surface.
3509b7f5c055SJed Brown   This projection could readily be extended to related surfaces.
3510b7f5c055SJed Brown 
3511b7f5c055SJed Brown   The face (edge) sets for the Schwarz P surface are numbered 1(-x), 2(+x), 3(-y), 4(+y), 5(-z), 6(+z).
351220f4b53cSBarry Smith   When the mesh is refined, "Face Sets" contain the new vertices (created during refinement).  Use `DMPlexLabelComplete()` to propagate to coarse-level vertices.
3513b7f5c055SJed Brown 
351460225df5SJacob Faibussowitsch   Developer Notes:
3515b7f5c055SJed Brown   The Gyroid mesh does not currently mark boundary sets.
3516b7f5c055SJed Brown 
3517a1cb98faSBarry Smith   References:
3518a1cb98faSBarry Smith . * - Maskery et al, Insights into the mechanical properties of several triply periodic minimal surface lattice structures made by polymer additive manufacturing, 2017.
3519a1cb98faSBarry Smith   https://doi.org/10.1016/j.polymer.2017.11.049
3520b7f5c055SJed Brown 
35211cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateSphereMesh()`, `DMSetType()`, `DMCreate()`
3522b7f5c055SJed Brown @*/
3523d71ae5a4SJacob 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)
3524d71ae5a4SJacob Faibussowitsch {
3525b7f5c055SJed Brown   PetscFunctionBegin;
35269566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
35279566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
35289566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateTPSMesh_Internal(*dm, tpstype, extent, periodic, tps_distribute, refinements, layers, thickness));
35293ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3530b7f5c055SJed Brown }
3531b7f5c055SJed Brown 
35329318fe57SMatthew G. Knepley /*@
35339318fe57SMatthew G. Knepley   DMPlexCreateSphereMesh - Creates a mesh on the d-dimensional sphere, S^d.
35349318fe57SMatthew G. Knepley 
35359318fe57SMatthew G. Knepley   Collective
35369318fe57SMatthew G. Knepley 
35379318fe57SMatthew G. Knepley   Input Parameters:
3538a1cb98faSBarry Smith + comm    - The communicator for the `DM` object
35399318fe57SMatthew G. Knepley . dim     - The dimension
35409318fe57SMatthew G. Knepley . simplex - Use simplices, or tensor product cells
35419318fe57SMatthew G. Knepley - R       - The radius
35429318fe57SMatthew G. Knepley 
35439318fe57SMatthew G. Knepley   Output Parameter:
3544a1cb98faSBarry Smith . dm - The `DM` object
35459318fe57SMatthew G. Knepley 
35469318fe57SMatthew G. Knepley   Level: beginner
35479318fe57SMatthew G. Knepley 
35481cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBallMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
35499318fe57SMatthew G. Knepley @*/
3550d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateSphereMesh(MPI_Comm comm, PetscInt dim, PetscBool simplex, PetscReal R, DM *dm)
3551d71ae5a4SJacob Faibussowitsch {
35529318fe57SMatthew G. Knepley   PetscFunctionBegin;
35534f572ea9SToby Isaac   PetscAssertPointer(dm, 5);
35549566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
35559566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
35569566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateSphereMesh_Internal(*dm, dim, simplex, R));
35573ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
35589318fe57SMatthew G. Knepley }
35599318fe57SMatthew G. Knepley 
3560d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBallMesh_Internal(DM dm, PetscInt dim, PetscReal R)
3561d71ae5a4SJacob Faibussowitsch {
35629318fe57SMatthew G. Knepley   DM      sdm, vol;
35639318fe57SMatthew G. Knepley   DMLabel bdlabel;
35649318fe57SMatthew G. Knepley 
35659318fe57SMatthew G. Knepley   PetscFunctionBegin;
35669566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &sdm));
35679566063dSJacob Faibussowitsch   PetscCall(DMSetType(sdm, DMPLEX));
35689566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)sdm, "bd_"));
35699566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateSphereMesh_Internal(sdm, dim - 1, PETSC_TRUE, R));
35709566063dSJacob Faibussowitsch   PetscCall(DMSetFromOptions(sdm));
35719566063dSJacob Faibussowitsch   PetscCall(DMViewFromOptions(sdm, NULL, "-dm_view"));
35729566063dSJacob Faibussowitsch   PetscCall(DMPlexGenerate(sdm, NULL, PETSC_TRUE, &vol));
35739566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&sdm));
357469d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
35759566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "marker"));
35769566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "marker", &bdlabel));
35779566063dSJacob Faibussowitsch   PetscCall(DMPlexMarkBoundaryFaces(dm, PETSC_DETERMINE, bdlabel));
35789566063dSJacob Faibussowitsch   PetscCall(DMPlexLabelComplete(dm, bdlabel));
35793ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
358051a74b61SMatthew G. Knepley }
358151a74b61SMatthew G. Knepley 
358251a74b61SMatthew G. Knepley /*@
358351a74b61SMatthew G. Knepley   DMPlexCreateBallMesh - Creates a simplex mesh on the d-dimensional ball, B^d.
358451a74b61SMatthew G. Knepley 
358551a74b61SMatthew G. Knepley   Collective
358651a74b61SMatthew G. Knepley 
358751a74b61SMatthew G. Knepley   Input Parameters:
3588a1cb98faSBarry Smith + comm - The communicator for the `DM` object
358951a74b61SMatthew G. Knepley . dim  - The dimension
359051a74b61SMatthew G. Knepley - R    - The radius
359151a74b61SMatthew G. Knepley 
359251a74b61SMatthew G. Knepley   Output Parameter:
3593a1cb98faSBarry Smith . dm - The `DM` object
359451a74b61SMatthew G. Knepley 
3595a1cb98faSBarry Smith   Options Database Key:
359660225df5SJacob Faibussowitsch . bd_dm_refine - This will refine the surface mesh preserving the sphere geometry
359751a74b61SMatthew G. Knepley 
359851a74b61SMatthew G. Knepley   Level: beginner
359951a74b61SMatthew G. Knepley 
36001cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateSphereMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
360151a74b61SMatthew G. Knepley @*/
3602d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateBallMesh(MPI_Comm comm, PetscInt dim, PetscReal R, DM *dm)
3603d71ae5a4SJacob Faibussowitsch {
360451a74b61SMatthew G. Knepley   PetscFunctionBegin;
36059566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
36069566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
36079566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBallMesh_Internal(*dm, dim, R));
36083ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
36092829fed8SMatthew G. Knepley }
36102829fed8SMatthew G. Knepley 
3611d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateReferenceCell_Internal(DM rdm, DMPolytopeType ct)
3612d71ae5a4SJacob Faibussowitsch {
36130a6ba040SMatthew G. Knepley   PetscFunctionBegin;
36149318fe57SMatthew G. Knepley   switch (ct) {
36159371c9d4SSatish Balay   case DM_POLYTOPE_POINT: {
36169318fe57SMatthew G. Knepley     PetscInt    numPoints[1]        = {1};
36179318fe57SMatthew G. Knepley     PetscInt    coneSize[1]         = {0};
36189318fe57SMatthew G. Knepley     PetscInt    cones[1]            = {0};
36199318fe57SMatthew G. Knepley     PetscInt    coneOrientations[1] = {0};
36209318fe57SMatthew G. Knepley     PetscScalar vertexCoords[1]     = {0.0};
36219318fe57SMatthew G. Knepley 
36229566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 0));
36239566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 0, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36249371c9d4SSatish Balay   } break;
36259371c9d4SSatish Balay   case DM_POLYTOPE_SEGMENT: {
36269318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {2, 1};
36279318fe57SMatthew G. Knepley     PetscInt    coneSize[3]         = {2, 0, 0};
36289318fe57SMatthew G. Knepley     PetscInt    cones[2]            = {1, 2};
36299318fe57SMatthew G. Knepley     PetscInt    coneOrientations[2] = {0, 0};
36309318fe57SMatthew G. Knepley     PetscScalar vertexCoords[2]     = {-1.0, 1.0};
36319318fe57SMatthew G. Knepley 
36329566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 1));
36339566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36349371c9d4SSatish Balay   } break;
36359371c9d4SSatish Balay   case DM_POLYTOPE_POINT_PRISM_TENSOR: {
3636b5a892a1SMatthew G. Knepley     PetscInt    numPoints[2]        = {2, 1};
3637b5a892a1SMatthew G. Knepley     PetscInt    coneSize[3]         = {2, 0, 0};
3638b5a892a1SMatthew G. Knepley     PetscInt    cones[2]            = {1, 2};
3639b5a892a1SMatthew G. Knepley     PetscInt    coneOrientations[2] = {0, 0};
3640b5a892a1SMatthew G. Knepley     PetscScalar vertexCoords[2]     = {-1.0, 1.0};
3641b5a892a1SMatthew G. Knepley 
36429566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 1));
36439566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36449371c9d4SSatish Balay   } break;
36459371c9d4SSatish Balay   case DM_POLYTOPE_TRIANGLE: {
36469318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {3, 1};
36479318fe57SMatthew G. Knepley     PetscInt    coneSize[4]         = {3, 0, 0, 0};
36489318fe57SMatthew G. Knepley     PetscInt    cones[3]            = {1, 2, 3};
36499318fe57SMatthew G. Knepley     PetscInt    coneOrientations[3] = {0, 0, 0};
36509318fe57SMatthew G. Knepley     PetscScalar vertexCoords[6]     = {-1.0, -1.0, 1.0, -1.0, -1.0, 1.0};
36519318fe57SMatthew G. Knepley 
36529566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
36539566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36549371c9d4SSatish Balay   } break;
36559371c9d4SSatish Balay   case DM_POLYTOPE_QUADRILATERAL: {
36569318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
36579318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
36589318fe57SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
36599318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
36609318fe57SMatthew G. Knepley     PetscScalar vertexCoords[8]     = {-1.0, -1.0, 1.0, -1.0, 1.0, 1.0, -1.0, 1.0};
36619318fe57SMatthew G. Knepley 
36629566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
36639566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36649371c9d4SSatish Balay   } break;
36659371c9d4SSatish Balay   case DM_POLYTOPE_SEG_PRISM_TENSOR: {
36669318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
36679318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
36689318fe57SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
36699318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
36709318fe57SMatthew G. Knepley     PetscScalar vertexCoords[8]     = {-1.0, -1.0, 1.0, -1.0, -1.0, 1.0, 1.0, 1.0};
36719318fe57SMatthew G. Knepley 
36729566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
36739566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36749371c9d4SSatish Balay   } break;
36759371c9d4SSatish Balay   case DM_POLYTOPE_TETRAHEDRON: {
36769318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
36779318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
3678f0edb160SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
36799318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
3680f0edb160SMatthew 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};
36819318fe57SMatthew G. Knepley 
36829566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
36839566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36849371c9d4SSatish Balay   } break;
36859371c9d4SSatish Balay   case DM_POLYTOPE_HEXAHEDRON: {
36869318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {8, 1};
36879318fe57SMatthew G. Knepley     PetscInt    coneSize[9]         = {8, 0, 0, 0, 0, 0, 0, 0, 0};
3688f0edb160SMatthew G. Knepley     PetscInt    cones[8]            = {1, 2, 3, 4, 5, 6, 7, 8};
36899318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
36909371c9d4SSatish 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};
36919318fe57SMatthew G. Knepley 
36929566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
36939566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36949371c9d4SSatish Balay   } break;
36959371c9d4SSatish Balay   case DM_POLYTOPE_TRI_PRISM: {
36969318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {6, 1};
36979318fe57SMatthew G. Knepley     PetscInt    coneSize[7]         = {6, 0, 0, 0, 0, 0, 0};
3698f0edb160SMatthew G. Knepley     PetscInt    cones[6]            = {1, 2, 3, 4, 5, 6};
36999318fe57SMatthew G. Knepley     PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
37009371c9d4SSatish 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};
37019318fe57SMatthew G. Knepley 
37029566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37039566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37049371c9d4SSatish Balay   } break;
37059371c9d4SSatish Balay   case DM_POLYTOPE_TRI_PRISM_TENSOR: {
37069318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {6, 1};
37079318fe57SMatthew G. Knepley     PetscInt    coneSize[7]         = {6, 0, 0, 0, 0, 0, 0};
37089318fe57SMatthew G. Knepley     PetscInt    cones[6]            = {1, 2, 3, 4, 5, 6};
37099318fe57SMatthew G. Knepley     PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
37109371c9d4SSatish 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};
37119318fe57SMatthew G. Knepley 
37129566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37139566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37149371c9d4SSatish Balay   } break;
37159371c9d4SSatish Balay   case DM_POLYTOPE_QUAD_PRISM_TENSOR: {
37169318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {8, 1};
37179318fe57SMatthew G. Knepley     PetscInt    coneSize[9]         = {8, 0, 0, 0, 0, 0, 0, 0, 0};
37189318fe57SMatthew G. Knepley     PetscInt    cones[8]            = {1, 2, 3, 4, 5, 6, 7, 8};
37199318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
37209371c9d4SSatish 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};
37219318fe57SMatthew G. Knepley 
37229566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37239566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37249371c9d4SSatish Balay   } break;
37259371c9d4SSatish Balay   case DM_POLYTOPE_PYRAMID: {
37269318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {5, 1};
37279318fe57SMatthew G. Knepley     PetscInt    coneSize[6]         = {5, 0, 0, 0, 0, 0};
3728f0edb160SMatthew G. Knepley     PetscInt    cones[5]            = {1, 2, 3, 4, 5};
37299318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
37309371c9d4SSatish 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};
37319318fe57SMatthew G. Knepley 
37329566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37339566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37349371c9d4SSatish Balay   } break;
3735d71ae5a4SJacob Faibussowitsch   default:
3736d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)rdm), PETSC_ERR_ARG_WRONG, "Cannot create reference cell for cell type %s", DMPolytopeTypes[ct]);
37379318fe57SMatthew G. Knepley   }
37389318fe57SMatthew G. Knepley   {
37399318fe57SMatthew G. Knepley     PetscInt Nv, v;
37409318fe57SMatthew G. Knepley 
37419318fe57SMatthew G. Knepley     /* Must create the celltype label here so that we do not automatically try to compute the types */
37429566063dSJacob Faibussowitsch     PetscCall(DMCreateLabel(rdm, "celltype"));
37439566063dSJacob Faibussowitsch     PetscCall(DMPlexSetCellType(rdm, 0, ct));
37449566063dSJacob Faibussowitsch     PetscCall(DMPlexGetChart(rdm, NULL, &Nv));
37459566063dSJacob Faibussowitsch     for (v = 1; v < Nv; ++v) PetscCall(DMPlexSetCellType(rdm, v, DM_POLYTOPE_POINT));
37469318fe57SMatthew G. Knepley   }
37479566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolateInPlace_Internal(rdm));
37489566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)rdm, DMPolytopeTypes[ct]));
37493ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
37500a6ba040SMatthew G. Knepley }
37510a6ba040SMatthew G. Knepley 
37529318fe57SMatthew G. Knepley /*@
3753a1cb98faSBarry Smith   DMPlexCreateReferenceCell - Create a `DMPLEX` with the appropriate FEM reference cell
37549318fe57SMatthew G. Knepley 
37559318fe57SMatthew G. Knepley   Collective
37569318fe57SMatthew G. Knepley 
37579318fe57SMatthew G. Knepley   Input Parameters:
37589318fe57SMatthew G. Knepley + comm - The communicator
37599318fe57SMatthew G. Knepley - ct   - The cell type of the reference cell
37609318fe57SMatthew G. Knepley 
37619318fe57SMatthew G. Knepley   Output Parameter:
37629318fe57SMatthew G. Knepley . refdm - The reference cell
37639318fe57SMatthew G. Knepley 
37649318fe57SMatthew G. Knepley   Level: intermediate
37659318fe57SMatthew G. Knepley 
376642747ad1SJacob Faibussowitsch .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBoxMesh()`
37679318fe57SMatthew G. Knepley @*/
3768d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateReferenceCell(MPI_Comm comm, DMPolytopeType ct, DM *refdm)
3769d71ae5a4SJacob Faibussowitsch {
37700a6ba040SMatthew G. Knepley   PetscFunctionBegin;
37719566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, refdm));
37729566063dSJacob Faibussowitsch   PetscCall(DMSetType(*refdm, DMPLEX));
37739566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateReferenceCell_Internal(*refdm, ct));
37743ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
37759318fe57SMatthew G. Knepley }
377679a015ccSMatthew G. Knepley 
3777d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoundaryLabel_Private(DM dm, const char name[])
3778d71ae5a4SJacob Faibussowitsch {
37799318fe57SMatthew G. Knepley   DM        plex;
37809318fe57SMatthew G. Knepley   DMLabel   label;
37819318fe57SMatthew G. Knepley   PetscBool hasLabel;
37820a6ba040SMatthew G. Knepley 
3783c22d3578SMatthew G. Knepley   PetscFunctionBegin;
37849566063dSJacob Faibussowitsch   PetscCall(DMHasLabel(dm, name, &hasLabel));
37853ba16761SJacob Faibussowitsch   if (hasLabel) PetscFunctionReturn(PETSC_SUCCESS);
37869566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, name));
37879566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, name, &label));
37889566063dSJacob Faibussowitsch   PetscCall(DMConvert(dm, DMPLEX, &plex));
37899566063dSJacob Faibussowitsch   PetscCall(DMPlexMarkBoundaryFaces(plex, 1, label));
37901c8afea9SMatthew G. Knepley   PetscCall(DMPlexLabelComplete(plex, label));
37919566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&plex));
37923ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
37939318fe57SMatthew G. Knepley }
3794acdc6f61SToby Isaac 
3795669647acSMatthew G. Knepley /*
3796669647acSMatthew 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.
3797669647acSMatthew G. Knepley 
3798669647acSMatthew G. Knepley     (x, y) -> (r, theta) = (x[1], (x[0] - lower[0]) * 2\pi/(upper[0] - lower[0]))
3799669647acSMatthew G. Knepley */
3800d71ae5a4SJacob 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[])
3801d71ae5a4SJacob Faibussowitsch {
3802669647acSMatthew G. Knepley   const PetscReal low = PetscRealPart(constants[0]);
3803669647acSMatthew G. Knepley   const PetscReal upp = PetscRealPart(constants[1]);
3804669647acSMatthew G. Knepley   const PetscReal r   = PetscRealPart(u[1]);
3805669647acSMatthew G. Knepley   const PetscReal th  = 2. * PETSC_PI * (PetscRealPart(u[0]) - low) / (upp - low);
3806669647acSMatthew G. Knepley 
3807669647acSMatthew G. Knepley   f0[0] = r * PetscCosReal(th);
3808669647acSMatthew G. Knepley   f0[1] = r * PetscSinReal(th);
3809669647acSMatthew G. Knepley }
3810669647acSMatthew G. Knepley 
38115dca41c3SJed Brown const char *const DMPlexShapes[] = {"box", "box_surface", "ball", "sphere", "cylinder", "schwarz_p", "gyroid", "doublet", "annulus", "hypercubic", "zbox", "unknown", "DMPlexShape", "DM_SHAPE_", NULL};
38129318fe57SMatthew G. Knepley 
3813d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateFromOptions_Internal(PetscOptionItems *PetscOptionsObject, PetscBool *useCoordSpace, DM dm)
3814d71ae5a4SJacob Faibussowitsch {
38159318fe57SMatthew G. Knepley   DMPlexShape    shape   = DM_SHAPE_BOX;
38169318fe57SMatthew G. Knepley   DMPolytopeType cell    = DM_POLYTOPE_TRIANGLE;
38179318fe57SMatthew G. Knepley   PetscInt       dim     = 2;
38189318fe57SMatthew G. Knepley   PetscBool      simplex = PETSC_TRUE, interpolate = PETSC_TRUE, adjCone = PETSC_FALSE, adjClosure = PETSC_TRUE, refDomain = PETSC_FALSE;
3819cd7e8a5eSksagiyam   PetscBool      flg, flg2, fflg, bdfflg, nameflg;
38209318fe57SMatthew G. Knepley   MPI_Comm       comm;
3821ed5e4e85SVaclav Hapla   char           filename[PETSC_MAX_PATH_LEN]   = "<unspecified>";
3822ed5e4e85SVaclav Hapla   char           bdFilename[PETSC_MAX_PATH_LEN] = "<unspecified>";
3823ed5e4e85SVaclav Hapla   char           plexname[PETSC_MAX_PATH_LEN]   = "";
38249318fe57SMatthew G. Knepley 
38259318fe57SMatthew G. Knepley   PetscFunctionBegin;
3826708be2fdSJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_CreateFromOptions, dm, 0, 0, 0));
38279566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)dm, &comm));
38289318fe57SMatthew G. Knepley   /* TODO Turn this into a registration interface */
38299566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_filename", "File containing a mesh", "DMPlexCreateFromFile", filename, filename, sizeof(filename), &fflg));
38309566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_boundary_filename", "File containing a mesh boundary", "DMPlexCreateFromFile", bdFilename, bdFilename, sizeof(bdFilename), &bdfflg));
38319566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_name", "Name of the mesh in the file", "DMPlexCreateFromFile", plexname, plexname, sizeof(plexname), &nameflg));
38329566063dSJacob Faibussowitsch   PetscCall(PetscOptionsEnum("-dm_plex_cell", "Cell shape", "", DMPolytopeTypes, (PetscEnum)cell, (PetscEnum *)&cell, NULL));
38339566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_reference_cell_domain", "Use a reference cell domain", "", refDomain, &refDomain, NULL));
38349566063dSJacob Faibussowitsch   PetscCall(PetscOptionsEnum("-dm_plex_shape", "Shape for built-in mesh", "", DMPlexShapes, (PetscEnum)shape, (PetscEnum *)&shape, &flg));
38359566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_plex_dim", "Topological dimension of the mesh", "DMGetDimension", dim, &dim, &flg, 0));
3836cfb853baSMatthew G. Knepley   PetscCheck(dim >= 0, comm, PETSC_ERR_ARG_OUTOFRANGE, "Dimension %" PetscInt_FMT " should be in [0, infinity)", dim);
38379566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_simplex", "Mesh cell shape", "", simplex, &simplex, &flg));
38389566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_interpolate", "Flag to create edges and faces automatically", "", interpolate, &interpolate, &flg));
38399566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_adj_cone", "Set adjacency direction", "DMSetBasicAdjacency", adjCone, &adjCone, &flg));
38409566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_adj_closure", "Set adjacency size", "DMSetBasicAdjacency", adjClosure, &adjClosure, &flg2));
38419566063dSJacob Faibussowitsch   if (flg || flg2) PetscCall(DMSetBasicAdjacency(dm, adjCone, adjClosure));
38429318fe57SMatthew G. Knepley 
384361a622f3SMatthew G. Knepley   switch (cell) {
384461a622f3SMatthew G. Knepley   case DM_POLYTOPE_POINT:
384561a622f3SMatthew G. Knepley   case DM_POLYTOPE_SEGMENT:
384661a622f3SMatthew G. Knepley   case DM_POLYTOPE_POINT_PRISM_TENSOR:
384761a622f3SMatthew G. Knepley   case DM_POLYTOPE_TRIANGLE:
384861a622f3SMatthew G. Knepley   case DM_POLYTOPE_QUADRILATERAL:
384961a622f3SMatthew G. Knepley   case DM_POLYTOPE_TETRAHEDRON:
3850d71ae5a4SJacob Faibussowitsch   case DM_POLYTOPE_HEXAHEDRON:
3851d71ae5a4SJacob Faibussowitsch     *useCoordSpace = PETSC_TRUE;
3852d71ae5a4SJacob Faibussowitsch     break;
3853d71ae5a4SJacob Faibussowitsch   default:
3854d71ae5a4SJacob Faibussowitsch     *useCoordSpace = PETSC_FALSE;
3855d71ae5a4SJacob Faibussowitsch     break;
385661a622f3SMatthew G. Knepley   }
385761a622f3SMatthew G. Knepley 
38589318fe57SMatthew G. Knepley   if (fflg) {
38599318fe57SMatthew G. Knepley     DM dmnew;
38609318fe57SMatthew G. Knepley 
38619566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromFile(PetscObjectComm((PetscObject)dm), filename, plexname, interpolate, &dmnew));
38625de52c6dSVaclav Hapla     PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
386369d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmnew));
38649318fe57SMatthew G. Knepley   } else if (refDomain) {
38659566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateReferenceCell_Internal(dm, cell));
38669318fe57SMatthew G. Knepley   } else if (bdfflg) {
38679318fe57SMatthew G. Knepley     DM bdm, dmnew;
38689318fe57SMatthew G. Knepley 
38699566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromFile(PetscObjectComm((PetscObject)dm), bdFilename, plexname, interpolate, &bdm));
38709566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)bdm, "bd_"));
38719566063dSJacob Faibussowitsch     PetscCall(DMSetFromOptions(bdm));
38729566063dSJacob Faibussowitsch     PetscCall(DMPlexGenerate(bdm, NULL, interpolate, &dmnew));
38739566063dSJacob Faibussowitsch     PetscCall(DMDestroy(&bdm));
38745de52c6dSVaclav Hapla     PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
387569d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmnew));
38769318fe57SMatthew G. Knepley   } else {
38779566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)dm, DMPlexShapes[shape]));
38789318fe57SMatthew G. Knepley     switch (shape) {
3879669647acSMatthew G. Knepley     case DM_SHAPE_BOX:
38805dca41c3SJed Brown     case DM_SHAPE_ZBOX:
3881669647acSMatthew G. Knepley     case DM_SHAPE_ANNULUS: {
38829318fe57SMatthew G. Knepley       PetscInt       faces[3]  = {0, 0, 0};
38839318fe57SMatthew G. Knepley       PetscReal      lower[3]  = {0, 0, 0};
38849318fe57SMatthew G. Knepley       PetscReal      upper[3]  = {1, 1, 1};
38859318fe57SMatthew G. Knepley       DMBoundaryType bdt[3]    = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
3886669647acSMatthew G. Knepley       PetscBool      isAnnular = shape == DM_SHAPE_ANNULUS ? PETSC_TRUE : PETSC_FALSE;
38879318fe57SMatthew G. Knepley       PetscInt       i, n;
38889318fe57SMatthew G. Knepley 
38899318fe57SMatthew G. Knepley       n = dim;
38909318fe57SMatthew G. Knepley       for (i = 0; i < dim; ++i) faces[i] = (dim == 1 ? 1 : 4 - dim);
38919566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", faces, &n, &flg));
38929318fe57SMatthew G. Knepley       n = 3;
38939566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
389463a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Lower box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
38959318fe57SMatthew G. Knepley       n = 3;
38969566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
389763a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Upper box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
38989318fe57SMatthew G. Knepley       n = 3;
38999566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnumArray("-dm_plex_box_bd", "Boundary type for each dimension", "", DMBoundaryTypes, (PetscEnum *)bdt, &n, &flg));
390063a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Box boundary types had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
3901669647acSMatthew G. Knepley 
3902669647acSMatthew G. Knepley       PetscCheck(!isAnnular || dim == 2, comm, PETSC_ERR_ARG_OUTOFRANGE, "Only two dimensional annuli have been implemented");
3903669647acSMatthew G. Knepley       if (isAnnular)
3904669647acSMatthew G. Knepley         for (i = 0; i < dim - 1; ++i) bdt[i] = DM_BOUNDARY_PERIODIC;
3905669647acSMatthew G. Knepley 
39069318fe57SMatthew G. Knepley       switch (cell) {
390761a622f3SMatthew G. Knepley       case DM_POLYTOPE_TRI_PRISM_TENSOR:
39089566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateWedgeBoxMesh_Internal(dm, faces, lower, upper, bdt));
3909d410b0cfSMatthew G. Knepley         if (!interpolate) {
3910d410b0cfSMatthew G. Knepley           DM udm;
3911d410b0cfSMatthew G. Knepley 
39129566063dSJacob Faibussowitsch           PetscCall(DMPlexUninterpolate(dm, &udm));
391369d8a87bSksagiyam           PetscCall(DMPlexReplace_Internal(dm, &udm));
3914d410b0cfSMatthew G. Knepley         }
39159318fe57SMatthew G. Knepley         break;
3916d71ae5a4SJacob Faibussowitsch       default:
39175dca41c3SJed Brown         PetscCall(DMPlexCreateBoxMesh_Internal(dm, shape, dim, simplex, faces, lower, upper, bdt, interpolate));
3918d71ae5a4SJacob Faibussowitsch         break;
39199318fe57SMatthew G. Knepley       }
3920669647acSMatthew G. Knepley       if (isAnnular) {
3921669647acSMatthew G. Knepley         DM          cdm;
3922669647acSMatthew G. Knepley         PetscDS     cds;
3923669647acSMatthew G. Knepley         PetscScalar bounds[2] = {lower[0], upper[0]};
3924669647acSMatthew G. Knepley 
3925669647acSMatthew G. Knepley         // Fix coordinates for annular region
3926669647acSMatthew G. Knepley         PetscCall(DMSetPeriodicity(dm, NULL, NULL, NULL));
3927669647acSMatthew G. Knepley         PetscCall(DMSetCellCoordinatesLocal(dm, NULL));
3928669647acSMatthew G. Knepley         PetscCall(DMSetCellCoordinates(dm, NULL));
3929*e44f6aebSMatthew G. Knepley         PetscCall(DMPlexCreateCoordinateSpace(dm, 1, PETSC_TRUE, NULL));
3930669647acSMatthew G. Knepley         PetscCall(DMGetCoordinateDM(dm, &cdm));
3931669647acSMatthew G. Knepley         PetscCall(DMGetDS(cdm, &cds));
3932669647acSMatthew G. Knepley         PetscCall(PetscDSSetConstants(cds, 2, bounds));
3933669647acSMatthew G. Knepley         PetscCall(DMPlexRemapGeometry(dm, 0.0, boxToAnnulus));
3934669647acSMatthew G. Knepley       }
39359371c9d4SSatish Balay     } break;
39369371c9d4SSatish Balay     case DM_SHAPE_BOX_SURFACE: {
39379318fe57SMatthew G. Knepley       PetscInt  faces[3] = {0, 0, 0};
39389318fe57SMatthew G. Knepley       PetscReal lower[3] = {0, 0, 0};
39399318fe57SMatthew G. Knepley       PetscReal upper[3] = {1, 1, 1};
39409318fe57SMatthew G. Knepley       PetscInt  i, n;
39419318fe57SMatthew G. Knepley 
39429318fe57SMatthew G. Knepley       n = dim + 1;
39439318fe57SMatthew G. Knepley       for (i = 0; i < dim + 1; ++i) faces[i] = (dim + 1 == 1 ? 1 : 4 - (dim + 1));
39449566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", faces, &n, &flg));
39459318fe57SMatthew G. Knepley       n = 3;
39469566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
394763a3b9bcSJacob 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);
39489318fe57SMatthew G. Knepley       n = 3;
39499566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
395063a3b9bcSJacob 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);
39519566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateBoxSurfaceMesh_Internal(dm, dim + 1, faces, lower, upper, interpolate));
39529371c9d4SSatish Balay     } break;
39539371c9d4SSatish Balay     case DM_SHAPE_SPHERE: {
39549318fe57SMatthew G. Knepley       PetscReal R = 1.0;
39559318fe57SMatthew G. Knepley 
39569566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_sphere_radius", "Radius of the sphere", "", R, &R, &flg));
39579566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateSphereMesh_Internal(dm, dim, simplex, R));
39589371c9d4SSatish Balay     } break;
39599371c9d4SSatish Balay     case DM_SHAPE_BALL: {
39609318fe57SMatthew G. Knepley       PetscReal R = 1.0;
39619318fe57SMatthew G. Knepley 
39629566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_ball_radius", "Radius of the ball", "", R, &R, &flg));
39639566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateBallMesh_Internal(dm, dim, R));
39649371c9d4SSatish Balay     } break;
39659371c9d4SSatish Balay     case DM_SHAPE_CYLINDER: {
39669318fe57SMatthew G. Knepley       DMBoundaryType bdt = DM_BOUNDARY_NONE;
39679318fe57SMatthew G. Knepley       PetscInt       Nw  = 6;
39689318fe57SMatthew G. Knepley 
39699566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnum("-dm_plex_cylinder_bd", "Boundary type in the z direction", "", DMBoundaryTypes, (PetscEnum)bdt, (PetscEnum *)&bdt, NULL));
39709566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_cylinder_num_wedges", "Number of wedges around the cylinder", "", Nw, &Nw, NULL));
39719318fe57SMatthew G. Knepley       switch (cell) {
3972d71ae5a4SJacob Faibussowitsch       case DM_POLYTOPE_TRI_PRISM_TENSOR:
3973d71ae5a4SJacob Faibussowitsch         PetscCall(DMPlexCreateWedgeCylinderMesh_Internal(dm, Nw, interpolate));
3974d71ae5a4SJacob Faibussowitsch         break;
3975d71ae5a4SJacob Faibussowitsch       default:
3976d71ae5a4SJacob Faibussowitsch         PetscCall(DMPlexCreateHexCylinderMesh_Internal(dm, bdt));
3977d71ae5a4SJacob Faibussowitsch         break;
39789318fe57SMatthew G. Knepley       }
39799371c9d4SSatish Balay     } break;
3980b7f5c055SJed Brown     case DM_SHAPE_SCHWARZ_P: // fallthrough
39819371c9d4SSatish Balay     case DM_SHAPE_GYROID: {
3982b7f5c055SJed Brown       PetscInt       extent[3] = {1, 1, 1}, refine = 0, layers = 0, three;
3983b7f5c055SJed Brown       PetscReal      thickness   = 0.;
3984b7f5c055SJed Brown       DMBoundaryType periodic[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
3985b7f5c055SJed Brown       DMPlexTPSType  tps_type    = shape == DM_SHAPE_SCHWARZ_P ? DMPLEX_TPS_SCHWARZ_P : DMPLEX_TPS_GYROID;
39861436d7faSJed Brown       PetscBool      tps_distribute;
39879566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_tps_extent", "Number of replicas for each of three dimensions", NULL, extent, (three = 3, &three), NULL));
39889566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_tps_refine", "Number of refinements", NULL, refine, &refine, NULL));
39899566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnumArray("-dm_plex_tps_periodic", "Periodicity in each of three dimensions", NULL, DMBoundaryTypes, (PetscEnum *)periodic, (three = 3, &three), NULL));
39909566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_tps_layers", "Number of layers in volumetric extrusion (or zero to not extrude)", NULL, layers, &layers, NULL));
39919566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_tps_thickness", "Thickness of volumetric extrusion", NULL, thickness, &thickness, NULL));
39929566063dSJacob Faibussowitsch       PetscCall(DMPlexDistributeGetDefault(dm, &tps_distribute));
39939566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_tps_distribute", "Distribute the 2D mesh prior to refinement and extrusion", NULL, tps_distribute, &tps_distribute, NULL));
39949566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateTPSMesh_Internal(dm, tps_type, extent, periodic, tps_distribute, refine, layers, thickness));
39959371c9d4SSatish Balay     } break;
39969371c9d4SSatish Balay     case DM_SHAPE_DOUBLET: {
399705bd46c0SStefano Zampini       DM        dmnew;
399805bd46c0SStefano Zampini       PetscReal rl = 0.0;
399905bd46c0SStefano Zampini 
400005bd46c0SStefano Zampini       PetscCall(PetscOptionsReal("-dm_plex_doublet_refinementlimit", "Refinement limit", NULL, rl, &rl, NULL));
400105bd46c0SStefano Zampini       PetscCall(DMPlexCreateDoublet(PetscObjectComm((PetscObject)dm), dim, simplex, interpolate, rl, &dmnew));
40025de52c6dSVaclav Hapla       PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
400369d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &dmnew));
40049371c9d4SSatish Balay     } break;
4005cfb853baSMatthew G. Knepley     case DM_SHAPE_HYPERCUBIC: {
4006cfb853baSMatthew G. Knepley       PetscInt       *edges;
4007cfb853baSMatthew G. Knepley       PetscReal      *lower, *upper;
4008cfb853baSMatthew G. Knepley       DMBoundaryType *bdt;
4009cfb853baSMatthew G. Knepley       PetscInt        n, d;
4010cfb853baSMatthew G. Knepley 
4011cfb853baSMatthew G. Knepley       *useCoordSpace = PETSC_FALSE;
4012cfb853baSMatthew G. Knepley       PetscCall(PetscMalloc4(dim, &edges, dim, &lower, dim, &upper, dim, &bdt));
4013cfb853baSMatthew G. Knepley       for (d = 0; d < dim; ++d) {
4014cfb853baSMatthew G. Knepley         edges[d] = 1;
4015cfb853baSMatthew G. Knepley         lower[d] = 0.;
4016cfb853baSMatthew G. Knepley         upper[d] = 1.;
4017cfb853baSMatthew G. Knepley         bdt[d]   = DM_BOUNDARY_PERIODIC;
4018cfb853baSMatthew G. Knepley       }
4019cfb853baSMatthew G. Knepley       n = dim;
4020cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", edges, &n, &flg));
4021cfb853baSMatthew G. Knepley       n = dim;
4022cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
4023cfb853baSMatthew 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);
4024cfb853baSMatthew G. Knepley       n = dim;
4025cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
4026cfb853baSMatthew 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);
4027cfb853baSMatthew G. Knepley       n = dim;
4028cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsEnumArray("-dm_plex_box_bd", "Boundary type for each dimension", "", DMBoundaryTypes, (PetscEnum *)bdt, &n, &flg));
4029cfb853baSMatthew 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);
4030cfb853baSMatthew G. Knepley       PetscCall(DMPlexCreateHypercubicMesh_Internal(dm, dim, lower, upper, edges, bdt));
4031cfb853baSMatthew G. Knepley       PetscCall(PetscFree4(edges, lower, upper, bdt));
4032cfb853baSMatthew G. Knepley     } break;
4033d71ae5a4SJacob Faibussowitsch     default:
4034d71ae5a4SJacob Faibussowitsch       SETERRQ(comm, PETSC_ERR_SUP, "Domain shape %s is unsupported", DMPlexShapes[shape]);
40359318fe57SMatthew G. Knepley     }
40369318fe57SMatthew G. Knepley   }
40379566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
403848a46eb9SPierre Jolivet   if (!((PetscObject)dm)->name && nameflg) PetscCall(PetscObjectSetName((PetscObject)dm, plexname));
4039708be2fdSJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_CreateFromOptions, dm, 0, 0, 0));
40403ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
40410a6ba040SMatthew G. Knepley }
40420a6ba040SMatthew G. Knepley 
4043d71ae5a4SJacob Faibussowitsch PetscErrorCode DMSetFromOptions_NonRefinement_Plex(DM dm, PetscOptionItems *PetscOptionsObject)
4044d71ae5a4SJacob Faibussowitsch {
40450a6ba040SMatthew G. Knepley   DM_Plex  *mesh = (DM_Plex *)dm->data;
40467f9d8d6cSVaclav Hapla   PetscBool flg, flg2;
40479318fe57SMatthew G. Knepley   char      bdLabel[PETSC_MAX_PATH_LEN];
40480a6ba040SMatthew G. Knepley 
40490a6ba040SMatthew G. Knepley   PetscFunctionBegin;
40500a6ba040SMatthew G. Knepley   /* Handle viewing */
40519566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_print_set_values", "Output all set values info", "DMPlexMatSetClosure", PETSC_FALSE, &mesh->printSetValues, NULL));
40529566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_fem", "Debug output level all fem computations", "DMPlexSNESComputeResidualFEM", 0, &mesh->printFEM, NULL, 0));
40539566063dSJacob Faibussowitsch   PetscCall(PetscOptionsReal("-dm_plex_print_tol", "Tolerance for FEM output", "DMPlexSNESComputeResidualFEM", mesh->printTol, &mesh->printTol, NULL));
40549566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_l2", "Debug output level all L2 diff computations", "DMComputeL2Diff", 0, &mesh->printL2, NULL, 0));
4055f5867de0SMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_locate", "Debug output level all point location computations", "DMLocatePoints", 0, &mesh->printLocate, NULL, 0));
40569566063dSJacob Faibussowitsch   PetscCall(DMMonitorSetFromOptions(dm, "-dm_plex_monitor_throughput", "Monitor the simulation throughput", "DMPlexMonitorThroughput", DMPlexMonitorThroughput, NULL, &flg));
40579566063dSJacob Faibussowitsch   if (flg) PetscCall(PetscLogDefaultBegin());
40589318fe57SMatthew G. Knepley   /* Labeling */
40599566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_boundary_label", "Label to mark the mesh boundary", "", bdLabel, bdLabel, sizeof(bdLabel), &flg));
40609566063dSJacob Faibussowitsch   if (flg) PetscCall(DMPlexCreateBoundaryLabel_Private(dm, bdLabel));
4061953fc75cSMatthew G. Knepley   /* Point Location */
40629566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_hash_location", "Use grid hashing for point location", "DMInterpolate", PETSC_FALSE, &mesh->useHashLocation, NULL));
40630848f4b5SMatthew G. Knepley   /* Partitioning and distribution */
40649566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_partition_balance", "Attempt to evenly divide points on partition boundary between processes", "DMPlexSetPartitionBalance", PETSC_FALSE, &mesh->partitionBalance, NULL));
40652e62ab5aSMatthew G. Knepley   /* Generation and remeshing */
40669566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_remesh_bd", "Allow changes to the boundary on remeshing", "DMAdapt", PETSC_FALSE, &mesh->remeshBd, NULL));
4067b29cfa1cSToby Isaac   /* Projection behavior */
4068d5b43468SJose E. Roman   PetscCall(PetscOptionsBoundedInt("-dm_plex_max_projection_height", "Maximum mesh point height used to project locally", "DMPlexSetMaxProjectionHeight", 0, &mesh->maxProjectionHeight, NULL, 0));
40699566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_regular_refinement", "Use special nested projection algorithm for regular refinement", "DMPlexSetRegularRefinement", mesh->regularRefinement, &mesh->regularRefinement, NULL));
4070f12cf164SMatthew G. Knepley   /* Checking structure */
4071f12cf164SMatthew G. Knepley   {
40727f9d8d6cSVaclav Hapla     PetscBool all = PETSC_FALSE;
4073f12cf164SMatthew G. Knepley 
40747f9d8d6cSVaclav Hapla     PetscCall(PetscOptionsBool("-dm_plex_check_all", "Perform all basic checks", "DMPlexCheck", PETSC_FALSE, &all, NULL));
40757f9d8d6cSVaclav Hapla     if (all) {
40767f9d8d6cSVaclav Hapla       PetscCall(DMPlexCheck(dm));
40777f9d8d6cSVaclav Hapla     } else {
40789566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_symmetry", "Check that the adjacency information in the mesh is symmetric", "DMPlexCheckSymmetry", PETSC_FALSE, &flg, &flg2));
40797f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckSymmetry(dm));
40809566063dSJacob 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));
40817f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckSkeleton(dm, 0));
40829566063dSJacob 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));
40837f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckFaces(dm, 0));
40849566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_geometry", "Check that cells have positive volume", "DMPlexCheckGeometry", PETSC_FALSE, &flg, &flg2));
40857f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckGeometry(dm));
40869566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_pointsf", "Check some necessary conditions for PointSF", "DMPlexCheckPointSF", PETSC_FALSE, &flg, &flg2));
4087d7d32a9aSMatthew G. Knepley       if (flg && flg2) PetscCall(DMPlexCheckPointSF(dm, NULL, PETSC_FALSE));
40889566063dSJacob 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));
40897f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckInterfaceCones(dm));
40907f9d8d6cSVaclav Hapla     }
40919566063dSJacob Faibussowitsch     PetscCall(PetscOptionsBool("-dm_plex_check_cell_shape", "Check cell shape", "DMPlexCheckCellShape", PETSC_FALSE, &flg, &flg2));
40929566063dSJacob Faibussowitsch     if (flg && flg2) PetscCall(DMPlexCheckCellShape(dm, PETSC_TRUE, PETSC_DETERMINE));
4093f12cf164SMatthew G. Knepley   }
40949318fe57SMatthew G. Knepley   {
40959318fe57SMatthew G. Knepley     PetscReal scale = 1.0;
40964f3833eaSMatthew G. Knepley 
40979566063dSJacob Faibussowitsch     PetscCall(PetscOptionsReal("-dm_plex_scale", "Scale factor for mesh coordinates", "DMPlexScale", scale, &scale, &flg));
40989318fe57SMatthew G. Knepley     if (flg) {
40999318fe57SMatthew G. Knepley       Vec coordinates, coordinatesLocal;
41009318fe57SMatthew G. Knepley 
41019566063dSJacob Faibussowitsch       PetscCall(DMGetCoordinates(dm, &coordinates));
41029566063dSJacob Faibussowitsch       PetscCall(DMGetCoordinatesLocal(dm, &coordinatesLocal));
41039566063dSJacob Faibussowitsch       PetscCall(VecScale(coordinates, scale));
41049566063dSJacob Faibussowitsch       PetscCall(VecScale(coordinatesLocal, scale));
41059318fe57SMatthew G. Knepley     }
41069318fe57SMatthew G. Knepley   }
41079566063dSJacob Faibussowitsch   PetscCall(PetscPartitionerSetFromOptions(mesh->partitioner));
41083ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
410968d4fef7SMatthew G. Knepley }
411068d4fef7SMatthew G. Knepley 
4111d71ae5a4SJacob Faibussowitsch PetscErrorCode DMSetFromOptions_Overlap_Plex(DM dm, PetscOptionItems *PetscOptionsObject, PetscInt *overlap)
4112d71ae5a4SJacob Faibussowitsch {
4113c506a872SMatthew G. Knepley   PetscInt  numOvLabels = 16, numOvExLabels = 16;
4114c506a872SMatthew G. Knepley   char     *ovLabelNames[16], *ovExLabelNames[16];
4115c506a872SMatthew G. Knepley   PetscInt  numOvValues = 16, numOvExValues = 16, l;
4116c506a872SMatthew G. Knepley   PetscBool flg;
4117c506a872SMatthew G. Knepley 
4118c506a872SMatthew G. Knepley   PetscFunctionBegin;
4119c506a872SMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_distribute_overlap", "The size of the overlap halo", "DMPlexDistribute", *overlap, overlap, NULL, 0));
4120c506a872SMatthew G. Knepley   PetscCall(PetscOptionsStringArray("-dm_distribute_overlap_labels", "List of overlap label names", "DMPlexDistribute", ovLabelNames, &numOvLabels, &flg));
4121c506a872SMatthew G. Knepley   if (!flg) numOvLabels = 0;
4122c506a872SMatthew G. Knepley   if (numOvLabels) {
4123c506a872SMatthew G. Knepley     ((DM_Plex *)dm->data)->numOvLabels = numOvLabels;
4124c506a872SMatthew G. Knepley     for (l = 0; l < numOvLabels; ++l) {
4125c506a872SMatthew G. Knepley       PetscCall(DMGetLabel(dm, ovLabelNames[l], &((DM_Plex *)dm->data)->ovLabels[l]));
4126c506a872SMatthew G. Knepley       PetscCheck(((DM_Plex *)dm->data)->ovLabels[l], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid label name %s", ovLabelNames[l]);
4127c506a872SMatthew G. Knepley       PetscCall(PetscFree(ovLabelNames[l]));
4128c506a872SMatthew G. Knepley     }
4129c506a872SMatthew G. Knepley     PetscCall(PetscOptionsIntArray("-dm_distribute_overlap_values", "List of overlap label values", "DMPlexDistribute", ((DM_Plex *)dm->data)->ovValues, &numOvValues, &flg));
4130c506a872SMatthew G. Knepley     if (!flg) numOvValues = 0;
4131c506a872SMatthew 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);
4132c506a872SMatthew G. Knepley 
4133c506a872SMatthew G. Knepley     PetscCall(PetscOptionsStringArray("-dm_distribute_overlap_exclude_labels", "List of overlap exclude label names", "DMPlexDistribute", ovExLabelNames, &numOvExLabels, &flg));
4134c506a872SMatthew G. Knepley     if (!flg) numOvExLabels = 0;
4135c506a872SMatthew G. Knepley     ((DM_Plex *)dm->data)->numOvExLabels = numOvExLabels;
4136c506a872SMatthew G. Knepley     for (l = 0; l < numOvExLabels; ++l) {
4137c506a872SMatthew G. Knepley       PetscCall(DMGetLabel(dm, ovExLabelNames[l], &((DM_Plex *)dm->data)->ovExLabels[l]));
4138c506a872SMatthew G. Knepley       PetscCheck(((DM_Plex *)dm->data)->ovExLabels[l], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid label name %s", ovExLabelNames[l]);
4139c506a872SMatthew G. Knepley       PetscCall(PetscFree(ovExLabelNames[l]));
4140c506a872SMatthew G. Knepley     }
4141c506a872SMatthew G. Knepley     PetscCall(PetscOptionsIntArray("-dm_distribute_overlap_exclude_values", "List of overlap exclude label values", "DMPlexDistribute", ((DM_Plex *)dm->data)->ovExValues, &numOvExValues, &flg));
4142c506a872SMatthew G. Knepley     if (!flg) numOvExValues = 0;
4143c506a872SMatthew 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);
4144c506a872SMatthew G. Knepley   }
41453ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4146c506a872SMatthew G. Knepley }
4147c506a872SMatthew G. Knepley 
4148d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMSetFromOptions_Plex(DM dm, PetscOptionItems *PetscOptionsObject)
4149d71ae5a4SJacob Faibussowitsch {
4150bdf63967SMatthew G. Knepley   PetscFunctionList        ordlist;
4151bdf63967SMatthew G. Knepley   char                     oname[256];
4152d410b0cfSMatthew G. Knepley   PetscReal                volume    = -1.0;
41539318fe57SMatthew G. Knepley   PetscInt                 prerefine = 0, refine = 0, r, coarsen = 0, overlap = 0, extLayers = 0, dim;
4154e600fa54SMatthew G. Knepley   PetscBool                uniformOrig, created = PETSC_FALSE, uniform = PETSC_TRUE, distribute, interpolate = PETSC_TRUE, coordSpace = PETSC_TRUE, remap = PETSC_TRUE, ghostCells = PETSC_FALSE, isHierarchy, ignoreModel = PETSC_FALSE, flg;
41556bc1bd01Sksagiyam   DMPlexReorderDefaultFlag reorder;
415668d4fef7SMatthew G. Knepley 
415768d4fef7SMatthew G. Knepley   PetscFunctionBegin;
4158d0609cedSBarry Smith   PetscOptionsHeadBegin(PetscOptionsObject, "DMPlex Options");
4159dd4c3f67SMatthew G. Knepley   if (dm->cloneOpts) goto non_refine;
41609318fe57SMatthew G. Knepley   /* Handle automatic creation */
41619566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
41626bc1bd01Sksagiyam   if (dim < 0) {
41636bc1bd01Sksagiyam     PetscCall(DMPlexCreateFromOptions_Internal(PetscOptionsObject, &coordSpace, dm));
41646bc1bd01Sksagiyam     created = PETSC_TRUE;
41656bc1bd01Sksagiyam   }
41666bc1bd01Sksagiyam   PetscCall(DMGetDimension(dm, &dim));
4167d89e6e46SMatthew G. Knepley   /* Handle interpolation before distribution */
41689566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_interpolate_pre", "Flag to interpolate mesh before distribution", "", interpolate, &interpolate, &flg));
4169d89e6e46SMatthew G. Knepley   if (flg) {
4170d89e6e46SMatthew G. Knepley     DMPlexInterpolatedFlag interpolated;
4171d89e6e46SMatthew G. Knepley 
41729566063dSJacob Faibussowitsch     PetscCall(DMPlexIsInterpolated(dm, &interpolated));
4173d89e6e46SMatthew G. Knepley     if (interpolated == DMPLEX_INTERPOLATED_FULL && !interpolate) {
4174d89e6e46SMatthew G. Knepley       DM udm;
4175d89e6e46SMatthew G. Knepley 
41769566063dSJacob Faibussowitsch       PetscCall(DMPlexUninterpolate(dm, &udm));
417769d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &udm));
4178d89e6e46SMatthew G. Knepley     } else if (interpolated != DMPLEX_INTERPOLATED_FULL && interpolate) {
4179d89e6e46SMatthew G. Knepley       DM idm;
4180d89e6e46SMatthew G. Knepley 
41819566063dSJacob Faibussowitsch       PetscCall(DMPlexInterpolate(dm, &idm));
418269d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &idm));
4183d89e6e46SMatthew G. Knepley     }
4184d89e6e46SMatthew G. Knepley   }
41859b44eab4SMatthew G. Knepley   /* Handle DMPlex refinement before distribution */
41869566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_ignore_model", "Flag to ignore the geometry model when refining", "DMCreate", ignoreModel, &ignoreModel, &flg));
4187ad540459SPierre Jolivet   if (flg) ((DM_Plex *)dm->data)->ignoreModel = ignoreModel;
41889566063dSJacob Faibussowitsch   PetscCall(DMPlexGetRefinementUniform(dm, &uniformOrig));
41899566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine_pre", "The number of refinements before distribution", "DMCreate", prerefine, &prerefine, NULL, 0));
41909566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_remap_pre", "Flag to control coordinate remapping", "DMCreate", remap, &remap, NULL));
41919566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_uniform_pre", "Flag for uniform refinement before distribution", "DMCreate", uniform, &uniform, &flg));
41929566063dSJacob Faibussowitsch   if (flg) PetscCall(DMPlexSetRefinementUniform(dm, uniform));
41939566063dSJacob Faibussowitsch   PetscCall(PetscOptionsReal("-dm_refine_volume_limit_pre", "The maximum cell volume after refinement before distribution", "DMCreate", volume, &volume, &flg));
41949318fe57SMatthew G. Knepley   if (flg) {
41959566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementUniform(dm, PETSC_FALSE));
41969566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementLimit(dm, volume));
41979318fe57SMatthew G. Knepley     prerefine = PetscMax(prerefine, 1);
41989318fe57SMatthew G. Knepley   }
41999b44eab4SMatthew G. Knepley   for (r = 0; r < prerefine; ++r) {
42009b44eab4SMatthew G. Knepley     DM             rdm;
42019b44eab4SMatthew G. Knepley     PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
42029b44eab4SMatthew G. Knepley 
4203dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
42049566063dSJacob Faibussowitsch     PetscCall(DMRefine(dm, PetscObjectComm((PetscObject)dm), &rdm));
420569d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &rdm));
4206dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
420761a622f3SMatthew G. Knepley     if (coordFunc && remap) {
42089566063dSJacob Faibussowitsch       PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
42099b44eab4SMatthew G. Knepley       ((DM_Plex *)dm->data)->coordFunc = coordFunc;
42109b44eab4SMatthew G. Knepley     }
42119b44eab4SMatthew G. Knepley   }
42129566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, uniformOrig));
42139318fe57SMatthew G. Knepley   /* Handle DMPlex extrusion before distribution */
42149566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_extrude", "The number of layers to extrude", "", extLayers, &extLayers, NULL, 0));
42159318fe57SMatthew G. Knepley   if (extLayers) {
42169318fe57SMatthew G. Knepley     DM edm;
42179318fe57SMatthew G. Knepley 
42189566063dSJacob Faibussowitsch     PetscCall(DMExtrude(dm, extLayers, &edm));
421969d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &edm));
422048d16a33SMatthew G. Knepley     ((DM_Plex *)dm->data)->coordFunc = NULL;
4221dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4222d410b0cfSMatthew G. Knepley     extLayers = 0;
42235e17fc22SAidan Hamilton     PetscCall(DMGetDimension(dm, &dim));
42249318fe57SMatthew G. Knepley   }
4225bdf63967SMatthew G. Knepley   /* Handle DMPlex reordering before distribution */
42266bc1bd01Sksagiyam   PetscCall(DMPlexReorderGetDefault(dm, &reorder));
42279566063dSJacob Faibussowitsch   PetscCall(MatGetOrderingList(&ordlist));
42286bc1bd01Sksagiyam   PetscCall(PetscStrncpy(oname, MATORDERINGNATURAL, sizeof(oname)));
42299566063dSJacob Faibussowitsch   PetscCall(PetscOptionsFList("-dm_plex_reorder", "Set mesh reordering type", "DMPlexGetOrdering", ordlist, MATORDERINGNATURAL, oname, sizeof(oname), &flg));
42306bc1bd01Sksagiyam   if (reorder == DMPLEX_REORDER_DEFAULT_TRUE || flg) {
4231bdf63967SMatthew G. Knepley     DM pdm;
4232bdf63967SMatthew G. Knepley     IS perm;
4233bdf63967SMatthew G. Knepley 
42349566063dSJacob Faibussowitsch     PetscCall(DMPlexGetOrdering(dm, oname, NULL, &perm));
42359566063dSJacob Faibussowitsch     PetscCall(DMPlexPermute(dm, perm, &pdm));
42369566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&perm));
423769d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &pdm));
4238dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4239bdf63967SMatthew G. Knepley   }
42409b44eab4SMatthew G. Knepley   /* Handle DMPlex distribution */
42419566063dSJacob Faibussowitsch   PetscCall(DMPlexDistributeGetDefault(dm, &distribute));
4242c506a872SMatthew G. Knepley   PetscCall(PetscOptionsBool("-dm_distribute", "Flag to redistribute a mesh among processes", "DMPlexDistribute", distribute, &distribute, NULL));
4243dbbe0bcdSBarry Smith   PetscCall(DMSetFromOptions_Overlap_Plex(dm, PetscOptionsObject, &overlap));
42449b44eab4SMatthew G. Knepley   if (distribute) {
42459b44eab4SMatthew G. Knepley     DM               pdm = NULL;
42469b44eab4SMatthew G. Knepley     PetscPartitioner part;
42479b44eab4SMatthew G. Knepley 
42489566063dSJacob Faibussowitsch     PetscCall(DMPlexGetPartitioner(dm, &part));
42499566063dSJacob Faibussowitsch     PetscCall(PetscPartitionerSetFromOptions(part));
42509566063dSJacob Faibussowitsch     PetscCall(DMPlexDistribute(dm, overlap, NULL, &pdm));
425148a46eb9SPierre Jolivet     if (pdm) PetscCall(DMPlexReplace_Internal(dm, &pdm));
42529b44eab4SMatthew G. Knepley   }
4253d2b2dc1eSMatthew G. Knepley   /* Must check CEED options before creating function space for coordinates */
4254d2b2dc1eSMatthew G. Knepley   {
4255d2b2dc1eSMatthew G. Knepley     PetscBool useCeed = PETSC_FALSE, flg;
4256d2b2dc1eSMatthew G. Knepley 
4257d2b2dc1eSMatthew G. Knepley     PetscCall(PetscOptionsBool("-dm_plex_use_ceed", "Use LibCEED as the FEM backend", "DMPlexSetUseCeed", useCeed, &useCeed, &flg));
4258d2b2dc1eSMatthew G. Knepley     if (flg) PetscCall(DMPlexSetUseCeed(dm, useCeed));
4259d2b2dc1eSMatthew G. Knepley   }
42609318fe57SMatthew G. Knepley   /* Create coordinate space */
42619318fe57SMatthew G. Knepley   if (created) {
426261a622f3SMatthew G. Knepley     DM_Plex  *mesh   = (DM_Plex *)dm->data;
4263*e44f6aebSMatthew G. Knepley     PetscInt  degree = 1, deg;
42645515ebd3SMatthew G. Knepley     PetscInt  height = 0;
42655515ebd3SMatthew G. Knepley     DM        cdm;
42666858538eSMatthew G. Knepley     PetscBool flg;
42679318fe57SMatthew G. Knepley 
42689566063dSJacob Faibussowitsch     PetscCall(PetscOptionsBool("-dm_coord_space", "Use an FEM space for coordinates", "", coordSpace, &coordSpace, &flg));
42699566063dSJacob Faibussowitsch     PetscCall(PetscOptionsInt("-dm_coord_petscspace_degree", "FEM degree for coordinate space", "", degree, &degree, NULL));
4270*e44f6aebSMatthew G. Knepley     PetscCall(DMGetCoordinateDegree_Internal(dm, &deg));
4271*e44f6aebSMatthew G. Knepley     if (coordSpace && deg <= 1) PetscCall(DMPlexCreateCoordinateSpace(dm, degree, PETSC_TRUE, mesh->coordFunc));
42725515ebd3SMatthew G. Knepley     PetscCall(DMGetCoordinateDM(dm, &cdm));
427361a622f3SMatthew G. Knepley     if (flg && !coordSpace) {
427461a622f3SMatthew G. Knepley       PetscDS      cds;
427561a622f3SMatthew G. Knepley       PetscObject  obj;
427661a622f3SMatthew G. Knepley       PetscClassId id;
427761a622f3SMatthew G. Knepley 
42789566063dSJacob Faibussowitsch       PetscCall(DMGetDS(cdm, &cds));
42799566063dSJacob Faibussowitsch       PetscCall(PetscDSGetDiscretization(cds, 0, &obj));
42809566063dSJacob Faibussowitsch       PetscCall(PetscObjectGetClassId(obj, &id));
428161a622f3SMatthew G. Knepley       if (id == PETSCFE_CLASSID) {
428261a622f3SMatthew G. Knepley         PetscContainer dummy;
428361a622f3SMatthew G. Knepley 
42849566063dSJacob Faibussowitsch         PetscCall(PetscContainerCreate(PETSC_COMM_SELF, &dummy));
42859566063dSJacob Faibussowitsch         PetscCall(PetscObjectSetName((PetscObject)dummy, "coordinates"));
42869566063dSJacob Faibussowitsch         PetscCall(DMSetField(cdm, 0, NULL, (PetscObject)dummy));
42879566063dSJacob Faibussowitsch         PetscCall(PetscContainerDestroy(&dummy));
42889566063dSJacob Faibussowitsch         PetscCall(DMClearDS(cdm));
428961a622f3SMatthew G. Knepley       }
429061a622f3SMatthew G. Knepley       mesh->coordFunc = NULL;
429161a622f3SMatthew G. Knepley     }
42926858538eSMatthew G. Knepley     PetscCall(PetscOptionsBool("-dm_sparse_localize", "Localize only necessary cells", "", dm->sparseLocalize, &dm->sparseLocalize, &flg));
42935515ebd3SMatthew G. Knepley     PetscCall(PetscOptionsInt("-dm_localize_height", "Localize edges and faces in addition to cells", "", height, &height, &flg));
42945515ebd3SMatthew G. Knepley     if (flg) PetscCall(DMPlexSetMaxProjectionHeight(cdm, height));
42959566063dSJacob Faibussowitsch     PetscCall(DMLocalizeCoordinates(dm));
42969318fe57SMatthew G. Knepley   }
429768d4fef7SMatthew G. Knepley   /* Handle DMPlex refinement */
429861a622f3SMatthew G. Knepley   remap = PETSC_TRUE;
42999566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine", "The number of uniform refinements", "DMCreate", refine, &refine, NULL, 0));
43009566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_remap", "Flag to control coordinate remapping", "DMCreate", remap, &remap, NULL));
43019566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine_hierarchy", "The number of uniform refinements", "DMCreate", refine, &refine, &isHierarchy, 0));
43029566063dSJacob Faibussowitsch   if (refine) PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
430368d4fef7SMatthew G. Knepley   if (refine && isHierarchy) {
4304acdc6f61SToby Isaac     DM *dms, coarseDM;
430568d4fef7SMatthew G. Knepley 
43069566063dSJacob Faibussowitsch     PetscCall(DMGetCoarseDM(dm, &coarseDM));
43079566063dSJacob Faibussowitsch     PetscCall(PetscObjectReference((PetscObject)coarseDM));
43089566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(refine, &dms));
43099566063dSJacob Faibussowitsch     PetscCall(DMRefineHierarchy(dm, refine, dms));
431068d4fef7SMatthew G. Knepley     /* Total hack since we do not pass in a pointer */
43119566063dSJacob Faibussowitsch     PetscCall(DMPlexSwap_Static(dm, dms[refine - 1]));
431268d4fef7SMatthew G. Knepley     if (refine == 1) {
43139566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dm, dms[0]));
43149566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dm, PETSC_TRUE));
431568d4fef7SMatthew G. Knepley     } else {
43169566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dm, dms[refine - 2]));
43179566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dm, PETSC_TRUE));
43189566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dms[0], dms[refine - 1]));
43199566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dms[0], PETSC_TRUE));
432068d4fef7SMatthew G. Knepley     }
43219566063dSJacob Faibussowitsch     PetscCall(DMSetCoarseDM(dms[refine - 1], coarseDM));
43229566063dSJacob Faibussowitsch     PetscCall(PetscObjectDereference((PetscObject)coarseDM));
432368d4fef7SMatthew G. Knepley     /* Free DMs */
432468d4fef7SMatthew G. Knepley     for (r = 0; r < refine; ++r) {
4325dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dms[r], PetscOptionsObject));
43269566063dSJacob Faibussowitsch       PetscCall(DMDestroy(&dms[r]));
432768d4fef7SMatthew G. Knepley     }
43289566063dSJacob Faibussowitsch     PetscCall(PetscFree(dms));
432968d4fef7SMatthew G. Knepley   } else {
433068d4fef7SMatthew G. Knepley     for (r = 0; r < refine; ++r) {
43319318fe57SMatthew G. Knepley       DM             rdm;
433251a74b61SMatthew G. Knepley       PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
433368d4fef7SMatthew G. Knepley 
4334dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
43359566063dSJacob Faibussowitsch       PetscCall(DMRefine(dm, PetscObjectComm((PetscObject)dm), &rdm));
433668d4fef7SMatthew G. Knepley       /* Total hack since we do not pass in a pointer */
433769d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &rdm));
4338dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
433961a622f3SMatthew G. Knepley       if (coordFunc && remap) {
43409566063dSJacob Faibussowitsch         PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
434151a74b61SMatthew G. Knepley         ((DM_Plex *)dm->data)->coordFunc = coordFunc;
434251a74b61SMatthew G. Knepley       }
434368d4fef7SMatthew G. Knepley     }
434468d4fef7SMatthew G. Knepley   }
43453cf6fe12SMatthew G. Knepley   /* Handle DMPlex coarsening */
43469566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_coarsen", "Coarsen the mesh", "DMCreate", coarsen, &coarsen, NULL, 0));
43479566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_coarsen_hierarchy", "The number of coarsenings", "DMCreate", coarsen, &coarsen, &isHierarchy, 0));
4348b653a561SMatthew G. Knepley   if (coarsen && isHierarchy) {
4349b653a561SMatthew G. Knepley     DM *dms;
4350b653a561SMatthew G. Knepley 
43519566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(coarsen, &dms));
43529566063dSJacob Faibussowitsch     PetscCall(DMCoarsenHierarchy(dm, coarsen, dms));
4353b653a561SMatthew G. Knepley     /* Free DMs */
4354b653a561SMatthew G. Knepley     for (r = 0; r < coarsen; ++r) {
4355dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dms[r], PetscOptionsObject));
43569566063dSJacob Faibussowitsch       PetscCall(DMDestroy(&dms[r]));
4357b653a561SMatthew G. Knepley     }
43589566063dSJacob Faibussowitsch     PetscCall(PetscFree(dms));
4359b653a561SMatthew G. Knepley   } else {
4360b653a561SMatthew G. Knepley     for (r = 0; r < coarsen; ++r) {
43619318fe57SMatthew G. Knepley       DM             cdm;
43629318fe57SMatthew G. Knepley       PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
43633cf6fe12SMatthew G. Knepley 
4364dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
43659566063dSJacob Faibussowitsch       PetscCall(DMCoarsen(dm, PetscObjectComm((PetscObject)dm), &cdm));
43663cf6fe12SMatthew G. Knepley       /* Total hack since we do not pass in a pointer */
436769d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &cdm));
4368dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
43699318fe57SMatthew G. Knepley       if (coordFunc) {
43709566063dSJacob Faibussowitsch         PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
43719318fe57SMatthew G. Knepley         ((DM_Plex *)dm->data)->coordFunc = coordFunc;
43729318fe57SMatthew G. Knepley       }
43733cf6fe12SMatthew G. Knepley     }
4374b653a561SMatthew G. Knepley   }
4375909dfd52SMatthew G. Knepley   /* Handle ghost cells */
43769566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_create_fv_ghost_cells", "Flag to create finite volume ghost cells on the boundary", "DMCreate", ghostCells, &ghostCells, NULL));
4377909dfd52SMatthew G. Knepley   if (ghostCells) {
4378909dfd52SMatthew G. Knepley     DM   gdm;
4379909dfd52SMatthew G. Knepley     char lname[PETSC_MAX_PATH_LEN];
4380909dfd52SMatthew G. Knepley 
4381909dfd52SMatthew G. Knepley     lname[0] = '\0';
43829566063dSJacob Faibussowitsch     PetscCall(PetscOptionsString("-dm_plex_fv_ghost_cells_label", "Label name for ghost cells boundary", "DMCreate", lname, lname, sizeof(lname), &flg));
43839566063dSJacob Faibussowitsch     PetscCall(DMPlexConstructGhostCells(dm, flg ? lname : NULL, NULL, &gdm));
438469d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &gdm));
4385909dfd52SMatthew G. Knepley   }
43866913077dSMatthew G. Knepley   /* Handle 1D order */
43876bc1bd01Sksagiyam   if (reorder != DMPLEX_REORDER_DEFAULT_FALSE && dim == 1) {
43886913077dSMatthew G. Knepley     DM           cdm, rdm;
43896913077dSMatthew G. Knepley     PetscDS      cds;
43906913077dSMatthew G. Knepley     PetscObject  obj;
43916913077dSMatthew G. Knepley     PetscClassId id = PETSC_OBJECT_CLASSID;
43926913077dSMatthew G. Knepley     IS           perm;
43936bc1bd01Sksagiyam     PetscInt     Nf;
43946913077dSMatthew G. Knepley     PetscBool    distributed;
43956913077dSMatthew G. Knepley 
43969566063dSJacob Faibussowitsch     PetscCall(DMPlexIsDistributed(dm, &distributed));
43979566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
43989566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
43999566063dSJacob Faibussowitsch     PetscCall(PetscDSGetNumFields(cds, &Nf));
44006913077dSMatthew G. Knepley     if (Nf) {
44019566063dSJacob Faibussowitsch       PetscCall(PetscDSGetDiscretization(cds, 0, &obj));
44029566063dSJacob Faibussowitsch       PetscCall(PetscObjectGetClassId(obj, &id));
44036913077dSMatthew G. Knepley     }
44046bc1bd01Sksagiyam     if (!distributed && id != PETSCFE_CLASSID) {
44059566063dSJacob Faibussowitsch       PetscCall(DMPlexGetOrdering1D(dm, &perm));
44069566063dSJacob Faibussowitsch       PetscCall(DMPlexPermute(dm, perm, &rdm));
440769d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &rdm));
44089566063dSJacob Faibussowitsch       PetscCall(ISDestroy(&perm));
44096913077dSMatthew G. Knepley     }
44106913077dSMatthew G. Knepley   }
44113cf6fe12SMatthew G. Knepley /* Handle */
4412dd4c3f67SMatthew G. Knepley non_refine:
4413dbbe0bcdSBarry Smith   PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4414d0609cedSBarry Smith   PetscOptionsHeadEnd();
44153ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
44160a6ba040SMatthew G. Knepley }
44170a6ba040SMatthew G. Knepley 
4418d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMCreateGlobalVector_Plex(DM dm, Vec *vec)
4419d71ae5a4SJacob Faibussowitsch {
4420552f7358SJed Brown   PetscFunctionBegin;
44219566063dSJacob Faibussowitsch   PetscCall(DMCreateGlobalVector_Section_Private(dm, vec));
44229566063dSJacob Faibussowitsch   /* PetscCall(VecSetOperation(*vec, VECOP_DUPLICATE, (void(*)(void)) VecDuplicate_MPI_DM)); */
44239566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEW, (void (*)(void))VecView_Plex));
44249566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEWNATIVE, (void (*)(void))VecView_Plex_Native));
44259566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOAD, (void (*)(void))VecLoad_Plex));
44269566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOADNATIVE, (void (*)(void))VecLoad_Plex_Native));
44273ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4428552f7358SJed Brown }
4429552f7358SJed Brown 
4430d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMCreateLocalVector_Plex(DM dm, Vec *vec)
4431d71ae5a4SJacob Faibussowitsch {
4432552f7358SJed Brown   PetscFunctionBegin;
44339566063dSJacob Faibussowitsch   PetscCall(DMCreateLocalVector_Section_Private(dm, vec));
44349566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEW, (void (*)(void))VecView_Plex_Local));
44359566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOAD, (void (*)(void))VecLoad_Plex_Local));
44363ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4437552f7358SJed Brown }
4438552f7358SJed Brown 
4439d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMGetDimPoints_Plex(DM dm, PetscInt dim, PetscInt *pStart, PetscInt *pEnd)
4440d71ae5a4SJacob Faibussowitsch {
4441793f3fe5SMatthew G. Knepley   PetscInt depth, d;
4442793f3fe5SMatthew G. Knepley 
4443793f3fe5SMatthew G. Knepley   PetscFunctionBegin;
44449566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepth(dm, &depth));
4445793f3fe5SMatthew G. Knepley   if (depth == 1) {
44469566063dSJacob Faibussowitsch     PetscCall(DMGetDimension(dm, &d));
44479566063dSJacob Faibussowitsch     if (dim == 0) PetscCall(DMPlexGetDepthStratum(dm, dim, pStart, pEnd));
44489566063dSJacob Faibussowitsch     else if (dim == d) PetscCall(DMPlexGetDepthStratum(dm, 1, pStart, pEnd));
44499371c9d4SSatish Balay     else {
44509371c9d4SSatish Balay       *pStart = 0;
44519371c9d4SSatish Balay       *pEnd   = 0;
44529371c9d4SSatish Balay     }
4453793f3fe5SMatthew G. Knepley   } else {
44549566063dSJacob Faibussowitsch     PetscCall(DMPlexGetDepthStratum(dm, dim, pStart, pEnd));
4455793f3fe5SMatthew G. Knepley   }
44563ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4457793f3fe5SMatthew G. Knepley }
4458793f3fe5SMatthew G. Knepley 
4459d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMGetNeighbors_Plex(DM dm, PetscInt *nranks, const PetscMPIInt *ranks[])
4460d71ae5a4SJacob Faibussowitsch {
4461502a2867SDave May   PetscSF            sf;
44620a19bb7dSprj-   PetscInt           niranks, njranks, n;
44630a19bb7dSprj-   const PetscMPIInt *iranks, *jranks;
44640a19bb7dSprj-   DM_Plex           *data = (DM_Plex *)dm->data;
4465502a2867SDave May 
44662f356facSMatthew G. Knepley   PetscFunctionBegin;
44679566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dm, &sf));
44680a19bb7dSprj-   if (!data->neighbors) {
44699566063dSJacob Faibussowitsch     PetscCall(PetscSFSetUp(sf));
44709566063dSJacob Faibussowitsch     PetscCall(PetscSFGetRootRanks(sf, &njranks, &jranks, NULL, NULL, NULL));
44719566063dSJacob Faibussowitsch     PetscCall(PetscSFGetLeafRanks(sf, &niranks, &iranks, NULL, NULL));
44729566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(njranks + niranks + 1, &data->neighbors));
44739566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(data->neighbors + 1, jranks, njranks));
44749566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(data->neighbors + njranks + 1, iranks, niranks));
44750a19bb7dSprj-     n = njranks + niranks;
44769566063dSJacob Faibussowitsch     PetscCall(PetscSortRemoveDupsMPIInt(&n, data->neighbors + 1));
44770a19bb7dSprj-     /* The following cast should never fail: can't have more neighbors than PETSC_MPI_INT_MAX */
44789566063dSJacob Faibussowitsch     PetscCall(PetscMPIIntCast(n, data->neighbors));
44790a19bb7dSprj-   }
44800a19bb7dSprj-   if (nranks) *nranks = data->neighbors[0];
44810a19bb7dSprj-   if (ranks) {
44820a19bb7dSprj-     if (data->neighbors[0]) *ranks = data->neighbors + 1;
44830a19bb7dSprj-     else *ranks = NULL;
44840a19bb7dSprj-   }
44853ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4486502a2867SDave May }
4487502a2867SDave May 
44881eb70e55SToby Isaac PETSC_INTERN PetscErrorCode DMInterpolateSolution_Plex(DM, DM, Mat, Vec, Vec);
44891eb70e55SToby Isaac 
4490d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMInitialize_Plex(DM dm)
4491d71ae5a4SJacob Faibussowitsch {
4492552f7358SJed Brown   PetscFunctionBegin;
4493552f7358SJed Brown   dm->ops->view                      = DMView_Plex;
44942c40f234SMatthew G. Knepley   dm->ops->load                      = DMLoad_Plex;
4495552f7358SJed Brown   dm->ops->setfromoptions            = DMSetFromOptions_Plex;
449638221697SMatthew G. Knepley   dm->ops->clone                     = DMClone_Plex;
4497552f7358SJed Brown   dm->ops->setup                     = DMSetUp_Plex;
44981bb6d2a8SBarry Smith   dm->ops->createlocalsection        = DMCreateLocalSection_Plex;
449966ad2231SToby Isaac   dm->ops->createdefaultconstraints  = DMCreateDefaultConstraints_Plex;
4500552f7358SJed Brown   dm->ops->createglobalvector        = DMCreateGlobalVector_Plex;
4501552f7358SJed Brown   dm->ops->createlocalvector         = DMCreateLocalVector_Plex;
4502184d77edSJed Brown   dm->ops->getlocaltoglobalmapping   = NULL;
45030298fd71SBarry Smith   dm->ops->createfieldis             = NULL;
4504552f7358SJed Brown   dm->ops->createcoordinatedm        = DMCreateCoordinateDM_Plex;
4505f19dbd58SToby Isaac   dm->ops->createcoordinatefield     = DMCreateCoordinateField_Plex;
45060a6ba040SMatthew G. Knepley   dm->ops->getcoloring               = NULL;
4507552f7358SJed Brown   dm->ops->creatematrix              = DMCreateMatrix_Plex;
4508bceba477SMatthew G. Knepley   dm->ops->createinterpolation       = DMCreateInterpolation_Plex;
4509bd041c0cSMatthew G. Knepley   dm->ops->createmassmatrix          = DMCreateMassMatrix_Plex;
4510b4937a87SMatthew G. Knepley   dm->ops->createmassmatrixlumped    = DMCreateMassMatrixLumped_Plex;
45115a84ad33SLisandro Dalcin   dm->ops->createinjection           = DMCreateInjection_Plex;
4512552f7358SJed Brown   dm->ops->refine                    = DMRefine_Plex;
45130a6ba040SMatthew G. Knepley   dm->ops->coarsen                   = DMCoarsen_Plex;
45140a6ba040SMatthew G. Knepley   dm->ops->refinehierarchy           = DMRefineHierarchy_Plex;
4515b653a561SMatthew G. Knepley   dm->ops->coarsenhierarchy          = DMCoarsenHierarchy_Plex;
4516d410b0cfSMatthew G. Knepley   dm->ops->extrude                   = DMExtrude_Plex;
45170298fd71SBarry Smith   dm->ops->globaltolocalbegin        = NULL;
45180298fd71SBarry Smith   dm->ops->globaltolocalend          = NULL;
45190298fd71SBarry Smith   dm->ops->localtoglobalbegin        = NULL;
45200298fd71SBarry Smith   dm->ops->localtoglobalend          = NULL;
4521552f7358SJed Brown   dm->ops->destroy                   = DMDestroy_Plex;
4522552f7358SJed Brown   dm->ops->createsubdm               = DMCreateSubDM_Plex;
45232adcc780SMatthew G. Knepley   dm->ops->createsuperdm             = DMCreateSuperDM_Plex;
4524793f3fe5SMatthew G. Knepley   dm->ops->getdimpoints              = DMGetDimPoints_Plex;
4525552f7358SJed Brown   dm->ops->locatepoints              = DMLocatePoints_Plex;
45260709b2feSToby Isaac   dm->ops->projectfunctionlocal      = DMProjectFunctionLocal_Plex;
45270709b2feSToby Isaac   dm->ops->projectfunctionlabellocal = DMProjectFunctionLabelLocal_Plex;
4528bfc4295aSToby Isaac   dm->ops->projectfieldlocal         = DMProjectFieldLocal_Plex;
45298c6c5593SMatthew G. Knepley   dm->ops->projectfieldlabellocal    = DMProjectFieldLabelLocal_Plex;
4530ece3a9fcSMatthew G. Knepley   dm->ops->projectbdfieldlabellocal  = DMProjectBdFieldLabelLocal_Plex;
45310709b2feSToby Isaac   dm->ops->computel2diff             = DMComputeL2Diff_Plex;
4532b698f381SToby Isaac   dm->ops->computel2gradientdiff     = DMComputeL2GradientDiff_Plex;
45332a16baeaSToby Isaac   dm->ops->computel2fielddiff        = DMComputeL2FieldDiff_Plex;
453428d58a37SPierre Jolivet   dm->ops->getneighbors              = DMGetNeighbors_Plex;
45359566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexInsertBoundaryValues_C", DMPlexInsertBoundaryValues_Plex));
45369566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexInsertTimeDerviativeBoundaryValues_C", DMPlexInsertTimeDerivativeBoundaryValues_Plex));
45379566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMSetUpGLVisViewer_C", DMSetUpGLVisViewer_Plex));
45389566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMCreateNeumannOverlap_C", DMCreateNeumannOverlap_Plex));
45399566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetOverlap_C", DMPlexGetOverlap_Plex));
45409566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexDistributeGetDefault_C", DMPlexDistributeGetDefault_Plex));
45419566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexDistributeSetDefault_C", DMPlexDistributeSetDefault_Plex));
45426bc1bd01Sksagiyam   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexReorderGetDefault_C", DMPlexReorderGetDefault_Plex));
45436bc1bd01Sksagiyam   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexReorderSetDefault_C", DMPlexReorderSetDefault_Plex));
45449566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMInterpolateSolution_C", DMInterpolateSolution_Plex));
4545c506a872SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetOverlap_C", DMPlexGetOverlap_Plex));
4546c506a872SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexSetOverlap_C", DMPlexSetOverlap_Plex));
4547d2b2dc1eSMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetUseCeed_C", DMPlexGetUseCeed_Plex));
4548d2b2dc1eSMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexSetUseCeed_C", DMPlexSetUseCeed_Plex));
45493ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4550552f7358SJed Brown }
4551552f7358SJed Brown 
4552d71ae5a4SJacob Faibussowitsch PETSC_INTERN PetscErrorCode DMClone_Plex(DM dm, DM *newdm)
4553d71ae5a4SJacob Faibussowitsch {
455463a16f15SMatthew G. Knepley   DM_Plex *mesh = (DM_Plex *)dm->data;
45556725e60dSJed Brown   PetscSF  face_sf;
455663a16f15SMatthew G. Knepley 
455763a16f15SMatthew G. Knepley   PetscFunctionBegin;
455863a16f15SMatthew G. Knepley   mesh->refct++;
455963a16f15SMatthew G. Knepley   (*newdm)->data = mesh;
45605f06a3ddSJed Brown   PetscCall(DMPlexGetIsoperiodicFaceSF(dm, &face_sf));
45615f06a3ddSJed Brown   PetscCall(DMPlexSetIsoperiodicFaceSF(*newdm, face_sf));
45629566063dSJacob Faibussowitsch   PetscCall(PetscObjectChangeTypeName((PetscObject)*newdm, DMPLEX));
45639566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(*newdm));
45643ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
456563a16f15SMatthew G. Knepley }
456663a16f15SMatthew G. Knepley 
45678818961aSMatthew G Knepley /*MC
4568a1cb98faSBarry Smith   DMPLEX = "plex" - A `DM` object that encapsulates an unstructured mesh, or CW Complex, which can be expressed using a Hasse Diagram.
456920f4b53cSBarry Smith                     In the local representation, `Vec`s contain all unknowns in the interior and shared boundary. This is
45708818961aSMatthew G Knepley                     specified by a PetscSection object. Ownership in the global representation is determined by
4571a1cb98faSBarry Smith                     ownership of the underlying `DMPLEX` points. This is specified by another `PetscSection` object.
45728818961aSMatthew G Knepley 
4573e5893cccSMatthew G. Knepley   Options Database Keys:
4574250712c9SMatthew G. Knepley + -dm_refine_pre                     - Refine mesh before distribution
4575250712c9SMatthew G. Knepley + -dm_refine_uniform_pre             - Choose uniform or generator-based refinement
4576250712c9SMatthew G. Knepley + -dm_refine_volume_limit_pre        - Cell volume limit after pre-refinement using generator
4577250712c9SMatthew G. Knepley . -dm_distribute                     - Distribute mesh across processes
4578250712c9SMatthew G. Knepley . -dm_distribute_overlap             - Number of cells to overlap for distribution
4579250712c9SMatthew G. Knepley . -dm_refine                         - Refine mesh after distribution
4580250712c9SMatthew G. Knepley . -dm_plex_hash_location             - Use grid hashing for point location
4581ddce0771SMatthew G. Knepley . -dm_plex_hash_box_faces <n,m,p>    - The number of divisions in each direction of the grid hash
4582f12cf164SMatthew G. Knepley . -dm_plex_partition_balance         - Attempt to evenly divide points on partition boundary between processes
4583f12cf164SMatthew G. Knepley . -dm_plex_remesh_bd                 - Allow changes to the boundary on remeshing
4584d5b43468SJose E. Roman . -dm_plex_max_projection_height     - Maximum mesh point height used to project locally
4585f12cf164SMatthew G. Knepley . -dm_plex_regular_refinement        - Use special nested projection algorithm for regular refinement
4586aaa8cc7dSPierre Jolivet . -dm_plex_check_all                 - Perform all checks below
4587f12cf164SMatthew G. Knepley . -dm_plex_check_symmetry            - Check that the adjacency information in the mesh is symmetric
4588f12cf164SMatthew G. Knepley . -dm_plex_check_skeleton <celltype> - Check that each cell has the correct number of vertices
4589f12cf164SMatthew 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
4590f12cf164SMatthew G. Knepley . -dm_plex_check_geometry            - Check that cells have positive volume
4591f12cf164SMatthew G. Knepley . -dm_view :mesh.tex:ascii_latex     - View the mesh in LaTeX/TikZ
4592e5893cccSMatthew G. Knepley . -dm_plex_view_scale <num>          - Scale the TikZ
4593e5893cccSMatthew G. Knepley - -dm_plex_print_fem <num>           - View FEM assembly information, such as element vectors and matrices
4594e5893cccSMatthew G. Knepley 
45958818961aSMatthew G Knepley   Level: intermediate
45968818961aSMatthew G Knepley 
45971cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMType`, `DMPlexCreate()`, `DMCreate()`, `DMSetType()`, `PetscSection`
45988818961aSMatthew G Knepley M*/
45998818961aSMatthew G Knepley 
4600d71ae5a4SJacob Faibussowitsch PETSC_EXTERN PetscErrorCode DMCreate_Plex(DM dm)
4601d71ae5a4SJacob Faibussowitsch {
4602552f7358SJed Brown   DM_Plex *mesh;
4603412e9a14SMatthew G. Knepley   PetscInt unit;
4604552f7358SJed Brown 
4605552f7358SJed Brown   PetscFunctionBegin;
4606f39ec787SMatthew G. Knepley   PetscCall(PetscCitationsRegister(PlexCitation, &Plexcite));
4607552f7358SJed Brown   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
46084dfa11a4SJacob Faibussowitsch   PetscCall(PetscNew(&mesh));
4609552f7358SJed Brown   dm->data = mesh;
4610552f7358SJed Brown 
4611552f7358SJed Brown   mesh->refct = 1;
46129566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &mesh->coneSection));
46139566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &mesh->supportSection));
4614552f7358SJed Brown   mesh->refinementUniform      = PETSC_TRUE;
4615552f7358SJed Brown   mesh->refinementLimit        = -1.0;
4616e600fa54SMatthew G. Knepley   mesh->distDefault            = PETSC_TRUE;
46176bc1bd01Sksagiyam   mesh->reorderDefault         = DMPLEX_REORDER_DEFAULT_NOTSET;
46181d1f2f2aSksagiyam   mesh->distributionName       = NULL;
46197d0f5628SVaclav Hapla   mesh->interpolated           = DMPLEX_INTERPOLATED_INVALID;
46207d0f5628SVaclav Hapla   mesh->interpolatedCollective = DMPLEX_INTERPOLATED_INVALID;
4621552f7358SJed Brown 
46229566063dSJacob Faibussowitsch   PetscCall(PetscPartitionerCreate(PetscObjectComm((PetscObject)dm), &mesh->partitioner));
46232e62ab5aSMatthew G. Knepley   mesh->remeshBd = PETSC_FALSE;
4624d9deefdfSMatthew G. Knepley 
46258865f1eaSKarl Rupp   for (unit = 0; unit < NUM_PETSC_UNITS; ++unit) mesh->scale[unit] = 1.0;
4626552f7358SJed Brown 
4627df0420ecSMatthew G. Knepley   mesh->depthState    = -1;
4628ba2698f1SMatthew G. Knepley   mesh->celltypeState = -1;
46296113b454SMatthew G. Knepley   mesh->printTol      = 1.0e-10;
4630552f7358SJed Brown 
46319566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(dm));
46323ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4633552f7358SJed Brown }
4634552f7358SJed Brown 
4635552f7358SJed Brown /*@
4636a1cb98faSBarry Smith   DMPlexCreate - Creates a `DMPLEX` object, which encapsulates an unstructured mesh, or CW complex, which can be expressed using a Hasse Diagram.
4637552f7358SJed Brown 
4638d083f849SBarry Smith   Collective
4639552f7358SJed Brown 
4640552f7358SJed Brown   Input Parameter:
4641a1cb98faSBarry Smith . comm - The communicator for the `DMPLEX` object
4642552f7358SJed Brown 
4643552f7358SJed Brown   Output Parameter:
4644a1cb98faSBarry Smith . mesh - The `DMPLEX` object
4645552f7358SJed Brown 
4646552f7358SJed Brown   Level: beginner
4647552f7358SJed Brown 
464842747ad1SJacob Faibussowitsch .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMType`, `DMCreate()`, `DMSetType()`
4649552f7358SJed Brown @*/
4650d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreate(MPI_Comm comm, DM *mesh)
4651d71ae5a4SJacob Faibussowitsch {
4652552f7358SJed Brown   PetscFunctionBegin;
46534f572ea9SToby Isaac   PetscAssertPointer(mesh, 2);
46549566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, mesh));
46559566063dSJacob Faibussowitsch   PetscCall(DMSetType(*mesh, DMPLEX));
46563ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4657552f7358SJed Brown }
4658552f7358SJed Brown 
4659b09969d6SVaclav Hapla /*@C
4660a1cb98faSBarry Smith   DMPlexBuildFromCellListParallel - Build distributed `DMPLEX` topology from a list of vertices for each cell (common mesh generator output)
4661a1cb98faSBarry Smith 
466220f4b53cSBarry Smith   Collective; No Fortran Support
4663b09969d6SVaclav Hapla 
4664b09969d6SVaclav Hapla   Input Parameters:
4665a1cb98faSBarry Smith + dm          - The `DM`
4666b09969d6SVaclav Hapla . numCells    - The number of cells owned by this process
4667a1cb98faSBarry Smith . numVertices - The number of vertices to be owned by this process, or `PETSC_DECIDE`
4668a1cb98faSBarry Smith . NVertices   - The global number of vertices, or `PETSC_DETERMINE`
4669b09969d6SVaclav Hapla . numCorners  - The number of vertices for each cell
46705e488331SVaclav Hapla - cells       - An array of numCells*numCorners numbers, the global vertex numbers for each cell
4671b09969d6SVaclav Hapla 
4672be8c289dSNicolas Barral   Output Parameters:
4673a1cb98faSBarry Smith + vertexSF         - (Optional) `PetscSF` describing complete vertex ownership
4674be8c289dSNicolas Barral - verticesAdjSaved - (Optional) vertex adjacency array
4675b09969d6SVaclav Hapla 
4676b09969d6SVaclav Hapla   Level: advanced
4677b09969d6SVaclav Hapla 
4678a1cb98faSBarry Smith   Notes:
4679a1cb98faSBarry Smith   Two triangles sharing a face
4680a1cb98faSBarry Smith .vb
4681a1cb98faSBarry Smith 
4682a1cb98faSBarry Smith         2
4683a1cb98faSBarry Smith       / | \
4684a1cb98faSBarry Smith      /  |  \
4685a1cb98faSBarry Smith     /   |   \
4686a1cb98faSBarry Smith    0  0 | 1  3
4687a1cb98faSBarry Smith     \   |   /
4688a1cb98faSBarry Smith      \  |  /
4689a1cb98faSBarry Smith       \ | /
4690a1cb98faSBarry Smith         1
4691a1cb98faSBarry Smith .ve
4692a1cb98faSBarry Smith   would have input
4693a1cb98faSBarry Smith .vb
4694a1cb98faSBarry Smith   numCells = 2, numVertices = 4
4695a1cb98faSBarry Smith   cells = [0 1 2  1 3 2]
4696a1cb98faSBarry Smith .ve
4697a1cb98faSBarry Smith   which would result in the `DMPLEX`
4698a1cb98faSBarry Smith .vb
4699a1cb98faSBarry Smith 
4700a1cb98faSBarry Smith         4
4701a1cb98faSBarry Smith       / | \
4702a1cb98faSBarry Smith      /  |  \
4703a1cb98faSBarry Smith     /   |   \
4704a1cb98faSBarry Smith    2  0 | 1  5
4705a1cb98faSBarry Smith     \   |   /
4706a1cb98faSBarry Smith      \  |  /
4707a1cb98faSBarry Smith       \ | /
4708a1cb98faSBarry Smith         3
4709a1cb98faSBarry Smith .ve
4710a1cb98faSBarry Smith 
4711a1cb98faSBarry Smith   Vertices are implicitly numbered consecutively 0,...,NVertices.
4712a1cb98faSBarry Smith   Each rank owns a chunk of numVertices consecutive vertices.
4713a1cb98faSBarry Smith   If numVertices is `PETSC_DECIDE`, PETSc will distribute them as evenly as possible using PetscLayout.
4714a1cb98faSBarry Smith   If NVertices is `PETSC_DETERMINE` and numVertices is PETSC_DECIDE, NVertices is computed by PETSc as the maximum vertex index in cells + 1.
4715a1cb98faSBarry Smith   If only NVertices is `PETSC_DETERMINE`, it is computed as the sum of numVertices over all ranks.
4716a1cb98faSBarry Smith 
4717a1cb98faSBarry Smith   The cell distribution is arbitrary non-overlapping, independent of the vertex distribution.
4718a1cb98faSBarry Smith 
47191cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildFromCellList()`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildCoordinatesFromCellListParallel()`,
4720a1cb98faSBarry Smith           `PetscSF`
4721b09969d6SVaclav Hapla @*/
4722d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildFromCellListParallel(DM dm, PetscInt numCells, PetscInt numVertices, PetscInt NVertices, PetscInt numCorners, const PetscInt cells[], PetscSF *vertexSF, PetscInt **verticesAdjSaved)
4723d71ae5a4SJacob Faibussowitsch {
47242464107aSksagiyam   PetscSF     sfPoint;
47252464107aSksagiyam   PetscLayout layout;
472682fb893eSVaclav Hapla   PetscInt    numVerticesAdj, *verticesAdj, *cones, c, p;
4727a47d0d45SMatthew G. Knepley 
4728a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
472925b6865aSVaclav Hapla   PetscValidLogicalCollectiveInt(dm, NVertices, 4);
47309566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
473125b6865aSVaclav Hapla   /* Get/check global number of vertices */
473225b6865aSVaclav Hapla   {
473325b6865aSVaclav Hapla     PetscInt       NVerticesInCells, i;
473425b6865aSVaclav Hapla     const PetscInt len = numCells * numCorners;
473525b6865aSVaclav Hapla 
473625b6865aSVaclav Hapla     /* NVerticesInCells = max(cells) + 1 */
473725b6865aSVaclav Hapla     NVerticesInCells = PETSC_MIN_INT;
47389371c9d4SSatish Balay     for (i = 0; i < len; i++)
47399371c9d4SSatish Balay       if (cells[i] > NVerticesInCells) NVerticesInCells = cells[i];
474025b6865aSVaclav Hapla     ++NVerticesInCells;
4741712fec58SPierre Jolivet     PetscCall(MPIU_Allreduce(MPI_IN_PLACE, &NVerticesInCells, 1, MPIU_INT, MPI_MAX, PetscObjectComm((PetscObject)dm)));
474225b6865aSVaclav Hapla 
474325b6865aSVaclav Hapla     if (numVertices == PETSC_DECIDE && NVertices == PETSC_DECIDE) NVertices = NVerticesInCells;
47449371c9d4SSatish Balay     else
47459371c9d4SSatish 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);
474625b6865aSVaclav Hapla   }
47479079aca8SVaclav Hapla   /* Count locally unique vertices */
47489079aca8SVaclav Hapla   {
47499079aca8SVaclav Hapla     PetscHSetI vhash;
47509079aca8SVaclav Hapla     PetscInt   off = 0;
47519079aca8SVaclav Hapla 
47529566063dSJacob Faibussowitsch     PetscCall(PetscHSetICreate(&vhash));
4753a47d0d45SMatthew G. Knepley     for (c = 0; c < numCells; ++c) {
475448a46eb9SPierre Jolivet       for (p = 0; p < numCorners; ++p) PetscCall(PetscHSetIAdd(vhash, cells[c * numCorners + p]));
4755a47d0d45SMatthew G. Knepley     }
47569566063dSJacob Faibussowitsch     PetscCall(PetscHSetIGetSize(vhash, &numVerticesAdj));
47579566063dSJacob Faibussowitsch     if (!verticesAdjSaved) PetscCall(PetscMalloc1(numVerticesAdj, &verticesAdj));
4758ad540459SPierre Jolivet     else verticesAdj = *verticesAdjSaved;
47599566063dSJacob Faibussowitsch     PetscCall(PetscHSetIGetElems(vhash, &off, verticesAdj));
47609566063dSJacob Faibussowitsch     PetscCall(PetscHSetIDestroy(&vhash));
476163a3b9bcSJacob Faibussowitsch     PetscCheck(off == numVerticesAdj, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid number of local vertices %" PetscInt_FMT " should be %" PetscInt_FMT, off, numVerticesAdj);
4762a47d0d45SMatthew G. Knepley   }
47639566063dSJacob Faibussowitsch   PetscCall(PetscSortInt(numVerticesAdj, verticesAdj));
4764a47d0d45SMatthew G. Knepley   /* Create cones */
47659566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, 0, numCells + numVerticesAdj));
47669566063dSJacob Faibussowitsch   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, numCorners));
47679566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm));
47689566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCones(dm, &cones));
4769a47d0d45SMatthew G. Knepley   for (c = 0; c < numCells; ++c) {
4770a47d0d45SMatthew G. Knepley     for (p = 0; p < numCorners; ++p) {
4771a47d0d45SMatthew G. Knepley       const PetscInt gv = cells[c * numCorners + p];
4772a47d0d45SMatthew G. Knepley       PetscInt       lv;
4773a47d0d45SMatthew G. Knepley 
47749079aca8SVaclav Hapla       /* Positions within verticesAdj form 0-based local vertex numbering;
47759079aca8SVaclav Hapla          we need to shift it by numCells to get correct DAG points (cells go first) */
47769566063dSJacob Faibussowitsch       PetscCall(PetscFindInt(gv, numVerticesAdj, verticesAdj, &lv));
477763a3b9bcSJacob Faibussowitsch       PetscCheck(lv >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Could not find global vertex %" PetscInt_FMT " in local connectivity", gv);
4778961cfab0SVaclav Hapla       cones[c * numCorners + p] = lv + numCells;
4779a47d0d45SMatthew G. Knepley     }
4780a47d0d45SMatthew G. Knepley   }
47812464107aSksagiyam   /* Build point sf */
47829566063dSJacob Faibussowitsch   PetscCall(PetscLayoutCreate(PetscObjectComm((PetscObject)dm), &layout));
47839566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetSize(layout, NVertices));
47849566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetLocalSize(layout, numVertices));
47859566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetBlockSize(layout, 1));
47869566063dSJacob Faibussowitsch   PetscCall(PetscSFCreateByMatchingIndices(layout, numVerticesAdj, verticesAdj, NULL, numCells, numVerticesAdj, verticesAdj, NULL, numCells, vertexSF, &sfPoint));
47879566063dSJacob Faibussowitsch   PetscCall(PetscLayoutDestroy(&layout));
47889566063dSJacob Faibussowitsch   if (!verticesAdjSaved) PetscCall(PetscFree(verticesAdj));
47899566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)sfPoint, "point SF"));
47902464107aSksagiyam   if (dm->sf) {
47912464107aSksagiyam     const char *prefix;
47922464107aSksagiyam 
47939566063dSJacob Faibussowitsch     PetscCall(PetscObjectGetOptionsPrefix((PetscObject)dm->sf, &prefix));
47949566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)sfPoint, prefix));
47952464107aSksagiyam   }
47969566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dm, sfPoint));
47979566063dSJacob Faibussowitsch   PetscCall(PetscSFDestroy(&sfPoint));
47989566063dSJacob Faibussowitsch   if (vertexSF) PetscCall(PetscObjectSetName((PetscObject)(*vertexSF), "Vertex Ownership SF"));
4799a47d0d45SMatthew G. Knepley   /* Fill in the rest of the topology structure */
48009566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
48019566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
48029566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
48033ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4804a47d0d45SMatthew G. Knepley }
4805a47d0d45SMatthew G. Knepley 
4806b09969d6SVaclav Hapla /*@C
4807a1cb98faSBarry Smith   DMPlexBuildCoordinatesFromCellListParallel - Build `DM` coordinates from a list of coordinates for each owned vertex (common mesh generator output)
4808a1cb98faSBarry Smith 
480920f4b53cSBarry Smith   Collective; No Fortran Support
4810b09969d6SVaclav Hapla 
4811b09969d6SVaclav Hapla   Input Parameters:
4812a1cb98faSBarry Smith + dm           - The `DM`
4813b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
4814a1cb98faSBarry Smith . sfVert       - `PetscSF` describing complete vertex ownership
4815b09969d6SVaclav Hapla - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
4816b09969d6SVaclav Hapla 
4817b09969d6SVaclav Hapla   Level: advanced
4818b09969d6SVaclav Hapla 
48191cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildFromCellListParallel()`
4820b09969d6SVaclav Hapla @*/
4821d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildCoordinatesFromCellListParallel(DM dm, PetscInt spaceDim, PetscSF sfVert, const PetscReal vertexCoords[])
4822d71ae5a4SJacob Faibussowitsch {
4823a47d0d45SMatthew G. Knepley   PetscSection coordSection;
4824a47d0d45SMatthew G. Knepley   Vec          coordinates;
4825a47d0d45SMatthew G. Knepley   PetscScalar *coords;
48261edcf0b2SVaclav Hapla   PetscInt     numVertices, numVerticesAdj, coordSize, v, vStart, vEnd;
4827a47d0d45SMatthew G. Knepley 
4828a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
48299566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
48309566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
48311dca8a05SBarry Smith   PetscCheck(vStart >= 0 && vEnd >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "DM is not set up properly. DMPlexBuildFromCellList() should be called first.");
48329566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, spaceDim));
48339566063dSJacob Faibussowitsch   PetscCall(PetscSFGetGraph(sfVert, &numVertices, &numVerticesAdj, NULL, NULL));
48341dca8a05SBarry 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);
48359566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
48369566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
48379566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, spaceDim));
48389566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, vStart, vEnd));
48391edcf0b2SVaclav Hapla   for (v = vStart; v < vEnd; ++v) {
48409566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, spaceDim));
48419566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, spaceDim));
4842a47d0d45SMatthew G. Knepley   }
48439566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
48449566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
48459566063dSJacob Faibussowitsch   PetscCall(VecCreate(PetscObjectComm((PetscObject)dm), &coordinates));
48469566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, spaceDim));
48479566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
48489566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
48499566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
48509566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
4851a47d0d45SMatthew G. Knepley   {
4852a47d0d45SMatthew G. Knepley     MPI_Datatype coordtype;
4853a47d0d45SMatthew G. Knepley 
4854a47d0d45SMatthew G. Knepley     /* Need a temp buffer for coords if we have complex/single */
48559566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_contiguous(spaceDim, MPIU_SCALAR, &coordtype));
48569566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_commit(&coordtype));
485721016a8bSBarry Smith #if defined(PETSC_USE_COMPLEX)
485821016a8bSBarry Smith     {
485921016a8bSBarry Smith       PetscScalar *svertexCoords;
486021016a8bSBarry Smith       PetscInt     i;
48619566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numVertices * spaceDim, &svertexCoords));
48623612f820SVaclav Hapla       for (i = 0; i < numVertices * spaceDim; i++) svertexCoords[i] = vertexCoords[i];
48639566063dSJacob Faibussowitsch       PetscCall(PetscSFBcastBegin(sfVert, coordtype, svertexCoords, coords, MPI_REPLACE));
48649566063dSJacob Faibussowitsch       PetscCall(PetscSFBcastEnd(sfVert, coordtype, svertexCoords, coords, MPI_REPLACE));
48659566063dSJacob Faibussowitsch       PetscCall(PetscFree(svertexCoords));
486621016a8bSBarry Smith     }
486721016a8bSBarry Smith #else
48689566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastBegin(sfVert, coordtype, vertexCoords, coords, MPI_REPLACE));
48699566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastEnd(sfVert, coordtype, vertexCoords, coords, MPI_REPLACE));
487021016a8bSBarry Smith #endif
48719566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_free(&coordtype));
4872a47d0d45SMatthew G. Knepley   }
48739566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
48749566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
48759566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
48769566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
48773ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4878a47d0d45SMatthew G. Knepley }
4879a47d0d45SMatthew G. Knepley 
4880c3edce3dSSatish Balay /*@
4881a1cb98faSBarry Smith   DMPlexCreateFromCellListParallelPetsc - Create distributed `DMPLEX` from a list of vertices for each cell (common mesh generator output)
4882a1cb98faSBarry Smith 
4883a1cb98faSBarry Smith   Collective
4884a47d0d45SMatthew G. Knepley 
4885a47d0d45SMatthew G. Knepley   Input Parameters:
4886a47d0d45SMatthew G. Knepley + comm         - The communicator
4887a47d0d45SMatthew G. Knepley . dim          - The topological dimension of the mesh
4888a47d0d45SMatthew G. Knepley . numCells     - The number of cells owned by this process
4889a1cb98faSBarry Smith . numVertices  - The number of vertices owned by this process, or `PETSC_DECIDE`
4890a1cb98faSBarry Smith . NVertices    - The global number of vertices, or `PETSC_DECIDE`
4891a47d0d45SMatthew G. Knepley . numCorners   - The number of vertices for each cell
4892a47d0d45SMatthew G. Knepley . interpolate  - Flag indicating that intermediate mesh entities (faces, edges) should be created automatically
4893a47d0d45SMatthew G. Knepley . cells        - An array of numCells*numCorners numbers, the global vertex numbers for each cell
4894a47d0d45SMatthew G. Knepley . spaceDim     - The spatial dimension used for coordinates
4895a47d0d45SMatthew G. Knepley - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
4896a47d0d45SMatthew G. Knepley 
4897d8d19677SJose E. Roman   Output Parameters:
4898a1cb98faSBarry Smith + dm          - The `DM`
4899a1cb98faSBarry Smith . vertexSF    - (Optional) `PetscSF` describing complete vertex ownership
490060225df5SJacob Faibussowitsch - verticesAdj - (Optional) vertex adjacency array
4901a47d0d45SMatthew G. Knepley 
4902b09969d6SVaclav Hapla   Level: intermediate
4903a47d0d45SMatthew G. Knepley 
4904a1cb98faSBarry Smith   Notes:
4905a1cb98faSBarry Smith   This function is just a convenient sequence of `DMCreate()`, `DMSetType()`, `DMSetDimension()`,
4906a1cb98faSBarry Smith   `DMPlexBuildFromCellListParallel()`, `DMPlexInterpolate()`, `DMPlexBuildCoordinatesFromCellListParallel()`
4907a1cb98faSBarry Smith 
4908a1cb98faSBarry Smith   See `DMPlexBuildFromCellListParallel()` for an example and details about the topology-related parameters.
4909a1cb98faSBarry Smith 
4910a1cb98faSBarry Smith   See `DMPlexBuildCoordinatesFromCellListParallel()` for details about the geometry-related parameters.
4911a1cb98faSBarry Smith 
49121cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListPetsc()`, `DMPlexBuildFromCellListParallel()`, `DMPlexBuildCoordinatesFromCellListParallel()`, `DMPlexCreateFromDAG()`, `DMPlexCreate()`
4913a47d0d45SMatthew G. Knepley @*/
4914d71ae5a4SJacob 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)
4915d71ae5a4SJacob Faibussowitsch {
4916a47d0d45SMatthew G. Knepley   PetscSF sfVert;
4917a47d0d45SMatthew G. Knepley 
4918a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
49199566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
49209566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
4921a47d0d45SMatthew G. Knepley   PetscValidLogicalCollectiveInt(*dm, dim, 2);
4922064a246eSJacob Faibussowitsch   PetscValidLogicalCollectiveInt(*dm, spaceDim, 9);
49239566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
49249566063dSJacob Faibussowitsch   PetscCall(DMPlexBuildFromCellListParallel(*dm, numCells, numVertices, NVertices, numCorners, cells, &sfVert, verticesAdj));
4925a47d0d45SMatthew G. Knepley   if (interpolate) {
49265fd9971aSMatthew G. Knepley     DM idm;
4927a47d0d45SMatthew G. Knepley 
49289566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
49299566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
4930a47d0d45SMatthew G. Knepley     *dm = idm;
4931a47d0d45SMatthew G. Knepley   }
49329566063dSJacob Faibussowitsch   PetscCall(DMPlexBuildCoordinatesFromCellListParallel(*dm, spaceDim, sfVert, vertexCoords));
493318d54ad4SMichael Lange   if (vertexSF) *vertexSF = sfVert;
49349566063dSJacob Faibussowitsch   else PetscCall(PetscSFDestroy(&sfVert));
49353ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4936a47d0d45SMatthew G. Knepley }
4937a47d0d45SMatthew G. Knepley 
4938b09969d6SVaclav Hapla /*@C
4939a1cb98faSBarry Smith   DMPlexBuildFromCellList - Build `DMPLEX` topology from a list of vertices for each cell (common mesh generator output)
4940a1cb98faSBarry Smith 
494120f4b53cSBarry Smith   Collective; No Fortran Support
49429298eaa6SMatthew G Knepley 
49439298eaa6SMatthew G Knepley   Input Parameters:
4944a1cb98faSBarry Smith + dm          - The `DM`
4945b09969d6SVaclav Hapla . numCells    - The number of cells owned by this process
4946a1cb98faSBarry Smith . numVertices - The number of vertices owned by this process, or `PETSC_DETERMINE`
49479298eaa6SMatthew G Knepley . numCorners  - The number of vertices for each cell
49485e488331SVaclav Hapla - cells       - An array of numCells*numCorners numbers, the global vertex numbers for each cell
49499298eaa6SMatthew G Knepley 
4950b09969d6SVaclav Hapla   Level: advanced
49519298eaa6SMatthew G Knepley 
4952b09969d6SVaclav Hapla   Notes:
4953b09969d6SVaclav Hapla   Two triangles sharing a face
4954a1cb98faSBarry Smith .vb
49559298eaa6SMatthew G Knepley 
4956a1cb98faSBarry Smith         2
4957a1cb98faSBarry Smith       / | \
4958a1cb98faSBarry Smith      /  |  \
4959a1cb98faSBarry Smith     /   |   \
4960a1cb98faSBarry Smith    0  0 | 1  3
4961a1cb98faSBarry Smith     \   |   /
4962a1cb98faSBarry Smith      \  |  /
4963a1cb98faSBarry Smith       \ | /
4964a1cb98faSBarry Smith         1
4965a1cb98faSBarry Smith .ve
4966a1cb98faSBarry Smith   would have input
4967a1cb98faSBarry Smith .vb
4968a1cb98faSBarry Smith   numCells = 2, numVertices = 4
4969a1cb98faSBarry Smith   cells = [0 1 2  1 3 2]
4970a1cb98faSBarry Smith .ve
4971a1cb98faSBarry Smith   which would result in the `DMPLEX`
4972a1cb98faSBarry Smith .vb
4973a1cb98faSBarry Smith 
4974a1cb98faSBarry Smith         4
4975a1cb98faSBarry Smith       / | \
4976a1cb98faSBarry Smith      /  |  \
4977a1cb98faSBarry Smith     /   |   \
4978a1cb98faSBarry Smith    2  0 | 1  5
4979a1cb98faSBarry Smith     \   |   /
4980a1cb98faSBarry Smith      \  |  /
4981a1cb98faSBarry Smith       \ | /
4982a1cb98faSBarry Smith         3
4983a1cb98faSBarry Smith .ve
4984a1cb98faSBarry Smith 
4985a1cb98faSBarry Smith   If numVertices is `PETSC_DETERMINE`, it is computed by PETSc as the maximum vertex index in cells + 1.
498625b6865aSVaclav Hapla 
49871cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildFromCellListParallel()`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromCellListPetsc()`
4988b09969d6SVaclav Hapla @*/
4989d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildFromCellList(DM dm, PetscInt numCells, PetscInt numVertices, PetscInt numCorners, const PetscInt cells[])
4990d71ae5a4SJacob Faibussowitsch {
4991961cfab0SVaclav Hapla   PetscInt *cones, c, p, dim;
4992b09969d6SVaclav Hapla 
4993b09969d6SVaclav Hapla   PetscFunctionBegin;
49949566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
49959566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
499625b6865aSVaclav Hapla   /* Get/check global number of vertices */
499725b6865aSVaclav Hapla   {
499825b6865aSVaclav Hapla     PetscInt       NVerticesInCells, i;
499925b6865aSVaclav Hapla     const PetscInt len = numCells * numCorners;
500025b6865aSVaclav Hapla 
500125b6865aSVaclav Hapla     /* NVerticesInCells = max(cells) + 1 */
500225b6865aSVaclav Hapla     NVerticesInCells = PETSC_MIN_INT;
50039371c9d4SSatish Balay     for (i = 0; i < len; i++)
50049371c9d4SSatish Balay       if (cells[i] > NVerticesInCells) NVerticesInCells = cells[i];
500525b6865aSVaclav Hapla     ++NVerticesInCells;
500625b6865aSVaclav Hapla 
500725b6865aSVaclav Hapla     if (numVertices == PETSC_DECIDE) numVertices = NVerticesInCells;
50089371c9d4SSatish Balay     else
50099371c9d4SSatish 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);
501025b6865aSVaclav Hapla   }
50119566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
501248a46eb9SPierre Jolivet   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, numCorners));
50139566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm));
50149566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCones(dm, &cones));
5015b09969d6SVaclav Hapla   for (c = 0; c < numCells; ++c) {
5016ad540459SPierre Jolivet     for (p = 0; p < numCorners; ++p) cones[c * numCorners + p] = cells[c * numCorners + p] + numCells;
5017b09969d6SVaclav Hapla   }
50189566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
50199566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
50209566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
50213ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5022b09969d6SVaclav Hapla }
5023b09969d6SVaclav Hapla 
5024b09969d6SVaclav Hapla /*@C
5025a1cb98faSBarry Smith   DMPlexBuildCoordinatesFromCellList - Build `DM` coordinates from a list of coordinates for each owned vertex (common mesh generator output)
5026a1cb98faSBarry Smith 
502720f4b53cSBarry Smith   Collective; No Fortran Support
5028b09969d6SVaclav Hapla 
5029b09969d6SVaclav Hapla   Input Parameters:
5030a1cb98faSBarry Smith + dm           - The `DM`
5031b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
5032b09969d6SVaclav Hapla - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
5033b09969d6SVaclav Hapla 
5034b09969d6SVaclav Hapla   Level: advanced
5035b09969d6SVaclav Hapla 
50361cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildCoordinatesFromCellListParallel()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexBuildFromCellList()`
5037b09969d6SVaclav Hapla @*/
5038d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildCoordinatesFromCellList(DM dm, PetscInt spaceDim, const PetscReal vertexCoords[])
5039d71ae5a4SJacob Faibussowitsch {
5040b09969d6SVaclav Hapla   PetscSection coordSection;
5041b09969d6SVaclav Hapla   Vec          coordinates;
5042b09969d6SVaclav Hapla   DM           cdm;
5043b09969d6SVaclav Hapla   PetscScalar *coords;
50441edcf0b2SVaclav Hapla   PetscInt     v, vStart, vEnd, d;
5045b09969d6SVaclav Hapla 
5046b09969d6SVaclav Hapla   PetscFunctionBegin;
50479566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
50489566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
50491dca8a05SBarry Smith   PetscCheck(vStart >= 0 && vEnd >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "DM is not set up properly. DMPlexBuildFromCellList() should be called first.");
50509566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, spaceDim));
50519566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
50529566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
50539566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, spaceDim));
50549566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, vStart, vEnd));
50551edcf0b2SVaclav Hapla   for (v = vStart; v < vEnd; ++v) {
50569566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, spaceDim));
50579566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, spaceDim));
5058b09969d6SVaclav Hapla   }
50599566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
5060b09969d6SVaclav Hapla 
50619566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dm, &cdm));
50629566063dSJacob Faibussowitsch   PetscCall(DMCreateLocalVector(cdm, &coordinates));
50639566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, spaceDim));
50649566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
50659566063dSJacob Faibussowitsch   PetscCall(VecGetArrayWrite(coordinates, &coords));
50661edcf0b2SVaclav Hapla   for (v = 0; v < vEnd - vStart; ++v) {
5067ad540459SPierre Jolivet     for (d = 0; d < spaceDim; ++d) coords[v * spaceDim + d] = vertexCoords[v * spaceDim + d];
5068b09969d6SVaclav Hapla   }
50699566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayWrite(coordinates, &coords));
50709566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
50719566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
50729566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
50733ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5074b09969d6SVaclav Hapla }
5075b09969d6SVaclav Hapla 
5076b09969d6SVaclav Hapla /*@
5077a1cb98faSBarry Smith   DMPlexCreateFromCellListPetsc - Create `DMPLEX` from a list of vertices for each cell (common mesh generator output), but only process 0 takes in the input
50783df08285SMatthew G. Knepley 
5079a1cb98faSBarry Smith   Collective
5080b09969d6SVaclav Hapla 
5081b09969d6SVaclav Hapla   Input Parameters:
5082b09969d6SVaclav Hapla + comm         - The communicator
5083b09969d6SVaclav Hapla . dim          - The topological dimension of the mesh
50843df08285SMatthew G. Knepley . numCells     - The number of cells, only on process 0
5085a1cb98faSBarry Smith . numVertices  - The number of vertices owned by this process, or `PETSC_DECIDE`, only on process 0
50863df08285SMatthew G. Knepley . numCorners   - The number of vertices for each cell, only on process 0
5087b09969d6SVaclav Hapla . interpolate  - Flag indicating that intermediate mesh entities (faces, edges) should be created automatically
50883df08285SMatthew G. Knepley . cells        - An array of numCells*numCorners numbers, the vertices for each cell, only on process 0
5089b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
50903df08285SMatthew G. Knepley - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex, only on process 0
5091b09969d6SVaclav Hapla 
5092b09969d6SVaclav Hapla   Output Parameter:
5093a1cb98faSBarry Smith . dm - The `DM`, which only has points on process 0
509425b6865aSVaclav Hapla 
5095b09969d6SVaclav Hapla   Level: intermediate
5096b09969d6SVaclav Hapla 
5097a1cb98faSBarry Smith   Notes:
5098a1cb98faSBarry Smith   This function is just a convenient sequence of `DMCreate()`, `DMSetType()`, `DMSetDimension()`, `DMPlexBuildFromCellList()`,
5099a1cb98faSBarry Smith   `DMPlexInterpolate()`, `DMPlexBuildCoordinatesFromCellList()`
5100a1cb98faSBarry Smith 
5101a1cb98faSBarry Smith   See `DMPlexBuildFromCellList()` for an example and details about the topology-related parameters.
5102a1cb98faSBarry Smith   See `DMPlexBuildCoordinatesFromCellList()` for details about the geometry-related parameters.
5103a1cb98faSBarry Smith   See `DMPlexCreateFromCellListParallelPetsc()` for parallel input
5104a1cb98faSBarry Smith 
51051cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildFromCellList()`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromDAG()`, `DMPlexCreate()`
51069298eaa6SMatthew G Knepley @*/
5107d71ae5a4SJacob 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)
5108d71ae5a4SJacob Faibussowitsch {
51093df08285SMatthew G. Knepley   PetscMPIInt rank;
51109298eaa6SMatthew G Knepley 
51119298eaa6SMatthew G Knepley   PetscFunctionBegin;
511228b400f6SJacob 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.");
51139566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
51149566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
51159566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
51169566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
5117c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildFromCellList(*dm, numCells, numVertices, numCorners, cells));
51189566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildFromCellList(*dm, 0, 0, 0, NULL));
51199298eaa6SMatthew G Knepley   if (interpolate) {
51205fd9971aSMatthew G. Knepley     DM idm;
51219298eaa6SMatthew G Knepley 
51229566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
51239566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
51249298eaa6SMatthew G Knepley     *dm = idm;
51259298eaa6SMatthew G Knepley   }
5126c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildCoordinatesFromCellList(*dm, spaceDim, vertexCoords));
51279566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildCoordinatesFromCellList(*dm, spaceDim, NULL));
51283ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
51299298eaa6SMatthew G Knepley }
51309298eaa6SMatthew G Knepley 
5131939f6067SMatthew G. Knepley /*@
513220f4b53cSBarry Smith   DMPlexCreateFromDAG - This takes as input the adjacency-list representation of the Directed Acyclic Graph (Hasse Diagram) encoding a mesh, and produces a `DM`
5133939f6067SMatthew G. Knepley 
5134939f6067SMatthew G. Knepley   Input Parameters:
513520f4b53cSBarry Smith + dm               - The empty `DM` object, usually from `DMCreate()` and `DMSetDimension()`
5136939f6067SMatthew G. Knepley . depth            - The depth of the DAG
513720f4b53cSBarry Smith . numPoints        - Array of size depth + 1 containing the number of points at each `depth`
5138939f6067SMatthew G. Knepley . coneSize         - The cone size of each point
5139939f6067SMatthew G. Knepley . cones            - The concatenation of the cone points for each point, the cone list must be oriented correctly for each point
5140939f6067SMatthew G. Knepley . coneOrientations - The orientation of each cone point
514120f4b53cSBarry Smith - vertexCoords     - An array of `numPoints`[0]*spacedim numbers representing the coordinates of each vertex, with spacedim the value set via `DMSetCoordinateDim()`
5142939f6067SMatthew G. Knepley 
5143939f6067SMatthew G. Knepley   Output Parameter:
514420f4b53cSBarry Smith . dm - The `DM`
514520f4b53cSBarry Smith 
514620f4b53cSBarry Smith   Level: advanced
5147939f6067SMatthew G. Knepley 
5148a1cb98faSBarry Smith   Note:
5149a1cb98faSBarry Smith   Two triangles sharing a face would have input
5150a1cb98faSBarry Smith .vb
5151a1cb98faSBarry Smith   depth = 1, numPoints = [4 2], coneSize = [3 3 0 0 0 0]
5152a1cb98faSBarry Smith   cones = [2 3 4  3 5 4], coneOrientations = [0 0 0  0 0 0]
5153a1cb98faSBarry Smith  vertexCoords = [-1.0 0.0  0.0 -1.0  0.0 1.0  1.0 0.0]
5154a1cb98faSBarry Smith .ve
5155939f6067SMatthew G. Knepley   which would result in the DMPlex
5156a1cb98faSBarry Smith .vb
5157a1cb98faSBarry Smith         4
5158a1cb98faSBarry Smith       / | \
5159a1cb98faSBarry Smith      /  |  \
5160a1cb98faSBarry Smith     /   |   \
5161a1cb98faSBarry Smith    2  0 | 1  5
5162a1cb98faSBarry Smith     \   |   /
5163a1cb98faSBarry Smith      \  |  /
5164a1cb98faSBarry Smith       \ | /
5165a1cb98faSBarry Smith         3
5166a1cb98faSBarry Smith .ve
5167a1cb98faSBarry Smith   Notice that all points are numbered consecutively, unlike `DMPlexCreateFromCellListPetsc()`
5168939f6067SMatthew G. Knepley 
51691cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`
5170939f6067SMatthew G. Knepley @*/
5171d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateFromDAG(DM dm, PetscInt depth, const PetscInt numPoints[], const PetscInt coneSize[], const PetscInt cones[], const PetscInt coneOrientations[], const PetscScalar vertexCoords[])
5172d71ae5a4SJacob Faibussowitsch {
51739298eaa6SMatthew G Knepley   Vec          coordinates;
51749298eaa6SMatthew G Knepley   PetscSection coordSection;
51759298eaa6SMatthew G Knepley   PetscScalar *coords;
5176811e8653SToby Isaac   PetscInt     coordSize, firstVertex = -1, pStart = 0, pEnd = 0, p, v, dim, dimEmbed, d, off;
51779298eaa6SMatthew G Knepley 
51789298eaa6SMatthew G Knepley   PetscFunctionBegin;
51799566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
51809566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &dimEmbed));
518163a3b9bcSJacob Faibussowitsch   PetscCheck(dimEmbed >= dim, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Embedding dimension %" PetscInt_FMT " cannot be less than intrinsic dimension %" PetscInt_FMT, dimEmbed, dim);
51829298eaa6SMatthew G Knepley   for (d = 0; d <= depth; ++d) pEnd += numPoints[d];
51839566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, pStart, pEnd));
51849298eaa6SMatthew G Knepley   for (p = pStart; p < pEnd; ++p) {
51859566063dSJacob Faibussowitsch     PetscCall(DMPlexSetConeSize(dm, p, coneSize[p - pStart]));
5186ad540459SPierre Jolivet     if (firstVertex < 0 && !coneSize[p - pStart]) firstVertex = p - pStart;
518797e052ccSToby Isaac   }
51881dca8a05SBarry Smith   PetscCheck(firstVertex >= 0 || !numPoints[0], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Expected %" PetscInt_FMT " vertices but could not find any", numPoints[0]);
51899566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm)); /* Allocate space for cones */
51909298eaa6SMatthew G Knepley   for (p = pStart, off = 0; p < pEnd; off += coneSize[p - pStart], ++p) {
51919566063dSJacob Faibussowitsch     PetscCall(DMPlexSetCone(dm, p, &cones[off]));
51929566063dSJacob Faibussowitsch     PetscCall(DMPlexSetConeOrientation(dm, p, &coneOrientations[off]));
51939298eaa6SMatthew G Knepley   }
51949566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
51959566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
51969298eaa6SMatthew G Knepley   /* Build coordinates */
51979566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
51989566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
51999566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dimEmbed));
52009566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numPoints[0]));
52019298eaa6SMatthew G Knepley   for (v = firstVertex; v < firstVertex + numPoints[0]; ++v) {
52029566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, dimEmbed));
52039566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dimEmbed));
52049298eaa6SMatthew G Knepley   }
52059566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
52069566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
52079566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
52089566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
52099566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
52109566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, dimEmbed));
52119566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
52129318fe57SMatthew G. Knepley   if (vertexCoords) {
52139566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
52149298eaa6SMatthew G Knepley     for (v = 0; v < numPoints[0]; ++v) {
52159298eaa6SMatthew G Knepley       PetscInt off;
52169298eaa6SMatthew G Knepley 
52179566063dSJacob Faibussowitsch       PetscCall(PetscSectionGetOffset(coordSection, v + firstVertex, &off));
5218ad540459SPierre Jolivet       for (d = 0; d < dimEmbed; ++d) coords[off + d] = vertexCoords[v * dimEmbed + d];
52199298eaa6SMatthew G Knepley     }
52209318fe57SMatthew G. Knepley   }
52219566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
52229566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
52239566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
52243ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
52259298eaa6SMatthew G Knepley }
52268415267dSToby Isaac 
5227a4e35b19SJacob Faibussowitsch /*
5228a1cb98faSBarry Smith   DMPlexCreateCellVertexFromFile - Create a `DMPLEX` mesh from a simple cell-vertex file.
5229a1cb98faSBarry Smith 
5230a1cb98faSBarry Smith   Collective
52318ca92349SMatthew G. Knepley 
52328ca92349SMatthew G. Knepley + comm        - The MPI communicator
52338ca92349SMatthew G. Knepley . filename    - Name of the .dat file
52348ca92349SMatthew G. Knepley - interpolate - Create faces and edges in the mesh
52358ca92349SMatthew G. Knepley 
52368ca92349SMatthew G. Knepley   Output Parameter:
5237a1cb98faSBarry Smith . dm  - The `DM` object representing the mesh
52388ca92349SMatthew G. Knepley 
52398ca92349SMatthew G. Knepley   Level: beginner
52408ca92349SMatthew G. Knepley 
5241a1cb98faSBarry Smith   Note:
5242a1cb98faSBarry Smith   The format is the simplest possible:
5243a1cb98faSBarry Smith .vb
5244a1cb98faSBarry Smith   Ne
5245a1cb98faSBarry Smith   v0 v1 ... vk
5246a1cb98faSBarry Smith   Nv
5247a1cb98faSBarry Smith   x y z marker
5248a1cb98faSBarry Smith .ve
5249a1cb98faSBarry Smith 
5250a1cb98faSBarry Smith   Developer Note:
5251a1cb98faSBarry Smith   Should use a `PetscViewer` not a filename
5252a1cb98faSBarry Smith 
52531cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromFile()`, `DMPlexCreateMedFromFile()`, `DMPlexCreateGmsh()`, `DMPlexCreate()`
5254a4e35b19SJacob Faibussowitsch */
5255ff6a9541SJacob Faibussowitsch static PetscErrorCode DMPlexCreateCellVertexFromFile(MPI_Comm comm, const char filename[], PetscBool interpolate, DM *dm)
5256d71ae5a4SJacob Faibussowitsch {
52578ca92349SMatthew G. Knepley   DMLabel      marker;
52588ca92349SMatthew G. Knepley   PetscViewer  viewer;
52598ca92349SMatthew G. Knepley   Vec          coordinates;
52608ca92349SMatthew G. Knepley   PetscSection coordSection;
52618ca92349SMatthew G. Knepley   PetscScalar *coords;
52628ca92349SMatthew G. Knepley   char         line[PETSC_MAX_PATH_LEN];
52638ca92349SMatthew G. Knepley   PetscInt     dim = 3, cdim = 3, coordSize, v, c, d;
52648ca92349SMatthew G. Knepley   PetscMPIInt  rank;
5265f8d5e320SMatthew G. Knepley   int          snum, Nv, Nc, Ncn, Nl;
52668ca92349SMatthew G. Knepley 
52678ca92349SMatthew G. Knepley   PetscFunctionBegin;
52689566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
52699566063dSJacob Faibussowitsch   PetscCall(PetscViewerCreate(comm, &viewer));
52709566063dSJacob Faibussowitsch   PetscCall(PetscViewerSetType(viewer, PETSCVIEWERASCII));
52719566063dSJacob Faibussowitsch   PetscCall(PetscViewerFileSetMode(viewer, FILE_MODE_READ));
52729566063dSJacob Faibussowitsch   PetscCall(PetscViewerFileSetName(viewer, filename));
5273dd400576SPatrick Sanan   if (rank == 0) {
52749566063dSJacob Faibussowitsch     PetscCall(PetscViewerRead(viewer, line, 4, NULL, PETSC_STRING));
5275f8d5e320SMatthew G. Knepley     snum = sscanf(line, "%d %d %d %d", &Nc, &Nv, &Ncn, &Nl);
527608401ef6SPierre Jolivet     PetscCheck(snum == 4, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
527725ce1634SJed Brown   } else {
5278f8d5e320SMatthew G. Knepley     Nc = Nv = Ncn = Nl = 0;
52798ca92349SMatthew G. Knepley   }
52809566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
52819566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
52829566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(*dm, 0, Nc + Nv));
52839566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
52849566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(*dm, cdim));
52858ca92349SMatthew G. Knepley   /* Read topology */
5286dd400576SPatrick Sanan   if (rank == 0) {
5287f8d5e320SMatthew G. Knepley     char     format[PETSC_MAX_PATH_LEN];
5288f8d5e320SMatthew G. Knepley     PetscInt cone[8];
52898ca92349SMatthew G. Knepley     int      vbuf[8], v;
52908ca92349SMatthew G. Knepley 
52919371c9d4SSatish Balay     for (c = 0; c < Ncn; ++c) {
52929371c9d4SSatish Balay       format[c * 3 + 0] = '%';
52939371c9d4SSatish Balay       format[c * 3 + 1] = 'd';
52949371c9d4SSatish Balay       format[c * 3 + 2] = ' ';
52959371c9d4SSatish Balay     }
5296f8d5e320SMatthew G. Knepley     format[Ncn * 3 - 1] = '\0';
52979566063dSJacob Faibussowitsch     for (c = 0; c < Nc; ++c) PetscCall(DMPlexSetConeSize(*dm, c, Ncn));
52989566063dSJacob Faibussowitsch     PetscCall(DMSetUp(*dm));
52998ca92349SMatthew G. Knepley     for (c = 0; c < Nc; ++c) {
53009566063dSJacob Faibussowitsch       PetscCall(PetscViewerRead(viewer, line, Ncn, NULL, PETSC_STRING));
5301f8d5e320SMatthew G. Knepley       switch (Ncn) {
5302d71ae5a4SJacob Faibussowitsch       case 2:
5303d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1]);
5304d71ae5a4SJacob Faibussowitsch         break;
5305d71ae5a4SJacob Faibussowitsch       case 3:
5306d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2]);
5307d71ae5a4SJacob Faibussowitsch         break;
5308d71ae5a4SJacob Faibussowitsch       case 4:
5309d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3]);
5310d71ae5a4SJacob Faibussowitsch         break;
5311d71ae5a4SJacob Faibussowitsch       case 6:
5312d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3], &vbuf[4], &vbuf[5]);
5313d71ae5a4SJacob Faibussowitsch         break;
5314d71ae5a4SJacob Faibussowitsch       case 8:
5315d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3], &vbuf[4], &vbuf[5], &vbuf[6], &vbuf[7]);
5316d71ae5a4SJacob Faibussowitsch         break;
5317d71ae5a4SJacob Faibussowitsch       default:
5318d71ae5a4SJacob Faibussowitsch         SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "No cell shape with %d vertices", Ncn);
5319f8d5e320SMatthew G. Knepley       }
532008401ef6SPierre Jolivet       PetscCheck(snum == Ncn, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
5321f8d5e320SMatthew G. Knepley       for (v = 0; v < Ncn; ++v) cone[v] = vbuf[v] + Nc;
53228ca92349SMatthew G. Knepley       /* Hexahedra are inverted */
5323f8d5e320SMatthew G. Knepley       if (Ncn == 8) {
53248ca92349SMatthew G. Knepley         PetscInt tmp = cone[1];
53258ca92349SMatthew G. Knepley         cone[1]      = cone[3];
53268ca92349SMatthew G. Knepley         cone[3]      = tmp;
53278ca92349SMatthew G. Knepley       }
53289566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCone(*dm, c, cone));
53298ca92349SMatthew G. Knepley     }
53308ca92349SMatthew G. Knepley   }
53319566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(*dm));
53329566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(*dm));
53338ca92349SMatthew G. Knepley   /* Read coordinates */
53349566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(*dm, &coordSection));
53359566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
53369566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, cdim));
53379566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, Nc, Nc + Nv));
53388ca92349SMatthew G. Knepley   for (v = Nc; v < Nc + Nv; ++v) {
53399566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, cdim));
53409566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, cdim));
53418ca92349SMatthew G. Knepley   }
53429566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
53439566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
53449566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
53459566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
53469566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
53479566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, cdim));
53489566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
53499566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
5350dd400576SPatrick Sanan   if (rank == 0) {
5351f8d5e320SMatthew G. Knepley     char   format[PETSC_MAX_PATH_LEN];
53528ca92349SMatthew G. Knepley     double x[3];
5353f8d5e320SMatthew G. Knepley     int    l, val[3];
53548ca92349SMatthew G. Knepley 
5355f8d5e320SMatthew G. Knepley     if (Nl) {
53569371c9d4SSatish Balay       for (l = 0; l < Nl; ++l) {
53579371c9d4SSatish Balay         format[l * 3 + 0] = '%';
53589371c9d4SSatish Balay         format[l * 3 + 1] = 'd';
53599371c9d4SSatish Balay         format[l * 3 + 2] = ' ';
53609371c9d4SSatish Balay       }
5361f8d5e320SMatthew G. Knepley       format[Nl * 3 - 1] = '\0';
53629566063dSJacob Faibussowitsch       PetscCall(DMCreateLabel(*dm, "marker"));
53639566063dSJacob Faibussowitsch       PetscCall(DMGetLabel(*dm, "marker", &marker));
5364f8d5e320SMatthew G. Knepley     }
53658ca92349SMatthew G. Knepley     for (v = 0; v < Nv; ++v) {
53669566063dSJacob Faibussowitsch       PetscCall(PetscViewerRead(viewer, line, 3 + Nl, NULL, PETSC_STRING));
5367f8d5e320SMatthew G. Knepley       snum = sscanf(line, "%lg %lg %lg", &x[0], &x[1], &x[2]);
536808401ef6SPierre Jolivet       PetscCheck(snum == 3, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
5369f8d5e320SMatthew G. Knepley       switch (Nl) {
5370d71ae5a4SJacob Faibussowitsch       case 0:
5371d71ae5a4SJacob Faibussowitsch         snum = 0;
5372d71ae5a4SJacob Faibussowitsch         break;
5373d71ae5a4SJacob Faibussowitsch       case 1:
5374d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0]);
5375d71ae5a4SJacob Faibussowitsch         break;
5376d71ae5a4SJacob Faibussowitsch       case 2:
5377d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0], &val[1]);
5378d71ae5a4SJacob Faibussowitsch         break;
5379d71ae5a4SJacob Faibussowitsch       case 3:
5380d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0], &val[1], &val[2]);
5381d71ae5a4SJacob Faibussowitsch         break;
5382d71ae5a4SJacob Faibussowitsch       default:
5383d71ae5a4SJacob Faibussowitsch         SETERRQ(PETSC_COMM_SELF, PETSC_ERR_SUP, "Request support for %d labels", Nl);
5384f8d5e320SMatthew G. Knepley       }
538508401ef6SPierre Jolivet       PetscCheck(snum == Nl, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
53868ca92349SMatthew G. Knepley       for (d = 0; d < cdim; ++d) coords[v * cdim + d] = x[d];
53879566063dSJacob Faibussowitsch       for (l = 0; l < Nl; ++l) PetscCall(DMLabelSetValue(marker, v + Nc, val[l]));
53888ca92349SMatthew G. Knepley     }
53898ca92349SMatthew G. Knepley   }
53909566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
53919566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(*dm, coordinates));
53929566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
53939566063dSJacob Faibussowitsch   PetscCall(PetscViewerDestroy(&viewer));
53948ca92349SMatthew G. Knepley   if (interpolate) {
53958ca92349SMatthew G. Knepley     DM      idm;
53968ca92349SMatthew G. Knepley     DMLabel bdlabel;
53978ca92349SMatthew G. Knepley 
53989566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
53999566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
54008ca92349SMatthew G. Knepley     *dm = idm;
54018ca92349SMatthew G. Knepley 
5402f8d5e320SMatthew G. Knepley     if (!Nl) {
54039566063dSJacob Faibussowitsch       PetscCall(DMCreateLabel(*dm, "marker"));
54049566063dSJacob Faibussowitsch       PetscCall(DMGetLabel(*dm, "marker", &bdlabel));
54059566063dSJacob Faibussowitsch       PetscCall(DMPlexMarkBoundaryFaces(*dm, PETSC_DETERMINE, bdlabel));
54069566063dSJacob Faibussowitsch       PetscCall(DMPlexLabelComplete(*dm, bdlabel));
54078ca92349SMatthew G. Knepley     }
5408f8d5e320SMatthew G. Knepley   }
54093ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
54108ca92349SMatthew G. Knepley }
54118ca92349SMatthew G. Knepley 
54128ca92349SMatthew G. Knepley /*@C
5413a1cb98faSBarry Smith   DMPlexCreateFromFile - This takes a filename and produces a `DM`
5414a1cb98faSBarry Smith 
5415a1cb98faSBarry Smith   Collective
5416ca522641SMatthew G. Knepley 
5417ca522641SMatthew G. Knepley   Input Parameters:
5418ca522641SMatthew G. Knepley + comm        - The communicator
5419ca522641SMatthew G. Knepley . filename    - A file name
5420a1cb98faSBarry Smith . plexname    - The object name of the resulting `DM`, also used for intra-datafile lookup by some formats
5421ca522641SMatthew G. Knepley - interpolate - Flag to create intermediate mesh pieces (edges, faces)
5422ca522641SMatthew G. Knepley 
5423ca522641SMatthew G. Knepley   Output Parameter:
5424a1cb98faSBarry Smith . dm - The `DM`
5425ca522641SMatthew G. Knepley 
5426a1cb98faSBarry Smith   Options Database Key:
5427a1cb98faSBarry Smith . -dm_plex_create_from_hdf5_xdmf - use the `PETSC_VIEWER_HDF5_XDMF` format for reading HDF5
542802ef0d99SVaclav Hapla 
542937fdd005SBarry Smith   Use `-dm_plex_create_ prefix` to pass options to the internal `PetscViewer`, e.g.
5430bca97951SVaclav Hapla $ -dm_plex_create_viewer_hdf5_collective
5431bca97951SVaclav Hapla 
5432ca522641SMatthew G. Knepley   Level: beginner
5433ca522641SMatthew G. Knepley 
5434a1cb98faSBarry Smith   Notes:
5435a1cb98faSBarry Smith   Using `PETSCVIEWERHDF5` type with `PETSC_VIEWER_HDF5_PETSC` format, one can save multiple `DMPLEX`
5436a1cb98faSBarry Smith   meshes in a single HDF5 file. This in turn requires one to name the `DMPLEX` object with `PetscObjectSetName()`
5437a1cb98faSBarry Smith   before saving it with `DMView()` and before loading it with `DMLoad()` for identification of the mesh object.
5438a1cb98faSBarry Smith   The input parameter name is thus used to name the `DMPLEX` object when `DMPlexCreateFromFile()` internally
5439a1cb98faSBarry Smith   calls `DMLoad()`. Currently, name is ignored for other viewer types and/or formats.
5440a1cb98faSBarry Smith 
54411cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromDAG()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`, `PetscObjectSetName()`, `DMView()`, `DMLoad()`
5442ca522641SMatthew G. Knepley @*/
5443d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateFromFile(MPI_Comm comm, const char filename[], const char plexname[], PetscBool interpolate, DM *dm)
5444d71ae5a4SJacob Faibussowitsch {
5445ef3a5affSJacob Faibussowitsch   const char  extGmsh[]      = ".msh";
5446ef3a5affSJacob Faibussowitsch   const char  extGmsh2[]     = ".msh2";
5447ef3a5affSJacob Faibussowitsch   const char  extGmsh4[]     = ".msh4";
5448ef3a5affSJacob Faibussowitsch   const char  extCGNS[]      = ".cgns";
5449ef3a5affSJacob Faibussowitsch   const char  extExodus[]    = ".exo";
5450ef3a5affSJacob Faibussowitsch   const char  extExodus_e[]  = ".e";
5451ef3a5affSJacob Faibussowitsch   const char  extGenesis[]   = ".gen";
5452ef3a5affSJacob Faibussowitsch   const char  extFluent[]    = ".cas";
5453ef3a5affSJacob Faibussowitsch   const char  extHDF5[]      = ".h5";
54546f2c871aSStefano Zampini   const char  extXDMFHDF5[]  = ".xdmf.h5";
5455ef3a5affSJacob Faibussowitsch   const char  extMed[]       = ".med";
5456ef3a5affSJacob Faibussowitsch   const char  extPLY[]       = ".ply";
5457ef3a5affSJacob Faibussowitsch   const char  extEGADSLite[] = ".egadslite";
5458ef3a5affSJacob Faibussowitsch   const char  extEGADS[]     = ".egads";
5459ef3a5affSJacob Faibussowitsch   const char  extIGES[]      = ".igs";
5460ef3a5affSJacob Faibussowitsch   const char  extSTEP[]      = ".stp";
5461ef3a5affSJacob Faibussowitsch   const char  extCV[]        = ".dat";
5462ca522641SMatthew G. Knepley   size_t      len;
54636f2c871aSStefano Zampini   PetscBool   isGmsh, isGmsh2, isGmsh4, isCGNS, isExodus, isGenesis, isFluent, isHDF5, isMed, isPLY, isEGADSLite, isEGADS, isIGES, isSTEP, isCV, isXDMFHDF5;
5464ca522641SMatthew G. Knepley   PetscMPIInt rank;
5465ca522641SMatthew G. Knepley 
5466ca522641SMatthew G. Knepley   PetscFunctionBegin;
54674f572ea9SToby Isaac   PetscAssertPointer(filename, 2);
54684f572ea9SToby Isaac   if (plexname) PetscAssertPointer(plexname, 3);
54694f572ea9SToby Isaac   PetscAssertPointer(dm, 5);
54709566063dSJacob Faibussowitsch   PetscCall(DMInitializePackage());
54719566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_CreateFromFile, 0, 0, 0, 0));
54729566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
54739566063dSJacob Faibussowitsch   PetscCall(PetscStrlen(filename, &len));
547428b400f6SJacob Faibussowitsch   PetscCheck(len, comm, PETSC_ERR_ARG_WRONG, "Filename must be a valid path");
5475ef3a5affSJacob Faibussowitsch 
54769371c9d4SSatish Balay #define CheckExtension(extension__, is_extension__) \
54779371c9d4SSatish Balay   do { \
5478274aaeaaSJacob Faibussowitsch     PetscAssert(sizeof(extension__), comm, PETSC_ERR_PLIB, "Zero-size extension: %s", extension__); \
5479274aaeaaSJacob Faibussowitsch     /* don't count the null-terminator at the end */ \
5480274aaeaaSJacob Faibussowitsch     const size_t ext_len = sizeof(extension__) - 1; \
5481274aaeaaSJacob Faibussowitsch     if (len < ext_len) { \
5482ef3a5affSJacob Faibussowitsch       is_extension__ = PETSC_FALSE; \
5483ef3a5affSJacob Faibussowitsch     } else { \
5484274aaeaaSJacob Faibussowitsch       PetscCall(PetscStrncmp(filename + len - ext_len, extension__, ext_len, &is_extension__)); \
5485ef3a5affSJacob Faibussowitsch     } \
5486ef3a5affSJacob Faibussowitsch   } while (0)
5487ef3a5affSJacob Faibussowitsch 
5488ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh, isGmsh);
5489ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh2, isGmsh2);
5490ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh4, isGmsh4);
5491ef3a5affSJacob Faibussowitsch   CheckExtension(extCGNS, isCGNS);
5492ef3a5affSJacob Faibussowitsch   CheckExtension(extExodus, isExodus);
5493ef3a5affSJacob Faibussowitsch   if (!isExodus) CheckExtension(extExodus_e, isExodus);
5494ef3a5affSJacob Faibussowitsch   CheckExtension(extGenesis, isGenesis);
5495ef3a5affSJacob Faibussowitsch   CheckExtension(extFluent, isFluent);
5496ef3a5affSJacob Faibussowitsch   CheckExtension(extHDF5, isHDF5);
5497ef3a5affSJacob Faibussowitsch   CheckExtension(extMed, isMed);
5498ef3a5affSJacob Faibussowitsch   CheckExtension(extPLY, isPLY);
5499ef3a5affSJacob Faibussowitsch   CheckExtension(extEGADSLite, isEGADSLite);
5500ef3a5affSJacob Faibussowitsch   CheckExtension(extEGADS, isEGADS);
5501ef3a5affSJacob Faibussowitsch   CheckExtension(extIGES, isIGES);
5502ef3a5affSJacob Faibussowitsch   CheckExtension(extSTEP, isSTEP);
5503ef3a5affSJacob Faibussowitsch   CheckExtension(extCV, isCV);
55046f2c871aSStefano Zampini   CheckExtension(extXDMFHDF5, isXDMFHDF5);
5505ef3a5affSJacob Faibussowitsch 
5506ef3a5affSJacob Faibussowitsch #undef CheckExtension
5507ef3a5affSJacob Faibussowitsch 
5508de78e4feSLisandro Dalcin   if (isGmsh || isGmsh2 || isGmsh4) {
55099566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateGmshFromFile(comm, filename, interpolate, dm));
5510ca522641SMatthew G. Knepley   } else if (isCGNS) {
55119566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateCGNSFromFile(comm, filename, interpolate, dm));
551290c68965SMatthew G. Knepley   } else if (isExodus || isGenesis) {
55139566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateExodusFromFile(comm, filename, interpolate, dm));
55142f0bd6dcSMichael Lange   } else if (isFluent) {
55159566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFluentFromFile(comm, filename, interpolate, dm));
5516cc2f8f65SMatthew G. Knepley   } else if (isHDF5) {
5517cc2f8f65SMatthew G. Knepley     PetscViewer viewer;
5518cc2f8f65SMatthew G. Knepley 
551943b242b4SVaclav 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 */
55206f2c871aSStefano Zampini     PetscCall(PetscOptionsGetBool(NULL, NULL, "-dm_plex_create_from_hdf5_xdmf", &isXDMFHDF5, NULL));
55219566063dSJacob Faibussowitsch     PetscCall(PetscViewerCreate(comm, &viewer));
55229566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetType(viewer, PETSCVIEWERHDF5));
55239566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetOptionsPrefix(viewer, "dm_plex_create_"));
55249566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetFromOptions(viewer));
55259566063dSJacob Faibussowitsch     PetscCall(PetscViewerFileSetMode(viewer, FILE_MODE_READ));
55269566063dSJacob Faibussowitsch     PetscCall(PetscViewerFileSetName(viewer, filename));
5527cd7e8a5eSksagiyam 
55289566063dSJacob Faibussowitsch     PetscCall(DMCreate(comm, dm));
55299566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)(*dm), plexname));
55309566063dSJacob Faibussowitsch     PetscCall(DMSetType(*dm, DMPLEX));
55316f2c871aSStefano Zampini     if (isXDMFHDF5) PetscCall(PetscViewerPushFormat(viewer, PETSC_VIEWER_HDF5_XDMF));
55329566063dSJacob Faibussowitsch     PetscCall(DMLoad(*dm, viewer));
55336f2c871aSStefano Zampini     if (isXDMFHDF5) PetscCall(PetscViewerPopFormat(viewer));
55349566063dSJacob Faibussowitsch     PetscCall(PetscViewerDestroy(&viewer));
55355fd9971aSMatthew G. Knepley 
55365fd9971aSMatthew G. Knepley     if (interpolate) {
55375fd9971aSMatthew G. Knepley       DM idm;
55385fd9971aSMatthew G. Knepley 
55399566063dSJacob Faibussowitsch       PetscCall(DMPlexInterpolate(*dm, &idm));
55409566063dSJacob Faibussowitsch       PetscCall(DMDestroy(dm));
55415fd9971aSMatthew G. Knepley       *dm = idm;
55425fd9971aSMatthew G. Knepley     }
5543707dd687SMichael Lange   } else if (isMed) {
55449566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateMedFromFile(comm, filename, interpolate, dm));
5545f2801cd6SMatthew G. Knepley   } else if (isPLY) {
55469566063dSJacob Faibussowitsch     PetscCall(DMPlexCreatePLYFromFile(comm, filename, interpolate, dm));
5547c1cad2e7SMatthew G. Knepley   } else if (isEGADSLite || isEGADS || isIGES || isSTEP) {
55489566063dSJacob Faibussowitsch     if (isEGADSLite) PetscCall(DMPlexCreateEGADSLiteFromFile(comm, filename, dm));
55499566063dSJacob Faibussowitsch     else PetscCall(DMPlexCreateEGADSFromFile(comm, filename, dm));
55507bee2925SMatthew Knepley     if (!interpolate) {
55517bee2925SMatthew Knepley       DM udm;
55527bee2925SMatthew Knepley 
55539566063dSJacob Faibussowitsch       PetscCall(DMPlexUninterpolate(*dm, &udm));
55549566063dSJacob Faibussowitsch       PetscCall(DMDestroy(dm));
55557bee2925SMatthew Knepley       *dm = udm;
55567bee2925SMatthew Knepley     }
55578ca92349SMatthew G. Knepley   } else if (isCV) {
55589566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateCellVertexFromFile(comm, filename, interpolate, dm));
555998921bdaSJacob Faibussowitsch   } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Cannot load file %s: unrecognized extension", filename);
55609566063dSJacob Faibussowitsch   PetscCall(PetscStrlen(plexname, &len));
55619566063dSJacob Faibussowitsch   if (len) PetscCall(PetscObjectSetName((PetscObject)(*dm), plexname));
55629566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_CreateFromFile, 0, 0, 0, 0));
55633ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5564ca522641SMatthew G. Knepley }
556512b8a6daSStefano Zampini 
55669f6c5813SMatthew G. Knepley /*@C
55679f6c5813SMatthew 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.
55689f6c5813SMatthew G. Knepley 
55690528010dSStefano Zampini   Input Parameters:
55700528010dSStefano Zampini + tr     - The `DMPlexTransform`
55710528010dSStefano Zampini - prefix - An options prefix, or NULL
55729f6c5813SMatthew G. Knepley 
55739f6c5813SMatthew G. Knepley   Output Parameter:
55749f6c5813SMatthew G. Knepley . dm - The `DM`
55759f6c5813SMatthew G. Knepley 
55769f6c5813SMatthew G. Knepley   Level: beginner
55779f6c5813SMatthew G. Knepley 
557820f4b53cSBarry Smith   Notes:
557920f4b53cSBarry 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.
558020f4b53cSBarry Smith 
55819f6c5813SMatthew G. Knepley .seealso: `DMPlexCreateFromFile`, `DMPlexCreateFromDAG()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`
55829f6c5813SMatthew G. Knepley @*/
55830528010dSStefano Zampini PetscErrorCode DMPlexCreateEphemeral(DMPlexTransform tr, const char prefix[], DM *dm)
55849f6c5813SMatthew G. Knepley {
55850528010dSStefano Zampini   DM           bdm, bcdm, cdm;
55860528010dSStefano Zampini   Vec          coordinates, coordinatesNew;
55870528010dSStefano Zampini   PetscSection cs;
55880528010dSStefano Zampini   PetscInt     dim, cdim, Nl;
55899f6c5813SMatthew G. Knepley 
55909f6c5813SMatthew G. Knepley   PetscFunctionBegin;
55919f6c5813SMatthew G. Knepley   PetscCall(DMCreate(PetscObjectComm((PetscObject)tr), dm));
55929f6c5813SMatthew G. Knepley   PetscCall(DMSetType(*dm, DMPLEX));
55930528010dSStefano Zampini   ((DM_Plex *)(*dm)->data)->interpolated = DMPLEX_INTERPOLATED_FULL;
55940528010dSStefano Zampini   // Handle coordinates
55950528010dSStefano Zampini   PetscCall(DMPlexTransformGetDM(tr, &bdm));
55960528010dSStefano Zampini   PetscCall(DMGetCoordinateDim(bdm, &cdim));
55970528010dSStefano Zampini   PetscCall(DMSetCoordinateDim(*dm, cdim));
55980528010dSStefano Zampini   PetscCall(DMGetDimension(bdm, &dim));
55990528010dSStefano Zampini   PetscCall(DMSetDimension(*dm, dim));
56000528010dSStefano Zampini   PetscCall(DMGetCoordinateDM(bdm, &bcdm));
56010528010dSStefano Zampini   PetscCall(DMGetCoordinateDM(*dm, &cdm));
56020528010dSStefano Zampini   PetscCall(DMCopyDisc(bcdm, cdm));
56030528010dSStefano Zampini   PetscCall(DMGetLocalSection(cdm, &cs));
56040528010dSStefano Zampini   PetscCall(PetscSectionSetNumFields(cs, 1));
56050528010dSStefano Zampini   PetscCall(PetscSectionSetFieldComponents(cs, 0, cdim));
56060528010dSStefano Zampini   PetscCall(DMGetCoordinatesLocal(bdm, &coordinates));
56070528010dSStefano Zampini   PetscCall(VecDuplicate(coordinates, &coordinatesNew));
56080528010dSStefano Zampini   PetscCall(VecCopy(coordinates, coordinatesNew));
56090528010dSStefano Zampini   PetscCall(DMSetCoordinatesLocal(*dm, coordinatesNew));
56100528010dSStefano Zampini   PetscCall(VecDestroy(&coordinatesNew));
56119f6c5813SMatthew G. Knepley 
56129f6c5813SMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)tr));
56139f6c5813SMatthew G. Knepley   PetscCall(DMPlexTransformDestroy(&((DM_Plex *)(*dm)->data)->tr));
56149f6c5813SMatthew G. Knepley   ((DM_Plex *)(*dm)->data)->tr = tr;
56150528010dSStefano Zampini   PetscCall(DMPlexDistributeSetDefault(*dm, PETSC_FALSE));
56160528010dSStefano Zampini   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)*dm, prefix));
56170528010dSStefano Zampini   PetscCall(DMSetFromOptions(*dm));
56189f6c5813SMatthew G. Knepley 
56199f6c5813SMatthew G. Knepley   PetscCall(DMGetNumLabels(bdm, &Nl));
56209f6c5813SMatthew G. Knepley   for (PetscInt l = 0; l < Nl; ++l) {
56219f6c5813SMatthew G. Knepley     DMLabel     label, labelNew;
56229f6c5813SMatthew G. Knepley     const char *lname;
56239f6c5813SMatthew G. Knepley     PetscBool   isDepth, isCellType;
56249f6c5813SMatthew G. Knepley 
56259f6c5813SMatthew G. Knepley     PetscCall(DMGetLabelName(bdm, l, &lname));
56269f6c5813SMatthew G. Knepley     PetscCall(PetscStrcmp(lname, "depth", &isDepth));
56279f6c5813SMatthew G. Knepley     if (isDepth) continue;
56289f6c5813SMatthew G. Knepley     PetscCall(PetscStrcmp(lname, "celltype", &isCellType));
56299f6c5813SMatthew G. Knepley     if (isCellType) continue;
56309f6c5813SMatthew G. Knepley     PetscCall(DMCreateLabel(*dm, lname));
56319f6c5813SMatthew G. Knepley     PetscCall(DMGetLabel(bdm, lname, &label));
56329f6c5813SMatthew G. Knepley     PetscCall(DMGetLabel(*dm, lname, &labelNew));
56339f6c5813SMatthew G. Knepley     PetscCall(DMLabelSetType(labelNew, DMLABELEPHEMERAL));
56349f6c5813SMatthew G. Knepley     PetscCall(DMLabelEphemeralSetLabel(labelNew, label));
56359f6c5813SMatthew G. Knepley     PetscCall(DMLabelEphemeralSetTransform(labelNew, tr));
56369f6c5813SMatthew G. Knepley     PetscCall(DMLabelSetUp(labelNew));
56379f6c5813SMatthew G. Knepley   }
56383ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
56399f6c5813SMatthew G. Knepley }
5640