xref: /petsc/src/dm/impls/plex/plexcreate.c (revision 5c34450195202929fe7520629dc69b8db9a7fadb)
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;
195962854dSMatthew G. Knepley   PetscBool                dist, useCeed;
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));
315962854dSMatthew G. Knepley   PetscCall(DMPlexGetUseCeed(dmin, &useCeed));
325962854dSMatthew G. Knepley   PetscCall(DMPlexSetUseCeed(dmout, useCeed));
33e600fa54SMatthew G. Knepley   ((DM_Plex *)dmout->data)->useHashLocation = ((DM_Plex *)dmin->data)->useHashLocation;
345962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printSetValues  = ((DM_Plex *)dmin->data)->printSetValues;
355962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printFEM        = ((DM_Plex *)dmin->data)->printFEM;
365962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printFVM        = ((DM_Plex *)dmin->data)->printFVM;
375962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printL2         = ((DM_Plex *)dmin->data)->printL2;
385962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printLocate     = ((DM_Plex *)dmin->data)->printLocate;
395962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printTol        = ((DM_Plex *)dmin->data)->printTol;
401baa6e33SBarry Smith   if (copyOverlap) PetscCall(DMPlexSetOverlap_Plex(dmout, dmin, 0));
413ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
42e600fa54SMatthew G. Knepley }
43e600fa54SMatthew G. Knepley 
449318fe57SMatthew G. Knepley /* Replace dm with the contents of ndm, and then destroy ndm
459318fe57SMatthew G. Knepley    - Share the DM_Plex structure
469318fe57SMatthew G. Knepley    - Share the coordinates
479318fe57SMatthew G. Knepley    - Share the SF
489318fe57SMatthew G. Knepley */
49d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexReplace_Internal(DM dm, DM *ndm)
50d71ae5a4SJacob Faibussowitsch {
519318fe57SMatthew G. Knepley   PetscSF          sf;
529318fe57SMatthew G. Knepley   DM               dmNew = *ndm, coordDM, coarseDM;
539318fe57SMatthew G. Knepley   Vec              coords;
544fb89dddSMatthew G. Knepley   const PetscReal *maxCell, *Lstart, *L;
559318fe57SMatthew G. Knepley   PetscInt         dim, cdim;
569318fe57SMatthew G. Knepley 
579318fe57SMatthew G. Knepley   PetscFunctionBegin;
589318fe57SMatthew G. Knepley   if (dm == dmNew) {
599566063dSJacob Faibussowitsch     PetscCall(DMDestroy(ndm));
603ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
619318fe57SMatthew G. Knepley   }
629318fe57SMatthew G. Knepley   dm->setupcalled = dmNew->setupcalled;
639566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dmNew, &dim));
649566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
659566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dmNew, &cdim));
669566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, cdim));
679566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dmNew, &sf));
689566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dm, sf));
699566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dmNew, &coordDM));
709566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dmNew, &coords));
719566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDM(dm, coordDM));
729566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coords));
736858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dmNew, &coordDM));
746858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocal(dmNew, &coords));
756858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinateDM(dm, coordDM));
766858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinatesLocal(dm, coords));
779318fe57SMatthew G. Knepley   /* Do not want to create the coordinate field if it does not already exist, so do not call DMGetCoordinateField() */
786858538eSMatthew G. Knepley   PetscCall(DMFieldDestroy(&dm->coordinates[0].field));
796858538eSMatthew G. Knepley   dm->coordinates[0].field            = dmNew->coordinates[0].field;
8061a622f3SMatthew G. Knepley   ((DM_Plex *)dmNew->data)->coordFunc = ((DM_Plex *)dm->data)->coordFunc;
814fb89dddSMatthew G. Knepley   PetscCall(DMGetPeriodicity(dmNew, &maxCell, &Lstart, &L));
824fb89dddSMatthew G. Knepley   PetscCall(DMSetPeriodicity(dm, maxCell, Lstart, L));
836925d1c4SMatthew G. Knepley   PetscCall(DMPlexGetGlobalToNaturalSF(dmNew, &sf));
846925d1c4SMatthew G. Knepley   PetscCall(DMPlexSetGlobalToNaturalSF(dm, sf));
859566063dSJacob Faibussowitsch   PetscCall(DMDestroy_Plex(dm));
869566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(dm));
879318fe57SMatthew G. Knepley   dm->data = dmNew->data;
889318fe57SMatthew G. Knepley   ((DM_Plex *)dmNew->data)->refct++;
895f06a3ddSJed Brown   PetscCall(DMPlexGetIsoperiodicFaceSF(dm, &sf));
905f06a3ddSJed Brown   PetscCall(DMPlexSetIsoperiodicFaceSF(dm, sf)); // for the compose function effect on dm
919566063dSJacob Faibussowitsch   PetscCall(DMDestroyLabelLinkList_Internal(dm));
929566063dSJacob Faibussowitsch   PetscCall(DMCopyLabels(dmNew, dm, PETSC_OWN_POINTER, PETSC_TRUE, DM_COPY_LABELS_FAIL));
939566063dSJacob Faibussowitsch   PetscCall(DMGetCoarseDM(dmNew, &coarseDM));
949566063dSJacob Faibussowitsch   PetscCall(DMSetCoarseDM(dm, coarseDM));
959566063dSJacob Faibussowitsch   PetscCall(DMDestroy(ndm));
963ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
979318fe57SMatthew G. Knepley }
989318fe57SMatthew G. Knepley 
999318fe57SMatthew G. Knepley /* Swap dm with the contents of dmNew
1009318fe57SMatthew G. Knepley    - Swap the DM_Plex structure
1019318fe57SMatthew G. Knepley    - Swap the coordinates
1029318fe57SMatthew G. Knepley    - Swap the point PetscSF
1039318fe57SMatthew G. Knepley */
104d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexSwap_Static(DM dmA, DM dmB)
105d71ae5a4SJacob Faibussowitsch {
1069318fe57SMatthew G. Knepley   DM          coordDMA, coordDMB;
1079318fe57SMatthew G. Knepley   Vec         coordsA, coordsB;
1089318fe57SMatthew G. Knepley   PetscSF     sfA, sfB;
1099318fe57SMatthew G. Knepley   DMField     fieldTmp;
1109318fe57SMatthew G. Knepley   void       *tmp;
1119318fe57SMatthew G. Knepley   DMLabelLink listTmp;
1129318fe57SMatthew G. Knepley   DMLabel     depthTmp;
1139318fe57SMatthew G. Knepley   PetscInt    tmpI;
1149318fe57SMatthew G. Knepley 
1159318fe57SMatthew G. Knepley   PetscFunctionBegin;
1163ba16761SJacob Faibussowitsch   if (dmA == dmB) PetscFunctionReturn(PETSC_SUCCESS);
1179566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dmA, &sfA));
1189566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dmB, &sfB));
1199566063dSJacob Faibussowitsch   PetscCall(PetscObjectReference((PetscObject)sfA));
1209566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dmA, sfB));
1219566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dmB, sfA));
1229566063dSJacob Faibussowitsch   PetscCall(PetscObjectDereference((PetscObject)sfA));
1239318fe57SMatthew G. Knepley 
1249566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dmA, &coordDMA));
1259566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dmB, &coordDMB));
1269566063dSJacob Faibussowitsch   PetscCall(PetscObjectReference((PetscObject)coordDMA));
1279566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDM(dmA, coordDMB));
1289566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDM(dmB, coordDMA));
1299566063dSJacob Faibussowitsch   PetscCall(PetscObjectDereference((PetscObject)coordDMA));
1309318fe57SMatthew G. Knepley 
1319566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dmA, &coordsA));
1329566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dmB, &coordsB));
1339566063dSJacob Faibussowitsch   PetscCall(PetscObjectReference((PetscObject)coordsA));
1349566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dmA, coordsB));
1359566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dmB, coordsA));
1369566063dSJacob Faibussowitsch   PetscCall(PetscObjectDereference((PetscObject)coordsA));
1379318fe57SMatthew G. Knepley 
1386858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dmA, &coordDMA));
1396858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dmB, &coordDMB));
1406858538eSMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)coordDMA));
1416858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinateDM(dmA, coordDMB));
1426858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinateDM(dmB, coordDMA));
1436858538eSMatthew G. Knepley   PetscCall(PetscObjectDereference((PetscObject)coordDMA));
1446858538eSMatthew G. Knepley 
1456858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocal(dmA, &coordsA));
1466858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocal(dmB, &coordsB));
1476858538eSMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)coordsA));
1486858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinatesLocal(dmA, coordsB));
1496858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinatesLocal(dmB, coordsA));
1506858538eSMatthew G. Knepley   PetscCall(PetscObjectDereference((PetscObject)coordsA));
1516858538eSMatthew G. Knepley 
1526858538eSMatthew G. Knepley   fieldTmp                  = dmA->coordinates[0].field;
1536858538eSMatthew G. Knepley   dmA->coordinates[0].field = dmB->coordinates[0].field;
1546858538eSMatthew G. Knepley   dmB->coordinates[0].field = fieldTmp;
1556858538eSMatthew G. Knepley   fieldTmp                  = dmA->coordinates[1].field;
1566858538eSMatthew G. Knepley   dmA->coordinates[1].field = dmB->coordinates[1].field;
1576858538eSMatthew G. Knepley   dmB->coordinates[1].field = fieldTmp;
1589318fe57SMatthew G. Knepley   tmp                       = dmA->data;
1599318fe57SMatthew G. Knepley   dmA->data                 = dmB->data;
1609318fe57SMatthew G. Knepley   dmB->data                 = tmp;
1619318fe57SMatthew G. Knepley   listTmp                   = dmA->labels;
1629318fe57SMatthew G. Knepley   dmA->labels               = dmB->labels;
1639318fe57SMatthew G. Knepley   dmB->labels               = listTmp;
1649318fe57SMatthew G. Knepley   depthTmp                  = dmA->depthLabel;
1659318fe57SMatthew G. Knepley   dmA->depthLabel           = dmB->depthLabel;
1669318fe57SMatthew G. Knepley   dmB->depthLabel           = depthTmp;
1679318fe57SMatthew G. Knepley   depthTmp                  = dmA->celltypeLabel;
1689318fe57SMatthew G. Knepley   dmA->celltypeLabel        = dmB->celltypeLabel;
1699318fe57SMatthew G. Knepley   dmB->celltypeLabel        = depthTmp;
1709318fe57SMatthew G. Knepley   tmpI                      = dmA->levelup;
1719318fe57SMatthew G. Knepley   dmA->levelup              = dmB->levelup;
1729318fe57SMatthew G. Knepley   dmB->levelup              = tmpI;
1733ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1749318fe57SMatthew G. Knepley }
1759318fe57SMatthew G. Knepley 
1763431e603SJed Brown PetscErrorCode DMPlexInterpolateInPlace_Internal(DM dm)
177d71ae5a4SJacob Faibussowitsch {
1789318fe57SMatthew G. Knepley   DM idm;
1799318fe57SMatthew G. Knepley 
1809318fe57SMatthew G. Knepley   PetscFunctionBegin;
1819566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolate(dm, &idm));
1829566063dSJacob Faibussowitsch   PetscCall(DMPlexCopyCoordinates(dm, idm));
18369d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &idm));
1843ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1859318fe57SMatthew G. Knepley }
1869318fe57SMatthew G. Knepley 
1879318fe57SMatthew G. Knepley /*@C
1889318fe57SMatthew G. Knepley   DMPlexCreateCoordinateSpace - Creates a finite element space for the coordinates
1899318fe57SMatthew G. Knepley 
19020f4b53cSBarry Smith   Collective
1919318fe57SMatthew G. Knepley 
1929318fe57SMatthew G. Knepley   Input Parameters:
19360225df5SJacob Faibussowitsch + dm        - The `DMPLEX`
19420f4b53cSBarry Smith . degree    - The degree of the finite element or `PETSC_DECIDE`
195e44f6aebSMatthew G. Knepley . project   - Flag to project current coordinates into the space
1969318fe57SMatthew G. Knepley - coordFunc - An optional function to map new points from refinement to the surface
1979318fe57SMatthew G. Knepley 
1989318fe57SMatthew G. Knepley   Level: advanced
1999318fe57SMatthew G. Knepley 
2001cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `PetscPointFunc`, `PetscFECreateLagrange()`, `DMGetCoordinateDM()`
2019318fe57SMatthew G. Knepley @*/
202e44f6aebSMatthew G. Knepley PetscErrorCode DMPlexCreateCoordinateSpace(DM dm, PetscInt degree, PetscBool project, PetscPointFunc coordFunc)
203d71ae5a4SJacob Faibussowitsch {
2049318fe57SMatthew G. Knepley   DM_Plex *mesh = (DM_Plex *)dm->data;
205e44f6aebSMatthew G. Knepley   PetscFE  fe   = NULL;
2069318fe57SMatthew G. Knepley   DM       cdm;
2079318fe57SMatthew G. Knepley   PetscInt dim, dE, qorder;
2089318fe57SMatthew G. Knepley 
209e44f6aebSMatthew G. Knepley   PetscFunctionBegin;
2109566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
2119566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &dE));
2129318fe57SMatthew G. Knepley   qorder = degree;
213e44f6aebSMatthew G. Knepley   PetscCall(DMGetCoordinateDM(dm, &cdm));
214d0609cedSBarry Smith   PetscObjectOptionsBegin((PetscObject)cdm);
215dc431b0cSMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-default_quadrature_order", "Quadrature order is one less than quadrature points per edge", "DMPlexCreateCoordinateSpace", qorder, &qorder, NULL, 0));
216d0609cedSBarry Smith   PetscOptionsEnd();
217e44f6aebSMatthew G. Knepley   if (degree >= 0) {
218e44f6aebSMatthew G. Knepley     DMPolytopeType ct = DM_POLYTOPE_UNKNOWN;
219e44f6aebSMatthew G. Knepley     PetscInt       cStart, cEnd, gct;
220dc431b0cSMatthew G. Knepley 
221dc431b0cSMatthew G. Knepley     PetscCall(DMPlexGetHeightStratum(dm, 0, &cStart, &cEnd));
222dc431b0cSMatthew G. Knepley     if (cEnd > cStart) PetscCall(DMPlexGetCellType(dm, cStart, &ct));
223e44f6aebSMatthew G. Knepley     gct = (PetscInt)ct;
224e44f6aebSMatthew G. Knepley     PetscCall(MPIU_Allreduce(MPI_IN_PLACE, &gct, 1, MPIU_INT, MPI_MIN, PetscObjectComm((PetscObject)dm)));
225e44f6aebSMatthew G. Knepley     ct = (DMPolytopeType)gct;
226e44f6aebSMatthew G. Knepley     // Work around current bug in PetscDualSpaceSetUp_Lagrange()
227e44f6aebSMatthew G. Knepley     //   Can be seen in plex_tutorials-ex10_1
228e44f6aebSMatthew 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));
2294f9ab2b4SJed Brown   }
230e44f6aebSMatthew G. Knepley   PetscCall(DMSetCoordinateDisc(dm, fe, project));
2319566063dSJacob Faibussowitsch   PetscCall(PetscFEDestroy(&fe));
2329318fe57SMatthew G. Knepley   mesh->coordFunc = coordFunc;
2333ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2349318fe57SMatthew G. Knepley }
2359318fe57SMatthew G. Knepley 
2361df5d5c5SMatthew G. Knepley /*@
2371df5d5c5SMatthew G. Knepley   DMPlexCreateDoublet - Creates a mesh of two cells of the specified type, optionally with later refinement.
2381df5d5c5SMatthew G. Knepley 
239d083f849SBarry Smith   Collective
2401df5d5c5SMatthew G. Knepley 
2411df5d5c5SMatthew G. Knepley   Input Parameters:
242a1cb98faSBarry Smith + comm            - The communicator for the `DM` object
2431df5d5c5SMatthew G. Knepley . dim             - The spatial dimension
2441df5d5c5SMatthew G. Knepley . simplex         - Flag for simplicial cells, otherwise they are tensor product cells
2451df5d5c5SMatthew G. Knepley . interpolate     - Flag to create intermediate mesh pieces (edges, faces)
2461df5d5c5SMatthew G. Knepley - refinementLimit - A nonzero number indicates the largest admissible volume for a refined cell
2471df5d5c5SMatthew G. Knepley 
2481df5d5c5SMatthew G. Knepley   Output Parameter:
24960225df5SJacob Faibussowitsch . newdm - The `DM` object
2501df5d5c5SMatthew G. Knepley 
2511df5d5c5SMatthew G. Knepley   Level: beginner
2521df5d5c5SMatthew G. Knepley 
2531cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMSetType()`, `DMCreate()`
2541df5d5c5SMatthew G. Knepley @*/
255d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateDoublet(MPI_Comm comm, PetscInt dim, PetscBool simplex, PetscBool interpolate, PetscReal refinementLimit, DM *newdm)
256d71ae5a4SJacob Faibussowitsch {
2571df5d5c5SMatthew G. Knepley   DM          dm;
2581df5d5c5SMatthew G. Knepley   PetscMPIInt rank;
2591df5d5c5SMatthew G. Knepley 
2601df5d5c5SMatthew G. Knepley   PetscFunctionBegin;
2619566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, &dm));
2629566063dSJacob Faibussowitsch   PetscCall(DMSetType(dm, DMPLEX));
2639566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
26446139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
2659566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
266ce78fa2fSMatthew G. Knepley   switch (dim) {
267ce78fa2fSMatthew G. Knepley   case 2:
2689566063dSJacob Faibussowitsch     if (simplex) PetscCall(PetscObjectSetName((PetscObject)dm, "triangular"));
2699566063dSJacob Faibussowitsch     else PetscCall(PetscObjectSetName((PetscObject)dm, "quadrilateral"));
270ce78fa2fSMatthew G. Knepley     break;
271ce78fa2fSMatthew G. Knepley   case 3:
2729566063dSJacob Faibussowitsch     if (simplex) PetscCall(PetscObjectSetName((PetscObject)dm, "tetrahedral"));
2739566063dSJacob Faibussowitsch     else PetscCall(PetscObjectSetName((PetscObject)dm, "hexahedral"));
274ce78fa2fSMatthew G. Knepley     break;
275d71ae5a4SJacob Faibussowitsch   default:
276d71ae5a4SJacob Faibussowitsch     SETERRQ(comm, PETSC_ERR_ARG_OUTOFRANGE, "Cannot make meshes for dimension %" PetscInt_FMT, dim);
277ce78fa2fSMatthew G. Knepley   }
2781df5d5c5SMatthew G. Knepley   if (rank) {
2791df5d5c5SMatthew G. Knepley     PetscInt numPoints[2] = {0, 0};
2809566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, NULL, NULL, NULL, NULL));
2811df5d5c5SMatthew G. Knepley   } else {
2821df5d5c5SMatthew G. Knepley     switch (dim) {
2831df5d5c5SMatthew G. Knepley     case 2:
2841df5d5c5SMatthew G. Knepley       if (simplex) {
2851df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]        = {4, 2};
2861df5d5c5SMatthew G. Knepley         PetscInt    coneSize[6]         = {3, 3, 0, 0, 0, 0};
2871df5d5c5SMatthew G. Knepley         PetscInt    cones[6]            = {2, 3, 4, 5, 4, 3};
2881df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
2891df5d5c5SMatthew G. Knepley         PetscScalar vertexCoords[8]     = {-0.5, 0.5, 0.0, 0.0, 0.0, 1.0, 0.5, 0.5};
2901df5d5c5SMatthew G. Knepley 
2919566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
2921df5d5c5SMatthew G. Knepley       } else {
2931df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]        = {6, 2};
2941df5d5c5SMatthew G. Knepley         PetscInt    coneSize[8]         = {4, 4, 0, 0, 0, 0, 0, 0};
2951df5d5c5SMatthew G. Knepley         PetscInt    cones[8]            = {2, 3, 4, 5, 3, 6, 7, 4};
2961df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
2971df5d5c5SMatthew 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};
2981df5d5c5SMatthew G. Knepley 
2999566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
3001df5d5c5SMatthew G. Knepley       }
3011df5d5c5SMatthew G. Knepley       break;
3021df5d5c5SMatthew G. Knepley     case 3:
3031df5d5c5SMatthew G. Knepley       if (simplex) {
3041df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]        = {5, 2};
3051df5d5c5SMatthew G. Knepley         PetscInt    coneSize[7]         = {4, 4, 0, 0, 0, 0, 0};
3061df5d5c5SMatthew G. Knepley         PetscInt    cones[8]            = {4, 3, 5, 2, 5, 3, 4, 6};
3071df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
3081df5d5c5SMatthew 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};
3091df5d5c5SMatthew G. Knepley 
3109566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
3111df5d5c5SMatthew G. Knepley       } else {
3121df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]         = {12, 2};
3131df5d5c5SMatthew G. Knepley         PetscInt    coneSize[14]         = {8, 8, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
3141df5d5c5SMatthew G. Knepley         PetscInt    cones[16]            = {2, 3, 4, 5, 6, 7, 8, 9, 5, 4, 10, 11, 7, 12, 13, 8};
3151df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[16] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
3169371c9d4SSatish 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};
3171df5d5c5SMatthew G. Knepley 
3189566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
3191df5d5c5SMatthew G. Knepley       }
3201df5d5c5SMatthew G. Knepley       break;
321d71ae5a4SJacob Faibussowitsch     default:
322d71ae5a4SJacob Faibussowitsch       SETERRQ(comm, PETSC_ERR_ARG_OUTOFRANGE, "Cannot make meshes for dimension %" PetscInt_FMT, dim);
3231df5d5c5SMatthew G. Knepley     }
3241df5d5c5SMatthew G. Knepley   }
32546139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
3261df5d5c5SMatthew G. Knepley   *newdm = dm;
3271df5d5c5SMatthew G. Knepley   if (refinementLimit > 0.0) {
3281df5d5c5SMatthew G. Knepley     DM          rdm;
3291df5d5c5SMatthew G. Knepley     const char *name;
3301df5d5c5SMatthew G. Knepley 
3319566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementUniform(*newdm, PETSC_FALSE));
3329566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementLimit(*newdm, refinementLimit));
3339566063dSJacob Faibussowitsch     PetscCall(DMRefine(*newdm, comm, &rdm));
3349566063dSJacob Faibussowitsch     PetscCall(PetscObjectGetName((PetscObject)*newdm, &name));
3359566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)rdm, name));
3369566063dSJacob Faibussowitsch     PetscCall(DMDestroy(newdm));
3371df5d5c5SMatthew G. Knepley     *newdm = rdm;
3381df5d5c5SMatthew G. Knepley   }
3391df5d5c5SMatthew G. Knepley   if (interpolate) {
3405fd9971aSMatthew G. Knepley     DM idm;
3411df5d5c5SMatthew G. Knepley 
3429566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*newdm, &idm));
3439566063dSJacob Faibussowitsch     PetscCall(DMDestroy(newdm));
3441df5d5c5SMatthew G. Knepley     *newdm = idm;
3451df5d5c5SMatthew G. Knepley   }
3463ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3471df5d5c5SMatthew G. Knepley }
3481df5d5c5SMatthew G. Knepley 
349d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Tensor_1D_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[])
350d71ae5a4SJacob Faibussowitsch {
3519318fe57SMatthew G. Knepley   const PetscInt numVertices    = 2;
3529318fe57SMatthew G. Knepley   PetscInt       markerRight    = 1;
3539318fe57SMatthew G. Knepley   PetscInt       markerLeft     = 1;
3549318fe57SMatthew G. Knepley   PetscBool      markerSeparate = PETSC_FALSE;
3559318fe57SMatthew G. Knepley   Vec            coordinates;
3569318fe57SMatthew G. Knepley   PetscSection   coordSection;
3579318fe57SMatthew G. Knepley   PetscScalar   *coords;
3589318fe57SMatthew G. Knepley   PetscInt       coordSize;
3599318fe57SMatthew G. Knepley   PetscMPIInt    rank;
3609318fe57SMatthew G. Knepley   PetscInt       cdim = 1, v;
361552f7358SJed Brown 
3629318fe57SMatthew G. Knepley   PetscFunctionBegin;
3639566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
3649318fe57SMatthew G. Knepley   if (markerSeparate) {
3659318fe57SMatthew G. Knepley     markerRight = 2;
3669318fe57SMatthew G. Knepley     markerLeft  = 1;
3679318fe57SMatthew G. Knepley   }
3689566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
369c5853193SPierre Jolivet   if (rank == 0) {
3709566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numVertices));
3719566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
3729566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", 0, markerLeft));
3739566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", 1, markerRight));
3749318fe57SMatthew G. Knepley   }
3759566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
3769566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
3779318fe57SMatthew G. Knepley   /* Build coordinates */
3789566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, cdim));
3799566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
3809566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
3819566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, 0, numVertices));
3829566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, cdim));
3839318fe57SMatthew G. Knepley   for (v = 0; v < numVertices; ++v) {
3849566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, cdim));
3859566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, cdim));
3869318fe57SMatthew G. Knepley   }
3879566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
3889566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
3899566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
3909566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
3919566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
3929566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, cdim));
3939566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
3949566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
3959318fe57SMatthew G. Knepley   coords[0] = lower[0];
3969318fe57SMatthew G. Knepley   coords[1] = upper[0];
3979566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
3989566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
3999566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
4003ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4019318fe57SMatthew G. Knepley }
40226492d91SMatthew G. Knepley 
403d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Tensor_2D_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[])
404d71ae5a4SJacob Faibussowitsch {
4051df21d24SMatthew G. Knepley   const PetscInt numVertices    = (edges[0] + 1) * (edges[1] + 1);
4061df21d24SMatthew G. Knepley   const PetscInt numEdges       = edges[0] * (edges[1] + 1) + (edges[0] + 1) * edges[1];
407552f7358SJed Brown   PetscInt       markerTop      = 1;
408552f7358SJed Brown   PetscInt       markerBottom   = 1;
409552f7358SJed Brown   PetscInt       markerRight    = 1;
410552f7358SJed Brown   PetscInt       markerLeft     = 1;
411552f7358SJed Brown   PetscBool      markerSeparate = PETSC_FALSE;
412552f7358SJed Brown   Vec            coordinates;
413552f7358SJed Brown   PetscSection   coordSection;
414552f7358SJed Brown   PetscScalar   *coords;
415552f7358SJed Brown   PetscInt       coordSize;
416552f7358SJed Brown   PetscMPIInt    rank;
417552f7358SJed Brown   PetscInt       v, vx, vy;
418552f7358SJed Brown 
419552f7358SJed Brown   PetscFunctionBegin;
4209566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
421552f7358SJed Brown   if (markerSeparate) {
4221df21d24SMatthew G. Knepley     markerTop    = 3;
4231df21d24SMatthew G. Knepley     markerBottom = 1;
4241df21d24SMatthew G. Knepley     markerRight  = 2;
4251df21d24SMatthew G. Knepley     markerLeft   = 4;
426552f7358SJed Brown   }
4279566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
428dd400576SPatrick Sanan   if (rank == 0) {
429552f7358SJed Brown     PetscInt e, ex, ey;
430552f7358SJed Brown 
4319566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numEdges + numVertices));
43248a46eb9SPierre Jolivet     for (e = 0; e < numEdges; ++e) PetscCall(DMPlexSetConeSize(dm, e, 2));
4339566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
434552f7358SJed Brown     for (vx = 0; vx <= edges[0]; vx++) {
435552f7358SJed Brown       for (ey = 0; ey < edges[1]; ey++) {
436552f7358SJed Brown         PetscInt edge   = vx * edges[1] + ey + edges[0] * (edges[1] + 1);
437552f7358SJed Brown         PetscInt vertex = ey * (edges[0] + 1) + vx + numEdges;
438da80777bSKarl Rupp         PetscInt cone[2];
439552f7358SJed Brown 
4409371c9d4SSatish Balay         cone[0] = vertex;
4419371c9d4SSatish Balay         cone[1] = vertex + edges[0] + 1;
4429566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, edge, cone));
443552f7358SJed Brown         if (vx == edges[0]) {
4449566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
4459566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
446552f7358SJed Brown           if (ey == edges[1] - 1) {
4479566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
4489566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerRight));
449552f7358SJed Brown           }
450552f7358SJed Brown         } else if (vx == 0) {
4519566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
4529566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
453552f7358SJed Brown           if (ey == edges[1] - 1) {
4549566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
4559566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerLeft));
456552f7358SJed Brown           }
457552f7358SJed Brown         }
458552f7358SJed Brown       }
459552f7358SJed Brown     }
460552f7358SJed Brown     for (vy = 0; vy <= edges[1]; vy++) {
461552f7358SJed Brown       for (ex = 0; ex < edges[0]; ex++) {
462552f7358SJed Brown         PetscInt edge   = vy * edges[0] + ex;
463552f7358SJed Brown         PetscInt vertex = vy * (edges[0] + 1) + ex + numEdges;
464da80777bSKarl Rupp         PetscInt cone[2];
465552f7358SJed Brown 
4669371c9d4SSatish Balay         cone[0] = vertex;
4679371c9d4SSatish Balay         cone[1] = vertex + 1;
4689566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, edge, cone));
469552f7358SJed Brown         if (vy == edges[1]) {
4709566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
4719566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
472552f7358SJed Brown           if (ex == edges[0] - 1) {
4739566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
4749566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerTop));
475552f7358SJed Brown           }
476552f7358SJed Brown         } else if (vy == 0) {
4779566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
4789566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
479552f7358SJed Brown           if (ex == edges[0] - 1) {
4809566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
4819566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerBottom));
482552f7358SJed Brown           }
483552f7358SJed Brown         }
484552f7358SJed Brown       }
485552f7358SJed Brown     }
486552f7358SJed Brown   }
4879566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
4889566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
489552f7358SJed Brown   /* Build coordinates */
4909566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, 2));
4919566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
4929566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
4939566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, numEdges, numEdges + numVertices));
4949566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, 2));
495552f7358SJed Brown   for (v = numEdges; v < numEdges + numVertices; ++v) {
4969566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, 2));
4979566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, 2));
498552f7358SJed Brown   }
4999566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
5009566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
5019566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
5029566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
5039566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
5049566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, 2));
5059566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
5069566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
507552f7358SJed Brown   for (vy = 0; vy <= edges[1]; ++vy) {
508552f7358SJed Brown     for (vx = 0; vx <= edges[0]; ++vx) {
509552f7358SJed Brown       coords[(vy * (edges[0] + 1) + vx) * 2 + 0] = lower[0] + ((upper[0] - lower[0]) / edges[0]) * vx;
510552f7358SJed Brown       coords[(vy * (edges[0] + 1) + vx) * 2 + 1] = lower[1] + ((upper[1] - lower[1]) / edges[1]) * vy;
511552f7358SJed Brown     }
512552f7358SJed Brown   }
5139566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
5149566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
5159566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
5163ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
517552f7358SJed Brown }
518552f7358SJed Brown 
519d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Tensor_3D_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt faces[])
520d71ae5a4SJacob Faibussowitsch {
5219e8abbc3SMichael Lange   PetscInt     vertices[3], numVertices;
5227b59f5a9SMichael Lange   PetscInt     numFaces       = 2 * faces[0] * faces[1] + 2 * faces[1] * faces[2] + 2 * faces[0] * faces[2];
523c2df9bbfSMatthew G. Knepley   PetscInt     markerTop      = 1;
524c2df9bbfSMatthew G. Knepley   PetscInt     markerBottom   = 1;
525c2df9bbfSMatthew G. Knepley   PetscInt     markerFront    = 1;
526c2df9bbfSMatthew G. Knepley   PetscInt     markerBack     = 1;
527c2df9bbfSMatthew G. Knepley   PetscInt     markerRight    = 1;
528c2df9bbfSMatthew G. Knepley   PetscInt     markerLeft     = 1;
529c2df9bbfSMatthew G. Knepley   PetscBool    markerSeparate = PETSC_FALSE;
530552f7358SJed Brown   Vec          coordinates;
531552f7358SJed Brown   PetscSection coordSection;
532552f7358SJed Brown   PetscScalar *coords;
533552f7358SJed Brown   PetscInt     coordSize;
534552f7358SJed Brown   PetscMPIInt  rank;
535552f7358SJed Brown   PetscInt     v, vx, vy, vz;
5367b59f5a9SMichael Lange   PetscInt     voffset, iface = 0, cone[4];
537552f7358SJed Brown 
538552f7358SJed Brown   PetscFunctionBegin;
5391dca8a05SBarry 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");
5409566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
541c2df9bbfSMatthew G. Knepley   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
542c2df9bbfSMatthew G. Knepley   if (markerSeparate) {
543c2df9bbfSMatthew G. Knepley     markerBottom = 1;
544c2df9bbfSMatthew G. Knepley     markerTop    = 2;
545c2df9bbfSMatthew G. Knepley     markerFront  = 3;
546c2df9bbfSMatthew G. Knepley     markerBack   = 4;
547c2df9bbfSMatthew G. Knepley     markerRight  = 5;
548c2df9bbfSMatthew G. Knepley     markerLeft   = 6;
549c2df9bbfSMatthew G. Knepley   }
5509371c9d4SSatish Balay   vertices[0] = faces[0] + 1;
5519371c9d4SSatish Balay   vertices[1] = faces[1] + 1;
5529371c9d4SSatish Balay   vertices[2] = faces[2] + 1;
5539e8abbc3SMichael Lange   numVertices = vertices[0] * vertices[1] * vertices[2];
554dd400576SPatrick Sanan   if (rank == 0) {
555552f7358SJed Brown     PetscInt f;
556552f7358SJed Brown 
5579566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numFaces + numVertices));
55848a46eb9SPierre Jolivet     for (f = 0; f < numFaces; ++f) PetscCall(DMPlexSetConeSize(dm, f, 4));
5599566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
5607b59f5a9SMichael Lange 
5617b59f5a9SMichael Lange     /* Side 0 (Top) */
5627b59f5a9SMichael Lange     for (vy = 0; vy < faces[1]; vy++) {
5637b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
5647b59f5a9SMichael Lange         voffset = numFaces + vertices[0] * vertices[1] * (vertices[2] - 1) + vy * vertices[0] + vx;
5659371c9d4SSatish Balay         cone[0] = voffset;
5669371c9d4SSatish Balay         cone[1] = voffset + 1;
5679371c9d4SSatish Balay         cone[2] = voffset + vertices[0] + 1;
5689371c9d4SSatish Balay         cone[3] = voffset + vertices[0];
5699566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
570c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerTop));
571c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerTop));
572c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerTop));
573c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerTop));
574c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 1, markerTop));
5757b59f5a9SMichael Lange         iface++;
576552f7358SJed Brown       }
577552f7358SJed Brown     }
5787b59f5a9SMichael Lange 
5797b59f5a9SMichael Lange     /* Side 1 (Bottom) */
5807b59f5a9SMichael Lange     for (vy = 0; vy < faces[1]; vy++) {
5817b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
5827b59f5a9SMichael Lange         voffset = numFaces + vy * (faces[0] + 1) + vx;
5839371c9d4SSatish Balay         cone[0] = voffset + 1;
5849371c9d4SSatish Balay         cone[1] = voffset;
5859371c9d4SSatish Balay         cone[2] = voffset + vertices[0];
5869371c9d4SSatish Balay         cone[3] = voffset + vertices[0] + 1;
5879566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
588c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerBottom));
589c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerBottom));
590c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerBottom));
591c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerBottom));
592c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 1, markerBottom));
5937b59f5a9SMichael Lange         iface++;
594552f7358SJed Brown       }
595552f7358SJed Brown     }
5967b59f5a9SMichael Lange 
5977b59f5a9SMichael Lange     /* Side 2 (Front) */
5987b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
5997b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
6007b59f5a9SMichael Lange         voffset = numFaces + vz * vertices[0] * vertices[1] + vx;
6019371c9d4SSatish Balay         cone[0] = voffset;
6029371c9d4SSatish Balay         cone[1] = voffset + 1;
6039371c9d4SSatish Balay         cone[2] = voffset + vertices[0] * vertices[1] + 1;
6049371c9d4SSatish Balay         cone[3] = voffset + vertices[0] * vertices[1];
6059566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
606c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerFront));
607c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerFront));
608c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerFront));
609c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 0, markerFront));
610c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 1, markerFront));
6117b59f5a9SMichael Lange         iface++;
612552f7358SJed Brown       }
6137b59f5a9SMichael Lange     }
6147b59f5a9SMichael Lange 
6157b59f5a9SMichael Lange     /* Side 3 (Back) */
6167b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
6177b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
6187b59f5a9SMichael Lange         voffset = numFaces + vz * vertices[0] * vertices[1] + vertices[0] * (vertices[1] - 1) + vx;
6199371c9d4SSatish Balay         cone[0] = voffset + vertices[0] * vertices[1];
6209371c9d4SSatish Balay         cone[1] = voffset + vertices[0] * vertices[1] + 1;
6219371c9d4SSatish Balay         cone[2] = voffset + 1;
6229371c9d4SSatish Balay         cone[3] = voffset;
6239566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
624c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerBack));
625c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerBack));
626c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerBack));
627c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 0, markerBack));
628c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 1, markerBack));
6297b59f5a9SMichael Lange         iface++;
6307b59f5a9SMichael Lange       }
6317b59f5a9SMichael Lange     }
6327b59f5a9SMichael Lange 
6337b59f5a9SMichael Lange     /* Side 4 (Left) */
6347b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
6357b59f5a9SMichael Lange       for (vy = 0; vy < faces[1]; vy++) {
6367b59f5a9SMichael Lange         voffset = numFaces + vz * vertices[0] * vertices[1] + vy * vertices[0];
6379371c9d4SSatish Balay         cone[0] = voffset;
6389371c9d4SSatish Balay         cone[1] = voffset + vertices[0] * vertices[1];
6399371c9d4SSatish Balay         cone[2] = voffset + vertices[0] * vertices[1] + vertices[0];
6409371c9d4SSatish Balay         cone[3] = voffset + vertices[0];
6419566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
642c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerLeft));
643c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerLeft));
644c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerLeft));
645c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[1] + 0, markerLeft));
646c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + vertices[0], markerLeft));
6477b59f5a9SMichael Lange         iface++;
6487b59f5a9SMichael Lange       }
6497b59f5a9SMichael Lange     }
6507b59f5a9SMichael Lange 
6517b59f5a9SMichael Lange     /* Side 5 (Right) */
6527b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
6537b59f5a9SMichael Lange       for (vy = 0; vy < faces[1]; vy++) {
654aab5bcd8SJed Brown         voffset = numFaces + vz * vertices[0] * vertices[1] + vy * vertices[0] + faces[0];
6559371c9d4SSatish Balay         cone[0] = voffset + vertices[0] * vertices[1];
6569371c9d4SSatish Balay         cone[1] = voffset;
6579371c9d4SSatish Balay         cone[2] = voffset + vertices[0];
6589371c9d4SSatish Balay         cone[3] = voffset + vertices[0] * vertices[1] + vertices[0];
6599566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
660c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerRight));
661c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerRight));
662c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerRight));
663c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 0, markerRight));
664c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + vertices[0], markerRight));
6657b59f5a9SMichael Lange         iface++;
6667b59f5a9SMichael Lange       }
667552f7358SJed Brown     }
668552f7358SJed Brown   }
6699566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
6709566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
671552f7358SJed Brown   /* Build coordinates */
6729566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, 3));
6739566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
6749566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
6759566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, numFaces, numFaces + numVertices));
6769566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, 3));
677552f7358SJed Brown   for (v = numFaces; v < numFaces + numVertices; ++v) {
6789566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, 3));
6799566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, 3));
680552f7358SJed Brown   }
6819566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
6829566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
6839566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
6849566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
6859566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
6869566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, 3));
6879566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
6889566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
689552f7358SJed Brown   for (vz = 0; vz <= faces[2]; ++vz) {
690552f7358SJed Brown     for (vy = 0; vy <= faces[1]; ++vy) {
691552f7358SJed Brown       for (vx = 0; vx <= faces[0]; ++vx) {
692552f7358SJed Brown         coords[((vz * (faces[1] + 1) + vy) * (faces[0] + 1) + vx) * 3 + 0] = lower[0] + ((upper[0] - lower[0]) / faces[0]) * vx;
693552f7358SJed Brown         coords[((vz * (faces[1] + 1) + vy) * (faces[0] + 1) + vx) * 3 + 1] = lower[1] + ((upper[1] - lower[1]) / faces[1]) * vy;
694552f7358SJed Brown         coords[((vz * (faces[1] + 1) + vy) * (faces[0] + 1) + vx) * 3 + 2] = lower[2] + ((upper[2] - lower[2]) / faces[2]) * vz;
695552f7358SJed Brown       }
696552f7358SJed Brown     }
697552f7358SJed Brown   }
6989566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
6999566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
7009566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
7013ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
702552f7358SJed Brown }
703552f7358SJed Brown 
704d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Internal(DM dm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], PetscBool interpolate)
705d71ae5a4SJacob Faibussowitsch {
7069318fe57SMatthew G. Knepley   PetscFunctionBegin;
7079318fe57SMatthew G. Knepley   PetscValidLogicalCollectiveInt(dm, dim, 2);
70846139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
7099566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim - 1));
7109566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, dim));
7119318fe57SMatthew G. Knepley   switch (dim) {
712d71ae5a4SJacob Faibussowitsch   case 1:
713d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexCreateBoxSurfaceMesh_Tensor_1D_Internal(dm, lower, upper, faces));
714d71ae5a4SJacob Faibussowitsch     break;
715d71ae5a4SJacob Faibussowitsch   case 2:
716d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexCreateBoxSurfaceMesh_Tensor_2D_Internal(dm, lower, upper, faces));
717d71ae5a4SJacob Faibussowitsch     break;
718d71ae5a4SJacob Faibussowitsch   case 3:
719d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexCreateBoxSurfaceMesh_Tensor_3D_Internal(dm, lower, upper, faces));
720d71ae5a4SJacob Faibussowitsch     break;
721d71ae5a4SJacob Faibussowitsch   default:
722d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Dimension not supported: %" PetscInt_FMT, dim);
7239318fe57SMatthew G. Knepley   }
72446139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
7259566063dSJacob Faibussowitsch   if (interpolate) PetscCall(DMPlexInterpolateInPlace_Internal(dm));
7263ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
7279318fe57SMatthew G. Knepley }
7289318fe57SMatthew G. Knepley 
7299318fe57SMatthew G. Knepley /*@C
7309318fe57SMatthew G. Knepley   DMPlexCreateBoxSurfaceMesh - Creates a mesh on the surface of the tensor product of unit intervals (box) using tensor cells (hexahedra).
7319318fe57SMatthew G. Knepley 
7329318fe57SMatthew G. Knepley   Collective
7339318fe57SMatthew G. Knepley 
7349318fe57SMatthew G. Knepley   Input Parameters:
735a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
73620f4b53cSBarry Smith . dim         - The spatial dimension of the box, so the resulting mesh is has dimension `dim`-1
73720f4b53cSBarry Smith . faces       - Number of faces per dimension, or `NULL` for (1,) in 1D and (2, 2) in 2D and (1, 1, 1) in 3D
73820f4b53cSBarry Smith . lower       - The lower left corner, or `NULL` for (0, 0, 0)
73920f4b53cSBarry Smith . upper       - The upper right corner, or `NULL` for (1, 1, 1)
7409318fe57SMatthew G. Knepley - interpolate - Flag to create intermediate mesh pieces (edges, faces)
7419318fe57SMatthew G. Knepley 
7429318fe57SMatthew G. Knepley   Output Parameter:
743a1cb98faSBarry Smith . dm - The `DM` object
7449318fe57SMatthew G. Knepley 
7459318fe57SMatthew G. Knepley   Level: beginner
7469318fe57SMatthew G. Knepley 
7471cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMSetFromOptions()`, `DMPlexCreateBoxMesh()`, `DMPlexCreateFromFile()`, `DMSetType()`, `DMCreate()`
7489318fe57SMatthew G. Knepley @*/
749d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateBoxSurfaceMesh(MPI_Comm comm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], PetscBool interpolate, DM *dm)
750d71ae5a4SJacob Faibussowitsch {
7519318fe57SMatthew G. Knepley   PetscInt  fac[3] = {1, 1, 1};
7529318fe57SMatthew G. Knepley   PetscReal low[3] = {0, 0, 0};
7539318fe57SMatthew G. Knepley   PetscReal upp[3] = {1, 1, 1};
7549318fe57SMatthew G. Knepley 
7559318fe57SMatthew G. Knepley   PetscFunctionBegin;
7569566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
7579566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
7589566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBoxSurfaceMesh_Internal(*dm, dim, faces ? faces : fac, lower ? lower : low, upper ? upper : upp, interpolate));
7593ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
7609318fe57SMatthew G. Knepley }
7619318fe57SMatthew G. Knepley 
762d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateLineMesh_Internal(DM dm, PetscInt segments, PetscReal lower, PetscReal upper, DMBoundaryType bd)
763d71ae5a4SJacob Faibussowitsch {
764fdbf62faSLisandro Dalcin   PetscInt     i, fStart, fEnd, numCells = 0, numVerts = 0;
765fdbf62faSLisandro Dalcin   PetscInt     numPoints[2], *coneSize, *cones, *coneOrientations;
766fdbf62faSLisandro Dalcin   PetscScalar *vertexCoords;
767fdbf62faSLisandro Dalcin   PetscReal    L, maxCell;
768fdbf62faSLisandro Dalcin   PetscBool    markerSeparate = PETSC_FALSE;
769fdbf62faSLisandro Dalcin   PetscInt     markerLeft = 1, faceMarkerLeft = 1;
770fdbf62faSLisandro Dalcin   PetscInt     markerRight = 1, faceMarkerRight = 2;
771fdbf62faSLisandro Dalcin   PetscBool    wrap = (bd == DM_BOUNDARY_PERIODIC || bd == DM_BOUNDARY_TWIST) ? PETSC_TRUE : PETSC_FALSE;
772fdbf62faSLisandro Dalcin   PetscMPIInt  rank;
773fdbf62faSLisandro Dalcin 
774fdbf62faSLisandro Dalcin   PetscFunctionBegin;
7754f572ea9SToby Isaac   PetscAssertPointer(dm, 1);
776fdbf62faSLisandro Dalcin 
7779566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, 1));
7789566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "marker"));
7799566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "Face Sets"));
780fdbf62faSLisandro Dalcin 
7819566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
782dd400576SPatrick Sanan   if (rank == 0) numCells = segments;
783dd400576SPatrick Sanan   if (rank == 0) numVerts = segments + (wrap ? 0 : 1);
784fdbf62faSLisandro Dalcin 
7859371c9d4SSatish Balay   numPoints[0] = numVerts;
7869371c9d4SSatish Balay   numPoints[1] = numCells;
7879566063dSJacob Faibussowitsch   PetscCall(PetscMalloc4(numCells + numVerts, &coneSize, numCells * 2, &cones, numCells + numVerts, &coneOrientations, numVerts, &vertexCoords));
7889566063dSJacob Faibussowitsch   PetscCall(PetscArrayzero(coneOrientations, numCells + numVerts));
789ad540459SPierre Jolivet   for (i = 0; i < numCells; ++i) coneSize[i] = 2;
790ad540459SPierre Jolivet   for (i = 0; i < numVerts; ++i) coneSize[numCells + i] = 0;
7919371c9d4SSatish Balay   for (i = 0; i < numCells; ++i) {
7929371c9d4SSatish Balay     cones[2 * i]     = numCells + i % numVerts;
7939371c9d4SSatish Balay     cones[2 * i + 1] = numCells + (i + 1) % numVerts;
7949371c9d4SSatish Balay   }
795ad540459SPierre Jolivet   for (i = 0; i < numVerts; ++i) vertexCoords[i] = lower + (upper - lower) * ((PetscReal)i / (PetscReal)numCells);
7969566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
7979566063dSJacob Faibussowitsch   PetscCall(PetscFree4(coneSize, cones, coneOrientations, vertexCoords));
798fdbf62faSLisandro Dalcin 
7999566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
8009371c9d4SSatish Balay   if (markerSeparate) {
8019371c9d4SSatish Balay     markerLeft  = faceMarkerLeft;
8029371c9d4SSatish Balay     markerRight = faceMarkerRight;
8039371c9d4SSatish Balay   }
804dd400576SPatrick Sanan   if (!wrap && rank == 0) {
8059566063dSJacob Faibussowitsch     PetscCall(DMPlexGetHeightStratum(dm, 1, &fStart, &fEnd));
8069566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", fStart, markerLeft));
8079566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", fEnd - 1, markerRight));
8089566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "Face Sets", fStart, faceMarkerLeft));
8099566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "Face Sets", fEnd - 1, faceMarkerRight));
810fdbf62faSLisandro Dalcin   }
811fdbf62faSLisandro Dalcin   if (wrap) {
812fdbf62faSLisandro Dalcin     L       = upper - lower;
813fdbf62faSLisandro Dalcin     maxCell = (PetscReal)1.1 * (L / (PetscReal)PetscMax(1, segments));
8144fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dm, &maxCell, &lower, &L));
815fdbf62faSLisandro Dalcin   }
8169566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
8173ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
818fdbf62faSLisandro Dalcin }
819fdbf62faSLisandro Dalcin 
820d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxMesh_Simplex_Internal(DM dm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[], PetscBool interpolate)
821d71ae5a4SJacob Faibussowitsch {
8229318fe57SMatthew G. Knepley   DM      boundary, vol;
823c22d3578SMatthew G. Knepley   DMLabel bdlabel;
824d6218766SMatthew G. Knepley 
825d6218766SMatthew G. Knepley   PetscFunctionBegin;
8264f572ea9SToby Isaac   PetscAssertPointer(dm, 1);
827c22d3578SMatthew 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");
8289566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &boundary));
8299566063dSJacob Faibussowitsch   PetscCall(DMSetType(boundary, DMPLEX));
8309566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBoxSurfaceMesh_Internal(boundary, dim, faces, lower, upper, PETSC_FALSE));
8319566063dSJacob Faibussowitsch   PetscCall(DMPlexGenerate(boundary, NULL, interpolate, &vol));
832c22d3578SMatthew G. Knepley   PetscCall(DMGetLabel(vol, "marker", &bdlabel));
833c22d3578SMatthew G. Knepley   if (bdlabel) PetscCall(DMPlexLabelComplete(vol, bdlabel));
8345de52c6dSVaclav Hapla   PetscCall(DMPlexCopy_Internal(dm, PETSC_TRUE, PETSC_FALSE, vol));
83569d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
8369566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&boundary));
8373ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
838d6218766SMatthew G. Knepley }
839d6218766SMatthew G. Knepley 
840d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateCubeMesh_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[], DMBoundaryType bdX, DMBoundaryType bdY, DMBoundaryType bdZ)
841d71ae5a4SJacob Faibussowitsch {
842ed0e4b50SMatthew G. Knepley   DMLabel     cutLabel  = NULL;
843f4eb4c5dSMatthew G. Knepley   PetscInt    markerTop = 1, faceMarkerTop = 1;
844f4eb4c5dSMatthew G. Knepley   PetscInt    markerBottom = 1, faceMarkerBottom = 1;
845f4eb4c5dSMatthew G. Knepley   PetscInt    markerFront = 1, faceMarkerFront = 1;
846f4eb4c5dSMatthew G. Knepley   PetscInt    markerBack = 1, faceMarkerBack = 1;
847f4eb4c5dSMatthew G. Knepley   PetscInt    markerRight = 1, faceMarkerRight = 1;
848f4eb4c5dSMatthew G. Knepley   PetscInt    markerLeft = 1, faceMarkerLeft = 1;
8493dfda0b1SToby Isaac   PetscInt    dim;
850d8211ee3SMatthew G. Knepley   PetscBool   markerSeparate = PETSC_FALSE, cutMarker = PETSC_FALSE;
8513dfda0b1SToby Isaac   PetscMPIInt rank;
8523dfda0b1SToby Isaac 
8533dfda0b1SToby Isaac   PetscFunctionBegin;
8549566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
8559566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
8569566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "marker"));
8579566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "Face Sets"));
8589566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_periodic_cut", &cutMarker, NULL));
8599371c9d4SSatish 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) {
8609371c9d4SSatish Balay     if (cutMarker) {
8619371c9d4SSatish Balay       PetscCall(DMCreateLabel(dm, "periodic_cut"));
8629371c9d4SSatish Balay       PetscCall(DMGetLabel(dm, "periodic_cut", &cutLabel));
8639371c9d4SSatish Balay     }
864d8211ee3SMatthew G. Knepley   }
8653dfda0b1SToby Isaac   switch (dim) {
8663dfda0b1SToby Isaac   case 2:
867f4eb4c5dSMatthew G. Knepley     faceMarkerTop    = 3;
868f4eb4c5dSMatthew G. Knepley     faceMarkerBottom = 1;
869f4eb4c5dSMatthew G. Knepley     faceMarkerRight  = 2;
870f4eb4c5dSMatthew G. Knepley     faceMarkerLeft   = 4;
8713dfda0b1SToby Isaac     break;
8723dfda0b1SToby Isaac   case 3:
873f4eb4c5dSMatthew G. Knepley     faceMarkerBottom = 1;
874f4eb4c5dSMatthew G. Knepley     faceMarkerTop    = 2;
875f4eb4c5dSMatthew G. Knepley     faceMarkerFront  = 3;
876f4eb4c5dSMatthew G. Knepley     faceMarkerBack   = 4;
877f4eb4c5dSMatthew G. Knepley     faceMarkerRight  = 5;
878f4eb4c5dSMatthew G. Knepley     faceMarkerLeft   = 6;
8793dfda0b1SToby Isaac     break;
880d71ae5a4SJacob Faibussowitsch   default:
881d71ae5a4SJacob Faibussowitsch     SETERRQ(PETSC_COMM_SELF, PETSC_ERR_SUP, "Dimension %" PetscInt_FMT " not supported", dim);
8823dfda0b1SToby Isaac   }
8839566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
884f4eb4c5dSMatthew G. Knepley   if (markerSeparate) {
885f4eb4c5dSMatthew G. Knepley     markerBottom = faceMarkerBottom;
886f4eb4c5dSMatthew G. Knepley     markerTop    = faceMarkerTop;
887f4eb4c5dSMatthew G. Knepley     markerFront  = faceMarkerFront;
888f4eb4c5dSMatthew G. Knepley     markerBack   = faceMarkerBack;
889f4eb4c5dSMatthew G. Knepley     markerRight  = faceMarkerRight;
890f4eb4c5dSMatthew G. Knepley     markerLeft   = faceMarkerLeft;
8913dfda0b1SToby Isaac   }
8923dfda0b1SToby Isaac   {
893dd400576SPatrick Sanan     const PetscInt numXEdges    = rank == 0 ? edges[0] : 0;
894dd400576SPatrick Sanan     const PetscInt numYEdges    = rank == 0 ? edges[1] : 0;
895dd400576SPatrick Sanan     const PetscInt numZEdges    = rank == 0 ? edges[2] : 0;
896dd400576SPatrick Sanan     const PetscInt numXVertices = rank == 0 ? (bdX == DM_BOUNDARY_PERIODIC || bdX == DM_BOUNDARY_TWIST ? edges[0] : edges[0] + 1) : 0;
897dd400576SPatrick Sanan     const PetscInt numYVertices = rank == 0 ? (bdY == DM_BOUNDARY_PERIODIC || bdY == DM_BOUNDARY_TWIST ? edges[1] : edges[1] + 1) : 0;
898dd400576SPatrick Sanan     const PetscInt numZVertices = rank == 0 ? (bdZ == DM_BOUNDARY_PERIODIC || bdZ == DM_BOUNDARY_TWIST ? edges[2] : edges[2] + 1) : 0;
8993dfda0b1SToby Isaac     const PetscInt numCells     = numXEdges * numYEdges * numZEdges;
9003dfda0b1SToby Isaac     const PetscInt numXFaces    = numYEdges * numZEdges;
9013dfda0b1SToby Isaac     const PetscInt numYFaces    = numXEdges * numZEdges;
9023dfda0b1SToby Isaac     const PetscInt numZFaces    = numXEdges * numYEdges;
9033dfda0b1SToby Isaac     const PetscInt numTotXFaces = numXVertices * numXFaces;
9043dfda0b1SToby Isaac     const PetscInt numTotYFaces = numYVertices * numYFaces;
9053dfda0b1SToby Isaac     const PetscInt numTotZFaces = numZVertices * numZFaces;
9063dfda0b1SToby Isaac     const PetscInt numFaces     = numTotXFaces + numTotYFaces + numTotZFaces;
9073dfda0b1SToby Isaac     const PetscInt numTotXEdges = numXEdges * numYVertices * numZVertices;
9083dfda0b1SToby Isaac     const PetscInt numTotYEdges = numYEdges * numXVertices * numZVertices;
9093dfda0b1SToby Isaac     const PetscInt numTotZEdges = numZEdges * numXVertices * numYVertices;
9103dfda0b1SToby Isaac     const PetscInt numVertices  = numXVertices * numYVertices * numZVertices;
9113dfda0b1SToby Isaac     const PetscInt numEdges     = numTotXEdges + numTotYEdges + numTotZEdges;
9123dfda0b1SToby Isaac     const PetscInt firstVertex  = (dim == 2) ? numFaces : numCells;
9133dfda0b1SToby Isaac     const PetscInt firstXFace   = (dim == 2) ? 0 : numCells + numVertices;
9143dfda0b1SToby Isaac     const PetscInt firstYFace   = firstXFace + numTotXFaces;
9153dfda0b1SToby Isaac     const PetscInt firstZFace   = firstYFace + numTotYFaces;
9163dfda0b1SToby Isaac     const PetscInt firstXEdge   = numCells + numFaces + numVertices;
9173dfda0b1SToby Isaac     const PetscInt firstYEdge   = firstXEdge + numTotXEdges;
9183dfda0b1SToby Isaac     const PetscInt firstZEdge   = firstYEdge + numTotYEdges;
9193dfda0b1SToby Isaac     Vec            coordinates;
9203dfda0b1SToby Isaac     PetscSection   coordSection;
9213dfda0b1SToby Isaac     PetscScalar   *coords;
9223dfda0b1SToby Isaac     PetscInt       coordSize;
9233dfda0b1SToby Isaac     PetscInt       v, vx, vy, vz;
9243dfda0b1SToby Isaac     PetscInt       c, f, fx, fy, fz, e, ex, ey, ez;
9253dfda0b1SToby Isaac 
9269566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numCells + numFaces + numEdges + numVertices));
92748a46eb9SPierre Jolivet     for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 6));
92848a46eb9SPierre Jolivet     for (f = firstXFace; f < firstXFace + numFaces; ++f) PetscCall(DMPlexSetConeSize(dm, f, 4));
92948a46eb9SPierre Jolivet     for (e = firstXEdge; e < firstXEdge + numEdges; ++e) PetscCall(DMPlexSetConeSize(dm, e, 2));
9309566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
9313dfda0b1SToby Isaac     /* Build cells */
9323dfda0b1SToby Isaac     for (fz = 0; fz < numZEdges; ++fz) {
9333dfda0b1SToby Isaac       for (fy = 0; fy < numYEdges; ++fy) {
9343dfda0b1SToby Isaac         for (fx = 0; fx < numXEdges; ++fx) {
9353dfda0b1SToby Isaac           PetscInt cell  = (fz * numYEdges + fy) * numXEdges + fx;
9363dfda0b1SToby Isaac           PetscInt faceB = firstZFace + (fy * numXEdges + fx) * numZVertices + fz;
9373dfda0b1SToby Isaac           PetscInt faceT = firstZFace + (fy * numXEdges + fx) * numZVertices + ((fz + 1) % numZVertices);
9383dfda0b1SToby Isaac           PetscInt faceF = firstYFace + (fz * numXEdges + fx) * numYVertices + fy;
9393dfda0b1SToby Isaac           PetscInt faceK = firstYFace + (fz * numXEdges + fx) * numYVertices + ((fy + 1) % numYVertices);
9403dfda0b1SToby Isaac           PetscInt faceL = firstXFace + (fz * numYEdges + fy) * numXVertices + fx;
9413dfda0b1SToby Isaac           PetscInt faceR = firstXFace + (fz * numYEdges + fy) * numXVertices + ((fx + 1) % numXVertices);
9423dfda0b1SToby Isaac           /* B,  T,  F,  K,  R,  L */
943b5a892a1SMatthew G. Knepley           PetscInt ornt[6] = {-2, 0, 0, -3, 0, -2}; /* ??? */
94442206facSLisandro Dalcin           PetscInt cone[6];
9453dfda0b1SToby Isaac 
9463dfda0b1SToby Isaac           /* no boundary twisting in 3D */
9479371c9d4SSatish Balay           cone[0] = faceB;
9489371c9d4SSatish Balay           cone[1] = faceT;
9499371c9d4SSatish Balay           cone[2] = faceF;
9509371c9d4SSatish Balay           cone[3] = faceK;
9519371c9d4SSatish Balay           cone[4] = faceR;
9529371c9d4SSatish Balay           cone[5] = faceL;
9539566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, cell, cone));
9549566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, cell, ornt));
9559566063dSJacob Faibussowitsch           if (bdX != DM_BOUNDARY_NONE && fx == numXEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, cell, 2));
9569566063dSJacob Faibussowitsch           if (bdY != DM_BOUNDARY_NONE && fy == numYEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, cell, 2));
9579566063dSJacob Faibussowitsch           if (bdZ != DM_BOUNDARY_NONE && fz == numZEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, cell, 2));
9583dfda0b1SToby Isaac         }
9593dfda0b1SToby Isaac       }
9603dfda0b1SToby Isaac     }
9613dfda0b1SToby Isaac     /* Build x faces */
9623dfda0b1SToby Isaac     for (fz = 0; fz < numZEdges; ++fz) {
9633dfda0b1SToby Isaac       for (fy = 0; fy < numYEdges; ++fy) {
9643dfda0b1SToby Isaac         for (fx = 0; fx < numXVertices; ++fx) {
9653dfda0b1SToby Isaac           PetscInt face    = firstXFace + (fz * numYEdges + fy) * numXVertices + fx;
9663dfda0b1SToby Isaac           PetscInt edgeL   = firstZEdge + (fy * numXVertices + fx) * numZEdges + fz;
9673dfda0b1SToby Isaac           PetscInt edgeR   = firstZEdge + (((fy + 1) % numYVertices) * numXVertices + fx) * numZEdges + fz;
9683dfda0b1SToby Isaac           PetscInt edgeB   = firstYEdge + (fz * numXVertices + fx) * numYEdges + fy;
9693dfda0b1SToby Isaac           PetscInt edgeT   = firstYEdge + (((fz + 1) % numZVertices) * numXVertices + fx) * numYEdges + fy;
970b5a892a1SMatthew G. Knepley           PetscInt ornt[4] = {0, 0, -1, -1};
9713dfda0b1SToby Isaac           PetscInt cone[4];
9723dfda0b1SToby Isaac 
9733dfda0b1SToby Isaac           if (dim == 3) {
9743dfda0b1SToby Isaac             /* markers */
9753dfda0b1SToby Isaac             if (bdX != DM_BOUNDARY_PERIODIC) {
9763dfda0b1SToby Isaac               if (fx == numXVertices - 1) {
9779566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerRight));
9789566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerRight));
9799371c9d4SSatish Balay               } else if (fx == 0) {
9809566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerLeft));
9819566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerLeft));
9823dfda0b1SToby Isaac               }
9833dfda0b1SToby Isaac             }
9843dfda0b1SToby Isaac           }
9859371c9d4SSatish Balay           cone[0] = edgeB;
9869371c9d4SSatish Balay           cone[1] = edgeR;
9879371c9d4SSatish Balay           cone[2] = edgeT;
9889371c9d4SSatish Balay           cone[3] = edgeL;
9899566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, face, cone));
9909566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, face, ornt));
9913dfda0b1SToby Isaac         }
9923dfda0b1SToby Isaac       }
9933dfda0b1SToby Isaac     }
9943dfda0b1SToby Isaac     /* Build y faces */
9953dfda0b1SToby Isaac     for (fz = 0; fz < numZEdges; ++fz) {
99642206facSLisandro Dalcin       for (fx = 0; fx < numXEdges; ++fx) {
9973dfda0b1SToby Isaac         for (fy = 0; fy < numYVertices; ++fy) {
9983dfda0b1SToby Isaac           PetscInt face    = firstYFace + (fz * numXEdges + fx) * numYVertices + fy;
9993dfda0b1SToby Isaac           PetscInt edgeL   = firstZEdge + (fy * numXVertices + fx) * numZEdges + fz;
10003dfda0b1SToby Isaac           PetscInt edgeR   = firstZEdge + (fy * numXVertices + ((fx + 1) % numXVertices)) * numZEdges + fz;
10013dfda0b1SToby Isaac           PetscInt edgeB   = firstXEdge + (fz * numYVertices + fy) * numXEdges + fx;
10023dfda0b1SToby Isaac           PetscInt edgeT   = firstXEdge + (((fz + 1) % numZVertices) * numYVertices + fy) * numXEdges + fx;
1003b5a892a1SMatthew G. Knepley           PetscInt ornt[4] = {0, 0, -1, -1};
10043dfda0b1SToby Isaac           PetscInt cone[4];
10053dfda0b1SToby Isaac 
10063dfda0b1SToby Isaac           if (dim == 3) {
10073dfda0b1SToby Isaac             /* markers */
10083dfda0b1SToby Isaac             if (bdY != DM_BOUNDARY_PERIODIC) {
10093dfda0b1SToby Isaac               if (fy == numYVertices - 1) {
10109566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerBack));
10119566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerBack));
10129371c9d4SSatish Balay               } else if (fy == 0) {
10139566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerFront));
10149566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerFront));
10153dfda0b1SToby Isaac               }
10163dfda0b1SToby Isaac             }
10173dfda0b1SToby Isaac           }
10189371c9d4SSatish Balay           cone[0] = edgeB;
10199371c9d4SSatish Balay           cone[1] = edgeR;
10209371c9d4SSatish Balay           cone[2] = edgeT;
10219371c9d4SSatish Balay           cone[3] = edgeL;
10229566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, face, cone));
10239566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, face, ornt));
10243dfda0b1SToby Isaac         }
10253dfda0b1SToby Isaac       }
10263dfda0b1SToby Isaac     }
10273dfda0b1SToby Isaac     /* Build z faces */
10283dfda0b1SToby Isaac     for (fy = 0; fy < numYEdges; ++fy) {
10293dfda0b1SToby Isaac       for (fx = 0; fx < numXEdges; ++fx) {
10303dfda0b1SToby Isaac         for (fz = 0; fz < numZVertices; fz++) {
10313dfda0b1SToby Isaac           PetscInt face    = firstZFace + (fy * numXEdges + fx) * numZVertices + fz;
10323dfda0b1SToby Isaac           PetscInt edgeL   = firstYEdge + (fz * numXVertices + fx) * numYEdges + fy;
10333dfda0b1SToby Isaac           PetscInt edgeR   = firstYEdge + (fz * numXVertices + ((fx + 1) % numXVertices)) * numYEdges + fy;
10343dfda0b1SToby Isaac           PetscInt edgeB   = firstXEdge + (fz * numYVertices + fy) * numXEdges + fx;
10353dfda0b1SToby Isaac           PetscInt edgeT   = firstXEdge + (fz * numYVertices + ((fy + 1) % numYVertices)) * numXEdges + fx;
1036b5a892a1SMatthew G. Knepley           PetscInt ornt[4] = {0, 0, -1, -1};
10373dfda0b1SToby Isaac           PetscInt cone[4];
10383dfda0b1SToby Isaac 
10393dfda0b1SToby Isaac           if (dim == 2) {
10409371c9d4SSatish Balay             if (bdX == DM_BOUNDARY_TWIST && fx == numXEdges - 1) {
10419371c9d4SSatish Balay               edgeR += numYEdges - 1 - 2 * fy;
10429371c9d4SSatish Balay               ornt[1] = -1;
10439371c9d4SSatish Balay             }
10449371c9d4SSatish Balay             if (bdY == DM_BOUNDARY_TWIST && fy == numYEdges - 1) {
10459371c9d4SSatish Balay               edgeT += numXEdges - 1 - 2 * fx;
10469371c9d4SSatish Balay               ornt[2] = 0;
10479371c9d4SSatish Balay             }
10489566063dSJacob Faibussowitsch             if (bdX != DM_BOUNDARY_NONE && fx == numXEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, face, 2));
10499566063dSJacob Faibussowitsch             if (bdY != DM_BOUNDARY_NONE && fy == numYEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, face, 2));
1050d1c88043SMatthew G. Knepley           } else {
10513dfda0b1SToby Isaac             /* markers */
10523dfda0b1SToby Isaac             if (bdZ != DM_BOUNDARY_PERIODIC) {
10533dfda0b1SToby Isaac               if (fz == numZVertices - 1) {
10549566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerTop));
10559566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerTop));
10569371c9d4SSatish Balay               } else if (fz == 0) {
10579566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerBottom));
10589566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerBottom));
10593dfda0b1SToby Isaac               }
10603dfda0b1SToby Isaac             }
10613dfda0b1SToby Isaac           }
10629371c9d4SSatish Balay           cone[0] = edgeB;
10639371c9d4SSatish Balay           cone[1] = edgeR;
10649371c9d4SSatish Balay           cone[2] = edgeT;
10659371c9d4SSatish Balay           cone[3] = edgeL;
10669566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, face, cone));
10679566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, face, ornt));
10683dfda0b1SToby Isaac         }
10693dfda0b1SToby Isaac       }
10703dfda0b1SToby Isaac     }
10713dfda0b1SToby Isaac     /* Build Z edges*/
10723dfda0b1SToby Isaac     for (vy = 0; vy < numYVertices; vy++) {
10733dfda0b1SToby Isaac       for (vx = 0; vx < numXVertices; vx++) {
10743dfda0b1SToby Isaac         for (ez = 0; ez < numZEdges; ez++) {
10753dfda0b1SToby Isaac           const PetscInt edge    = firstZEdge + (vy * numXVertices + vx) * numZEdges + ez;
10763dfda0b1SToby Isaac           const PetscInt vertexB = firstVertex + (ez * numYVertices + vy) * numXVertices + vx;
10773dfda0b1SToby Isaac           const PetscInt vertexT = firstVertex + (((ez + 1) % numZVertices) * numYVertices + vy) * numXVertices + vx;
10783dfda0b1SToby Isaac           PetscInt       cone[2];
10793dfda0b1SToby Isaac 
10809371c9d4SSatish Balay           cone[0] = vertexB;
10819371c9d4SSatish Balay           cone[1] = vertexT;
1082c2df9bbfSMatthew G. Knepley           PetscCall(DMPlexSetCone(dm, edge, cone));
10833dfda0b1SToby Isaac           if (dim == 3) {
10843dfda0b1SToby Isaac             if (bdX != DM_BOUNDARY_PERIODIC) {
10853dfda0b1SToby Isaac               if (vx == numXVertices - 1) {
10869566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
1087c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
1088c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
1089c2df9bbfSMatthew G. Knepley               } else if (vx == 0) {
10909566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
1091c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
1092c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
10933dfda0b1SToby Isaac               }
10943dfda0b1SToby Isaac             }
10953dfda0b1SToby Isaac             if (bdY != DM_BOUNDARY_PERIODIC) {
10963dfda0b1SToby Isaac               if (vy == numYVertices - 1) {
10979566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBack));
1098c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBack));
1099c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBack));
1100c2df9bbfSMatthew G. Knepley               } else if (vy == 0) {
11019566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerFront));
1102c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerFront));
1103c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerFront));
11043dfda0b1SToby Isaac               }
11053dfda0b1SToby Isaac             }
11063dfda0b1SToby Isaac           }
11073dfda0b1SToby Isaac         }
11083dfda0b1SToby Isaac       }
11093dfda0b1SToby Isaac     }
11103dfda0b1SToby Isaac     /* Build Y edges*/
11113dfda0b1SToby Isaac     for (vz = 0; vz < numZVertices; vz++) {
11123dfda0b1SToby Isaac       for (vx = 0; vx < numXVertices; vx++) {
11133dfda0b1SToby Isaac         for (ey = 0; ey < numYEdges; ey++) {
11143dfda0b1SToby Isaac           const PetscInt nextv   = (dim == 2 && bdY == DM_BOUNDARY_TWIST && ey == numYEdges - 1) ? (numXVertices - vx - 1) : (vz * numYVertices + ((ey + 1) % numYVertices)) * numXVertices + vx;
11153dfda0b1SToby Isaac           const PetscInt edge    = firstYEdge + (vz * numXVertices + vx) * numYEdges + ey;
11163dfda0b1SToby Isaac           const PetscInt vertexF = firstVertex + (vz * numYVertices + ey) * numXVertices + vx;
11173dfda0b1SToby Isaac           const PetscInt vertexK = firstVertex + nextv;
11183dfda0b1SToby Isaac           PetscInt       cone[2];
11193dfda0b1SToby Isaac 
11209371c9d4SSatish Balay           cone[0] = vertexF;
11219371c9d4SSatish Balay           cone[1] = vertexK;
11229566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, edge, cone));
11233dfda0b1SToby Isaac           if (dim == 2) {
11243dfda0b1SToby Isaac             if ((bdX != DM_BOUNDARY_PERIODIC) && (bdX != DM_BOUNDARY_TWIST)) {
11253dfda0b1SToby Isaac               if (vx == numXVertices - 1) {
11269566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerRight));
11279566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
11289566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
1129c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
1130d8211ee3SMatthew G. Knepley               } else if (vx == 0) {
11319566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerLeft));
11329566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
11339566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
1134c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
11353dfda0b1SToby Isaac               }
1136d8211ee3SMatthew G. Knepley             } else {
11374c67ea77SStefano Zampini               if (vx == 0 && cutLabel) {
11389566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, edge, 1));
11399566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, cone[0], 1));
1140c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMLabelSetValue(cutLabel, cone[1], 1));
11413dfda0b1SToby Isaac               }
1142d8211ee3SMatthew G. Knepley             }
1143d8211ee3SMatthew G. Knepley           } else {
11443dfda0b1SToby Isaac             if (bdX != DM_BOUNDARY_PERIODIC) {
11453dfda0b1SToby Isaac               if (vx == numXVertices - 1) {
11469566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
1147c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
1148c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
1149d8211ee3SMatthew G. Knepley               } else if (vx == 0) {
11509566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
1151c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
1152c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
11533dfda0b1SToby Isaac               }
11543dfda0b1SToby Isaac             }
11553dfda0b1SToby Isaac             if (bdZ != DM_BOUNDARY_PERIODIC) {
11563dfda0b1SToby Isaac               if (vz == numZVertices - 1) {
11579566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
1158c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
1159c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
1160d8211ee3SMatthew G. Knepley               } else if (vz == 0) {
11619566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
1162c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
1163c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
11643dfda0b1SToby Isaac               }
11653dfda0b1SToby Isaac             }
11663dfda0b1SToby Isaac           }
11673dfda0b1SToby Isaac         }
11683dfda0b1SToby Isaac       }
11693dfda0b1SToby Isaac     }
11703dfda0b1SToby Isaac     /* Build X edges*/
11713dfda0b1SToby Isaac     for (vz = 0; vz < numZVertices; vz++) {
11723dfda0b1SToby Isaac       for (vy = 0; vy < numYVertices; vy++) {
11733dfda0b1SToby Isaac         for (ex = 0; ex < numXEdges; ex++) {
11743dfda0b1SToby Isaac           const PetscInt nextv   = (dim == 2 && bdX == DM_BOUNDARY_TWIST && ex == numXEdges - 1) ? (numYVertices - vy - 1) * numXVertices : (vz * numYVertices + vy) * numXVertices + (ex + 1) % numXVertices;
11753dfda0b1SToby Isaac           const PetscInt edge    = firstXEdge + (vz * numYVertices + vy) * numXEdges + ex;
11763dfda0b1SToby Isaac           const PetscInt vertexL = firstVertex + (vz * numYVertices + vy) * numXVertices + ex;
11773dfda0b1SToby Isaac           const PetscInt vertexR = firstVertex + nextv;
11783dfda0b1SToby Isaac           PetscInt       cone[2];
11793dfda0b1SToby Isaac 
11809371c9d4SSatish Balay           cone[0] = vertexL;
11819371c9d4SSatish Balay           cone[1] = vertexR;
11829566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, edge, cone));
11833dfda0b1SToby Isaac           if (dim == 2) {
11843dfda0b1SToby Isaac             if ((bdY != DM_BOUNDARY_PERIODIC) && (bdY != DM_BOUNDARY_TWIST)) {
11853dfda0b1SToby Isaac               if (vy == numYVertices - 1) {
11869566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerTop));
11879566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
11889566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
1189c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
1190d8211ee3SMatthew G. Knepley               } else if (vy == 0) {
11919566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerBottom));
11929566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
11939566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
1194c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
11953dfda0b1SToby Isaac               }
1196d8211ee3SMatthew G. Knepley             } else {
11974c67ea77SStefano Zampini               if (vy == 0 && cutLabel) {
11989566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, edge, 1));
11999566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, cone[0], 1));
1200c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMLabelSetValue(cutLabel, cone[1], 1));
12013dfda0b1SToby Isaac               }
1202d8211ee3SMatthew G. Knepley             }
1203d8211ee3SMatthew G. Knepley           } else {
12043dfda0b1SToby Isaac             if (bdY != DM_BOUNDARY_PERIODIC) {
12053dfda0b1SToby Isaac               if (vy == numYVertices - 1) {
12069566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBack));
1207c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBack));
1208c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBack));
1209c2df9bbfSMatthew G. Knepley               } else if (vy == 0) {
12109566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerFront));
1211c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerFront));
1212c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerFront));
12133dfda0b1SToby Isaac               }
12143dfda0b1SToby Isaac             }
12153dfda0b1SToby Isaac             if (bdZ != DM_BOUNDARY_PERIODIC) {
12163dfda0b1SToby Isaac               if (vz == numZVertices - 1) {
12179566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
1218c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
1219c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
1220c2df9bbfSMatthew G. Knepley               } else if (vz == 0) {
12219566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
1222c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
1223c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
12243dfda0b1SToby Isaac               }
12253dfda0b1SToby Isaac             }
12263dfda0b1SToby Isaac           }
12273dfda0b1SToby Isaac         }
12283dfda0b1SToby Isaac       }
12293dfda0b1SToby Isaac     }
12309566063dSJacob Faibussowitsch     PetscCall(DMPlexSymmetrize(dm));
12319566063dSJacob Faibussowitsch     PetscCall(DMPlexStratify(dm));
12323dfda0b1SToby Isaac     /* Build coordinates */
12339566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &coordSection));
12349566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetNumFields(coordSection, 1));
12359566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
12369566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numVertices));
12373dfda0b1SToby Isaac     for (v = firstVertex; v < firstVertex + numVertices; ++v) {
12389566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetDof(coordSection, v, dim));
12399566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
12403dfda0b1SToby Isaac     }
12419566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetUp(coordSection));
12429566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
12439566063dSJacob Faibussowitsch     PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
12449566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
12459566063dSJacob Faibussowitsch     PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
12469566063dSJacob Faibussowitsch     PetscCall(VecSetBlockSize(coordinates, dim));
12479566063dSJacob Faibussowitsch     PetscCall(VecSetType(coordinates, VECSTANDARD));
12489566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
12493dfda0b1SToby Isaac     for (vz = 0; vz < numZVertices; ++vz) {
12503dfda0b1SToby Isaac       for (vy = 0; vy < numYVertices; ++vy) {
12513dfda0b1SToby Isaac         for (vx = 0; vx < numXVertices; ++vx) {
12523dfda0b1SToby Isaac           coords[((vz * numYVertices + vy) * numXVertices + vx) * dim + 0] = lower[0] + ((upper[0] - lower[0]) / numXEdges) * vx;
12533dfda0b1SToby Isaac           coords[((vz * numYVertices + vy) * numXVertices + vx) * dim + 1] = lower[1] + ((upper[1] - lower[1]) / numYEdges) * vy;
1254ad540459SPierre Jolivet           if (dim == 3) coords[((vz * numYVertices + vy) * numXVertices + vx) * dim + 2] = lower[2] + ((upper[2] - lower[2]) / numZEdges) * vz;
12553dfda0b1SToby Isaac         }
12563dfda0b1SToby Isaac       }
12573dfda0b1SToby Isaac     }
12589566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(coordinates, &coords));
12599566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, coordinates));
12609566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&coordinates));
12613dfda0b1SToby Isaac   }
12623ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
12633dfda0b1SToby Isaac }
12643dfda0b1SToby Isaac 
1265d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxMesh_Tensor_Internal(DM dm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[])
1266d71ae5a4SJacob Faibussowitsch {
12679318fe57SMatthew G. Knepley   DMBoundaryType bdt[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
12689318fe57SMatthew G. Knepley   PetscInt       fac[3] = {0, 0, 0}, d;
1269552f7358SJed Brown 
1270552f7358SJed Brown   PetscFunctionBegin;
12714f572ea9SToby Isaac   PetscAssertPointer(dm, 1);
12729318fe57SMatthew G. Knepley   PetscValidLogicalCollectiveInt(dm, dim, 2);
12739566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
12749371c9d4SSatish Balay   for (d = 0; d < dim; ++d) {
12759371c9d4SSatish Balay     fac[d] = faces[d];
12769371c9d4SSatish Balay     bdt[d] = periodicity[d];
12779371c9d4SSatish Balay   }
12789566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateCubeMesh_Internal(dm, lower, upper, fac, bdt[0], bdt[1], bdt[2]));
12799371c9d4SSatish 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))) {
12806858538eSMatthew G. Knepley     PetscReal L[3]       = {-1., -1., 0.};
12816858538eSMatthew G. Knepley     PetscReal maxCell[3] = {-1., -1., 0.};
1282552f7358SJed Brown 
12839318fe57SMatthew G. Knepley     for (d = 0; d < dim; ++d) {
12846858538eSMatthew G. Knepley       if (periodicity[d] != DM_BOUNDARY_NONE) {
12859318fe57SMatthew G. Knepley         L[d]       = upper[d] - lower[d];
12869318fe57SMatthew G. Knepley         maxCell[d] = 1.1 * (L[d] / PetscMax(1, faces[d]));
1287768d5fceSMatthew G. Knepley       }
12886858538eSMatthew G. Knepley     }
12894fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dm, maxCell, lower, L));
1290768d5fceSMatthew G. Knepley   }
12919566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
12923ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
12939318fe57SMatthew G. Knepley }
12949318fe57SMatthew G. Knepley 
12955dca41c3SJed 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)
1296d71ae5a4SJacob Faibussowitsch {
12979318fe57SMatthew G. Knepley   PetscFunctionBegin;
129846139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
12995dca41c3SJed Brown   if (shape == DM_SHAPE_ZBOX) PetscCall(DMPlexCreateBoxMesh_Tensor_SFC_Internal(dm, dim, faces, lower, upper, periodicity, interpolate));
13006725e60dSJed Brown   else if (dim == 1) PetscCall(DMPlexCreateLineMesh_Internal(dm, faces[0], lower[0], upper[0], periodicity[0]));
13019566063dSJacob Faibussowitsch   else if (simplex) PetscCall(DMPlexCreateBoxMesh_Simplex_Internal(dm, dim, faces, lower, upper, periodicity, interpolate));
13029566063dSJacob Faibussowitsch   else PetscCall(DMPlexCreateBoxMesh_Tensor_Internal(dm, dim, faces, lower, upper, periodicity));
13039318fe57SMatthew G. Knepley   if (!interpolate && dim > 1 && !simplex) {
1304768d5fceSMatthew G. Knepley     DM udm;
1305768d5fceSMatthew G. Knepley 
13069566063dSJacob Faibussowitsch     PetscCall(DMPlexUninterpolate(dm, &udm));
13079566063dSJacob Faibussowitsch     PetscCall(DMPlexCopyCoordinates(dm, udm));
130869d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &udm));
1309768d5fceSMatthew G. Knepley   }
131046139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
13113ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1312c8c68bd8SToby Isaac }
1313c8c68bd8SToby Isaac 
1314768d5fceSMatthew G. Knepley /*@C
1315768d5fceSMatthew G. Knepley   DMPlexCreateBoxMesh - Creates a mesh on the tensor product of unit intervals (box) using simplices or tensor cells (hexahedra).
1316768d5fceSMatthew G. Knepley 
1317d083f849SBarry Smith   Collective
1318768d5fceSMatthew G. Knepley 
1319768d5fceSMatthew G. Knepley   Input Parameters:
1320a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
1321768d5fceSMatthew G. Knepley . dim         - The spatial dimension
1322a1cb98faSBarry Smith . simplex     - `PETSC_TRUE` for simplices, `PETSC_FALSE` for tensor cells
132320f4b53cSBarry Smith . faces       - Number of faces per dimension, or `NULL` for (1,) in 1D and (2, 2) in 2D and (1, 1, 1) in 3D
132420f4b53cSBarry Smith . lower       - The lower left corner, or `NULL` for (0, 0, 0)
132520f4b53cSBarry Smith . upper       - The upper right corner, or `NULL` for (1, 1, 1)
132620f4b53cSBarry Smith . periodicity - The boundary type for the X,Y,Z direction, or `NULL` for `DM_BOUNDARY_NONE`
1327768d5fceSMatthew G. Knepley - interpolate - Flag to create intermediate mesh pieces (edges, faces)
1328768d5fceSMatthew G. Knepley 
1329768d5fceSMatthew G. Knepley   Output Parameter:
1330a1cb98faSBarry Smith . dm - The `DM` object
1331768d5fceSMatthew G. Knepley 
1332768d5fceSMatthew G. Knepley   Level: beginner
1333768d5fceSMatthew G. Knepley 
1334a1cb98faSBarry Smith   Note:
1335a1cb98faSBarry Smith   To customize this mesh using options, use
1336a1cb98faSBarry Smith .vb
1337a1cb98faSBarry Smith   DMCreate(comm, &dm);
1338a1cb98faSBarry Smith   DMSetType(dm, DMPLEX);
1339a1cb98faSBarry Smith   DMSetFromOptions(dm);
1340a1cb98faSBarry Smith .ve
1341a1cb98faSBarry Smith   and use the options in `DMSetFromOptions()`.
1342a1cb98faSBarry Smith 
1343a4e35b19SJacob Faibussowitsch   Here is the numbering returned for 2 faces in each direction for tensor cells\:
1344a1cb98faSBarry Smith .vb
1345a1cb98faSBarry Smith  10---17---11---18----12
1346a1cb98faSBarry Smith   |         |         |
1347a1cb98faSBarry Smith   |         |         |
1348a1cb98faSBarry Smith  20    2   22    3    24
1349a1cb98faSBarry Smith   |         |         |
1350a1cb98faSBarry Smith   |         |         |
1351a1cb98faSBarry Smith   7---15----8---16----9
1352a1cb98faSBarry Smith   |         |         |
1353a1cb98faSBarry Smith   |         |         |
1354a1cb98faSBarry Smith  19    0   21    1   23
1355a1cb98faSBarry Smith   |         |         |
1356a1cb98faSBarry Smith   |         |         |
1357a1cb98faSBarry Smith   4---13----5---14----6
1358a1cb98faSBarry Smith .ve
1359a1cb98faSBarry Smith   and for simplicial cells
1360a1cb98faSBarry Smith .vb
1361a1cb98faSBarry Smith  14----8---15----9----16
1362a1cb98faSBarry Smith   |\     5  |\      7 |
1363a1cb98faSBarry Smith   | \       | \       |
1364a1cb98faSBarry Smith  13   2    14    3    15
1365a1cb98faSBarry Smith   | 4   \   | 6   \   |
1366a1cb98faSBarry Smith   |       \ |       \ |
1367a1cb98faSBarry Smith  11----6---12----7----13
1368a1cb98faSBarry Smith   |\        |\        |
1369a1cb98faSBarry Smith   | \    1  | \     3 |
1370a1cb98faSBarry Smith  10   0    11    1    12
1371a1cb98faSBarry Smith   | 0   \   | 2   \   |
1372a1cb98faSBarry Smith   |       \ |       \ |
1373a1cb98faSBarry Smith   8----4----9----5----10
1374a1cb98faSBarry Smith .ve
1375a1cb98faSBarry Smith 
13761cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMSetFromOptions()`, `DMPlexCreateFromFile()`, `DMPlexCreateHexCylinderMesh()`, `DMSetType()`, `DMCreate()`
1377768d5fceSMatthew G. Knepley @*/
1378d71ae5a4SJacob 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)
1379d71ae5a4SJacob Faibussowitsch {
13809318fe57SMatthew G. Knepley   PetscInt       fac[3] = {1, 1, 1};
1381fdbf62faSLisandro Dalcin   PetscReal      low[3] = {0, 0, 0};
1382fdbf62faSLisandro Dalcin   PetscReal      upp[3] = {1, 1, 1};
1383fdbf62faSLisandro Dalcin   DMBoundaryType bdt[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
1384552f7358SJed Brown 
1385768d5fceSMatthew G. Knepley   PetscFunctionBegin;
13869566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
13879566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
13885dca41c3SJed Brown   PetscCall(DMPlexCreateBoxMesh_Internal(*dm, DM_SHAPE_BOX, dim, simplex, faces ? faces : fac, lower ? lower : low, upper ? upper : upp, periodicity ? periodicity : bdt, interpolate));
13897ff04441SMatthew G. Knepley   if (periodicity) PetscCall(DMLocalizeCoordinates(*dm));
13903ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
13919318fe57SMatthew G. Knepley }
1392fdbf62faSLisandro Dalcin 
1393d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateWedgeBoxMesh_Internal(DM dm, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[])
1394d71ae5a4SJacob Faibussowitsch {
13959318fe57SMatthew G. Knepley   DM       bdm, vol;
13969318fe57SMatthew G. Knepley   PetscInt i;
13979318fe57SMatthew G. Knepley 
13989318fe57SMatthew G. Knepley   PetscFunctionBegin;
13991fcf445aSMatthew G. Knepley   // TODO Now we can support periodicity
140008401ef6SPierre Jolivet   for (i = 0; i < 3; ++i) PetscCheck(periodicity[i] == DM_BOUNDARY_NONE, PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Periodicity not yet supported");
14019566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &bdm));
14029566063dSJacob Faibussowitsch   PetscCall(DMSetType(bdm, DMPLEX));
14039566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(bdm, 2));
140446139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, bdm, 0, 0, 0));
14059566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBoxMesh_Simplex_Internal(bdm, 2, faces, lower, upper, periodicity, PETSC_TRUE));
14061fcf445aSMatthew G. Knepley   PetscCall(DMPlexExtrude(bdm, faces[2], upper[2] - lower[2], PETSC_TRUE, PETSC_FALSE, PETSC_FALSE, NULL, NULL, &vol));
140746139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, bdm, 0, 0, 0));
14089566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&bdm));
140969d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
14109318fe57SMatthew G. Knepley   if (lower[2] != 0.0) {
14119318fe57SMatthew G. Knepley     Vec          v;
14129318fe57SMatthew G. Knepley     PetscScalar *x;
14139318fe57SMatthew G. Knepley     PetscInt     cDim, n;
14149318fe57SMatthew G. Knepley 
14159566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinatesLocal(dm, &v));
14169566063dSJacob Faibussowitsch     PetscCall(VecGetBlockSize(v, &cDim));
14179566063dSJacob Faibussowitsch     PetscCall(VecGetLocalSize(v, &n));
14189566063dSJacob Faibussowitsch     PetscCall(VecGetArray(v, &x));
14199318fe57SMatthew G. Knepley     x += cDim;
14209318fe57SMatthew G. Knepley     for (i = 0; i < n; i += cDim) x[i] += lower[2];
14219566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(v, &x));
14229566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, v));
14239318fe57SMatthew G. Knepley   }
14243ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1425552f7358SJed Brown }
1426552f7358SJed Brown 
142700dabe28SStefano Zampini /*@
142800dabe28SStefano Zampini   DMPlexCreateWedgeBoxMesh - Creates a 3-D mesh tesselating the (x,y) plane and extruding in the third direction using wedge cells.
142900dabe28SStefano Zampini 
1430d083f849SBarry Smith   Collective
143100dabe28SStefano Zampini 
143200dabe28SStefano Zampini   Input Parameters:
1433a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
143420f4b53cSBarry Smith . faces       - Number of faces per dimension, or `NULL` for (1, 1, 1)
143520f4b53cSBarry Smith . lower       - The lower left corner, or `NULL` for (0, 0, 0)
143620f4b53cSBarry Smith . upper       - The upper right corner, or `NULL` for (1, 1, 1)
143720f4b53cSBarry Smith . periodicity - The boundary type for the X,Y,Z direction, or `NULL` for `DM_BOUNDARY_NONE`
1438a1cb98faSBarry Smith . orderHeight - If `PETSC_TRUE`, orders the extruded cells in the height first. Otherwise, orders the cell on the layers first
143900dabe28SStefano Zampini - interpolate - Flag to create intermediate mesh pieces (edges, faces)
144000dabe28SStefano Zampini 
144100dabe28SStefano Zampini   Output Parameter:
1442a1cb98faSBarry Smith . dm - The `DM` object
144300dabe28SStefano Zampini 
144400dabe28SStefano Zampini   Level: beginner
144500dabe28SStefano Zampini 
14461cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateHexCylinderMesh()`, `DMPlexCreateWedgeCylinderMesh()`, `DMExtrude()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
144700dabe28SStefano Zampini @*/
1448d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateWedgeBoxMesh(MPI_Comm comm, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[], PetscBool orderHeight, PetscBool interpolate, DM *dm)
1449d71ae5a4SJacob Faibussowitsch {
14509318fe57SMatthew G. Knepley   PetscInt       fac[3] = {1, 1, 1};
145100dabe28SStefano Zampini   PetscReal      low[3] = {0, 0, 0};
145200dabe28SStefano Zampini   PetscReal      upp[3] = {1, 1, 1};
145300dabe28SStefano Zampini   DMBoundaryType bdt[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
145400dabe28SStefano Zampini 
145500dabe28SStefano Zampini   PetscFunctionBegin;
14569566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
14579566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
14589566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateWedgeBoxMesh_Internal(*dm, faces ? faces : fac, lower ? lower : low, upper ? upper : upp, periodicity ? periodicity : bdt));
1459d410b0cfSMatthew G. Knepley   if (!interpolate) {
1460d410b0cfSMatthew G. Knepley     DM udm;
146100dabe28SStefano Zampini 
14629566063dSJacob Faibussowitsch     PetscCall(DMPlexUninterpolate(*dm, &udm));
146369d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(*dm, &udm));
146400dabe28SStefano Zampini   }
14657ff04441SMatthew G. Knepley   if (periodicity) PetscCall(DMLocalizeCoordinates(*dm));
14663ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
146700dabe28SStefano Zampini }
146800dabe28SStefano Zampini 
1469cfb853baSMatthew G. Knepley /*
1470cfb853baSMatthew 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.
1471cfb853baSMatthew G. Knepley 
1472cfb853baSMatthew G. Knepley   Input Parameters:
1473cfb853baSMatthew G. Knepley + len - The length of the tuple
1474cfb853baSMatthew G. Knepley . max - The maximum for each dimension, so values are in [0, max)
1475cfb853baSMatthew G. Knepley - tup - A tuple of length len+1: tup[len] > 0 indicates a stopping condition
1476cfb853baSMatthew G. Knepley 
1477cfb853baSMatthew G. Knepley   Output Parameter:
147820f4b53cSBarry Smith . tup - A tuple of `len` integers whose entries are at most `max`
1479cfb853baSMatthew G. Knepley 
1480cfb853baSMatthew G. Knepley   Level: developer
1481cfb853baSMatthew G. Knepley 
148220f4b53cSBarry Smith   Note:
148320f4b53cSBarry Smith   Ordering is lexicographic with lowest index as least significant in ordering.
148420f4b53cSBarry 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}.
148520f4b53cSBarry Smith 
1486cfb853baSMatthew G. Knepley .seealso: PetscDualSpaceTensorPointLexicographic_Internal(), PetscDualSpaceLatticePointLexicographic_Internal()
1487cfb853baSMatthew G. Knepley */
1488cfb853baSMatthew G. Knepley static PetscErrorCode DMPlexTensorPointLexicographic_Private(PetscInt len, const PetscInt max[], PetscInt tup[])
1489cfb853baSMatthew G. Knepley {
1490cfb853baSMatthew G. Knepley   PetscInt i;
1491cfb853baSMatthew G. Knepley 
1492cfb853baSMatthew G. Knepley   PetscFunctionBegin;
1493cfb853baSMatthew G. Knepley   for (i = 0; i < len; ++i) {
1494cfb853baSMatthew G. Knepley     if (tup[i] < max[i] - 1) {
1495cfb853baSMatthew G. Knepley       break;
1496cfb853baSMatthew G. Knepley     } else {
1497cfb853baSMatthew G. Knepley       tup[i] = 0;
1498cfb853baSMatthew G. Knepley     }
1499cfb853baSMatthew G. Knepley   }
1500cfb853baSMatthew G. Knepley   if (i == len) tup[i - 1] = max[i - 1];
1501cfb853baSMatthew G. Knepley   else ++tup[i];
15023ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1503cfb853baSMatthew G. Knepley }
1504cfb853baSMatthew G. Knepley 
1505cfb853baSMatthew G. Knepley static PetscInt TupleToIndex_Private(PetscInt len, const PetscInt max[], const PetscInt tup[])
1506cfb853baSMatthew G. Knepley {
1507cfb853baSMatthew G. Knepley   PetscInt i, idx = tup[len - 1];
1508cfb853baSMatthew G. Knepley 
1509cfb853baSMatthew G. Knepley   for (i = len - 2; i >= 0; --i) {
1510cfb853baSMatthew G. Knepley     idx *= max[i];
1511cfb853baSMatthew G. Knepley     idx += tup[i];
1512cfb853baSMatthew G. Knepley   }
1513cfb853baSMatthew G. Knepley   return idx;
1514cfb853baSMatthew G. Knepley }
1515cfb853baSMatthew G. Knepley 
1516cfb853baSMatthew G. Knepley static PetscErrorCode DestroyExtent_Private(void *extent)
1517cfb853baSMatthew G. Knepley {
1518cfb853baSMatthew G. Knepley   return PetscFree(extent);
1519cfb853baSMatthew G. Knepley }
1520cfb853baSMatthew G. Knepley 
1521cfb853baSMatthew G. Knepley static PetscErrorCode DMPlexCreateHypercubicMesh_Internal(DM dm, PetscInt dim, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[], const DMBoundaryType bd[])
1522cfb853baSMatthew G. Knepley {
1523cfb853baSMatthew G. Knepley   Vec          coordinates;
1524cfb853baSMatthew G. Knepley   PetscSection coordSection;
1525cfb853baSMatthew G. Knepley   DMLabel      cutLabel    = NULL;
1526cfb853baSMatthew G. Knepley   PetscBool    cutMarker   = PETSC_FALSE;
1527cfb853baSMatthew G. Knepley   PetscBool    periodic    = PETSC_FALSE;
1528cfb853baSMatthew G. Knepley   PetscInt     numCells    = 1, c;
1529cfb853baSMatthew G. Knepley   PetscInt     numVertices = 1, v;
1530cfb853baSMatthew G. Knepley   PetscScalar *coords;
1531cfb853baSMatthew G. Knepley   PetscInt    *vertices, *vert, *vtmp, *supp, cone[2];
1532cfb853baSMatthew G. Knepley   PetscInt     d, e, cell = 0, coordSize;
1533cfb853baSMatthew G. Knepley   PetscMPIInt  rank;
1534cfb853baSMatthew G. Knepley 
1535cfb853baSMatthew G. Knepley   PetscFunctionBegin;
1536cfb853baSMatthew G. Knepley   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
1537cfb853baSMatthew G. Knepley   PetscCall(DMSetDimension(dm, dim));
1538cfb853baSMatthew G. Knepley   PetscCall(PetscCalloc4(dim, &vertices, dim, &vert, dim, &vtmp, 2 * dim, &supp));
1539cfb853baSMatthew G. Knepley   PetscCall(DMCreateLabel(dm, "marker"));
1540cfb853baSMatthew G. Knepley   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_periodic_cut", &cutMarker, NULL));
1541cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) periodic = (periodic || bd[d] == DM_BOUNDARY_PERIODIC) ? PETSC_TRUE : PETSC_FALSE;
1542cfb853baSMatthew G. Knepley   if (periodic && cutMarker) {
1543cfb853baSMatthew G. Knepley     PetscCall(DMCreateLabel(dm, "periodic_cut"));
1544cfb853baSMatthew G. Knepley     PetscCall(DMGetLabel(dm, "periodic_cut", &cutLabel));
1545cfb853baSMatthew G. Knepley   }
1546cfb853baSMatthew 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");
1547cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) {
1548cfb853baSMatthew G. Knepley     vertices[d] = edges[d];
1549cfb853baSMatthew G. Knepley     numVertices *= vertices[d];
1550cfb853baSMatthew G. Knepley   }
1551cfb853baSMatthew G. Knepley   numCells = numVertices * dim;
1552cfb853baSMatthew G. Knepley   PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
1553cfb853baSMatthew G. Knepley   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, 2));
1554cfb853baSMatthew G. Knepley   for (v = numCells; v < numCells + numVertices; ++v) PetscCall(DMPlexSetSupportSize(dm, v, 2 * dim));
1555cfb853baSMatthew G. Knepley   /* TODO Loop over boundary and reset support sizes */
1556cfb853baSMatthew G. Knepley   PetscCall(DMSetUp(dm)); /* Allocate space for cones and supports */
1557cfb853baSMatthew G. Knepley   /* Build cell cones and vertex supports */
1558cfb853baSMatthew G. Knepley   PetscCall(DMCreateLabel(dm, "celltype"));
1559cfb853baSMatthew G. Knepley   while (vert[dim - 1] < vertices[dim - 1]) {
1560cfb853baSMatthew G. Knepley     const PetscInt vertex = TupleToIndex_Private(dim, vertices, vert) + numCells;
1561cfb853baSMatthew G. Knepley     PetscInt       s      = 0;
1562cfb853baSMatthew G. Knepley 
15633ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "Vertex %" PetscInt_FMT ":", vertex));
15643ba16761SJacob Faibussowitsch     for (d = 0; d < dim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %" PetscInt_FMT, vert[d]));
15653ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
1566cfb853baSMatthew G. Knepley     PetscCall(DMPlexSetCellType(dm, vertex, DM_POLYTOPE_POINT));
1567cfb853baSMatthew G. Knepley     for (d = 0; d < dim; ++d) {
1568cfb853baSMatthew G. Knepley       for (e = 0; e < dim; ++e) vtmp[e] = vert[e];
1569cfb853baSMatthew G. Knepley       vtmp[d] = (vert[d] + 1) % vertices[d];
1570cfb853baSMatthew G. Knepley       cone[0] = vertex;
1571cfb853baSMatthew G. Knepley       cone[1] = TupleToIndex_Private(dim, vertices, vtmp) + numCells;
15723ba16761SJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Vertex %" PetscInt_FMT ":", cone[1]));
15733ba16761SJacob Faibussowitsch       for (e = 0; e < dim; ++e) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %" PetscInt_FMT, vtmp[e]));
15743ba16761SJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
1575cfb853baSMatthew G. Knepley       PetscCall(DMPlexSetCone(dm, cell, cone));
1576cfb853baSMatthew G. Knepley       PetscCall(DMPlexSetCellType(dm, cell, DM_POLYTOPE_SEGMENT));
15773ba16761SJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Edge %" PetscInt_FMT " (%" PetscInt_FMT " %" PetscInt_FMT ")\n", cell, cone[0], cone[1]));
1578cfb853baSMatthew G. Knepley       ++cell;
1579cfb853baSMatthew G. Knepley     }
1580cfb853baSMatthew G. Knepley     for (d = 0; d < dim; ++d) {
1581cfb853baSMatthew G. Knepley       for (e = 0; e < dim; ++e) vtmp[e] = vert[e];
1582cfb853baSMatthew G. Knepley       vtmp[d]   = (vert[d] + vertices[d] - 1) % vertices[d];
1583cfb853baSMatthew G. Knepley       supp[s++] = TupleToIndex_Private(dim, vertices, vtmp) * dim + d;
1584cfb853baSMatthew G. Knepley       supp[s++] = (vertex - numCells) * dim + d;
1585cfb853baSMatthew G. Knepley       PetscCall(DMPlexSetSupport(dm, vertex, supp));
1586cfb853baSMatthew G. Knepley     }
1587cfb853baSMatthew G. Knepley     PetscCall(DMPlexTensorPointLexicographic_Private(dim, vertices, vert));
1588cfb853baSMatthew G. Knepley   }
1589cfb853baSMatthew G. Knepley   PetscCall(DMPlexStratify(dm));
1590cfb853baSMatthew G. Knepley   /* Build coordinates */
1591cfb853baSMatthew G. Knepley   PetscCall(DMGetCoordinateSection(dm, &coordSection));
1592cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetNumFields(coordSection, 1));
1593cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
1594cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetChart(coordSection, numCells, numCells + numVertices));
1595cfb853baSMatthew G. Knepley   for (v = numCells; v < numCells + numVertices; ++v) {
1596cfb853baSMatthew G. Knepley     PetscCall(PetscSectionSetDof(coordSection, v, dim));
1597cfb853baSMatthew G. Knepley     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
1598cfb853baSMatthew G. Knepley   }
1599cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetUp(coordSection));
1600cfb853baSMatthew G. Knepley   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
1601cfb853baSMatthew G. Knepley   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
1602cfb853baSMatthew G. Knepley   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
1603cfb853baSMatthew G. Knepley   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
1604cfb853baSMatthew G. Knepley   PetscCall(VecSetBlockSize(coordinates, dim));
1605cfb853baSMatthew G. Knepley   PetscCall(VecSetType(coordinates, VECSTANDARD));
1606cfb853baSMatthew G. Knepley   PetscCall(VecGetArray(coordinates, &coords));
1607cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) vert[d] = 0;
1608cfb853baSMatthew G. Knepley   while (vert[dim - 1] < vertices[dim - 1]) {
1609cfb853baSMatthew G. Knepley     const PetscInt vertex = TupleToIndex_Private(dim, vertices, vert);
1610cfb853baSMatthew G. Knepley 
1611cfb853baSMatthew G. Knepley     for (d = 0; d < dim; ++d) coords[vertex * dim + d] = lower[d] + ((upper[d] - lower[d]) / vertices[d]) * vert[d];
16123ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "Vertex %" PetscInt_FMT ":", vertex));
16133ba16761SJacob Faibussowitsch     for (d = 0; d < dim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %" PetscInt_FMT, vert[d]));
16143ba16761SJacob Faibussowitsch     for (d = 0; d < dim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %g", (double)PetscRealPart(coords[vertex * dim + d])));
16153ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
1616cfb853baSMatthew G. Knepley     PetscCall(DMPlexTensorPointLexicographic_Private(dim, vertices, vert));
1617cfb853baSMatthew G. Knepley   }
1618cfb853baSMatthew G. Knepley   PetscCall(VecRestoreArray(coordinates, &coords));
1619cfb853baSMatthew G. Knepley   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
1620cfb853baSMatthew G. Knepley   PetscCall(VecDestroy(&coordinates));
1621cfb853baSMatthew G. Knepley   PetscCall(PetscFree4(vertices, vert, vtmp, supp));
1622cfb853baSMatthew G. Knepley   //PetscCall(DMSetPeriodicity(dm, NULL, lower, upper));
1623cfb853baSMatthew G. Knepley   // Attach the extent
1624cfb853baSMatthew G. Knepley   {
1625cfb853baSMatthew G. Knepley     PetscContainer c;
1626cfb853baSMatthew G. Knepley     PetscInt      *extent;
1627cfb853baSMatthew G. Knepley 
1628cfb853baSMatthew G. Knepley     PetscCall(PetscMalloc1(dim, &extent));
1629cfb853baSMatthew G. Knepley     for (PetscInt d = 0; d < dim; ++d) extent[d] = edges[d];
1630cfb853baSMatthew G. Knepley     PetscCall(PetscContainerCreate(PETSC_COMM_SELF, &c));
1631cfb853baSMatthew G. Knepley     PetscCall(PetscContainerSetUserDestroy(c, DestroyExtent_Private));
1632cfb853baSMatthew G. Knepley     PetscCall(PetscContainerSetPointer(c, extent));
1633cfb853baSMatthew G. Knepley     PetscCall(PetscObjectCompose((PetscObject)dm, "_extent", (PetscObject)c));
1634cfb853baSMatthew G. Knepley     PetscCall(PetscContainerDestroy(&c));
1635cfb853baSMatthew G. Knepley   }
16363ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1637cfb853baSMatthew G. Knepley }
1638cfb853baSMatthew G. Knepley 
1639cfb853baSMatthew G. Knepley /*@C
1640aaa8cc7dSPierre Jolivet   DMPlexCreateHypercubicMesh - Creates a periodic mesh on the tensor product of unit intervals using only vertices and edges.
1641cfb853baSMatthew G. Knepley 
1642cfb853baSMatthew G. Knepley   Collective
1643cfb853baSMatthew G. Knepley 
1644cfb853baSMatthew G. Knepley   Input Parameters:
1645cfb853baSMatthew G. Knepley + comm  - The communicator for the DM object
1646cfb853baSMatthew G. Knepley . dim   - The spatial dimension
164720f4b53cSBarry Smith . edges - Number of edges per dimension, or `NULL` for (1,) in 1D and (2, 2) in 2D and (1, 1, 1) in 3D
164820f4b53cSBarry Smith . lower - The lower left corner, or `NULL` for (0, 0, 0)
164920f4b53cSBarry Smith - upper - The upper right corner, or `NULL` for (1, 1, 1)
1650cfb853baSMatthew G. Knepley 
1651cfb853baSMatthew G. Knepley   Output Parameter:
1652cfb853baSMatthew G. Knepley . dm - The DM object
1653cfb853baSMatthew G. Knepley 
165420f4b53cSBarry Smith   Level: beginner
165520f4b53cSBarry Smith 
165620f4b53cSBarry Smith   Note:
165720f4b53cSBarry Smith   If you want to customize this mesh using options, you just need to
165820f4b53cSBarry Smith .vb
165920f4b53cSBarry Smith   DMCreate(comm, &dm);
166020f4b53cSBarry Smith   DMSetType(dm, DMPLEX);
166120f4b53cSBarry Smith   DMSetFromOptions(dm);
166220f4b53cSBarry Smith .ve
166320f4b53cSBarry Smith   and use the options on the `DMSetFromOptions()` page.
1664cfb853baSMatthew G. Knepley 
1665cfb853baSMatthew G. Knepley   The vertices are numbered is lexicographic order, and the dim edges exiting a vertex in the positive orthant are number consecutively,
166620f4b53cSBarry Smith .vb
166720f4b53cSBarry Smith  18--0-19--2-20--4-18
166820f4b53cSBarry Smith   |     |     |     |
166920f4b53cSBarry Smith  13    15    17    13
167020f4b53cSBarry Smith   |     |     |     |
167120f4b53cSBarry Smith  24-12-25-14-26-16-24
167220f4b53cSBarry Smith   |     |     |     |
167320f4b53cSBarry Smith   7     9    11     7
167420f4b53cSBarry Smith   |     |     |     |
167520f4b53cSBarry Smith  21--6-22--8-23-10-21
167620f4b53cSBarry Smith   |     |     |     |
167720f4b53cSBarry Smith   1     3     5     1
167820f4b53cSBarry Smith   |     |     |     |
167920f4b53cSBarry Smith  18--0-19--2-20--4-18
168020f4b53cSBarry Smith .ve
1681cfb853baSMatthew G. Knepley 
168276fbde31SPierre Jolivet .seealso: `DMSetFromOptions()`, `DMPlexCreateFromFile()`, `DMPlexCreateHexCylinderMesh()`, `DMSetType()`, `DMCreate()`
1683cfb853baSMatthew G. Knepley @*/
1684cfb853baSMatthew G. Knepley PetscErrorCode DMPlexCreateHypercubicMesh(MPI_Comm comm, PetscInt dim, const PetscInt edges[], const PetscReal lower[], const PetscReal upper[], DM *dm)
1685cfb853baSMatthew G. Knepley {
1686cfb853baSMatthew G. Knepley   PetscInt       *edg;
1687cfb853baSMatthew G. Knepley   PetscReal      *low, *upp;
1688cfb853baSMatthew G. Knepley   DMBoundaryType *bdt;
1689cfb853baSMatthew G. Knepley   PetscInt        d;
1690cfb853baSMatthew G. Knepley 
1691cfb853baSMatthew G. Knepley   PetscFunctionBegin;
1692cfb853baSMatthew G. Knepley   PetscCall(DMCreate(comm, dm));
1693cfb853baSMatthew G. Knepley   PetscCall(DMSetType(*dm, DMPLEX));
1694cfb853baSMatthew G. Knepley   PetscCall(PetscMalloc4(dim, &edg, dim, &low, dim, &upp, dim, &bdt));
1695cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) {
1696cfb853baSMatthew G. Knepley     edg[d] = edges ? edges[d] : 1;
1697cfb853baSMatthew G. Knepley     low[d] = lower ? lower[d] : 0.;
1698cfb853baSMatthew G. Knepley     upp[d] = upper ? upper[d] : 1.;
1699cfb853baSMatthew G. Knepley     bdt[d] = DM_BOUNDARY_PERIODIC;
1700cfb853baSMatthew G. Knepley   }
1701cfb853baSMatthew G. Knepley   PetscCall(DMPlexCreateHypercubicMesh_Internal(*dm, dim, low, upp, edg, bdt));
1702cfb853baSMatthew G. Knepley   PetscCall(PetscFree4(edg, low, upp, bdt));
17033ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1704cfb853baSMatthew G. Knepley }
1705cfb853baSMatthew G. Knepley 
1706a9074c1eSMatthew G. Knepley /*@C
1707a1cb98faSBarry Smith   DMPlexSetOptionsPrefix - Sets the prefix used for searching for all `DM` options in the database.
1708a9074c1eSMatthew G. Knepley 
170920f4b53cSBarry Smith   Logically Collective
1710a9074c1eSMatthew G. Knepley 
1711a9074c1eSMatthew G. Knepley   Input Parameters:
171220f4b53cSBarry Smith + dm     - the `DM` context
1713a9074c1eSMatthew G. Knepley - prefix - the prefix to prepend to all option names
1714a9074c1eSMatthew G. Knepley 
1715a1cb98faSBarry Smith   Level: advanced
1716a1cb98faSBarry Smith 
1717a1cb98faSBarry Smith   Note:
1718a9074c1eSMatthew G. Knepley   A hyphen (-) must NOT be given at the beginning of the prefix name.
1719a9074c1eSMatthew G. Knepley   The first character of all runtime options is AUTOMATICALLY the hyphen.
1720a9074c1eSMatthew G. Knepley 
17211cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `SNESSetFromOptions()`
1722a9074c1eSMatthew G. Knepley @*/
1723d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexSetOptionsPrefix(DM dm, const char prefix[])
1724d71ae5a4SJacob Faibussowitsch {
1725a9074c1eSMatthew G. Knepley   DM_Plex *mesh = (DM_Plex *)dm->data;
1726a9074c1eSMatthew G. Knepley 
1727a9074c1eSMatthew G. Knepley   PetscFunctionBegin;
1728a9074c1eSMatthew G. Knepley   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
17299566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)dm, prefix));
17309566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)mesh->partitioner, prefix));
17313ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1732a9074c1eSMatthew G. Knepley }
1733a9074c1eSMatthew G. Knepley 
17349318fe57SMatthew G. Knepley /* Remap geometry to cylinder
173561a622f3SMatthew G. Knepley    TODO: This only works for a single refinement, then it is broken
173661a622f3SMatthew G. Knepley 
17379318fe57SMatthew G. Knepley      Interior square: Linear interpolation is correct
17389318fe57SMatthew G. Knepley      The other cells all have vertices on rays from the origin. We want to uniformly expand the spacing
17399318fe57SMatthew G. Knepley      such that the last vertex is on the unit circle. So the closest and farthest vertices are at distance
17400510c589SMatthew G. Knepley 
17419318fe57SMatthew G. Knepley        phi     = arctan(y/x)
17429318fe57SMatthew G. Knepley        d_close = sqrt(1/8 + 1/4 sin^2(phi))
17439318fe57SMatthew G. Knepley        d_far   = sqrt(1/2 + sin^2(phi))
17440510c589SMatthew G. Knepley 
17459318fe57SMatthew G. Knepley      so we remap them using
17460510c589SMatthew G. Knepley 
17479318fe57SMatthew G. Knepley        x_new = x_close + (x - x_close) (1 - d_close) / (d_far - d_close)
17489318fe57SMatthew G. Knepley        y_new = y_close + (y - y_close) (1 - d_close) / (d_far - d_close)
17490510c589SMatthew G. Knepley 
17509318fe57SMatthew G. Knepley      If pi/4 < phi < 3pi/4 or -3pi/4 < phi < -pi/4, then we switch x and y.
17519318fe57SMatthew G. Knepley */
1752d71ae5a4SJacob 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[])
1753d71ae5a4SJacob Faibussowitsch {
17549318fe57SMatthew G. Knepley   const PetscReal dis = 1.0 / PetscSqrtReal(2.0);
17559318fe57SMatthew G. Knepley   const PetscReal ds2 = 0.5 * dis;
175622cc497dSMatthew G. Knepley 
17579318fe57SMatthew G. Knepley   if ((PetscAbsScalar(u[0]) <= ds2) && (PetscAbsScalar(u[1]) <= ds2)) {
17589318fe57SMatthew G. Knepley     f0[0] = u[0];
17599318fe57SMatthew G. Knepley     f0[1] = u[1];
17609318fe57SMatthew G. Knepley   } else {
17619318fe57SMatthew G. Knepley     PetscReal phi, sinp, cosp, dc, df, x, y, xc, yc;
17620510c589SMatthew G. Knepley 
17639318fe57SMatthew G. Knepley     x    = PetscRealPart(u[0]);
17649318fe57SMatthew G. Knepley     y    = PetscRealPart(u[1]);
17659318fe57SMatthew G. Knepley     phi  = PetscAtan2Real(y, x);
17669318fe57SMatthew G. Knepley     sinp = PetscSinReal(phi);
17679318fe57SMatthew G. Knepley     cosp = PetscCosReal(phi);
17689318fe57SMatthew G. Knepley     if ((PetscAbsReal(phi) > PETSC_PI / 4.0) && (PetscAbsReal(phi) < 3.0 * PETSC_PI / 4.0)) {
17699318fe57SMatthew G. Knepley       dc = PetscAbsReal(ds2 / sinp);
17709318fe57SMatthew G. Knepley       df = PetscAbsReal(dis / sinp);
17719318fe57SMatthew G. Knepley       xc = ds2 * x / PetscAbsReal(y);
17729318fe57SMatthew G. Knepley       yc = ds2 * PetscSignReal(y);
17739318fe57SMatthew G. Knepley     } else {
17749318fe57SMatthew G. Knepley       dc = PetscAbsReal(ds2 / cosp);
17759318fe57SMatthew G. Knepley       df = PetscAbsReal(dis / cosp);
17769318fe57SMatthew G. Knepley       xc = ds2 * PetscSignReal(x);
17779318fe57SMatthew G. Knepley       yc = ds2 * y / PetscAbsReal(x);
17789318fe57SMatthew G. Knepley     }
17799318fe57SMatthew G. Knepley     f0[0] = xc + (u[0] - xc) * (1.0 - dc) / (df - dc);
17809318fe57SMatthew G. Knepley     f0[1] = yc + (u[1] - yc) * (1.0 - dc) / (df - dc);
17819318fe57SMatthew G. Knepley   }
17829318fe57SMatthew G. Knepley   f0[2] = u[2];
17839318fe57SMatthew G. Knepley }
17840510c589SMatthew G. Knepley 
1785d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateHexCylinderMesh_Internal(DM dm, DMBoundaryType periodicZ)
1786d71ae5a4SJacob Faibussowitsch {
17870510c589SMatthew G. Knepley   const PetscInt dim = 3;
17889318fe57SMatthew G. Knepley   PetscInt       numCells, numVertices;
1789d8c47e87SMatthew G. Knepley   PetscMPIInt    rank;
17900510c589SMatthew G. Knepley 
17910510c589SMatthew G. Knepley   PetscFunctionBegin;
179246139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
17939566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
17949566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
17950510c589SMatthew G. Knepley   /* Create topology */
17960510c589SMatthew G. Knepley   {
17970510c589SMatthew G. Knepley     PetscInt cone[8], c;
17980510c589SMatthew G. Knepley 
1799dd400576SPatrick Sanan     numCells    = rank == 0 ? 5 : 0;
1800dd400576SPatrick Sanan     numVertices = rank == 0 ? 16 : 0;
1801006a8963SMatthew G. Knepley     if (periodicZ == DM_BOUNDARY_PERIODIC) {
1802ae8bcbbbSMatthew G. Knepley       numCells *= 3;
1803dd400576SPatrick Sanan       numVertices = rank == 0 ? 24 : 0;
1804006a8963SMatthew G. Knepley     }
18059566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
18069566063dSJacob Faibussowitsch     for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 8));
18079566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm));
1808dd400576SPatrick Sanan     if (rank == 0) {
1809006a8963SMatthew G. Knepley       if (periodicZ == DM_BOUNDARY_PERIODIC) {
18109371c9d4SSatish Balay         cone[0] = 15;
18119371c9d4SSatish Balay         cone[1] = 18;
18129371c9d4SSatish Balay         cone[2] = 17;
18139371c9d4SSatish Balay         cone[3] = 16;
18149371c9d4SSatish Balay         cone[4] = 31;
18159371c9d4SSatish Balay         cone[5] = 32;
18169371c9d4SSatish Balay         cone[6] = 33;
18179371c9d4SSatish Balay         cone[7] = 34;
18189566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
18199371c9d4SSatish Balay         cone[0] = 16;
18209371c9d4SSatish Balay         cone[1] = 17;
18219371c9d4SSatish Balay         cone[2] = 24;
18229371c9d4SSatish Balay         cone[3] = 23;
18239371c9d4SSatish Balay         cone[4] = 32;
18249371c9d4SSatish Balay         cone[5] = 36;
18259371c9d4SSatish Balay         cone[6] = 37;
18269371c9d4SSatish Balay         cone[7] = 33; /* 22 25 26 21 */
18279566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
18289371c9d4SSatish Balay         cone[0] = 18;
18299371c9d4SSatish Balay         cone[1] = 27;
18309371c9d4SSatish Balay         cone[2] = 24;
18319371c9d4SSatish Balay         cone[3] = 17;
18329371c9d4SSatish Balay         cone[4] = 34;
18339371c9d4SSatish Balay         cone[5] = 33;
18349371c9d4SSatish Balay         cone[6] = 37;
18359371c9d4SSatish Balay         cone[7] = 38;
18369566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
18379371c9d4SSatish Balay         cone[0] = 29;
18389371c9d4SSatish Balay         cone[1] = 27;
18399371c9d4SSatish Balay         cone[2] = 18;
18409371c9d4SSatish Balay         cone[3] = 15;
18419371c9d4SSatish Balay         cone[4] = 35;
18429371c9d4SSatish Balay         cone[5] = 31;
18439371c9d4SSatish Balay         cone[6] = 34;
18449371c9d4SSatish Balay         cone[7] = 38;
18459566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
18469371c9d4SSatish Balay         cone[0] = 29;
18479371c9d4SSatish Balay         cone[1] = 15;
18489371c9d4SSatish Balay         cone[2] = 16;
18499371c9d4SSatish Balay         cone[3] = 23;
18509371c9d4SSatish Balay         cone[4] = 35;
18519371c9d4SSatish Balay         cone[5] = 36;
18529371c9d4SSatish Balay         cone[6] = 32;
18539371c9d4SSatish Balay         cone[7] = 31;
18549566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
1855006a8963SMatthew G. Knepley 
18569371c9d4SSatish Balay         cone[0] = 31;
18579371c9d4SSatish Balay         cone[1] = 34;
18589371c9d4SSatish Balay         cone[2] = 33;
18599371c9d4SSatish Balay         cone[3] = 32;
18609371c9d4SSatish Balay         cone[4] = 19;
18619371c9d4SSatish Balay         cone[5] = 22;
18629371c9d4SSatish Balay         cone[6] = 21;
18639371c9d4SSatish Balay         cone[7] = 20;
18649566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 5, cone));
18659371c9d4SSatish Balay         cone[0] = 32;
18669371c9d4SSatish Balay         cone[1] = 33;
18679371c9d4SSatish Balay         cone[2] = 37;
18689371c9d4SSatish Balay         cone[3] = 36;
18699371c9d4SSatish Balay         cone[4] = 22;
18709371c9d4SSatish Balay         cone[5] = 25;
18719371c9d4SSatish Balay         cone[6] = 26;
18729371c9d4SSatish Balay         cone[7] = 21;
18739566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 6, cone));
18749371c9d4SSatish Balay         cone[0] = 34;
18759371c9d4SSatish Balay         cone[1] = 38;
18769371c9d4SSatish Balay         cone[2] = 37;
18779371c9d4SSatish Balay         cone[3] = 33;
18789371c9d4SSatish Balay         cone[4] = 20;
18799371c9d4SSatish Balay         cone[5] = 21;
18809371c9d4SSatish Balay         cone[6] = 26;
18819371c9d4SSatish Balay         cone[7] = 28;
18829566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 7, cone));
18839371c9d4SSatish Balay         cone[0] = 35;
18849371c9d4SSatish Balay         cone[1] = 38;
18859371c9d4SSatish Balay         cone[2] = 34;
18869371c9d4SSatish Balay         cone[3] = 31;
18879371c9d4SSatish Balay         cone[4] = 30;
18889371c9d4SSatish Balay         cone[5] = 19;
18899371c9d4SSatish Balay         cone[6] = 20;
18909371c9d4SSatish Balay         cone[7] = 28;
18919566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 8, cone));
18929371c9d4SSatish Balay         cone[0] = 35;
18939371c9d4SSatish Balay         cone[1] = 31;
18949371c9d4SSatish Balay         cone[2] = 32;
18959371c9d4SSatish Balay         cone[3] = 36;
18969371c9d4SSatish Balay         cone[4] = 30;
18979371c9d4SSatish Balay         cone[5] = 25;
18989371c9d4SSatish Balay         cone[6] = 22;
18999371c9d4SSatish Balay         cone[7] = 19;
19009566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 9, cone));
1901ae8bcbbbSMatthew G. Knepley 
19029371c9d4SSatish Balay         cone[0] = 19;
19039371c9d4SSatish Balay         cone[1] = 20;
19049371c9d4SSatish Balay         cone[2] = 21;
19059371c9d4SSatish Balay         cone[3] = 22;
19069371c9d4SSatish Balay         cone[4] = 15;
19079371c9d4SSatish Balay         cone[5] = 16;
19089371c9d4SSatish Balay         cone[6] = 17;
19099371c9d4SSatish Balay         cone[7] = 18;
19109566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 10, cone));
19119371c9d4SSatish Balay         cone[0] = 22;
19129371c9d4SSatish Balay         cone[1] = 21;
19139371c9d4SSatish Balay         cone[2] = 26;
19149371c9d4SSatish Balay         cone[3] = 25;
19159371c9d4SSatish Balay         cone[4] = 16;
19169371c9d4SSatish Balay         cone[5] = 23;
19179371c9d4SSatish Balay         cone[6] = 24;
19189371c9d4SSatish Balay         cone[7] = 17;
19199566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 11, cone));
19209371c9d4SSatish Balay         cone[0] = 20;
19219371c9d4SSatish Balay         cone[1] = 28;
19229371c9d4SSatish Balay         cone[2] = 26;
19239371c9d4SSatish Balay         cone[3] = 21;
19249371c9d4SSatish Balay         cone[4] = 18;
19259371c9d4SSatish Balay         cone[5] = 17;
19269371c9d4SSatish Balay         cone[6] = 24;
19279371c9d4SSatish Balay         cone[7] = 27;
19289566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 12, cone));
19299371c9d4SSatish Balay         cone[0] = 30;
19309371c9d4SSatish Balay         cone[1] = 28;
19319371c9d4SSatish Balay         cone[2] = 20;
19329371c9d4SSatish Balay         cone[3] = 19;
19339371c9d4SSatish Balay         cone[4] = 29;
19349371c9d4SSatish Balay         cone[5] = 15;
19359371c9d4SSatish Balay         cone[6] = 18;
19369371c9d4SSatish Balay         cone[7] = 27;
19379566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 13, cone));
19389371c9d4SSatish Balay         cone[0] = 30;
19399371c9d4SSatish Balay         cone[1] = 19;
19409371c9d4SSatish Balay         cone[2] = 22;
19419371c9d4SSatish Balay         cone[3] = 25;
19429371c9d4SSatish Balay         cone[4] = 29;
19439371c9d4SSatish Balay         cone[5] = 23;
19449371c9d4SSatish Balay         cone[6] = 16;
19459371c9d4SSatish Balay         cone[7] = 15;
19469566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 14, cone));
1947006a8963SMatthew G. Knepley       } else {
19489371c9d4SSatish Balay         cone[0] = 5;
19499371c9d4SSatish Balay         cone[1] = 8;
19509371c9d4SSatish Balay         cone[2] = 7;
19519371c9d4SSatish Balay         cone[3] = 6;
19529371c9d4SSatish Balay         cone[4] = 9;
19539371c9d4SSatish Balay         cone[5] = 12;
19549371c9d4SSatish Balay         cone[6] = 11;
19559371c9d4SSatish Balay         cone[7] = 10;
19569566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
19579371c9d4SSatish Balay         cone[0] = 6;
19589371c9d4SSatish Balay         cone[1] = 7;
19599371c9d4SSatish Balay         cone[2] = 14;
19609371c9d4SSatish Balay         cone[3] = 13;
19619371c9d4SSatish Balay         cone[4] = 12;
19629371c9d4SSatish Balay         cone[5] = 15;
19639371c9d4SSatish Balay         cone[6] = 16;
19649371c9d4SSatish Balay         cone[7] = 11;
19659566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
19669371c9d4SSatish Balay         cone[0] = 8;
19679371c9d4SSatish Balay         cone[1] = 17;
19689371c9d4SSatish Balay         cone[2] = 14;
19699371c9d4SSatish Balay         cone[3] = 7;
19709371c9d4SSatish Balay         cone[4] = 10;
19719371c9d4SSatish Balay         cone[5] = 11;
19729371c9d4SSatish Balay         cone[6] = 16;
19739371c9d4SSatish Balay         cone[7] = 18;
19749566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
19759371c9d4SSatish Balay         cone[0] = 19;
19769371c9d4SSatish Balay         cone[1] = 17;
19779371c9d4SSatish Balay         cone[2] = 8;
19789371c9d4SSatish Balay         cone[3] = 5;
19799371c9d4SSatish Balay         cone[4] = 20;
19809371c9d4SSatish Balay         cone[5] = 9;
19819371c9d4SSatish Balay         cone[6] = 10;
19829371c9d4SSatish Balay         cone[7] = 18;
19839566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
19849371c9d4SSatish Balay         cone[0] = 19;
19859371c9d4SSatish Balay         cone[1] = 5;
19869371c9d4SSatish Balay         cone[2] = 6;
19879371c9d4SSatish Balay         cone[3] = 13;
19889371c9d4SSatish Balay         cone[4] = 20;
19899371c9d4SSatish Balay         cone[5] = 15;
19909371c9d4SSatish Balay         cone[6] = 12;
19919371c9d4SSatish Balay         cone[7] = 9;
19929566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
1993006a8963SMatthew G. Knepley       }
1994d8c47e87SMatthew G. Knepley     }
19959566063dSJacob Faibussowitsch     PetscCall(DMPlexSymmetrize(dm));
19969566063dSJacob Faibussowitsch     PetscCall(DMPlexStratify(dm));
19970510c589SMatthew G. Knepley   }
1998dbc1dc17SMatthew G. Knepley   /* Create cube geometry */
19990510c589SMatthew G. Knepley   {
20000510c589SMatthew G. Knepley     Vec             coordinates;
20010510c589SMatthew G. Knepley     PetscSection    coordSection;
20020510c589SMatthew G. Knepley     PetscScalar    *coords;
20030510c589SMatthew G. Knepley     PetscInt        coordSize, v;
20040510c589SMatthew G. Knepley     const PetscReal dis = 1.0 / PetscSqrtReal(2.0);
20050510c589SMatthew G. Knepley     const PetscReal ds2 = dis / 2.0;
20060510c589SMatthew G. Knepley 
20070510c589SMatthew G. Knepley     /* Build coordinates */
20089566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &coordSection));
20099566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetNumFields(coordSection, 1));
20109566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
20119566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetChart(coordSection, numCells, numCells + numVertices));
20120510c589SMatthew G. Knepley     for (v = numCells; v < numCells + numVertices; ++v) {
20139566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetDof(coordSection, v, dim));
20149566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
20150510c589SMatthew G. Knepley     }
20169566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetUp(coordSection));
20179566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
20189566063dSJacob Faibussowitsch     PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
20199566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
20209566063dSJacob Faibussowitsch     PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
20219566063dSJacob Faibussowitsch     PetscCall(VecSetBlockSize(coordinates, dim));
20229566063dSJacob Faibussowitsch     PetscCall(VecSetType(coordinates, VECSTANDARD));
20239566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
2024dd400576SPatrick Sanan     if (rank == 0) {
20259371c9d4SSatish Balay       coords[0 * dim + 0]  = -ds2;
20269371c9d4SSatish Balay       coords[0 * dim + 1]  = -ds2;
20279371c9d4SSatish Balay       coords[0 * dim + 2]  = 0.0;
20289371c9d4SSatish Balay       coords[1 * dim + 0]  = ds2;
20299371c9d4SSatish Balay       coords[1 * dim + 1]  = -ds2;
20309371c9d4SSatish Balay       coords[1 * dim + 2]  = 0.0;
20319371c9d4SSatish Balay       coords[2 * dim + 0]  = ds2;
20329371c9d4SSatish Balay       coords[2 * dim + 1]  = ds2;
20339371c9d4SSatish Balay       coords[2 * dim + 2]  = 0.0;
20349371c9d4SSatish Balay       coords[3 * dim + 0]  = -ds2;
20359371c9d4SSatish Balay       coords[3 * dim + 1]  = ds2;
20369371c9d4SSatish Balay       coords[3 * dim + 2]  = 0.0;
20379371c9d4SSatish Balay       coords[4 * dim + 0]  = -ds2;
20389371c9d4SSatish Balay       coords[4 * dim + 1]  = -ds2;
20399371c9d4SSatish Balay       coords[4 * dim + 2]  = 1.0;
20409371c9d4SSatish Balay       coords[5 * dim + 0]  = -ds2;
20419371c9d4SSatish Balay       coords[5 * dim + 1]  = ds2;
20429371c9d4SSatish Balay       coords[5 * dim + 2]  = 1.0;
20439371c9d4SSatish Balay       coords[6 * dim + 0]  = ds2;
20449371c9d4SSatish Balay       coords[6 * dim + 1]  = ds2;
20459371c9d4SSatish Balay       coords[6 * dim + 2]  = 1.0;
20469371c9d4SSatish Balay       coords[7 * dim + 0]  = ds2;
20479371c9d4SSatish Balay       coords[7 * dim + 1]  = -ds2;
20489371c9d4SSatish Balay       coords[7 * dim + 2]  = 1.0;
20499371c9d4SSatish Balay       coords[8 * dim + 0]  = dis;
20509371c9d4SSatish Balay       coords[8 * dim + 1]  = -dis;
20519371c9d4SSatish Balay       coords[8 * dim + 2]  = 0.0;
20529371c9d4SSatish Balay       coords[9 * dim + 0]  = dis;
20539371c9d4SSatish Balay       coords[9 * dim + 1]  = dis;
20549371c9d4SSatish Balay       coords[9 * dim + 2]  = 0.0;
20559371c9d4SSatish Balay       coords[10 * dim + 0] = dis;
20569371c9d4SSatish Balay       coords[10 * dim + 1] = -dis;
20579371c9d4SSatish Balay       coords[10 * dim + 2] = 1.0;
20589371c9d4SSatish Balay       coords[11 * dim + 0] = dis;
20599371c9d4SSatish Balay       coords[11 * dim + 1] = dis;
20609371c9d4SSatish Balay       coords[11 * dim + 2] = 1.0;
20619371c9d4SSatish Balay       coords[12 * dim + 0] = -dis;
20629371c9d4SSatish Balay       coords[12 * dim + 1] = dis;
20639371c9d4SSatish Balay       coords[12 * dim + 2] = 0.0;
20649371c9d4SSatish Balay       coords[13 * dim + 0] = -dis;
20659371c9d4SSatish Balay       coords[13 * dim + 1] = dis;
20669371c9d4SSatish Balay       coords[13 * dim + 2] = 1.0;
20679371c9d4SSatish Balay       coords[14 * dim + 0] = -dis;
20689371c9d4SSatish Balay       coords[14 * dim + 1] = -dis;
20699371c9d4SSatish Balay       coords[14 * dim + 2] = 0.0;
20709371c9d4SSatish Balay       coords[15 * dim + 0] = -dis;
20719371c9d4SSatish Balay       coords[15 * dim + 1] = -dis;
20729371c9d4SSatish Balay       coords[15 * dim + 2] = 1.0;
2073ae8bcbbbSMatthew G. Knepley       if (periodicZ == DM_BOUNDARY_PERIODIC) {
20749371c9d4SSatish Balay         /* 15 31 19 */ coords[16 * dim + 0] = -ds2;
20759371c9d4SSatish Balay         coords[16 * dim + 1]                = -ds2;
20769371c9d4SSatish Balay         coords[16 * dim + 2]                = 0.5;
20779371c9d4SSatish Balay         /* 16 32 22 */ coords[17 * dim + 0] = ds2;
20789371c9d4SSatish Balay         coords[17 * dim + 1]                = -ds2;
20799371c9d4SSatish Balay         coords[17 * dim + 2]                = 0.5;
20809371c9d4SSatish Balay         /* 17 33 21 */ coords[18 * dim + 0] = ds2;
20819371c9d4SSatish Balay         coords[18 * dim + 1]                = ds2;
20829371c9d4SSatish Balay         coords[18 * dim + 2]                = 0.5;
20839371c9d4SSatish Balay         /* 18 34 20 */ coords[19 * dim + 0] = -ds2;
20849371c9d4SSatish Balay         coords[19 * dim + 1]                = ds2;
20859371c9d4SSatish Balay         coords[19 * dim + 2]                = 0.5;
20869371c9d4SSatish Balay         /* 29 35 30 */ coords[20 * dim + 0] = -dis;
20879371c9d4SSatish Balay         coords[20 * dim + 1]                = -dis;
20889371c9d4SSatish Balay         coords[20 * dim + 2]                = 0.5;
20899371c9d4SSatish Balay         /* 23 36 25 */ coords[21 * dim + 0] = dis;
20909371c9d4SSatish Balay         coords[21 * dim + 1]                = -dis;
20919371c9d4SSatish Balay         coords[21 * dim + 2]                = 0.5;
20929371c9d4SSatish Balay         /* 24 37 26 */ coords[22 * dim + 0] = dis;
20939371c9d4SSatish Balay         coords[22 * dim + 1]                = dis;
20949371c9d4SSatish Balay         coords[22 * dim + 2]                = 0.5;
20959371c9d4SSatish Balay         /* 27 38 28 */ coords[23 * dim + 0] = -dis;
20969371c9d4SSatish Balay         coords[23 * dim + 1]                = dis;
20979371c9d4SSatish Balay         coords[23 * dim + 2]                = 0.5;
2098ae8bcbbbSMatthew G. Knepley       }
2099d8c47e87SMatthew G. Knepley     }
21009566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(coordinates, &coords));
21019566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, coordinates));
21029566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&coordinates));
21030510c589SMatthew G. Knepley   }
2104006a8963SMatthew G. Knepley   /* Create periodicity */
2105006a8963SMatthew G. Knepley   if (periodicZ == DM_BOUNDARY_PERIODIC || periodicZ == DM_BOUNDARY_TWIST) {
21066858538eSMatthew G. Knepley     PetscReal L[3]       = {-1., -1., 0.};
21076858538eSMatthew G. Knepley     PetscReal maxCell[3] = {-1., -1., 0.};
2108006a8963SMatthew G. Knepley     PetscReal lower[3]   = {0.0, 0.0, 0.0};
2109ae8bcbbbSMatthew G. Knepley     PetscReal upper[3]   = {1.0, 1.0, 1.5};
21106858538eSMatthew G. Knepley     PetscInt  numZCells  = 3;
2111006a8963SMatthew G. Knepley 
21126858538eSMatthew G. Knepley     L[2]       = upper[2] - lower[2];
21136858538eSMatthew G. Knepley     maxCell[2] = 1.1 * (L[2] / numZCells);
21144fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dm, maxCell, lower, L));
2115006a8963SMatthew G. Knepley   }
2116dbc1dc17SMatthew G. Knepley   {
21179318fe57SMatthew G. Knepley     DM          cdm;
21189318fe57SMatthew G. Knepley     PetscDS     cds;
21199318fe57SMatthew G. Knepley     PetscScalar c[2] = {1.0, 1.0};
2120dbc1dc17SMatthew G. Knepley 
2121e44f6aebSMatthew G. Knepley     PetscCall(DMPlexCreateCoordinateSpace(dm, 1, PETSC_TRUE, snapToCylinder));
21229566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
21239566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
21249566063dSJacob Faibussowitsch     PetscCall(PetscDSSetConstants(cds, 2, c));
2125dbc1dc17SMatthew G. Knepley   }
212646139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
212746139095SJed Brown 
21289318fe57SMatthew G. Knepley   /* Wait for coordinate creation before doing in-place modification */
21299566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolateInPlace_Internal(dm));
21303ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
21310510c589SMatthew G. Knepley }
21320510c589SMatthew G. Knepley 
213324119c2aSMatthew G. Knepley /*@
21349318fe57SMatthew G. Knepley   DMPlexCreateHexCylinderMesh - Creates a mesh on the tensor product of the unit interval with the circle (cylinder) using hexahedra.
213524119c2aSMatthew G. Knepley 
2136d083f849SBarry Smith   Collective
213724119c2aSMatthew G. Knepley 
213824119c2aSMatthew G. Knepley   Input Parameters:
2139a1cb98faSBarry Smith + comm      - The communicator for the `DM` object
21409318fe57SMatthew G. Knepley - periodicZ - The boundary type for the Z direction
214124119c2aSMatthew G. Knepley 
214224119c2aSMatthew G. Knepley   Output Parameter:
214320f4b53cSBarry Smith . dm - The `DM` object
214424119c2aSMatthew G. Knepley 
214524119c2aSMatthew G. Knepley   Level: beginner
214624119c2aSMatthew G. Knepley 
2147a1cb98faSBarry Smith   Note:
2148a4e35b19SJacob Faibussowitsch   Here is the output numbering looking from the bottom of the cylinder\:
2149a1cb98faSBarry Smith .vb
2150a1cb98faSBarry Smith        17-----14
2151a1cb98faSBarry Smith         |     |
2152a1cb98faSBarry Smith         |  2  |
2153a1cb98faSBarry Smith         |     |
2154a1cb98faSBarry Smith  17-----8-----7-----14
2155a1cb98faSBarry Smith   |     |     |     |
2156a1cb98faSBarry Smith   |  3  |  0  |  1  |
2157a1cb98faSBarry Smith   |     |     |     |
2158a1cb98faSBarry Smith  19-----5-----6-----13
2159a1cb98faSBarry Smith         |     |
2160a1cb98faSBarry Smith         |  4  |
2161a1cb98faSBarry Smith         |     |
2162a1cb98faSBarry Smith        19-----13
2163a1cb98faSBarry Smith 
2164a1cb98faSBarry Smith  and up through the top
2165a1cb98faSBarry Smith 
2166a1cb98faSBarry Smith        18-----16
2167a1cb98faSBarry Smith         |     |
2168a1cb98faSBarry Smith         |  2  |
2169a1cb98faSBarry Smith         |     |
2170a1cb98faSBarry Smith  18----10----11-----16
2171a1cb98faSBarry Smith   |     |     |     |
2172a1cb98faSBarry Smith   |  3  |  0  |  1  |
2173a1cb98faSBarry Smith   |     |     |     |
2174a1cb98faSBarry Smith  20-----9----12-----15
2175a1cb98faSBarry Smith         |     |
2176a1cb98faSBarry Smith         |  4  |
2177a1cb98faSBarry Smith         |     |
2178a1cb98faSBarry Smith        20-----15
2179a1cb98faSBarry Smith .ve
2180a1cb98faSBarry Smith 
21811cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
218224119c2aSMatthew G. Knepley @*/
2183d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateHexCylinderMesh(MPI_Comm comm, DMBoundaryType periodicZ, DM *dm)
2184d71ae5a4SJacob Faibussowitsch {
21859318fe57SMatthew G. Knepley   PetscFunctionBegin;
21864f572ea9SToby Isaac   PetscAssertPointer(dm, 3);
21879566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
21889566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
21899566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateHexCylinderMesh_Internal(*dm, periodicZ));
21903ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
21919318fe57SMatthew G. Knepley }
21929318fe57SMatthew G. Knepley 
2193d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateWedgeCylinderMesh_Internal(DM dm, PetscInt n, PetscBool interpolate)
2194d71ae5a4SJacob Faibussowitsch {
219524119c2aSMatthew G. Knepley   const PetscInt dim = 3;
2196412e9a14SMatthew G. Knepley   PetscInt       numCells, numVertices, v;
21979fe9f049SMatthew G. Knepley   PetscMPIInt    rank;
219824119c2aSMatthew G. Knepley 
219924119c2aSMatthew G. Knepley   PetscFunctionBegin;
220063a3b9bcSJacob Faibussowitsch   PetscCheck(n >= 0, PetscObjectComm((PetscObject)dm), PETSC_ERR_ARG_OUTOFRANGE, "Number of wedges %" PetscInt_FMT " cannot be negative", n);
220146139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
22029566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
22039566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
2204412e9a14SMatthew G. Knepley   /* Must create the celltype label here so that we do not automatically try to compute the types */
22059566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "celltype"));
220624119c2aSMatthew G. Knepley   /* Create topology */
220724119c2aSMatthew G. Knepley   {
220824119c2aSMatthew G. Knepley     PetscInt cone[6], c;
220924119c2aSMatthew G. Knepley 
2210dd400576SPatrick Sanan     numCells    = rank == 0 ? n : 0;
2211dd400576SPatrick Sanan     numVertices = rank == 0 ? 2 * (n + 1) : 0;
22129566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
22139566063dSJacob Faibussowitsch     for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 6));
22149566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm));
221524119c2aSMatthew G. Knepley     for (c = 0; c < numCells; c++) {
22169371c9d4SSatish Balay       cone[0] = c + n * 1;
22179371c9d4SSatish Balay       cone[1] = (c + 1) % n + n * 1;
22189371c9d4SSatish Balay       cone[2] = 0 + 3 * n;
22199371c9d4SSatish Balay       cone[3] = c + n * 2;
22209371c9d4SSatish Balay       cone[4] = (c + 1) % n + n * 2;
22219371c9d4SSatish Balay       cone[5] = 1 + 3 * n;
22229566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCone(dm, c, cone));
22239566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCellType(dm, c, DM_POLYTOPE_TRI_PRISM_TENSOR));
222424119c2aSMatthew G. Knepley     }
22259566063dSJacob Faibussowitsch     PetscCall(DMPlexSymmetrize(dm));
22269566063dSJacob Faibussowitsch     PetscCall(DMPlexStratify(dm));
222724119c2aSMatthew G. Knepley   }
222848a46eb9SPierre Jolivet   for (v = numCells; v < numCells + numVertices; ++v) PetscCall(DMPlexSetCellType(dm, v, DM_POLYTOPE_POINT));
222924119c2aSMatthew G. Knepley   /* Create cylinder geometry */
223024119c2aSMatthew G. Knepley   {
223124119c2aSMatthew G. Knepley     Vec          coordinates;
223224119c2aSMatthew G. Knepley     PetscSection coordSection;
223324119c2aSMatthew G. Knepley     PetscScalar *coords;
2234412e9a14SMatthew G. Knepley     PetscInt     coordSize, c;
223524119c2aSMatthew G. Knepley 
223624119c2aSMatthew G. Knepley     /* Build coordinates */
22379566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &coordSection));
22389566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetNumFields(coordSection, 1));
22399566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
22409566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetChart(coordSection, numCells, numCells + numVertices));
224124119c2aSMatthew G. Knepley     for (v = numCells; v < numCells + numVertices; ++v) {
22429566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetDof(coordSection, v, dim));
22439566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
224424119c2aSMatthew G. Knepley     }
22459566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetUp(coordSection));
22469566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
22479566063dSJacob Faibussowitsch     PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
22489566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
22499566063dSJacob Faibussowitsch     PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
22509566063dSJacob Faibussowitsch     PetscCall(VecSetBlockSize(coordinates, dim));
22519566063dSJacob Faibussowitsch     PetscCall(VecSetType(coordinates, VECSTANDARD));
22529566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
225324119c2aSMatthew G. Knepley     for (c = 0; c < numCells; c++) {
22549371c9d4SSatish Balay       coords[(c + 0 * n) * dim + 0] = PetscCosReal(2.0 * c * PETSC_PI / n);
22559371c9d4SSatish Balay       coords[(c + 0 * n) * dim + 1] = PetscSinReal(2.0 * c * PETSC_PI / n);
22569371c9d4SSatish Balay       coords[(c + 0 * n) * dim + 2] = 1.0;
22579371c9d4SSatish Balay       coords[(c + 1 * n) * dim + 0] = PetscCosReal(2.0 * c * PETSC_PI / n);
22589371c9d4SSatish Balay       coords[(c + 1 * n) * dim + 1] = PetscSinReal(2.0 * c * PETSC_PI / n);
22599371c9d4SSatish Balay       coords[(c + 1 * n) * dim + 2] = 0.0;
226024119c2aSMatthew G. Knepley     }
2261dd400576SPatrick Sanan     if (rank == 0) {
22629371c9d4SSatish Balay       coords[(2 * n + 0) * dim + 0] = 0.0;
22639371c9d4SSatish Balay       coords[(2 * n + 0) * dim + 1] = 0.0;
22649371c9d4SSatish Balay       coords[(2 * n + 0) * dim + 2] = 1.0;
22659371c9d4SSatish Balay       coords[(2 * n + 1) * dim + 0] = 0.0;
22669371c9d4SSatish Balay       coords[(2 * n + 1) * dim + 1] = 0.0;
22679371c9d4SSatish Balay       coords[(2 * n + 1) * dim + 2] = 0.0;
22689fe9f049SMatthew G. Knepley     }
22699566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(coordinates, &coords));
22709566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, coordinates));
22719566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&coordinates));
227224119c2aSMatthew G. Knepley   }
227346139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
22749318fe57SMatthew G. Knepley   /* Interpolate */
22759566063dSJacob Faibussowitsch   if (interpolate) PetscCall(DMPlexInterpolateInPlace_Internal(dm));
22763ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
22779318fe57SMatthew G. Knepley }
22789318fe57SMatthew G. Knepley 
22799318fe57SMatthew G. Knepley /*@
22809318fe57SMatthew G. Knepley   DMPlexCreateWedgeCylinderMesh - Creates a mesh on the tensor product of the unit interval with the circle (cylinder) using wedges.
22819318fe57SMatthew G. Knepley 
22829318fe57SMatthew G. Knepley   Collective
22839318fe57SMatthew G. Knepley 
22849318fe57SMatthew G. Knepley   Input Parameters:
2285a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
22869318fe57SMatthew G. Knepley . n           - The number of wedges around the origin
22879318fe57SMatthew G. Knepley - interpolate - Create edges and faces
22889318fe57SMatthew G. Knepley 
22899318fe57SMatthew G. Knepley   Output Parameter:
2290a1cb98faSBarry Smith . dm - The `DM` object
22919318fe57SMatthew G. Knepley 
22929318fe57SMatthew G. Knepley   Level: beginner
22939318fe57SMatthew G. Knepley 
22941cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateHexCylinderMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
22959318fe57SMatthew G. Knepley @*/
2296d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateWedgeCylinderMesh(MPI_Comm comm, PetscInt n, PetscBool interpolate, DM *dm)
2297d71ae5a4SJacob Faibussowitsch {
22989318fe57SMatthew G. Knepley   PetscFunctionBegin;
22994f572ea9SToby Isaac   PetscAssertPointer(dm, 4);
23009566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
23019566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
23029566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateWedgeCylinderMesh_Internal(*dm, n, interpolate));
23033ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
230424119c2aSMatthew G. Knepley }
230524119c2aSMatthew G. Knepley 
2306d71ae5a4SJacob Faibussowitsch static inline PetscReal DiffNormReal(PetscInt dim, const PetscReal x[], const PetscReal y[])
2307d71ae5a4SJacob Faibussowitsch {
230865a81367SMatthew G. Knepley   PetscReal prod = 0.0;
230965a81367SMatthew G. Knepley   PetscInt  i;
231065a81367SMatthew G. Knepley   for (i = 0; i < dim; ++i) prod += PetscSqr(x[i] - y[i]);
231165a81367SMatthew G. Knepley   return PetscSqrtReal(prod);
231265a81367SMatthew G. Knepley }
2313d71ae5a4SJacob Faibussowitsch static inline PetscReal DotReal(PetscInt dim, const PetscReal x[], const PetscReal y[])
2314d71ae5a4SJacob Faibussowitsch {
231565a81367SMatthew G. Knepley   PetscReal prod = 0.0;
231665a81367SMatthew G. Knepley   PetscInt  i;
231765a81367SMatthew G. Knepley   for (i = 0; i < dim; ++i) prod += x[i] * y[i];
231865a81367SMatthew G. Knepley   return prod;
231965a81367SMatthew G. Knepley }
232065a81367SMatthew G. Knepley 
232151a74b61SMatthew G. Knepley /* The first constant is the sphere radius */
2322d71ae5a4SJacob 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[])
2323d71ae5a4SJacob Faibussowitsch {
232451a74b61SMatthew G. Knepley   PetscReal r     = PetscRealPart(constants[0]);
232551a74b61SMatthew G. Knepley   PetscReal norm2 = 0.0, fac;
232651a74b61SMatthew G. Knepley   PetscInt  n     = uOff[1] - uOff[0], d;
232751a74b61SMatthew G. Knepley 
232851a74b61SMatthew G. Knepley   for (d = 0; d < n; ++d) norm2 += PetscSqr(PetscRealPart(u[d]));
232951a74b61SMatthew G. Knepley   fac = r / PetscSqrtReal(norm2);
233051a74b61SMatthew G. Knepley   for (d = 0; d < n; ++d) f0[d] = u[d] * fac;
233151a74b61SMatthew G. Knepley }
233251a74b61SMatthew G. Knepley 
2333d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateSphereMesh_Internal(DM dm, PetscInt dim, PetscBool simplex, PetscReal R)
2334d71ae5a4SJacob Faibussowitsch {
233565a81367SMatthew G. Knepley   const PetscInt embedDim = dim + 1;
233665a81367SMatthew G. Knepley   PetscSection   coordSection;
233765a81367SMatthew G. Knepley   Vec            coordinates;
233865a81367SMatthew G. Knepley   PetscScalar   *coords;
233965a81367SMatthew G. Knepley   PetscReal     *coordsIn;
2340064cae4fSPierre Jolivet   PetscInt       numCells, numEdges, numVerts = 0, firstVertex = 0, v, firstEdge, coordSize, d, c, e;
234165a81367SMatthew G. Knepley   PetscMPIInt    rank;
234265a81367SMatthew G. Knepley 
234365a81367SMatthew G. Knepley   PetscFunctionBegin;
23449318fe57SMatthew G. Knepley   PetscValidLogicalCollectiveBool(dm, simplex, 3);
234546139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
23469566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
23479566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, dim + 1));
23489566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
234965a81367SMatthew G. Knepley   switch (dim) {
2350*5c344501SMatthew G. Knepley   case 1:
2351*5c344501SMatthew G. Knepley     numCells = 16;
2352*5c344501SMatthew G. Knepley     numVerts = numCells;
2353*5c344501SMatthew G. Knepley 
2354*5c344501SMatthew G. Knepley     // Build Topology
2355*5c344501SMatthew G. Knepley     PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
2356*5c344501SMatthew G. Knepley     for (PetscInt c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
2357*5c344501SMatthew G. Knepley     PetscCall(DMSetUp(dm));
2358*5c344501SMatthew G. Knepley     for (PetscInt c = 0; c < numCells; ++c) {
2359*5c344501SMatthew G. Knepley       PetscInt cone[2];
2360*5c344501SMatthew G. Knepley 
2361*5c344501SMatthew G. Knepley       cone[0] = c + numCells;
2362*5c344501SMatthew G. Knepley       cone[1] = (c + 1) % numVerts + numCells;
2363*5c344501SMatthew G. Knepley       PetscCall(DMPlexSetCone(dm, c, cone));
2364*5c344501SMatthew G. Knepley     }
2365*5c344501SMatthew G. Knepley     PetscCall(DMPlexSymmetrize(dm));
2366*5c344501SMatthew G. Knepley     PetscCall(DMPlexStratify(dm));
2367*5c344501SMatthew G. Knepley     PetscCall(PetscMalloc1(numVerts * embedDim, &coordsIn));
2368*5c344501SMatthew G. Knepley     for (PetscInt v = 0; v < numVerts; ++v) {
2369*5c344501SMatthew G. Knepley       const PetscReal rad = 2. * PETSC_PI * v / numVerts;
2370*5c344501SMatthew G. Knepley 
2371*5c344501SMatthew G. Knepley       coordsIn[v * embedDim + 0] = PetscCosReal(rad);
2372*5c344501SMatthew G. Knepley       coordsIn[v * embedDim + 1] = PetscSinReal(rad);
2373*5c344501SMatthew G. Knepley     }
2374*5c344501SMatthew G. Knepley     break;
237565a81367SMatthew G. Knepley   case 2:
237665a81367SMatthew G. Knepley     if (simplex) {
237751a74b61SMatthew G. Knepley       const PetscReal radius    = PetscSqrtReal(1 + PETSC_PHI * PETSC_PHI) / (1.0 + PETSC_PHI);
237851a74b61SMatthew G. Knepley       const PetscReal edgeLen   = 2.0 / (1.0 + PETSC_PHI) * (R / radius);
237965a81367SMatthew G. Knepley       const PetscInt  degree    = 5;
238051a74b61SMatthew G. Knepley       PetscReal       vertex[3] = {0.0, 1.0 / (1.0 + PETSC_PHI), PETSC_PHI / (1.0 + PETSC_PHI)};
238165a81367SMatthew G. Knepley       PetscInt        s[3]      = {1, 1, 1};
238265a81367SMatthew G. Knepley       PetscInt        cone[3];
238365a81367SMatthew G. Knepley       PetscInt       *graph, p, i, j, k;
238465a81367SMatthew G. Knepley 
23859371c9d4SSatish Balay       vertex[0] *= R / radius;
23869371c9d4SSatish Balay       vertex[1] *= R / radius;
23879371c9d4SSatish Balay       vertex[2] *= R / radius;
2388dd400576SPatrick Sanan       numCells    = rank == 0 ? 20 : 0;
2389dd400576SPatrick Sanan       numVerts    = rank == 0 ? 12 : 0;
239065a81367SMatthew G. Knepley       firstVertex = numCells;
239151a74b61SMatthew G. Knepley       /* Use icosahedron, which for a R-sphere has coordinates which are all cyclic permutations of
239265a81367SMatthew G. Knepley 
239365a81367SMatthew G. Knepley            (0, \pm 1/\phi+1, \pm \phi/\phi+1)
239465a81367SMatthew G. Knepley 
239565a81367SMatthew G. Knepley          where \phi^2 - \phi - 1 = 0, meaning \phi is the golden ratio \frac{1 + \sqrt{5}}{2}. The edge
239651a74b61SMatthew G. Knepley          length is then given by 2/(1+\phi) = 2 * 0.38197 = 0.76393.
239765a81367SMatthew G. Knepley       */
239865a81367SMatthew G. Knepley       /* Construct vertices */
23999566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2400dd400576SPatrick Sanan       if (rank == 0) {
240165a81367SMatthew G. Knepley         for (p = 0, i = 0; p < embedDim; ++p) {
240265a81367SMatthew G. Knepley           for (s[1] = -1; s[1] < 2; s[1] += 2) {
240365a81367SMatthew G. Knepley             for (s[2] = -1; s[2] < 2; s[2] += 2) {
240465a81367SMatthew G. Knepley               for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[(d + p) % embedDim] * vertex[(d + p) % embedDim];
240565a81367SMatthew G. Knepley               ++i;
240665a81367SMatthew G. Knepley             }
240765a81367SMatthew G. Knepley           }
240865a81367SMatthew G. Knepley         }
240945da822fSValeria Barra       }
241065a81367SMatthew G. Knepley       /* Construct graph */
24119566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * numVerts, &graph));
241265a81367SMatthew G. Knepley       for (i = 0; i < numVerts; ++i) {
241365a81367SMatthew G. Knepley         for (j = 0, k = 0; j < numVerts; ++j) {
24149371c9d4SSatish Balay           if (PetscAbsReal(DiffNormReal(embedDim, &coordsIn[i * embedDim], &coordsIn[j * embedDim]) - edgeLen) < PETSC_SMALL) {
24159371c9d4SSatish Balay             graph[i * numVerts + j] = 1;
24169371c9d4SSatish Balay             ++k;
24179371c9d4SSatish Balay           }
241865a81367SMatthew G. Knepley         }
241963a3b9bcSJacob Faibussowitsch         PetscCheck(k == degree, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid icosahedron, vertex %" PetscInt_FMT " degree %" PetscInt_FMT " != %" PetscInt_FMT, i, k, degree);
242065a81367SMatthew G. Knepley       }
242165a81367SMatthew G. Knepley       /* Build Topology */
24229566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
242348a46eb9SPierre Jolivet       for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
24249566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
242565a81367SMatthew G. Knepley       /* Cells */
242665a81367SMatthew G. Knepley       for (i = 0, c = 0; i < numVerts; ++i) {
242765a81367SMatthew G. Knepley         for (j = 0; j < i; ++j) {
242865a81367SMatthew G. Knepley           for (k = 0; k < j; ++k) {
242965a81367SMatthew G. Knepley             if (graph[i * numVerts + j] && graph[j * numVerts + k] && graph[k * numVerts + i]) {
24309371c9d4SSatish Balay               cone[0] = firstVertex + i;
24319371c9d4SSatish Balay               cone[1] = firstVertex + j;
24329371c9d4SSatish Balay               cone[2] = firstVertex + k;
243365a81367SMatthew G. Knepley               /* Check orientation */
243465a81367SMatthew G. Knepley               {
24359371c9d4SSatish Balay                 const PetscInt epsilon[3][3][3] = {
24369371c9d4SSatish Balay                   {{0, 0, 0},  {0, 0, 1},  {0, -1, 0}},
24379371c9d4SSatish Balay                   {{0, 0, -1}, {0, 0, 0},  {1, 0, 0} },
24389371c9d4SSatish Balay                   {{0, 1, 0},  {-1, 0, 0}, {0, 0, 0} }
24399371c9d4SSatish Balay                 };
244065a81367SMatthew G. Knepley                 PetscReal normal[3];
244165a81367SMatthew G. Knepley                 PetscInt  e, f;
244265a81367SMatthew G. Knepley 
244365a81367SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) {
244465a81367SMatthew G. Knepley                   normal[d] = 0.0;
244565a81367SMatthew G. Knepley                   for (e = 0; e < embedDim; ++e) {
2446ad540459SPierre 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]);
244765a81367SMatthew G. Knepley                   }
244865a81367SMatthew G. Knepley                 }
24499371c9d4SSatish Balay                 if (DotReal(embedDim, normal, &coordsIn[i * embedDim]) < 0) {
24509371c9d4SSatish Balay                   PetscInt tmp = cone[1];
24519371c9d4SSatish Balay                   cone[1]      = cone[2];
24529371c9d4SSatish Balay                   cone[2]      = tmp;
245365a81367SMatthew G. Knepley                 }
245465a81367SMatthew G. Knepley               }
24559566063dSJacob Faibussowitsch               PetscCall(DMPlexSetCone(dm, c++, cone));
245665a81367SMatthew G. Knepley             }
245765a81367SMatthew G. Knepley           }
245865a81367SMatthew G. Knepley         }
245965a81367SMatthew G. Knepley       }
24609566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
24619566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
24629566063dSJacob Faibussowitsch       PetscCall(PetscFree(graph));
246365a81367SMatthew G. Knepley     } else {
24642829fed8SMatthew G. Knepley       /*
24652829fed8SMatthew G. Knepley         12-21--13
24662829fed8SMatthew G. Knepley          |     |
24672829fed8SMatthew G. Knepley         25  4  24
24682829fed8SMatthew G. Knepley          |     |
24692829fed8SMatthew G. Knepley   12-25--9-16--8-24--13
24702829fed8SMatthew G. Knepley    |     |     |     |
24712829fed8SMatthew G. Knepley   23  5 17  0 15  3  22
24722829fed8SMatthew G. Knepley    |     |     |     |
24732829fed8SMatthew G. Knepley   10-20--6-14--7-19--11
24742829fed8SMatthew G. Knepley          |     |
24752829fed8SMatthew G. Knepley         20  1  19
24762829fed8SMatthew G. Knepley          |     |
24772829fed8SMatthew G. Knepley         10-18--11
24782829fed8SMatthew G. Knepley          |     |
24792829fed8SMatthew G. Knepley         23  2  22
24802829fed8SMatthew G. Knepley          |     |
24812829fed8SMatthew G. Knepley         12-21--13
24822829fed8SMatthew G. Knepley        */
24832829fed8SMatthew G. Knepley       PetscInt cone[4], ornt[4];
24842829fed8SMatthew G. Knepley 
2485dd400576SPatrick Sanan       numCells    = rank == 0 ? 6 : 0;
2486dd400576SPatrick Sanan       numEdges    = rank == 0 ? 12 : 0;
2487dd400576SPatrick Sanan       numVerts    = rank == 0 ? 8 : 0;
248865a81367SMatthew G. Knepley       firstVertex = numCells;
248965a81367SMatthew G. Knepley       firstEdge   = numCells + numVerts;
24902829fed8SMatthew G. Knepley       /* Build Topology */
24919566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numEdges + numVerts));
249248a46eb9SPierre Jolivet       for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 4));
249348a46eb9SPierre Jolivet       for (e = firstEdge; e < firstEdge + numEdges; ++e) PetscCall(DMPlexSetConeSize(dm, e, 2));
24949566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
2495dd400576SPatrick Sanan       if (rank == 0) {
24962829fed8SMatthew G. Knepley         /* Cell 0 */
24979371c9d4SSatish Balay         cone[0] = 14;
24989371c9d4SSatish Balay         cone[1] = 15;
24999371c9d4SSatish Balay         cone[2] = 16;
25009371c9d4SSatish Balay         cone[3] = 17;
25019566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
25029371c9d4SSatish Balay         ornt[0] = 0;
25039371c9d4SSatish Balay         ornt[1] = 0;
25049371c9d4SSatish Balay         ornt[2] = 0;
25059371c9d4SSatish Balay         ornt[3] = 0;
25069566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 0, ornt));
25072829fed8SMatthew G. Knepley         /* Cell 1 */
25089371c9d4SSatish Balay         cone[0] = 18;
25099371c9d4SSatish Balay         cone[1] = 19;
25109371c9d4SSatish Balay         cone[2] = 14;
25119371c9d4SSatish Balay         cone[3] = 20;
25129566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
25139371c9d4SSatish Balay         ornt[0] = 0;
25149371c9d4SSatish Balay         ornt[1] = 0;
25159371c9d4SSatish Balay         ornt[2] = -1;
25169371c9d4SSatish Balay         ornt[3] = 0;
25179566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 1, ornt));
25182829fed8SMatthew G. Knepley         /* Cell 2 */
25199371c9d4SSatish Balay         cone[0] = 21;
25209371c9d4SSatish Balay         cone[1] = 22;
25219371c9d4SSatish Balay         cone[2] = 18;
25229371c9d4SSatish Balay         cone[3] = 23;
25239566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
25249371c9d4SSatish Balay         ornt[0] = 0;
25259371c9d4SSatish Balay         ornt[1] = 0;
25269371c9d4SSatish Balay         ornt[2] = -1;
25279371c9d4SSatish Balay         ornt[3] = 0;
25289566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 2, ornt));
25292829fed8SMatthew G. Knepley         /* Cell 3 */
25309371c9d4SSatish Balay         cone[0] = 19;
25319371c9d4SSatish Balay         cone[1] = 22;
25329371c9d4SSatish Balay         cone[2] = 24;
25339371c9d4SSatish Balay         cone[3] = 15;
25349566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
25359371c9d4SSatish Balay         ornt[0] = -1;
25369371c9d4SSatish Balay         ornt[1] = -1;
25379371c9d4SSatish Balay         ornt[2] = 0;
25389371c9d4SSatish Balay         ornt[3] = -1;
25399566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 3, ornt));
25402829fed8SMatthew G. Knepley         /* Cell 4 */
25419371c9d4SSatish Balay         cone[0] = 16;
25429371c9d4SSatish Balay         cone[1] = 24;
25439371c9d4SSatish Balay         cone[2] = 21;
25449371c9d4SSatish Balay         cone[3] = 25;
25459566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
25469371c9d4SSatish Balay         ornt[0] = -1;
25479371c9d4SSatish Balay         ornt[1] = -1;
25489371c9d4SSatish Balay         ornt[2] = -1;
25499371c9d4SSatish Balay         ornt[3] = 0;
25509566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 4, ornt));
25512829fed8SMatthew G. Knepley         /* Cell 5 */
25529371c9d4SSatish Balay         cone[0] = 20;
25539371c9d4SSatish Balay         cone[1] = 17;
25549371c9d4SSatish Balay         cone[2] = 25;
25559371c9d4SSatish Balay         cone[3] = 23;
25569566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 5, cone));
25579371c9d4SSatish Balay         ornt[0] = -1;
25589371c9d4SSatish Balay         ornt[1] = -1;
25599371c9d4SSatish Balay         ornt[2] = -1;
25609371c9d4SSatish Balay         ornt[3] = -1;
25619566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 5, ornt));
25622829fed8SMatthew G. Knepley         /* Edges */
25639371c9d4SSatish Balay         cone[0] = 6;
25649371c9d4SSatish Balay         cone[1] = 7;
25659566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 14, cone));
25669371c9d4SSatish Balay         cone[0] = 7;
25679371c9d4SSatish Balay         cone[1] = 8;
25689566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 15, cone));
25699371c9d4SSatish Balay         cone[0] = 8;
25709371c9d4SSatish Balay         cone[1] = 9;
25719566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 16, cone));
25729371c9d4SSatish Balay         cone[0] = 9;
25739371c9d4SSatish Balay         cone[1] = 6;
25749566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 17, cone));
25759371c9d4SSatish Balay         cone[0] = 10;
25769371c9d4SSatish Balay         cone[1] = 11;
25779566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 18, cone));
25789371c9d4SSatish Balay         cone[0] = 11;
25799371c9d4SSatish Balay         cone[1] = 7;
25809566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 19, cone));
25819371c9d4SSatish Balay         cone[0] = 6;
25829371c9d4SSatish Balay         cone[1] = 10;
25839566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 20, cone));
25849371c9d4SSatish Balay         cone[0] = 12;
25859371c9d4SSatish Balay         cone[1] = 13;
25869566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 21, cone));
25879371c9d4SSatish Balay         cone[0] = 13;
25889371c9d4SSatish Balay         cone[1] = 11;
25899566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 22, cone));
25909371c9d4SSatish Balay         cone[0] = 10;
25919371c9d4SSatish Balay         cone[1] = 12;
25929566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 23, cone));
25939371c9d4SSatish Balay         cone[0] = 13;
25949371c9d4SSatish Balay         cone[1] = 8;
25959566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 24, cone));
25969371c9d4SSatish Balay         cone[0] = 12;
25979371c9d4SSatish Balay         cone[1] = 9;
25989566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 25, cone));
259945da822fSValeria Barra       }
26009566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
26019566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
26022829fed8SMatthew G. Knepley       /* Build coordinates */
26039566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2604dd400576SPatrick Sanan       if (rank == 0) {
26059371c9d4SSatish Balay         coordsIn[0 * embedDim + 0] = -R;
26069371c9d4SSatish Balay         coordsIn[0 * embedDim + 1] = R;
26079371c9d4SSatish Balay         coordsIn[0 * embedDim + 2] = -R;
26089371c9d4SSatish Balay         coordsIn[1 * embedDim + 0] = R;
26099371c9d4SSatish Balay         coordsIn[1 * embedDim + 1] = R;
26109371c9d4SSatish Balay         coordsIn[1 * embedDim + 2] = -R;
26119371c9d4SSatish Balay         coordsIn[2 * embedDim + 0] = R;
26129371c9d4SSatish Balay         coordsIn[2 * embedDim + 1] = -R;
26139371c9d4SSatish Balay         coordsIn[2 * embedDim + 2] = -R;
26149371c9d4SSatish Balay         coordsIn[3 * embedDim + 0] = -R;
26159371c9d4SSatish Balay         coordsIn[3 * embedDim + 1] = -R;
26169371c9d4SSatish Balay         coordsIn[3 * embedDim + 2] = -R;
26179371c9d4SSatish Balay         coordsIn[4 * embedDim + 0] = -R;
26189371c9d4SSatish Balay         coordsIn[4 * embedDim + 1] = R;
26199371c9d4SSatish Balay         coordsIn[4 * embedDim + 2] = R;
26209371c9d4SSatish Balay         coordsIn[5 * embedDim + 0] = R;
26219371c9d4SSatish Balay         coordsIn[5 * embedDim + 1] = R;
26229371c9d4SSatish Balay         coordsIn[5 * embedDim + 2] = R;
26239371c9d4SSatish Balay         coordsIn[6 * embedDim + 0] = -R;
26249371c9d4SSatish Balay         coordsIn[6 * embedDim + 1] = -R;
26259371c9d4SSatish Balay         coordsIn[6 * embedDim + 2] = R;
26269371c9d4SSatish Balay         coordsIn[7 * embedDim + 0] = R;
26279371c9d4SSatish Balay         coordsIn[7 * embedDim + 1] = -R;
26289371c9d4SSatish Balay         coordsIn[7 * embedDim + 2] = R;
262965a81367SMatthew G. Knepley       }
263045da822fSValeria Barra     }
263165a81367SMatthew G. Knepley     break;
263265a81367SMatthew G. Knepley   case 3:
2633116ded15SMatthew G. Knepley     if (simplex) {
2634116ded15SMatthew G. Knepley       const PetscReal edgeLen         = 1.0 / PETSC_PHI;
263551a74b61SMatthew G. Knepley       PetscReal       vertexA[4]      = {0.5, 0.5, 0.5, 0.5};
263651a74b61SMatthew G. Knepley       PetscReal       vertexB[4]      = {1.0, 0.0, 0.0, 0.0};
263751a74b61SMatthew G. Knepley       PetscReal       vertexC[4]      = {0.5, 0.5 * PETSC_PHI, 0.5 / PETSC_PHI, 0.0};
2638116ded15SMatthew G. Knepley       const PetscInt  degree          = 12;
2639116ded15SMatthew G. Knepley       PetscInt        s[4]            = {1, 1, 1};
26409371c9d4SSatish Balay       PetscInt        evenPerm[12][4] = {
26419371c9d4SSatish Balay         {0, 1, 2, 3},
26429371c9d4SSatish Balay         {0, 2, 3, 1},
26439371c9d4SSatish Balay         {0, 3, 1, 2},
26449371c9d4SSatish Balay         {1, 0, 3, 2},
26459371c9d4SSatish Balay         {1, 2, 0, 3},
26469371c9d4SSatish Balay         {1, 3, 2, 0},
26479371c9d4SSatish Balay         {2, 0, 1, 3},
26489371c9d4SSatish Balay         {2, 1, 3, 0},
26499371c9d4SSatish Balay         {2, 3, 0, 1},
26509371c9d4SSatish Balay         {3, 0, 2, 1},
26519371c9d4SSatish Balay         {3, 1, 0, 2},
26529371c9d4SSatish Balay         {3, 2, 1, 0}
26539371c9d4SSatish Balay       };
2654116ded15SMatthew G. Knepley       PetscInt  cone[4];
2655116ded15SMatthew G. Knepley       PetscInt *graph, p, i, j, k, l;
2656116ded15SMatthew G. Knepley 
26579371c9d4SSatish Balay       vertexA[0] *= R;
26589371c9d4SSatish Balay       vertexA[1] *= R;
26599371c9d4SSatish Balay       vertexA[2] *= R;
26609371c9d4SSatish Balay       vertexA[3] *= R;
26619371c9d4SSatish Balay       vertexB[0] *= R;
26629371c9d4SSatish Balay       vertexB[1] *= R;
26639371c9d4SSatish Balay       vertexB[2] *= R;
26649371c9d4SSatish Balay       vertexB[3] *= R;
26659371c9d4SSatish Balay       vertexC[0] *= R;
26669371c9d4SSatish Balay       vertexC[1] *= R;
26679371c9d4SSatish Balay       vertexC[2] *= R;
26689371c9d4SSatish Balay       vertexC[3] *= R;
2669dd400576SPatrick Sanan       numCells    = rank == 0 ? 600 : 0;
2670dd400576SPatrick Sanan       numVerts    = rank == 0 ? 120 : 0;
2671116ded15SMatthew G. Knepley       firstVertex = numCells;
2672116ded15SMatthew G. Knepley       /* Use the 600-cell, which for a unit sphere has coordinates which are
2673116ded15SMatthew G. Knepley 
2674116ded15SMatthew G. Knepley            1/2 (\pm 1, \pm 1,    \pm 1, \pm 1)                          16
2675116ded15SMatthew G. Knepley                (\pm 1,    0,       0,      0)  all cyclic permutations   8
2676116ded15SMatthew G. Knepley            1/2 (\pm 1, \pm phi, \pm 1/phi, 0)  all even permutations    96
2677116ded15SMatthew G. Knepley 
2678116ded15SMatthew G. Knepley          where \phi^2 - \phi - 1 = 0, meaning \phi is the golden ratio \frac{1 + \sqrt{5}}{2}. The edge
26796333ae4fSvaleriabarra          length is then given by 1/\phi = 0.61803.
2680116ded15SMatthew G. Knepley 
2681116ded15SMatthew G. Knepley          http://buzzard.pugetsound.edu/sage-practice/ch03s03.html
2682116ded15SMatthew G. Knepley          http://mathworld.wolfram.com/600-Cell.html
2683116ded15SMatthew G. Knepley       */
2684116ded15SMatthew G. Knepley       /* Construct vertices */
26859566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2686116ded15SMatthew G. Knepley       i = 0;
2687dd400576SPatrick Sanan       if (rank == 0) {
2688116ded15SMatthew G. Knepley         for (s[0] = -1; s[0] < 2; s[0] += 2) {
2689116ded15SMatthew G. Knepley           for (s[1] = -1; s[1] < 2; s[1] += 2) {
2690116ded15SMatthew G. Knepley             for (s[2] = -1; s[2] < 2; s[2] += 2) {
2691116ded15SMatthew G. Knepley               for (s[3] = -1; s[3] < 2; s[3] += 2) {
2692116ded15SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[d] * vertexA[d];
2693116ded15SMatthew G. Knepley                 ++i;
2694116ded15SMatthew G. Knepley               }
2695116ded15SMatthew G. Knepley             }
2696116ded15SMatthew G. Knepley           }
2697116ded15SMatthew G. Knepley         }
2698116ded15SMatthew G. Knepley         for (p = 0; p < embedDim; ++p) {
2699116ded15SMatthew G. Knepley           s[1] = s[2] = s[3] = 1;
2700116ded15SMatthew G. Knepley           for (s[0] = -1; s[0] < 2; s[0] += 2) {
2701116ded15SMatthew G. Knepley             for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[(d + p) % embedDim] * vertexB[(d + p) % embedDim];
2702116ded15SMatthew G. Knepley             ++i;
2703116ded15SMatthew G. Knepley           }
2704116ded15SMatthew G. Knepley         }
2705116ded15SMatthew G. Knepley         for (p = 0; p < 12; ++p) {
2706116ded15SMatthew G. Knepley           s[3] = 1;
2707116ded15SMatthew G. Knepley           for (s[0] = -1; s[0] < 2; s[0] += 2) {
2708116ded15SMatthew G. Knepley             for (s[1] = -1; s[1] < 2; s[1] += 2) {
2709116ded15SMatthew G. Knepley               for (s[2] = -1; s[2] < 2; s[2] += 2) {
2710116ded15SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[evenPerm[p][d]] * vertexC[evenPerm[p][d]];
2711116ded15SMatthew G. Knepley                 ++i;
2712116ded15SMatthew G. Knepley               }
2713116ded15SMatthew G. Knepley             }
2714116ded15SMatthew G. Knepley           }
2715116ded15SMatthew G. Knepley         }
271645da822fSValeria Barra       }
271763a3b9bcSJacob Faibussowitsch       PetscCheck(i == numVerts, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid 600-cell, vertices %" PetscInt_FMT " != %" PetscInt_FMT, i, numVerts);
2718116ded15SMatthew G. Knepley       /* Construct graph */
27199566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * numVerts, &graph));
2720116ded15SMatthew G. Knepley       for (i = 0; i < numVerts; ++i) {
2721116ded15SMatthew G. Knepley         for (j = 0, k = 0; j < numVerts; ++j) {
27229371c9d4SSatish Balay           if (PetscAbsReal(DiffNormReal(embedDim, &coordsIn[i * embedDim], &coordsIn[j * embedDim]) - edgeLen) < PETSC_SMALL) {
27239371c9d4SSatish Balay             graph[i * numVerts + j] = 1;
27249371c9d4SSatish Balay             ++k;
27259371c9d4SSatish Balay           }
2726116ded15SMatthew G. Knepley         }
272763a3b9bcSJacob Faibussowitsch         PetscCheck(k == degree, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid 600-cell, vertex %" PetscInt_FMT " degree %" PetscInt_FMT " != %" PetscInt_FMT, i, k, degree);
2728116ded15SMatthew G. Knepley       }
2729116ded15SMatthew G. Knepley       /* Build Topology */
27309566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
273148a46eb9SPierre Jolivet       for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
27329566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
2733116ded15SMatthew G. Knepley       /* Cells */
2734dd400576SPatrick Sanan       if (rank == 0) {
2735116ded15SMatthew G. Knepley         for (i = 0, c = 0; i < numVerts; ++i) {
2736116ded15SMatthew G. Knepley           for (j = 0; j < i; ++j) {
2737116ded15SMatthew G. Knepley             for (k = 0; k < j; ++k) {
2738116ded15SMatthew G. Knepley               for (l = 0; l < k; ++l) {
27399371c9d4SSatish 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]) {
27409371c9d4SSatish Balay                   cone[0] = firstVertex + i;
27419371c9d4SSatish Balay                   cone[1] = firstVertex + j;
27429371c9d4SSatish Balay                   cone[2] = firstVertex + k;
27439371c9d4SSatish Balay                   cone[3] = firstVertex + l;
2744116ded15SMatthew G. Knepley                   /* Check orientation: https://ef.gy/linear-algebra:normal-vectors-in-higher-dimensional-spaces */
2745116ded15SMatthew G. Knepley                   {
27469371c9d4SSatish Balay                     const PetscInt epsilon[4][4][4][4] = {
27479371c9d4SSatish 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}}},
2748116ded15SMatthew G. Knepley 
27499371c9d4SSatish 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}}},
2750116ded15SMatthew G. Knepley 
27519371c9d4SSatish 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}}},
2752116ded15SMatthew G. Knepley 
27539371c9d4SSatish 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}} }
27549371c9d4SSatish Balay                     };
2755116ded15SMatthew G. Knepley                     PetscReal normal[4];
2756116ded15SMatthew G. Knepley                     PetscInt  e, f, g;
2757116ded15SMatthew G. Knepley 
2758116ded15SMatthew G. Knepley                     for (d = 0; d < embedDim; ++d) {
2759116ded15SMatthew G. Knepley                       normal[d] = 0.0;
2760116ded15SMatthew G. Knepley                       for (e = 0; e < embedDim; ++e) {
2761116ded15SMatthew G. Knepley                         for (f = 0; f < embedDim; ++f) {
2762116ded15SMatthew G. Knepley                           for (g = 0; g < embedDim; ++g) {
2763116ded15SMatthew 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]);
2764116ded15SMatthew G. Knepley                           }
2765116ded15SMatthew G. Knepley                         }
2766116ded15SMatthew G. Knepley                       }
2767116ded15SMatthew G. Knepley                     }
27689371c9d4SSatish Balay                     if (DotReal(embedDim, normal, &coordsIn[i * embedDim]) < 0) {
27699371c9d4SSatish Balay                       PetscInt tmp = cone[1];
27709371c9d4SSatish Balay                       cone[1]      = cone[2];
27719371c9d4SSatish Balay                       cone[2]      = tmp;
27729371c9d4SSatish Balay                     }
2773116ded15SMatthew G. Knepley                   }
27749566063dSJacob Faibussowitsch                   PetscCall(DMPlexSetCone(dm, c++, cone));
2775116ded15SMatthew G. Knepley                 }
2776116ded15SMatthew G. Knepley               }
2777116ded15SMatthew G. Knepley             }
2778116ded15SMatthew G. Knepley           }
2779116ded15SMatthew G. Knepley         }
278045da822fSValeria Barra       }
27819566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
27829566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
27839566063dSJacob Faibussowitsch       PetscCall(PetscFree(graph));
2784116ded15SMatthew G. Knepley     }
2785f4d061e9SPierre Jolivet     break;
2786d71ae5a4SJacob Faibussowitsch   default:
2787d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Unsupported dimension for sphere: %" PetscInt_FMT, dim);
278865a81367SMatthew G. Knepley   }
278965a81367SMatthew G. Knepley   /* Create coordinates */
27909566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
27919566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
27929566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, embedDim));
27939566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numVerts));
27942829fed8SMatthew G. Knepley   for (v = firstVertex; v < firstVertex + numVerts; ++v) {
27959566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, embedDim));
27969566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, embedDim));
27972829fed8SMatthew G. Knepley   }
27989566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
27999566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
28009566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
28019566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, embedDim));
28029566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
28039566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
28049566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
28059566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
28069371c9d4SSatish Balay   for (v = 0; v < numVerts; ++v)
2807ad540459SPierre Jolivet     for (d = 0; d < embedDim; ++d) coords[v * embedDim + d] = coordsIn[v * embedDim + d];
28089566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
28099566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
28109566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
28119566063dSJacob Faibussowitsch   PetscCall(PetscFree(coordsIn));
281251a74b61SMatthew G. Knepley   {
281351a74b61SMatthew G. Knepley     DM          cdm;
281451a74b61SMatthew G. Knepley     PetscDS     cds;
28159318fe57SMatthew G. Knepley     PetscScalar c = R;
281651a74b61SMatthew G. Knepley 
2817e44f6aebSMatthew G. Knepley     PetscCall(DMPlexCreateCoordinateSpace(dm, 1, PETSC_TRUE, snapToSphere));
28189566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
28199566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
28209566063dSJacob Faibussowitsch     PetscCall(PetscDSSetConstants(cds, 1, &c));
282151a74b61SMatthew G. Knepley   }
282246139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
28239318fe57SMatthew G. Knepley   /* Wait for coordinate creation before doing in-place modification */
28249566063dSJacob Faibussowitsch   if (simplex) PetscCall(DMPlexInterpolateInPlace_Internal(dm));
28253ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
28269318fe57SMatthew G. Knepley }
28279318fe57SMatthew G. Knepley 
2828b7f5c055SJed Brown typedef void (*TPSEvaluateFunc)(const PetscReal[], PetscReal *, PetscReal[], PetscReal (*)[3]);
2829b7f5c055SJed Brown 
2830b7f5c055SJed Brown /*
2831b7f5c055SJed Brown  The Schwarz P implicit surface is
2832b7f5c055SJed Brown 
2833b7f5c055SJed Brown      f(x) = cos(x0) + cos(x1) + cos(x2) = 0
2834b7f5c055SJed Brown */
2835d71ae5a4SJacob Faibussowitsch static void TPSEvaluate_SchwarzP(const PetscReal y[3], PetscReal *f, PetscReal grad[], PetscReal (*hess)[3])
2836d71ae5a4SJacob Faibussowitsch {
2837b7f5c055SJed Brown   PetscReal c[3] = {PetscCosReal(y[0] * PETSC_PI), PetscCosReal(y[1] * PETSC_PI), PetscCosReal(y[2] * PETSC_PI)};
2838b7f5c055SJed Brown   PetscReal g[3] = {-PetscSinReal(y[0] * PETSC_PI), -PetscSinReal(y[1] * PETSC_PI), -PetscSinReal(y[2] * PETSC_PI)};
2839b7f5c055SJed Brown   f[0]           = c[0] + c[1] + c[2];
2840b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) {
2841b7f5c055SJed Brown     grad[i] = PETSC_PI * g[i];
2842ad540459SPierre Jolivet     for (PetscInt j = 0; j < 3; j++) hess[i][j] = (i == j) ? -PetscSqr(PETSC_PI) * c[i] : 0.;
2843b7f5c055SJed Brown   }
2844b7f5c055SJed Brown }
2845b7f5c055SJed Brown 
28464663dae6SJed Brown // u[] is a tentative normal on input. Replace with the implicit function gradient in the same direction
2847d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSExtrudeNormalFunc_SchwarzP(PetscInt dim, PetscReal time, const PetscReal x[], PetscInt r, PetscScalar u[], void *ctx)
2848d71ae5a4SJacob Faibussowitsch {
2849ad540459SPierre Jolivet   for (PetscInt i = 0; i < 3; i++) u[i] = -PETSC_PI * PetscSinReal(x[i] * PETSC_PI);
28503ba16761SJacob Faibussowitsch   return PETSC_SUCCESS;
28514663dae6SJed Brown }
28524663dae6SJed Brown 
2853b7f5c055SJed Brown /*
2854b7f5c055SJed Brown  The Gyroid implicit surface is
2855b7f5c055SJed Brown 
2856b7f5c055SJed 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)
2857b7f5c055SJed Brown 
2858b7f5c055SJed Brown */
2859d71ae5a4SJacob Faibussowitsch static void TPSEvaluate_Gyroid(const PetscReal y[3], PetscReal *f, PetscReal grad[], PetscReal (*hess)[3])
2860d71ae5a4SJacob Faibussowitsch {
2861b7f5c055SJed Brown   PetscReal s[3] = {PetscSinReal(PETSC_PI * y[0]), PetscSinReal(PETSC_PI * (y[1] + .5)), PetscSinReal(PETSC_PI * (y[2] + .25))};
2862b7f5c055SJed Brown   PetscReal c[3] = {PetscCosReal(PETSC_PI * y[0]), PetscCosReal(PETSC_PI * (y[1] + .5)), PetscCosReal(PETSC_PI * (y[2] + .25))};
2863b7f5c055SJed Brown   f[0]           = s[0] * c[1] + s[1] * c[2] + s[2] * c[0];
2864b7f5c055SJed Brown   grad[0]        = PETSC_PI * (c[0] * c[1] - s[2] * s[0]);
2865b7f5c055SJed Brown   grad[1]        = PETSC_PI * (c[1] * c[2] - s[0] * s[1]);
2866b7f5c055SJed Brown   grad[2]        = PETSC_PI * (c[2] * c[0] - s[1] * s[2]);
2867b7f5c055SJed Brown   hess[0][0]     = -PetscSqr(PETSC_PI) * (s[0] * c[1] + s[2] * c[0]);
2868b7f5c055SJed Brown   hess[0][1]     = -PetscSqr(PETSC_PI) * (c[0] * s[1]);
2869b7f5c055SJed Brown   hess[0][2]     = -PetscSqr(PETSC_PI) * (c[2] * s[0]);
2870b7f5c055SJed Brown   hess[1][0]     = -PetscSqr(PETSC_PI) * (s[1] * c[2] + s[0] * c[1]);
2871b7f5c055SJed Brown   hess[1][1]     = -PetscSqr(PETSC_PI) * (c[1] * s[2]);
2872b7f5c055SJed Brown   hess[2][2]     = -PetscSqr(PETSC_PI) * (c[0] * s[1]);
2873b7f5c055SJed Brown   hess[2][0]     = -PetscSqr(PETSC_PI) * (s[2] * c[0] + s[1] * c[2]);
2874b7f5c055SJed Brown   hess[2][1]     = -PetscSqr(PETSC_PI) * (c[2] * s[0]);
2875b7f5c055SJed Brown   hess[2][2]     = -PetscSqr(PETSC_PI) * (c[1] * s[2]);
2876b7f5c055SJed Brown }
2877b7f5c055SJed Brown 
28784663dae6SJed Brown // u[] is a tentative normal on input. Replace with the implicit function gradient in the same direction
2879d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSExtrudeNormalFunc_Gyroid(PetscInt dim, PetscReal time, const PetscReal x[], PetscInt r, PetscScalar u[], void *ctx)
2880d71ae5a4SJacob Faibussowitsch {
28814663dae6SJed Brown   PetscReal s[3] = {PetscSinReal(PETSC_PI * x[0]), PetscSinReal(PETSC_PI * (x[1] + .5)), PetscSinReal(PETSC_PI * (x[2] + .25))};
28824663dae6SJed Brown   PetscReal c[3] = {PetscCosReal(PETSC_PI * x[0]), PetscCosReal(PETSC_PI * (x[1] + .5)), PetscCosReal(PETSC_PI * (x[2] + .25))};
28834663dae6SJed Brown   u[0]           = PETSC_PI * (c[0] * c[1] - s[2] * s[0]);
28844663dae6SJed Brown   u[1]           = PETSC_PI * (c[1] * c[2] - s[0] * s[1]);
28854663dae6SJed Brown   u[2]           = PETSC_PI * (c[2] * c[0] - s[1] * s[2]);
28863ba16761SJacob Faibussowitsch   return PETSC_SUCCESS;
28874663dae6SJed Brown }
28884663dae6SJed Brown 
2889b7f5c055SJed Brown /*
2890b7f5c055SJed Brown    We wish to solve
2891b7f5c055SJed Brown 
2892b7f5c055SJed Brown          min_y || y - x ||^2  subject to f(y) = 0
2893b7f5c055SJed Brown 
2894b7f5c055SJed Brown    Let g(y) = grad(f).  The minimization problem is equivalent to asking to satisfy
2895b7f5c055SJed 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
2896b7f5c055SJed Brown    tangent space and ask for both components in the tangent space to be zero.
2897b7f5c055SJed Brown 
2898b7f5c055SJed Brown    Take g to be a column vector and compute the "full QR" factorization Q R = g,
2899b7f5c055SJed Brown    where Q = I - 2 n n^T is a symmetric orthogonal matrix.
2900b7f5c055SJed Brown    The first column of Q is parallel to g so the remaining two columns span the null space.
2901b7f5c055SJed Brown    Let Qn = Q[:,1:] be those remaining columns.  Then Qn Qn^T is an orthogonal projector into the tangent space.
2902da81f932SPierre Jolivet    Since Q is symmetric, this is equivalent to multiplying by Q and taking the last two entries.
2903b7f5c055SJed Brown    In total, we have a system of 3 equations in 3 unknowns:
2904b7f5c055SJed Brown 
2905b7f5c055SJed Brown      f(y) = 0                       1 equation
2906b7f5c055SJed Brown      Qn^T (y - x) = 0               2 equations
2907b7f5c055SJed Brown 
2908b7f5c055SJed Brown    Here, we compute the residual and Jacobian of this system.
2909b7f5c055SJed Brown */
2910d71ae5a4SJacob Faibussowitsch static void TPSNearestPointResJac(TPSEvaluateFunc feval, const PetscScalar x[], const PetscScalar y[], PetscScalar res[], PetscScalar J[])
2911d71ae5a4SJacob Faibussowitsch {
2912b7f5c055SJed Brown   PetscReal yreal[3] = {PetscRealPart(y[0]), PetscRealPart(y[1]), PetscRealPart(y[2])};
2913b7f5c055SJed Brown   PetscReal d[3]     = {PetscRealPart(y[0] - x[0]), PetscRealPart(y[1] - x[1]), PetscRealPart(y[2] - x[2])};
29142f0490c0SSatish Balay   PetscReal f, grad[3], n[3], norm, norm_y[3], nd, nd_y[3], sign;
29159371c9d4SSatish Balay   PetscReal n_y[3][3] = {
29169371c9d4SSatish Balay     {0, 0, 0},
29179371c9d4SSatish Balay     {0, 0, 0},
29189371c9d4SSatish Balay     {0, 0, 0}
29199371c9d4SSatish Balay   };
2920b7f5c055SJed Brown 
2921b7f5c055SJed Brown   feval(yreal, &f, grad, n_y);
2922b7f5c055SJed Brown 
2923b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) n[i] = grad[i];
2924b7f5c055SJed Brown   norm = PetscSqrtReal(PetscSqr(n[0]) + PetscSqr(n[1]) + PetscSqr(n[2]));
2925ad540459SPierre Jolivet   for (PetscInt i = 0; i < 3; i++) norm_y[i] = 1. / norm * n[i] * n_y[i][i];
2926b7f5c055SJed Brown 
2927b7f5c055SJed Brown   // Define the Householder reflector
2928b7f5c055SJed Brown   sign = n[0] >= 0 ? 1. : -1.;
2929b7f5c055SJed Brown   n[0] += norm * sign;
2930b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) n_y[0][i] += norm_y[i] * sign;
2931b7f5c055SJed Brown 
2932b7f5c055SJed Brown   norm      = PetscSqrtReal(PetscSqr(n[0]) + PetscSqr(n[1]) + PetscSqr(n[2]));
2933b7f5c055SJed Brown   norm_y[0] = 1. / norm * (n[0] * n_y[0][0]);
2934b7f5c055SJed Brown   norm_y[1] = 1. / norm * (n[0] * n_y[0][1] + n[1] * n_y[1][1]);
2935b7f5c055SJed Brown   norm_y[2] = 1. / norm * (n[0] * n_y[0][2] + n[2] * n_y[2][2]);
2936b7f5c055SJed Brown 
2937b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) {
2938b7f5c055SJed Brown     n[i] /= norm;
2939b7f5c055SJed Brown     for (PetscInt j = 0; j < 3; j++) {
2940b7f5c055SJed Brown       // note that n[i] is n_old[i]/norm when executing the code below
2941b7f5c055SJed Brown       n_y[i][j] = n_y[i][j] / norm - n[i] / norm * norm_y[j];
2942b7f5c055SJed Brown     }
2943b7f5c055SJed Brown   }
2944b7f5c055SJed Brown 
2945b7f5c055SJed Brown   nd = n[0] * d[0] + n[1] * d[1] + n[2] * d[2];
2946b7f5c055SJed 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];
2947b7f5c055SJed Brown 
2948b7f5c055SJed Brown   res[0] = f;
2949b7f5c055SJed Brown   res[1] = d[1] - 2 * n[1] * nd;
2950b7f5c055SJed Brown   res[2] = d[2] - 2 * n[2] * nd;
2951b7f5c055SJed Brown   // J[j][i] is J_{ij} (column major)
2952b7f5c055SJed Brown   for (PetscInt j = 0; j < 3; j++) {
2953b7f5c055SJed Brown     J[0 + j * 3] = grad[j];
2954b7f5c055SJed Brown     J[1 + j * 3] = (j == 1) * 1. - 2 * (n_y[1][j] * nd + n[1] * nd_y[j]);
2955b7f5c055SJed Brown     J[2 + j * 3] = (j == 2) * 1. - 2 * (n_y[2][j] * nd + n[2] * nd_y[j]);
2956b7f5c055SJed Brown   }
2957b7f5c055SJed Brown }
2958b7f5c055SJed Brown 
2959b7f5c055SJed Brown /*
2960b7f5c055SJed Brown    Project x to the nearest point on the implicit surface using Newton's method.
2961b7f5c055SJed Brown */
2962d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSNearestPoint(TPSEvaluateFunc feval, PetscScalar x[])
2963d71ae5a4SJacob Faibussowitsch {
2964b7f5c055SJed Brown   PetscScalar y[3] = {x[0], x[1], x[2]}; // Initial guess
2965b7f5c055SJed Brown 
2966b7f5c055SJed Brown   PetscFunctionBegin;
2967b7f5c055SJed Brown   for (PetscInt iter = 0; iter < 10; iter++) {
2968b7f5c055SJed Brown     PetscScalar res[3], J[9];
2969b7f5c055SJed Brown     PetscReal   resnorm;
2970b7f5c055SJed Brown     TPSNearestPointResJac(feval, x, y, res, J);
2971b7f5c055SJed Brown     resnorm = PetscSqrtReal(PetscSqr(PetscRealPart(res[0])) + PetscSqr(PetscRealPart(res[1])) + PetscSqr(PetscRealPart(res[2])));
2972b7f5c055SJed Brown     if (0) { // Turn on this monitor if you need to confirm quadratic convergence
297363a3b9bcSJacob 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])));
2974b7f5c055SJed Brown     }
2975b7f5c055SJed Brown     if (resnorm < PETSC_SMALL) break;
2976b7f5c055SJed Brown 
2977b7f5c055SJed Brown     // Take the Newton step
29789566063dSJacob Faibussowitsch     PetscCall(PetscKernel_A_gets_inverse_A_3(J, 0., PETSC_FALSE, NULL));
2979b7f5c055SJed Brown     PetscKernel_v_gets_v_minus_A_times_w_3(y, J, res);
2980b7f5c055SJed Brown   }
2981b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) x[i] = y[i];
29823ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2983b7f5c055SJed Brown }
2984b7f5c055SJed Brown 
2985b7f5c055SJed Brown const char *const DMPlexTPSTypes[] = {"SCHWARZ_P", "GYROID", "DMPlexTPSType", "DMPLEX_TPS_", NULL};
2986b7f5c055SJed Brown 
2987d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateTPSMesh_Internal(DM dm, DMPlexTPSType tpstype, const PetscInt extent[], const DMBoundaryType periodic[], PetscBool tps_distribute, PetscInt refinements, PetscInt layers, PetscReal thickness)
2988d71ae5a4SJacob Faibussowitsch {
2989b7f5c055SJed Brown   PetscMPIInt rank;
2990b7f5c055SJed Brown   PetscInt    topoDim = 2, spaceDim = 3, numFaces = 0, numVertices = 0, numEdges = 0;
2991b7f5c055SJed Brown   PetscInt(*edges)[2] = NULL, *edgeSets = NULL;
2992b7f5c055SJed Brown   PetscInt            *cells_flat = NULL;
2993b7f5c055SJed Brown   PetscReal           *vtxCoords  = NULL;
2994b7f5c055SJed Brown   TPSEvaluateFunc      evalFunc   = NULL;
29954663dae6SJed Brown   PetscSimplePointFunc normalFunc = NULL;
2996b7f5c055SJed Brown   DMLabel              label;
2997b7f5c055SJed Brown 
2998b7f5c055SJed Brown   PetscFunctionBegin;
299946139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
30009566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
300163a3b9bcSJacob 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);
3002b7f5c055SJed Brown   switch (tpstype) {
3003b7f5c055SJed Brown   case DMPLEX_TPS_SCHWARZ_P:
3004b7f5c055SJed 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");
3005c5853193SPierre Jolivet     if (rank == 0) {
3006b7f5c055SJed Brown       PetscInt(*cells)[6][4][4] = NULL; // [junction, junction-face, cell, conn]
3007b7f5c055SJed Brown       PetscInt  Njunctions = 0, Ncuts = 0, Npipes[3], vcount;
3008b7f5c055SJed Brown       PetscReal L = 1;
3009b7f5c055SJed Brown 
3010b7f5c055SJed Brown       Npipes[0]   = (extent[0] + 1) * extent[1] * extent[2];
3011b7f5c055SJed Brown       Npipes[1]   = extent[0] * (extent[1] + 1) * extent[2];
3012b7f5c055SJed Brown       Npipes[2]   = extent[0] * extent[1] * (extent[2] + 1);
3013b7f5c055SJed Brown       Njunctions  = extent[0] * extent[1] * extent[2];
3014b7f5c055SJed Brown       Ncuts       = 2 * (extent[0] * extent[1] + extent[1] * extent[2] + extent[2] * extent[0]);
3015b7f5c055SJed Brown       numVertices = 4 * (Npipes[0] + Npipes[1] + Npipes[2]) + 8 * Njunctions;
30169566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(3 * numVertices, &vtxCoords));
30179566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Njunctions, &cells));
30189566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Ncuts * 4, &edges));
30199566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Ncuts * 4, &edgeSets));
3020b7f5c055SJed Brown       // x-normal pipes
3021b7f5c055SJed Brown       vcount = 0;
3022b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0] + 1; i++) {
3023b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3024b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3025b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3026b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * i - 1) * L;
3027b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * j * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3028b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * k * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3029b7f5c055SJed Brown             }
3030b7f5c055SJed Brown           }
3031b7f5c055SJed Brown         }
3032b7f5c055SJed Brown       }
3033b7f5c055SJed Brown       // y-normal pipes
3034b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3035b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1] + 1; j++) {
3036b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3037b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3038b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * i * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3039b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * j - 1) * L;
3040b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * k * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3041b7f5c055SJed Brown             }
3042b7f5c055SJed Brown           }
3043b7f5c055SJed Brown         }
3044b7f5c055SJed Brown       }
3045b7f5c055SJed Brown       // z-normal pipes
3046b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3047b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3048b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2] + 1; k++) {
3049b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3050b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * i * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3051b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * j * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3052b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * k - 1) * L;
3053b7f5c055SJed Brown             }
3054b7f5c055SJed Brown           }
3055b7f5c055SJed Brown         }
3056b7f5c055SJed Brown       }
3057b7f5c055SJed Brown       // junctions
3058b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3059b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3060b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3061b7f5c055SJed Brown             const PetscInt J = (i * extent[1] + j) * extent[2] + k, Jvoff = (Npipes[0] + Npipes[1] + Npipes[2]) * 4 + J * 8;
3062b7f5c055SJed Brown             PetscCheck(vcount / 3 == Jvoff, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Unexpected vertex count");
3063b7f5c055SJed Brown             for (PetscInt ii = 0; ii < 2; ii++) {
3064b7f5c055SJed Brown               for (PetscInt jj = 0; jj < 2; jj++) {
3065b7f5c055SJed Brown                 for (PetscInt kk = 0; kk < 2; kk++) {
3066b7f5c055SJed Brown                   double Ls           = (1 - sqrt(2) / 4) * L;
3067b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * i * L + (2 * ii - 1) * Ls;
3068b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * j * L + (2 * jj - 1) * Ls;
3069b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * k * L + (2 * kk - 1) * Ls;
3070b7f5c055SJed Brown                 }
3071b7f5c055SJed Brown               }
3072b7f5c055SJed Brown             }
3073b7f5c055SJed Brown             const PetscInt jfaces[3][2][4] = {
3074b7f5c055SJed Brown               {{3, 1, 0, 2}, {7, 5, 4, 6}}, // x-aligned
3075b7f5c055SJed Brown               {{5, 4, 0, 1}, {7, 6, 2, 3}}, // y-aligned
3076b7f5c055SJed Brown               {{6, 2, 0, 4}, {7, 3, 1, 5}}  // z-aligned
3077b7f5c055SJed Brown             };
3078b7f5c055SJed Brown             const PetscInt pipe_lo[3] = {// vertex numbers of pipes
30799371c9d4SSatish 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};
3080b7f5c055SJed Brown             const PetscInt pipe_hi[3] = {// vertex numbers of pipes
30819371c9d4SSatish 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};
3082b7f5c055SJed Brown             for (PetscInt dir = 0; dir < 3; dir++) { // x,y,z
3083b7f5c055SJed Brown               const PetscInt ijk[3] = {i, j, k};
3084b7f5c055SJed Brown               for (PetscInt l = 0; l < 4; l++) { // rotations
3085b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][0] = pipe_lo[dir] + l;
3086b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][1] = Jvoff + jfaces[dir][0][l];
3087b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][2] = Jvoff + jfaces[dir][0][(l - 1 + 4) % 4];
3088b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][3] = pipe_lo[dir] + (l - 1 + 4) % 4;
3089b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][0] = Jvoff + jfaces[dir][1][l];
3090b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][1] = pipe_hi[dir] + l;
3091b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][2] = pipe_hi[dir] + (l - 1 + 4) % 4;
3092b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][3] = Jvoff + jfaces[dir][1][(l - 1 + 4) % 4];
3093b7f5c055SJed Brown                 if (ijk[dir] == 0) {
3094b7f5c055SJed Brown                   edges[numEdges][0] = pipe_lo[dir] + l;
3095b7f5c055SJed Brown                   edges[numEdges][1] = pipe_lo[dir] + (l + 1) % 4;
3096b7f5c055SJed Brown                   edgeSets[numEdges] = dir * 2 + 1;
3097b7f5c055SJed Brown                   numEdges++;
3098b7f5c055SJed Brown                 }
3099b7f5c055SJed Brown                 if (ijk[dir] + 1 == extent[dir]) {
3100b7f5c055SJed Brown                   edges[numEdges][0] = pipe_hi[dir] + l;
3101b7f5c055SJed Brown                   edges[numEdges][1] = pipe_hi[dir] + (l + 1) % 4;
3102b7f5c055SJed Brown                   edgeSets[numEdges] = dir * 2 + 2;
3103b7f5c055SJed Brown                   numEdges++;
3104b7f5c055SJed Brown                 }
3105b7f5c055SJed Brown               }
3106b7f5c055SJed Brown             }
3107b7f5c055SJed Brown           }
3108b7f5c055SJed Brown         }
3109b7f5c055SJed Brown       }
311063a3b9bcSJacob Faibussowitsch       PetscCheck(numEdges == Ncuts * 4, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Edge count %" PetscInt_FMT " incompatible with number of cuts %" PetscInt_FMT, numEdges, Ncuts);
3111b7f5c055SJed Brown       numFaces   = 24 * Njunctions;
3112b7f5c055SJed Brown       cells_flat = cells[0][0][0];
3113b7f5c055SJed Brown     }
3114b7f5c055SJed Brown     evalFunc   = TPSEvaluate_SchwarzP;
31154663dae6SJed Brown     normalFunc = TPSExtrudeNormalFunc_SchwarzP;
3116b7f5c055SJed Brown     break;
3117b7f5c055SJed Brown   case DMPLEX_TPS_GYROID:
3118c5853193SPierre Jolivet     if (rank == 0) {
3119b7f5c055SJed Brown       // This is a coarse mesh approximation of the gyroid shifted to being the zero of the level set
3120b7f5c055SJed Brown       //
3121b7f5c055SJed 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)
3122b7f5c055SJed Brown       //
3123b7f5c055SJed Brown       // on the cell [0,2]^3.
3124b7f5c055SJed Brown       //
3125b7f5c055SJed Brown       // Think about dividing that cell into four columns, and focus on the column [0,1]x[0,1]x[0,2].
3126b7f5c055SJed Brown       // If you looked at the gyroid in that column at different slices of z you would see that it kind of spins
3127b7f5c055SJed Brown       // like a boomerang:
3128b7f5c055SJed Brown       //
3129b7f5c055SJed Brown       //     z = 0          z = 1/4        z = 1/2        z = 3/4     //
3130b7f5c055SJed Brown       //     -----          -------        -------        -------     //
3131b7f5c055SJed Brown       //                                                              //
3132b7f5c055SJed Brown       //     +       +      +       +      +       +      +   \   +   //
3133b7f5c055SJed Brown       //      \                                   /            \      //
3134b7f5c055SJed Brown       //       \            `-_   _-'            /              }     //
3135b7f5c055SJed Brown       //        *-_            `-'            _-'              /      //
3136b7f5c055SJed Brown       //     +     `-+      +       +      +-'     +      +   /   +   //
3137b7f5c055SJed Brown       //                                                              //
3138b7f5c055SJed Brown       //                                                              //
3139b7f5c055SJed Brown       //     z = 1          z = 5/4        z = 3/2        z = 7/4     //
3140b7f5c055SJed Brown       //     -----          -------        -------        -------     //
3141b7f5c055SJed Brown       //                                                              //
3142b7f5c055SJed Brown       //     +-_     +      +       +      +     _-+      +   /   +   //
3143b7f5c055SJed Brown       //        `-_            _-_            _-`            /        //
3144b7f5c055SJed Brown       //           \        _-'   `-_        /              {         //
3145b7f5c055SJed Brown       //            \                       /                \        //
3146b7f5c055SJed Brown       //     +       +      +       +      +       +      +   \   +   //
3147b7f5c055SJed Brown       //
3148b7f5c055SJed Brown       //
3149b7f5c055SJed Brown       // This course mesh approximates each of these slices by two line segments,
3150b7f5c055SJed Brown       // and then connects the segments in consecutive layers with quadrilateral faces.
3151b7f5c055SJed Brown       // All of the end points of the segments are multiples of 1/4 except for the
3152b7f5c055SJed Brown       // point * in the picture for z = 0 above and the similar points in other layers.
3153b7f5c055SJed Brown       // That point is at (gamma, gamma, 0), where gamma is calculated below.
3154b7f5c055SJed Brown       //
3155b7f5c055SJed Brown       // The column  [1,2]x[1,2]x[0,2] looks the same as this column;
3156b7f5c055SJed Brown       // The columns [1,2]x[0,1]x[0,2] and [0,1]x[1,2]x[0,2] are mirror images.
3157b7f5c055SJed Brown       //
3158b7f5c055SJed Brown       // As for how this method turned into the names given to the vertices:
3159b7f5c055SJed Brown       // that was not systematic, it was just the way it worked out in my handwritten notes.
3160b7f5c055SJed Brown 
3161b7f5c055SJed Brown       PetscInt facesPerBlock = 64;
3162b7f5c055SJed Brown       PetscInt vertsPerBlock = 56;
3163b7f5c055SJed Brown       PetscInt extentPlus[3];
3164b7f5c055SJed Brown       PetscInt numBlocks, numBlocksPlus;
31659371c9d4SSatish 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;
31669371c9d4SSatish Balay       const PetscInt pattern[64][4] = {
31679371c9d4SSatish Balay   /* face to vertex within the coarse discretization of a single gyroid block */
3168b7f5c055SJed Brown   /* layer 0 */
31699371c9d4SSatish Balay         {A,           C,           K,           G          },
31709371c9d4SSatish Balay         {C,           B,           II,          K          },
31719371c9d4SSatish Balay         {D,           A,           H,           L          },
31729371c9d4SSatish Balay         {B + 56 * 1,  D,           L,           J          },
31739371c9d4SSatish Balay         {E,           B + 56 * 1,  J,           N          },
31749371c9d4SSatish Balay         {A + 56 * 2,  E,           N,           H + 56 * 2 },
31759371c9d4SSatish Balay         {F,           A + 56 * 2,  G + 56 * 2,  M          },
31769371c9d4SSatish Balay         {B,           F,           M,           II         },
3177b7f5c055SJed Brown  /* layer 1 */
31789371c9d4SSatish Balay         {G,           K,           Q,           O          },
31799371c9d4SSatish Balay         {K,           II,          P,           Q          },
31809371c9d4SSatish Balay         {L,           H,           O + 56 * 1,  R          },
31819371c9d4SSatish Balay         {J,           L,           R,           P          },
31829371c9d4SSatish Balay         {N,           J,           P,           S          },
31839371c9d4SSatish Balay         {H + 56 * 2,  N,           S,           O + 56 * 3 },
31849371c9d4SSatish Balay         {M,           G + 56 * 2,  O + 56 * 2,  T          },
31859371c9d4SSatish Balay         {II,          M,           T,           P          },
3186b7f5c055SJed Brown  /* layer 2 */
31879371c9d4SSatish Balay         {O,           Q,           Y,           U          },
31889371c9d4SSatish Balay         {Q,           P,           W,           Y          },
31899371c9d4SSatish Balay         {R,           O + 56 * 1,  U + 56 * 1,  Ap         },
31909371c9d4SSatish Balay         {P,           R,           Ap,          W          },
31919371c9d4SSatish Balay         {S,           P,           X,           Bp         },
31929371c9d4SSatish Balay         {O + 56 * 3,  S,           Bp,          V + 56 * 1 },
31939371c9d4SSatish Balay         {T,           O + 56 * 2,  V,           Z          },
31949371c9d4SSatish Balay         {P,           T,           Z,           X          },
3195b7f5c055SJed Brown  /* layer 3 */
31969371c9d4SSatish Balay         {U,           Y,           Ep,          Dp         },
31979371c9d4SSatish Balay         {Y,           W,           Cp,          Ep         },
31989371c9d4SSatish Balay         {Ap,          U + 56 * 1,  Dp + 56 * 1, Gp         },
31999371c9d4SSatish Balay         {W,           Ap,          Gp,          Cp         },
32009371c9d4SSatish Balay         {Bp,          X,           Cp + 56 * 2, Fp         },
32019371c9d4SSatish Balay         {V + 56 * 1,  Bp,          Fp,          Dp + 56 * 1},
32029371c9d4SSatish Balay         {Z,           V,           Dp,          Hp         },
32039371c9d4SSatish Balay         {X,           Z,           Hp,          Cp + 56 * 2},
3204b7f5c055SJed Brown  /* layer 4 */
32059371c9d4SSatish Balay         {Dp,          Ep,          Mp,          Kp         },
32069371c9d4SSatish Balay         {Ep,          Cp,          Ip,          Mp         },
32079371c9d4SSatish Balay         {Gp,          Dp + 56 * 1, Lp,          Np         },
32089371c9d4SSatish Balay         {Cp,          Gp,          Np,          Jp         },
32099371c9d4SSatish Balay         {Fp,          Cp + 56 * 2, Jp + 56 * 2, Pp         },
32109371c9d4SSatish Balay         {Dp + 56 * 1, Fp,          Pp,          Lp         },
32119371c9d4SSatish Balay         {Hp,          Dp,          Kp,          Op         },
32129371c9d4SSatish Balay         {Cp + 56 * 2, Hp,          Op,          Ip + 56 * 2},
3213b7f5c055SJed Brown  /* layer 5 */
32149371c9d4SSatish Balay         {Kp,          Mp,          Sp,          Rp         },
32159371c9d4SSatish Balay         {Mp,          Ip,          Qp,          Sp         },
32169371c9d4SSatish Balay         {Np,          Lp,          Rp,          Tp         },
32179371c9d4SSatish Balay         {Jp,          Np,          Tp,          Qp + 56 * 1},
32189371c9d4SSatish Balay         {Pp,          Jp + 56 * 2, Qp + 56 * 3, Up         },
32199371c9d4SSatish Balay         {Lp,          Pp,          Up,          Rp         },
32209371c9d4SSatish Balay         {Op,          Kp,          Rp,          Vp         },
32219371c9d4SSatish Balay         {Ip + 56 * 2, Op,          Vp,          Qp + 56 * 2},
3222b7f5c055SJed Brown  /* layer 6 */
32239371c9d4SSatish Balay         {Rp,          Sp,          Aq,          Yp         },
32249371c9d4SSatish Balay         {Sp,          Qp,          Wp,          Aq         },
32259371c9d4SSatish Balay         {Tp,          Rp,          Yp,          Cq         },
32269371c9d4SSatish Balay         {Qp + 56 * 1, Tp,          Cq,          Wp + 56 * 1},
32279371c9d4SSatish Balay         {Up,          Qp + 56 * 3, Xp + 56 * 1, Dq         },
32289371c9d4SSatish Balay         {Rp,          Up,          Dq,          Zp         },
32299371c9d4SSatish Balay         {Vp,          Rp,          Zp,          Bq         },
32309371c9d4SSatish Balay         {Qp + 56 * 2, Vp,          Bq,          Xp         },
3231b7f5c055SJed Brown  /* layer 7 (the top is the periodic image of the bottom of layer 0) */
32329371c9d4SSatish Balay         {Yp,          Aq,          C + 56 * 4,  A + 56 * 4 },
32339371c9d4SSatish Balay         {Aq,          Wp,          B + 56 * 4,  C + 56 * 4 },
32349371c9d4SSatish Balay         {Cq,          Yp,          A + 56 * 4,  D + 56 * 4 },
32359371c9d4SSatish Balay         {Wp + 56 * 1, Cq,          D + 56 * 4,  B + 56 * 5 },
32369371c9d4SSatish Balay         {Dq,          Xp + 56 * 1, B + 56 * 5,  E + 56 * 4 },
32379371c9d4SSatish Balay         {Zp,          Dq,          E + 56 * 4,  A + 56 * 6 },
32389371c9d4SSatish Balay         {Bq,          Zp,          A + 56 * 6,  F + 56 * 4 },
32399371c9d4SSatish Balay         {Xp,          Bq,          F + 56 * 4,  B + 56 * 4 }
3240b7f5c055SJed Brown       };
3241b7f5c055SJed Brown       const PetscReal gamma                = PetscAcosReal((PetscSqrtReal(3.) - 1.) / PetscSqrtReal(2.)) / PETSC_PI;
32429371c9d4SSatish Balay       const PetscReal patternCoords[56][3] = {
3243bee3fc89SBarry Smith         {1.,        0.,        0.  }, /* A  */
3244bee3fc89SBarry Smith         {0.,        1.,        0.  }, /* B  */
3245bee3fc89SBarry Smith         {gamma,     gamma,     0.  }, /* C  */
3246bee3fc89SBarry Smith         {1 + gamma, 1 - gamma, 0.  }, /* D  */
3247bee3fc89SBarry Smith         {2 - gamma, 2 - gamma, 0.  }, /* E  */
3248bee3fc89SBarry Smith         {1 - gamma, 1 + gamma, 0.  }, /* F  */
3249b7f5c055SJed Brown 
3250bee3fc89SBarry Smith         {.5,        0,         .25 }, /* G  */
3251bee3fc89SBarry Smith         {1.5,       0.,        .25 }, /* H  */
3252bee3fc89SBarry Smith         {.5,        1.,        .25 }, /* II */
3253bee3fc89SBarry Smith         {1.5,       1.,        .25 }, /* J  */
3254bee3fc89SBarry Smith         {.25,       .5,        .25 }, /* K  */
3255bee3fc89SBarry Smith         {1.25,      .5,        .25 }, /* L  */
3256bee3fc89SBarry Smith         {.75,       1.5,       .25 }, /* M  */
3257bee3fc89SBarry Smith         {1.75,      1.5,       .25 }, /* N  */
3258b7f5c055SJed Brown 
3259bee3fc89SBarry Smith         {0.,        0.,        .5  }, /* O  */
3260bee3fc89SBarry Smith         {1.,        1.,        .5  }, /* P  */
3261bee3fc89SBarry Smith         {gamma,     1 - gamma, .5  }, /* Q  */
3262bee3fc89SBarry Smith         {1 + gamma, gamma,     .5  }, /* R  */
3263bee3fc89SBarry Smith         {2 - gamma, 1 + gamma, .5  }, /* S  */
3264bee3fc89SBarry Smith         {1 - gamma, 2 - gamma, .5  }, /* T  */
3265b7f5c055SJed Brown 
3266bee3fc89SBarry Smith         {0.,        .5,        .75 }, /* U  */
3267bee3fc89SBarry Smith         {0.,        1.5,       .75 }, /* V  */
3268bee3fc89SBarry Smith         {1.,        .5,        .75 }, /* W  */
3269bee3fc89SBarry Smith         {1.,        1.5,       .75 }, /* X  */
3270bee3fc89SBarry Smith         {.5,        .75,       .75 }, /* Y  */
3271bee3fc89SBarry Smith         {.5,        1.75,      .75 }, /* Z  */
3272bee3fc89SBarry Smith         {1.5,       .25,       .75 }, /* Ap */
3273bee3fc89SBarry Smith         {1.5,       1.25,      .75 }, /* Bp */
3274b7f5c055SJed Brown 
3275bee3fc89SBarry Smith         {1.,        0.,        1.  }, /* Cp */
3276bee3fc89SBarry Smith         {0.,        1.,        1.  }, /* Dp */
3277bee3fc89SBarry Smith         {1 - gamma, 1 - gamma, 1.  }, /* Ep */
3278bee3fc89SBarry Smith         {1 + gamma, 1 + gamma, 1.  }, /* Fp */
3279bee3fc89SBarry Smith         {2 - gamma, gamma,     1.  }, /* Gp */
3280bee3fc89SBarry Smith         {gamma,     2 - gamma, 1.  }, /* Hp */
3281b7f5c055SJed Brown 
3282bee3fc89SBarry Smith         {.5,        0.,        1.25}, /* Ip */
3283bee3fc89SBarry Smith         {1.5,       0.,        1.25}, /* Jp */
3284bee3fc89SBarry Smith         {.5,        1.,        1.25}, /* Kp */
3285bee3fc89SBarry Smith         {1.5,       1.,        1.25}, /* Lp */
3286bee3fc89SBarry Smith         {.75,       .5,        1.25}, /* Mp */
3287bee3fc89SBarry Smith         {1.75,      .5,        1.25}, /* Np */
3288bee3fc89SBarry Smith         {.25,       1.5,       1.25}, /* Op */
3289bee3fc89SBarry Smith         {1.25,      1.5,       1.25}, /* Pp */
3290b7f5c055SJed Brown 
3291bee3fc89SBarry Smith         {0.,        0.,        1.5 }, /* Qp */
3292bee3fc89SBarry Smith         {1.,        1.,        1.5 }, /* Rp */
3293bee3fc89SBarry Smith         {1 - gamma, gamma,     1.5 }, /* Sp */
3294bee3fc89SBarry Smith         {2 - gamma, 1 - gamma, 1.5 }, /* Tp */
3295bee3fc89SBarry Smith         {1 + gamma, 2 - gamma, 1.5 }, /* Up */
3296bee3fc89SBarry Smith         {gamma,     1 + gamma, 1.5 }, /* Vp */
3297b7f5c055SJed Brown 
3298bee3fc89SBarry Smith         {0.,        .5,        1.75}, /* Wp */
3299bee3fc89SBarry Smith         {0.,        1.5,       1.75}, /* Xp */
3300bee3fc89SBarry Smith         {1.,        .5,        1.75}, /* Yp */
3301bee3fc89SBarry Smith         {1.,        1.5,       1.75}, /* Zp */
3302bee3fc89SBarry Smith         {.5,        .25,       1.75}, /* Aq */
3303bee3fc89SBarry Smith         {.5,        1.25,      1.75}, /* Bq */
3304bee3fc89SBarry Smith         {1.5,       .75,       1.75}, /* Cq */
3305bee3fc89SBarry Smith         {1.5,       1.75,      1.75}, /* Dq */
3306b7f5c055SJed Brown       };
3307b7f5c055SJed Brown       PetscInt(*cells)[64][4] = NULL;
3308b7f5c055SJed Brown       PetscBool *seen;
3309b7f5c055SJed Brown       PetscInt  *vertToTrueVert;
3310b7f5c055SJed Brown       PetscInt   count;
3311b7f5c055SJed Brown 
3312b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) extentPlus[i] = extent[i] + 1;
3313b7f5c055SJed Brown       numBlocks = 1;
3314b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) numBlocks *= extent[i];
3315b7f5c055SJed Brown       numBlocksPlus = 1;
3316b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) numBlocksPlus *= extentPlus[i];
3317b7f5c055SJed Brown       numFaces = numBlocks * facesPerBlock;
33189566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numBlocks, &cells));
33199566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numBlocksPlus * vertsPerBlock, &seen));
3320b7f5c055SJed Brown       for (PetscInt k = 0; k < extent[2]; k++) {
3321b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3322b7f5c055SJed Brown           for (PetscInt i = 0; i < extent[0]; i++) {
3323b7f5c055SJed Brown             for (PetscInt f = 0; f < facesPerBlock; f++) {
3324b7f5c055SJed Brown               for (PetscInt v = 0; v < 4; v++) {
3325b7f5c055SJed Brown                 PetscInt vertRaw     = pattern[f][v];
3326b7f5c055SJed Brown                 PetscInt blockidx    = vertRaw / 56;
3327b7f5c055SJed Brown                 PetscInt patternvert = vertRaw % 56;
3328b7f5c055SJed Brown                 PetscInt xplus       = (blockidx & 1);
3329b7f5c055SJed Brown                 PetscInt yplus       = (blockidx & 2) >> 1;
3330b7f5c055SJed Brown                 PetscInt zplus       = (blockidx & 4) >> 2;
3331b7f5c055SJed Brown                 PetscInt zcoord      = (periodic && periodic[2] == DM_BOUNDARY_PERIODIC) ? ((k + zplus) % extent[2]) : (k + zplus);
3332b7f5c055SJed Brown                 PetscInt ycoord      = (periodic && periodic[1] == DM_BOUNDARY_PERIODIC) ? ((j + yplus) % extent[1]) : (j + yplus);
3333b7f5c055SJed Brown                 PetscInt xcoord      = (periodic && periodic[0] == DM_BOUNDARY_PERIODIC) ? ((i + xplus) % extent[0]) : (i + xplus);
3334b7f5c055SJed Brown                 PetscInt vert        = ((zcoord * extentPlus[1] + ycoord) * extentPlus[0] + xcoord) * 56 + patternvert;
3335b7f5c055SJed Brown 
3336b7f5c055SJed Brown                 cells[(k * extent[1] + j) * extent[0] + i][f][v] = vert;
3337b7f5c055SJed Brown                 seen[vert]                                       = PETSC_TRUE;
3338b7f5c055SJed Brown               }
3339b7f5c055SJed Brown             }
3340b7f5c055SJed Brown           }
3341b7f5c055SJed Brown         }
3342b7f5c055SJed Brown       }
33439371c9d4SSatish Balay       for (PetscInt i = 0; i < numBlocksPlus * vertsPerBlock; i++)
33449371c9d4SSatish Balay         if (seen[i]) numVertices++;
3345b7f5c055SJed Brown       count = 0;
33469566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numBlocksPlus * vertsPerBlock, &vertToTrueVert));
33479566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numVertices * 3, &vtxCoords));
3348b7f5c055SJed Brown       for (PetscInt i = 0; i < numBlocksPlus * vertsPerBlock; i++) vertToTrueVert[i] = -1;
3349b7f5c055SJed Brown       for (PetscInt k = 0; k < extentPlus[2]; k++) {
3350b7f5c055SJed Brown         for (PetscInt j = 0; j < extentPlus[1]; j++) {
3351b7f5c055SJed Brown           for (PetscInt i = 0; i < extentPlus[0]; i++) {
3352b7f5c055SJed Brown             for (PetscInt v = 0; v < vertsPerBlock; v++) {
3353b7f5c055SJed Brown               PetscInt vIdx = ((k * extentPlus[1] + j) * extentPlus[0] + i) * vertsPerBlock + v;
3354b7f5c055SJed Brown 
3355b7f5c055SJed Brown               if (seen[vIdx]) {
3356b7f5c055SJed Brown                 PetscInt thisVert;
3357b7f5c055SJed Brown 
3358b7f5c055SJed Brown                 vertToTrueVert[vIdx] = thisVert = count++;
3359b7f5c055SJed Brown 
3360b7f5c055SJed Brown                 for (PetscInt d = 0; d < 3; d++) vtxCoords[3 * thisVert + d] = patternCoords[v][d];
3361b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 0] += i * 2;
3362b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 1] += j * 2;
3363b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 2] += k * 2;
3364b7f5c055SJed Brown               }
3365b7f5c055SJed Brown             }
3366b7f5c055SJed Brown           }
3367b7f5c055SJed Brown         }
3368b7f5c055SJed Brown       }
3369b7f5c055SJed Brown       for (PetscInt i = 0; i < numBlocks; i++) {
3370b7f5c055SJed Brown         for (PetscInt f = 0; f < facesPerBlock; f++) {
3371ad540459SPierre Jolivet           for (PetscInt v = 0; v < 4; v++) cells[i][f][v] = vertToTrueVert[cells[i][f][v]];
3372b7f5c055SJed Brown         }
3373b7f5c055SJed Brown       }
33749566063dSJacob Faibussowitsch       PetscCall(PetscFree(vertToTrueVert));
33759566063dSJacob Faibussowitsch       PetscCall(PetscFree(seen));
3376b7f5c055SJed Brown       cells_flat = cells[0][0];
3377b7f5c055SJed Brown       numEdges   = 0;
3378b7f5c055SJed Brown       for (PetscInt i = 0; i < numFaces; i++) {
3379b7f5c055SJed Brown         for (PetscInt e = 0; e < 4; e++) {
3380b7f5c055SJed Brown           PetscInt         ev[]       = {cells_flat[i * 4 + e], cells_flat[i * 4 + ((e + 1) % 4)]};
3381b7f5c055SJed Brown           const PetscReal *evCoords[] = {&vtxCoords[3 * ev[0]], &vtxCoords[3 * ev[1]]};
3382b7f5c055SJed Brown 
3383b7f5c055SJed Brown           for (PetscInt d = 0; d < 3; d++) {
3384b7f5c055SJed Brown             if (!periodic || periodic[0] != DM_BOUNDARY_PERIODIC) {
3385b7f5c055SJed Brown               if (evCoords[0][d] == 0. && evCoords[1][d] == 0.) numEdges++;
3386b7f5c055SJed Brown               if (evCoords[0][d] == 2. * extent[d] && evCoords[1][d] == 2. * extent[d]) numEdges++;
3387b7f5c055SJed Brown             }
3388b7f5c055SJed Brown           }
3389b7f5c055SJed Brown         }
3390b7f5c055SJed Brown       }
33919566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numEdges, &edges));
33929566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numEdges, &edgeSets));
3393b7f5c055SJed Brown       for (PetscInt edge = 0, i = 0; i < numFaces; i++) {
3394b7f5c055SJed Brown         for (PetscInt e = 0; e < 4; e++) {
3395b7f5c055SJed Brown           PetscInt         ev[]       = {cells_flat[i * 4 + e], cells_flat[i * 4 + ((e + 1) % 4)]};
3396b7f5c055SJed Brown           const PetscReal *evCoords[] = {&vtxCoords[3 * ev[0]], &vtxCoords[3 * ev[1]]};
3397b7f5c055SJed Brown 
3398b7f5c055SJed Brown           for (PetscInt d = 0; d < 3; d++) {
3399b7f5c055SJed Brown             if (!periodic || periodic[d] != DM_BOUNDARY_PERIODIC) {
3400b7f5c055SJed Brown               if (evCoords[0][d] == 0. && evCoords[1][d] == 0.) {
3401b7f5c055SJed Brown                 edges[edge][0]   = ev[0];
3402b7f5c055SJed Brown                 edges[edge][1]   = ev[1];
3403b7f5c055SJed Brown                 edgeSets[edge++] = 2 * d;
3404b7f5c055SJed Brown               }
3405b7f5c055SJed Brown               if (evCoords[0][d] == 2. * extent[d] && evCoords[1][d] == 2. * extent[d]) {
3406b7f5c055SJed Brown                 edges[edge][0]   = ev[0];
3407b7f5c055SJed Brown                 edges[edge][1]   = ev[1];
3408b7f5c055SJed Brown                 edgeSets[edge++] = 2 * d + 1;
3409b7f5c055SJed Brown               }
3410b7f5c055SJed Brown             }
3411b7f5c055SJed Brown           }
3412b7f5c055SJed Brown         }
3413b7f5c055SJed Brown       }
3414b7f5c055SJed Brown     }
3415b7f5c055SJed Brown     evalFunc   = TPSEvaluate_Gyroid;
34164663dae6SJed Brown     normalFunc = TPSExtrudeNormalFunc_Gyroid;
3417b7f5c055SJed Brown     break;
3418b7f5c055SJed Brown   }
3419b7f5c055SJed Brown 
34209566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, topoDim));
3421c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildFromCellList(dm, numFaces, numVertices, 4, cells_flat));
34229566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildFromCellList(dm, 0, 0, 0, NULL));
34239566063dSJacob Faibussowitsch   PetscCall(PetscFree(cells_flat));
3424b7f5c055SJed Brown   {
3425b7f5c055SJed Brown     DM idm;
34269566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(dm, &idm));
342769d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &idm));
3428b7f5c055SJed Brown   }
3429c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildCoordinatesFromCellList(dm, spaceDim, vtxCoords));
34309566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildCoordinatesFromCellList(dm, spaceDim, NULL));
34319566063dSJacob Faibussowitsch   PetscCall(PetscFree(vtxCoords));
3432b7f5c055SJed Brown 
34339566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "Face Sets"));
34349566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "Face Sets", &label));
3435b7f5c055SJed Brown   for (PetscInt e = 0; e < numEdges; e++) {
3436b7f5c055SJed Brown     PetscInt        njoin;
3437b7f5c055SJed Brown     const PetscInt *join, verts[] = {numFaces + edges[e][0], numFaces + edges[e][1]};
34389566063dSJacob Faibussowitsch     PetscCall(DMPlexGetJoin(dm, 2, verts, &njoin, &join));
343963a3b9bcSJacob 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]);
34409566063dSJacob Faibussowitsch     PetscCall(DMLabelSetValue(label, join[0], edgeSets[e]));
34419566063dSJacob Faibussowitsch     PetscCall(DMPlexRestoreJoin(dm, 2, verts, &njoin, &join));
3442b7f5c055SJed Brown   }
34439566063dSJacob Faibussowitsch   PetscCall(PetscFree(edges));
34449566063dSJacob Faibussowitsch   PetscCall(PetscFree(edgeSets));
34451436d7faSJed Brown   if (tps_distribute) {
34461436d7faSJed Brown     DM               pdm = NULL;
34471436d7faSJed Brown     PetscPartitioner part;
34481436d7faSJed Brown 
34499566063dSJacob Faibussowitsch     PetscCall(DMPlexGetPartitioner(dm, &part));
34509566063dSJacob Faibussowitsch     PetscCall(PetscPartitionerSetFromOptions(part));
34519566063dSJacob Faibussowitsch     PetscCall(DMPlexDistribute(dm, 0, NULL, &pdm));
345248a46eb9SPierre Jolivet     if (pdm) PetscCall(DMPlexReplace_Internal(dm, &pdm));
34531436d7faSJed Brown     // Do not auto-distribute again
34549566063dSJacob Faibussowitsch     PetscCall(DMPlexDistributeSetDefault(dm, PETSC_FALSE));
34551436d7faSJed Brown   }
3456b7f5c055SJed Brown 
34579566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
3458b7f5c055SJed Brown   for (PetscInt refine = 0; refine < refinements; refine++) {
3459b7f5c055SJed Brown     PetscInt     m;
3460b7f5c055SJed Brown     DM           dmf;
3461b7f5c055SJed Brown     Vec          X;
3462b7f5c055SJed Brown     PetscScalar *x;
34639566063dSJacob Faibussowitsch     PetscCall(DMRefine(dm, MPI_COMM_NULL, &dmf));
346469d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmf));
3465b7f5c055SJed Brown 
34669566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinatesLocal(dm, &X));
34679566063dSJacob Faibussowitsch     PetscCall(VecGetLocalSize(X, &m));
34689566063dSJacob Faibussowitsch     PetscCall(VecGetArray(X, &x));
346948a46eb9SPierre Jolivet     for (PetscInt i = 0; i < m; i += 3) PetscCall(TPSNearestPoint(evalFunc, &x[i]));
34709566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(X, &x));
3471b7f5c055SJed Brown   }
3472b7f5c055SJed Brown 
3473b7f5c055SJed Brown   // Face Sets has already been propagated to new vertices during refinement; this propagates to the initial vertices.
34749566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "Face Sets", &label));
34759566063dSJacob Faibussowitsch   PetscCall(DMPlexLabelComplete(dm, label));
3476b7f5c055SJed Brown 
347746139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
347846139095SJed Brown 
3479b7f5c055SJed Brown   if (thickness > 0) {
34804663dae6SJed Brown     DM              edm, cdm, ecdm;
34814663dae6SJed Brown     DMPlexTransform tr;
34824663dae6SJed Brown     const char     *prefix;
34834663dae6SJed Brown     PetscOptions    options;
34844663dae6SJed Brown     // Code from DMPlexExtrude
34854663dae6SJed Brown     PetscCall(DMPlexTransformCreate(PetscObjectComm((PetscObject)dm), &tr));
34864663dae6SJed Brown     PetscCall(DMPlexTransformSetDM(tr, dm));
34874663dae6SJed Brown     PetscCall(DMPlexTransformSetType(tr, DMPLEXEXTRUDE));
34884663dae6SJed Brown     PetscCall(PetscObjectGetOptionsPrefix((PetscObject)dm, &prefix));
34894663dae6SJed Brown     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)tr, prefix));
34904663dae6SJed Brown     PetscCall(PetscObjectGetOptions((PetscObject)dm, &options));
34914663dae6SJed Brown     PetscCall(PetscObjectSetOptions((PetscObject)tr, options));
34924663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetLayers(tr, layers));
34934663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetThickness(tr, thickness));
34944663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetTensor(tr, PETSC_FALSE));
34954663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetSymmetric(tr, PETSC_TRUE));
34964663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetNormalFunction(tr, normalFunc));
34974663dae6SJed Brown     PetscCall(DMPlexTransformSetFromOptions(tr));
34984663dae6SJed Brown     PetscCall(PetscObjectSetOptions((PetscObject)tr, NULL));
34994663dae6SJed Brown     PetscCall(DMPlexTransformSetUp(tr));
35004663dae6SJed Brown     PetscCall(PetscObjectViewFromOptions((PetscObject)tr, NULL, "-dm_plex_tps_transform_view"));
35014663dae6SJed Brown     PetscCall(DMPlexTransformApply(tr, dm, &edm));
35024663dae6SJed Brown     PetscCall(DMCopyDisc(dm, edm));
35034663dae6SJed Brown     PetscCall(DMGetCoordinateDM(dm, &cdm));
35044663dae6SJed Brown     PetscCall(DMGetCoordinateDM(edm, &ecdm));
35054663dae6SJed Brown     PetscCall(DMCopyDisc(cdm, ecdm));
35064663dae6SJed Brown     PetscCall(DMPlexTransformCreateDiscLabels(tr, edm));
35074663dae6SJed Brown     PetscCall(DMPlexTransformDestroy(&tr));
35084663dae6SJed Brown     if (edm) {
35094663dae6SJed Brown       ((DM_Plex *)edm->data)->printFEM    = ((DM_Plex *)dm->data)->printFEM;
35104663dae6SJed Brown       ((DM_Plex *)edm->data)->printL2     = ((DM_Plex *)dm->data)->printL2;
3511f5867de0SMatthew G. Knepley       ((DM_Plex *)edm->data)->printLocate = ((DM_Plex *)dm->data)->printLocate;
35124663dae6SJed Brown     }
351369d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &edm));
3514b7f5c055SJed Brown   }
35153ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3516b7f5c055SJed Brown }
3517b7f5c055SJed Brown 
3518b7f5c055SJed Brown /*@
3519b7f5c055SJed Brown   DMPlexCreateTPSMesh - Create a distributed, interpolated mesh of a triply-periodic surface
3520b7f5c055SJed Brown 
3521b7f5c055SJed Brown   Collective
3522b7f5c055SJed Brown 
3523b7f5c055SJed Brown   Input Parameters:
3524a1cb98faSBarry Smith + comm           - The communicator for the `DM` object
3525b7f5c055SJed Brown . tpstype        - Type of triply-periodic surface
3526b7f5c055SJed Brown . extent         - Array of length 3 containing number of periods in each direction
352720f4b53cSBarry Smith . periodic       - array of length 3 with periodicity, or `NULL` for non-periodic
35281436d7faSJed Brown . tps_distribute - Distribute 2D manifold mesh prior to refinement and extrusion (more scalable)
3529817da375SSatish Balay . refinements    - Number of factor-of-2 refinements of 2D manifold mesh
35301436d7faSJed Brown . layers         - Number of cell layers extruded in normal direction
3531817da375SSatish Balay - thickness      - Thickness in normal direction
3532b7f5c055SJed Brown 
3533b7f5c055SJed Brown   Output Parameter:
3534a1cb98faSBarry Smith . dm - The `DM` object
3535a1cb98faSBarry Smith 
3536a1cb98faSBarry Smith   Level: beginner
3537b7f5c055SJed Brown 
3538b7f5c055SJed Brown   Notes:
3539b7f5c055SJed 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.
3540b7f5c055SJed Brown   https://en.wikipedia.org/wiki/Schwarz_minimal_surface#Schwarz_P_(%22Primitive%22) and can be cut with "clean" boundaries.
3541b7f5c055SJed 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.
3542b7f5c055SJed Brown   Our implementation creates a very coarse mesh of the surface and refines (by 4-way splitting) as many times as requested.
3543b7f5c055SJed Brown   On each refinement, all vertices are projected to their nearest point on the surface.
3544b7f5c055SJed Brown   This projection could readily be extended to related surfaces.
3545b7f5c055SJed Brown 
3546b7f5c055SJed Brown   The face (edge) sets for the Schwarz P surface are numbered 1(-x), 2(+x), 3(-y), 4(+y), 5(-z), 6(+z).
354720f4b53cSBarry Smith   When the mesh is refined, "Face Sets" contain the new vertices (created during refinement).  Use `DMPlexLabelComplete()` to propagate to coarse-level vertices.
3548b7f5c055SJed Brown 
354960225df5SJacob Faibussowitsch   Developer Notes:
3550b7f5c055SJed Brown   The Gyroid mesh does not currently mark boundary sets.
3551b7f5c055SJed Brown 
3552a1cb98faSBarry Smith   References:
3553a1cb98faSBarry Smith . * - Maskery et al, Insights into the mechanical properties of several triply periodic minimal surface lattice structures made by polymer additive manufacturing, 2017.
3554a1cb98faSBarry Smith   https://doi.org/10.1016/j.polymer.2017.11.049
3555b7f5c055SJed Brown 
35561cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateSphereMesh()`, `DMSetType()`, `DMCreate()`
3557b7f5c055SJed Brown @*/
3558d71ae5a4SJacob 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)
3559d71ae5a4SJacob Faibussowitsch {
3560b7f5c055SJed Brown   PetscFunctionBegin;
35619566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
35629566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
35639566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateTPSMesh_Internal(*dm, tpstype, extent, periodic, tps_distribute, refinements, layers, thickness));
35643ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3565b7f5c055SJed Brown }
3566b7f5c055SJed Brown 
35679318fe57SMatthew G. Knepley /*@
35689318fe57SMatthew G. Knepley   DMPlexCreateSphereMesh - Creates a mesh on the d-dimensional sphere, S^d.
35699318fe57SMatthew G. Knepley 
35709318fe57SMatthew G. Knepley   Collective
35719318fe57SMatthew G. Knepley 
35729318fe57SMatthew G. Knepley   Input Parameters:
3573a1cb98faSBarry Smith + comm    - The communicator for the `DM` object
35749318fe57SMatthew G. Knepley . dim     - The dimension
35759318fe57SMatthew G. Knepley . simplex - Use simplices, or tensor product cells
35769318fe57SMatthew G. Knepley - R       - The radius
35779318fe57SMatthew G. Knepley 
35789318fe57SMatthew G. Knepley   Output Parameter:
3579a1cb98faSBarry Smith . dm - The `DM` object
35809318fe57SMatthew G. Knepley 
35819318fe57SMatthew G. Knepley   Level: beginner
35829318fe57SMatthew G. Knepley 
35831cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBallMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
35849318fe57SMatthew G. Knepley @*/
3585d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateSphereMesh(MPI_Comm comm, PetscInt dim, PetscBool simplex, PetscReal R, DM *dm)
3586d71ae5a4SJacob Faibussowitsch {
35879318fe57SMatthew G. Knepley   PetscFunctionBegin;
35884f572ea9SToby Isaac   PetscAssertPointer(dm, 5);
35899566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
35909566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
35919566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateSphereMesh_Internal(*dm, dim, simplex, R));
35923ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
35939318fe57SMatthew G. Knepley }
35949318fe57SMatthew G. Knepley 
3595d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBallMesh_Internal(DM dm, PetscInt dim, PetscReal R)
3596d71ae5a4SJacob Faibussowitsch {
35979318fe57SMatthew G. Knepley   DM      sdm, vol;
35989318fe57SMatthew G. Knepley   DMLabel bdlabel;
35999318fe57SMatthew G. Knepley 
36009318fe57SMatthew G. Knepley   PetscFunctionBegin;
36019566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &sdm));
36029566063dSJacob Faibussowitsch   PetscCall(DMSetType(sdm, DMPLEX));
36039566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)sdm, "bd_"));
36049566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateSphereMesh_Internal(sdm, dim - 1, PETSC_TRUE, R));
36059566063dSJacob Faibussowitsch   PetscCall(DMSetFromOptions(sdm));
36069566063dSJacob Faibussowitsch   PetscCall(DMViewFromOptions(sdm, NULL, "-dm_view"));
36079566063dSJacob Faibussowitsch   PetscCall(DMPlexGenerate(sdm, NULL, PETSC_TRUE, &vol));
36089566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&sdm));
360969d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
36109566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "marker"));
36119566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "marker", &bdlabel));
36129566063dSJacob Faibussowitsch   PetscCall(DMPlexMarkBoundaryFaces(dm, PETSC_DETERMINE, bdlabel));
36139566063dSJacob Faibussowitsch   PetscCall(DMPlexLabelComplete(dm, bdlabel));
36143ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
361551a74b61SMatthew G. Knepley }
361651a74b61SMatthew G. Knepley 
361751a74b61SMatthew G. Knepley /*@
361851a74b61SMatthew G. Knepley   DMPlexCreateBallMesh - Creates a simplex mesh on the d-dimensional ball, B^d.
361951a74b61SMatthew G. Knepley 
362051a74b61SMatthew G. Knepley   Collective
362151a74b61SMatthew G. Knepley 
362251a74b61SMatthew G. Knepley   Input Parameters:
3623a1cb98faSBarry Smith + comm - The communicator for the `DM` object
362451a74b61SMatthew G. Knepley . dim  - The dimension
362551a74b61SMatthew G. Knepley - R    - The radius
362651a74b61SMatthew G. Knepley 
362751a74b61SMatthew G. Knepley   Output Parameter:
3628a1cb98faSBarry Smith . dm - The `DM` object
362951a74b61SMatthew G. Knepley 
3630a1cb98faSBarry Smith   Options Database Key:
363160225df5SJacob Faibussowitsch . bd_dm_refine - This will refine the surface mesh preserving the sphere geometry
363251a74b61SMatthew G. Knepley 
363351a74b61SMatthew G. Knepley   Level: beginner
363451a74b61SMatthew G. Knepley 
36351cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateSphereMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
363651a74b61SMatthew G. Knepley @*/
3637d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateBallMesh(MPI_Comm comm, PetscInt dim, PetscReal R, DM *dm)
3638d71ae5a4SJacob Faibussowitsch {
363951a74b61SMatthew G. Knepley   PetscFunctionBegin;
36409566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
36419566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
36429566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBallMesh_Internal(*dm, dim, R));
36433ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
36442829fed8SMatthew G. Knepley }
36452829fed8SMatthew G. Knepley 
3646d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateReferenceCell_Internal(DM rdm, DMPolytopeType ct)
3647d71ae5a4SJacob Faibussowitsch {
36480a6ba040SMatthew G. Knepley   PetscFunctionBegin;
36499318fe57SMatthew G. Knepley   switch (ct) {
36509371c9d4SSatish Balay   case DM_POLYTOPE_POINT: {
36519318fe57SMatthew G. Knepley     PetscInt    numPoints[1]        = {1};
36529318fe57SMatthew G. Knepley     PetscInt    coneSize[1]         = {0};
36539318fe57SMatthew G. Knepley     PetscInt    cones[1]            = {0};
36549318fe57SMatthew G. Knepley     PetscInt    coneOrientations[1] = {0};
36559318fe57SMatthew G. Knepley     PetscScalar vertexCoords[1]     = {0.0};
36569318fe57SMatthew G. Knepley 
36579566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 0));
36589566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 0, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36599371c9d4SSatish Balay   } break;
36609371c9d4SSatish Balay   case DM_POLYTOPE_SEGMENT: {
36619318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {2, 1};
36629318fe57SMatthew G. Knepley     PetscInt    coneSize[3]         = {2, 0, 0};
36639318fe57SMatthew G. Knepley     PetscInt    cones[2]            = {1, 2};
36649318fe57SMatthew G. Knepley     PetscInt    coneOrientations[2] = {0, 0};
36659318fe57SMatthew G. Knepley     PetscScalar vertexCoords[2]     = {-1.0, 1.0};
36669318fe57SMatthew G. Knepley 
36679566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 1));
36689566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36699371c9d4SSatish Balay   } break;
36709371c9d4SSatish Balay   case DM_POLYTOPE_POINT_PRISM_TENSOR: {
3671b5a892a1SMatthew G. Knepley     PetscInt    numPoints[2]        = {2, 1};
3672b5a892a1SMatthew G. Knepley     PetscInt    coneSize[3]         = {2, 0, 0};
3673b5a892a1SMatthew G. Knepley     PetscInt    cones[2]            = {1, 2};
3674b5a892a1SMatthew G. Knepley     PetscInt    coneOrientations[2] = {0, 0};
3675b5a892a1SMatthew G. Knepley     PetscScalar vertexCoords[2]     = {-1.0, 1.0};
3676b5a892a1SMatthew G. Knepley 
36779566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 1));
36789566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36799371c9d4SSatish Balay   } break;
36809371c9d4SSatish Balay   case DM_POLYTOPE_TRIANGLE: {
36819318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {3, 1};
36829318fe57SMatthew G. Knepley     PetscInt    coneSize[4]         = {3, 0, 0, 0};
36839318fe57SMatthew G. Knepley     PetscInt    cones[3]            = {1, 2, 3};
36849318fe57SMatthew G. Knepley     PetscInt    coneOrientations[3] = {0, 0, 0};
36859318fe57SMatthew G. Knepley     PetscScalar vertexCoords[6]     = {-1.0, -1.0, 1.0, -1.0, -1.0, 1.0};
36869318fe57SMatthew G. Knepley 
36879566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
36889566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36899371c9d4SSatish Balay   } break;
36909371c9d4SSatish Balay   case DM_POLYTOPE_QUADRILATERAL: {
36919318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
36929318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
36939318fe57SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
36949318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
36959318fe57SMatthew G. Knepley     PetscScalar vertexCoords[8]     = {-1.0, -1.0, 1.0, -1.0, 1.0, 1.0, -1.0, 1.0};
36969318fe57SMatthew G. Knepley 
36979566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
36989566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36999371c9d4SSatish Balay   } break;
37009371c9d4SSatish Balay   case DM_POLYTOPE_SEG_PRISM_TENSOR: {
37019318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
37029318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
37039318fe57SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
37049318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
37059318fe57SMatthew G. Knepley     PetscScalar vertexCoords[8]     = {-1.0, -1.0, 1.0, -1.0, -1.0, 1.0, 1.0, 1.0};
37069318fe57SMatthew G. Knepley 
37079566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
37089566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37099371c9d4SSatish Balay   } break;
37109371c9d4SSatish Balay   case DM_POLYTOPE_TETRAHEDRON: {
37119318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
37129318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
3713f0edb160SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
37149318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
3715f0edb160SMatthew 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};
37169318fe57SMatthew G. Knepley 
37179566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37189566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37199371c9d4SSatish Balay   } break;
37209371c9d4SSatish Balay   case DM_POLYTOPE_HEXAHEDRON: {
37219318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {8, 1};
37229318fe57SMatthew G. Knepley     PetscInt    coneSize[9]         = {8, 0, 0, 0, 0, 0, 0, 0, 0};
3723f0edb160SMatthew G. Knepley     PetscInt    cones[8]            = {1, 2, 3, 4, 5, 6, 7, 8};
37249318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
37259371c9d4SSatish 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};
37269318fe57SMatthew G. Knepley 
37279566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37289566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37299371c9d4SSatish Balay   } break;
37309371c9d4SSatish Balay   case DM_POLYTOPE_TRI_PRISM: {
37319318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {6, 1};
37329318fe57SMatthew G. Knepley     PetscInt    coneSize[7]         = {6, 0, 0, 0, 0, 0, 0};
3733f0edb160SMatthew G. Knepley     PetscInt    cones[6]            = {1, 2, 3, 4, 5, 6};
37349318fe57SMatthew G. Knepley     PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
37359371c9d4SSatish 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};
37369318fe57SMatthew G. Knepley 
37379566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37389566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37399371c9d4SSatish Balay   } break;
37409371c9d4SSatish Balay   case DM_POLYTOPE_TRI_PRISM_TENSOR: {
37419318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {6, 1};
37429318fe57SMatthew G. Knepley     PetscInt    coneSize[7]         = {6, 0, 0, 0, 0, 0, 0};
37439318fe57SMatthew G. Knepley     PetscInt    cones[6]            = {1, 2, 3, 4, 5, 6};
37449318fe57SMatthew G. Knepley     PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
37459371c9d4SSatish 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};
37469318fe57SMatthew G. Knepley 
37479566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37489566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37499371c9d4SSatish Balay   } break;
37509371c9d4SSatish Balay   case DM_POLYTOPE_QUAD_PRISM_TENSOR: {
37519318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {8, 1};
37529318fe57SMatthew G. Knepley     PetscInt    coneSize[9]         = {8, 0, 0, 0, 0, 0, 0, 0, 0};
37539318fe57SMatthew G. Knepley     PetscInt    cones[8]            = {1, 2, 3, 4, 5, 6, 7, 8};
37549318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
37559371c9d4SSatish 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};
37569318fe57SMatthew G. Knepley 
37579566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37589566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37599371c9d4SSatish Balay   } break;
37609371c9d4SSatish Balay   case DM_POLYTOPE_PYRAMID: {
37619318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {5, 1};
37629318fe57SMatthew G. Knepley     PetscInt    coneSize[6]         = {5, 0, 0, 0, 0, 0};
3763f0edb160SMatthew G. Knepley     PetscInt    cones[5]            = {1, 2, 3, 4, 5};
37649318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
37659371c9d4SSatish 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};
37669318fe57SMatthew G. Knepley 
37679566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37689566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37699371c9d4SSatish Balay   } break;
3770d71ae5a4SJacob Faibussowitsch   default:
3771d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)rdm), PETSC_ERR_ARG_WRONG, "Cannot create reference cell for cell type %s", DMPolytopeTypes[ct]);
37729318fe57SMatthew G. Knepley   }
37739318fe57SMatthew G. Knepley   {
37749318fe57SMatthew G. Knepley     PetscInt Nv, v;
37759318fe57SMatthew G. Knepley 
37769318fe57SMatthew G. Knepley     /* Must create the celltype label here so that we do not automatically try to compute the types */
37779566063dSJacob Faibussowitsch     PetscCall(DMCreateLabel(rdm, "celltype"));
37789566063dSJacob Faibussowitsch     PetscCall(DMPlexSetCellType(rdm, 0, ct));
37799566063dSJacob Faibussowitsch     PetscCall(DMPlexGetChart(rdm, NULL, &Nv));
37809566063dSJacob Faibussowitsch     for (v = 1; v < Nv; ++v) PetscCall(DMPlexSetCellType(rdm, v, DM_POLYTOPE_POINT));
37819318fe57SMatthew G. Knepley   }
37829566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolateInPlace_Internal(rdm));
37839566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)rdm, DMPolytopeTypes[ct]));
37843ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
37850a6ba040SMatthew G. Knepley }
37860a6ba040SMatthew G. Knepley 
37879318fe57SMatthew G. Knepley /*@
3788a1cb98faSBarry Smith   DMPlexCreateReferenceCell - Create a `DMPLEX` with the appropriate FEM reference cell
37899318fe57SMatthew G. Knepley 
37909318fe57SMatthew G. Knepley   Collective
37919318fe57SMatthew G. Knepley 
37929318fe57SMatthew G. Knepley   Input Parameters:
37939318fe57SMatthew G. Knepley + comm - The communicator
37949318fe57SMatthew G. Knepley - ct   - The cell type of the reference cell
37959318fe57SMatthew G. Knepley 
37969318fe57SMatthew G. Knepley   Output Parameter:
37979318fe57SMatthew G. Knepley . refdm - The reference cell
37989318fe57SMatthew G. Knepley 
37999318fe57SMatthew G. Knepley   Level: intermediate
38009318fe57SMatthew G. Knepley 
380142747ad1SJacob Faibussowitsch .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBoxMesh()`
38029318fe57SMatthew G. Knepley @*/
3803d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateReferenceCell(MPI_Comm comm, DMPolytopeType ct, DM *refdm)
3804d71ae5a4SJacob Faibussowitsch {
38050a6ba040SMatthew G. Knepley   PetscFunctionBegin;
38069566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, refdm));
38079566063dSJacob Faibussowitsch   PetscCall(DMSetType(*refdm, DMPLEX));
38089566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateReferenceCell_Internal(*refdm, ct));
38093ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
38109318fe57SMatthew G. Knepley }
381179a015ccSMatthew G. Knepley 
3812d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoundaryLabel_Private(DM dm, const char name[])
3813d71ae5a4SJacob Faibussowitsch {
38149318fe57SMatthew G. Knepley   DM        plex;
38159318fe57SMatthew G. Knepley   DMLabel   label;
38169318fe57SMatthew G. Knepley   PetscBool hasLabel;
38170a6ba040SMatthew G. Knepley 
3818c22d3578SMatthew G. Knepley   PetscFunctionBegin;
38199566063dSJacob Faibussowitsch   PetscCall(DMHasLabel(dm, name, &hasLabel));
38203ba16761SJacob Faibussowitsch   if (hasLabel) PetscFunctionReturn(PETSC_SUCCESS);
38219566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, name));
38229566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, name, &label));
38239566063dSJacob Faibussowitsch   PetscCall(DMConvert(dm, DMPLEX, &plex));
38249566063dSJacob Faibussowitsch   PetscCall(DMPlexMarkBoundaryFaces(plex, 1, label));
38251c8afea9SMatthew G. Knepley   PetscCall(DMPlexLabelComplete(plex, label));
38269566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&plex));
38273ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
38289318fe57SMatthew G. Knepley }
3829acdc6f61SToby Isaac 
3830669647acSMatthew G. Knepley /*
3831669647acSMatthew 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.
3832669647acSMatthew G. Knepley 
3833669647acSMatthew G. Knepley     (x, y) -> (r, theta) = (x[1], (x[0] - lower[0]) * 2\pi/(upper[0] - lower[0]))
3834669647acSMatthew G. Knepley */
3835d71ae5a4SJacob 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[])
3836d71ae5a4SJacob Faibussowitsch {
3837669647acSMatthew G. Knepley   const PetscReal low = PetscRealPart(constants[0]);
3838669647acSMatthew G. Knepley   const PetscReal upp = PetscRealPart(constants[1]);
3839669647acSMatthew G. Knepley   const PetscReal r   = PetscRealPart(u[1]);
3840669647acSMatthew G. Knepley   const PetscReal th  = 2. * PETSC_PI * (PetscRealPart(u[0]) - low) / (upp - low);
3841669647acSMatthew G. Knepley 
3842669647acSMatthew G. Knepley   f0[0] = r * PetscCosReal(th);
3843669647acSMatthew G. Knepley   f0[1] = r * PetscSinReal(th);
3844669647acSMatthew G. Knepley }
3845669647acSMatthew G. Knepley 
38465dca41c3SJed Brown const char *const DMPlexShapes[] = {"box", "box_surface", "ball", "sphere", "cylinder", "schwarz_p", "gyroid", "doublet", "annulus", "hypercubic", "zbox", "unknown", "DMPlexShape", "DM_SHAPE_", NULL};
38479318fe57SMatthew G. Knepley 
3848d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateFromOptions_Internal(PetscOptionItems *PetscOptionsObject, PetscBool *useCoordSpace, DM dm)
3849d71ae5a4SJacob Faibussowitsch {
38509318fe57SMatthew G. Knepley   DMPlexShape    shape   = DM_SHAPE_BOX;
38519318fe57SMatthew G. Knepley   DMPolytopeType cell    = DM_POLYTOPE_TRIANGLE;
38529318fe57SMatthew G. Knepley   PetscInt       dim     = 2;
38539318fe57SMatthew G. Knepley   PetscBool      simplex = PETSC_TRUE, interpolate = PETSC_TRUE, adjCone = PETSC_FALSE, adjClosure = PETSC_TRUE, refDomain = PETSC_FALSE;
3854cd7e8a5eSksagiyam   PetscBool      flg, flg2, fflg, bdfflg, nameflg;
38559318fe57SMatthew G. Knepley   MPI_Comm       comm;
3856ed5e4e85SVaclav Hapla   char           filename[PETSC_MAX_PATH_LEN]   = "<unspecified>";
3857ed5e4e85SVaclav Hapla   char           bdFilename[PETSC_MAX_PATH_LEN] = "<unspecified>";
3858ed5e4e85SVaclav Hapla   char           plexname[PETSC_MAX_PATH_LEN]   = "";
38599318fe57SMatthew G. Knepley 
38609318fe57SMatthew G. Knepley   PetscFunctionBegin;
3861708be2fdSJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_CreateFromOptions, dm, 0, 0, 0));
38629566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)dm, &comm));
38639318fe57SMatthew G. Knepley   /* TODO Turn this into a registration interface */
38649566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_filename", "File containing a mesh", "DMPlexCreateFromFile", filename, filename, sizeof(filename), &fflg));
38659566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_boundary_filename", "File containing a mesh boundary", "DMPlexCreateFromFile", bdFilename, bdFilename, sizeof(bdFilename), &bdfflg));
38669566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_name", "Name of the mesh in the file", "DMPlexCreateFromFile", plexname, plexname, sizeof(plexname), &nameflg));
38679566063dSJacob Faibussowitsch   PetscCall(PetscOptionsEnum("-dm_plex_cell", "Cell shape", "", DMPolytopeTypes, (PetscEnum)cell, (PetscEnum *)&cell, NULL));
38689566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_reference_cell_domain", "Use a reference cell domain", "", refDomain, &refDomain, NULL));
38699566063dSJacob Faibussowitsch   PetscCall(PetscOptionsEnum("-dm_plex_shape", "Shape for built-in mesh", "", DMPlexShapes, (PetscEnum)shape, (PetscEnum *)&shape, &flg));
38709566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_plex_dim", "Topological dimension of the mesh", "DMGetDimension", dim, &dim, &flg, 0));
3871cfb853baSMatthew G. Knepley   PetscCheck(dim >= 0, comm, PETSC_ERR_ARG_OUTOFRANGE, "Dimension %" PetscInt_FMT " should be in [0, infinity)", dim);
38729566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_simplex", "Mesh cell shape", "", simplex, &simplex, &flg));
38739566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_interpolate", "Flag to create edges and faces automatically", "", interpolate, &interpolate, &flg));
38749566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_adj_cone", "Set adjacency direction", "DMSetBasicAdjacency", adjCone, &adjCone, &flg));
38759566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_adj_closure", "Set adjacency size", "DMSetBasicAdjacency", adjClosure, &adjClosure, &flg2));
38769566063dSJacob Faibussowitsch   if (flg || flg2) PetscCall(DMSetBasicAdjacency(dm, adjCone, adjClosure));
38779318fe57SMatthew G. Knepley 
387861a622f3SMatthew G. Knepley   switch (cell) {
387961a622f3SMatthew G. Knepley   case DM_POLYTOPE_POINT:
388061a622f3SMatthew G. Knepley   case DM_POLYTOPE_SEGMENT:
388161a622f3SMatthew G. Knepley   case DM_POLYTOPE_POINT_PRISM_TENSOR:
388261a622f3SMatthew G. Knepley   case DM_POLYTOPE_TRIANGLE:
388361a622f3SMatthew G. Knepley   case DM_POLYTOPE_QUADRILATERAL:
388461a622f3SMatthew G. Knepley   case DM_POLYTOPE_TETRAHEDRON:
3885d71ae5a4SJacob Faibussowitsch   case DM_POLYTOPE_HEXAHEDRON:
3886d71ae5a4SJacob Faibussowitsch     *useCoordSpace = PETSC_TRUE;
3887d71ae5a4SJacob Faibussowitsch     break;
3888d71ae5a4SJacob Faibussowitsch   default:
3889d71ae5a4SJacob Faibussowitsch     *useCoordSpace = PETSC_FALSE;
3890d71ae5a4SJacob Faibussowitsch     break;
389161a622f3SMatthew G. Knepley   }
389261a622f3SMatthew G. Knepley 
38939318fe57SMatthew G. Knepley   if (fflg) {
38949318fe57SMatthew G. Knepley     DM dmnew;
38959318fe57SMatthew G. Knepley 
38969566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromFile(PetscObjectComm((PetscObject)dm), filename, plexname, interpolate, &dmnew));
38975de52c6dSVaclav Hapla     PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
389869d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmnew));
38999318fe57SMatthew G. Knepley   } else if (refDomain) {
39009566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateReferenceCell_Internal(dm, cell));
39019318fe57SMatthew G. Knepley   } else if (bdfflg) {
39029318fe57SMatthew G. Knepley     DM bdm, dmnew;
39039318fe57SMatthew G. Knepley 
39049566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromFile(PetscObjectComm((PetscObject)dm), bdFilename, plexname, interpolate, &bdm));
39059566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)bdm, "bd_"));
39069566063dSJacob Faibussowitsch     PetscCall(DMSetFromOptions(bdm));
39079566063dSJacob Faibussowitsch     PetscCall(DMPlexGenerate(bdm, NULL, interpolate, &dmnew));
39089566063dSJacob Faibussowitsch     PetscCall(DMDestroy(&bdm));
39095de52c6dSVaclav Hapla     PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
391069d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmnew));
39119318fe57SMatthew G. Knepley   } else {
39129566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)dm, DMPlexShapes[shape]));
39139318fe57SMatthew G. Knepley     switch (shape) {
3914669647acSMatthew G. Knepley     case DM_SHAPE_BOX:
39155dca41c3SJed Brown     case DM_SHAPE_ZBOX:
3916669647acSMatthew G. Knepley     case DM_SHAPE_ANNULUS: {
39179318fe57SMatthew G. Knepley       PetscInt       faces[3]  = {0, 0, 0};
39189318fe57SMatthew G. Knepley       PetscReal      lower[3]  = {0, 0, 0};
39199318fe57SMatthew G. Knepley       PetscReal      upper[3]  = {1, 1, 1};
39209318fe57SMatthew G. Knepley       DMBoundaryType bdt[3]    = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
3921669647acSMatthew G. Knepley       PetscBool      isAnnular = shape == DM_SHAPE_ANNULUS ? PETSC_TRUE : PETSC_FALSE;
39229318fe57SMatthew G. Knepley       PetscInt       i, n;
39239318fe57SMatthew G. Knepley 
39249318fe57SMatthew G. Knepley       n = dim;
39259318fe57SMatthew G. Knepley       for (i = 0; i < dim; ++i) faces[i] = (dim == 1 ? 1 : 4 - dim);
39269566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", faces, &n, &flg));
39279318fe57SMatthew G. Knepley       n = 3;
39289566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
392963a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Lower box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
39309318fe57SMatthew G. Knepley       n = 3;
39319566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
393263a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Upper box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
39339318fe57SMatthew G. Knepley       n = 3;
39349566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnumArray("-dm_plex_box_bd", "Boundary type for each dimension", "", DMBoundaryTypes, (PetscEnum *)bdt, &n, &flg));
393563a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Box boundary types had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
3936669647acSMatthew G. Knepley 
3937669647acSMatthew G. Knepley       PetscCheck(!isAnnular || dim == 2, comm, PETSC_ERR_ARG_OUTOFRANGE, "Only two dimensional annuli have been implemented");
3938669647acSMatthew G. Knepley       if (isAnnular)
3939669647acSMatthew G. Knepley         for (i = 0; i < dim - 1; ++i) bdt[i] = DM_BOUNDARY_PERIODIC;
3940669647acSMatthew G. Knepley 
39419318fe57SMatthew G. Knepley       switch (cell) {
394261a622f3SMatthew G. Knepley       case DM_POLYTOPE_TRI_PRISM_TENSOR:
39439566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateWedgeBoxMesh_Internal(dm, faces, lower, upper, bdt));
3944d410b0cfSMatthew G. Knepley         if (!interpolate) {
3945d410b0cfSMatthew G. Knepley           DM udm;
3946d410b0cfSMatthew G. Knepley 
39479566063dSJacob Faibussowitsch           PetscCall(DMPlexUninterpolate(dm, &udm));
394869d8a87bSksagiyam           PetscCall(DMPlexReplace_Internal(dm, &udm));
3949d410b0cfSMatthew G. Knepley         }
39509318fe57SMatthew G. Knepley         break;
3951d71ae5a4SJacob Faibussowitsch       default:
39525dca41c3SJed Brown         PetscCall(DMPlexCreateBoxMesh_Internal(dm, shape, dim, simplex, faces, lower, upper, bdt, interpolate));
3953d71ae5a4SJacob Faibussowitsch         break;
39549318fe57SMatthew G. Knepley       }
3955669647acSMatthew G. Knepley       if (isAnnular) {
3956669647acSMatthew G. Knepley         DM          cdm;
3957669647acSMatthew G. Knepley         PetscDS     cds;
3958669647acSMatthew G. Knepley         PetscScalar bounds[2] = {lower[0], upper[0]};
3959669647acSMatthew G. Knepley 
3960669647acSMatthew G. Knepley         // Fix coordinates for annular region
3961669647acSMatthew G. Knepley         PetscCall(DMSetPeriodicity(dm, NULL, NULL, NULL));
3962669647acSMatthew G. Knepley         PetscCall(DMSetCellCoordinatesLocal(dm, NULL));
3963669647acSMatthew G. Knepley         PetscCall(DMSetCellCoordinates(dm, NULL));
3964e44f6aebSMatthew G. Knepley         PetscCall(DMPlexCreateCoordinateSpace(dm, 1, PETSC_TRUE, NULL));
3965669647acSMatthew G. Knepley         PetscCall(DMGetCoordinateDM(dm, &cdm));
3966669647acSMatthew G. Knepley         PetscCall(DMGetDS(cdm, &cds));
3967669647acSMatthew G. Knepley         PetscCall(PetscDSSetConstants(cds, 2, bounds));
3968669647acSMatthew G. Knepley         PetscCall(DMPlexRemapGeometry(dm, 0.0, boxToAnnulus));
3969669647acSMatthew G. Knepley       }
39709371c9d4SSatish Balay     } break;
39719371c9d4SSatish Balay     case DM_SHAPE_BOX_SURFACE: {
39729318fe57SMatthew G. Knepley       PetscInt  faces[3] = {0, 0, 0};
39739318fe57SMatthew G. Knepley       PetscReal lower[3] = {0, 0, 0};
39749318fe57SMatthew G. Knepley       PetscReal upper[3] = {1, 1, 1};
39759318fe57SMatthew G. Knepley       PetscInt  i, n;
39769318fe57SMatthew G. Knepley 
39779318fe57SMatthew G. Knepley       n = dim + 1;
39789318fe57SMatthew G. Knepley       for (i = 0; i < dim + 1; ++i) faces[i] = (dim + 1 == 1 ? 1 : 4 - (dim + 1));
39799566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", faces, &n, &flg));
39809318fe57SMatthew G. Knepley       n = 3;
39819566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
398263a3b9bcSJacob 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);
39839318fe57SMatthew G. Knepley       n = 3;
39849566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
398563a3b9bcSJacob 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);
39869566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateBoxSurfaceMesh_Internal(dm, dim + 1, faces, lower, upper, interpolate));
39879371c9d4SSatish Balay     } break;
39889371c9d4SSatish Balay     case DM_SHAPE_SPHERE: {
39899318fe57SMatthew G. Knepley       PetscReal R = 1.0;
39909318fe57SMatthew G. Knepley 
39919566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_sphere_radius", "Radius of the sphere", "", R, &R, &flg));
39929566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateSphereMesh_Internal(dm, dim, simplex, R));
39939371c9d4SSatish Balay     } break;
39949371c9d4SSatish Balay     case DM_SHAPE_BALL: {
39959318fe57SMatthew G. Knepley       PetscReal R = 1.0;
39969318fe57SMatthew G. Knepley 
39979566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_ball_radius", "Radius of the ball", "", R, &R, &flg));
39989566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateBallMesh_Internal(dm, dim, R));
39999371c9d4SSatish Balay     } break;
40009371c9d4SSatish Balay     case DM_SHAPE_CYLINDER: {
40019318fe57SMatthew G. Knepley       DMBoundaryType bdt = DM_BOUNDARY_NONE;
40029318fe57SMatthew G. Knepley       PetscInt       Nw  = 6;
40039318fe57SMatthew G. Knepley 
40049566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnum("-dm_plex_cylinder_bd", "Boundary type in the z direction", "", DMBoundaryTypes, (PetscEnum)bdt, (PetscEnum *)&bdt, NULL));
40059566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_cylinder_num_wedges", "Number of wedges around the cylinder", "", Nw, &Nw, NULL));
40069318fe57SMatthew G. Knepley       switch (cell) {
4007d71ae5a4SJacob Faibussowitsch       case DM_POLYTOPE_TRI_PRISM_TENSOR:
4008d71ae5a4SJacob Faibussowitsch         PetscCall(DMPlexCreateWedgeCylinderMesh_Internal(dm, Nw, interpolate));
4009d71ae5a4SJacob Faibussowitsch         break;
4010d71ae5a4SJacob Faibussowitsch       default:
4011d71ae5a4SJacob Faibussowitsch         PetscCall(DMPlexCreateHexCylinderMesh_Internal(dm, bdt));
4012d71ae5a4SJacob Faibussowitsch         break;
40139318fe57SMatthew G. Knepley       }
40149371c9d4SSatish Balay     } break;
4015b7f5c055SJed Brown     case DM_SHAPE_SCHWARZ_P: // fallthrough
40169371c9d4SSatish Balay     case DM_SHAPE_GYROID: {
4017b7f5c055SJed Brown       PetscInt       extent[3] = {1, 1, 1}, refine = 0, layers = 0, three;
4018b7f5c055SJed Brown       PetscReal      thickness   = 0.;
4019b7f5c055SJed Brown       DMBoundaryType periodic[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
4020b7f5c055SJed Brown       DMPlexTPSType  tps_type    = shape == DM_SHAPE_SCHWARZ_P ? DMPLEX_TPS_SCHWARZ_P : DMPLEX_TPS_GYROID;
40211436d7faSJed Brown       PetscBool      tps_distribute;
40229566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_tps_extent", "Number of replicas for each of three dimensions", NULL, extent, (three = 3, &three), NULL));
40239566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_tps_refine", "Number of refinements", NULL, refine, &refine, NULL));
40249566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnumArray("-dm_plex_tps_periodic", "Periodicity in each of three dimensions", NULL, DMBoundaryTypes, (PetscEnum *)periodic, (three = 3, &three), NULL));
40259566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_tps_layers", "Number of layers in volumetric extrusion (or zero to not extrude)", NULL, layers, &layers, NULL));
40269566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_tps_thickness", "Thickness of volumetric extrusion", NULL, thickness, &thickness, NULL));
40279566063dSJacob Faibussowitsch       PetscCall(DMPlexDistributeGetDefault(dm, &tps_distribute));
40289566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_tps_distribute", "Distribute the 2D mesh prior to refinement and extrusion", NULL, tps_distribute, &tps_distribute, NULL));
40299566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateTPSMesh_Internal(dm, tps_type, extent, periodic, tps_distribute, refine, layers, thickness));
40309371c9d4SSatish Balay     } break;
40319371c9d4SSatish Balay     case DM_SHAPE_DOUBLET: {
403205bd46c0SStefano Zampini       DM        dmnew;
403305bd46c0SStefano Zampini       PetscReal rl = 0.0;
403405bd46c0SStefano Zampini 
403505bd46c0SStefano Zampini       PetscCall(PetscOptionsReal("-dm_plex_doublet_refinementlimit", "Refinement limit", NULL, rl, &rl, NULL));
403605bd46c0SStefano Zampini       PetscCall(DMPlexCreateDoublet(PetscObjectComm((PetscObject)dm), dim, simplex, interpolate, rl, &dmnew));
40375de52c6dSVaclav Hapla       PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
403869d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &dmnew));
40399371c9d4SSatish Balay     } break;
4040cfb853baSMatthew G. Knepley     case DM_SHAPE_HYPERCUBIC: {
4041cfb853baSMatthew G. Knepley       PetscInt       *edges;
4042cfb853baSMatthew G. Knepley       PetscReal      *lower, *upper;
4043cfb853baSMatthew G. Knepley       DMBoundaryType *bdt;
4044cfb853baSMatthew G. Knepley       PetscInt        n, d;
4045cfb853baSMatthew G. Knepley 
4046cfb853baSMatthew G. Knepley       *useCoordSpace = PETSC_FALSE;
4047cfb853baSMatthew G. Knepley       PetscCall(PetscMalloc4(dim, &edges, dim, &lower, dim, &upper, dim, &bdt));
4048cfb853baSMatthew G. Knepley       for (d = 0; d < dim; ++d) {
4049cfb853baSMatthew G. Knepley         edges[d] = 1;
4050cfb853baSMatthew G. Knepley         lower[d] = 0.;
4051cfb853baSMatthew G. Knepley         upper[d] = 1.;
4052cfb853baSMatthew G. Knepley         bdt[d]   = DM_BOUNDARY_PERIODIC;
4053cfb853baSMatthew G. Knepley       }
4054cfb853baSMatthew G. Knepley       n = dim;
4055cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", edges, &n, &flg));
4056cfb853baSMatthew G. Knepley       n = dim;
4057cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
4058cfb853baSMatthew 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);
4059cfb853baSMatthew G. Knepley       n = dim;
4060cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
4061cfb853baSMatthew 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);
4062cfb853baSMatthew G. Knepley       n = dim;
4063cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsEnumArray("-dm_plex_box_bd", "Boundary type for each dimension", "", DMBoundaryTypes, (PetscEnum *)bdt, &n, &flg));
4064cfb853baSMatthew 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);
4065cfb853baSMatthew G. Knepley       PetscCall(DMPlexCreateHypercubicMesh_Internal(dm, dim, lower, upper, edges, bdt));
4066cfb853baSMatthew G. Knepley       PetscCall(PetscFree4(edges, lower, upper, bdt));
4067cfb853baSMatthew G. Knepley     } break;
4068d71ae5a4SJacob Faibussowitsch     default:
4069d71ae5a4SJacob Faibussowitsch       SETERRQ(comm, PETSC_ERR_SUP, "Domain shape %s is unsupported", DMPlexShapes[shape]);
40709318fe57SMatthew G. Knepley     }
40719318fe57SMatthew G. Knepley   }
40729566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
407348a46eb9SPierre Jolivet   if (!((PetscObject)dm)->name && nameflg) PetscCall(PetscObjectSetName((PetscObject)dm, plexname));
4074708be2fdSJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_CreateFromOptions, dm, 0, 0, 0));
40753ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
40760a6ba040SMatthew G. Knepley }
40770a6ba040SMatthew G. Knepley 
4078d71ae5a4SJacob Faibussowitsch PetscErrorCode DMSetFromOptions_NonRefinement_Plex(DM dm, PetscOptionItems *PetscOptionsObject)
4079d71ae5a4SJacob Faibussowitsch {
40800a6ba040SMatthew G. Knepley   DM_Plex  *mesh = (DM_Plex *)dm->data;
40817f9d8d6cSVaclav Hapla   PetscBool flg, flg2;
40829318fe57SMatthew G. Knepley   char      bdLabel[PETSC_MAX_PATH_LEN];
40830a6ba040SMatthew G. Knepley 
40840a6ba040SMatthew G. Knepley   PetscFunctionBegin;
40850a6ba040SMatthew G. Knepley   /* Handle viewing */
40869566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_print_set_values", "Output all set values info", "DMPlexMatSetClosure", PETSC_FALSE, &mesh->printSetValues, NULL));
40875962854dSMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_fem", "Debug output level for all fem computations", "DMPlexSNESComputeResidualFEM", 0, &mesh->printFEM, NULL, 0));
40885962854dSMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_fvm", "Debug output level for all fvm computations", "DMPlexSNESComputeResidualFVM", 0, &mesh->printFVM, NULL, 0));
40899566063dSJacob Faibussowitsch   PetscCall(PetscOptionsReal("-dm_plex_print_tol", "Tolerance for FEM output", "DMPlexSNESComputeResidualFEM", mesh->printTol, &mesh->printTol, NULL));
40909566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_l2", "Debug output level all L2 diff computations", "DMComputeL2Diff", 0, &mesh->printL2, NULL, 0));
4091f5867de0SMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_locate", "Debug output level all point location computations", "DMLocatePoints", 0, &mesh->printLocate, NULL, 0));
40929566063dSJacob Faibussowitsch   PetscCall(DMMonitorSetFromOptions(dm, "-dm_plex_monitor_throughput", "Monitor the simulation throughput", "DMPlexMonitorThroughput", DMPlexMonitorThroughput, NULL, &flg));
40939566063dSJacob Faibussowitsch   if (flg) PetscCall(PetscLogDefaultBegin());
40949318fe57SMatthew G. Knepley   /* Labeling */
40959566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_boundary_label", "Label to mark the mesh boundary", "", bdLabel, bdLabel, sizeof(bdLabel), &flg));
40969566063dSJacob Faibussowitsch   if (flg) PetscCall(DMPlexCreateBoundaryLabel_Private(dm, bdLabel));
4097953fc75cSMatthew G. Knepley   /* Point Location */
40989566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_hash_location", "Use grid hashing for point location", "DMInterpolate", PETSC_FALSE, &mesh->useHashLocation, NULL));
40990848f4b5SMatthew G. Knepley   /* Partitioning and distribution */
41009566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_partition_balance", "Attempt to evenly divide points on partition boundary between processes", "DMPlexSetPartitionBalance", PETSC_FALSE, &mesh->partitionBalance, NULL));
41012e62ab5aSMatthew G. Knepley   /* Generation and remeshing */
41029566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_remesh_bd", "Allow changes to the boundary on remeshing", "DMAdapt", PETSC_FALSE, &mesh->remeshBd, NULL));
4103b29cfa1cSToby Isaac   /* Projection behavior */
4104d5b43468SJose E. Roman   PetscCall(PetscOptionsBoundedInt("-dm_plex_max_projection_height", "Maximum mesh point height used to project locally", "DMPlexSetMaxProjectionHeight", 0, &mesh->maxProjectionHeight, NULL, 0));
41059566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_regular_refinement", "Use special nested projection algorithm for regular refinement", "DMPlexSetRegularRefinement", mesh->regularRefinement, &mesh->regularRefinement, NULL));
4106f12cf164SMatthew G. Knepley   /* Checking structure */
4107f12cf164SMatthew G. Knepley   {
41087f9d8d6cSVaclav Hapla     PetscBool all = PETSC_FALSE;
4109f12cf164SMatthew G. Knepley 
41107f9d8d6cSVaclav Hapla     PetscCall(PetscOptionsBool("-dm_plex_check_all", "Perform all basic checks", "DMPlexCheck", PETSC_FALSE, &all, NULL));
41117f9d8d6cSVaclav Hapla     if (all) {
41127f9d8d6cSVaclav Hapla       PetscCall(DMPlexCheck(dm));
41137f9d8d6cSVaclav Hapla     } else {
41149566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_symmetry", "Check that the adjacency information in the mesh is symmetric", "DMPlexCheckSymmetry", PETSC_FALSE, &flg, &flg2));
41157f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckSymmetry(dm));
41169566063dSJacob 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));
41177f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckSkeleton(dm, 0));
41189566063dSJacob 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));
41197f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckFaces(dm, 0));
41209566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_geometry", "Check that cells have positive volume", "DMPlexCheckGeometry", PETSC_FALSE, &flg, &flg2));
41217f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckGeometry(dm));
41229566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_pointsf", "Check some necessary conditions for PointSF", "DMPlexCheckPointSF", PETSC_FALSE, &flg, &flg2));
4123d7d32a9aSMatthew G. Knepley       if (flg && flg2) PetscCall(DMPlexCheckPointSF(dm, NULL, PETSC_FALSE));
41249566063dSJacob 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));
41257f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckInterfaceCones(dm));
41267f9d8d6cSVaclav Hapla     }
41279566063dSJacob Faibussowitsch     PetscCall(PetscOptionsBool("-dm_plex_check_cell_shape", "Check cell shape", "DMPlexCheckCellShape", PETSC_FALSE, &flg, &flg2));
41289566063dSJacob Faibussowitsch     if (flg && flg2) PetscCall(DMPlexCheckCellShape(dm, PETSC_TRUE, PETSC_DETERMINE));
4129f12cf164SMatthew G. Knepley   }
41309318fe57SMatthew G. Knepley   {
41319318fe57SMatthew G. Knepley     PetscReal scale = 1.0;
41324f3833eaSMatthew G. Knepley 
41339566063dSJacob Faibussowitsch     PetscCall(PetscOptionsReal("-dm_plex_scale", "Scale factor for mesh coordinates", "DMPlexScale", scale, &scale, &flg));
41349318fe57SMatthew G. Knepley     if (flg) {
41359318fe57SMatthew G. Knepley       Vec coordinates, coordinatesLocal;
41369318fe57SMatthew G. Knepley 
41379566063dSJacob Faibussowitsch       PetscCall(DMGetCoordinates(dm, &coordinates));
41389566063dSJacob Faibussowitsch       PetscCall(DMGetCoordinatesLocal(dm, &coordinatesLocal));
41399566063dSJacob Faibussowitsch       PetscCall(VecScale(coordinates, scale));
41409566063dSJacob Faibussowitsch       PetscCall(VecScale(coordinatesLocal, scale));
41419318fe57SMatthew G. Knepley     }
41429318fe57SMatthew G. Knepley   }
41439566063dSJacob Faibussowitsch   PetscCall(PetscPartitionerSetFromOptions(mesh->partitioner));
41443ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
414568d4fef7SMatthew G. Knepley }
414668d4fef7SMatthew G. Knepley 
4147d71ae5a4SJacob Faibussowitsch PetscErrorCode DMSetFromOptions_Overlap_Plex(DM dm, PetscOptionItems *PetscOptionsObject, PetscInt *overlap)
4148d71ae5a4SJacob Faibussowitsch {
4149c506a872SMatthew G. Knepley   PetscInt  numOvLabels = 16, numOvExLabels = 16;
4150c506a872SMatthew G. Knepley   char     *ovLabelNames[16], *ovExLabelNames[16];
4151c506a872SMatthew G. Knepley   PetscInt  numOvValues = 16, numOvExValues = 16, l;
4152c506a872SMatthew G. Knepley   PetscBool flg;
4153c506a872SMatthew G. Knepley 
4154c506a872SMatthew G. Knepley   PetscFunctionBegin;
4155c506a872SMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_distribute_overlap", "The size of the overlap halo", "DMPlexDistribute", *overlap, overlap, NULL, 0));
4156c506a872SMatthew G. Knepley   PetscCall(PetscOptionsStringArray("-dm_distribute_overlap_labels", "List of overlap label names", "DMPlexDistribute", ovLabelNames, &numOvLabels, &flg));
4157c506a872SMatthew G. Knepley   if (!flg) numOvLabels = 0;
4158c506a872SMatthew G. Knepley   if (numOvLabels) {
4159c506a872SMatthew G. Knepley     ((DM_Plex *)dm->data)->numOvLabels = numOvLabels;
4160c506a872SMatthew G. Knepley     for (l = 0; l < numOvLabels; ++l) {
4161c506a872SMatthew G. Knepley       PetscCall(DMGetLabel(dm, ovLabelNames[l], &((DM_Plex *)dm->data)->ovLabels[l]));
4162c506a872SMatthew G. Knepley       PetscCheck(((DM_Plex *)dm->data)->ovLabels[l], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid label name %s", ovLabelNames[l]);
4163c506a872SMatthew G. Knepley       PetscCall(PetscFree(ovLabelNames[l]));
4164c506a872SMatthew G. Knepley     }
4165c506a872SMatthew G. Knepley     PetscCall(PetscOptionsIntArray("-dm_distribute_overlap_values", "List of overlap label values", "DMPlexDistribute", ((DM_Plex *)dm->data)->ovValues, &numOvValues, &flg));
4166c506a872SMatthew G. Knepley     if (!flg) numOvValues = 0;
4167c506a872SMatthew 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);
4168c506a872SMatthew G. Knepley 
4169c506a872SMatthew G. Knepley     PetscCall(PetscOptionsStringArray("-dm_distribute_overlap_exclude_labels", "List of overlap exclude label names", "DMPlexDistribute", ovExLabelNames, &numOvExLabels, &flg));
4170c506a872SMatthew G. Knepley     if (!flg) numOvExLabels = 0;
4171c506a872SMatthew G. Knepley     ((DM_Plex *)dm->data)->numOvExLabels = numOvExLabels;
4172c506a872SMatthew G. Knepley     for (l = 0; l < numOvExLabels; ++l) {
4173c506a872SMatthew G. Knepley       PetscCall(DMGetLabel(dm, ovExLabelNames[l], &((DM_Plex *)dm->data)->ovExLabels[l]));
4174c506a872SMatthew G. Knepley       PetscCheck(((DM_Plex *)dm->data)->ovExLabels[l], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid label name %s", ovExLabelNames[l]);
4175c506a872SMatthew G. Knepley       PetscCall(PetscFree(ovExLabelNames[l]));
4176c506a872SMatthew G. Knepley     }
4177c506a872SMatthew G. Knepley     PetscCall(PetscOptionsIntArray("-dm_distribute_overlap_exclude_values", "List of overlap exclude label values", "DMPlexDistribute", ((DM_Plex *)dm->data)->ovExValues, &numOvExValues, &flg));
4178c506a872SMatthew G. Knepley     if (!flg) numOvExValues = 0;
4179c506a872SMatthew 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);
4180c506a872SMatthew G. Knepley   }
41813ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4182c506a872SMatthew G. Knepley }
4183c506a872SMatthew G. Knepley 
4184d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMSetFromOptions_Plex(DM dm, PetscOptionItems *PetscOptionsObject)
4185d71ae5a4SJacob Faibussowitsch {
4186bdf63967SMatthew G. Knepley   PetscFunctionList        ordlist;
4187bdf63967SMatthew G. Knepley   char                     oname[256];
4188a286e215SMatthew G. Knepley   DMPlexReorderDefaultFlag reorder;
4189d410b0cfSMatthew G. Knepley   PetscReal                volume    = -1.0;
41909318fe57SMatthew G. Knepley   PetscInt                 prerefine = 0, refine = 0, r, coarsen = 0, overlap = 0, extLayers = 0, dim;
4191a286e215SMatthew G. Knepley   PetscBool uniformOrig = PETSC_FALSE, created = PETSC_FALSE, uniform = PETSC_TRUE, distribute, saveSF = PETSC_FALSE, interpolate = PETSC_TRUE, coordSpace = PETSC_TRUE, remap = PETSC_TRUE, ghostCells = PETSC_FALSE, isHierarchy, ignoreModel = PETSC_FALSE, flg;
419268d4fef7SMatthew G. Knepley 
419368d4fef7SMatthew G. Knepley   PetscFunctionBegin;
4194d0609cedSBarry Smith   PetscOptionsHeadBegin(PetscOptionsObject, "DMPlex Options");
4195dd4c3f67SMatthew G. Knepley   if (dm->cloneOpts) goto non_refine;
41969318fe57SMatthew G. Knepley   /* Handle automatic creation */
41979566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
41986bc1bd01Sksagiyam   if (dim < 0) {
41996bc1bd01Sksagiyam     PetscCall(DMPlexCreateFromOptions_Internal(PetscOptionsObject, &coordSpace, dm));
42006bc1bd01Sksagiyam     created = PETSC_TRUE;
42016bc1bd01Sksagiyam   }
42026bc1bd01Sksagiyam   PetscCall(DMGetDimension(dm, &dim));
4203d89e6e46SMatthew G. Knepley   /* Handle interpolation before distribution */
42049566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_interpolate_pre", "Flag to interpolate mesh before distribution", "", interpolate, &interpolate, &flg));
4205d89e6e46SMatthew G. Knepley   if (flg) {
4206d89e6e46SMatthew G. Knepley     DMPlexInterpolatedFlag interpolated;
4207d89e6e46SMatthew G. Knepley 
42089566063dSJacob Faibussowitsch     PetscCall(DMPlexIsInterpolated(dm, &interpolated));
4209d89e6e46SMatthew G. Knepley     if (interpolated == DMPLEX_INTERPOLATED_FULL && !interpolate) {
4210d89e6e46SMatthew G. Knepley       DM udm;
4211d89e6e46SMatthew G. Knepley 
42129566063dSJacob Faibussowitsch       PetscCall(DMPlexUninterpolate(dm, &udm));
421369d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &udm));
4214d89e6e46SMatthew G. Knepley     } else if (interpolated != DMPLEX_INTERPOLATED_FULL && interpolate) {
4215d89e6e46SMatthew G. Knepley       DM idm;
4216d89e6e46SMatthew G. Knepley 
42179566063dSJacob Faibussowitsch       PetscCall(DMPlexInterpolate(dm, &idm));
421869d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &idm));
4219d89e6e46SMatthew G. Knepley     }
4220d89e6e46SMatthew G. Knepley   }
42219b44eab4SMatthew G. Knepley   /* Handle DMPlex refinement before distribution */
42229566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_ignore_model", "Flag to ignore the geometry model when refining", "DMCreate", ignoreModel, &ignoreModel, &flg));
4223ad540459SPierre Jolivet   if (flg) ((DM_Plex *)dm->data)->ignoreModel = ignoreModel;
42249566063dSJacob Faibussowitsch   PetscCall(DMPlexGetRefinementUniform(dm, &uniformOrig));
42259566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine_pre", "The number of refinements before distribution", "DMCreate", prerefine, &prerefine, NULL, 0));
42269566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_remap_pre", "Flag to control coordinate remapping", "DMCreate", remap, &remap, NULL));
42279566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_uniform_pre", "Flag for uniform refinement before distribution", "DMCreate", uniform, &uniform, &flg));
42289566063dSJacob Faibussowitsch   if (flg) PetscCall(DMPlexSetRefinementUniform(dm, uniform));
42299566063dSJacob Faibussowitsch   PetscCall(PetscOptionsReal("-dm_refine_volume_limit_pre", "The maximum cell volume after refinement before distribution", "DMCreate", volume, &volume, &flg));
42309318fe57SMatthew G. Knepley   if (flg) {
42319566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementUniform(dm, PETSC_FALSE));
42329566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementLimit(dm, volume));
42339318fe57SMatthew G. Knepley     prerefine = PetscMax(prerefine, 1);
42349318fe57SMatthew G. Knepley   }
42359b44eab4SMatthew G. Knepley   for (r = 0; r < prerefine; ++r) {
42369b44eab4SMatthew G. Knepley     DM             rdm;
42379b44eab4SMatthew G. Knepley     PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
42389b44eab4SMatthew G. Knepley 
4239dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
42409566063dSJacob Faibussowitsch     PetscCall(DMRefine(dm, PetscObjectComm((PetscObject)dm), &rdm));
424169d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &rdm));
4242dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
424361a622f3SMatthew G. Knepley     if (coordFunc && remap) {
42449566063dSJacob Faibussowitsch       PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
42459b44eab4SMatthew G. Knepley       ((DM_Plex *)dm->data)->coordFunc = coordFunc;
42469b44eab4SMatthew G. Knepley     }
42479b44eab4SMatthew G. Knepley   }
42489566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, uniformOrig));
42499318fe57SMatthew G. Knepley   /* Handle DMPlex extrusion before distribution */
42509566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_extrude", "The number of layers to extrude", "", extLayers, &extLayers, NULL, 0));
42519318fe57SMatthew G. Knepley   if (extLayers) {
42529318fe57SMatthew G. Knepley     DM edm;
42539318fe57SMatthew G. Knepley 
42549566063dSJacob Faibussowitsch     PetscCall(DMExtrude(dm, extLayers, &edm));
425569d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &edm));
425648d16a33SMatthew G. Knepley     ((DM_Plex *)dm->data)->coordFunc = NULL;
4257dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4258d410b0cfSMatthew G. Knepley     extLayers = 0;
42595e17fc22SAidan Hamilton     PetscCall(DMGetDimension(dm, &dim));
42609318fe57SMatthew G. Knepley   }
4261bdf63967SMatthew G. Knepley   /* Handle DMPlex reordering before distribution */
42626bc1bd01Sksagiyam   PetscCall(DMPlexReorderGetDefault(dm, &reorder));
42639566063dSJacob Faibussowitsch   PetscCall(MatGetOrderingList(&ordlist));
42646bc1bd01Sksagiyam   PetscCall(PetscStrncpy(oname, MATORDERINGNATURAL, sizeof(oname)));
42659566063dSJacob Faibussowitsch   PetscCall(PetscOptionsFList("-dm_plex_reorder", "Set mesh reordering type", "DMPlexGetOrdering", ordlist, MATORDERINGNATURAL, oname, sizeof(oname), &flg));
42666bc1bd01Sksagiyam   if (reorder == DMPLEX_REORDER_DEFAULT_TRUE || flg) {
4267bdf63967SMatthew G. Knepley     DM pdm;
4268bdf63967SMatthew G. Knepley     IS perm;
4269bdf63967SMatthew G. Knepley 
42709566063dSJacob Faibussowitsch     PetscCall(DMPlexGetOrdering(dm, oname, NULL, &perm));
42719566063dSJacob Faibussowitsch     PetscCall(DMPlexPermute(dm, perm, &pdm));
42729566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&perm));
427369d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &pdm));
4274dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4275bdf63967SMatthew G. Knepley   }
42769b44eab4SMatthew G. Knepley   /* Handle DMPlex distribution */
42779566063dSJacob Faibussowitsch   PetscCall(DMPlexDistributeGetDefault(dm, &distribute));
4278c506a872SMatthew G. Knepley   PetscCall(PetscOptionsBool("-dm_distribute", "Flag to redistribute a mesh among processes", "DMPlexDistribute", distribute, &distribute, NULL));
4279a286e215SMatthew G. Knepley   PetscCall(PetscOptionsBool("-dm_distribute_save_sf", "Flag to save the migration SF", "DMPlexSetMigrationSF", saveSF, &saveSF, NULL));
4280dbbe0bcdSBarry Smith   PetscCall(DMSetFromOptions_Overlap_Plex(dm, PetscOptionsObject, &overlap));
42819b44eab4SMatthew G. Knepley   if (distribute) {
42829b44eab4SMatthew G. Knepley     DM               pdm = NULL;
42839b44eab4SMatthew G. Knepley     PetscPartitioner part;
4284a286e215SMatthew G. Knepley     PetscSF          sfMigration;
42859b44eab4SMatthew G. Knepley 
42869566063dSJacob Faibussowitsch     PetscCall(DMPlexGetPartitioner(dm, &part));
42879566063dSJacob Faibussowitsch     PetscCall(PetscPartitionerSetFromOptions(part));
4288a286e215SMatthew G. Knepley     PetscCall(DMPlexDistribute(dm, overlap, &sfMigration, &pdm));
428948a46eb9SPierre Jolivet     if (pdm) PetscCall(DMPlexReplace_Internal(dm, &pdm));
4290a286e215SMatthew G. Knepley     if (saveSF) PetscCall(DMPlexSetMigrationSF(dm, sfMigration));
4291a286e215SMatthew G. Knepley     PetscCall(PetscSFDestroy(&sfMigration));
42929b44eab4SMatthew G. Knepley   }
4293d2b2dc1eSMatthew G. Knepley   /* Must check CEED options before creating function space for coordinates */
4294d2b2dc1eSMatthew G. Knepley   {
4295d2b2dc1eSMatthew G. Knepley     PetscBool useCeed = PETSC_FALSE, flg;
4296d2b2dc1eSMatthew G. Knepley 
4297d2b2dc1eSMatthew G. Knepley     PetscCall(PetscOptionsBool("-dm_plex_use_ceed", "Use LibCEED as the FEM backend", "DMPlexSetUseCeed", useCeed, &useCeed, &flg));
4298d2b2dc1eSMatthew G. Knepley     if (flg) PetscCall(DMPlexSetUseCeed(dm, useCeed));
4299d2b2dc1eSMatthew G. Knepley   }
43009318fe57SMatthew G. Knepley   /* Create coordinate space */
43019318fe57SMatthew G. Knepley   if (created) {
430261a622f3SMatthew G. Knepley     DM_Plex  *mesh   = (DM_Plex *)dm->data;
4303e44f6aebSMatthew G. Knepley     PetscInt  degree = 1, deg;
43045515ebd3SMatthew G. Knepley     PetscInt  height = 0;
43055515ebd3SMatthew G. Knepley     DM        cdm;
43066858538eSMatthew G. Knepley     PetscBool flg;
43079318fe57SMatthew G. Knepley 
43089566063dSJacob Faibussowitsch     PetscCall(PetscOptionsBool("-dm_coord_space", "Use an FEM space for coordinates", "", coordSpace, &coordSpace, &flg));
43099566063dSJacob Faibussowitsch     PetscCall(PetscOptionsInt("-dm_coord_petscspace_degree", "FEM degree for coordinate space", "", degree, &degree, NULL));
4310e44f6aebSMatthew G. Knepley     PetscCall(DMGetCoordinateDegree_Internal(dm, &deg));
4311e44f6aebSMatthew G. Knepley     if (coordSpace && deg <= 1) PetscCall(DMPlexCreateCoordinateSpace(dm, degree, PETSC_TRUE, mesh->coordFunc));
43125515ebd3SMatthew G. Knepley     PetscCall(DMGetCoordinateDM(dm, &cdm));
431361a622f3SMatthew G. Knepley     if (flg && !coordSpace) {
431461a622f3SMatthew G. Knepley       PetscDS      cds;
431561a622f3SMatthew G. Knepley       PetscObject  obj;
431661a622f3SMatthew G. Knepley       PetscClassId id;
431761a622f3SMatthew G. Knepley 
43189566063dSJacob Faibussowitsch       PetscCall(DMGetDS(cdm, &cds));
43199566063dSJacob Faibussowitsch       PetscCall(PetscDSGetDiscretization(cds, 0, &obj));
43209566063dSJacob Faibussowitsch       PetscCall(PetscObjectGetClassId(obj, &id));
432161a622f3SMatthew G. Knepley       if (id == PETSCFE_CLASSID) {
432261a622f3SMatthew G. Knepley         PetscContainer dummy;
432361a622f3SMatthew G. Knepley 
43249566063dSJacob Faibussowitsch         PetscCall(PetscContainerCreate(PETSC_COMM_SELF, &dummy));
43259566063dSJacob Faibussowitsch         PetscCall(PetscObjectSetName((PetscObject)dummy, "coordinates"));
43269566063dSJacob Faibussowitsch         PetscCall(DMSetField(cdm, 0, NULL, (PetscObject)dummy));
43279566063dSJacob Faibussowitsch         PetscCall(PetscContainerDestroy(&dummy));
43289566063dSJacob Faibussowitsch         PetscCall(DMClearDS(cdm));
432961a622f3SMatthew G. Knepley       }
433061a622f3SMatthew G. Knepley       mesh->coordFunc = NULL;
433161a622f3SMatthew G. Knepley     }
43326858538eSMatthew G. Knepley     PetscCall(PetscOptionsBool("-dm_sparse_localize", "Localize only necessary cells", "", dm->sparseLocalize, &dm->sparseLocalize, &flg));
43335515ebd3SMatthew G. Knepley     PetscCall(PetscOptionsInt("-dm_localize_height", "Localize edges and faces in addition to cells", "", height, &height, &flg));
43345515ebd3SMatthew G. Knepley     if (flg) PetscCall(DMPlexSetMaxProjectionHeight(cdm, height));
43359566063dSJacob Faibussowitsch     PetscCall(DMLocalizeCoordinates(dm));
43369318fe57SMatthew G. Knepley   }
433768d4fef7SMatthew G. Knepley   /* Handle DMPlex refinement */
433861a622f3SMatthew G. Knepley   remap = PETSC_TRUE;
43399566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine", "The number of uniform refinements", "DMCreate", refine, &refine, NULL, 0));
43409566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_remap", "Flag to control coordinate remapping", "DMCreate", remap, &remap, NULL));
43419566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine_hierarchy", "The number of uniform refinements", "DMCreate", refine, &refine, &isHierarchy, 0));
43429566063dSJacob Faibussowitsch   if (refine) PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
434368d4fef7SMatthew G. Knepley   if (refine && isHierarchy) {
4344acdc6f61SToby Isaac     DM *dms, coarseDM;
434568d4fef7SMatthew G. Knepley 
43469566063dSJacob Faibussowitsch     PetscCall(DMGetCoarseDM(dm, &coarseDM));
43479566063dSJacob Faibussowitsch     PetscCall(PetscObjectReference((PetscObject)coarseDM));
43489566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(refine, &dms));
43499566063dSJacob Faibussowitsch     PetscCall(DMRefineHierarchy(dm, refine, dms));
435068d4fef7SMatthew G. Knepley     /* Total hack since we do not pass in a pointer */
43519566063dSJacob Faibussowitsch     PetscCall(DMPlexSwap_Static(dm, dms[refine - 1]));
435268d4fef7SMatthew G. Knepley     if (refine == 1) {
43539566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dm, dms[0]));
43549566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dm, PETSC_TRUE));
435568d4fef7SMatthew G. Knepley     } else {
43569566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dm, dms[refine - 2]));
43579566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dm, PETSC_TRUE));
43589566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dms[0], dms[refine - 1]));
43599566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dms[0], PETSC_TRUE));
436068d4fef7SMatthew G. Knepley     }
43619566063dSJacob Faibussowitsch     PetscCall(DMSetCoarseDM(dms[refine - 1], coarseDM));
43629566063dSJacob Faibussowitsch     PetscCall(PetscObjectDereference((PetscObject)coarseDM));
436368d4fef7SMatthew G. Knepley     /* Free DMs */
436468d4fef7SMatthew G. Knepley     for (r = 0; r < refine; ++r) {
4365dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dms[r], PetscOptionsObject));
43669566063dSJacob Faibussowitsch       PetscCall(DMDestroy(&dms[r]));
436768d4fef7SMatthew G. Knepley     }
43689566063dSJacob Faibussowitsch     PetscCall(PetscFree(dms));
436968d4fef7SMatthew G. Knepley   } else {
437068d4fef7SMatthew G. Knepley     for (r = 0; r < refine; ++r) {
43719318fe57SMatthew G. Knepley       DM             rdm;
437251a74b61SMatthew G. Knepley       PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
437368d4fef7SMatthew G. Knepley 
4374dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
43759566063dSJacob Faibussowitsch       PetscCall(DMRefine(dm, PetscObjectComm((PetscObject)dm), &rdm));
437668d4fef7SMatthew G. Knepley       /* Total hack since we do not pass in a pointer */
437769d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &rdm));
4378dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
437961a622f3SMatthew G. Knepley       if (coordFunc && remap) {
43809566063dSJacob Faibussowitsch         PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
438151a74b61SMatthew G. Knepley         ((DM_Plex *)dm->data)->coordFunc = coordFunc;
438251a74b61SMatthew G. Knepley       }
438368d4fef7SMatthew G. Knepley     }
438468d4fef7SMatthew G. Knepley   }
43853cf6fe12SMatthew G. Knepley   /* Handle DMPlex coarsening */
43869566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_coarsen", "Coarsen the mesh", "DMCreate", coarsen, &coarsen, NULL, 0));
43879566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_coarsen_hierarchy", "The number of coarsenings", "DMCreate", coarsen, &coarsen, &isHierarchy, 0));
4388b653a561SMatthew G. Knepley   if (coarsen && isHierarchy) {
4389b653a561SMatthew G. Knepley     DM *dms;
4390b653a561SMatthew G. Knepley 
43919566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(coarsen, &dms));
43929566063dSJacob Faibussowitsch     PetscCall(DMCoarsenHierarchy(dm, coarsen, dms));
4393b653a561SMatthew G. Knepley     /* Free DMs */
4394b653a561SMatthew G. Knepley     for (r = 0; r < coarsen; ++r) {
4395dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dms[r], PetscOptionsObject));
43969566063dSJacob Faibussowitsch       PetscCall(DMDestroy(&dms[r]));
4397b653a561SMatthew G. Knepley     }
43989566063dSJacob Faibussowitsch     PetscCall(PetscFree(dms));
4399b653a561SMatthew G. Knepley   } else {
4400b653a561SMatthew G. Knepley     for (r = 0; r < coarsen; ++r) {
44019318fe57SMatthew G. Knepley       DM             cdm;
44029318fe57SMatthew G. Knepley       PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
44033cf6fe12SMatthew G. Knepley 
4404dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
44059566063dSJacob Faibussowitsch       PetscCall(DMCoarsen(dm, PetscObjectComm((PetscObject)dm), &cdm));
44063cf6fe12SMatthew G. Knepley       /* Total hack since we do not pass in a pointer */
440769d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &cdm));
4408dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
44099318fe57SMatthew G. Knepley       if (coordFunc) {
44109566063dSJacob Faibussowitsch         PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
44119318fe57SMatthew G. Knepley         ((DM_Plex *)dm->data)->coordFunc = coordFunc;
44129318fe57SMatthew G. Knepley       }
44133cf6fe12SMatthew G. Knepley     }
4414b653a561SMatthew G. Knepley   }
4415909dfd52SMatthew G. Knepley   /* Handle ghost cells */
44169566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_create_fv_ghost_cells", "Flag to create finite volume ghost cells on the boundary", "DMCreate", ghostCells, &ghostCells, NULL));
4417909dfd52SMatthew G. Knepley   if (ghostCells) {
4418909dfd52SMatthew G. Knepley     DM   gdm;
4419909dfd52SMatthew G. Knepley     char lname[PETSC_MAX_PATH_LEN];
4420909dfd52SMatthew G. Knepley 
4421909dfd52SMatthew G. Knepley     lname[0] = '\0';
44229566063dSJacob Faibussowitsch     PetscCall(PetscOptionsString("-dm_plex_fv_ghost_cells_label", "Label name for ghost cells boundary", "DMCreate", lname, lname, sizeof(lname), &flg));
44239566063dSJacob Faibussowitsch     PetscCall(DMPlexConstructGhostCells(dm, flg ? lname : NULL, NULL, &gdm));
442469d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &gdm));
4425909dfd52SMatthew G. Knepley   }
44266913077dSMatthew G. Knepley   /* Handle 1D order */
44276bc1bd01Sksagiyam   if (reorder != DMPLEX_REORDER_DEFAULT_FALSE && dim == 1) {
44286913077dSMatthew G. Knepley     DM           cdm, rdm;
44296913077dSMatthew G. Knepley     PetscDS      cds;
44306913077dSMatthew G. Knepley     PetscObject  obj;
44316913077dSMatthew G. Knepley     PetscClassId id = PETSC_OBJECT_CLASSID;
44326913077dSMatthew G. Knepley     IS           perm;
44336bc1bd01Sksagiyam     PetscInt     Nf;
44346913077dSMatthew G. Knepley     PetscBool    distributed;
44356913077dSMatthew G. Knepley 
44369566063dSJacob Faibussowitsch     PetscCall(DMPlexIsDistributed(dm, &distributed));
44379566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
44389566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
44399566063dSJacob Faibussowitsch     PetscCall(PetscDSGetNumFields(cds, &Nf));
44406913077dSMatthew G. Knepley     if (Nf) {
44419566063dSJacob Faibussowitsch       PetscCall(PetscDSGetDiscretization(cds, 0, &obj));
44429566063dSJacob Faibussowitsch       PetscCall(PetscObjectGetClassId(obj, &id));
44436913077dSMatthew G. Knepley     }
44446bc1bd01Sksagiyam     if (!distributed && id != PETSCFE_CLASSID) {
44459566063dSJacob Faibussowitsch       PetscCall(DMPlexGetOrdering1D(dm, &perm));
44469566063dSJacob Faibussowitsch       PetscCall(DMPlexPermute(dm, perm, &rdm));
444769d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &rdm));
44489566063dSJacob Faibussowitsch       PetscCall(ISDestroy(&perm));
44496913077dSMatthew G. Knepley     }
44506913077dSMatthew G. Knepley   }
44513cf6fe12SMatthew G. Knepley /* Handle */
4452dd4c3f67SMatthew G. Knepley non_refine:
4453dbbe0bcdSBarry Smith   PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4454d0609cedSBarry Smith   PetscOptionsHeadEnd();
44553ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
44560a6ba040SMatthew G. Knepley }
44570a6ba040SMatthew G. Knepley 
4458d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMCreateGlobalVector_Plex(DM dm, Vec *vec)
4459d71ae5a4SJacob Faibussowitsch {
4460552f7358SJed Brown   PetscFunctionBegin;
44619566063dSJacob Faibussowitsch   PetscCall(DMCreateGlobalVector_Section_Private(dm, vec));
44629566063dSJacob Faibussowitsch   /* PetscCall(VecSetOperation(*vec, VECOP_DUPLICATE, (void(*)(void)) VecDuplicate_MPI_DM)); */
44639566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEW, (void (*)(void))VecView_Plex));
44649566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEWNATIVE, (void (*)(void))VecView_Plex_Native));
44659566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOAD, (void (*)(void))VecLoad_Plex));
44669566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOADNATIVE, (void (*)(void))VecLoad_Plex_Native));
44673ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4468552f7358SJed Brown }
4469552f7358SJed Brown 
4470d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMCreateLocalVector_Plex(DM dm, Vec *vec)
4471d71ae5a4SJacob Faibussowitsch {
4472552f7358SJed Brown   PetscFunctionBegin;
44739566063dSJacob Faibussowitsch   PetscCall(DMCreateLocalVector_Section_Private(dm, vec));
44749566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEW, (void (*)(void))VecView_Plex_Local));
44759566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOAD, (void (*)(void))VecLoad_Plex_Local));
44763ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4477552f7358SJed Brown }
4478552f7358SJed Brown 
4479d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMGetDimPoints_Plex(DM dm, PetscInt dim, PetscInt *pStart, PetscInt *pEnd)
4480d71ae5a4SJacob Faibussowitsch {
4481793f3fe5SMatthew G. Knepley   PetscInt depth, d;
4482793f3fe5SMatthew G. Knepley 
4483793f3fe5SMatthew G. Knepley   PetscFunctionBegin;
44849566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepth(dm, &depth));
4485793f3fe5SMatthew G. Knepley   if (depth == 1) {
44869566063dSJacob Faibussowitsch     PetscCall(DMGetDimension(dm, &d));
44879566063dSJacob Faibussowitsch     if (dim == 0) PetscCall(DMPlexGetDepthStratum(dm, dim, pStart, pEnd));
44889566063dSJacob Faibussowitsch     else if (dim == d) PetscCall(DMPlexGetDepthStratum(dm, 1, pStart, pEnd));
44899371c9d4SSatish Balay     else {
44909371c9d4SSatish Balay       *pStart = 0;
44919371c9d4SSatish Balay       *pEnd   = 0;
44929371c9d4SSatish Balay     }
4493793f3fe5SMatthew G. Knepley   } else {
44949566063dSJacob Faibussowitsch     PetscCall(DMPlexGetDepthStratum(dm, dim, pStart, pEnd));
4495793f3fe5SMatthew G. Knepley   }
44963ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4497793f3fe5SMatthew G. Knepley }
4498793f3fe5SMatthew G. Knepley 
4499d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMGetNeighbors_Plex(DM dm, PetscInt *nranks, const PetscMPIInt *ranks[])
4500d71ae5a4SJacob Faibussowitsch {
4501502a2867SDave May   PetscSF            sf;
45020a19bb7dSprj-   PetscInt           niranks, njranks, n;
45030a19bb7dSprj-   const PetscMPIInt *iranks, *jranks;
45040a19bb7dSprj-   DM_Plex           *data = (DM_Plex *)dm->data;
4505502a2867SDave May 
45062f356facSMatthew G. Knepley   PetscFunctionBegin;
45079566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dm, &sf));
45080a19bb7dSprj-   if (!data->neighbors) {
45099566063dSJacob Faibussowitsch     PetscCall(PetscSFSetUp(sf));
45109566063dSJacob Faibussowitsch     PetscCall(PetscSFGetRootRanks(sf, &njranks, &jranks, NULL, NULL, NULL));
45119566063dSJacob Faibussowitsch     PetscCall(PetscSFGetLeafRanks(sf, &niranks, &iranks, NULL, NULL));
45129566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(njranks + niranks + 1, &data->neighbors));
45139566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(data->neighbors + 1, jranks, njranks));
45149566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(data->neighbors + njranks + 1, iranks, niranks));
45150a19bb7dSprj-     n = njranks + niranks;
45169566063dSJacob Faibussowitsch     PetscCall(PetscSortRemoveDupsMPIInt(&n, data->neighbors + 1));
45170a19bb7dSprj-     /* The following cast should never fail: can't have more neighbors than PETSC_MPI_INT_MAX */
45189566063dSJacob Faibussowitsch     PetscCall(PetscMPIIntCast(n, data->neighbors));
45190a19bb7dSprj-   }
45200a19bb7dSprj-   if (nranks) *nranks = data->neighbors[0];
45210a19bb7dSprj-   if (ranks) {
45220a19bb7dSprj-     if (data->neighbors[0]) *ranks = data->neighbors + 1;
45230a19bb7dSprj-     else *ranks = NULL;
45240a19bb7dSprj-   }
45253ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4526502a2867SDave May }
4527502a2867SDave May 
45281eb70e55SToby Isaac PETSC_INTERN PetscErrorCode DMInterpolateSolution_Plex(DM, DM, Mat, Vec, Vec);
45291eb70e55SToby Isaac 
4530d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMInitialize_Plex(DM dm)
4531d71ae5a4SJacob Faibussowitsch {
4532552f7358SJed Brown   PetscFunctionBegin;
4533552f7358SJed Brown   dm->ops->view                      = DMView_Plex;
45342c40f234SMatthew G. Knepley   dm->ops->load                      = DMLoad_Plex;
4535552f7358SJed Brown   dm->ops->setfromoptions            = DMSetFromOptions_Plex;
453638221697SMatthew G. Knepley   dm->ops->clone                     = DMClone_Plex;
4537552f7358SJed Brown   dm->ops->setup                     = DMSetUp_Plex;
45381bb6d2a8SBarry Smith   dm->ops->createlocalsection        = DMCreateLocalSection_Plex;
453966ad2231SToby Isaac   dm->ops->createdefaultconstraints  = DMCreateDefaultConstraints_Plex;
4540552f7358SJed Brown   dm->ops->createglobalvector        = DMCreateGlobalVector_Plex;
4541552f7358SJed Brown   dm->ops->createlocalvector         = DMCreateLocalVector_Plex;
4542184d77edSJed Brown   dm->ops->getlocaltoglobalmapping   = NULL;
45430298fd71SBarry Smith   dm->ops->createfieldis             = NULL;
4544552f7358SJed Brown   dm->ops->createcoordinatedm        = DMCreateCoordinateDM_Plex;
4545f19dbd58SToby Isaac   dm->ops->createcoordinatefield     = DMCreateCoordinateField_Plex;
45460a6ba040SMatthew G. Knepley   dm->ops->getcoloring               = NULL;
4547552f7358SJed Brown   dm->ops->creatematrix              = DMCreateMatrix_Plex;
4548bceba477SMatthew G. Knepley   dm->ops->createinterpolation       = DMCreateInterpolation_Plex;
4549bd041c0cSMatthew G. Knepley   dm->ops->createmassmatrix          = DMCreateMassMatrix_Plex;
4550b4937a87SMatthew G. Knepley   dm->ops->createmassmatrixlumped    = DMCreateMassMatrixLumped_Plex;
45515a84ad33SLisandro Dalcin   dm->ops->createinjection           = DMCreateInjection_Plex;
4552552f7358SJed Brown   dm->ops->refine                    = DMRefine_Plex;
45530a6ba040SMatthew G. Knepley   dm->ops->coarsen                   = DMCoarsen_Plex;
45540a6ba040SMatthew G. Knepley   dm->ops->refinehierarchy           = DMRefineHierarchy_Plex;
4555b653a561SMatthew G. Knepley   dm->ops->coarsenhierarchy          = DMCoarsenHierarchy_Plex;
4556d410b0cfSMatthew G. Knepley   dm->ops->extrude                   = DMExtrude_Plex;
45570298fd71SBarry Smith   dm->ops->globaltolocalbegin        = NULL;
45580298fd71SBarry Smith   dm->ops->globaltolocalend          = NULL;
45590298fd71SBarry Smith   dm->ops->localtoglobalbegin        = NULL;
45600298fd71SBarry Smith   dm->ops->localtoglobalend          = NULL;
4561552f7358SJed Brown   dm->ops->destroy                   = DMDestroy_Plex;
4562552f7358SJed Brown   dm->ops->createsubdm               = DMCreateSubDM_Plex;
45632adcc780SMatthew G. Knepley   dm->ops->createsuperdm             = DMCreateSuperDM_Plex;
4564793f3fe5SMatthew G. Knepley   dm->ops->getdimpoints              = DMGetDimPoints_Plex;
4565552f7358SJed Brown   dm->ops->locatepoints              = DMLocatePoints_Plex;
45660709b2feSToby Isaac   dm->ops->projectfunctionlocal      = DMProjectFunctionLocal_Plex;
45670709b2feSToby Isaac   dm->ops->projectfunctionlabellocal = DMProjectFunctionLabelLocal_Plex;
4568bfc4295aSToby Isaac   dm->ops->projectfieldlocal         = DMProjectFieldLocal_Plex;
45698c6c5593SMatthew G. Knepley   dm->ops->projectfieldlabellocal    = DMProjectFieldLabelLocal_Plex;
4570ece3a9fcSMatthew G. Knepley   dm->ops->projectbdfieldlabellocal  = DMProjectBdFieldLabelLocal_Plex;
45710709b2feSToby Isaac   dm->ops->computel2diff             = DMComputeL2Diff_Plex;
4572b698f381SToby Isaac   dm->ops->computel2gradientdiff     = DMComputeL2GradientDiff_Plex;
45732a16baeaSToby Isaac   dm->ops->computel2fielddiff        = DMComputeL2FieldDiff_Plex;
457428d58a37SPierre Jolivet   dm->ops->getneighbors              = DMGetNeighbors_Plex;
45759566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexInsertBoundaryValues_C", DMPlexInsertBoundaryValues_Plex));
45769566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexInsertTimeDerviativeBoundaryValues_C", DMPlexInsertTimeDerivativeBoundaryValues_Plex));
45779566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMSetUpGLVisViewer_C", DMSetUpGLVisViewer_Plex));
45789566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMCreateNeumannOverlap_C", DMCreateNeumannOverlap_Plex));
45799566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetOverlap_C", DMPlexGetOverlap_Plex));
45809566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexDistributeGetDefault_C", DMPlexDistributeGetDefault_Plex));
45819566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexDistributeSetDefault_C", DMPlexDistributeSetDefault_Plex));
45826bc1bd01Sksagiyam   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexReorderGetDefault_C", DMPlexReorderGetDefault_Plex));
45836bc1bd01Sksagiyam   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexReorderSetDefault_C", DMPlexReorderSetDefault_Plex));
45849566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMInterpolateSolution_C", DMInterpolateSolution_Plex));
4585c506a872SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetOverlap_C", DMPlexGetOverlap_Plex));
4586c506a872SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexSetOverlap_C", DMPlexSetOverlap_Plex));
4587d2b2dc1eSMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetUseCeed_C", DMPlexGetUseCeed_Plex));
4588d2b2dc1eSMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexSetUseCeed_C", DMPlexSetUseCeed_Plex));
45893ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4590552f7358SJed Brown }
4591552f7358SJed Brown 
4592d71ae5a4SJacob Faibussowitsch PETSC_INTERN PetscErrorCode DMClone_Plex(DM dm, DM *newdm)
4593d71ae5a4SJacob Faibussowitsch {
459463a16f15SMatthew G. Knepley   DM_Plex *mesh = (DM_Plex *)dm->data;
45956725e60dSJed Brown   PetscSF  face_sf;
459663a16f15SMatthew G. Knepley 
459763a16f15SMatthew G. Knepley   PetscFunctionBegin;
459863a16f15SMatthew G. Knepley   mesh->refct++;
459963a16f15SMatthew G. Knepley   (*newdm)->data = mesh;
46005f06a3ddSJed Brown   PetscCall(DMPlexGetIsoperiodicFaceSF(dm, &face_sf));
46015f06a3ddSJed Brown   PetscCall(DMPlexSetIsoperiodicFaceSF(*newdm, face_sf));
46029566063dSJacob Faibussowitsch   PetscCall(PetscObjectChangeTypeName((PetscObject)*newdm, DMPLEX));
46039566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(*newdm));
46043ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
460563a16f15SMatthew G. Knepley }
460663a16f15SMatthew G. Knepley 
46078818961aSMatthew G Knepley /*MC
4608a1cb98faSBarry Smith   DMPLEX = "plex" - A `DM` object that encapsulates an unstructured mesh, or CW Complex, which can be expressed using a Hasse Diagram.
460920f4b53cSBarry Smith                     In the local representation, `Vec`s contain all unknowns in the interior and shared boundary. This is
46108818961aSMatthew G Knepley                     specified by a PetscSection object. Ownership in the global representation is determined by
4611a1cb98faSBarry Smith                     ownership of the underlying `DMPLEX` points. This is specified by another `PetscSection` object.
46128818961aSMatthew G Knepley 
4613e5893cccSMatthew G. Knepley   Options Database Keys:
4614250712c9SMatthew G. Knepley + -dm_refine_pre                     - Refine mesh before distribution
4615250712c9SMatthew G. Knepley + -dm_refine_uniform_pre             - Choose uniform or generator-based refinement
4616250712c9SMatthew G. Knepley + -dm_refine_volume_limit_pre        - Cell volume limit after pre-refinement using generator
4617250712c9SMatthew G. Knepley . -dm_distribute                     - Distribute mesh across processes
4618250712c9SMatthew G. Knepley . -dm_distribute_overlap             - Number of cells to overlap for distribution
4619250712c9SMatthew G. Knepley . -dm_refine                         - Refine mesh after distribution
4620250712c9SMatthew G. Knepley . -dm_plex_hash_location             - Use grid hashing for point location
4621ddce0771SMatthew G. Knepley . -dm_plex_hash_box_faces <n,m,p>    - The number of divisions in each direction of the grid hash
4622f12cf164SMatthew G. Knepley . -dm_plex_partition_balance         - Attempt to evenly divide points on partition boundary between processes
4623f12cf164SMatthew G. Knepley . -dm_plex_remesh_bd                 - Allow changes to the boundary on remeshing
4624d5b43468SJose E. Roman . -dm_plex_max_projection_height     - Maximum mesh point height used to project locally
4625f12cf164SMatthew G. Knepley . -dm_plex_regular_refinement        - Use special nested projection algorithm for regular refinement
4626aaa8cc7dSPierre Jolivet . -dm_plex_check_all                 - Perform all checks below
4627f12cf164SMatthew G. Knepley . -dm_plex_check_symmetry            - Check that the adjacency information in the mesh is symmetric
4628f12cf164SMatthew G. Knepley . -dm_plex_check_skeleton <celltype> - Check that each cell has the correct number of vertices
4629f12cf164SMatthew 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
4630f12cf164SMatthew G. Knepley . -dm_plex_check_geometry            - Check that cells have positive volume
4631f12cf164SMatthew G. Knepley . -dm_view :mesh.tex:ascii_latex     - View the mesh in LaTeX/TikZ
4632e5893cccSMatthew G. Knepley . -dm_plex_view_scale <num>          - Scale the TikZ
46335962854dSMatthew G. Knepley . -dm_plex_print_fem <num>           - View FEM assembly information, such as element vectors and matrices
46345962854dSMatthew G. Knepley - -dm_plex_print_fvm <num>           - View FVM assembly information, such as flux updates
4635e5893cccSMatthew G. Knepley 
46368818961aSMatthew G Knepley   Level: intermediate
46378818961aSMatthew G Knepley 
46381cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMType`, `DMPlexCreate()`, `DMCreate()`, `DMSetType()`, `PetscSection`
46398818961aSMatthew G Knepley M*/
46408818961aSMatthew G Knepley 
4641d71ae5a4SJacob Faibussowitsch PETSC_EXTERN PetscErrorCode DMCreate_Plex(DM dm)
4642d71ae5a4SJacob Faibussowitsch {
4643552f7358SJed Brown   DM_Plex *mesh;
4644412e9a14SMatthew G. Knepley   PetscInt unit;
4645552f7358SJed Brown 
4646552f7358SJed Brown   PetscFunctionBegin;
4647f39ec787SMatthew G. Knepley   PetscCall(PetscCitationsRegister(PlexCitation, &Plexcite));
4648552f7358SJed Brown   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
46494dfa11a4SJacob Faibussowitsch   PetscCall(PetscNew(&mesh));
4650552f7358SJed Brown   dm->data = mesh;
4651552f7358SJed Brown 
4652552f7358SJed Brown   mesh->refct = 1;
46539566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &mesh->coneSection));
46549566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &mesh->supportSection));
4655552f7358SJed Brown   mesh->refinementUniform      = PETSC_TRUE;
4656552f7358SJed Brown   mesh->refinementLimit        = -1.0;
4657e600fa54SMatthew G. Knepley   mesh->distDefault            = PETSC_TRUE;
46586bc1bd01Sksagiyam   mesh->reorderDefault         = DMPLEX_REORDER_DEFAULT_NOTSET;
46591d1f2f2aSksagiyam   mesh->distributionName       = NULL;
46607d0f5628SVaclav Hapla   mesh->interpolated           = DMPLEX_INTERPOLATED_INVALID;
46617d0f5628SVaclav Hapla   mesh->interpolatedCollective = DMPLEX_INTERPOLATED_INVALID;
4662552f7358SJed Brown 
46639566063dSJacob Faibussowitsch   PetscCall(PetscPartitionerCreate(PetscObjectComm((PetscObject)dm), &mesh->partitioner));
46642e62ab5aSMatthew G. Knepley   mesh->remeshBd = PETSC_FALSE;
4665d9deefdfSMatthew G. Knepley 
46668865f1eaSKarl Rupp   for (unit = 0; unit < NUM_PETSC_UNITS; ++unit) mesh->scale[unit] = 1.0;
4667552f7358SJed Brown 
4668df0420ecSMatthew G. Knepley   mesh->depthState    = -1;
4669ba2698f1SMatthew G. Knepley   mesh->celltypeState = -1;
46706113b454SMatthew G. Knepley   mesh->printTol      = 1.0e-10;
4671552f7358SJed Brown 
46729566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(dm));
46733ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4674552f7358SJed Brown }
4675552f7358SJed Brown 
4676552f7358SJed Brown /*@
4677a1cb98faSBarry Smith   DMPlexCreate - Creates a `DMPLEX` object, which encapsulates an unstructured mesh, or CW complex, which can be expressed using a Hasse Diagram.
4678552f7358SJed Brown 
4679d083f849SBarry Smith   Collective
4680552f7358SJed Brown 
4681552f7358SJed Brown   Input Parameter:
4682a1cb98faSBarry Smith . comm - The communicator for the `DMPLEX` object
4683552f7358SJed Brown 
4684552f7358SJed Brown   Output Parameter:
4685a1cb98faSBarry Smith . mesh - The `DMPLEX` object
4686552f7358SJed Brown 
4687552f7358SJed Brown   Level: beginner
4688552f7358SJed Brown 
468942747ad1SJacob Faibussowitsch .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMType`, `DMCreate()`, `DMSetType()`
4690552f7358SJed Brown @*/
4691d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreate(MPI_Comm comm, DM *mesh)
4692d71ae5a4SJacob Faibussowitsch {
4693552f7358SJed Brown   PetscFunctionBegin;
46944f572ea9SToby Isaac   PetscAssertPointer(mesh, 2);
46959566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, mesh));
46969566063dSJacob Faibussowitsch   PetscCall(DMSetType(*mesh, DMPLEX));
46973ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4698552f7358SJed Brown }
4699552f7358SJed Brown 
4700b09969d6SVaclav Hapla /*@C
4701a1cb98faSBarry Smith   DMPlexBuildFromCellListParallel - Build distributed `DMPLEX` topology from a list of vertices for each cell (common mesh generator output)
4702a1cb98faSBarry Smith 
470320f4b53cSBarry Smith   Collective; No Fortran Support
4704b09969d6SVaclav Hapla 
4705b09969d6SVaclav Hapla   Input Parameters:
4706a1cb98faSBarry Smith + dm          - The `DM`
4707b09969d6SVaclav Hapla . numCells    - The number of cells owned by this process
4708a1cb98faSBarry Smith . numVertices - The number of vertices to be owned by this process, or `PETSC_DECIDE`
4709a1cb98faSBarry Smith . NVertices   - The global number of vertices, or `PETSC_DETERMINE`
4710b09969d6SVaclav Hapla . numCorners  - The number of vertices for each cell
47115e488331SVaclav Hapla - cells       - An array of numCells*numCorners numbers, the global vertex numbers for each cell
4712b09969d6SVaclav Hapla 
4713be8c289dSNicolas Barral   Output Parameters:
4714a1cb98faSBarry Smith + vertexSF         - (Optional) `PetscSF` describing complete vertex ownership
4715be8c289dSNicolas Barral - verticesAdjSaved - (Optional) vertex adjacency array
4716b09969d6SVaclav Hapla 
4717b09969d6SVaclav Hapla   Level: advanced
4718b09969d6SVaclav Hapla 
4719a1cb98faSBarry Smith   Notes:
4720a1cb98faSBarry Smith   Two triangles sharing a face
4721a1cb98faSBarry Smith .vb
4722a1cb98faSBarry Smith 
4723a1cb98faSBarry Smith         2
4724a1cb98faSBarry Smith       / | \
4725a1cb98faSBarry Smith      /  |  \
4726a1cb98faSBarry Smith     /   |   \
4727a1cb98faSBarry Smith    0  0 | 1  3
4728a1cb98faSBarry Smith     \   |   /
4729a1cb98faSBarry Smith      \  |  /
4730a1cb98faSBarry Smith       \ | /
4731a1cb98faSBarry Smith         1
4732a1cb98faSBarry Smith .ve
4733a1cb98faSBarry Smith   would have input
4734a1cb98faSBarry Smith .vb
4735a1cb98faSBarry Smith   numCells = 2, numVertices = 4
4736a1cb98faSBarry Smith   cells = [0 1 2  1 3 2]
4737a1cb98faSBarry Smith .ve
4738a1cb98faSBarry Smith   which would result in the `DMPLEX`
4739a1cb98faSBarry Smith .vb
4740a1cb98faSBarry Smith 
4741a1cb98faSBarry Smith         4
4742a1cb98faSBarry Smith       / | \
4743a1cb98faSBarry Smith      /  |  \
4744a1cb98faSBarry Smith     /   |   \
4745a1cb98faSBarry Smith    2  0 | 1  5
4746a1cb98faSBarry Smith     \   |   /
4747a1cb98faSBarry Smith      \  |  /
4748a1cb98faSBarry Smith       \ | /
4749a1cb98faSBarry Smith         3
4750a1cb98faSBarry Smith .ve
4751a1cb98faSBarry Smith 
4752a1cb98faSBarry Smith   Vertices are implicitly numbered consecutively 0,...,NVertices.
4753a1cb98faSBarry Smith   Each rank owns a chunk of numVertices consecutive vertices.
4754a1cb98faSBarry Smith   If numVertices is `PETSC_DECIDE`, PETSc will distribute them as evenly as possible using PetscLayout.
4755a1cb98faSBarry Smith   If NVertices is `PETSC_DETERMINE` and numVertices is PETSC_DECIDE, NVertices is computed by PETSc as the maximum vertex index in cells + 1.
4756a1cb98faSBarry Smith   If only NVertices is `PETSC_DETERMINE`, it is computed as the sum of numVertices over all ranks.
4757a1cb98faSBarry Smith 
4758a1cb98faSBarry Smith   The cell distribution is arbitrary non-overlapping, independent of the vertex distribution.
4759a1cb98faSBarry Smith 
47601cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildFromCellList()`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildCoordinatesFromCellListParallel()`,
4761a1cb98faSBarry Smith           `PetscSF`
4762b09969d6SVaclav Hapla @*/
4763d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildFromCellListParallel(DM dm, PetscInt numCells, PetscInt numVertices, PetscInt NVertices, PetscInt numCorners, const PetscInt cells[], PetscSF *vertexSF, PetscInt **verticesAdjSaved)
4764d71ae5a4SJacob Faibussowitsch {
47652464107aSksagiyam   PetscSF     sfPoint;
47662464107aSksagiyam   PetscLayout layout;
476782fb893eSVaclav Hapla   PetscInt    numVerticesAdj, *verticesAdj, *cones, c, p;
4768a47d0d45SMatthew G. Knepley 
4769a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
477025b6865aSVaclav Hapla   PetscValidLogicalCollectiveInt(dm, NVertices, 4);
47719566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
477225b6865aSVaclav Hapla   /* Get/check global number of vertices */
477325b6865aSVaclav Hapla   {
477425b6865aSVaclav Hapla     PetscInt       NVerticesInCells, i;
477525b6865aSVaclav Hapla     const PetscInt len = numCells * numCorners;
477625b6865aSVaclav Hapla 
477725b6865aSVaclav Hapla     /* NVerticesInCells = max(cells) + 1 */
477825b6865aSVaclav Hapla     NVerticesInCells = PETSC_MIN_INT;
47799371c9d4SSatish Balay     for (i = 0; i < len; i++)
47809371c9d4SSatish Balay       if (cells[i] > NVerticesInCells) NVerticesInCells = cells[i];
478125b6865aSVaclav Hapla     ++NVerticesInCells;
4782712fec58SPierre Jolivet     PetscCall(MPIU_Allreduce(MPI_IN_PLACE, &NVerticesInCells, 1, MPIU_INT, MPI_MAX, PetscObjectComm((PetscObject)dm)));
478325b6865aSVaclav Hapla 
478425b6865aSVaclav Hapla     if (numVertices == PETSC_DECIDE && NVertices == PETSC_DECIDE) NVertices = NVerticesInCells;
47859371c9d4SSatish Balay     else
47869371c9d4SSatish 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);
478725b6865aSVaclav Hapla   }
47889079aca8SVaclav Hapla   /* Count locally unique vertices */
47899079aca8SVaclav Hapla   {
47909079aca8SVaclav Hapla     PetscHSetI vhash;
47919079aca8SVaclav Hapla     PetscInt   off = 0;
47929079aca8SVaclav Hapla 
47939566063dSJacob Faibussowitsch     PetscCall(PetscHSetICreate(&vhash));
4794a47d0d45SMatthew G. Knepley     for (c = 0; c < numCells; ++c) {
479548a46eb9SPierre Jolivet       for (p = 0; p < numCorners; ++p) PetscCall(PetscHSetIAdd(vhash, cells[c * numCorners + p]));
4796a47d0d45SMatthew G. Knepley     }
47979566063dSJacob Faibussowitsch     PetscCall(PetscHSetIGetSize(vhash, &numVerticesAdj));
47989566063dSJacob Faibussowitsch     if (!verticesAdjSaved) PetscCall(PetscMalloc1(numVerticesAdj, &verticesAdj));
4799ad540459SPierre Jolivet     else verticesAdj = *verticesAdjSaved;
48009566063dSJacob Faibussowitsch     PetscCall(PetscHSetIGetElems(vhash, &off, verticesAdj));
48019566063dSJacob Faibussowitsch     PetscCall(PetscHSetIDestroy(&vhash));
480263a3b9bcSJacob Faibussowitsch     PetscCheck(off == numVerticesAdj, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid number of local vertices %" PetscInt_FMT " should be %" PetscInt_FMT, off, numVerticesAdj);
4803a47d0d45SMatthew G. Knepley   }
48049566063dSJacob Faibussowitsch   PetscCall(PetscSortInt(numVerticesAdj, verticesAdj));
4805a47d0d45SMatthew G. Knepley   /* Create cones */
48069566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, 0, numCells + numVerticesAdj));
48079566063dSJacob Faibussowitsch   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, numCorners));
48089566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm));
48099566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCones(dm, &cones));
4810a47d0d45SMatthew G. Knepley   for (c = 0; c < numCells; ++c) {
4811a47d0d45SMatthew G. Knepley     for (p = 0; p < numCorners; ++p) {
4812a47d0d45SMatthew G. Knepley       const PetscInt gv = cells[c * numCorners + p];
4813a47d0d45SMatthew G. Knepley       PetscInt       lv;
4814a47d0d45SMatthew G. Knepley 
48159079aca8SVaclav Hapla       /* Positions within verticesAdj form 0-based local vertex numbering;
48169079aca8SVaclav Hapla          we need to shift it by numCells to get correct DAG points (cells go first) */
48179566063dSJacob Faibussowitsch       PetscCall(PetscFindInt(gv, numVerticesAdj, verticesAdj, &lv));
481863a3b9bcSJacob Faibussowitsch       PetscCheck(lv >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Could not find global vertex %" PetscInt_FMT " in local connectivity", gv);
4819961cfab0SVaclav Hapla       cones[c * numCorners + p] = lv + numCells;
4820a47d0d45SMatthew G. Knepley     }
4821a47d0d45SMatthew G. Knepley   }
48222464107aSksagiyam   /* Build point sf */
48239566063dSJacob Faibussowitsch   PetscCall(PetscLayoutCreate(PetscObjectComm((PetscObject)dm), &layout));
48249566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetSize(layout, NVertices));
48259566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetLocalSize(layout, numVertices));
48269566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetBlockSize(layout, 1));
48279566063dSJacob Faibussowitsch   PetscCall(PetscSFCreateByMatchingIndices(layout, numVerticesAdj, verticesAdj, NULL, numCells, numVerticesAdj, verticesAdj, NULL, numCells, vertexSF, &sfPoint));
48289566063dSJacob Faibussowitsch   PetscCall(PetscLayoutDestroy(&layout));
48299566063dSJacob Faibussowitsch   if (!verticesAdjSaved) PetscCall(PetscFree(verticesAdj));
48309566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)sfPoint, "point SF"));
48312464107aSksagiyam   if (dm->sf) {
48322464107aSksagiyam     const char *prefix;
48332464107aSksagiyam 
48349566063dSJacob Faibussowitsch     PetscCall(PetscObjectGetOptionsPrefix((PetscObject)dm->sf, &prefix));
48359566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)sfPoint, prefix));
48362464107aSksagiyam   }
48379566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dm, sfPoint));
48389566063dSJacob Faibussowitsch   PetscCall(PetscSFDestroy(&sfPoint));
48399566063dSJacob Faibussowitsch   if (vertexSF) PetscCall(PetscObjectSetName((PetscObject)(*vertexSF), "Vertex Ownership SF"));
4840a47d0d45SMatthew G. Knepley   /* Fill in the rest of the topology structure */
48419566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
48429566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
48439566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
48443ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4845a47d0d45SMatthew G. Knepley }
4846a47d0d45SMatthew G. Knepley 
4847b09969d6SVaclav Hapla /*@C
4848a1cb98faSBarry Smith   DMPlexBuildCoordinatesFromCellListParallel - Build `DM` coordinates from a list of coordinates for each owned vertex (common mesh generator output)
4849a1cb98faSBarry Smith 
485020f4b53cSBarry Smith   Collective; No Fortran Support
4851b09969d6SVaclav Hapla 
4852b09969d6SVaclav Hapla   Input Parameters:
4853a1cb98faSBarry Smith + dm           - The `DM`
4854b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
4855a1cb98faSBarry Smith . sfVert       - `PetscSF` describing complete vertex ownership
4856b09969d6SVaclav Hapla - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
4857b09969d6SVaclav Hapla 
4858b09969d6SVaclav Hapla   Level: advanced
4859b09969d6SVaclav Hapla 
48601cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildFromCellListParallel()`
4861b09969d6SVaclav Hapla @*/
4862d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildCoordinatesFromCellListParallel(DM dm, PetscInt spaceDim, PetscSF sfVert, const PetscReal vertexCoords[])
4863d71ae5a4SJacob Faibussowitsch {
4864a47d0d45SMatthew G. Knepley   PetscSection coordSection;
4865a47d0d45SMatthew G. Knepley   Vec          coordinates;
4866a47d0d45SMatthew G. Knepley   PetscScalar *coords;
48671edcf0b2SVaclav Hapla   PetscInt     numVertices, numVerticesAdj, coordSize, v, vStart, vEnd;
4868a47d0d45SMatthew G. Knepley 
4869a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
48709566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
48719566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
48721dca8a05SBarry Smith   PetscCheck(vStart >= 0 && vEnd >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "DM is not set up properly. DMPlexBuildFromCellList() should be called first.");
48739566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, spaceDim));
48749566063dSJacob Faibussowitsch   PetscCall(PetscSFGetGraph(sfVert, &numVertices, &numVerticesAdj, NULL, NULL));
48751dca8a05SBarry 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);
48769566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
48779566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
48789566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, spaceDim));
48799566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, vStart, vEnd));
48801edcf0b2SVaclav Hapla   for (v = vStart; v < vEnd; ++v) {
48819566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, spaceDim));
48829566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, spaceDim));
4883a47d0d45SMatthew G. Knepley   }
48849566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
48859566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
48869566063dSJacob Faibussowitsch   PetscCall(VecCreate(PetscObjectComm((PetscObject)dm), &coordinates));
48879566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, spaceDim));
48889566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
48899566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
48909566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
48919566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
4892a47d0d45SMatthew G. Knepley   {
4893a47d0d45SMatthew G. Knepley     MPI_Datatype coordtype;
4894a47d0d45SMatthew G. Knepley 
4895a47d0d45SMatthew G. Knepley     /* Need a temp buffer for coords if we have complex/single */
48969566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_contiguous(spaceDim, MPIU_SCALAR, &coordtype));
48979566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_commit(&coordtype));
489821016a8bSBarry Smith #if defined(PETSC_USE_COMPLEX)
489921016a8bSBarry Smith     {
490021016a8bSBarry Smith       PetscScalar *svertexCoords;
490121016a8bSBarry Smith       PetscInt     i;
49029566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numVertices * spaceDim, &svertexCoords));
49033612f820SVaclav Hapla       for (i = 0; i < numVertices * spaceDim; i++) svertexCoords[i] = vertexCoords[i];
49049566063dSJacob Faibussowitsch       PetscCall(PetscSFBcastBegin(sfVert, coordtype, svertexCoords, coords, MPI_REPLACE));
49059566063dSJacob Faibussowitsch       PetscCall(PetscSFBcastEnd(sfVert, coordtype, svertexCoords, coords, MPI_REPLACE));
49069566063dSJacob Faibussowitsch       PetscCall(PetscFree(svertexCoords));
490721016a8bSBarry Smith     }
490821016a8bSBarry Smith #else
49099566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastBegin(sfVert, coordtype, vertexCoords, coords, MPI_REPLACE));
49109566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastEnd(sfVert, coordtype, vertexCoords, coords, MPI_REPLACE));
491121016a8bSBarry Smith #endif
49129566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_free(&coordtype));
4913a47d0d45SMatthew G. Knepley   }
49149566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
49159566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
49169566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
49179566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
49183ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4919a47d0d45SMatthew G. Knepley }
4920a47d0d45SMatthew G. Knepley 
4921c3edce3dSSatish Balay /*@
4922a1cb98faSBarry Smith   DMPlexCreateFromCellListParallelPetsc - Create distributed `DMPLEX` from a list of vertices for each cell (common mesh generator output)
4923a1cb98faSBarry Smith 
4924a1cb98faSBarry Smith   Collective
4925a47d0d45SMatthew G. Knepley 
4926a47d0d45SMatthew G. Knepley   Input Parameters:
4927a47d0d45SMatthew G. Knepley + comm         - The communicator
4928a47d0d45SMatthew G. Knepley . dim          - The topological dimension of the mesh
4929a47d0d45SMatthew G. Knepley . numCells     - The number of cells owned by this process
4930a1cb98faSBarry Smith . numVertices  - The number of vertices owned by this process, or `PETSC_DECIDE`
4931a1cb98faSBarry Smith . NVertices    - The global number of vertices, or `PETSC_DECIDE`
4932a47d0d45SMatthew G. Knepley . numCorners   - The number of vertices for each cell
4933a47d0d45SMatthew G. Knepley . interpolate  - Flag indicating that intermediate mesh entities (faces, edges) should be created automatically
4934a47d0d45SMatthew G. Knepley . cells        - An array of numCells*numCorners numbers, the global vertex numbers for each cell
4935a47d0d45SMatthew G. Knepley . spaceDim     - The spatial dimension used for coordinates
4936a47d0d45SMatthew G. Knepley - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
4937a47d0d45SMatthew G. Knepley 
4938d8d19677SJose E. Roman   Output Parameters:
4939a1cb98faSBarry Smith + dm          - The `DM`
4940a1cb98faSBarry Smith . vertexSF    - (Optional) `PetscSF` describing complete vertex ownership
494160225df5SJacob Faibussowitsch - verticesAdj - (Optional) vertex adjacency array
4942a47d0d45SMatthew G. Knepley 
4943b09969d6SVaclav Hapla   Level: intermediate
4944a47d0d45SMatthew G. Knepley 
4945a1cb98faSBarry Smith   Notes:
4946a1cb98faSBarry Smith   This function is just a convenient sequence of `DMCreate()`, `DMSetType()`, `DMSetDimension()`,
4947a1cb98faSBarry Smith   `DMPlexBuildFromCellListParallel()`, `DMPlexInterpolate()`, `DMPlexBuildCoordinatesFromCellListParallel()`
4948a1cb98faSBarry Smith 
4949a1cb98faSBarry Smith   See `DMPlexBuildFromCellListParallel()` for an example and details about the topology-related parameters.
4950a1cb98faSBarry Smith 
4951a1cb98faSBarry Smith   See `DMPlexBuildCoordinatesFromCellListParallel()` for details about the geometry-related parameters.
4952a1cb98faSBarry Smith 
49531cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListPetsc()`, `DMPlexBuildFromCellListParallel()`, `DMPlexBuildCoordinatesFromCellListParallel()`, `DMPlexCreateFromDAG()`, `DMPlexCreate()`
4954a47d0d45SMatthew G. Knepley @*/
4955d71ae5a4SJacob 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)
4956d71ae5a4SJacob Faibussowitsch {
4957a47d0d45SMatthew G. Knepley   PetscSF sfVert;
4958a47d0d45SMatthew G. Knepley 
4959a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
49609566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
49619566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
4962a47d0d45SMatthew G. Knepley   PetscValidLogicalCollectiveInt(*dm, dim, 2);
4963064a246eSJacob Faibussowitsch   PetscValidLogicalCollectiveInt(*dm, spaceDim, 9);
49649566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
49659566063dSJacob Faibussowitsch   PetscCall(DMPlexBuildFromCellListParallel(*dm, numCells, numVertices, NVertices, numCorners, cells, &sfVert, verticesAdj));
4966a47d0d45SMatthew G. Knepley   if (interpolate) {
49675fd9971aSMatthew G. Knepley     DM idm;
4968a47d0d45SMatthew G. Knepley 
49699566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
49709566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
4971a47d0d45SMatthew G. Knepley     *dm = idm;
4972a47d0d45SMatthew G. Knepley   }
49739566063dSJacob Faibussowitsch   PetscCall(DMPlexBuildCoordinatesFromCellListParallel(*dm, spaceDim, sfVert, vertexCoords));
497418d54ad4SMichael Lange   if (vertexSF) *vertexSF = sfVert;
49759566063dSJacob Faibussowitsch   else PetscCall(PetscSFDestroy(&sfVert));
49763ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4977a47d0d45SMatthew G. Knepley }
4978a47d0d45SMatthew G. Knepley 
4979b09969d6SVaclav Hapla /*@C
4980a1cb98faSBarry Smith   DMPlexBuildFromCellList - Build `DMPLEX` topology from a list of vertices for each cell (common mesh generator output)
4981a1cb98faSBarry Smith 
498220f4b53cSBarry Smith   Collective; No Fortran Support
49839298eaa6SMatthew G Knepley 
49849298eaa6SMatthew G Knepley   Input Parameters:
4985a1cb98faSBarry Smith + dm          - The `DM`
4986b09969d6SVaclav Hapla . numCells    - The number of cells owned by this process
4987a1cb98faSBarry Smith . numVertices - The number of vertices owned by this process, or `PETSC_DETERMINE`
49889298eaa6SMatthew G Knepley . numCorners  - The number of vertices for each cell
49895e488331SVaclav Hapla - cells       - An array of numCells*numCorners numbers, the global vertex numbers for each cell
49909298eaa6SMatthew G Knepley 
4991b09969d6SVaclav Hapla   Level: advanced
49929298eaa6SMatthew G Knepley 
4993b09969d6SVaclav Hapla   Notes:
4994b09969d6SVaclav Hapla   Two triangles sharing a face
4995a1cb98faSBarry Smith .vb
49969298eaa6SMatthew G Knepley 
4997a1cb98faSBarry Smith         2
4998a1cb98faSBarry Smith       / | \
4999a1cb98faSBarry Smith      /  |  \
5000a1cb98faSBarry Smith     /   |   \
5001a1cb98faSBarry Smith    0  0 | 1  3
5002a1cb98faSBarry Smith     \   |   /
5003a1cb98faSBarry Smith      \  |  /
5004a1cb98faSBarry Smith       \ | /
5005a1cb98faSBarry Smith         1
5006a1cb98faSBarry Smith .ve
5007a1cb98faSBarry Smith   would have input
5008a1cb98faSBarry Smith .vb
5009a1cb98faSBarry Smith   numCells = 2, numVertices = 4
5010a1cb98faSBarry Smith   cells = [0 1 2  1 3 2]
5011a1cb98faSBarry Smith .ve
5012a1cb98faSBarry Smith   which would result in the `DMPLEX`
5013a1cb98faSBarry Smith .vb
5014a1cb98faSBarry Smith 
5015a1cb98faSBarry Smith         4
5016a1cb98faSBarry Smith       / | \
5017a1cb98faSBarry Smith      /  |  \
5018a1cb98faSBarry Smith     /   |   \
5019a1cb98faSBarry Smith    2  0 | 1  5
5020a1cb98faSBarry Smith     \   |   /
5021a1cb98faSBarry Smith      \  |  /
5022a1cb98faSBarry Smith       \ | /
5023a1cb98faSBarry Smith         3
5024a1cb98faSBarry Smith .ve
5025a1cb98faSBarry Smith 
5026a1cb98faSBarry Smith   If numVertices is `PETSC_DETERMINE`, it is computed by PETSc as the maximum vertex index in cells + 1.
502725b6865aSVaclav Hapla 
50281cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildFromCellListParallel()`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromCellListPetsc()`
5029b09969d6SVaclav Hapla @*/
5030d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildFromCellList(DM dm, PetscInt numCells, PetscInt numVertices, PetscInt numCorners, const PetscInt cells[])
5031d71ae5a4SJacob Faibussowitsch {
5032961cfab0SVaclav Hapla   PetscInt *cones, c, p, dim;
5033b09969d6SVaclav Hapla 
5034b09969d6SVaclav Hapla   PetscFunctionBegin;
50359566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
50369566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
503725b6865aSVaclav Hapla   /* Get/check global number of vertices */
503825b6865aSVaclav Hapla   {
503925b6865aSVaclav Hapla     PetscInt       NVerticesInCells, i;
504025b6865aSVaclav Hapla     const PetscInt len = numCells * numCorners;
504125b6865aSVaclav Hapla 
504225b6865aSVaclav Hapla     /* NVerticesInCells = max(cells) + 1 */
504325b6865aSVaclav Hapla     NVerticesInCells = PETSC_MIN_INT;
50449371c9d4SSatish Balay     for (i = 0; i < len; i++)
50459371c9d4SSatish Balay       if (cells[i] > NVerticesInCells) NVerticesInCells = cells[i];
504625b6865aSVaclav Hapla     ++NVerticesInCells;
504725b6865aSVaclav Hapla 
504825b6865aSVaclav Hapla     if (numVertices == PETSC_DECIDE) numVertices = NVerticesInCells;
50499371c9d4SSatish Balay     else
50509371c9d4SSatish 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);
505125b6865aSVaclav Hapla   }
50529566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
505348a46eb9SPierre Jolivet   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, numCorners));
50549566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm));
50559566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCones(dm, &cones));
5056b09969d6SVaclav Hapla   for (c = 0; c < numCells; ++c) {
5057ad540459SPierre Jolivet     for (p = 0; p < numCorners; ++p) cones[c * numCorners + p] = cells[c * numCorners + p] + numCells;
5058b09969d6SVaclav Hapla   }
50599566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
50609566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
50619566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
50623ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5063b09969d6SVaclav Hapla }
5064b09969d6SVaclav Hapla 
5065b09969d6SVaclav Hapla /*@C
5066a1cb98faSBarry Smith   DMPlexBuildCoordinatesFromCellList - Build `DM` coordinates from a list of coordinates for each owned vertex (common mesh generator output)
5067a1cb98faSBarry Smith 
506820f4b53cSBarry Smith   Collective; No Fortran Support
5069b09969d6SVaclav Hapla 
5070b09969d6SVaclav Hapla   Input Parameters:
5071a1cb98faSBarry Smith + dm           - The `DM`
5072b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
5073b09969d6SVaclav Hapla - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
5074b09969d6SVaclav Hapla 
5075b09969d6SVaclav Hapla   Level: advanced
5076b09969d6SVaclav Hapla 
50771cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildCoordinatesFromCellListParallel()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexBuildFromCellList()`
5078b09969d6SVaclav Hapla @*/
5079d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildCoordinatesFromCellList(DM dm, PetscInt spaceDim, const PetscReal vertexCoords[])
5080d71ae5a4SJacob Faibussowitsch {
5081b09969d6SVaclav Hapla   PetscSection coordSection;
5082b09969d6SVaclav Hapla   Vec          coordinates;
5083b09969d6SVaclav Hapla   DM           cdm;
5084b09969d6SVaclav Hapla   PetscScalar *coords;
50851edcf0b2SVaclav Hapla   PetscInt     v, vStart, vEnd, d;
5086b09969d6SVaclav Hapla 
5087b09969d6SVaclav Hapla   PetscFunctionBegin;
50889566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
50899566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
50901dca8a05SBarry Smith   PetscCheck(vStart >= 0 && vEnd >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "DM is not set up properly. DMPlexBuildFromCellList() should be called first.");
50919566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, spaceDim));
50929566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
50939566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
50949566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, spaceDim));
50959566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, vStart, vEnd));
50961edcf0b2SVaclav Hapla   for (v = vStart; v < vEnd; ++v) {
50979566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, spaceDim));
50989566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, spaceDim));
5099b09969d6SVaclav Hapla   }
51009566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
5101b09969d6SVaclav Hapla 
51029566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dm, &cdm));
51039566063dSJacob Faibussowitsch   PetscCall(DMCreateLocalVector(cdm, &coordinates));
51049566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, spaceDim));
51059566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
51069566063dSJacob Faibussowitsch   PetscCall(VecGetArrayWrite(coordinates, &coords));
51071edcf0b2SVaclav Hapla   for (v = 0; v < vEnd - vStart; ++v) {
5108ad540459SPierre Jolivet     for (d = 0; d < spaceDim; ++d) coords[v * spaceDim + d] = vertexCoords[v * spaceDim + d];
5109b09969d6SVaclav Hapla   }
51109566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayWrite(coordinates, &coords));
51119566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
51129566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
51139566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
51143ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5115b09969d6SVaclav Hapla }
5116b09969d6SVaclav Hapla 
5117b09969d6SVaclav Hapla /*@
5118a1cb98faSBarry Smith   DMPlexCreateFromCellListPetsc - Create `DMPLEX` from a list of vertices for each cell (common mesh generator output), but only process 0 takes in the input
51193df08285SMatthew G. Knepley 
5120a1cb98faSBarry Smith   Collective
5121b09969d6SVaclav Hapla 
5122b09969d6SVaclav Hapla   Input Parameters:
5123b09969d6SVaclav Hapla + comm         - The communicator
5124b09969d6SVaclav Hapla . dim          - The topological dimension of the mesh
51253df08285SMatthew G. Knepley . numCells     - The number of cells, only on process 0
5126a1cb98faSBarry Smith . numVertices  - The number of vertices owned by this process, or `PETSC_DECIDE`, only on process 0
51273df08285SMatthew G. Knepley . numCorners   - The number of vertices for each cell, only on process 0
5128b09969d6SVaclav Hapla . interpolate  - Flag indicating that intermediate mesh entities (faces, edges) should be created automatically
51293df08285SMatthew G. Knepley . cells        - An array of numCells*numCorners numbers, the vertices for each cell, only on process 0
5130b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
51313df08285SMatthew G. Knepley - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex, only on process 0
5132b09969d6SVaclav Hapla 
5133b09969d6SVaclav Hapla   Output Parameter:
5134a1cb98faSBarry Smith . dm - The `DM`, which only has points on process 0
513525b6865aSVaclav Hapla 
5136b09969d6SVaclav Hapla   Level: intermediate
5137b09969d6SVaclav Hapla 
5138a1cb98faSBarry Smith   Notes:
5139a1cb98faSBarry Smith   This function is just a convenient sequence of `DMCreate()`, `DMSetType()`, `DMSetDimension()`, `DMPlexBuildFromCellList()`,
5140a1cb98faSBarry Smith   `DMPlexInterpolate()`, `DMPlexBuildCoordinatesFromCellList()`
5141a1cb98faSBarry Smith 
5142a1cb98faSBarry Smith   See `DMPlexBuildFromCellList()` for an example and details about the topology-related parameters.
5143a1cb98faSBarry Smith   See `DMPlexBuildCoordinatesFromCellList()` for details about the geometry-related parameters.
5144a1cb98faSBarry Smith   See `DMPlexCreateFromCellListParallelPetsc()` for parallel input
5145a1cb98faSBarry Smith 
51461cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildFromCellList()`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromDAG()`, `DMPlexCreate()`
51479298eaa6SMatthew G Knepley @*/
5148d71ae5a4SJacob 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)
5149d71ae5a4SJacob Faibussowitsch {
51503df08285SMatthew G. Knepley   PetscMPIInt rank;
51519298eaa6SMatthew G Knepley 
51529298eaa6SMatthew G Knepley   PetscFunctionBegin;
515328b400f6SJacob 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.");
51549566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
51559566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
51569566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
51579566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
5158c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildFromCellList(*dm, numCells, numVertices, numCorners, cells));
51599566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildFromCellList(*dm, 0, 0, 0, NULL));
51609298eaa6SMatthew G Knepley   if (interpolate) {
51615fd9971aSMatthew G. Knepley     DM idm;
51629298eaa6SMatthew G Knepley 
51639566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
51649566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
51659298eaa6SMatthew G Knepley     *dm = idm;
51669298eaa6SMatthew G Knepley   }
5167c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildCoordinatesFromCellList(*dm, spaceDim, vertexCoords));
51689566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildCoordinatesFromCellList(*dm, spaceDim, NULL));
51693ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
51709298eaa6SMatthew G Knepley }
51719298eaa6SMatthew G Knepley 
5172939f6067SMatthew G. Knepley /*@
517320f4b53cSBarry Smith   DMPlexCreateFromDAG - This takes as input the adjacency-list representation of the Directed Acyclic Graph (Hasse Diagram) encoding a mesh, and produces a `DM`
5174939f6067SMatthew G. Knepley 
5175939f6067SMatthew G. Knepley   Input Parameters:
517620f4b53cSBarry Smith + dm               - The empty `DM` object, usually from `DMCreate()` and `DMSetDimension()`
5177939f6067SMatthew G. Knepley . depth            - The depth of the DAG
517820f4b53cSBarry Smith . numPoints        - Array of size depth + 1 containing the number of points at each `depth`
5179939f6067SMatthew G. Knepley . coneSize         - The cone size of each point
5180939f6067SMatthew G. Knepley . cones            - The concatenation of the cone points for each point, the cone list must be oriented correctly for each point
5181939f6067SMatthew G. Knepley . coneOrientations - The orientation of each cone point
518220f4b53cSBarry Smith - vertexCoords     - An array of `numPoints`[0]*spacedim numbers representing the coordinates of each vertex, with spacedim the value set via `DMSetCoordinateDim()`
5183939f6067SMatthew G. Knepley 
5184939f6067SMatthew G. Knepley   Output Parameter:
518520f4b53cSBarry Smith . dm - The `DM`
518620f4b53cSBarry Smith 
518720f4b53cSBarry Smith   Level: advanced
5188939f6067SMatthew G. Knepley 
5189a1cb98faSBarry Smith   Note:
5190a1cb98faSBarry Smith   Two triangles sharing a face would have input
5191a1cb98faSBarry Smith .vb
5192a1cb98faSBarry Smith   depth = 1, numPoints = [4 2], coneSize = [3 3 0 0 0 0]
5193a1cb98faSBarry Smith   cones = [2 3 4  3 5 4], coneOrientations = [0 0 0  0 0 0]
5194a1cb98faSBarry Smith  vertexCoords = [-1.0 0.0  0.0 -1.0  0.0 1.0  1.0 0.0]
5195a1cb98faSBarry Smith .ve
5196939f6067SMatthew G. Knepley   which would result in the DMPlex
5197a1cb98faSBarry Smith .vb
5198a1cb98faSBarry Smith         4
5199a1cb98faSBarry Smith       / | \
5200a1cb98faSBarry Smith      /  |  \
5201a1cb98faSBarry Smith     /   |   \
5202a1cb98faSBarry Smith    2  0 | 1  5
5203a1cb98faSBarry Smith     \   |   /
5204a1cb98faSBarry Smith      \  |  /
5205a1cb98faSBarry Smith       \ | /
5206a1cb98faSBarry Smith         3
5207a1cb98faSBarry Smith .ve
5208a1cb98faSBarry Smith   Notice that all points are numbered consecutively, unlike `DMPlexCreateFromCellListPetsc()`
5209939f6067SMatthew G. Knepley 
52101cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`
5211939f6067SMatthew G. Knepley @*/
5212d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateFromDAG(DM dm, PetscInt depth, const PetscInt numPoints[], const PetscInt coneSize[], const PetscInt cones[], const PetscInt coneOrientations[], const PetscScalar vertexCoords[])
5213d71ae5a4SJacob Faibussowitsch {
52149298eaa6SMatthew G Knepley   Vec          coordinates;
52159298eaa6SMatthew G Knepley   PetscSection coordSection;
52169298eaa6SMatthew G Knepley   PetscScalar *coords;
5217811e8653SToby Isaac   PetscInt     coordSize, firstVertex = -1, pStart = 0, pEnd = 0, p, v, dim, dimEmbed, d, off;
52189298eaa6SMatthew G Knepley 
52199298eaa6SMatthew G Knepley   PetscFunctionBegin;
52209566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
52219566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &dimEmbed));
522263a3b9bcSJacob Faibussowitsch   PetscCheck(dimEmbed >= dim, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Embedding dimension %" PetscInt_FMT " cannot be less than intrinsic dimension %" PetscInt_FMT, dimEmbed, dim);
52239298eaa6SMatthew G Knepley   for (d = 0; d <= depth; ++d) pEnd += numPoints[d];
52249566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, pStart, pEnd));
52259298eaa6SMatthew G Knepley   for (p = pStart; p < pEnd; ++p) {
52269566063dSJacob Faibussowitsch     PetscCall(DMPlexSetConeSize(dm, p, coneSize[p - pStart]));
5227ad540459SPierre Jolivet     if (firstVertex < 0 && !coneSize[p - pStart]) firstVertex = p - pStart;
522897e052ccSToby Isaac   }
52291dca8a05SBarry Smith   PetscCheck(firstVertex >= 0 || !numPoints[0], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Expected %" PetscInt_FMT " vertices but could not find any", numPoints[0]);
52309566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm)); /* Allocate space for cones */
52319298eaa6SMatthew G Knepley   for (p = pStart, off = 0; p < pEnd; off += coneSize[p - pStart], ++p) {
52329566063dSJacob Faibussowitsch     PetscCall(DMPlexSetCone(dm, p, &cones[off]));
52339566063dSJacob Faibussowitsch     PetscCall(DMPlexSetConeOrientation(dm, p, &coneOrientations[off]));
52349298eaa6SMatthew G Knepley   }
52359566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
52369566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
52379298eaa6SMatthew G Knepley   /* Build coordinates */
52389566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
52399566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
52409566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dimEmbed));
52419566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numPoints[0]));
52429298eaa6SMatthew G Knepley   for (v = firstVertex; v < firstVertex + numPoints[0]; ++v) {
52439566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, dimEmbed));
52449566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dimEmbed));
52459298eaa6SMatthew G Knepley   }
52469566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
52479566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
52489566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
52499566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
52509566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
52519566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, dimEmbed));
52529566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
52539318fe57SMatthew G. Knepley   if (vertexCoords) {
52549566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
52559298eaa6SMatthew G Knepley     for (v = 0; v < numPoints[0]; ++v) {
52569298eaa6SMatthew G Knepley       PetscInt off;
52579298eaa6SMatthew G Knepley 
52589566063dSJacob Faibussowitsch       PetscCall(PetscSectionGetOffset(coordSection, v + firstVertex, &off));
5259ad540459SPierre Jolivet       for (d = 0; d < dimEmbed; ++d) coords[off + d] = vertexCoords[v * dimEmbed + d];
52609298eaa6SMatthew G Knepley     }
52619318fe57SMatthew G. Knepley   }
52629566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
52639566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
52649566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
52653ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
52669298eaa6SMatthew G Knepley }
52678415267dSToby Isaac 
5268a4e35b19SJacob Faibussowitsch /*
5269a1cb98faSBarry Smith   DMPlexCreateCellVertexFromFile - Create a `DMPLEX` mesh from a simple cell-vertex file.
5270a1cb98faSBarry Smith 
5271a1cb98faSBarry Smith   Collective
52728ca92349SMatthew G. Knepley 
52738ca92349SMatthew G. Knepley + comm        - The MPI communicator
52748ca92349SMatthew G. Knepley . filename    - Name of the .dat file
52758ca92349SMatthew G. Knepley - interpolate - Create faces and edges in the mesh
52768ca92349SMatthew G. Knepley 
52778ca92349SMatthew G. Knepley   Output Parameter:
5278a1cb98faSBarry Smith . dm  - The `DM` object representing the mesh
52798ca92349SMatthew G. Knepley 
52808ca92349SMatthew G. Knepley   Level: beginner
52818ca92349SMatthew G. Knepley 
5282a1cb98faSBarry Smith   Note:
5283a1cb98faSBarry Smith   The format is the simplest possible:
5284a1cb98faSBarry Smith .vb
5285a1cb98faSBarry Smith   Ne
5286a1cb98faSBarry Smith   v0 v1 ... vk
5287a1cb98faSBarry Smith   Nv
5288a1cb98faSBarry Smith   x y z marker
5289a1cb98faSBarry Smith .ve
5290a1cb98faSBarry Smith 
5291a1cb98faSBarry Smith   Developer Note:
5292a1cb98faSBarry Smith   Should use a `PetscViewer` not a filename
5293a1cb98faSBarry Smith 
52941cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromFile()`, `DMPlexCreateMedFromFile()`, `DMPlexCreateGmsh()`, `DMPlexCreate()`
5295a4e35b19SJacob Faibussowitsch */
5296ff6a9541SJacob Faibussowitsch static PetscErrorCode DMPlexCreateCellVertexFromFile(MPI_Comm comm, const char filename[], PetscBool interpolate, DM *dm)
5297d71ae5a4SJacob Faibussowitsch {
52988ca92349SMatthew G. Knepley   DMLabel      marker;
52998ca92349SMatthew G. Knepley   PetscViewer  viewer;
53008ca92349SMatthew G. Knepley   Vec          coordinates;
53018ca92349SMatthew G. Knepley   PetscSection coordSection;
53028ca92349SMatthew G. Knepley   PetscScalar *coords;
53038ca92349SMatthew G. Knepley   char         line[PETSC_MAX_PATH_LEN];
53048ca92349SMatthew G. Knepley   PetscInt     dim = 3, cdim = 3, coordSize, v, c, d;
53058ca92349SMatthew G. Knepley   PetscMPIInt  rank;
5306f8d5e320SMatthew G. Knepley   int          snum, Nv, Nc, Ncn, Nl;
53078ca92349SMatthew G. Knepley 
53088ca92349SMatthew G. Knepley   PetscFunctionBegin;
53099566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
53109566063dSJacob Faibussowitsch   PetscCall(PetscViewerCreate(comm, &viewer));
53119566063dSJacob Faibussowitsch   PetscCall(PetscViewerSetType(viewer, PETSCVIEWERASCII));
53129566063dSJacob Faibussowitsch   PetscCall(PetscViewerFileSetMode(viewer, FILE_MODE_READ));
53139566063dSJacob Faibussowitsch   PetscCall(PetscViewerFileSetName(viewer, filename));
5314dd400576SPatrick Sanan   if (rank == 0) {
53159566063dSJacob Faibussowitsch     PetscCall(PetscViewerRead(viewer, line, 4, NULL, PETSC_STRING));
5316f8d5e320SMatthew G. Knepley     snum = sscanf(line, "%d %d %d %d", &Nc, &Nv, &Ncn, &Nl);
531708401ef6SPierre Jolivet     PetscCheck(snum == 4, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
531825ce1634SJed Brown   } else {
5319f8d5e320SMatthew G. Knepley     Nc = Nv = Ncn = Nl = 0;
53208ca92349SMatthew G. Knepley   }
53219566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
53229566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
53239566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(*dm, 0, Nc + Nv));
53249566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
53259566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(*dm, cdim));
53268ca92349SMatthew G. Knepley   /* Read topology */
5327dd400576SPatrick Sanan   if (rank == 0) {
5328f8d5e320SMatthew G. Knepley     char     format[PETSC_MAX_PATH_LEN];
5329f8d5e320SMatthew G. Knepley     PetscInt cone[8];
53308ca92349SMatthew G. Knepley     int      vbuf[8], v;
53318ca92349SMatthew G. Knepley 
53329371c9d4SSatish Balay     for (c = 0; c < Ncn; ++c) {
53339371c9d4SSatish Balay       format[c * 3 + 0] = '%';
53349371c9d4SSatish Balay       format[c * 3 + 1] = 'd';
53359371c9d4SSatish Balay       format[c * 3 + 2] = ' ';
53369371c9d4SSatish Balay     }
5337f8d5e320SMatthew G. Knepley     format[Ncn * 3 - 1] = '\0';
53389566063dSJacob Faibussowitsch     for (c = 0; c < Nc; ++c) PetscCall(DMPlexSetConeSize(*dm, c, Ncn));
53399566063dSJacob Faibussowitsch     PetscCall(DMSetUp(*dm));
53408ca92349SMatthew G. Knepley     for (c = 0; c < Nc; ++c) {
53419566063dSJacob Faibussowitsch       PetscCall(PetscViewerRead(viewer, line, Ncn, NULL, PETSC_STRING));
5342f8d5e320SMatthew G. Knepley       switch (Ncn) {
5343d71ae5a4SJacob Faibussowitsch       case 2:
5344d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1]);
5345d71ae5a4SJacob Faibussowitsch         break;
5346d71ae5a4SJacob Faibussowitsch       case 3:
5347d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2]);
5348d71ae5a4SJacob Faibussowitsch         break;
5349d71ae5a4SJacob Faibussowitsch       case 4:
5350d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3]);
5351d71ae5a4SJacob Faibussowitsch         break;
5352d71ae5a4SJacob Faibussowitsch       case 6:
5353d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3], &vbuf[4], &vbuf[5]);
5354d71ae5a4SJacob Faibussowitsch         break;
5355d71ae5a4SJacob Faibussowitsch       case 8:
5356d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3], &vbuf[4], &vbuf[5], &vbuf[6], &vbuf[7]);
5357d71ae5a4SJacob Faibussowitsch         break;
5358d71ae5a4SJacob Faibussowitsch       default:
5359d71ae5a4SJacob Faibussowitsch         SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "No cell shape with %d vertices", Ncn);
5360f8d5e320SMatthew G. Knepley       }
536108401ef6SPierre Jolivet       PetscCheck(snum == Ncn, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
5362f8d5e320SMatthew G. Knepley       for (v = 0; v < Ncn; ++v) cone[v] = vbuf[v] + Nc;
53638ca92349SMatthew G. Knepley       /* Hexahedra are inverted */
5364f8d5e320SMatthew G. Knepley       if (Ncn == 8) {
53658ca92349SMatthew G. Knepley         PetscInt tmp = cone[1];
53668ca92349SMatthew G. Knepley         cone[1]      = cone[3];
53678ca92349SMatthew G. Knepley         cone[3]      = tmp;
53688ca92349SMatthew G. Knepley       }
53699566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCone(*dm, c, cone));
53708ca92349SMatthew G. Knepley     }
53718ca92349SMatthew G. Knepley   }
53729566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(*dm));
53739566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(*dm));
53748ca92349SMatthew G. Knepley   /* Read coordinates */
53759566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(*dm, &coordSection));
53769566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
53779566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, cdim));
53789566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, Nc, Nc + Nv));
53798ca92349SMatthew G. Knepley   for (v = Nc; v < Nc + Nv; ++v) {
53809566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, cdim));
53819566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, cdim));
53828ca92349SMatthew G. Knepley   }
53839566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
53849566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
53859566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
53869566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
53879566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
53889566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, cdim));
53899566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
53909566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
5391dd400576SPatrick Sanan   if (rank == 0) {
5392f8d5e320SMatthew G. Knepley     char   format[PETSC_MAX_PATH_LEN];
53938ca92349SMatthew G. Knepley     double x[3];
5394f8d5e320SMatthew G. Knepley     int    l, val[3];
53958ca92349SMatthew G. Knepley 
5396f8d5e320SMatthew G. Knepley     if (Nl) {
53979371c9d4SSatish Balay       for (l = 0; l < Nl; ++l) {
53989371c9d4SSatish Balay         format[l * 3 + 0] = '%';
53999371c9d4SSatish Balay         format[l * 3 + 1] = 'd';
54009371c9d4SSatish Balay         format[l * 3 + 2] = ' ';
54019371c9d4SSatish Balay       }
5402f8d5e320SMatthew G. Knepley       format[Nl * 3 - 1] = '\0';
54039566063dSJacob Faibussowitsch       PetscCall(DMCreateLabel(*dm, "marker"));
54049566063dSJacob Faibussowitsch       PetscCall(DMGetLabel(*dm, "marker", &marker));
5405f8d5e320SMatthew G. Knepley     }
54068ca92349SMatthew G. Knepley     for (v = 0; v < Nv; ++v) {
54079566063dSJacob Faibussowitsch       PetscCall(PetscViewerRead(viewer, line, 3 + Nl, NULL, PETSC_STRING));
5408f8d5e320SMatthew G. Knepley       snum = sscanf(line, "%lg %lg %lg", &x[0], &x[1], &x[2]);
540908401ef6SPierre Jolivet       PetscCheck(snum == 3, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
5410f8d5e320SMatthew G. Knepley       switch (Nl) {
5411d71ae5a4SJacob Faibussowitsch       case 0:
5412d71ae5a4SJacob Faibussowitsch         snum = 0;
5413d71ae5a4SJacob Faibussowitsch         break;
5414d71ae5a4SJacob Faibussowitsch       case 1:
5415d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0]);
5416d71ae5a4SJacob Faibussowitsch         break;
5417d71ae5a4SJacob Faibussowitsch       case 2:
5418d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0], &val[1]);
5419d71ae5a4SJacob Faibussowitsch         break;
5420d71ae5a4SJacob Faibussowitsch       case 3:
5421d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0], &val[1], &val[2]);
5422d71ae5a4SJacob Faibussowitsch         break;
5423d71ae5a4SJacob Faibussowitsch       default:
5424d71ae5a4SJacob Faibussowitsch         SETERRQ(PETSC_COMM_SELF, PETSC_ERR_SUP, "Request support for %d labels", Nl);
5425f8d5e320SMatthew G. Knepley       }
542608401ef6SPierre Jolivet       PetscCheck(snum == Nl, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
54278ca92349SMatthew G. Knepley       for (d = 0; d < cdim; ++d) coords[v * cdim + d] = x[d];
54289566063dSJacob Faibussowitsch       for (l = 0; l < Nl; ++l) PetscCall(DMLabelSetValue(marker, v + Nc, val[l]));
54298ca92349SMatthew G. Knepley     }
54308ca92349SMatthew G. Knepley   }
54319566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
54329566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(*dm, coordinates));
54339566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
54349566063dSJacob Faibussowitsch   PetscCall(PetscViewerDestroy(&viewer));
54358ca92349SMatthew G. Knepley   if (interpolate) {
54368ca92349SMatthew G. Knepley     DM      idm;
54378ca92349SMatthew G. Knepley     DMLabel bdlabel;
54388ca92349SMatthew G. Knepley 
54399566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
54409566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
54418ca92349SMatthew G. Knepley     *dm = idm;
54428ca92349SMatthew G. Knepley 
5443f8d5e320SMatthew G. Knepley     if (!Nl) {
54449566063dSJacob Faibussowitsch       PetscCall(DMCreateLabel(*dm, "marker"));
54459566063dSJacob Faibussowitsch       PetscCall(DMGetLabel(*dm, "marker", &bdlabel));
54469566063dSJacob Faibussowitsch       PetscCall(DMPlexMarkBoundaryFaces(*dm, PETSC_DETERMINE, bdlabel));
54479566063dSJacob Faibussowitsch       PetscCall(DMPlexLabelComplete(*dm, bdlabel));
54488ca92349SMatthew G. Knepley     }
5449f8d5e320SMatthew G. Knepley   }
54503ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
54518ca92349SMatthew G. Knepley }
54528ca92349SMatthew G. Knepley 
54538ca92349SMatthew G. Knepley /*@C
5454a1cb98faSBarry Smith   DMPlexCreateFromFile - This takes a filename and produces a `DM`
5455a1cb98faSBarry Smith 
5456a1cb98faSBarry Smith   Collective
5457ca522641SMatthew G. Knepley 
5458ca522641SMatthew G. Knepley   Input Parameters:
5459ca522641SMatthew G. Knepley + comm        - The communicator
5460ca522641SMatthew G. Knepley . filename    - A file name
5461a1cb98faSBarry Smith . plexname    - The object name of the resulting `DM`, also used for intra-datafile lookup by some formats
5462ca522641SMatthew G. Knepley - interpolate - Flag to create intermediate mesh pieces (edges, faces)
5463ca522641SMatthew G. Knepley 
5464ca522641SMatthew G. Knepley   Output Parameter:
5465a1cb98faSBarry Smith . dm - The `DM`
5466ca522641SMatthew G. Knepley 
5467a1cb98faSBarry Smith   Options Database Key:
5468a1cb98faSBarry Smith . -dm_plex_create_from_hdf5_xdmf - use the `PETSC_VIEWER_HDF5_XDMF` format for reading HDF5
546902ef0d99SVaclav Hapla 
547037fdd005SBarry Smith   Use `-dm_plex_create_ prefix` to pass options to the internal `PetscViewer`, e.g.
5471bca97951SVaclav Hapla $ -dm_plex_create_viewer_hdf5_collective
5472bca97951SVaclav Hapla 
5473ca522641SMatthew G. Knepley   Level: beginner
5474ca522641SMatthew G. Knepley 
5475a1cb98faSBarry Smith   Notes:
5476a1cb98faSBarry Smith   Using `PETSCVIEWERHDF5` type with `PETSC_VIEWER_HDF5_PETSC` format, one can save multiple `DMPLEX`
5477a1cb98faSBarry Smith   meshes in a single HDF5 file. This in turn requires one to name the `DMPLEX` object with `PetscObjectSetName()`
5478a1cb98faSBarry Smith   before saving it with `DMView()` and before loading it with `DMLoad()` for identification of the mesh object.
5479a1cb98faSBarry Smith   The input parameter name is thus used to name the `DMPLEX` object when `DMPlexCreateFromFile()` internally
5480a1cb98faSBarry Smith   calls `DMLoad()`. Currently, name is ignored for other viewer types and/or formats.
5481a1cb98faSBarry Smith 
54821cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromDAG()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`, `PetscObjectSetName()`, `DMView()`, `DMLoad()`
5483ca522641SMatthew G. Knepley @*/
5484d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateFromFile(MPI_Comm comm, const char filename[], const char plexname[], PetscBool interpolate, DM *dm)
5485d71ae5a4SJacob Faibussowitsch {
5486ef3a5affSJacob Faibussowitsch   const char  extGmsh[]      = ".msh";
5487ef3a5affSJacob Faibussowitsch   const char  extGmsh2[]     = ".msh2";
5488ef3a5affSJacob Faibussowitsch   const char  extGmsh4[]     = ".msh4";
5489ef3a5affSJacob Faibussowitsch   const char  extCGNS[]      = ".cgns";
5490ef3a5affSJacob Faibussowitsch   const char  extExodus[]    = ".exo";
5491ef3a5affSJacob Faibussowitsch   const char  extExodus_e[]  = ".e";
5492ef3a5affSJacob Faibussowitsch   const char  extGenesis[]   = ".gen";
5493ef3a5affSJacob Faibussowitsch   const char  extFluent[]    = ".cas";
5494ef3a5affSJacob Faibussowitsch   const char  extHDF5[]      = ".h5";
54956f2c871aSStefano Zampini   const char  extXDMFHDF5[]  = ".xdmf.h5";
5496ef3a5affSJacob Faibussowitsch   const char  extMed[]       = ".med";
5497ef3a5affSJacob Faibussowitsch   const char  extPLY[]       = ".ply";
5498ef3a5affSJacob Faibussowitsch   const char  extEGADSLite[] = ".egadslite";
5499ef3a5affSJacob Faibussowitsch   const char  extEGADS[]     = ".egads";
5500ef3a5affSJacob Faibussowitsch   const char  extIGES[]      = ".igs";
5501ef3a5affSJacob Faibussowitsch   const char  extSTEP[]      = ".stp";
5502ef3a5affSJacob Faibussowitsch   const char  extCV[]        = ".dat";
5503ca522641SMatthew G. Knepley   size_t      len;
55046f2c871aSStefano Zampini   PetscBool   isGmsh, isGmsh2, isGmsh4, isCGNS, isExodus, isGenesis, isFluent, isHDF5, isMed, isPLY, isEGADSLite, isEGADS, isIGES, isSTEP, isCV, isXDMFHDF5;
5505ca522641SMatthew G. Knepley   PetscMPIInt rank;
5506ca522641SMatthew G. Knepley 
5507ca522641SMatthew G. Knepley   PetscFunctionBegin;
55084f572ea9SToby Isaac   PetscAssertPointer(filename, 2);
55094f572ea9SToby Isaac   if (plexname) PetscAssertPointer(plexname, 3);
55104f572ea9SToby Isaac   PetscAssertPointer(dm, 5);
55119566063dSJacob Faibussowitsch   PetscCall(DMInitializePackage());
55129566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_CreateFromFile, 0, 0, 0, 0));
55139566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
55149566063dSJacob Faibussowitsch   PetscCall(PetscStrlen(filename, &len));
551528b400f6SJacob Faibussowitsch   PetscCheck(len, comm, PETSC_ERR_ARG_WRONG, "Filename must be a valid path");
5516ef3a5affSJacob Faibussowitsch 
55179371c9d4SSatish Balay #define CheckExtension(extension__, is_extension__) \
55189371c9d4SSatish Balay   do { \
5519274aaeaaSJacob Faibussowitsch     PetscAssert(sizeof(extension__), comm, PETSC_ERR_PLIB, "Zero-size extension: %s", extension__); \
5520274aaeaaSJacob Faibussowitsch     /* don't count the null-terminator at the end */ \
5521274aaeaaSJacob Faibussowitsch     const size_t ext_len = sizeof(extension__) - 1; \
5522274aaeaaSJacob Faibussowitsch     if (len < ext_len) { \
5523ef3a5affSJacob Faibussowitsch       is_extension__ = PETSC_FALSE; \
5524ef3a5affSJacob Faibussowitsch     } else { \
5525274aaeaaSJacob Faibussowitsch       PetscCall(PetscStrncmp(filename + len - ext_len, extension__, ext_len, &is_extension__)); \
5526ef3a5affSJacob Faibussowitsch     } \
5527ef3a5affSJacob Faibussowitsch   } while (0)
5528ef3a5affSJacob Faibussowitsch 
5529ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh, isGmsh);
5530ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh2, isGmsh2);
5531ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh4, isGmsh4);
5532ef3a5affSJacob Faibussowitsch   CheckExtension(extCGNS, isCGNS);
5533ef3a5affSJacob Faibussowitsch   CheckExtension(extExodus, isExodus);
5534ef3a5affSJacob Faibussowitsch   if (!isExodus) CheckExtension(extExodus_e, isExodus);
5535ef3a5affSJacob Faibussowitsch   CheckExtension(extGenesis, isGenesis);
5536ef3a5affSJacob Faibussowitsch   CheckExtension(extFluent, isFluent);
5537ef3a5affSJacob Faibussowitsch   CheckExtension(extHDF5, isHDF5);
5538ef3a5affSJacob Faibussowitsch   CheckExtension(extMed, isMed);
5539ef3a5affSJacob Faibussowitsch   CheckExtension(extPLY, isPLY);
5540ef3a5affSJacob Faibussowitsch   CheckExtension(extEGADSLite, isEGADSLite);
5541ef3a5affSJacob Faibussowitsch   CheckExtension(extEGADS, isEGADS);
5542ef3a5affSJacob Faibussowitsch   CheckExtension(extIGES, isIGES);
5543ef3a5affSJacob Faibussowitsch   CheckExtension(extSTEP, isSTEP);
5544ef3a5affSJacob Faibussowitsch   CheckExtension(extCV, isCV);
55456f2c871aSStefano Zampini   CheckExtension(extXDMFHDF5, isXDMFHDF5);
5546ef3a5affSJacob Faibussowitsch 
5547ef3a5affSJacob Faibussowitsch #undef CheckExtension
5548ef3a5affSJacob Faibussowitsch 
5549de78e4feSLisandro Dalcin   if (isGmsh || isGmsh2 || isGmsh4) {
55509566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateGmshFromFile(comm, filename, interpolate, dm));
5551ca522641SMatthew G. Knepley   } else if (isCGNS) {
55529566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateCGNSFromFile(comm, filename, interpolate, dm));
555390c68965SMatthew G. Knepley   } else if (isExodus || isGenesis) {
55549566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateExodusFromFile(comm, filename, interpolate, dm));
55552f0bd6dcSMichael Lange   } else if (isFluent) {
55569566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFluentFromFile(comm, filename, interpolate, dm));
5557cc2f8f65SMatthew G. Knepley   } else if (isHDF5) {
5558cc2f8f65SMatthew G. Knepley     PetscViewer viewer;
5559cc2f8f65SMatthew G. Knepley 
556043b242b4SVaclav 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 */
55616f2c871aSStefano Zampini     PetscCall(PetscOptionsGetBool(NULL, NULL, "-dm_plex_create_from_hdf5_xdmf", &isXDMFHDF5, NULL));
55629566063dSJacob Faibussowitsch     PetscCall(PetscViewerCreate(comm, &viewer));
55639566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetType(viewer, PETSCVIEWERHDF5));
55649566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetOptionsPrefix(viewer, "dm_plex_create_"));
55659566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetFromOptions(viewer));
55669566063dSJacob Faibussowitsch     PetscCall(PetscViewerFileSetMode(viewer, FILE_MODE_READ));
55679566063dSJacob Faibussowitsch     PetscCall(PetscViewerFileSetName(viewer, filename));
5568cd7e8a5eSksagiyam 
55699566063dSJacob Faibussowitsch     PetscCall(DMCreate(comm, dm));
55709566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)(*dm), plexname));
55719566063dSJacob Faibussowitsch     PetscCall(DMSetType(*dm, DMPLEX));
55726f2c871aSStefano Zampini     if (isXDMFHDF5) PetscCall(PetscViewerPushFormat(viewer, PETSC_VIEWER_HDF5_XDMF));
55739566063dSJacob Faibussowitsch     PetscCall(DMLoad(*dm, viewer));
55746f2c871aSStefano Zampini     if (isXDMFHDF5) PetscCall(PetscViewerPopFormat(viewer));
55759566063dSJacob Faibussowitsch     PetscCall(PetscViewerDestroy(&viewer));
55765fd9971aSMatthew G. Knepley 
55775fd9971aSMatthew G. Knepley     if (interpolate) {
55785fd9971aSMatthew G. Knepley       DM idm;
55795fd9971aSMatthew G. Knepley 
55809566063dSJacob Faibussowitsch       PetscCall(DMPlexInterpolate(*dm, &idm));
55819566063dSJacob Faibussowitsch       PetscCall(DMDestroy(dm));
55825fd9971aSMatthew G. Knepley       *dm = idm;
55835fd9971aSMatthew G. Knepley     }
5584707dd687SMichael Lange   } else if (isMed) {
55859566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateMedFromFile(comm, filename, interpolate, dm));
5586f2801cd6SMatthew G. Knepley   } else if (isPLY) {
55879566063dSJacob Faibussowitsch     PetscCall(DMPlexCreatePLYFromFile(comm, filename, interpolate, dm));
5588c1cad2e7SMatthew G. Knepley   } else if (isEGADSLite || isEGADS || isIGES || isSTEP) {
55899566063dSJacob Faibussowitsch     if (isEGADSLite) PetscCall(DMPlexCreateEGADSLiteFromFile(comm, filename, dm));
55909566063dSJacob Faibussowitsch     else PetscCall(DMPlexCreateEGADSFromFile(comm, filename, dm));
55917bee2925SMatthew Knepley     if (!interpolate) {
55927bee2925SMatthew Knepley       DM udm;
55937bee2925SMatthew Knepley 
55949566063dSJacob Faibussowitsch       PetscCall(DMPlexUninterpolate(*dm, &udm));
55959566063dSJacob Faibussowitsch       PetscCall(DMDestroy(dm));
55967bee2925SMatthew Knepley       *dm = udm;
55977bee2925SMatthew Knepley     }
55988ca92349SMatthew G. Knepley   } else if (isCV) {
55999566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateCellVertexFromFile(comm, filename, interpolate, dm));
560098921bdaSJacob Faibussowitsch   } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Cannot load file %s: unrecognized extension", filename);
56019566063dSJacob Faibussowitsch   PetscCall(PetscStrlen(plexname, &len));
56029566063dSJacob Faibussowitsch   if (len) PetscCall(PetscObjectSetName((PetscObject)(*dm), plexname));
56039566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_CreateFromFile, 0, 0, 0, 0));
56043ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5605ca522641SMatthew G. Knepley }
560612b8a6daSStefano Zampini 
56079f6c5813SMatthew G. Knepley /*@C
56089f6c5813SMatthew 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.
56099f6c5813SMatthew G. Knepley 
56100528010dSStefano Zampini   Input Parameters:
56110528010dSStefano Zampini + tr     - The `DMPlexTransform`
56120528010dSStefano Zampini - prefix - An options prefix, or NULL
56139f6c5813SMatthew G. Knepley 
56149f6c5813SMatthew G. Knepley   Output Parameter:
56159f6c5813SMatthew G. Knepley . dm - The `DM`
56169f6c5813SMatthew G. Knepley 
56179f6c5813SMatthew G. Knepley   Level: beginner
56189f6c5813SMatthew G. Knepley 
561920f4b53cSBarry Smith   Notes:
562020f4b53cSBarry 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.
562120f4b53cSBarry Smith 
56229f6c5813SMatthew G. Knepley .seealso: `DMPlexCreateFromFile`, `DMPlexCreateFromDAG()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`
56239f6c5813SMatthew G. Knepley @*/
56240528010dSStefano Zampini PetscErrorCode DMPlexCreateEphemeral(DMPlexTransform tr, const char prefix[], DM *dm)
56259f6c5813SMatthew G. Knepley {
56260528010dSStefano Zampini   DM           bdm, bcdm, cdm;
56270528010dSStefano Zampini   Vec          coordinates, coordinatesNew;
56280528010dSStefano Zampini   PetscSection cs;
56290528010dSStefano Zampini   PetscInt     dim, cdim, Nl;
56309f6c5813SMatthew G. Knepley 
56319f6c5813SMatthew G. Knepley   PetscFunctionBegin;
56329f6c5813SMatthew G. Knepley   PetscCall(DMCreate(PetscObjectComm((PetscObject)tr), dm));
56339f6c5813SMatthew G. Knepley   PetscCall(DMSetType(*dm, DMPLEX));
56340528010dSStefano Zampini   ((DM_Plex *)(*dm)->data)->interpolated = DMPLEX_INTERPOLATED_FULL;
56350528010dSStefano Zampini   // Handle coordinates
56360528010dSStefano Zampini   PetscCall(DMPlexTransformGetDM(tr, &bdm));
56370528010dSStefano Zampini   PetscCall(DMGetCoordinateDim(bdm, &cdim));
56380528010dSStefano Zampini   PetscCall(DMSetCoordinateDim(*dm, cdim));
56390528010dSStefano Zampini   PetscCall(DMGetDimension(bdm, &dim));
56400528010dSStefano Zampini   PetscCall(DMSetDimension(*dm, dim));
56410528010dSStefano Zampini   PetscCall(DMGetCoordinateDM(bdm, &bcdm));
56420528010dSStefano Zampini   PetscCall(DMGetCoordinateDM(*dm, &cdm));
56430528010dSStefano Zampini   PetscCall(DMCopyDisc(bcdm, cdm));
56440528010dSStefano Zampini   PetscCall(DMGetLocalSection(cdm, &cs));
56450528010dSStefano Zampini   PetscCall(PetscSectionSetNumFields(cs, 1));
56460528010dSStefano Zampini   PetscCall(PetscSectionSetFieldComponents(cs, 0, cdim));
56470528010dSStefano Zampini   PetscCall(DMGetCoordinatesLocal(bdm, &coordinates));
56480528010dSStefano Zampini   PetscCall(VecDuplicate(coordinates, &coordinatesNew));
56490528010dSStefano Zampini   PetscCall(VecCopy(coordinates, coordinatesNew));
56500528010dSStefano Zampini   PetscCall(DMSetCoordinatesLocal(*dm, coordinatesNew));
56510528010dSStefano Zampini   PetscCall(VecDestroy(&coordinatesNew));
56529f6c5813SMatthew G. Knepley 
56539f6c5813SMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)tr));
56549f6c5813SMatthew G. Knepley   PetscCall(DMPlexTransformDestroy(&((DM_Plex *)(*dm)->data)->tr));
56559f6c5813SMatthew G. Knepley   ((DM_Plex *)(*dm)->data)->tr = tr;
56560528010dSStefano Zampini   PetscCall(DMPlexDistributeSetDefault(*dm, PETSC_FALSE));
56570528010dSStefano Zampini   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)*dm, prefix));
56580528010dSStefano Zampini   PetscCall(DMSetFromOptions(*dm));
56599f6c5813SMatthew G. Knepley 
56609f6c5813SMatthew G. Knepley   PetscCall(DMGetNumLabels(bdm, &Nl));
56619f6c5813SMatthew G. Knepley   for (PetscInt l = 0; l < Nl; ++l) {
56629f6c5813SMatthew G. Knepley     DMLabel     label, labelNew;
56639f6c5813SMatthew G. Knepley     const char *lname;
56649f6c5813SMatthew G. Knepley     PetscBool   isDepth, isCellType;
56659f6c5813SMatthew G. Knepley 
56669f6c5813SMatthew G. Knepley     PetscCall(DMGetLabelName(bdm, l, &lname));
56679f6c5813SMatthew G. Knepley     PetscCall(PetscStrcmp(lname, "depth", &isDepth));
56689f6c5813SMatthew G. Knepley     if (isDepth) continue;
56699f6c5813SMatthew G. Knepley     PetscCall(PetscStrcmp(lname, "celltype", &isCellType));
56709f6c5813SMatthew G. Knepley     if (isCellType) continue;
56719f6c5813SMatthew G. Knepley     PetscCall(DMCreateLabel(*dm, lname));
56729f6c5813SMatthew G. Knepley     PetscCall(DMGetLabel(bdm, lname, &label));
56739f6c5813SMatthew G. Knepley     PetscCall(DMGetLabel(*dm, lname, &labelNew));
56749f6c5813SMatthew G. Knepley     PetscCall(DMLabelSetType(labelNew, DMLABELEPHEMERAL));
56759f6c5813SMatthew G. Knepley     PetscCall(DMLabelEphemeralSetLabel(labelNew, label));
56769f6c5813SMatthew G. Knepley     PetscCall(DMLabelEphemeralSetTransform(labelNew, tr));
56779f6c5813SMatthew G. Knepley     PetscCall(DMLabelSetUp(labelNew));
56789f6c5813SMatthew G. Knepley   }
56793ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
56809f6c5813SMatthew G. Knepley }
5681