xref: /petsc/src/dm/impls/plex/plexcreate.c (revision 1d27aa22b2f6148b2c4e3f06a75e0638d6493e09)
1552f7358SJed Brown #define PETSCDM_DLL
2af0996ceSBarry Smith #include <petsc/private/dmpleximpl.h> /*I   "petscdmplex.h"   I*/
3e8f14785SLisandro Dalcin #include <petsc/private/hashseti.h>   /*I   "petscdmplex.h"   I*/
40c312b8eSJed Brown #include <petscsf.h>
54663dae6SJed Brown #include <petscdmplextransform.h>
69f6c5813SMatthew G. Knepley #include <petscdmlabelephemeral.h>
7b7f5c055SJed Brown #include <petsc/private/kernels/blockmatmult.h>
8b7f5c055SJed Brown #include <petsc/private/kernels/blockinvert.h>
9552f7358SJed Brown 
10708be2fdSJed Brown PetscLogEvent DMPLEX_CreateFromFile, DMPLEX_CreateFromOptions, DMPLEX_BuildFromCellList, DMPLEX_BuildCoordinatesFromCellList;
1158cd63d5SVaclav Hapla 
129318fe57SMatthew G. Knepley /* External function declarations here */
139318fe57SMatthew G. Knepley static PetscErrorCode DMInitialize_Plex(DM dm);
149318fe57SMatthew G. Knepley 
15e600fa54SMatthew G. Knepley /* This copies internal things in the Plex structure that we generally want when making a new, related Plex */
16d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCopy_Internal(DM dmin, PetscBool copyPeriodicity, PetscBool copyOverlap, DM dmout)
17d71ae5a4SJacob Faibussowitsch {
184fb89dddSMatthew G. Knepley   const PetscReal         *maxCell, *Lstart, *L;
196858538eSMatthew G. Knepley   PetscBool                dist;
206bc1bd01Sksagiyam   DMPlexReorderDefaultFlag reorder;
21e600fa54SMatthew G. Knepley 
22e600fa54SMatthew G. Knepley   PetscFunctionBegin;
23e600fa54SMatthew G. Knepley   if (copyPeriodicity) {
244fb89dddSMatthew G. Knepley     PetscCall(DMGetPeriodicity(dmin, &maxCell, &Lstart, &L));
254fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dmout, maxCell, Lstart, L));
26e600fa54SMatthew G. Knepley   }
279566063dSJacob Faibussowitsch   PetscCall(DMPlexDistributeGetDefault(dmin, &dist));
289566063dSJacob Faibussowitsch   PetscCall(DMPlexDistributeSetDefault(dmout, dist));
296bc1bd01Sksagiyam   PetscCall(DMPlexReorderGetDefault(dmin, &reorder));
306bc1bd01Sksagiyam   PetscCall(DMPlexReorderSetDefault(dmout, reorder));
31e600fa54SMatthew G. Knepley   ((DM_Plex *)dmout->data)->useHashLocation = ((DM_Plex *)dmin->data)->useHashLocation;
321baa6e33SBarry Smith   if (copyOverlap) PetscCall(DMPlexSetOverlap_Plex(dmout, dmin, 0));
333ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
34e600fa54SMatthew G. Knepley }
35e600fa54SMatthew G. Knepley 
369318fe57SMatthew G. Knepley /* Replace dm with the contents of ndm, and then destroy ndm
379318fe57SMatthew G. Knepley    - Share the DM_Plex structure
389318fe57SMatthew G. Knepley    - Share the coordinates
399318fe57SMatthew G. Knepley    - Share the SF
409318fe57SMatthew G. Knepley */
41d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexReplace_Internal(DM dm, DM *ndm)
42d71ae5a4SJacob Faibussowitsch {
439318fe57SMatthew G. Knepley   PetscSF          sf;
449318fe57SMatthew G. Knepley   DM               dmNew = *ndm, coordDM, coarseDM;
459318fe57SMatthew G. Knepley   Vec              coords;
464fb89dddSMatthew G. Knepley   const PetscReal *maxCell, *Lstart, *L;
479318fe57SMatthew G. Knepley   PetscInt         dim, cdim;
489318fe57SMatthew G. Knepley 
499318fe57SMatthew G. Knepley   PetscFunctionBegin;
509318fe57SMatthew G. Knepley   if (dm == dmNew) {
519566063dSJacob Faibussowitsch     PetscCall(DMDestroy(ndm));
523ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
539318fe57SMatthew G. Knepley   }
549318fe57SMatthew G. Knepley   dm->setupcalled = dmNew->setupcalled;
559566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dmNew, &dim));
569566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
579566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dmNew, &cdim));
589566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, cdim));
599566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dmNew, &sf));
609566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dm, sf));
619566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dmNew, &coordDM));
629566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dmNew, &coords));
639566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDM(dm, coordDM));
649566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coords));
656858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dmNew, &coordDM));
666858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocal(dmNew, &coords));
676858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinateDM(dm, coordDM));
686858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinatesLocal(dm, coords));
699318fe57SMatthew G. Knepley   /* Do not want to create the coordinate field if it does not already exist, so do not call DMGetCoordinateField() */
706858538eSMatthew G. Knepley   PetscCall(DMFieldDestroy(&dm->coordinates[0].field));
716858538eSMatthew G. Knepley   dm->coordinates[0].field            = dmNew->coordinates[0].field;
7261a622f3SMatthew G. Knepley   ((DM_Plex *)dmNew->data)->coordFunc = ((DM_Plex *)dm->data)->coordFunc;
734fb89dddSMatthew G. Knepley   PetscCall(DMGetPeriodicity(dmNew, &maxCell, &Lstart, &L));
744fb89dddSMatthew G. Knepley   PetscCall(DMSetPeriodicity(dm, maxCell, Lstart, L));
759566063dSJacob Faibussowitsch   PetscCall(DMDestroy_Plex(dm));
769566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(dm));
779318fe57SMatthew G. Knepley   dm->data = dmNew->data;
789318fe57SMatthew G. Knepley   ((DM_Plex *)dmNew->data)->refct++;
795f06a3ddSJed Brown   PetscCall(DMPlexGetIsoperiodicFaceSF(dm, &sf));
805f06a3ddSJed Brown   PetscCall(DMPlexSetIsoperiodicFaceSF(dm, sf)); // for the compose function effect on dm
819566063dSJacob Faibussowitsch   PetscCall(DMDestroyLabelLinkList_Internal(dm));
829566063dSJacob Faibussowitsch   PetscCall(DMCopyLabels(dmNew, dm, PETSC_OWN_POINTER, PETSC_TRUE, DM_COPY_LABELS_FAIL));
839566063dSJacob Faibussowitsch   PetscCall(DMGetCoarseDM(dmNew, &coarseDM));
849566063dSJacob Faibussowitsch   PetscCall(DMSetCoarseDM(dm, coarseDM));
859566063dSJacob Faibussowitsch   PetscCall(DMDestroy(ndm));
863ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
879318fe57SMatthew G. Knepley }
889318fe57SMatthew G. Knepley 
899318fe57SMatthew G. Knepley /* Swap dm with the contents of dmNew
909318fe57SMatthew G. Knepley    - Swap the DM_Plex structure
919318fe57SMatthew G. Knepley    - Swap the coordinates
929318fe57SMatthew G. Knepley    - Swap the point PetscSF
939318fe57SMatthew G. Knepley */
94d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexSwap_Static(DM dmA, DM dmB)
95d71ae5a4SJacob Faibussowitsch {
969318fe57SMatthew G. Knepley   DM          coordDMA, coordDMB;
979318fe57SMatthew G. Knepley   Vec         coordsA, coordsB;
989318fe57SMatthew G. Knepley   PetscSF     sfA, sfB;
999318fe57SMatthew G. Knepley   DMField     fieldTmp;
1009318fe57SMatthew G. Knepley   void       *tmp;
1019318fe57SMatthew G. Knepley   DMLabelLink listTmp;
1029318fe57SMatthew G. Knepley   DMLabel     depthTmp;
1039318fe57SMatthew G. Knepley   PetscInt    tmpI;
1049318fe57SMatthew G. Knepley 
1059318fe57SMatthew G. Knepley   PetscFunctionBegin;
1063ba16761SJacob Faibussowitsch   if (dmA == dmB) PetscFunctionReturn(PETSC_SUCCESS);
1079566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dmA, &sfA));
1089566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dmB, &sfB));
1099566063dSJacob Faibussowitsch   PetscCall(PetscObjectReference((PetscObject)sfA));
1109566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dmA, sfB));
1119566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dmB, sfA));
1129566063dSJacob Faibussowitsch   PetscCall(PetscObjectDereference((PetscObject)sfA));
1139318fe57SMatthew G. Knepley 
1149566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dmA, &coordDMA));
1159566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dmB, &coordDMB));
1169566063dSJacob Faibussowitsch   PetscCall(PetscObjectReference((PetscObject)coordDMA));
1179566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDM(dmA, coordDMB));
1189566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDM(dmB, coordDMA));
1199566063dSJacob Faibussowitsch   PetscCall(PetscObjectDereference((PetscObject)coordDMA));
1209318fe57SMatthew G. Knepley 
1219566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dmA, &coordsA));
1229566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dmB, &coordsB));
1239566063dSJacob Faibussowitsch   PetscCall(PetscObjectReference((PetscObject)coordsA));
1249566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dmA, coordsB));
1259566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dmB, coordsA));
1269566063dSJacob Faibussowitsch   PetscCall(PetscObjectDereference((PetscObject)coordsA));
1279318fe57SMatthew G. Knepley 
1286858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dmA, &coordDMA));
1296858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dmB, &coordDMB));
1306858538eSMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)coordDMA));
1316858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinateDM(dmA, coordDMB));
1326858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinateDM(dmB, coordDMA));
1336858538eSMatthew G. Knepley   PetscCall(PetscObjectDereference((PetscObject)coordDMA));
1346858538eSMatthew G. Knepley 
1356858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocal(dmA, &coordsA));
1366858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocal(dmB, &coordsB));
1376858538eSMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)coordsA));
1386858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinatesLocal(dmA, coordsB));
1396858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinatesLocal(dmB, coordsA));
1406858538eSMatthew G. Knepley   PetscCall(PetscObjectDereference((PetscObject)coordsA));
1416858538eSMatthew G. Knepley 
1426858538eSMatthew G. Knepley   fieldTmp                  = dmA->coordinates[0].field;
1436858538eSMatthew G. Knepley   dmA->coordinates[0].field = dmB->coordinates[0].field;
1446858538eSMatthew G. Knepley   dmB->coordinates[0].field = fieldTmp;
1456858538eSMatthew G. Knepley   fieldTmp                  = dmA->coordinates[1].field;
1466858538eSMatthew G. Knepley   dmA->coordinates[1].field = dmB->coordinates[1].field;
1476858538eSMatthew G. Knepley   dmB->coordinates[1].field = fieldTmp;
1489318fe57SMatthew G. Knepley   tmp                       = dmA->data;
1499318fe57SMatthew G. Knepley   dmA->data                 = dmB->data;
1509318fe57SMatthew G. Knepley   dmB->data                 = tmp;
1519318fe57SMatthew G. Knepley   listTmp                   = dmA->labels;
1529318fe57SMatthew G. Knepley   dmA->labels               = dmB->labels;
1539318fe57SMatthew G. Knepley   dmB->labels               = listTmp;
1549318fe57SMatthew G. Knepley   depthTmp                  = dmA->depthLabel;
1559318fe57SMatthew G. Knepley   dmA->depthLabel           = dmB->depthLabel;
1569318fe57SMatthew G. Knepley   dmB->depthLabel           = depthTmp;
1579318fe57SMatthew G. Knepley   depthTmp                  = dmA->celltypeLabel;
1589318fe57SMatthew G. Knepley   dmA->celltypeLabel        = dmB->celltypeLabel;
1599318fe57SMatthew G. Knepley   dmB->celltypeLabel        = depthTmp;
1609318fe57SMatthew G. Knepley   tmpI                      = dmA->levelup;
1619318fe57SMatthew G. Knepley   dmA->levelup              = dmB->levelup;
1629318fe57SMatthew G. Knepley   dmB->levelup              = tmpI;
1633ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1649318fe57SMatthew G. Knepley }
1659318fe57SMatthew G. Knepley 
1663431e603SJed Brown PetscErrorCode DMPlexInterpolateInPlace_Internal(DM dm)
167d71ae5a4SJacob Faibussowitsch {
1689318fe57SMatthew G. Knepley   DM idm;
1699318fe57SMatthew G. Knepley 
1709318fe57SMatthew G. Knepley   PetscFunctionBegin;
1719566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolate(dm, &idm));
1729566063dSJacob Faibussowitsch   PetscCall(DMPlexCopyCoordinates(dm, idm));
17369d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &idm));
1743ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1759318fe57SMatthew G. Knepley }
1769318fe57SMatthew G. Knepley 
1779318fe57SMatthew G. Knepley /*@C
1789318fe57SMatthew G. Knepley   DMPlexCreateCoordinateSpace - Creates a finite element space for the coordinates
1799318fe57SMatthew G. Knepley 
18020f4b53cSBarry Smith   Collective
1819318fe57SMatthew G. Knepley 
1829318fe57SMatthew G. Knepley   Input Parameters:
18360225df5SJacob Faibussowitsch + dm        - The `DMPLEX`
18420f4b53cSBarry Smith . degree    - The degree of the finite element or `PETSC_DECIDE`
1859318fe57SMatthew G. Knepley - coordFunc - An optional function to map new points from refinement to the surface
1869318fe57SMatthew G. Knepley 
1879318fe57SMatthew G. Knepley   Level: advanced
1889318fe57SMatthew G. Knepley 
1891cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `PetscPointFunc`, `PetscFECreateLagrange()`, `DMGetCoordinateDM()`
1909318fe57SMatthew G. Knepley @*/
191d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateCoordinateSpace(DM dm, PetscInt degree, PetscPointFunc coordFunc)
192d71ae5a4SJacob Faibussowitsch {
1939318fe57SMatthew G. Knepley   DM_Plex     *mesh = (DM_Plex *)dm->data;
1949318fe57SMatthew G. Knepley   DM           cdm;
1959318fe57SMatthew G. Knepley   PetscDS      cds;
1969318fe57SMatthew G. Knepley   PetscFE      fe;
1979318fe57SMatthew G. Knepley   PetscClassId id;
1989318fe57SMatthew G. Knepley 
1999318fe57SMatthew G. Knepley   PetscFunctionBegin;
2009566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dm, &cdm));
2019566063dSJacob Faibussowitsch   PetscCall(DMGetDS(cdm, &cds));
2029566063dSJacob Faibussowitsch   PetscCall(PetscDSGetDiscretization(cds, 0, (PetscObject *)&fe));
2039566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetClassId((PetscObject)fe, &id));
2049318fe57SMatthew G. Knepley   if (id != PETSCFE_CLASSID) {
2059318fe57SMatthew G. Knepley     PetscInt dim, dE, qorder;
2069318fe57SMatthew G. Knepley 
2079566063dSJacob Faibussowitsch     PetscCall(DMGetDimension(dm, &dim));
2089566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDim(dm, &dE));
2099318fe57SMatthew G. Knepley     qorder = degree;
210d0609cedSBarry Smith     PetscObjectOptionsBegin((PetscObject)cdm);
211dc431b0cSMatthew G. Knepley     PetscCall(PetscOptionsBoundedInt("-default_quadrature_order", "Quadrature order is one less than quadrature points per edge", "DMPlexCreateCoordinateSpace", qorder, &qorder, NULL, 0));
212d0609cedSBarry Smith     PetscOptionsEnd();
2134f9ab2b4SJed Brown     if (degree == PETSC_DECIDE) fe = NULL;
2144f9ab2b4SJed Brown     else {
215dc431b0cSMatthew G. Knepley       DMPolytopeType ct;
216dc431b0cSMatthew G. Knepley       PetscInt       cStart, cEnd, ctTmp;
217dc431b0cSMatthew G. Knepley 
218dc431b0cSMatthew G. Knepley       PetscCall(DMPlexGetHeightStratum(dm, 0, &cStart, &cEnd));
219dc431b0cSMatthew G. Knepley       // Want to match cell types
220dc431b0cSMatthew G. Knepley       if (cEnd > cStart) PetscCall(DMPlexGetCellType(dm, cStart, &ct));
221dc431b0cSMatthew G. Knepley       else ct = DM_POLYTOPE_UNKNOWN;
222dc431b0cSMatthew G. Knepley       ctTmp = (PetscInt)ct;
223712fec58SPierre Jolivet       PetscCall(MPIU_Allreduce(MPI_IN_PLACE, &ctTmp, 1, MPIU_INT, MPI_MIN, PetscObjectComm((PetscObject)dm)));
224dc431b0cSMatthew G. Knepley       ct = (DMPolytopeType)ctTmp;
225dc431b0cSMatthew G. Knepley       // Work around current bug
226dc431b0cSMatthew G. Knepley       if (ct == DM_POLYTOPE_SEG_PRISM_TENSOR || ct == DM_POLYTOPE_TRI_PRISM_TENSOR || ct == DM_POLYTOPE_QUAD_PRISM_TENSOR) fe = NULL;
227dc431b0cSMatthew G. Knepley       else PetscCall(PetscFECreateLagrangeByCell(PETSC_COMM_SELF, dim, dE, ct, degree, qorder, &fe));
2284f9ab2b4SJed Brown     }
229dc431b0cSMatthew G. Knepley     if (fe) PetscCall(DMProjectCoordinates(dm, fe));
2309566063dSJacob Faibussowitsch     PetscCall(PetscFEDestroy(&fe));
2319318fe57SMatthew G. Knepley   }
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 
21219566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateCoordinateSpace(dm, 1, 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) {
235065a81367SMatthew G. Knepley   case 2:
235165a81367SMatthew G. Knepley     if (simplex) {
235251a74b61SMatthew G. Knepley       const PetscReal radius    = PetscSqrtReal(1 + PETSC_PHI * PETSC_PHI) / (1.0 + PETSC_PHI);
235351a74b61SMatthew G. Knepley       const PetscReal edgeLen   = 2.0 / (1.0 + PETSC_PHI) * (R / radius);
235465a81367SMatthew G. Knepley       const PetscInt  degree    = 5;
235551a74b61SMatthew G. Knepley       PetscReal       vertex[3] = {0.0, 1.0 / (1.0 + PETSC_PHI), PETSC_PHI / (1.0 + PETSC_PHI)};
235665a81367SMatthew G. Knepley       PetscInt        s[3]      = {1, 1, 1};
235765a81367SMatthew G. Knepley       PetscInt        cone[3];
235865a81367SMatthew G. Knepley       PetscInt       *graph, p, i, j, k;
235965a81367SMatthew G. Knepley 
23609371c9d4SSatish Balay       vertex[0] *= R / radius;
23619371c9d4SSatish Balay       vertex[1] *= R / radius;
23629371c9d4SSatish Balay       vertex[2] *= R / radius;
2363dd400576SPatrick Sanan       numCells    = rank == 0 ? 20 : 0;
2364dd400576SPatrick Sanan       numVerts    = rank == 0 ? 12 : 0;
236565a81367SMatthew G. Knepley       firstVertex = numCells;
236651a74b61SMatthew G. Knepley       /* Use icosahedron, which for a R-sphere has coordinates which are all cyclic permutations of
236765a81367SMatthew G. Knepley 
236865a81367SMatthew G. Knepley            (0, \pm 1/\phi+1, \pm \phi/\phi+1)
236965a81367SMatthew G. Knepley 
237065a81367SMatthew G. Knepley          where \phi^2 - \phi - 1 = 0, meaning \phi is the golden ratio \frac{1 + \sqrt{5}}{2}. The edge
237151a74b61SMatthew G. Knepley          length is then given by 2/(1+\phi) = 2 * 0.38197 = 0.76393.
237265a81367SMatthew G. Knepley       */
237365a81367SMatthew G. Knepley       /* Construct vertices */
23749566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2375dd400576SPatrick Sanan       if (rank == 0) {
237665a81367SMatthew G. Knepley         for (p = 0, i = 0; p < embedDim; ++p) {
237765a81367SMatthew G. Knepley           for (s[1] = -1; s[1] < 2; s[1] += 2) {
237865a81367SMatthew G. Knepley             for (s[2] = -1; s[2] < 2; s[2] += 2) {
237965a81367SMatthew G. Knepley               for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[(d + p) % embedDim] * vertex[(d + p) % embedDim];
238065a81367SMatthew G. Knepley               ++i;
238165a81367SMatthew G. Knepley             }
238265a81367SMatthew G. Knepley           }
238365a81367SMatthew G. Knepley         }
238445da822fSValeria Barra       }
238565a81367SMatthew G. Knepley       /* Construct graph */
23869566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * numVerts, &graph));
238765a81367SMatthew G. Knepley       for (i = 0; i < numVerts; ++i) {
238865a81367SMatthew G. Knepley         for (j = 0, k = 0; j < numVerts; ++j) {
23899371c9d4SSatish Balay           if (PetscAbsReal(DiffNormReal(embedDim, &coordsIn[i * embedDim], &coordsIn[j * embedDim]) - edgeLen) < PETSC_SMALL) {
23909371c9d4SSatish Balay             graph[i * numVerts + j] = 1;
23919371c9d4SSatish Balay             ++k;
23929371c9d4SSatish Balay           }
239365a81367SMatthew G. Knepley         }
239463a3b9bcSJacob Faibussowitsch         PetscCheck(k == degree, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid icosahedron, vertex %" PetscInt_FMT " degree %" PetscInt_FMT " != %" PetscInt_FMT, i, k, degree);
239565a81367SMatthew G. Knepley       }
239665a81367SMatthew G. Knepley       /* Build Topology */
23979566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
239848a46eb9SPierre Jolivet       for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
23999566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
240065a81367SMatthew G. Knepley       /* Cells */
240165a81367SMatthew G. Knepley       for (i = 0, c = 0; i < numVerts; ++i) {
240265a81367SMatthew G. Knepley         for (j = 0; j < i; ++j) {
240365a81367SMatthew G. Knepley           for (k = 0; k < j; ++k) {
240465a81367SMatthew G. Knepley             if (graph[i * numVerts + j] && graph[j * numVerts + k] && graph[k * numVerts + i]) {
24059371c9d4SSatish Balay               cone[0] = firstVertex + i;
24069371c9d4SSatish Balay               cone[1] = firstVertex + j;
24079371c9d4SSatish Balay               cone[2] = firstVertex + k;
240865a81367SMatthew G. Knepley               /* Check orientation */
240965a81367SMatthew G. Knepley               {
24109371c9d4SSatish Balay                 const PetscInt epsilon[3][3][3] = {
24119371c9d4SSatish Balay                   {{0, 0, 0},  {0, 0, 1},  {0, -1, 0}},
24129371c9d4SSatish Balay                   {{0, 0, -1}, {0, 0, 0},  {1, 0, 0} },
24139371c9d4SSatish Balay                   {{0, 1, 0},  {-1, 0, 0}, {0, 0, 0} }
24149371c9d4SSatish Balay                 };
241565a81367SMatthew G. Knepley                 PetscReal normal[3];
241665a81367SMatthew G. Knepley                 PetscInt  e, f;
241765a81367SMatthew G. Knepley 
241865a81367SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) {
241965a81367SMatthew G. Knepley                   normal[d] = 0.0;
242065a81367SMatthew G. Knepley                   for (e = 0; e < embedDim; ++e) {
2421ad540459SPierre 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]);
242265a81367SMatthew G. Knepley                   }
242365a81367SMatthew G. Knepley                 }
24249371c9d4SSatish Balay                 if (DotReal(embedDim, normal, &coordsIn[i * embedDim]) < 0) {
24259371c9d4SSatish Balay                   PetscInt tmp = cone[1];
24269371c9d4SSatish Balay                   cone[1]      = cone[2];
24279371c9d4SSatish Balay                   cone[2]      = tmp;
242865a81367SMatthew G. Knepley                 }
242965a81367SMatthew G. Knepley               }
24309566063dSJacob Faibussowitsch               PetscCall(DMPlexSetCone(dm, c++, cone));
243165a81367SMatthew G. Knepley             }
243265a81367SMatthew G. Knepley           }
243365a81367SMatthew G. Knepley         }
243465a81367SMatthew G. Knepley       }
24359566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
24369566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
24379566063dSJacob Faibussowitsch       PetscCall(PetscFree(graph));
243865a81367SMatthew G. Knepley     } else {
24392829fed8SMatthew G. Knepley       /*
24402829fed8SMatthew G. Knepley         12-21--13
24412829fed8SMatthew G. Knepley          |     |
24422829fed8SMatthew G. Knepley         25  4  24
24432829fed8SMatthew G. Knepley          |     |
24442829fed8SMatthew G. Knepley   12-25--9-16--8-24--13
24452829fed8SMatthew G. Knepley    |     |     |     |
24462829fed8SMatthew G. Knepley   23  5 17  0 15  3  22
24472829fed8SMatthew G. Knepley    |     |     |     |
24482829fed8SMatthew G. Knepley   10-20--6-14--7-19--11
24492829fed8SMatthew G. Knepley          |     |
24502829fed8SMatthew G. Knepley         20  1  19
24512829fed8SMatthew G. Knepley          |     |
24522829fed8SMatthew G. Knepley         10-18--11
24532829fed8SMatthew G. Knepley          |     |
24542829fed8SMatthew G. Knepley         23  2  22
24552829fed8SMatthew G. Knepley          |     |
24562829fed8SMatthew G. Knepley         12-21--13
24572829fed8SMatthew G. Knepley        */
24582829fed8SMatthew G. Knepley       PetscInt cone[4], ornt[4];
24592829fed8SMatthew G. Knepley 
2460dd400576SPatrick Sanan       numCells    = rank == 0 ? 6 : 0;
2461dd400576SPatrick Sanan       numEdges    = rank == 0 ? 12 : 0;
2462dd400576SPatrick Sanan       numVerts    = rank == 0 ? 8 : 0;
246365a81367SMatthew G. Knepley       firstVertex = numCells;
246465a81367SMatthew G. Knepley       firstEdge   = numCells + numVerts;
24652829fed8SMatthew G. Knepley       /* Build Topology */
24669566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numEdges + numVerts));
246748a46eb9SPierre Jolivet       for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 4));
246848a46eb9SPierre Jolivet       for (e = firstEdge; e < firstEdge + numEdges; ++e) PetscCall(DMPlexSetConeSize(dm, e, 2));
24699566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
2470dd400576SPatrick Sanan       if (rank == 0) {
24712829fed8SMatthew G. Knepley         /* Cell 0 */
24729371c9d4SSatish Balay         cone[0] = 14;
24739371c9d4SSatish Balay         cone[1] = 15;
24749371c9d4SSatish Balay         cone[2] = 16;
24759371c9d4SSatish Balay         cone[3] = 17;
24769566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
24779371c9d4SSatish Balay         ornt[0] = 0;
24789371c9d4SSatish Balay         ornt[1] = 0;
24799371c9d4SSatish Balay         ornt[2] = 0;
24809371c9d4SSatish Balay         ornt[3] = 0;
24819566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 0, ornt));
24822829fed8SMatthew G. Knepley         /* Cell 1 */
24839371c9d4SSatish Balay         cone[0] = 18;
24849371c9d4SSatish Balay         cone[1] = 19;
24859371c9d4SSatish Balay         cone[2] = 14;
24869371c9d4SSatish Balay         cone[3] = 20;
24879566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
24889371c9d4SSatish Balay         ornt[0] = 0;
24899371c9d4SSatish Balay         ornt[1] = 0;
24909371c9d4SSatish Balay         ornt[2] = -1;
24919371c9d4SSatish Balay         ornt[3] = 0;
24929566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 1, ornt));
24932829fed8SMatthew G. Knepley         /* Cell 2 */
24949371c9d4SSatish Balay         cone[0] = 21;
24959371c9d4SSatish Balay         cone[1] = 22;
24969371c9d4SSatish Balay         cone[2] = 18;
24979371c9d4SSatish Balay         cone[3] = 23;
24989566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
24999371c9d4SSatish Balay         ornt[0] = 0;
25009371c9d4SSatish Balay         ornt[1] = 0;
25019371c9d4SSatish Balay         ornt[2] = -1;
25029371c9d4SSatish Balay         ornt[3] = 0;
25039566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 2, ornt));
25042829fed8SMatthew G. Knepley         /* Cell 3 */
25059371c9d4SSatish Balay         cone[0] = 19;
25069371c9d4SSatish Balay         cone[1] = 22;
25079371c9d4SSatish Balay         cone[2] = 24;
25089371c9d4SSatish Balay         cone[3] = 15;
25099566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
25109371c9d4SSatish Balay         ornt[0] = -1;
25119371c9d4SSatish Balay         ornt[1] = -1;
25129371c9d4SSatish Balay         ornt[2] = 0;
25139371c9d4SSatish Balay         ornt[3] = -1;
25149566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 3, ornt));
25152829fed8SMatthew G. Knepley         /* Cell 4 */
25169371c9d4SSatish Balay         cone[0] = 16;
25179371c9d4SSatish Balay         cone[1] = 24;
25189371c9d4SSatish Balay         cone[2] = 21;
25199371c9d4SSatish Balay         cone[3] = 25;
25209566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
25219371c9d4SSatish Balay         ornt[0] = -1;
25229371c9d4SSatish Balay         ornt[1] = -1;
25239371c9d4SSatish Balay         ornt[2] = -1;
25249371c9d4SSatish Balay         ornt[3] = 0;
25259566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 4, ornt));
25262829fed8SMatthew G. Knepley         /* Cell 5 */
25279371c9d4SSatish Balay         cone[0] = 20;
25289371c9d4SSatish Balay         cone[1] = 17;
25299371c9d4SSatish Balay         cone[2] = 25;
25309371c9d4SSatish Balay         cone[3] = 23;
25319566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 5, cone));
25329371c9d4SSatish Balay         ornt[0] = -1;
25339371c9d4SSatish Balay         ornt[1] = -1;
25349371c9d4SSatish Balay         ornt[2] = -1;
25359371c9d4SSatish Balay         ornt[3] = -1;
25369566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 5, ornt));
25372829fed8SMatthew G. Knepley         /* Edges */
25389371c9d4SSatish Balay         cone[0] = 6;
25399371c9d4SSatish Balay         cone[1] = 7;
25409566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 14, cone));
25419371c9d4SSatish Balay         cone[0] = 7;
25429371c9d4SSatish Balay         cone[1] = 8;
25439566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 15, cone));
25449371c9d4SSatish Balay         cone[0] = 8;
25459371c9d4SSatish Balay         cone[1] = 9;
25469566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 16, cone));
25479371c9d4SSatish Balay         cone[0] = 9;
25489371c9d4SSatish Balay         cone[1] = 6;
25499566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 17, cone));
25509371c9d4SSatish Balay         cone[0] = 10;
25519371c9d4SSatish Balay         cone[1] = 11;
25529566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 18, cone));
25539371c9d4SSatish Balay         cone[0] = 11;
25549371c9d4SSatish Balay         cone[1] = 7;
25559566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 19, cone));
25569371c9d4SSatish Balay         cone[0] = 6;
25579371c9d4SSatish Balay         cone[1] = 10;
25589566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 20, cone));
25599371c9d4SSatish Balay         cone[0] = 12;
25609371c9d4SSatish Balay         cone[1] = 13;
25619566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 21, cone));
25629371c9d4SSatish Balay         cone[0] = 13;
25639371c9d4SSatish Balay         cone[1] = 11;
25649566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 22, cone));
25659371c9d4SSatish Balay         cone[0] = 10;
25669371c9d4SSatish Balay         cone[1] = 12;
25679566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 23, cone));
25689371c9d4SSatish Balay         cone[0] = 13;
25699371c9d4SSatish Balay         cone[1] = 8;
25709566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 24, cone));
25719371c9d4SSatish Balay         cone[0] = 12;
25729371c9d4SSatish Balay         cone[1] = 9;
25739566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 25, cone));
257445da822fSValeria Barra       }
25759566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
25769566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
25772829fed8SMatthew G. Knepley       /* Build coordinates */
25789566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2579dd400576SPatrick Sanan       if (rank == 0) {
25809371c9d4SSatish Balay         coordsIn[0 * embedDim + 0] = -R;
25819371c9d4SSatish Balay         coordsIn[0 * embedDim + 1] = R;
25829371c9d4SSatish Balay         coordsIn[0 * embedDim + 2] = -R;
25839371c9d4SSatish Balay         coordsIn[1 * embedDim + 0] = R;
25849371c9d4SSatish Balay         coordsIn[1 * embedDim + 1] = R;
25859371c9d4SSatish Balay         coordsIn[1 * embedDim + 2] = -R;
25869371c9d4SSatish Balay         coordsIn[2 * embedDim + 0] = R;
25879371c9d4SSatish Balay         coordsIn[2 * embedDim + 1] = -R;
25889371c9d4SSatish Balay         coordsIn[2 * embedDim + 2] = -R;
25899371c9d4SSatish Balay         coordsIn[3 * embedDim + 0] = -R;
25909371c9d4SSatish Balay         coordsIn[3 * embedDim + 1] = -R;
25919371c9d4SSatish Balay         coordsIn[3 * embedDim + 2] = -R;
25929371c9d4SSatish Balay         coordsIn[4 * embedDim + 0] = -R;
25939371c9d4SSatish Balay         coordsIn[4 * embedDim + 1] = R;
25949371c9d4SSatish Balay         coordsIn[4 * embedDim + 2] = R;
25959371c9d4SSatish Balay         coordsIn[5 * embedDim + 0] = R;
25969371c9d4SSatish Balay         coordsIn[5 * embedDim + 1] = R;
25979371c9d4SSatish Balay         coordsIn[5 * embedDim + 2] = R;
25989371c9d4SSatish Balay         coordsIn[6 * embedDim + 0] = -R;
25999371c9d4SSatish Balay         coordsIn[6 * embedDim + 1] = -R;
26009371c9d4SSatish Balay         coordsIn[6 * embedDim + 2] = R;
26019371c9d4SSatish Balay         coordsIn[7 * embedDim + 0] = R;
26029371c9d4SSatish Balay         coordsIn[7 * embedDim + 1] = -R;
26039371c9d4SSatish Balay         coordsIn[7 * embedDim + 2] = R;
260465a81367SMatthew G. Knepley       }
260545da822fSValeria Barra     }
260665a81367SMatthew G. Knepley     break;
260765a81367SMatthew G. Knepley   case 3:
2608116ded15SMatthew G. Knepley     if (simplex) {
2609116ded15SMatthew G. Knepley       const PetscReal edgeLen         = 1.0 / PETSC_PHI;
261051a74b61SMatthew G. Knepley       PetscReal       vertexA[4]      = {0.5, 0.5, 0.5, 0.5};
261151a74b61SMatthew G. Knepley       PetscReal       vertexB[4]      = {1.0, 0.0, 0.0, 0.0};
261251a74b61SMatthew G. Knepley       PetscReal       vertexC[4]      = {0.5, 0.5 * PETSC_PHI, 0.5 / PETSC_PHI, 0.0};
2613116ded15SMatthew G. Knepley       const PetscInt  degree          = 12;
2614116ded15SMatthew G. Knepley       PetscInt        s[4]            = {1, 1, 1};
26159371c9d4SSatish Balay       PetscInt        evenPerm[12][4] = {
26169371c9d4SSatish Balay         {0, 1, 2, 3},
26179371c9d4SSatish Balay         {0, 2, 3, 1},
26189371c9d4SSatish Balay         {0, 3, 1, 2},
26199371c9d4SSatish Balay         {1, 0, 3, 2},
26209371c9d4SSatish Balay         {1, 2, 0, 3},
26219371c9d4SSatish Balay         {1, 3, 2, 0},
26229371c9d4SSatish Balay         {2, 0, 1, 3},
26239371c9d4SSatish Balay         {2, 1, 3, 0},
26249371c9d4SSatish Balay         {2, 3, 0, 1},
26259371c9d4SSatish Balay         {3, 0, 2, 1},
26269371c9d4SSatish Balay         {3, 1, 0, 2},
26279371c9d4SSatish Balay         {3, 2, 1, 0}
26289371c9d4SSatish Balay       };
2629116ded15SMatthew G. Knepley       PetscInt  cone[4];
2630116ded15SMatthew G. Knepley       PetscInt *graph, p, i, j, k, l;
2631116ded15SMatthew G. Knepley 
26329371c9d4SSatish Balay       vertexA[0] *= R;
26339371c9d4SSatish Balay       vertexA[1] *= R;
26349371c9d4SSatish Balay       vertexA[2] *= R;
26359371c9d4SSatish Balay       vertexA[3] *= R;
26369371c9d4SSatish Balay       vertexB[0] *= R;
26379371c9d4SSatish Balay       vertexB[1] *= R;
26389371c9d4SSatish Balay       vertexB[2] *= R;
26399371c9d4SSatish Balay       vertexB[3] *= R;
26409371c9d4SSatish Balay       vertexC[0] *= R;
26419371c9d4SSatish Balay       vertexC[1] *= R;
26429371c9d4SSatish Balay       vertexC[2] *= R;
26439371c9d4SSatish Balay       vertexC[3] *= R;
2644dd400576SPatrick Sanan       numCells    = rank == 0 ? 600 : 0;
2645dd400576SPatrick Sanan       numVerts    = rank == 0 ? 120 : 0;
2646116ded15SMatthew G. Knepley       firstVertex = numCells;
2647116ded15SMatthew G. Knepley       /* Use the 600-cell, which for a unit sphere has coordinates which are
2648116ded15SMatthew G. Knepley 
2649116ded15SMatthew G. Knepley            1/2 (\pm 1, \pm 1,    \pm 1, \pm 1)                          16
2650116ded15SMatthew G. Knepley                (\pm 1,    0,       0,      0)  all cyclic permutations   8
2651116ded15SMatthew G. Knepley            1/2 (\pm 1, \pm phi, \pm 1/phi, 0)  all even permutations    96
2652116ded15SMatthew G. Knepley 
2653116ded15SMatthew G. Knepley          where \phi^2 - \phi - 1 = 0, meaning \phi is the golden ratio \frac{1 + \sqrt{5}}{2}. The edge
26546333ae4fSvaleriabarra          length is then given by 1/\phi = 0.61803.
2655116ded15SMatthew G. Knepley 
2656116ded15SMatthew G. Knepley          http://buzzard.pugetsound.edu/sage-practice/ch03s03.html
2657116ded15SMatthew G. Knepley          http://mathworld.wolfram.com/600-Cell.html
2658116ded15SMatthew G. Knepley       */
2659116ded15SMatthew G. Knepley       /* Construct vertices */
26609566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2661116ded15SMatthew G. Knepley       i = 0;
2662dd400576SPatrick Sanan       if (rank == 0) {
2663116ded15SMatthew G. Knepley         for (s[0] = -1; s[0] < 2; s[0] += 2) {
2664116ded15SMatthew G. Knepley           for (s[1] = -1; s[1] < 2; s[1] += 2) {
2665116ded15SMatthew G. Knepley             for (s[2] = -1; s[2] < 2; s[2] += 2) {
2666116ded15SMatthew G. Knepley               for (s[3] = -1; s[3] < 2; s[3] += 2) {
2667116ded15SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[d] * vertexA[d];
2668116ded15SMatthew G. Knepley                 ++i;
2669116ded15SMatthew G. Knepley               }
2670116ded15SMatthew G. Knepley             }
2671116ded15SMatthew G. Knepley           }
2672116ded15SMatthew G. Knepley         }
2673116ded15SMatthew G. Knepley         for (p = 0; p < embedDim; ++p) {
2674116ded15SMatthew G. Knepley           s[1] = s[2] = s[3] = 1;
2675116ded15SMatthew G. Knepley           for (s[0] = -1; s[0] < 2; s[0] += 2) {
2676116ded15SMatthew G. Knepley             for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[(d + p) % embedDim] * vertexB[(d + p) % embedDim];
2677116ded15SMatthew G. Knepley             ++i;
2678116ded15SMatthew G. Knepley           }
2679116ded15SMatthew G. Knepley         }
2680116ded15SMatthew G. Knepley         for (p = 0; p < 12; ++p) {
2681116ded15SMatthew G. Knepley           s[3] = 1;
2682116ded15SMatthew G. Knepley           for (s[0] = -1; s[0] < 2; s[0] += 2) {
2683116ded15SMatthew G. Knepley             for (s[1] = -1; s[1] < 2; s[1] += 2) {
2684116ded15SMatthew G. Knepley               for (s[2] = -1; s[2] < 2; s[2] += 2) {
2685116ded15SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[evenPerm[p][d]] * vertexC[evenPerm[p][d]];
2686116ded15SMatthew G. Knepley                 ++i;
2687116ded15SMatthew G. Knepley               }
2688116ded15SMatthew G. Knepley             }
2689116ded15SMatthew G. Knepley           }
2690116ded15SMatthew G. Knepley         }
269145da822fSValeria Barra       }
269263a3b9bcSJacob Faibussowitsch       PetscCheck(i == numVerts, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid 600-cell, vertices %" PetscInt_FMT " != %" PetscInt_FMT, i, numVerts);
2693116ded15SMatthew G. Knepley       /* Construct graph */
26949566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * numVerts, &graph));
2695116ded15SMatthew G. Knepley       for (i = 0; i < numVerts; ++i) {
2696116ded15SMatthew G. Knepley         for (j = 0, k = 0; j < numVerts; ++j) {
26979371c9d4SSatish Balay           if (PetscAbsReal(DiffNormReal(embedDim, &coordsIn[i * embedDim], &coordsIn[j * embedDim]) - edgeLen) < PETSC_SMALL) {
26989371c9d4SSatish Balay             graph[i * numVerts + j] = 1;
26999371c9d4SSatish Balay             ++k;
27009371c9d4SSatish Balay           }
2701116ded15SMatthew G. Knepley         }
270263a3b9bcSJacob Faibussowitsch         PetscCheck(k == degree, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid 600-cell, vertex %" PetscInt_FMT " degree %" PetscInt_FMT " != %" PetscInt_FMT, i, k, degree);
2703116ded15SMatthew G. Knepley       }
2704116ded15SMatthew G. Knepley       /* Build Topology */
27059566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
270648a46eb9SPierre Jolivet       for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
27079566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
2708116ded15SMatthew G. Knepley       /* Cells */
2709dd400576SPatrick Sanan       if (rank == 0) {
2710116ded15SMatthew G. Knepley         for (i = 0, c = 0; i < numVerts; ++i) {
2711116ded15SMatthew G. Knepley           for (j = 0; j < i; ++j) {
2712116ded15SMatthew G. Knepley             for (k = 0; k < j; ++k) {
2713116ded15SMatthew G. Knepley               for (l = 0; l < k; ++l) {
27149371c9d4SSatish 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]) {
27159371c9d4SSatish Balay                   cone[0] = firstVertex + i;
27169371c9d4SSatish Balay                   cone[1] = firstVertex + j;
27179371c9d4SSatish Balay                   cone[2] = firstVertex + k;
27189371c9d4SSatish Balay                   cone[3] = firstVertex + l;
2719116ded15SMatthew G. Knepley                   /* Check orientation: https://ef.gy/linear-algebra:normal-vectors-in-higher-dimensional-spaces */
2720116ded15SMatthew G. Knepley                   {
27219371c9d4SSatish Balay                     const PetscInt epsilon[4][4][4][4] = {
27229371c9d4SSatish 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}}},
2723116ded15SMatthew G. Knepley 
27249371c9d4SSatish 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}}},
2725116ded15SMatthew G. Knepley 
27269371c9d4SSatish 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}}},
2727116ded15SMatthew G. Knepley 
27289371c9d4SSatish 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}} }
27299371c9d4SSatish Balay                     };
2730116ded15SMatthew G. Knepley                     PetscReal normal[4];
2731116ded15SMatthew G. Knepley                     PetscInt  e, f, g;
2732116ded15SMatthew G. Knepley 
2733116ded15SMatthew G. Knepley                     for (d = 0; d < embedDim; ++d) {
2734116ded15SMatthew G. Knepley                       normal[d] = 0.0;
2735116ded15SMatthew G. Knepley                       for (e = 0; e < embedDim; ++e) {
2736116ded15SMatthew G. Knepley                         for (f = 0; f < embedDim; ++f) {
2737116ded15SMatthew G. Knepley                           for (g = 0; g < embedDim; ++g) {
2738116ded15SMatthew 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]);
2739116ded15SMatthew G. Knepley                           }
2740116ded15SMatthew G. Knepley                         }
2741116ded15SMatthew G. Knepley                       }
2742116ded15SMatthew G. Knepley                     }
27439371c9d4SSatish Balay                     if (DotReal(embedDim, normal, &coordsIn[i * embedDim]) < 0) {
27449371c9d4SSatish Balay                       PetscInt tmp = cone[1];
27459371c9d4SSatish Balay                       cone[1]      = cone[2];
27469371c9d4SSatish Balay                       cone[2]      = tmp;
27479371c9d4SSatish Balay                     }
2748116ded15SMatthew G. Knepley                   }
27499566063dSJacob Faibussowitsch                   PetscCall(DMPlexSetCone(dm, c++, cone));
2750116ded15SMatthew G. Knepley                 }
2751116ded15SMatthew G. Knepley               }
2752116ded15SMatthew G. Knepley             }
2753116ded15SMatthew G. Knepley           }
2754116ded15SMatthew G. Knepley         }
275545da822fSValeria Barra       }
27569566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
27579566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
27589566063dSJacob Faibussowitsch       PetscCall(PetscFree(graph));
2759116ded15SMatthew G. Knepley     }
2760f4d061e9SPierre Jolivet     break;
2761d71ae5a4SJacob Faibussowitsch   default:
2762d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Unsupported dimension for sphere: %" PetscInt_FMT, dim);
276365a81367SMatthew G. Knepley   }
276465a81367SMatthew G. Knepley   /* Create coordinates */
27659566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
27669566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
27679566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, embedDim));
27689566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numVerts));
27692829fed8SMatthew G. Knepley   for (v = firstVertex; v < firstVertex + numVerts; ++v) {
27709566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, embedDim));
27719566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, embedDim));
27722829fed8SMatthew G. Knepley   }
27739566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
27749566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
27759566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
27769566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, embedDim));
27779566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
27789566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
27799566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
27809566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
27819371c9d4SSatish Balay   for (v = 0; v < numVerts; ++v)
2782ad540459SPierre Jolivet     for (d = 0; d < embedDim; ++d) coords[v * embedDim + d] = coordsIn[v * embedDim + d];
27839566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
27849566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
27859566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
27869566063dSJacob Faibussowitsch   PetscCall(PetscFree(coordsIn));
278751a74b61SMatthew G. Knepley   {
278851a74b61SMatthew G. Knepley     DM          cdm;
278951a74b61SMatthew G. Knepley     PetscDS     cds;
27909318fe57SMatthew G. Knepley     PetscScalar c = R;
279151a74b61SMatthew G. Knepley 
27929566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateCoordinateSpace(dm, 1, snapToSphere));
27939566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
27949566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
27959566063dSJacob Faibussowitsch     PetscCall(PetscDSSetConstants(cds, 1, &c));
279651a74b61SMatthew G. Knepley   }
279746139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
27989318fe57SMatthew G. Knepley   /* Wait for coordinate creation before doing in-place modification */
27999566063dSJacob Faibussowitsch   if (simplex) PetscCall(DMPlexInterpolateInPlace_Internal(dm));
28003ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
28019318fe57SMatthew G. Knepley }
28029318fe57SMatthew G. Knepley 
2803b7f5c055SJed Brown typedef void (*TPSEvaluateFunc)(const PetscReal[], PetscReal *, PetscReal[], PetscReal (*)[3]);
2804b7f5c055SJed Brown 
2805b7f5c055SJed Brown /*
2806b7f5c055SJed Brown  The Schwarz P implicit surface is
2807b7f5c055SJed Brown 
2808b7f5c055SJed Brown      f(x) = cos(x0) + cos(x1) + cos(x2) = 0
2809b7f5c055SJed Brown */
2810d71ae5a4SJacob Faibussowitsch static void TPSEvaluate_SchwarzP(const PetscReal y[3], PetscReal *f, PetscReal grad[], PetscReal (*hess)[3])
2811d71ae5a4SJacob Faibussowitsch {
2812b7f5c055SJed Brown   PetscReal c[3] = {PetscCosReal(y[0] * PETSC_PI), PetscCosReal(y[1] * PETSC_PI), PetscCosReal(y[2] * PETSC_PI)};
2813b7f5c055SJed Brown   PetscReal g[3] = {-PetscSinReal(y[0] * PETSC_PI), -PetscSinReal(y[1] * PETSC_PI), -PetscSinReal(y[2] * PETSC_PI)};
2814b7f5c055SJed Brown   f[0]           = c[0] + c[1] + c[2];
2815b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) {
2816b7f5c055SJed Brown     grad[i] = PETSC_PI * g[i];
2817ad540459SPierre Jolivet     for (PetscInt j = 0; j < 3; j++) hess[i][j] = (i == j) ? -PetscSqr(PETSC_PI) * c[i] : 0.;
2818b7f5c055SJed Brown   }
2819b7f5c055SJed Brown }
2820b7f5c055SJed Brown 
28214663dae6SJed Brown // u[] is a tentative normal on input. Replace with the implicit function gradient in the same direction
2822d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSExtrudeNormalFunc_SchwarzP(PetscInt dim, PetscReal time, const PetscReal x[], PetscInt r, PetscScalar u[], void *ctx)
2823d71ae5a4SJacob Faibussowitsch {
2824ad540459SPierre Jolivet   for (PetscInt i = 0; i < 3; i++) u[i] = -PETSC_PI * PetscSinReal(x[i] * PETSC_PI);
28253ba16761SJacob Faibussowitsch   return PETSC_SUCCESS;
28264663dae6SJed Brown }
28274663dae6SJed Brown 
2828b7f5c055SJed Brown /*
2829b7f5c055SJed Brown  The Gyroid implicit surface is
2830b7f5c055SJed Brown 
2831b7f5c055SJed 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)
2832b7f5c055SJed Brown 
2833b7f5c055SJed Brown */
2834d71ae5a4SJacob Faibussowitsch static void TPSEvaluate_Gyroid(const PetscReal y[3], PetscReal *f, PetscReal grad[], PetscReal (*hess)[3])
2835d71ae5a4SJacob Faibussowitsch {
2836b7f5c055SJed Brown   PetscReal s[3] = {PetscSinReal(PETSC_PI * y[0]), PetscSinReal(PETSC_PI * (y[1] + .5)), PetscSinReal(PETSC_PI * (y[2] + .25))};
2837b7f5c055SJed Brown   PetscReal c[3] = {PetscCosReal(PETSC_PI * y[0]), PetscCosReal(PETSC_PI * (y[1] + .5)), PetscCosReal(PETSC_PI * (y[2] + .25))};
2838b7f5c055SJed Brown   f[0]           = s[0] * c[1] + s[1] * c[2] + s[2] * c[0];
2839b7f5c055SJed Brown   grad[0]        = PETSC_PI * (c[0] * c[1] - s[2] * s[0]);
2840b7f5c055SJed Brown   grad[1]        = PETSC_PI * (c[1] * c[2] - s[0] * s[1]);
2841b7f5c055SJed Brown   grad[2]        = PETSC_PI * (c[2] * c[0] - s[1] * s[2]);
2842b7f5c055SJed Brown   hess[0][0]     = -PetscSqr(PETSC_PI) * (s[0] * c[1] + s[2] * c[0]);
2843b7f5c055SJed Brown   hess[0][1]     = -PetscSqr(PETSC_PI) * (c[0] * s[1]);
2844b7f5c055SJed Brown   hess[0][2]     = -PetscSqr(PETSC_PI) * (c[2] * s[0]);
2845b7f5c055SJed Brown   hess[1][0]     = -PetscSqr(PETSC_PI) * (s[1] * c[2] + s[0] * c[1]);
2846b7f5c055SJed Brown   hess[1][1]     = -PetscSqr(PETSC_PI) * (c[1] * s[2]);
2847b7f5c055SJed Brown   hess[2][2]     = -PetscSqr(PETSC_PI) * (c[0] * s[1]);
2848b7f5c055SJed Brown   hess[2][0]     = -PetscSqr(PETSC_PI) * (s[2] * c[0] + s[1] * c[2]);
2849b7f5c055SJed Brown   hess[2][1]     = -PetscSqr(PETSC_PI) * (c[2] * s[0]);
2850b7f5c055SJed Brown   hess[2][2]     = -PetscSqr(PETSC_PI) * (c[1] * s[2]);
2851b7f5c055SJed Brown }
2852b7f5c055SJed Brown 
28534663dae6SJed Brown // u[] is a tentative normal on input. Replace with the implicit function gradient in the same direction
2854d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSExtrudeNormalFunc_Gyroid(PetscInt dim, PetscReal time, const PetscReal x[], PetscInt r, PetscScalar u[], void *ctx)
2855d71ae5a4SJacob Faibussowitsch {
28564663dae6SJed Brown   PetscReal s[3] = {PetscSinReal(PETSC_PI * x[0]), PetscSinReal(PETSC_PI * (x[1] + .5)), PetscSinReal(PETSC_PI * (x[2] + .25))};
28574663dae6SJed Brown   PetscReal c[3] = {PetscCosReal(PETSC_PI * x[0]), PetscCosReal(PETSC_PI * (x[1] + .5)), PetscCosReal(PETSC_PI * (x[2] + .25))};
28584663dae6SJed Brown   u[0]           = PETSC_PI * (c[0] * c[1] - s[2] * s[0]);
28594663dae6SJed Brown   u[1]           = PETSC_PI * (c[1] * c[2] - s[0] * s[1]);
28604663dae6SJed Brown   u[2]           = PETSC_PI * (c[2] * c[0] - s[1] * s[2]);
28613ba16761SJacob Faibussowitsch   return PETSC_SUCCESS;
28624663dae6SJed Brown }
28634663dae6SJed Brown 
2864b7f5c055SJed Brown /*
2865b7f5c055SJed Brown    We wish to solve
2866b7f5c055SJed Brown 
2867b7f5c055SJed Brown          min_y || y - x ||^2  subject to f(y) = 0
2868b7f5c055SJed Brown 
2869b7f5c055SJed Brown    Let g(y) = grad(f).  The minimization problem is equivalent to asking to satisfy
2870b7f5c055SJed 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
2871b7f5c055SJed Brown    tangent space and ask for both components in the tangent space to be zero.
2872b7f5c055SJed Brown 
2873b7f5c055SJed Brown    Take g to be a column vector and compute the "full QR" factorization Q R = g,
2874b7f5c055SJed Brown    where Q = I - 2 n n^T is a symmetric orthogonal matrix.
2875b7f5c055SJed Brown    The first column of Q is parallel to g so the remaining two columns span the null space.
2876b7f5c055SJed Brown    Let Qn = Q[:,1:] be those remaining columns.  Then Qn Qn^T is an orthogonal projector into the tangent space.
2877da81f932SPierre Jolivet    Since Q is symmetric, this is equivalent to multiplying by Q and taking the last two entries.
2878b7f5c055SJed Brown    In total, we have a system of 3 equations in 3 unknowns:
2879b7f5c055SJed Brown 
2880b7f5c055SJed Brown      f(y) = 0                       1 equation
2881b7f5c055SJed Brown      Qn^T (y - x) = 0               2 equations
2882b7f5c055SJed Brown 
2883b7f5c055SJed Brown    Here, we compute the residual and Jacobian of this system.
2884b7f5c055SJed Brown */
2885d71ae5a4SJacob Faibussowitsch static void TPSNearestPointResJac(TPSEvaluateFunc feval, const PetscScalar x[], const PetscScalar y[], PetscScalar res[], PetscScalar J[])
2886d71ae5a4SJacob Faibussowitsch {
2887b7f5c055SJed Brown   PetscReal yreal[3] = {PetscRealPart(y[0]), PetscRealPart(y[1]), PetscRealPart(y[2])};
2888b7f5c055SJed Brown   PetscReal d[3]     = {PetscRealPart(y[0] - x[0]), PetscRealPart(y[1] - x[1]), PetscRealPart(y[2] - x[2])};
28892f0490c0SSatish Balay   PetscReal f, grad[3], n[3], norm, norm_y[3], nd, nd_y[3], sign;
28909371c9d4SSatish Balay   PetscReal n_y[3][3] = {
28919371c9d4SSatish Balay     {0, 0, 0},
28929371c9d4SSatish Balay     {0, 0, 0},
28939371c9d4SSatish Balay     {0, 0, 0}
28949371c9d4SSatish Balay   };
2895b7f5c055SJed Brown 
2896b7f5c055SJed Brown   feval(yreal, &f, grad, n_y);
2897b7f5c055SJed Brown 
2898b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) n[i] = grad[i];
2899b7f5c055SJed Brown   norm = PetscSqrtReal(PetscSqr(n[0]) + PetscSqr(n[1]) + PetscSqr(n[2]));
2900ad540459SPierre Jolivet   for (PetscInt i = 0; i < 3; i++) norm_y[i] = 1. / norm * n[i] * n_y[i][i];
2901b7f5c055SJed Brown 
2902b7f5c055SJed Brown   // Define the Householder reflector
2903b7f5c055SJed Brown   sign = n[0] >= 0 ? 1. : -1.;
2904b7f5c055SJed Brown   n[0] += norm * sign;
2905b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) n_y[0][i] += norm_y[i] * sign;
2906b7f5c055SJed Brown 
2907b7f5c055SJed Brown   norm      = PetscSqrtReal(PetscSqr(n[0]) + PetscSqr(n[1]) + PetscSqr(n[2]));
2908b7f5c055SJed Brown   norm_y[0] = 1. / norm * (n[0] * n_y[0][0]);
2909b7f5c055SJed Brown   norm_y[1] = 1. / norm * (n[0] * n_y[0][1] + n[1] * n_y[1][1]);
2910b7f5c055SJed Brown   norm_y[2] = 1. / norm * (n[0] * n_y[0][2] + n[2] * n_y[2][2]);
2911b7f5c055SJed Brown 
2912b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) {
2913b7f5c055SJed Brown     n[i] /= norm;
2914b7f5c055SJed Brown     for (PetscInt j = 0; j < 3; j++) {
2915b7f5c055SJed Brown       // note that n[i] is n_old[i]/norm when executing the code below
2916b7f5c055SJed Brown       n_y[i][j] = n_y[i][j] / norm - n[i] / norm * norm_y[j];
2917b7f5c055SJed Brown     }
2918b7f5c055SJed Brown   }
2919b7f5c055SJed Brown 
2920b7f5c055SJed Brown   nd = n[0] * d[0] + n[1] * d[1] + n[2] * d[2];
2921b7f5c055SJed 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];
2922b7f5c055SJed Brown 
2923b7f5c055SJed Brown   res[0] = f;
2924b7f5c055SJed Brown   res[1] = d[1] - 2 * n[1] * nd;
2925b7f5c055SJed Brown   res[2] = d[2] - 2 * n[2] * nd;
2926b7f5c055SJed Brown   // J[j][i] is J_{ij} (column major)
2927b7f5c055SJed Brown   for (PetscInt j = 0; j < 3; j++) {
2928b7f5c055SJed Brown     J[0 + j * 3] = grad[j];
2929b7f5c055SJed Brown     J[1 + j * 3] = (j == 1) * 1. - 2 * (n_y[1][j] * nd + n[1] * nd_y[j]);
2930b7f5c055SJed Brown     J[2 + j * 3] = (j == 2) * 1. - 2 * (n_y[2][j] * nd + n[2] * nd_y[j]);
2931b7f5c055SJed Brown   }
2932b7f5c055SJed Brown }
2933b7f5c055SJed Brown 
2934b7f5c055SJed Brown /*
2935b7f5c055SJed Brown    Project x to the nearest point on the implicit surface using Newton's method.
2936b7f5c055SJed Brown */
2937d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSNearestPoint(TPSEvaluateFunc feval, PetscScalar x[])
2938d71ae5a4SJacob Faibussowitsch {
2939b7f5c055SJed Brown   PetscScalar y[3] = {x[0], x[1], x[2]}; // Initial guess
2940b7f5c055SJed Brown 
2941b7f5c055SJed Brown   PetscFunctionBegin;
2942b7f5c055SJed Brown   for (PetscInt iter = 0; iter < 10; iter++) {
2943b7f5c055SJed Brown     PetscScalar res[3], J[9];
2944b7f5c055SJed Brown     PetscReal   resnorm;
2945b7f5c055SJed Brown     TPSNearestPointResJac(feval, x, y, res, J);
2946b7f5c055SJed Brown     resnorm = PetscSqrtReal(PetscSqr(PetscRealPart(res[0])) + PetscSqr(PetscRealPart(res[1])) + PetscSqr(PetscRealPart(res[2])));
2947b7f5c055SJed Brown     if (0) { // Turn on this monitor if you need to confirm quadratic convergence
294863a3b9bcSJacob 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])));
2949b7f5c055SJed Brown     }
2950b7f5c055SJed Brown     if (resnorm < PETSC_SMALL) break;
2951b7f5c055SJed Brown 
2952b7f5c055SJed Brown     // Take the Newton step
29539566063dSJacob Faibussowitsch     PetscCall(PetscKernel_A_gets_inverse_A_3(J, 0., PETSC_FALSE, NULL));
2954b7f5c055SJed Brown     PetscKernel_v_gets_v_minus_A_times_w_3(y, J, res);
2955b7f5c055SJed Brown   }
2956b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) x[i] = y[i];
29573ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2958b7f5c055SJed Brown }
2959b7f5c055SJed Brown 
2960b7f5c055SJed Brown const char *const DMPlexTPSTypes[] = {"SCHWARZ_P", "GYROID", "DMPlexTPSType", "DMPLEX_TPS_", NULL};
2961b7f5c055SJed Brown 
2962d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateTPSMesh_Internal(DM dm, DMPlexTPSType tpstype, const PetscInt extent[], const DMBoundaryType periodic[], PetscBool tps_distribute, PetscInt refinements, PetscInt layers, PetscReal thickness)
2963d71ae5a4SJacob Faibussowitsch {
2964b7f5c055SJed Brown   PetscMPIInt rank;
2965b7f5c055SJed Brown   PetscInt    topoDim = 2, spaceDim = 3, numFaces = 0, numVertices = 0, numEdges = 0;
2966b7f5c055SJed Brown   PetscInt(*edges)[2] = NULL, *edgeSets = NULL;
2967b7f5c055SJed Brown   PetscInt            *cells_flat = NULL;
2968b7f5c055SJed Brown   PetscReal           *vtxCoords  = NULL;
2969b7f5c055SJed Brown   TPSEvaluateFunc      evalFunc   = NULL;
29704663dae6SJed Brown   PetscSimplePointFunc normalFunc = NULL;
2971b7f5c055SJed Brown   DMLabel              label;
2972b7f5c055SJed Brown 
2973b7f5c055SJed Brown   PetscFunctionBegin;
297446139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
29759566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
297663a3b9bcSJacob 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);
2977b7f5c055SJed Brown   switch (tpstype) {
2978b7f5c055SJed Brown   case DMPLEX_TPS_SCHWARZ_P:
2979b7f5c055SJed 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");
2980c5853193SPierre Jolivet     if (rank == 0) {
2981b7f5c055SJed Brown       PetscInt(*cells)[6][4][4] = NULL; // [junction, junction-face, cell, conn]
2982b7f5c055SJed Brown       PetscInt  Njunctions = 0, Ncuts = 0, Npipes[3], vcount;
2983b7f5c055SJed Brown       PetscReal L = 1;
2984b7f5c055SJed Brown 
2985b7f5c055SJed Brown       Npipes[0]   = (extent[0] + 1) * extent[1] * extent[2];
2986b7f5c055SJed Brown       Npipes[1]   = extent[0] * (extent[1] + 1) * extent[2];
2987b7f5c055SJed Brown       Npipes[2]   = extent[0] * extent[1] * (extent[2] + 1);
2988b7f5c055SJed Brown       Njunctions  = extent[0] * extent[1] * extent[2];
2989b7f5c055SJed Brown       Ncuts       = 2 * (extent[0] * extent[1] + extent[1] * extent[2] + extent[2] * extent[0]);
2990b7f5c055SJed Brown       numVertices = 4 * (Npipes[0] + Npipes[1] + Npipes[2]) + 8 * Njunctions;
29919566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(3 * numVertices, &vtxCoords));
29929566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Njunctions, &cells));
29939566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Ncuts * 4, &edges));
29949566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Ncuts * 4, &edgeSets));
2995b7f5c055SJed Brown       // x-normal pipes
2996b7f5c055SJed Brown       vcount = 0;
2997b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0] + 1; i++) {
2998b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
2999b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3000b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3001b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * i - 1) * L;
3002b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * j * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3003b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * k * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3004b7f5c055SJed Brown             }
3005b7f5c055SJed Brown           }
3006b7f5c055SJed Brown         }
3007b7f5c055SJed Brown       }
3008b7f5c055SJed Brown       // y-normal pipes
3009b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3010b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1] + 1; j++) {
3011b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3012b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3013b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * i * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3014b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * j - 1) * L;
3015b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * k * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3016b7f5c055SJed Brown             }
3017b7f5c055SJed Brown           }
3018b7f5c055SJed Brown         }
3019b7f5c055SJed Brown       }
3020b7f5c055SJed Brown       // z-normal pipes
3021b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3022b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3023b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2] + 1; k++) {
3024b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3025b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * i * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3026b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * j * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3027b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * k - 1) * L;
3028b7f5c055SJed Brown             }
3029b7f5c055SJed Brown           }
3030b7f5c055SJed Brown         }
3031b7f5c055SJed Brown       }
3032b7f5c055SJed Brown       // junctions
3033b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3034b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3035b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3036b7f5c055SJed Brown             const PetscInt J = (i * extent[1] + j) * extent[2] + k, Jvoff = (Npipes[0] + Npipes[1] + Npipes[2]) * 4 + J * 8;
3037b7f5c055SJed Brown             PetscCheck(vcount / 3 == Jvoff, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Unexpected vertex count");
3038b7f5c055SJed Brown             for (PetscInt ii = 0; ii < 2; ii++) {
3039b7f5c055SJed Brown               for (PetscInt jj = 0; jj < 2; jj++) {
3040b7f5c055SJed Brown                 for (PetscInt kk = 0; kk < 2; kk++) {
3041b7f5c055SJed Brown                   double Ls           = (1 - sqrt(2) / 4) * L;
3042b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * i * L + (2 * ii - 1) * Ls;
3043b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * j * L + (2 * jj - 1) * Ls;
3044b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * k * L + (2 * kk - 1) * Ls;
3045b7f5c055SJed Brown                 }
3046b7f5c055SJed Brown               }
3047b7f5c055SJed Brown             }
3048b7f5c055SJed Brown             const PetscInt jfaces[3][2][4] = {
3049b7f5c055SJed Brown               {{3, 1, 0, 2}, {7, 5, 4, 6}}, // x-aligned
3050b7f5c055SJed Brown               {{5, 4, 0, 1}, {7, 6, 2, 3}}, // y-aligned
3051b7f5c055SJed Brown               {{6, 2, 0, 4}, {7, 3, 1, 5}}  // z-aligned
3052b7f5c055SJed Brown             };
3053b7f5c055SJed Brown             const PetscInt pipe_lo[3] = {// vertex numbers of pipes
30549371c9d4SSatish 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};
3055b7f5c055SJed Brown             const PetscInt pipe_hi[3] = {// vertex numbers of pipes
30569371c9d4SSatish 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};
3057b7f5c055SJed Brown             for (PetscInt dir = 0; dir < 3; dir++) { // x,y,z
3058b7f5c055SJed Brown               const PetscInt ijk[3] = {i, j, k};
3059b7f5c055SJed Brown               for (PetscInt l = 0; l < 4; l++) { // rotations
3060b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][0] = pipe_lo[dir] + l;
3061b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][1] = Jvoff + jfaces[dir][0][l];
3062b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][2] = Jvoff + jfaces[dir][0][(l - 1 + 4) % 4];
3063b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][3] = pipe_lo[dir] + (l - 1 + 4) % 4;
3064b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][0] = Jvoff + jfaces[dir][1][l];
3065b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][1] = pipe_hi[dir] + l;
3066b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][2] = pipe_hi[dir] + (l - 1 + 4) % 4;
3067b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][3] = Jvoff + jfaces[dir][1][(l - 1 + 4) % 4];
3068b7f5c055SJed Brown                 if (ijk[dir] == 0) {
3069b7f5c055SJed Brown                   edges[numEdges][0] = pipe_lo[dir] + l;
3070b7f5c055SJed Brown                   edges[numEdges][1] = pipe_lo[dir] + (l + 1) % 4;
3071b7f5c055SJed Brown                   edgeSets[numEdges] = dir * 2 + 1;
3072b7f5c055SJed Brown                   numEdges++;
3073b7f5c055SJed Brown                 }
3074b7f5c055SJed Brown                 if (ijk[dir] + 1 == extent[dir]) {
3075b7f5c055SJed Brown                   edges[numEdges][0] = pipe_hi[dir] + l;
3076b7f5c055SJed Brown                   edges[numEdges][1] = pipe_hi[dir] + (l + 1) % 4;
3077b7f5c055SJed Brown                   edgeSets[numEdges] = dir * 2 + 2;
3078b7f5c055SJed Brown                   numEdges++;
3079b7f5c055SJed Brown                 }
3080b7f5c055SJed Brown               }
3081b7f5c055SJed Brown             }
3082b7f5c055SJed Brown           }
3083b7f5c055SJed Brown         }
3084b7f5c055SJed Brown       }
308563a3b9bcSJacob Faibussowitsch       PetscCheck(numEdges == Ncuts * 4, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Edge count %" PetscInt_FMT " incompatible with number of cuts %" PetscInt_FMT, numEdges, Ncuts);
3086b7f5c055SJed Brown       numFaces   = 24 * Njunctions;
3087b7f5c055SJed Brown       cells_flat = cells[0][0][0];
3088b7f5c055SJed Brown     }
3089b7f5c055SJed Brown     evalFunc   = TPSEvaluate_SchwarzP;
30904663dae6SJed Brown     normalFunc = TPSExtrudeNormalFunc_SchwarzP;
3091b7f5c055SJed Brown     break;
3092b7f5c055SJed Brown   case DMPLEX_TPS_GYROID:
3093c5853193SPierre Jolivet     if (rank == 0) {
3094b7f5c055SJed Brown       // This is a coarse mesh approximation of the gyroid shifted to being the zero of the level set
3095b7f5c055SJed Brown       //
3096b7f5c055SJed 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)
3097b7f5c055SJed Brown       //
3098b7f5c055SJed Brown       // on the cell [0,2]^3.
3099b7f5c055SJed Brown       //
3100b7f5c055SJed Brown       // Think about dividing that cell into four columns, and focus on the column [0,1]x[0,1]x[0,2].
3101b7f5c055SJed Brown       // If you looked at the gyroid in that column at different slices of z you would see that it kind of spins
3102b7f5c055SJed Brown       // like a boomerang:
3103b7f5c055SJed Brown       //
3104b7f5c055SJed Brown       //     z = 0          z = 1/4        z = 1/2        z = 3/4     //
3105b7f5c055SJed Brown       //     -----          -------        -------        -------     //
3106b7f5c055SJed Brown       //                                                              //
3107b7f5c055SJed Brown       //     +       +      +       +      +       +      +   \   +   //
3108b7f5c055SJed Brown       //      \                                   /            \      //
3109b7f5c055SJed Brown       //       \            `-_   _-'            /              }     //
3110b7f5c055SJed Brown       //        *-_            `-'            _-'              /      //
3111b7f5c055SJed Brown       //     +     `-+      +       +      +-'     +      +   /   +   //
3112b7f5c055SJed Brown       //                                                              //
3113b7f5c055SJed Brown       //                                                              //
3114b7f5c055SJed Brown       //     z = 1          z = 5/4        z = 3/2        z = 7/4     //
3115b7f5c055SJed Brown       //     -----          -------        -------        -------     //
3116b7f5c055SJed Brown       //                                                              //
3117b7f5c055SJed Brown       //     +-_     +      +       +      +     _-+      +   /   +   //
3118b7f5c055SJed Brown       //        `-_            _-_            _-`            /        //
3119b7f5c055SJed Brown       //           \        _-'   `-_        /              {         //
3120b7f5c055SJed Brown       //            \                       /                \        //
3121b7f5c055SJed Brown       //     +       +      +       +      +       +      +   \   +   //
3122b7f5c055SJed Brown       //
3123b7f5c055SJed Brown       //
3124b7f5c055SJed Brown       // This course mesh approximates each of these slices by two line segments,
3125b7f5c055SJed Brown       // and then connects the segments in consecutive layers with quadrilateral faces.
3126b7f5c055SJed Brown       // All of the end points of the segments are multiples of 1/4 except for the
3127b7f5c055SJed Brown       // point * in the picture for z = 0 above and the similar points in other layers.
3128b7f5c055SJed Brown       // That point is at (gamma, gamma, 0), where gamma is calculated below.
3129b7f5c055SJed Brown       //
3130b7f5c055SJed Brown       // The column  [1,2]x[1,2]x[0,2] looks the same as this column;
3131b7f5c055SJed Brown       // The columns [1,2]x[0,1]x[0,2] and [0,1]x[1,2]x[0,2] are mirror images.
3132b7f5c055SJed Brown       //
3133b7f5c055SJed Brown       // As for how this method turned into the names given to the vertices:
3134b7f5c055SJed Brown       // that was not systematic, it was just the way it worked out in my handwritten notes.
3135b7f5c055SJed Brown 
3136b7f5c055SJed Brown       PetscInt facesPerBlock = 64;
3137b7f5c055SJed Brown       PetscInt vertsPerBlock = 56;
3138b7f5c055SJed Brown       PetscInt extentPlus[3];
3139b7f5c055SJed Brown       PetscInt numBlocks, numBlocksPlus;
31409371c9d4SSatish 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;
31419371c9d4SSatish Balay       const PetscInt pattern[64][4] = {
31429371c9d4SSatish Balay   /* face to vertex within the coarse discretization of a single gyroid block */
3143b7f5c055SJed Brown   /* layer 0 */
31449371c9d4SSatish Balay         {A,           C,           K,           G          },
31459371c9d4SSatish Balay         {C,           B,           II,          K          },
31469371c9d4SSatish Balay         {D,           A,           H,           L          },
31479371c9d4SSatish Balay         {B + 56 * 1,  D,           L,           J          },
31489371c9d4SSatish Balay         {E,           B + 56 * 1,  J,           N          },
31499371c9d4SSatish Balay         {A + 56 * 2,  E,           N,           H + 56 * 2 },
31509371c9d4SSatish Balay         {F,           A + 56 * 2,  G + 56 * 2,  M          },
31519371c9d4SSatish Balay         {B,           F,           M,           II         },
3152b7f5c055SJed Brown  /* layer 1 */
31539371c9d4SSatish Balay         {G,           K,           Q,           O          },
31549371c9d4SSatish Balay         {K,           II,          P,           Q          },
31559371c9d4SSatish Balay         {L,           H,           O + 56 * 1,  R          },
31569371c9d4SSatish Balay         {J,           L,           R,           P          },
31579371c9d4SSatish Balay         {N,           J,           P,           S          },
31589371c9d4SSatish Balay         {H + 56 * 2,  N,           S,           O + 56 * 3 },
31599371c9d4SSatish Balay         {M,           G + 56 * 2,  O + 56 * 2,  T          },
31609371c9d4SSatish Balay         {II,          M,           T,           P          },
3161b7f5c055SJed Brown  /* layer 2 */
31629371c9d4SSatish Balay         {O,           Q,           Y,           U          },
31639371c9d4SSatish Balay         {Q,           P,           W,           Y          },
31649371c9d4SSatish Balay         {R,           O + 56 * 1,  U + 56 * 1,  Ap         },
31659371c9d4SSatish Balay         {P,           R,           Ap,          W          },
31669371c9d4SSatish Balay         {S,           P,           X,           Bp         },
31679371c9d4SSatish Balay         {O + 56 * 3,  S,           Bp,          V + 56 * 1 },
31689371c9d4SSatish Balay         {T,           O + 56 * 2,  V,           Z          },
31699371c9d4SSatish Balay         {P,           T,           Z,           X          },
3170b7f5c055SJed Brown  /* layer 3 */
31719371c9d4SSatish Balay         {U,           Y,           Ep,          Dp         },
31729371c9d4SSatish Balay         {Y,           W,           Cp,          Ep         },
31739371c9d4SSatish Balay         {Ap,          U + 56 * 1,  Dp + 56 * 1, Gp         },
31749371c9d4SSatish Balay         {W,           Ap,          Gp,          Cp         },
31759371c9d4SSatish Balay         {Bp,          X,           Cp + 56 * 2, Fp         },
31769371c9d4SSatish Balay         {V + 56 * 1,  Bp,          Fp,          Dp + 56 * 1},
31779371c9d4SSatish Balay         {Z,           V,           Dp,          Hp         },
31789371c9d4SSatish Balay         {X,           Z,           Hp,          Cp + 56 * 2},
3179b7f5c055SJed Brown  /* layer 4 */
31809371c9d4SSatish Balay         {Dp,          Ep,          Mp,          Kp         },
31819371c9d4SSatish Balay         {Ep,          Cp,          Ip,          Mp         },
31829371c9d4SSatish Balay         {Gp,          Dp + 56 * 1, Lp,          Np         },
31839371c9d4SSatish Balay         {Cp,          Gp,          Np,          Jp         },
31849371c9d4SSatish Balay         {Fp,          Cp + 56 * 2, Jp + 56 * 2, Pp         },
31859371c9d4SSatish Balay         {Dp + 56 * 1, Fp,          Pp,          Lp         },
31869371c9d4SSatish Balay         {Hp,          Dp,          Kp,          Op         },
31879371c9d4SSatish Balay         {Cp + 56 * 2, Hp,          Op,          Ip + 56 * 2},
3188b7f5c055SJed Brown  /* layer 5 */
31899371c9d4SSatish Balay         {Kp,          Mp,          Sp,          Rp         },
31909371c9d4SSatish Balay         {Mp,          Ip,          Qp,          Sp         },
31919371c9d4SSatish Balay         {Np,          Lp,          Rp,          Tp         },
31929371c9d4SSatish Balay         {Jp,          Np,          Tp,          Qp + 56 * 1},
31939371c9d4SSatish Balay         {Pp,          Jp + 56 * 2, Qp + 56 * 3, Up         },
31949371c9d4SSatish Balay         {Lp,          Pp,          Up,          Rp         },
31959371c9d4SSatish Balay         {Op,          Kp,          Rp,          Vp         },
31969371c9d4SSatish Balay         {Ip + 56 * 2, Op,          Vp,          Qp + 56 * 2},
3197b7f5c055SJed Brown  /* layer 6 */
31989371c9d4SSatish Balay         {Rp,          Sp,          Aq,          Yp         },
31999371c9d4SSatish Balay         {Sp,          Qp,          Wp,          Aq         },
32009371c9d4SSatish Balay         {Tp,          Rp,          Yp,          Cq         },
32019371c9d4SSatish Balay         {Qp + 56 * 1, Tp,          Cq,          Wp + 56 * 1},
32029371c9d4SSatish Balay         {Up,          Qp + 56 * 3, Xp + 56 * 1, Dq         },
32039371c9d4SSatish Balay         {Rp,          Up,          Dq,          Zp         },
32049371c9d4SSatish Balay         {Vp,          Rp,          Zp,          Bq         },
32059371c9d4SSatish Balay         {Qp + 56 * 2, Vp,          Bq,          Xp         },
3206b7f5c055SJed Brown  /* layer 7 (the top is the periodic image of the bottom of layer 0) */
32079371c9d4SSatish Balay         {Yp,          Aq,          C + 56 * 4,  A + 56 * 4 },
32089371c9d4SSatish Balay         {Aq,          Wp,          B + 56 * 4,  C + 56 * 4 },
32099371c9d4SSatish Balay         {Cq,          Yp,          A + 56 * 4,  D + 56 * 4 },
32109371c9d4SSatish Balay         {Wp + 56 * 1, Cq,          D + 56 * 4,  B + 56 * 5 },
32119371c9d4SSatish Balay         {Dq,          Xp + 56 * 1, B + 56 * 5,  E + 56 * 4 },
32129371c9d4SSatish Balay         {Zp,          Dq,          E + 56 * 4,  A + 56 * 6 },
32139371c9d4SSatish Balay         {Bq,          Zp,          A + 56 * 6,  F + 56 * 4 },
32149371c9d4SSatish Balay         {Xp,          Bq,          F + 56 * 4,  B + 56 * 4 }
3215b7f5c055SJed Brown       };
3216b7f5c055SJed Brown       const PetscReal gamma                = PetscAcosReal((PetscSqrtReal(3.) - 1.) / PetscSqrtReal(2.)) / PETSC_PI;
32179371c9d4SSatish Balay       const PetscReal patternCoords[56][3] = {
3218bee3fc89SBarry Smith         {1.,        0.,        0.  }, /* A  */
3219bee3fc89SBarry Smith         {0.,        1.,        0.  }, /* B  */
3220bee3fc89SBarry Smith         {gamma,     gamma,     0.  }, /* C  */
3221bee3fc89SBarry Smith         {1 + gamma, 1 - gamma, 0.  }, /* D  */
3222bee3fc89SBarry Smith         {2 - gamma, 2 - gamma, 0.  }, /* E  */
3223bee3fc89SBarry Smith         {1 - gamma, 1 + gamma, 0.  }, /* F  */
3224b7f5c055SJed Brown 
3225bee3fc89SBarry Smith         {.5,        0,         .25 }, /* G  */
3226bee3fc89SBarry Smith         {1.5,       0.,        .25 }, /* H  */
3227bee3fc89SBarry Smith         {.5,        1.,        .25 }, /* II */
3228bee3fc89SBarry Smith         {1.5,       1.,        .25 }, /* J  */
3229bee3fc89SBarry Smith         {.25,       .5,        .25 }, /* K  */
3230bee3fc89SBarry Smith         {1.25,      .5,        .25 }, /* L  */
3231bee3fc89SBarry Smith         {.75,       1.5,       .25 }, /* M  */
3232bee3fc89SBarry Smith         {1.75,      1.5,       .25 }, /* N  */
3233b7f5c055SJed Brown 
3234bee3fc89SBarry Smith         {0.,        0.,        .5  }, /* O  */
3235bee3fc89SBarry Smith         {1.,        1.,        .5  }, /* P  */
3236bee3fc89SBarry Smith         {gamma,     1 - gamma, .5  }, /* Q  */
3237bee3fc89SBarry Smith         {1 + gamma, gamma,     .5  }, /* R  */
3238bee3fc89SBarry Smith         {2 - gamma, 1 + gamma, .5  }, /* S  */
3239bee3fc89SBarry Smith         {1 - gamma, 2 - gamma, .5  }, /* T  */
3240b7f5c055SJed Brown 
3241bee3fc89SBarry Smith         {0.,        .5,        .75 }, /* U  */
3242bee3fc89SBarry Smith         {0.,        1.5,       .75 }, /* V  */
3243bee3fc89SBarry Smith         {1.,        .5,        .75 }, /* W  */
3244bee3fc89SBarry Smith         {1.,        1.5,       .75 }, /* X  */
3245bee3fc89SBarry Smith         {.5,        .75,       .75 }, /* Y  */
3246bee3fc89SBarry Smith         {.5,        1.75,      .75 }, /* Z  */
3247bee3fc89SBarry Smith         {1.5,       .25,       .75 }, /* Ap */
3248bee3fc89SBarry Smith         {1.5,       1.25,      .75 }, /* Bp */
3249b7f5c055SJed Brown 
3250bee3fc89SBarry Smith         {1.,        0.,        1.  }, /* Cp */
3251bee3fc89SBarry Smith         {0.,        1.,        1.  }, /* Dp */
3252bee3fc89SBarry Smith         {1 - gamma, 1 - gamma, 1.  }, /* Ep */
3253bee3fc89SBarry Smith         {1 + gamma, 1 + gamma, 1.  }, /* Fp */
3254bee3fc89SBarry Smith         {2 - gamma, gamma,     1.  }, /* Gp */
3255bee3fc89SBarry Smith         {gamma,     2 - gamma, 1.  }, /* Hp */
3256b7f5c055SJed Brown 
3257bee3fc89SBarry Smith         {.5,        0.,        1.25}, /* Ip */
3258bee3fc89SBarry Smith         {1.5,       0.,        1.25}, /* Jp */
3259bee3fc89SBarry Smith         {.5,        1.,        1.25}, /* Kp */
3260bee3fc89SBarry Smith         {1.5,       1.,        1.25}, /* Lp */
3261bee3fc89SBarry Smith         {.75,       .5,        1.25}, /* Mp */
3262bee3fc89SBarry Smith         {1.75,      .5,        1.25}, /* Np */
3263bee3fc89SBarry Smith         {.25,       1.5,       1.25}, /* Op */
3264bee3fc89SBarry Smith         {1.25,      1.5,       1.25}, /* Pp */
3265b7f5c055SJed Brown 
3266bee3fc89SBarry Smith         {0.,        0.,        1.5 }, /* Qp */
3267bee3fc89SBarry Smith         {1.,        1.,        1.5 }, /* Rp */
3268bee3fc89SBarry Smith         {1 - gamma, gamma,     1.5 }, /* Sp */
3269bee3fc89SBarry Smith         {2 - gamma, 1 - gamma, 1.5 }, /* Tp */
3270bee3fc89SBarry Smith         {1 + gamma, 2 - gamma, 1.5 }, /* Up */
3271bee3fc89SBarry Smith         {gamma,     1 + gamma, 1.5 }, /* Vp */
3272b7f5c055SJed Brown 
3273bee3fc89SBarry Smith         {0.,        .5,        1.75}, /* Wp */
3274bee3fc89SBarry Smith         {0.,        1.5,       1.75}, /* Xp */
3275bee3fc89SBarry Smith         {1.,        .5,        1.75}, /* Yp */
3276bee3fc89SBarry Smith         {1.,        1.5,       1.75}, /* Zp */
3277bee3fc89SBarry Smith         {.5,        .25,       1.75}, /* Aq */
3278bee3fc89SBarry Smith         {.5,        1.25,      1.75}, /* Bq */
3279bee3fc89SBarry Smith         {1.5,       .75,       1.75}, /* Cq */
3280bee3fc89SBarry Smith         {1.5,       1.75,      1.75}, /* Dq */
3281b7f5c055SJed Brown       };
3282b7f5c055SJed Brown       PetscInt(*cells)[64][4] = NULL;
3283b7f5c055SJed Brown       PetscBool *seen;
3284b7f5c055SJed Brown       PetscInt  *vertToTrueVert;
3285b7f5c055SJed Brown       PetscInt   count;
3286b7f5c055SJed Brown 
3287b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) extentPlus[i] = extent[i] + 1;
3288b7f5c055SJed Brown       numBlocks = 1;
3289b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) numBlocks *= extent[i];
3290b7f5c055SJed Brown       numBlocksPlus = 1;
3291b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) numBlocksPlus *= extentPlus[i];
3292b7f5c055SJed Brown       numFaces = numBlocks * facesPerBlock;
32939566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numBlocks, &cells));
32949566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numBlocksPlus * vertsPerBlock, &seen));
3295b7f5c055SJed Brown       for (PetscInt k = 0; k < extent[2]; k++) {
3296b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3297b7f5c055SJed Brown           for (PetscInt i = 0; i < extent[0]; i++) {
3298b7f5c055SJed Brown             for (PetscInt f = 0; f < facesPerBlock; f++) {
3299b7f5c055SJed Brown               for (PetscInt v = 0; v < 4; v++) {
3300b7f5c055SJed Brown                 PetscInt vertRaw     = pattern[f][v];
3301b7f5c055SJed Brown                 PetscInt blockidx    = vertRaw / 56;
3302b7f5c055SJed Brown                 PetscInt patternvert = vertRaw % 56;
3303b7f5c055SJed Brown                 PetscInt xplus       = (blockidx & 1);
3304b7f5c055SJed Brown                 PetscInt yplus       = (blockidx & 2) >> 1;
3305b7f5c055SJed Brown                 PetscInt zplus       = (blockidx & 4) >> 2;
3306b7f5c055SJed Brown                 PetscInt zcoord      = (periodic && periodic[2] == DM_BOUNDARY_PERIODIC) ? ((k + zplus) % extent[2]) : (k + zplus);
3307b7f5c055SJed Brown                 PetscInt ycoord      = (periodic && periodic[1] == DM_BOUNDARY_PERIODIC) ? ((j + yplus) % extent[1]) : (j + yplus);
3308b7f5c055SJed Brown                 PetscInt xcoord      = (periodic && periodic[0] == DM_BOUNDARY_PERIODIC) ? ((i + xplus) % extent[0]) : (i + xplus);
3309b7f5c055SJed Brown                 PetscInt vert        = ((zcoord * extentPlus[1] + ycoord) * extentPlus[0] + xcoord) * 56 + patternvert;
3310b7f5c055SJed Brown 
3311b7f5c055SJed Brown                 cells[(k * extent[1] + j) * extent[0] + i][f][v] = vert;
3312b7f5c055SJed Brown                 seen[vert]                                       = PETSC_TRUE;
3313b7f5c055SJed Brown               }
3314b7f5c055SJed Brown             }
3315b7f5c055SJed Brown           }
3316b7f5c055SJed Brown         }
3317b7f5c055SJed Brown       }
33189371c9d4SSatish Balay       for (PetscInt i = 0; i < numBlocksPlus * vertsPerBlock; i++)
33199371c9d4SSatish Balay         if (seen[i]) numVertices++;
3320b7f5c055SJed Brown       count = 0;
33219566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numBlocksPlus * vertsPerBlock, &vertToTrueVert));
33229566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numVertices * 3, &vtxCoords));
3323b7f5c055SJed Brown       for (PetscInt i = 0; i < numBlocksPlus * vertsPerBlock; i++) vertToTrueVert[i] = -1;
3324b7f5c055SJed Brown       for (PetscInt k = 0; k < extentPlus[2]; k++) {
3325b7f5c055SJed Brown         for (PetscInt j = 0; j < extentPlus[1]; j++) {
3326b7f5c055SJed Brown           for (PetscInt i = 0; i < extentPlus[0]; i++) {
3327b7f5c055SJed Brown             for (PetscInt v = 0; v < vertsPerBlock; v++) {
3328b7f5c055SJed Brown               PetscInt vIdx = ((k * extentPlus[1] + j) * extentPlus[0] + i) * vertsPerBlock + v;
3329b7f5c055SJed Brown 
3330b7f5c055SJed Brown               if (seen[vIdx]) {
3331b7f5c055SJed Brown                 PetscInt thisVert;
3332b7f5c055SJed Brown 
3333b7f5c055SJed Brown                 vertToTrueVert[vIdx] = thisVert = count++;
3334b7f5c055SJed Brown 
3335b7f5c055SJed Brown                 for (PetscInt d = 0; d < 3; d++) vtxCoords[3 * thisVert + d] = patternCoords[v][d];
3336b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 0] += i * 2;
3337b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 1] += j * 2;
3338b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 2] += k * 2;
3339b7f5c055SJed Brown               }
3340b7f5c055SJed Brown             }
3341b7f5c055SJed Brown           }
3342b7f5c055SJed Brown         }
3343b7f5c055SJed Brown       }
3344b7f5c055SJed Brown       for (PetscInt i = 0; i < numBlocks; i++) {
3345b7f5c055SJed Brown         for (PetscInt f = 0; f < facesPerBlock; f++) {
3346ad540459SPierre Jolivet           for (PetscInt v = 0; v < 4; v++) cells[i][f][v] = vertToTrueVert[cells[i][f][v]];
3347b7f5c055SJed Brown         }
3348b7f5c055SJed Brown       }
33499566063dSJacob Faibussowitsch       PetscCall(PetscFree(vertToTrueVert));
33509566063dSJacob Faibussowitsch       PetscCall(PetscFree(seen));
3351b7f5c055SJed Brown       cells_flat = cells[0][0];
3352b7f5c055SJed Brown       numEdges   = 0;
3353b7f5c055SJed Brown       for (PetscInt i = 0; i < numFaces; i++) {
3354b7f5c055SJed Brown         for (PetscInt e = 0; e < 4; e++) {
3355b7f5c055SJed Brown           PetscInt         ev[]       = {cells_flat[i * 4 + e], cells_flat[i * 4 + ((e + 1) % 4)]};
3356b7f5c055SJed Brown           const PetscReal *evCoords[] = {&vtxCoords[3 * ev[0]], &vtxCoords[3 * ev[1]]};
3357b7f5c055SJed Brown 
3358b7f5c055SJed Brown           for (PetscInt d = 0; d < 3; d++) {
3359b7f5c055SJed Brown             if (!periodic || periodic[0] != DM_BOUNDARY_PERIODIC) {
3360b7f5c055SJed Brown               if (evCoords[0][d] == 0. && evCoords[1][d] == 0.) numEdges++;
3361b7f5c055SJed Brown               if (evCoords[0][d] == 2. * extent[d] && evCoords[1][d] == 2. * extent[d]) numEdges++;
3362b7f5c055SJed Brown             }
3363b7f5c055SJed Brown           }
3364b7f5c055SJed Brown         }
3365b7f5c055SJed Brown       }
33669566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numEdges, &edges));
33679566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numEdges, &edgeSets));
3368b7f5c055SJed Brown       for (PetscInt edge = 0, i = 0; i < numFaces; i++) {
3369b7f5c055SJed Brown         for (PetscInt e = 0; e < 4; e++) {
3370b7f5c055SJed Brown           PetscInt         ev[]       = {cells_flat[i * 4 + e], cells_flat[i * 4 + ((e + 1) % 4)]};
3371b7f5c055SJed Brown           const PetscReal *evCoords[] = {&vtxCoords[3 * ev[0]], &vtxCoords[3 * ev[1]]};
3372b7f5c055SJed Brown 
3373b7f5c055SJed Brown           for (PetscInt d = 0; d < 3; d++) {
3374b7f5c055SJed Brown             if (!periodic || periodic[d] != DM_BOUNDARY_PERIODIC) {
3375b7f5c055SJed Brown               if (evCoords[0][d] == 0. && evCoords[1][d] == 0.) {
3376b7f5c055SJed Brown                 edges[edge][0]   = ev[0];
3377b7f5c055SJed Brown                 edges[edge][1]   = ev[1];
3378b7f5c055SJed Brown                 edgeSets[edge++] = 2 * d;
3379b7f5c055SJed Brown               }
3380b7f5c055SJed Brown               if (evCoords[0][d] == 2. * extent[d] && evCoords[1][d] == 2. * extent[d]) {
3381b7f5c055SJed Brown                 edges[edge][0]   = ev[0];
3382b7f5c055SJed Brown                 edges[edge][1]   = ev[1];
3383b7f5c055SJed Brown                 edgeSets[edge++] = 2 * d + 1;
3384b7f5c055SJed Brown               }
3385b7f5c055SJed Brown             }
3386b7f5c055SJed Brown           }
3387b7f5c055SJed Brown         }
3388b7f5c055SJed Brown       }
3389b7f5c055SJed Brown     }
3390b7f5c055SJed Brown     evalFunc   = TPSEvaluate_Gyroid;
33914663dae6SJed Brown     normalFunc = TPSExtrudeNormalFunc_Gyroid;
3392b7f5c055SJed Brown     break;
3393b7f5c055SJed Brown   }
3394b7f5c055SJed Brown 
33959566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, topoDim));
3396c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildFromCellList(dm, numFaces, numVertices, 4, cells_flat));
33979566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildFromCellList(dm, 0, 0, 0, NULL));
33989566063dSJacob Faibussowitsch   PetscCall(PetscFree(cells_flat));
3399b7f5c055SJed Brown   {
3400b7f5c055SJed Brown     DM idm;
34019566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(dm, &idm));
340269d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &idm));
3403b7f5c055SJed Brown   }
3404c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildCoordinatesFromCellList(dm, spaceDim, vtxCoords));
34059566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildCoordinatesFromCellList(dm, spaceDim, NULL));
34069566063dSJacob Faibussowitsch   PetscCall(PetscFree(vtxCoords));
3407b7f5c055SJed Brown 
34089566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "Face Sets"));
34099566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "Face Sets", &label));
3410b7f5c055SJed Brown   for (PetscInt e = 0; e < numEdges; e++) {
3411b7f5c055SJed Brown     PetscInt        njoin;
3412b7f5c055SJed Brown     const PetscInt *join, verts[] = {numFaces + edges[e][0], numFaces + edges[e][1]};
34139566063dSJacob Faibussowitsch     PetscCall(DMPlexGetJoin(dm, 2, verts, &njoin, &join));
341463a3b9bcSJacob 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]);
34159566063dSJacob Faibussowitsch     PetscCall(DMLabelSetValue(label, join[0], edgeSets[e]));
34169566063dSJacob Faibussowitsch     PetscCall(DMPlexRestoreJoin(dm, 2, verts, &njoin, &join));
3417b7f5c055SJed Brown   }
34189566063dSJacob Faibussowitsch   PetscCall(PetscFree(edges));
34199566063dSJacob Faibussowitsch   PetscCall(PetscFree(edgeSets));
34201436d7faSJed Brown   if (tps_distribute) {
34211436d7faSJed Brown     DM               pdm = NULL;
34221436d7faSJed Brown     PetscPartitioner part;
34231436d7faSJed Brown 
34249566063dSJacob Faibussowitsch     PetscCall(DMPlexGetPartitioner(dm, &part));
34259566063dSJacob Faibussowitsch     PetscCall(PetscPartitionerSetFromOptions(part));
34269566063dSJacob Faibussowitsch     PetscCall(DMPlexDistribute(dm, 0, NULL, &pdm));
342748a46eb9SPierre Jolivet     if (pdm) PetscCall(DMPlexReplace_Internal(dm, &pdm));
34281436d7faSJed Brown     // Do not auto-distribute again
34299566063dSJacob Faibussowitsch     PetscCall(DMPlexDistributeSetDefault(dm, PETSC_FALSE));
34301436d7faSJed Brown   }
3431b7f5c055SJed Brown 
34329566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
3433b7f5c055SJed Brown   for (PetscInt refine = 0; refine < refinements; refine++) {
3434b7f5c055SJed Brown     PetscInt     m;
3435b7f5c055SJed Brown     DM           dmf;
3436b7f5c055SJed Brown     Vec          X;
3437b7f5c055SJed Brown     PetscScalar *x;
34389566063dSJacob Faibussowitsch     PetscCall(DMRefine(dm, MPI_COMM_NULL, &dmf));
343969d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmf));
3440b7f5c055SJed Brown 
34419566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinatesLocal(dm, &X));
34429566063dSJacob Faibussowitsch     PetscCall(VecGetLocalSize(X, &m));
34439566063dSJacob Faibussowitsch     PetscCall(VecGetArray(X, &x));
344448a46eb9SPierre Jolivet     for (PetscInt i = 0; i < m; i += 3) PetscCall(TPSNearestPoint(evalFunc, &x[i]));
34459566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(X, &x));
3446b7f5c055SJed Brown   }
3447b7f5c055SJed Brown 
3448b7f5c055SJed Brown   // Face Sets has already been propagated to new vertices during refinement; this propagates to the initial vertices.
34499566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "Face Sets", &label));
34509566063dSJacob Faibussowitsch   PetscCall(DMPlexLabelComplete(dm, label));
3451b7f5c055SJed Brown 
345246139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
345346139095SJed Brown 
3454b7f5c055SJed Brown   if (thickness > 0) {
34554663dae6SJed Brown     DM              edm, cdm, ecdm;
34564663dae6SJed Brown     DMPlexTransform tr;
34574663dae6SJed Brown     const char     *prefix;
34584663dae6SJed Brown     PetscOptions    options;
34594663dae6SJed Brown     // Code from DMPlexExtrude
34604663dae6SJed Brown     PetscCall(DMPlexTransformCreate(PetscObjectComm((PetscObject)dm), &tr));
34614663dae6SJed Brown     PetscCall(DMPlexTransformSetDM(tr, dm));
34624663dae6SJed Brown     PetscCall(DMPlexTransformSetType(tr, DMPLEXEXTRUDE));
34634663dae6SJed Brown     PetscCall(PetscObjectGetOptionsPrefix((PetscObject)dm, &prefix));
34644663dae6SJed Brown     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)tr, prefix));
34654663dae6SJed Brown     PetscCall(PetscObjectGetOptions((PetscObject)dm, &options));
34664663dae6SJed Brown     PetscCall(PetscObjectSetOptions((PetscObject)tr, options));
34674663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetLayers(tr, layers));
34684663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetThickness(tr, thickness));
34694663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetTensor(tr, PETSC_FALSE));
34704663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetSymmetric(tr, PETSC_TRUE));
34714663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetNormalFunction(tr, normalFunc));
34724663dae6SJed Brown     PetscCall(DMPlexTransformSetFromOptions(tr));
34734663dae6SJed Brown     PetscCall(PetscObjectSetOptions((PetscObject)tr, NULL));
34744663dae6SJed Brown     PetscCall(DMPlexTransformSetUp(tr));
34754663dae6SJed Brown     PetscCall(PetscObjectViewFromOptions((PetscObject)tr, NULL, "-dm_plex_tps_transform_view"));
34764663dae6SJed Brown     PetscCall(DMPlexTransformApply(tr, dm, &edm));
34774663dae6SJed Brown     PetscCall(DMCopyDisc(dm, edm));
34784663dae6SJed Brown     PetscCall(DMGetCoordinateDM(dm, &cdm));
34794663dae6SJed Brown     PetscCall(DMGetCoordinateDM(edm, &ecdm));
34804663dae6SJed Brown     PetscCall(DMCopyDisc(cdm, ecdm));
34814663dae6SJed Brown     PetscCall(DMPlexTransformCreateDiscLabels(tr, edm));
34824663dae6SJed Brown     PetscCall(DMPlexTransformDestroy(&tr));
34834663dae6SJed Brown     if (edm) {
34844663dae6SJed Brown       ((DM_Plex *)edm->data)->printFEM    = ((DM_Plex *)dm->data)->printFEM;
34854663dae6SJed Brown       ((DM_Plex *)edm->data)->printL2     = ((DM_Plex *)dm->data)->printL2;
3486f5867de0SMatthew G. Knepley       ((DM_Plex *)edm->data)->printLocate = ((DM_Plex *)dm->data)->printLocate;
34874663dae6SJed Brown     }
348869d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &edm));
3489b7f5c055SJed Brown   }
34903ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3491b7f5c055SJed Brown }
3492b7f5c055SJed Brown 
3493b7f5c055SJed Brown /*@
3494b7f5c055SJed Brown   DMPlexCreateTPSMesh - Create a distributed, interpolated mesh of a triply-periodic surface
3495b7f5c055SJed Brown 
3496b7f5c055SJed Brown   Collective
3497b7f5c055SJed Brown 
3498b7f5c055SJed Brown   Input Parameters:
3499a1cb98faSBarry Smith + comm           - The communicator for the `DM` object
3500b7f5c055SJed Brown . tpstype        - Type of triply-periodic surface
3501b7f5c055SJed Brown . extent         - Array of length 3 containing number of periods in each direction
350220f4b53cSBarry Smith . periodic       - array of length 3 with periodicity, or `NULL` for non-periodic
35031436d7faSJed Brown . tps_distribute - Distribute 2D manifold mesh prior to refinement and extrusion (more scalable)
3504817da375SSatish Balay . refinements    - Number of factor-of-2 refinements of 2D manifold mesh
35051436d7faSJed Brown . layers         - Number of cell layers extruded in normal direction
3506817da375SSatish Balay - thickness      - Thickness in normal direction
3507b7f5c055SJed Brown 
3508b7f5c055SJed Brown   Output Parameter:
3509a1cb98faSBarry Smith . dm - The `DM` object
3510a1cb98faSBarry Smith 
3511a1cb98faSBarry Smith   Level: beginner
3512b7f5c055SJed Brown 
3513b7f5c055SJed Brown   Notes:
3514b7f5c055SJed 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.
3515*1d27aa22SBarry Smith   <https://en.wikipedia.org/wiki/Schwarz_minimal_surface#Schwarz_P_(%22Primitive%22)> and can be cut with "clean" boundaries.
3516*1d27aa22SBarry Smith   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.
3517b7f5c055SJed Brown   Our implementation creates a very coarse mesh of the surface and refines (by 4-way splitting) as many times as requested.
3518b7f5c055SJed Brown   On each refinement, all vertices are projected to their nearest point on the surface.
3519b7f5c055SJed Brown   This projection could readily be extended to related surfaces.
3520b7f5c055SJed Brown 
3521*1d27aa22SBarry Smith   See {cite}`maskery2018insights`
3522*1d27aa22SBarry Smith 
3523*1d27aa22SBarry Smith   The face (edge) sets for the Schwarz P surface are numbered $1(-x), 2(+x), 3(-y), 4(+y), 5(-z), 6(+z)$.
3524*1d27aa22SBarry Smith   When the mesh is refined, "Face Sets" contain the new vertices (created during refinement).
3525*1d27aa22SBarry Smith   Use `DMPlexLabelComplete()` to propagate to coarse-level vertices.
3526b7f5c055SJed Brown 
352760225df5SJacob Faibussowitsch   Developer Notes:
3528b7f5c055SJed Brown   The Gyroid mesh does not currently mark boundary sets.
3529b7f5c055SJed Brown 
35301cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateSphereMesh()`, `DMSetType()`, `DMCreate()`
3531b7f5c055SJed Brown @*/
3532d71ae5a4SJacob 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)
3533d71ae5a4SJacob Faibussowitsch {
3534b7f5c055SJed Brown   PetscFunctionBegin;
35359566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
35369566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
35379566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateTPSMesh_Internal(*dm, tpstype, extent, periodic, tps_distribute, refinements, layers, thickness));
35383ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3539b7f5c055SJed Brown }
3540b7f5c055SJed Brown 
35419318fe57SMatthew G. Knepley /*@
35429318fe57SMatthew G. Knepley   DMPlexCreateSphereMesh - Creates a mesh on the d-dimensional sphere, S^d.
35439318fe57SMatthew G. Knepley 
35449318fe57SMatthew G. Knepley   Collective
35459318fe57SMatthew G. Knepley 
35469318fe57SMatthew G. Knepley   Input Parameters:
3547a1cb98faSBarry Smith + comm    - The communicator for the `DM` object
35489318fe57SMatthew G. Knepley . dim     - The dimension
35499318fe57SMatthew G. Knepley . simplex - Use simplices, or tensor product cells
35509318fe57SMatthew G. Knepley - R       - The radius
35519318fe57SMatthew G. Knepley 
35529318fe57SMatthew G. Knepley   Output Parameter:
3553a1cb98faSBarry Smith . dm - The `DM` object
35549318fe57SMatthew G. Knepley 
35559318fe57SMatthew G. Knepley   Level: beginner
35569318fe57SMatthew G. Knepley 
35571cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBallMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
35589318fe57SMatthew G. Knepley @*/
3559d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateSphereMesh(MPI_Comm comm, PetscInt dim, PetscBool simplex, PetscReal R, DM *dm)
3560d71ae5a4SJacob Faibussowitsch {
35619318fe57SMatthew G. Knepley   PetscFunctionBegin;
35624f572ea9SToby Isaac   PetscAssertPointer(dm, 5);
35639566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
35649566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
35659566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateSphereMesh_Internal(*dm, dim, simplex, R));
35663ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
35679318fe57SMatthew G. Knepley }
35689318fe57SMatthew G. Knepley 
3569d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBallMesh_Internal(DM dm, PetscInt dim, PetscReal R)
3570d71ae5a4SJacob Faibussowitsch {
35719318fe57SMatthew G. Knepley   DM      sdm, vol;
35729318fe57SMatthew G. Knepley   DMLabel bdlabel;
35739318fe57SMatthew G. Knepley 
35749318fe57SMatthew G. Knepley   PetscFunctionBegin;
35759566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &sdm));
35769566063dSJacob Faibussowitsch   PetscCall(DMSetType(sdm, DMPLEX));
35779566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)sdm, "bd_"));
35789566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateSphereMesh_Internal(sdm, dim - 1, PETSC_TRUE, R));
35799566063dSJacob Faibussowitsch   PetscCall(DMSetFromOptions(sdm));
35809566063dSJacob Faibussowitsch   PetscCall(DMViewFromOptions(sdm, NULL, "-dm_view"));
35819566063dSJacob Faibussowitsch   PetscCall(DMPlexGenerate(sdm, NULL, PETSC_TRUE, &vol));
35829566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&sdm));
358369d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
35849566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "marker"));
35859566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "marker", &bdlabel));
35869566063dSJacob Faibussowitsch   PetscCall(DMPlexMarkBoundaryFaces(dm, PETSC_DETERMINE, bdlabel));
35879566063dSJacob Faibussowitsch   PetscCall(DMPlexLabelComplete(dm, bdlabel));
35883ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
358951a74b61SMatthew G. Knepley }
359051a74b61SMatthew G. Knepley 
359151a74b61SMatthew G. Knepley /*@
359251a74b61SMatthew G. Knepley   DMPlexCreateBallMesh - Creates a simplex mesh on the d-dimensional ball, B^d.
359351a74b61SMatthew G. Knepley 
359451a74b61SMatthew G. Knepley   Collective
359551a74b61SMatthew G. Knepley 
359651a74b61SMatthew G. Knepley   Input Parameters:
3597a1cb98faSBarry Smith + comm - The communicator for the `DM` object
359851a74b61SMatthew G. Knepley . dim  - The dimension
359951a74b61SMatthew G. Knepley - R    - The radius
360051a74b61SMatthew G. Knepley 
360151a74b61SMatthew G. Knepley   Output Parameter:
3602a1cb98faSBarry Smith . dm - The `DM` object
360351a74b61SMatthew G. Knepley 
3604a1cb98faSBarry Smith   Options Database Key:
360560225df5SJacob Faibussowitsch . bd_dm_refine - This will refine the surface mesh preserving the sphere geometry
360651a74b61SMatthew G. Knepley 
360751a74b61SMatthew G. Knepley   Level: beginner
360851a74b61SMatthew G. Knepley 
36091cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateSphereMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
361051a74b61SMatthew G. Knepley @*/
3611d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateBallMesh(MPI_Comm comm, PetscInt dim, PetscReal R, DM *dm)
3612d71ae5a4SJacob Faibussowitsch {
361351a74b61SMatthew G. Knepley   PetscFunctionBegin;
36149566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
36159566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
36169566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBallMesh_Internal(*dm, dim, R));
36173ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
36182829fed8SMatthew G. Knepley }
36192829fed8SMatthew G. Knepley 
3620d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateReferenceCell_Internal(DM rdm, DMPolytopeType ct)
3621d71ae5a4SJacob Faibussowitsch {
36220a6ba040SMatthew G. Knepley   PetscFunctionBegin;
36239318fe57SMatthew G. Knepley   switch (ct) {
36249371c9d4SSatish Balay   case DM_POLYTOPE_POINT: {
36259318fe57SMatthew G. Knepley     PetscInt    numPoints[1]        = {1};
36269318fe57SMatthew G. Knepley     PetscInt    coneSize[1]         = {0};
36279318fe57SMatthew G. Knepley     PetscInt    cones[1]            = {0};
36289318fe57SMatthew G. Knepley     PetscInt    coneOrientations[1] = {0};
36299318fe57SMatthew G. Knepley     PetscScalar vertexCoords[1]     = {0.0};
36309318fe57SMatthew G. Knepley 
36319566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 0));
36329566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 0, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36339371c9d4SSatish Balay   } break;
36349371c9d4SSatish Balay   case DM_POLYTOPE_SEGMENT: {
36359318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {2, 1};
36369318fe57SMatthew G. Knepley     PetscInt    coneSize[3]         = {2, 0, 0};
36379318fe57SMatthew G. Knepley     PetscInt    cones[2]            = {1, 2};
36389318fe57SMatthew G. Knepley     PetscInt    coneOrientations[2] = {0, 0};
36399318fe57SMatthew G. Knepley     PetscScalar vertexCoords[2]     = {-1.0, 1.0};
36409318fe57SMatthew G. Knepley 
36419566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 1));
36429566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36439371c9d4SSatish Balay   } break;
36449371c9d4SSatish Balay   case DM_POLYTOPE_POINT_PRISM_TENSOR: {
3645b5a892a1SMatthew G. Knepley     PetscInt    numPoints[2]        = {2, 1};
3646b5a892a1SMatthew G. Knepley     PetscInt    coneSize[3]         = {2, 0, 0};
3647b5a892a1SMatthew G. Knepley     PetscInt    cones[2]            = {1, 2};
3648b5a892a1SMatthew G. Knepley     PetscInt    coneOrientations[2] = {0, 0};
3649b5a892a1SMatthew G. Knepley     PetscScalar vertexCoords[2]     = {-1.0, 1.0};
3650b5a892a1SMatthew G. Knepley 
36519566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 1));
36529566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36539371c9d4SSatish Balay   } break;
36549371c9d4SSatish Balay   case DM_POLYTOPE_TRIANGLE: {
36559318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {3, 1};
36569318fe57SMatthew G. Knepley     PetscInt    coneSize[4]         = {3, 0, 0, 0};
36579318fe57SMatthew G. Knepley     PetscInt    cones[3]            = {1, 2, 3};
36589318fe57SMatthew G. Knepley     PetscInt    coneOrientations[3] = {0, 0, 0};
36599318fe57SMatthew G. Knepley     PetscScalar vertexCoords[6]     = {-1.0, -1.0, 1.0, -1.0, -1.0, 1.0};
36609318fe57SMatthew G. Knepley 
36619566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
36629566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36639371c9d4SSatish Balay   } break;
36649371c9d4SSatish Balay   case DM_POLYTOPE_QUADRILATERAL: {
36659318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
36669318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
36679318fe57SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
36689318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
36699318fe57SMatthew G. Knepley     PetscScalar vertexCoords[8]     = {-1.0, -1.0, 1.0, -1.0, 1.0, 1.0, -1.0, 1.0};
36709318fe57SMatthew G. Knepley 
36719566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
36729566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36739371c9d4SSatish Balay   } break;
36749371c9d4SSatish Balay   case DM_POLYTOPE_SEG_PRISM_TENSOR: {
36759318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
36769318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
36779318fe57SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
36789318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
36799318fe57SMatthew G. Knepley     PetscScalar vertexCoords[8]     = {-1.0, -1.0, 1.0, -1.0, -1.0, 1.0, 1.0, 1.0};
36809318fe57SMatthew G. Knepley 
36819566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
36829566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36839371c9d4SSatish Balay   } break;
36849371c9d4SSatish Balay   case DM_POLYTOPE_TETRAHEDRON: {
36859318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
36869318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
3687f0edb160SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
36889318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
3689f0edb160SMatthew 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};
36909318fe57SMatthew G. Knepley 
36919566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
36929566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36939371c9d4SSatish Balay   } break;
36949371c9d4SSatish Balay   case DM_POLYTOPE_HEXAHEDRON: {
36959318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {8, 1};
36969318fe57SMatthew G. Knepley     PetscInt    coneSize[9]         = {8, 0, 0, 0, 0, 0, 0, 0, 0};
3697f0edb160SMatthew G. Knepley     PetscInt    cones[8]            = {1, 2, 3, 4, 5, 6, 7, 8};
36989318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
36999371c9d4SSatish 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};
37009318fe57SMatthew G. Knepley 
37019566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37029566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37039371c9d4SSatish Balay   } break;
37049371c9d4SSatish Balay   case DM_POLYTOPE_TRI_PRISM: {
37059318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {6, 1};
37069318fe57SMatthew G. Knepley     PetscInt    coneSize[7]         = {6, 0, 0, 0, 0, 0, 0};
3707f0edb160SMatthew G. Knepley     PetscInt    cones[6]            = {1, 2, 3, 4, 5, 6};
37089318fe57SMatthew G. Knepley     PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
37099371c9d4SSatish 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};
37109318fe57SMatthew G. Knepley 
37119566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37129566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37139371c9d4SSatish Balay   } break;
37149371c9d4SSatish Balay   case DM_POLYTOPE_TRI_PRISM_TENSOR: {
37159318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {6, 1};
37169318fe57SMatthew G. Knepley     PetscInt    coneSize[7]         = {6, 0, 0, 0, 0, 0, 0};
37179318fe57SMatthew G. Knepley     PetscInt    cones[6]            = {1, 2, 3, 4, 5, 6};
37189318fe57SMatthew G. Knepley     PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
37199371c9d4SSatish 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};
37209318fe57SMatthew G. Knepley 
37219566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37229566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37239371c9d4SSatish Balay   } break;
37249371c9d4SSatish Balay   case DM_POLYTOPE_QUAD_PRISM_TENSOR: {
37259318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {8, 1};
37269318fe57SMatthew G. Knepley     PetscInt    coneSize[9]         = {8, 0, 0, 0, 0, 0, 0, 0, 0};
37279318fe57SMatthew G. Knepley     PetscInt    cones[8]            = {1, 2, 3, 4, 5, 6, 7, 8};
37289318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
37299371c9d4SSatish 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};
37309318fe57SMatthew G. Knepley 
37319566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37329566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37339371c9d4SSatish Balay   } break;
37349371c9d4SSatish Balay   case DM_POLYTOPE_PYRAMID: {
37359318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {5, 1};
37369318fe57SMatthew G. Knepley     PetscInt    coneSize[6]         = {5, 0, 0, 0, 0, 0};
3737f0edb160SMatthew G. Knepley     PetscInt    cones[5]            = {1, 2, 3, 4, 5};
37389318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
37399371c9d4SSatish 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};
37409318fe57SMatthew G. Knepley 
37419566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37429566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37439371c9d4SSatish Balay   } break;
3744d71ae5a4SJacob Faibussowitsch   default:
3745d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)rdm), PETSC_ERR_ARG_WRONG, "Cannot create reference cell for cell type %s", DMPolytopeTypes[ct]);
37469318fe57SMatthew G. Knepley   }
37479318fe57SMatthew G. Knepley   {
37489318fe57SMatthew G. Knepley     PetscInt Nv, v;
37499318fe57SMatthew G. Knepley 
37509318fe57SMatthew G. Knepley     /* Must create the celltype label here so that we do not automatically try to compute the types */
37519566063dSJacob Faibussowitsch     PetscCall(DMCreateLabel(rdm, "celltype"));
37529566063dSJacob Faibussowitsch     PetscCall(DMPlexSetCellType(rdm, 0, ct));
37539566063dSJacob Faibussowitsch     PetscCall(DMPlexGetChart(rdm, NULL, &Nv));
37549566063dSJacob Faibussowitsch     for (v = 1; v < Nv; ++v) PetscCall(DMPlexSetCellType(rdm, v, DM_POLYTOPE_POINT));
37559318fe57SMatthew G. Knepley   }
37569566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolateInPlace_Internal(rdm));
37579566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)rdm, DMPolytopeTypes[ct]));
37583ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
37590a6ba040SMatthew G. Knepley }
37600a6ba040SMatthew G. Knepley 
37619318fe57SMatthew G. Knepley /*@
3762a1cb98faSBarry Smith   DMPlexCreateReferenceCell - Create a `DMPLEX` with the appropriate FEM reference cell
37639318fe57SMatthew G. Knepley 
37649318fe57SMatthew G. Knepley   Collective
37659318fe57SMatthew G. Knepley 
37669318fe57SMatthew G. Knepley   Input Parameters:
37679318fe57SMatthew G. Knepley + comm - The communicator
37689318fe57SMatthew G. Knepley - ct   - The cell type of the reference cell
37699318fe57SMatthew G. Knepley 
37709318fe57SMatthew G. Knepley   Output Parameter:
37719318fe57SMatthew G. Knepley . refdm - The reference cell
37729318fe57SMatthew G. Knepley 
37739318fe57SMatthew G. Knepley   Level: intermediate
37749318fe57SMatthew G. Knepley 
377542747ad1SJacob Faibussowitsch .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBoxMesh()`
37769318fe57SMatthew G. Knepley @*/
3777d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateReferenceCell(MPI_Comm comm, DMPolytopeType ct, DM *refdm)
3778d71ae5a4SJacob Faibussowitsch {
37790a6ba040SMatthew G. Knepley   PetscFunctionBegin;
37809566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, refdm));
37819566063dSJacob Faibussowitsch   PetscCall(DMSetType(*refdm, DMPLEX));
37829566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateReferenceCell_Internal(*refdm, ct));
37833ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
37849318fe57SMatthew G. Knepley }
378579a015ccSMatthew G. Knepley 
3786d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoundaryLabel_Private(DM dm, const char name[])
3787d71ae5a4SJacob Faibussowitsch {
37889318fe57SMatthew G. Knepley   DM        plex;
37899318fe57SMatthew G. Knepley   DMLabel   label;
37909318fe57SMatthew G. Knepley   PetscBool hasLabel;
37910a6ba040SMatthew G. Knepley 
3792c22d3578SMatthew G. Knepley   PetscFunctionBegin;
37939566063dSJacob Faibussowitsch   PetscCall(DMHasLabel(dm, name, &hasLabel));
37943ba16761SJacob Faibussowitsch   if (hasLabel) PetscFunctionReturn(PETSC_SUCCESS);
37959566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, name));
37969566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, name, &label));
37979566063dSJacob Faibussowitsch   PetscCall(DMConvert(dm, DMPLEX, &plex));
37989566063dSJacob Faibussowitsch   PetscCall(DMPlexMarkBoundaryFaces(plex, 1, label));
37991c8afea9SMatthew G. Knepley   PetscCall(DMPlexLabelComplete(plex, label));
38009566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&plex));
38013ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
38029318fe57SMatthew G. Knepley }
3803acdc6f61SToby Isaac 
3804669647acSMatthew G. Knepley /*
3805669647acSMatthew 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.
3806669647acSMatthew G. Knepley 
3807669647acSMatthew G. Knepley     (x, y) -> (r, theta) = (x[1], (x[0] - lower[0]) * 2\pi/(upper[0] - lower[0]))
3808669647acSMatthew G. Knepley */
3809d71ae5a4SJacob 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[])
3810d71ae5a4SJacob Faibussowitsch {
3811669647acSMatthew G. Knepley   const PetscReal low = PetscRealPart(constants[0]);
3812669647acSMatthew G. Knepley   const PetscReal upp = PetscRealPart(constants[1]);
3813669647acSMatthew G. Knepley   const PetscReal r   = PetscRealPart(u[1]);
3814669647acSMatthew G. Knepley   const PetscReal th  = 2. * PETSC_PI * (PetscRealPart(u[0]) - low) / (upp - low);
3815669647acSMatthew G. Knepley 
3816669647acSMatthew G. Knepley   f0[0] = r * PetscCosReal(th);
3817669647acSMatthew G. Knepley   f0[1] = r * PetscSinReal(th);
3818669647acSMatthew G. Knepley }
3819669647acSMatthew G. Knepley 
38205dca41c3SJed Brown const char *const DMPlexShapes[] = {"box", "box_surface", "ball", "sphere", "cylinder", "schwarz_p", "gyroid", "doublet", "annulus", "hypercubic", "zbox", "unknown", "DMPlexShape", "DM_SHAPE_", NULL};
38219318fe57SMatthew G. Knepley 
3822d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateFromOptions_Internal(PetscOptionItems *PetscOptionsObject, PetscBool *useCoordSpace, DM dm)
3823d71ae5a4SJacob Faibussowitsch {
38249318fe57SMatthew G. Knepley   DMPlexShape    shape   = DM_SHAPE_BOX;
38259318fe57SMatthew G. Knepley   DMPolytopeType cell    = DM_POLYTOPE_TRIANGLE;
38269318fe57SMatthew G. Knepley   PetscInt       dim     = 2;
38279318fe57SMatthew G. Knepley   PetscBool      simplex = PETSC_TRUE, interpolate = PETSC_TRUE, adjCone = PETSC_FALSE, adjClosure = PETSC_TRUE, refDomain = PETSC_FALSE;
3828cd7e8a5eSksagiyam   PetscBool      flg, flg2, fflg, bdfflg, nameflg;
38299318fe57SMatthew G. Knepley   MPI_Comm       comm;
3830ed5e4e85SVaclav Hapla   char           filename[PETSC_MAX_PATH_LEN]   = "<unspecified>";
3831ed5e4e85SVaclav Hapla   char           bdFilename[PETSC_MAX_PATH_LEN] = "<unspecified>";
3832ed5e4e85SVaclav Hapla   char           plexname[PETSC_MAX_PATH_LEN]   = "";
38339318fe57SMatthew G. Knepley 
38349318fe57SMatthew G. Knepley   PetscFunctionBegin;
3835708be2fdSJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_CreateFromOptions, dm, 0, 0, 0));
38369566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)dm, &comm));
38379318fe57SMatthew G. Knepley   /* TODO Turn this into a registration interface */
38389566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_filename", "File containing a mesh", "DMPlexCreateFromFile", filename, filename, sizeof(filename), &fflg));
38399566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_boundary_filename", "File containing a mesh boundary", "DMPlexCreateFromFile", bdFilename, bdFilename, sizeof(bdFilename), &bdfflg));
38409566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_name", "Name of the mesh in the file", "DMPlexCreateFromFile", plexname, plexname, sizeof(plexname), &nameflg));
38419566063dSJacob Faibussowitsch   PetscCall(PetscOptionsEnum("-dm_plex_cell", "Cell shape", "", DMPolytopeTypes, (PetscEnum)cell, (PetscEnum *)&cell, NULL));
38429566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_reference_cell_domain", "Use a reference cell domain", "", refDomain, &refDomain, NULL));
38439566063dSJacob Faibussowitsch   PetscCall(PetscOptionsEnum("-dm_plex_shape", "Shape for built-in mesh", "", DMPlexShapes, (PetscEnum)shape, (PetscEnum *)&shape, &flg));
38449566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_plex_dim", "Topological dimension of the mesh", "DMGetDimension", dim, &dim, &flg, 0));
3845cfb853baSMatthew G. Knepley   PetscCheck(dim >= 0, comm, PETSC_ERR_ARG_OUTOFRANGE, "Dimension %" PetscInt_FMT " should be in [0, infinity)", dim);
38469566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_simplex", "Mesh cell shape", "", simplex, &simplex, &flg));
38479566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_interpolate", "Flag to create edges and faces automatically", "", interpolate, &interpolate, &flg));
38489566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_adj_cone", "Set adjacency direction", "DMSetBasicAdjacency", adjCone, &adjCone, &flg));
38499566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_adj_closure", "Set adjacency size", "DMSetBasicAdjacency", adjClosure, &adjClosure, &flg2));
38509566063dSJacob Faibussowitsch   if (flg || flg2) PetscCall(DMSetBasicAdjacency(dm, adjCone, adjClosure));
38519318fe57SMatthew G. Knepley 
385261a622f3SMatthew G. Knepley   switch (cell) {
385361a622f3SMatthew G. Knepley   case DM_POLYTOPE_POINT:
385461a622f3SMatthew G. Knepley   case DM_POLYTOPE_SEGMENT:
385561a622f3SMatthew G. Knepley   case DM_POLYTOPE_POINT_PRISM_TENSOR:
385661a622f3SMatthew G. Knepley   case DM_POLYTOPE_TRIANGLE:
385761a622f3SMatthew G. Knepley   case DM_POLYTOPE_QUADRILATERAL:
385861a622f3SMatthew G. Knepley   case DM_POLYTOPE_TETRAHEDRON:
3859d71ae5a4SJacob Faibussowitsch   case DM_POLYTOPE_HEXAHEDRON:
3860d71ae5a4SJacob Faibussowitsch     *useCoordSpace = PETSC_TRUE;
3861d71ae5a4SJacob Faibussowitsch     break;
3862d71ae5a4SJacob Faibussowitsch   default:
3863d71ae5a4SJacob Faibussowitsch     *useCoordSpace = PETSC_FALSE;
3864d71ae5a4SJacob Faibussowitsch     break;
386561a622f3SMatthew G. Knepley   }
386661a622f3SMatthew G. Knepley 
38679318fe57SMatthew G. Knepley   if (fflg) {
38689318fe57SMatthew G. Knepley     DM dmnew;
38699318fe57SMatthew G. Knepley 
38709566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromFile(PetscObjectComm((PetscObject)dm), filename, plexname, interpolate, &dmnew));
38715de52c6dSVaclav Hapla     PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
387269d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmnew));
38739318fe57SMatthew G. Knepley   } else if (refDomain) {
38749566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateReferenceCell_Internal(dm, cell));
38759318fe57SMatthew G. Knepley   } else if (bdfflg) {
38769318fe57SMatthew G. Knepley     DM bdm, dmnew;
38779318fe57SMatthew G. Knepley 
38789566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromFile(PetscObjectComm((PetscObject)dm), bdFilename, plexname, interpolate, &bdm));
38799566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)bdm, "bd_"));
38809566063dSJacob Faibussowitsch     PetscCall(DMSetFromOptions(bdm));
38819566063dSJacob Faibussowitsch     PetscCall(DMPlexGenerate(bdm, NULL, interpolate, &dmnew));
38829566063dSJacob Faibussowitsch     PetscCall(DMDestroy(&bdm));
38835de52c6dSVaclav Hapla     PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
388469d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmnew));
38859318fe57SMatthew G. Knepley   } else {
38869566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)dm, DMPlexShapes[shape]));
38879318fe57SMatthew G. Knepley     switch (shape) {
3888669647acSMatthew G. Knepley     case DM_SHAPE_BOX:
38895dca41c3SJed Brown     case DM_SHAPE_ZBOX:
3890669647acSMatthew G. Knepley     case DM_SHAPE_ANNULUS: {
38919318fe57SMatthew G. Knepley       PetscInt       faces[3]  = {0, 0, 0};
38929318fe57SMatthew G. Knepley       PetscReal      lower[3]  = {0, 0, 0};
38939318fe57SMatthew G. Knepley       PetscReal      upper[3]  = {1, 1, 1};
38949318fe57SMatthew G. Knepley       DMBoundaryType bdt[3]    = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
3895669647acSMatthew G. Knepley       PetscBool      isAnnular = shape == DM_SHAPE_ANNULUS ? PETSC_TRUE : PETSC_FALSE;
38969318fe57SMatthew G. Knepley       PetscInt       i, n;
38979318fe57SMatthew G. Knepley 
38989318fe57SMatthew G. Knepley       n = dim;
38999318fe57SMatthew G. Knepley       for (i = 0; i < dim; ++i) faces[i] = (dim == 1 ? 1 : 4 - dim);
39009566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", faces, &n, &flg));
39019318fe57SMatthew G. Knepley       n = 3;
39029566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
390363a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Lower box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
39049318fe57SMatthew G. Knepley       n = 3;
39059566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
390663a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Upper box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
39079318fe57SMatthew G. Knepley       n = 3;
39089566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnumArray("-dm_plex_box_bd", "Boundary type for each dimension", "", DMBoundaryTypes, (PetscEnum *)bdt, &n, &flg));
390963a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Box boundary types had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
3910669647acSMatthew G. Knepley 
3911669647acSMatthew G. Knepley       PetscCheck(!isAnnular || dim == 2, comm, PETSC_ERR_ARG_OUTOFRANGE, "Only two dimensional annuli have been implemented");
3912669647acSMatthew G. Knepley       if (isAnnular)
3913669647acSMatthew G. Knepley         for (i = 0; i < dim - 1; ++i) bdt[i] = DM_BOUNDARY_PERIODIC;
3914669647acSMatthew G. Knepley 
39159318fe57SMatthew G. Knepley       switch (cell) {
391661a622f3SMatthew G. Knepley       case DM_POLYTOPE_TRI_PRISM_TENSOR:
39179566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateWedgeBoxMesh_Internal(dm, faces, lower, upper, bdt));
3918d410b0cfSMatthew G. Knepley         if (!interpolate) {
3919d410b0cfSMatthew G. Knepley           DM udm;
3920d410b0cfSMatthew G. Knepley 
39219566063dSJacob Faibussowitsch           PetscCall(DMPlexUninterpolate(dm, &udm));
392269d8a87bSksagiyam           PetscCall(DMPlexReplace_Internal(dm, &udm));
3923d410b0cfSMatthew G. Knepley         }
39249318fe57SMatthew G. Knepley         break;
3925d71ae5a4SJacob Faibussowitsch       default:
39265dca41c3SJed Brown         PetscCall(DMPlexCreateBoxMesh_Internal(dm, shape, dim, simplex, faces, lower, upper, bdt, interpolate));
3927d71ae5a4SJacob Faibussowitsch         break;
39289318fe57SMatthew G. Knepley       }
3929669647acSMatthew G. Knepley       if (isAnnular) {
3930669647acSMatthew G. Knepley         DM          cdm;
3931669647acSMatthew G. Knepley         PetscDS     cds;
3932669647acSMatthew G. Knepley         PetscScalar bounds[2] = {lower[0], upper[0]};
3933669647acSMatthew G. Knepley 
3934669647acSMatthew G. Knepley         // Fix coordinates for annular region
3935669647acSMatthew G. Knepley         PetscCall(DMSetPeriodicity(dm, NULL, NULL, NULL));
3936669647acSMatthew G. Knepley         PetscCall(DMSetCellCoordinatesLocal(dm, NULL));
3937669647acSMatthew G. Knepley         PetscCall(DMSetCellCoordinates(dm, NULL));
3938669647acSMatthew G. Knepley         PetscCall(DMPlexCreateCoordinateSpace(dm, 1, NULL));
3939669647acSMatthew G. Knepley         PetscCall(DMGetCoordinateDM(dm, &cdm));
3940669647acSMatthew G. Knepley         PetscCall(DMGetDS(cdm, &cds));
3941669647acSMatthew G. Knepley         PetscCall(PetscDSSetConstants(cds, 2, bounds));
3942669647acSMatthew G. Knepley         PetscCall(DMPlexRemapGeometry(dm, 0.0, boxToAnnulus));
3943669647acSMatthew G. Knepley       }
39449371c9d4SSatish Balay     } break;
39459371c9d4SSatish Balay     case DM_SHAPE_BOX_SURFACE: {
39469318fe57SMatthew G. Knepley       PetscInt  faces[3] = {0, 0, 0};
39479318fe57SMatthew G. Knepley       PetscReal lower[3] = {0, 0, 0};
39489318fe57SMatthew G. Knepley       PetscReal upper[3] = {1, 1, 1};
39499318fe57SMatthew G. Knepley       PetscInt  i, n;
39509318fe57SMatthew G. Knepley 
39519318fe57SMatthew G. Knepley       n = dim + 1;
39529318fe57SMatthew G. Knepley       for (i = 0; i < dim + 1; ++i) faces[i] = (dim + 1 == 1 ? 1 : 4 - (dim + 1));
39539566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", faces, &n, &flg));
39549318fe57SMatthew G. Knepley       n = 3;
39559566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
395663a3b9bcSJacob 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);
39579318fe57SMatthew G. Knepley       n = 3;
39589566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
395963a3b9bcSJacob 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);
39609566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateBoxSurfaceMesh_Internal(dm, dim + 1, faces, lower, upper, interpolate));
39619371c9d4SSatish Balay     } break;
39629371c9d4SSatish Balay     case DM_SHAPE_SPHERE: {
39639318fe57SMatthew G. Knepley       PetscReal R = 1.0;
39649318fe57SMatthew G. Knepley 
39659566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_sphere_radius", "Radius of the sphere", "", R, &R, &flg));
39669566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateSphereMesh_Internal(dm, dim, simplex, R));
39679371c9d4SSatish Balay     } break;
39689371c9d4SSatish Balay     case DM_SHAPE_BALL: {
39699318fe57SMatthew G. Knepley       PetscReal R = 1.0;
39709318fe57SMatthew G. Knepley 
39719566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_ball_radius", "Radius of the ball", "", R, &R, &flg));
39729566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateBallMesh_Internal(dm, dim, R));
39739371c9d4SSatish Balay     } break;
39749371c9d4SSatish Balay     case DM_SHAPE_CYLINDER: {
39759318fe57SMatthew G. Knepley       DMBoundaryType bdt = DM_BOUNDARY_NONE;
39769318fe57SMatthew G. Knepley       PetscInt       Nw  = 6;
39779318fe57SMatthew G. Knepley 
39789566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnum("-dm_plex_cylinder_bd", "Boundary type in the z direction", "", DMBoundaryTypes, (PetscEnum)bdt, (PetscEnum *)&bdt, NULL));
39799566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_cylinder_num_wedges", "Number of wedges around the cylinder", "", Nw, &Nw, NULL));
39809318fe57SMatthew G. Knepley       switch (cell) {
3981d71ae5a4SJacob Faibussowitsch       case DM_POLYTOPE_TRI_PRISM_TENSOR:
3982d71ae5a4SJacob Faibussowitsch         PetscCall(DMPlexCreateWedgeCylinderMesh_Internal(dm, Nw, interpolate));
3983d71ae5a4SJacob Faibussowitsch         break;
3984d71ae5a4SJacob Faibussowitsch       default:
3985d71ae5a4SJacob Faibussowitsch         PetscCall(DMPlexCreateHexCylinderMesh_Internal(dm, bdt));
3986d71ae5a4SJacob Faibussowitsch         break;
39879318fe57SMatthew G. Knepley       }
39889371c9d4SSatish Balay     } break;
3989b7f5c055SJed Brown     case DM_SHAPE_SCHWARZ_P: // fallthrough
39909371c9d4SSatish Balay     case DM_SHAPE_GYROID: {
3991b7f5c055SJed Brown       PetscInt       extent[3] = {1, 1, 1}, refine = 0, layers = 0, three;
3992b7f5c055SJed Brown       PetscReal      thickness   = 0.;
3993b7f5c055SJed Brown       DMBoundaryType periodic[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
3994b7f5c055SJed Brown       DMPlexTPSType  tps_type    = shape == DM_SHAPE_SCHWARZ_P ? DMPLEX_TPS_SCHWARZ_P : DMPLEX_TPS_GYROID;
39951436d7faSJed Brown       PetscBool      tps_distribute;
39969566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_tps_extent", "Number of replicas for each of three dimensions", NULL, extent, (three = 3, &three), NULL));
39979566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_tps_refine", "Number of refinements", NULL, refine, &refine, NULL));
39989566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnumArray("-dm_plex_tps_periodic", "Periodicity in each of three dimensions", NULL, DMBoundaryTypes, (PetscEnum *)periodic, (three = 3, &three), NULL));
39999566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_tps_layers", "Number of layers in volumetric extrusion (or zero to not extrude)", NULL, layers, &layers, NULL));
40009566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_tps_thickness", "Thickness of volumetric extrusion", NULL, thickness, &thickness, NULL));
40019566063dSJacob Faibussowitsch       PetscCall(DMPlexDistributeGetDefault(dm, &tps_distribute));
40029566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_tps_distribute", "Distribute the 2D mesh prior to refinement and extrusion", NULL, tps_distribute, &tps_distribute, NULL));
40039566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateTPSMesh_Internal(dm, tps_type, extent, periodic, tps_distribute, refine, layers, thickness));
40049371c9d4SSatish Balay     } break;
40059371c9d4SSatish Balay     case DM_SHAPE_DOUBLET: {
400605bd46c0SStefano Zampini       DM        dmnew;
400705bd46c0SStefano Zampini       PetscReal rl = 0.0;
400805bd46c0SStefano Zampini 
400905bd46c0SStefano Zampini       PetscCall(PetscOptionsReal("-dm_plex_doublet_refinementlimit", "Refinement limit", NULL, rl, &rl, NULL));
401005bd46c0SStefano Zampini       PetscCall(DMPlexCreateDoublet(PetscObjectComm((PetscObject)dm), dim, simplex, interpolate, rl, &dmnew));
40115de52c6dSVaclav Hapla       PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
401269d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &dmnew));
40139371c9d4SSatish Balay     } break;
4014cfb853baSMatthew G. Knepley     case DM_SHAPE_HYPERCUBIC: {
4015cfb853baSMatthew G. Knepley       PetscInt       *edges;
4016cfb853baSMatthew G. Knepley       PetscReal      *lower, *upper;
4017cfb853baSMatthew G. Knepley       DMBoundaryType *bdt;
4018cfb853baSMatthew G. Knepley       PetscInt        n, d;
4019cfb853baSMatthew G. Knepley 
4020cfb853baSMatthew G. Knepley       *useCoordSpace = PETSC_FALSE;
4021cfb853baSMatthew G. Knepley       PetscCall(PetscMalloc4(dim, &edges, dim, &lower, dim, &upper, dim, &bdt));
4022cfb853baSMatthew G. Knepley       for (d = 0; d < dim; ++d) {
4023cfb853baSMatthew G. Knepley         edges[d] = 1;
4024cfb853baSMatthew G. Knepley         lower[d] = 0.;
4025cfb853baSMatthew G. Knepley         upper[d] = 1.;
4026cfb853baSMatthew G. Knepley         bdt[d]   = DM_BOUNDARY_PERIODIC;
4027cfb853baSMatthew G. Knepley       }
4028cfb853baSMatthew G. Knepley       n = dim;
4029cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", edges, &n, &flg));
4030cfb853baSMatthew G. Knepley       n = dim;
4031cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
4032cfb853baSMatthew 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);
4033cfb853baSMatthew G. Knepley       n = dim;
4034cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
4035cfb853baSMatthew 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);
4036cfb853baSMatthew G. Knepley       n = dim;
4037cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsEnumArray("-dm_plex_box_bd", "Boundary type for each dimension", "", DMBoundaryTypes, (PetscEnum *)bdt, &n, &flg));
4038cfb853baSMatthew 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);
4039cfb853baSMatthew G. Knepley       PetscCall(DMPlexCreateHypercubicMesh_Internal(dm, dim, lower, upper, edges, bdt));
4040cfb853baSMatthew G. Knepley       PetscCall(PetscFree4(edges, lower, upper, bdt));
4041cfb853baSMatthew G. Knepley     } break;
4042d71ae5a4SJacob Faibussowitsch     default:
4043d71ae5a4SJacob Faibussowitsch       SETERRQ(comm, PETSC_ERR_SUP, "Domain shape %s is unsupported", DMPlexShapes[shape]);
40449318fe57SMatthew G. Knepley     }
40459318fe57SMatthew G. Knepley   }
40469566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
404748a46eb9SPierre Jolivet   if (!((PetscObject)dm)->name && nameflg) PetscCall(PetscObjectSetName((PetscObject)dm, plexname));
4048708be2fdSJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_CreateFromOptions, dm, 0, 0, 0));
40493ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
40500a6ba040SMatthew G. Knepley }
40510a6ba040SMatthew G. Knepley 
4052d71ae5a4SJacob Faibussowitsch PetscErrorCode DMSetFromOptions_NonRefinement_Plex(DM dm, PetscOptionItems *PetscOptionsObject)
4053d71ae5a4SJacob Faibussowitsch {
40540a6ba040SMatthew G. Knepley   DM_Plex  *mesh = (DM_Plex *)dm->data;
40557f9d8d6cSVaclav Hapla   PetscBool flg, flg2;
40569318fe57SMatthew G. Knepley   char      bdLabel[PETSC_MAX_PATH_LEN];
40570a6ba040SMatthew G. Knepley 
40580a6ba040SMatthew G. Knepley   PetscFunctionBegin;
40590a6ba040SMatthew G. Knepley   /* Handle viewing */
40609566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_print_set_values", "Output all set values info", "DMPlexMatSetClosure", PETSC_FALSE, &mesh->printSetValues, NULL));
40619566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_fem", "Debug output level all fem computations", "DMPlexSNESComputeResidualFEM", 0, &mesh->printFEM, NULL, 0));
40629566063dSJacob Faibussowitsch   PetscCall(PetscOptionsReal("-dm_plex_print_tol", "Tolerance for FEM output", "DMPlexSNESComputeResidualFEM", mesh->printTol, &mesh->printTol, NULL));
40639566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_l2", "Debug output level all L2 diff computations", "DMComputeL2Diff", 0, &mesh->printL2, NULL, 0));
4064f5867de0SMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_locate", "Debug output level all point location computations", "DMLocatePoints", 0, &mesh->printLocate, NULL, 0));
40659566063dSJacob Faibussowitsch   PetscCall(DMMonitorSetFromOptions(dm, "-dm_plex_monitor_throughput", "Monitor the simulation throughput", "DMPlexMonitorThroughput", DMPlexMonitorThroughput, NULL, &flg));
40669566063dSJacob Faibussowitsch   if (flg) PetscCall(PetscLogDefaultBegin());
40679318fe57SMatthew G. Knepley   /* Labeling */
40689566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_boundary_label", "Label to mark the mesh boundary", "", bdLabel, bdLabel, sizeof(bdLabel), &flg));
40699566063dSJacob Faibussowitsch   if (flg) PetscCall(DMPlexCreateBoundaryLabel_Private(dm, bdLabel));
4070953fc75cSMatthew G. Knepley   /* Point Location */
40719566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_hash_location", "Use grid hashing for point location", "DMInterpolate", PETSC_FALSE, &mesh->useHashLocation, NULL));
40720848f4b5SMatthew G. Knepley   /* Partitioning and distribution */
40739566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_partition_balance", "Attempt to evenly divide points on partition boundary between processes", "DMPlexSetPartitionBalance", PETSC_FALSE, &mesh->partitionBalance, NULL));
40742e62ab5aSMatthew G. Knepley   /* Generation and remeshing */
40759566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_remesh_bd", "Allow changes to the boundary on remeshing", "DMAdapt", PETSC_FALSE, &mesh->remeshBd, NULL));
4076b29cfa1cSToby Isaac   /* Projection behavior */
4077d5b43468SJose E. Roman   PetscCall(PetscOptionsBoundedInt("-dm_plex_max_projection_height", "Maximum mesh point height used to project locally", "DMPlexSetMaxProjectionHeight", 0, &mesh->maxProjectionHeight, NULL, 0));
40789566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_regular_refinement", "Use special nested projection algorithm for regular refinement", "DMPlexSetRegularRefinement", mesh->regularRefinement, &mesh->regularRefinement, NULL));
4079f12cf164SMatthew G. Knepley   /* Checking structure */
4080f12cf164SMatthew G. Knepley   {
40817f9d8d6cSVaclav Hapla     PetscBool all = PETSC_FALSE;
4082f12cf164SMatthew G. Knepley 
40837f9d8d6cSVaclav Hapla     PetscCall(PetscOptionsBool("-dm_plex_check_all", "Perform all basic checks", "DMPlexCheck", PETSC_FALSE, &all, NULL));
40847f9d8d6cSVaclav Hapla     if (all) {
40857f9d8d6cSVaclav Hapla       PetscCall(DMPlexCheck(dm));
40867f9d8d6cSVaclav Hapla     } else {
40879566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_symmetry", "Check that the adjacency information in the mesh is symmetric", "DMPlexCheckSymmetry", PETSC_FALSE, &flg, &flg2));
40887f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckSymmetry(dm));
40899566063dSJacob 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));
40907f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckSkeleton(dm, 0));
40919566063dSJacob 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));
40927f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckFaces(dm, 0));
40939566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_geometry", "Check that cells have positive volume", "DMPlexCheckGeometry", PETSC_FALSE, &flg, &flg2));
40947f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckGeometry(dm));
40959566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_pointsf", "Check some necessary conditions for PointSF", "DMPlexCheckPointSF", PETSC_FALSE, &flg, &flg2));
4096d7d32a9aSMatthew G. Knepley       if (flg && flg2) PetscCall(DMPlexCheckPointSF(dm, NULL, PETSC_FALSE));
40979566063dSJacob 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));
40987f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckInterfaceCones(dm));
40997f9d8d6cSVaclav Hapla     }
41009566063dSJacob Faibussowitsch     PetscCall(PetscOptionsBool("-dm_plex_check_cell_shape", "Check cell shape", "DMPlexCheckCellShape", PETSC_FALSE, &flg, &flg2));
41019566063dSJacob Faibussowitsch     if (flg && flg2) PetscCall(DMPlexCheckCellShape(dm, PETSC_TRUE, PETSC_DETERMINE));
4102f12cf164SMatthew G. Knepley   }
41039318fe57SMatthew G. Knepley   {
41049318fe57SMatthew G. Knepley     PetscReal scale = 1.0;
41054f3833eaSMatthew G. Knepley 
41069566063dSJacob Faibussowitsch     PetscCall(PetscOptionsReal("-dm_plex_scale", "Scale factor for mesh coordinates", "DMPlexScale", scale, &scale, &flg));
41079318fe57SMatthew G. Knepley     if (flg) {
41089318fe57SMatthew G. Knepley       Vec coordinates, coordinatesLocal;
41099318fe57SMatthew G. Knepley 
41109566063dSJacob Faibussowitsch       PetscCall(DMGetCoordinates(dm, &coordinates));
41119566063dSJacob Faibussowitsch       PetscCall(DMGetCoordinatesLocal(dm, &coordinatesLocal));
41129566063dSJacob Faibussowitsch       PetscCall(VecScale(coordinates, scale));
41139566063dSJacob Faibussowitsch       PetscCall(VecScale(coordinatesLocal, scale));
41149318fe57SMatthew G. Knepley     }
41159318fe57SMatthew G. Knepley   }
41169566063dSJacob Faibussowitsch   PetscCall(PetscPartitionerSetFromOptions(mesh->partitioner));
41173ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
411868d4fef7SMatthew G. Knepley }
411968d4fef7SMatthew G. Knepley 
4120d71ae5a4SJacob Faibussowitsch PetscErrorCode DMSetFromOptions_Overlap_Plex(DM dm, PetscOptionItems *PetscOptionsObject, PetscInt *overlap)
4121d71ae5a4SJacob Faibussowitsch {
4122c506a872SMatthew G. Knepley   PetscInt  numOvLabels = 16, numOvExLabels = 16;
4123c506a872SMatthew G. Knepley   char     *ovLabelNames[16], *ovExLabelNames[16];
4124c506a872SMatthew G. Knepley   PetscInt  numOvValues = 16, numOvExValues = 16, l;
4125c506a872SMatthew G. Knepley   PetscBool flg;
4126c506a872SMatthew G. Knepley 
4127c506a872SMatthew G. Knepley   PetscFunctionBegin;
4128c506a872SMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_distribute_overlap", "The size of the overlap halo", "DMPlexDistribute", *overlap, overlap, NULL, 0));
4129c506a872SMatthew G. Knepley   PetscCall(PetscOptionsStringArray("-dm_distribute_overlap_labels", "List of overlap label names", "DMPlexDistribute", ovLabelNames, &numOvLabels, &flg));
4130c506a872SMatthew G. Knepley   if (!flg) numOvLabels = 0;
4131c506a872SMatthew G. Knepley   if (numOvLabels) {
4132c506a872SMatthew G. Knepley     ((DM_Plex *)dm->data)->numOvLabels = numOvLabels;
4133c506a872SMatthew G. Knepley     for (l = 0; l < numOvLabels; ++l) {
4134c506a872SMatthew G. Knepley       PetscCall(DMGetLabel(dm, ovLabelNames[l], &((DM_Plex *)dm->data)->ovLabels[l]));
4135c506a872SMatthew G. Knepley       PetscCheck(((DM_Plex *)dm->data)->ovLabels[l], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid label name %s", ovLabelNames[l]);
4136c506a872SMatthew G. Knepley       PetscCall(PetscFree(ovLabelNames[l]));
4137c506a872SMatthew G. Knepley     }
4138c506a872SMatthew G. Knepley     PetscCall(PetscOptionsIntArray("-dm_distribute_overlap_values", "List of overlap label values", "DMPlexDistribute", ((DM_Plex *)dm->data)->ovValues, &numOvValues, &flg));
4139c506a872SMatthew G. Knepley     if (!flg) numOvValues = 0;
4140c506a872SMatthew 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);
4141c506a872SMatthew G. Knepley 
4142c506a872SMatthew G. Knepley     PetscCall(PetscOptionsStringArray("-dm_distribute_overlap_exclude_labels", "List of overlap exclude label names", "DMPlexDistribute", ovExLabelNames, &numOvExLabels, &flg));
4143c506a872SMatthew G. Knepley     if (!flg) numOvExLabels = 0;
4144c506a872SMatthew G. Knepley     ((DM_Plex *)dm->data)->numOvExLabels = numOvExLabels;
4145c506a872SMatthew G. Knepley     for (l = 0; l < numOvExLabels; ++l) {
4146c506a872SMatthew G. Knepley       PetscCall(DMGetLabel(dm, ovExLabelNames[l], &((DM_Plex *)dm->data)->ovExLabels[l]));
4147c506a872SMatthew G. Knepley       PetscCheck(((DM_Plex *)dm->data)->ovExLabels[l], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid label name %s", ovExLabelNames[l]);
4148c506a872SMatthew G. Knepley       PetscCall(PetscFree(ovExLabelNames[l]));
4149c506a872SMatthew G. Knepley     }
4150c506a872SMatthew G. Knepley     PetscCall(PetscOptionsIntArray("-dm_distribute_overlap_exclude_values", "List of overlap exclude label values", "DMPlexDistribute", ((DM_Plex *)dm->data)->ovExValues, &numOvExValues, &flg));
4151c506a872SMatthew G. Knepley     if (!flg) numOvExValues = 0;
4152c506a872SMatthew 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);
4153c506a872SMatthew G. Knepley   }
41543ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4155c506a872SMatthew G. Knepley }
4156c506a872SMatthew G. Knepley 
4157d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMSetFromOptions_Plex(DM dm, PetscOptionItems *PetscOptionsObject)
4158d71ae5a4SJacob Faibussowitsch {
4159bdf63967SMatthew G. Knepley   PetscFunctionList        ordlist;
4160bdf63967SMatthew G. Knepley   char                     oname[256];
4161d410b0cfSMatthew G. Knepley   PetscReal                volume    = -1.0;
41629318fe57SMatthew G. Knepley   PetscInt                 prerefine = 0, refine = 0, r, coarsen = 0, overlap = 0, extLayers = 0, dim;
4163e600fa54SMatthew G. Knepley   PetscBool                uniformOrig, created = PETSC_FALSE, uniform = PETSC_TRUE, distribute, interpolate = PETSC_TRUE, coordSpace = PETSC_TRUE, remap = PETSC_TRUE, ghostCells = PETSC_FALSE, isHierarchy, ignoreModel = PETSC_FALSE, flg;
41646bc1bd01Sksagiyam   DMPlexReorderDefaultFlag reorder;
416568d4fef7SMatthew G. Knepley 
416668d4fef7SMatthew G. Knepley   PetscFunctionBegin;
4167d0609cedSBarry Smith   PetscOptionsHeadBegin(PetscOptionsObject, "DMPlex Options");
4168dd4c3f67SMatthew G. Knepley   if (dm->cloneOpts) goto non_refine;
41699318fe57SMatthew G. Knepley   /* Handle automatic creation */
41709566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
41716bc1bd01Sksagiyam   if (dim < 0) {
41726bc1bd01Sksagiyam     PetscCall(DMPlexCreateFromOptions_Internal(PetscOptionsObject, &coordSpace, dm));
41736bc1bd01Sksagiyam     created = PETSC_TRUE;
41746bc1bd01Sksagiyam   }
41756bc1bd01Sksagiyam   PetscCall(DMGetDimension(dm, &dim));
4176d89e6e46SMatthew G. Knepley   /* Handle interpolation before distribution */
41779566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_interpolate_pre", "Flag to interpolate mesh before distribution", "", interpolate, &interpolate, &flg));
4178d89e6e46SMatthew G. Knepley   if (flg) {
4179d89e6e46SMatthew G. Knepley     DMPlexInterpolatedFlag interpolated;
4180d89e6e46SMatthew G. Knepley 
41819566063dSJacob Faibussowitsch     PetscCall(DMPlexIsInterpolated(dm, &interpolated));
4182d89e6e46SMatthew G. Knepley     if (interpolated == DMPLEX_INTERPOLATED_FULL && !interpolate) {
4183d89e6e46SMatthew G. Knepley       DM udm;
4184d89e6e46SMatthew G. Knepley 
41859566063dSJacob Faibussowitsch       PetscCall(DMPlexUninterpolate(dm, &udm));
418669d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &udm));
4187d89e6e46SMatthew G. Knepley     } else if (interpolated != DMPLEX_INTERPOLATED_FULL && interpolate) {
4188d89e6e46SMatthew G. Knepley       DM idm;
4189d89e6e46SMatthew G. Knepley 
41909566063dSJacob Faibussowitsch       PetscCall(DMPlexInterpolate(dm, &idm));
419169d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &idm));
4192d89e6e46SMatthew G. Knepley     }
4193d89e6e46SMatthew G. Knepley   }
41949b44eab4SMatthew G. Knepley   /* Handle DMPlex refinement before distribution */
41959566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_ignore_model", "Flag to ignore the geometry model when refining", "DMCreate", ignoreModel, &ignoreModel, &flg));
4196ad540459SPierre Jolivet   if (flg) ((DM_Plex *)dm->data)->ignoreModel = ignoreModel;
41979566063dSJacob Faibussowitsch   PetscCall(DMPlexGetRefinementUniform(dm, &uniformOrig));
41989566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine_pre", "The number of refinements before distribution", "DMCreate", prerefine, &prerefine, NULL, 0));
41999566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_remap_pre", "Flag to control coordinate remapping", "DMCreate", remap, &remap, NULL));
42009566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_uniform_pre", "Flag for uniform refinement before distribution", "DMCreate", uniform, &uniform, &flg));
42019566063dSJacob Faibussowitsch   if (flg) PetscCall(DMPlexSetRefinementUniform(dm, uniform));
42029566063dSJacob Faibussowitsch   PetscCall(PetscOptionsReal("-dm_refine_volume_limit_pre", "The maximum cell volume after refinement before distribution", "DMCreate", volume, &volume, &flg));
42039318fe57SMatthew G. Knepley   if (flg) {
42049566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementUniform(dm, PETSC_FALSE));
42059566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementLimit(dm, volume));
42069318fe57SMatthew G. Knepley     prerefine = PetscMax(prerefine, 1);
42079318fe57SMatthew G. Knepley   }
42089b44eab4SMatthew G. Knepley   for (r = 0; r < prerefine; ++r) {
42099b44eab4SMatthew G. Knepley     DM             rdm;
42109b44eab4SMatthew G. Knepley     PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
42119b44eab4SMatthew G. Knepley 
4212dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
42139566063dSJacob Faibussowitsch     PetscCall(DMRefine(dm, PetscObjectComm((PetscObject)dm), &rdm));
421469d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &rdm));
4215dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
421661a622f3SMatthew G. Knepley     if (coordFunc && remap) {
42179566063dSJacob Faibussowitsch       PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
42189b44eab4SMatthew G. Knepley       ((DM_Plex *)dm->data)->coordFunc = coordFunc;
42199b44eab4SMatthew G. Knepley     }
42209b44eab4SMatthew G. Knepley   }
42219566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, uniformOrig));
42229318fe57SMatthew G. Knepley   /* Handle DMPlex extrusion before distribution */
42239566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_extrude", "The number of layers to extrude", "", extLayers, &extLayers, NULL, 0));
42249318fe57SMatthew G. Knepley   if (extLayers) {
42259318fe57SMatthew G. Knepley     DM edm;
42269318fe57SMatthew G. Knepley 
42279566063dSJacob Faibussowitsch     PetscCall(DMExtrude(dm, extLayers, &edm));
422869d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &edm));
422948d16a33SMatthew G. Knepley     ((DM_Plex *)dm->data)->coordFunc = NULL;
4230dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4231d410b0cfSMatthew G. Knepley     extLayers = 0;
42325e17fc22SAidan Hamilton     PetscCall(DMGetDimension(dm, &dim));
42339318fe57SMatthew G. Knepley   }
4234bdf63967SMatthew G. Knepley   /* Handle DMPlex reordering before distribution */
42356bc1bd01Sksagiyam   PetscCall(DMPlexReorderGetDefault(dm, &reorder));
42369566063dSJacob Faibussowitsch   PetscCall(MatGetOrderingList(&ordlist));
42376bc1bd01Sksagiyam   PetscCall(PetscStrncpy(oname, MATORDERINGNATURAL, sizeof(oname)));
42389566063dSJacob Faibussowitsch   PetscCall(PetscOptionsFList("-dm_plex_reorder", "Set mesh reordering type", "DMPlexGetOrdering", ordlist, MATORDERINGNATURAL, oname, sizeof(oname), &flg));
42396bc1bd01Sksagiyam   if (reorder == DMPLEX_REORDER_DEFAULT_TRUE || flg) {
4240bdf63967SMatthew G. Knepley     DM pdm;
4241bdf63967SMatthew G. Knepley     IS perm;
4242bdf63967SMatthew G. Knepley 
42439566063dSJacob Faibussowitsch     PetscCall(DMPlexGetOrdering(dm, oname, NULL, &perm));
42449566063dSJacob Faibussowitsch     PetscCall(DMPlexPermute(dm, perm, &pdm));
42459566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&perm));
424669d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &pdm));
4247dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4248bdf63967SMatthew G. Knepley   }
42499b44eab4SMatthew G. Knepley   /* Handle DMPlex distribution */
42509566063dSJacob Faibussowitsch   PetscCall(DMPlexDistributeGetDefault(dm, &distribute));
4251c506a872SMatthew G. Knepley   PetscCall(PetscOptionsBool("-dm_distribute", "Flag to redistribute a mesh among processes", "DMPlexDistribute", distribute, &distribute, NULL));
4252dbbe0bcdSBarry Smith   PetscCall(DMSetFromOptions_Overlap_Plex(dm, PetscOptionsObject, &overlap));
42539b44eab4SMatthew G. Knepley   if (distribute) {
42549b44eab4SMatthew G. Knepley     DM               pdm = NULL;
42559b44eab4SMatthew G. Knepley     PetscPartitioner part;
42569b44eab4SMatthew G. Knepley 
42579566063dSJacob Faibussowitsch     PetscCall(DMPlexGetPartitioner(dm, &part));
42589566063dSJacob Faibussowitsch     PetscCall(PetscPartitionerSetFromOptions(part));
42599566063dSJacob Faibussowitsch     PetscCall(DMPlexDistribute(dm, overlap, NULL, &pdm));
426048a46eb9SPierre Jolivet     if (pdm) PetscCall(DMPlexReplace_Internal(dm, &pdm));
42619b44eab4SMatthew G. Knepley   }
4262d2b2dc1eSMatthew G. Knepley   /* Must check CEED options before creating function space for coordinates */
4263d2b2dc1eSMatthew G. Knepley   {
4264d2b2dc1eSMatthew G. Knepley     PetscBool useCeed = PETSC_FALSE, flg;
4265d2b2dc1eSMatthew G. Knepley 
4266d2b2dc1eSMatthew G. Knepley     PetscCall(PetscOptionsBool("-dm_plex_use_ceed", "Use LibCEED as the FEM backend", "DMPlexSetUseCeed", useCeed, &useCeed, &flg));
4267d2b2dc1eSMatthew G. Knepley     if (flg) PetscCall(DMPlexSetUseCeed(dm, useCeed));
4268d2b2dc1eSMatthew G. Knepley   }
42699318fe57SMatthew G. Knepley   /* Create coordinate space */
42709318fe57SMatthew G. Knepley   if (created) {
427161a622f3SMatthew G. Knepley     DM_Plex  *mesh   = (DM_Plex *)dm->data;
42729318fe57SMatthew G. Knepley     PetscInt  degree = 1;
42735515ebd3SMatthew G. Knepley     PetscInt  height = 0;
42745515ebd3SMatthew G. Knepley     DM        cdm;
42756858538eSMatthew G. Knepley     PetscBool flg;
42769318fe57SMatthew G. Knepley 
42779566063dSJacob Faibussowitsch     PetscCall(PetscOptionsBool("-dm_coord_space", "Use an FEM space for coordinates", "", coordSpace, &coordSpace, &flg));
42789566063dSJacob Faibussowitsch     PetscCall(PetscOptionsInt("-dm_coord_petscspace_degree", "FEM degree for coordinate space", "", degree, &degree, NULL));
42799566063dSJacob Faibussowitsch     if (coordSpace) PetscCall(DMPlexCreateCoordinateSpace(dm, degree, mesh->coordFunc));
42805515ebd3SMatthew G. Knepley     PetscCall(DMGetCoordinateDM(dm, &cdm));
428161a622f3SMatthew G. Knepley     if (flg && !coordSpace) {
428261a622f3SMatthew G. Knepley       PetscDS      cds;
428361a622f3SMatthew G. Knepley       PetscObject  obj;
428461a622f3SMatthew G. Knepley       PetscClassId id;
428561a622f3SMatthew G. Knepley 
42869566063dSJacob Faibussowitsch       PetscCall(DMGetDS(cdm, &cds));
42879566063dSJacob Faibussowitsch       PetscCall(PetscDSGetDiscretization(cds, 0, &obj));
42889566063dSJacob Faibussowitsch       PetscCall(PetscObjectGetClassId(obj, &id));
428961a622f3SMatthew G. Knepley       if (id == PETSCFE_CLASSID) {
429061a622f3SMatthew G. Knepley         PetscContainer dummy;
429161a622f3SMatthew G. Knepley 
42929566063dSJacob Faibussowitsch         PetscCall(PetscContainerCreate(PETSC_COMM_SELF, &dummy));
42939566063dSJacob Faibussowitsch         PetscCall(PetscObjectSetName((PetscObject)dummy, "coordinates"));
42949566063dSJacob Faibussowitsch         PetscCall(DMSetField(cdm, 0, NULL, (PetscObject)dummy));
42959566063dSJacob Faibussowitsch         PetscCall(PetscContainerDestroy(&dummy));
42969566063dSJacob Faibussowitsch         PetscCall(DMClearDS(cdm));
429761a622f3SMatthew G. Knepley       }
429861a622f3SMatthew G. Knepley       mesh->coordFunc = NULL;
429961a622f3SMatthew G. Knepley     }
43006858538eSMatthew G. Knepley     PetscCall(PetscOptionsBool("-dm_sparse_localize", "Localize only necessary cells", "", dm->sparseLocalize, &dm->sparseLocalize, &flg));
43015515ebd3SMatthew G. Knepley     PetscCall(PetscOptionsInt("-dm_localize_height", "Localize edges and faces in addition to cells", "", height, &height, &flg));
43025515ebd3SMatthew G. Knepley     if (flg) PetscCall(DMPlexSetMaxProjectionHeight(cdm, height));
43039566063dSJacob Faibussowitsch     PetscCall(DMLocalizeCoordinates(dm));
43049318fe57SMatthew G. Knepley   }
430568d4fef7SMatthew G. Knepley   /* Handle DMPlex refinement */
430661a622f3SMatthew G. Knepley   remap = PETSC_TRUE;
43079566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine", "The number of uniform refinements", "DMCreate", refine, &refine, NULL, 0));
43089566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_remap", "Flag to control coordinate remapping", "DMCreate", remap, &remap, NULL));
43099566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine_hierarchy", "The number of uniform refinements", "DMCreate", refine, &refine, &isHierarchy, 0));
43109566063dSJacob Faibussowitsch   if (refine) PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
431168d4fef7SMatthew G. Knepley   if (refine && isHierarchy) {
4312acdc6f61SToby Isaac     DM *dms, coarseDM;
431368d4fef7SMatthew G. Knepley 
43149566063dSJacob Faibussowitsch     PetscCall(DMGetCoarseDM(dm, &coarseDM));
43159566063dSJacob Faibussowitsch     PetscCall(PetscObjectReference((PetscObject)coarseDM));
43169566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(refine, &dms));
43179566063dSJacob Faibussowitsch     PetscCall(DMRefineHierarchy(dm, refine, dms));
431868d4fef7SMatthew G. Knepley     /* Total hack since we do not pass in a pointer */
43199566063dSJacob Faibussowitsch     PetscCall(DMPlexSwap_Static(dm, dms[refine - 1]));
432068d4fef7SMatthew G. Knepley     if (refine == 1) {
43219566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dm, dms[0]));
43229566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dm, PETSC_TRUE));
432368d4fef7SMatthew G. Knepley     } else {
43249566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dm, dms[refine - 2]));
43259566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dm, PETSC_TRUE));
43269566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dms[0], dms[refine - 1]));
43279566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dms[0], PETSC_TRUE));
432868d4fef7SMatthew G. Knepley     }
43299566063dSJacob Faibussowitsch     PetscCall(DMSetCoarseDM(dms[refine - 1], coarseDM));
43309566063dSJacob Faibussowitsch     PetscCall(PetscObjectDereference((PetscObject)coarseDM));
433168d4fef7SMatthew G. Knepley     /* Free DMs */
433268d4fef7SMatthew G. Knepley     for (r = 0; r < refine; ++r) {
4333dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dms[r], PetscOptionsObject));
43349566063dSJacob Faibussowitsch       PetscCall(DMDestroy(&dms[r]));
433568d4fef7SMatthew G. Knepley     }
43369566063dSJacob Faibussowitsch     PetscCall(PetscFree(dms));
433768d4fef7SMatthew G. Knepley   } else {
433868d4fef7SMatthew G. Knepley     for (r = 0; r < refine; ++r) {
43399318fe57SMatthew G. Knepley       DM             rdm;
434051a74b61SMatthew G. Knepley       PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
434168d4fef7SMatthew G. Knepley 
4342dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
43439566063dSJacob Faibussowitsch       PetscCall(DMRefine(dm, PetscObjectComm((PetscObject)dm), &rdm));
434468d4fef7SMatthew G. Knepley       /* Total hack since we do not pass in a pointer */
434569d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &rdm));
4346dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
434761a622f3SMatthew G. Knepley       if (coordFunc && remap) {
43489566063dSJacob Faibussowitsch         PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
434951a74b61SMatthew G. Knepley         ((DM_Plex *)dm->data)->coordFunc = coordFunc;
435051a74b61SMatthew G. Knepley       }
435168d4fef7SMatthew G. Knepley     }
435268d4fef7SMatthew G. Knepley   }
43533cf6fe12SMatthew G. Knepley   /* Handle DMPlex coarsening */
43549566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_coarsen", "Coarsen the mesh", "DMCreate", coarsen, &coarsen, NULL, 0));
43559566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_coarsen_hierarchy", "The number of coarsenings", "DMCreate", coarsen, &coarsen, &isHierarchy, 0));
4356b653a561SMatthew G. Knepley   if (coarsen && isHierarchy) {
4357b653a561SMatthew G. Knepley     DM *dms;
4358b653a561SMatthew G. Knepley 
43599566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(coarsen, &dms));
43609566063dSJacob Faibussowitsch     PetscCall(DMCoarsenHierarchy(dm, coarsen, dms));
4361b653a561SMatthew G. Knepley     /* Free DMs */
4362b653a561SMatthew G. Knepley     for (r = 0; r < coarsen; ++r) {
4363dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dms[r], PetscOptionsObject));
43649566063dSJacob Faibussowitsch       PetscCall(DMDestroy(&dms[r]));
4365b653a561SMatthew G. Knepley     }
43669566063dSJacob Faibussowitsch     PetscCall(PetscFree(dms));
4367b653a561SMatthew G. Knepley   } else {
4368b653a561SMatthew G. Knepley     for (r = 0; r < coarsen; ++r) {
43699318fe57SMatthew G. Knepley       DM             cdm;
43709318fe57SMatthew G. Knepley       PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
43713cf6fe12SMatthew G. Knepley 
4372dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
43739566063dSJacob Faibussowitsch       PetscCall(DMCoarsen(dm, PetscObjectComm((PetscObject)dm), &cdm));
43743cf6fe12SMatthew G. Knepley       /* Total hack since we do not pass in a pointer */
437569d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &cdm));
4376dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
43779318fe57SMatthew G. Knepley       if (coordFunc) {
43789566063dSJacob Faibussowitsch         PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
43799318fe57SMatthew G. Knepley         ((DM_Plex *)dm->data)->coordFunc = coordFunc;
43809318fe57SMatthew G. Knepley       }
43813cf6fe12SMatthew G. Knepley     }
4382b653a561SMatthew G. Knepley   }
4383909dfd52SMatthew G. Knepley   /* Handle ghost cells */
43849566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_create_fv_ghost_cells", "Flag to create finite volume ghost cells on the boundary", "DMCreate", ghostCells, &ghostCells, NULL));
4385909dfd52SMatthew G. Knepley   if (ghostCells) {
4386909dfd52SMatthew G. Knepley     DM   gdm;
4387909dfd52SMatthew G. Knepley     char lname[PETSC_MAX_PATH_LEN];
4388909dfd52SMatthew G. Knepley 
4389909dfd52SMatthew G. Knepley     lname[0] = '\0';
43909566063dSJacob Faibussowitsch     PetscCall(PetscOptionsString("-dm_plex_fv_ghost_cells_label", "Label name for ghost cells boundary", "DMCreate", lname, lname, sizeof(lname), &flg));
43919566063dSJacob Faibussowitsch     PetscCall(DMPlexConstructGhostCells(dm, flg ? lname : NULL, NULL, &gdm));
439269d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &gdm));
4393909dfd52SMatthew G. Knepley   }
43946913077dSMatthew G. Knepley   /* Handle 1D order */
43956bc1bd01Sksagiyam   if (reorder != DMPLEX_REORDER_DEFAULT_FALSE && dim == 1) {
43966913077dSMatthew G. Knepley     DM           cdm, rdm;
43976913077dSMatthew G. Knepley     PetscDS      cds;
43986913077dSMatthew G. Knepley     PetscObject  obj;
43996913077dSMatthew G. Knepley     PetscClassId id = PETSC_OBJECT_CLASSID;
44006913077dSMatthew G. Knepley     IS           perm;
44016bc1bd01Sksagiyam     PetscInt     Nf;
44026913077dSMatthew G. Knepley     PetscBool    distributed;
44036913077dSMatthew G. Knepley 
44049566063dSJacob Faibussowitsch     PetscCall(DMPlexIsDistributed(dm, &distributed));
44059566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
44069566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
44079566063dSJacob Faibussowitsch     PetscCall(PetscDSGetNumFields(cds, &Nf));
44086913077dSMatthew G. Knepley     if (Nf) {
44099566063dSJacob Faibussowitsch       PetscCall(PetscDSGetDiscretization(cds, 0, &obj));
44109566063dSJacob Faibussowitsch       PetscCall(PetscObjectGetClassId(obj, &id));
44116913077dSMatthew G. Knepley     }
44126bc1bd01Sksagiyam     if (!distributed && id != PETSCFE_CLASSID) {
44139566063dSJacob Faibussowitsch       PetscCall(DMPlexGetOrdering1D(dm, &perm));
44149566063dSJacob Faibussowitsch       PetscCall(DMPlexPermute(dm, perm, &rdm));
441569d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &rdm));
44169566063dSJacob Faibussowitsch       PetscCall(ISDestroy(&perm));
44176913077dSMatthew G. Knepley     }
44186913077dSMatthew G. Knepley   }
44193cf6fe12SMatthew G. Knepley /* Handle */
4420dd4c3f67SMatthew G. Knepley non_refine:
4421dbbe0bcdSBarry Smith   PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4422d0609cedSBarry Smith   PetscOptionsHeadEnd();
44233ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
44240a6ba040SMatthew G. Knepley }
44250a6ba040SMatthew G. Knepley 
4426d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMCreateGlobalVector_Plex(DM dm, Vec *vec)
4427d71ae5a4SJacob Faibussowitsch {
4428552f7358SJed Brown   PetscFunctionBegin;
44299566063dSJacob Faibussowitsch   PetscCall(DMCreateGlobalVector_Section_Private(dm, vec));
44309566063dSJacob Faibussowitsch   /* PetscCall(VecSetOperation(*vec, VECOP_DUPLICATE, (void(*)(void)) VecDuplicate_MPI_DM)); */
44319566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEW, (void (*)(void))VecView_Plex));
44329566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEWNATIVE, (void (*)(void))VecView_Plex_Native));
44339566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOAD, (void (*)(void))VecLoad_Plex));
44349566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOADNATIVE, (void (*)(void))VecLoad_Plex_Native));
44353ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4436552f7358SJed Brown }
4437552f7358SJed Brown 
4438d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMCreateLocalVector_Plex(DM dm, Vec *vec)
4439d71ae5a4SJacob Faibussowitsch {
4440552f7358SJed Brown   PetscFunctionBegin;
44419566063dSJacob Faibussowitsch   PetscCall(DMCreateLocalVector_Section_Private(dm, vec));
44429566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEW, (void (*)(void))VecView_Plex_Local));
44439566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOAD, (void (*)(void))VecLoad_Plex_Local));
44443ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4445552f7358SJed Brown }
4446552f7358SJed Brown 
4447d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMGetDimPoints_Plex(DM dm, PetscInt dim, PetscInt *pStart, PetscInt *pEnd)
4448d71ae5a4SJacob Faibussowitsch {
4449793f3fe5SMatthew G. Knepley   PetscInt depth, d;
4450793f3fe5SMatthew G. Knepley 
4451793f3fe5SMatthew G. Knepley   PetscFunctionBegin;
44529566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepth(dm, &depth));
4453793f3fe5SMatthew G. Knepley   if (depth == 1) {
44549566063dSJacob Faibussowitsch     PetscCall(DMGetDimension(dm, &d));
44559566063dSJacob Faibussowitsch     if (dim == 0) PetscCall(DMPlexGetDepthStratum(dm, dim, pStart, pEnd));
44569566063dSJacob Faibussowitsch     else if (dim == d) PetscCall(DMPlexGetDepthStratum(dm, 1, pStart, pEnd));
44579371c9d4SSatish Balay     else {
44589371c9d4SSatish Balay       *pStart = 0;
44599371c9d4SSatish Balay       *pEnd   = 0;
44609371c9d4SSatish Balay     }
4461793f3fe5SMatthew G. Knepley   } else {
44629566063dSJacob Faibussowitsch     PetscCall(DMPlexGetDepthStratum(dm, dim, pStart, pEnd));
4463793f3fe5SMatthew G. Knepley   }
44643ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4465793f3fe5SMatthew G. Knepley }
4466793f3fe5SMatthew G. Knepley 
4467d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMGetNeighbors_Plex(DM dm, PetscInt *nranks, const PetscMPIInt *ranks[])
4468d71ae5a4SJacob Faibussowitsch {
4469502a2867SDave May   PetscSF            sf;
44700a19bb7dSprj-   PetscInt           niranks, njranks, n;
44710a19bb7dSprj-   const PetscMPIInt *iranks, *jranks;
44720a19bb7dSprj-   DM_Plex           *data = (DM_Plex *)dm->data;
4473502a2867SDave May 
44742f356facSMatthew G. Knepley   PetscFunctionBegin;
44759566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dm, &sf));
44760a19bb7dSprj-   if (!data->neighbors) {
44779566063dSJacob Faibussowitsch     PetscCall(PetscSFSetUp(sf));
44789566063dSJacob Faibussowitsch     PetscCall(PetscSFGetRootRanks(sf, &njranks, &jranks, NULL, NULL, NULL));
44799566063dSJacob Faibussowitsch     PetscCall(PetscSFGetLeafRanks(sf, &niranks, &iranks, NULL, NULL));
44809566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(njranks + niranks + 1, &data->neighbors));
44819566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(data->neighbors + 1, jranks, njranks));
44829566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(data->neighbors + njranks + 1, iranks, niranks));
44830a19bb7dSprj-     n = njranks + niranks;
44849566063dSJacob Faibussowitsch     PetscCall(PetscSortRemoveDupsMPIInt(&n, data->neighbors + 1));
44850a19bb7dSprj-     /* The following cast should never fail: can't have more neighbors than PETSC_MPI_INT_MAX */
44869566063dSJacob Faibussowitsch     PetscCall(PetscMPIIntCast(n, data->neighbors));
44870a19bb7dSprj-   }
44880a19bb7dSprj-   if (nranks) *nranks = data->neighbors[0];
44890a19bb7dSprj-   if (ranks) {
44900a19bb7dSprj-     if (data->neighbors[0]) *ranks = data->neighbors + 1;
44910a19bb7dSprj-     else *ranks = NULL;
44920a19bb7dSprj-   }
44933ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4494502a2867SDave May }
4495502a2867SDave May 
44961eb70e55SToby Isaac PETSC_INTERN PetscErrorCode DMInterpolateSolution_Plex(DM, DM, Mat, Vec, Vec);
44971eb70e55SToby Isaac 
4498d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMInitialize_Plex(DM dm)
4499d71ae5a4SJacob Faibussowitsch {
4500552f7358SJed Brown   PetscFunctionBegin;
4501552f7358SJed Brown   dm->ops->view                      = DMView_Plex;
45022c40f234SMatthew G. Knepley   dm->ops->load                      = DMLoad_Plex;
4503552f7358SJed Brown   dm->ops->setfromoptions            = DMSetFromOptions_Plex;
450438221697SMatthew G. Knepley   dm->ops->clone                     = DMClone_Plex;
4505552f7358SJed Brown   dm->ops->setup                     = DMSetUp_Plex;
45061bb6d2a8SBarry Smith   dm->ops->createlocalsection        = DMCreateLocalSection_Plex;
450766ad2231SToby Isaac   dm->ops->createdefaultconstraints  = DMCreateDefaultConstraints_Plex;
4508552f7358SJed Brown   dm->ops->createglobalvector        = DMCreateGlobalVector_Plex;
4509552f7358SJed Brown   dm->ops->createlocalvector         = DMCreateLocalVector_Plex;
4510184d77edSJed Brown   dm->ops->getlocaltoglobalmapping   = NULL;
45110298fd71SBarry Smith   dm->ops->createfieldis             = NULL;
4512552f7358SJed Brown   dm->ops->createcoordinatedm        = DMCreateCoordinateDM_Plex;
4513f19dbd58SToby Isaac   dm->ops->createcoordinatefield     = DMCreateCoordinateField_Plex;
45140a6ba040SMatthew G. Knepley   dm->ops->getcoloring               = NULL;
4515552f7358SJed Brown   dm->ops->creatematrix              = DMCreateMatrix_Plex;
4516bceba477SMatthew G. Knepley   dm->ops->createinterpolation       = DMCreateInterpolation_Plex;
4517bd041c0cSMatthew G. Knepley   dm->ops->createmassmatrix          = DMCreateMassMatrix_Plex;
4518b4937a87SMatthew G. Knepley   dm->ops->createmassmatrixlumped    = DMCreateMassMatrixLumped_Plex;
45195a84ad33SLisandro Dalcin   dm->ops->createinjection           = DMCreateInjection_Plex;
4520552f7358SJed Brown   dm->ops->refine                    = DMRefine_Plex;
45210a6ba040SMatthew G. Knepley   dm->ops->coarsen                   = DMCoarsen_Plex;
45220a6ba040SMatthew G. Knepley   dm->ops->refinehierarchy           = DMRefineHierarchy_Plex;
4523b653a561SMatthew G. Knepley   dm->ops->coarsenhierarchy          = DMCoarsenHierarchy_Plex;
4524d410b0cfSMatthew G. Knepley   dm->ops->extrude                   = DMExtrude_Plex;
45250298fd71SBarry Smith   dm->ops->globaltolocalbegin        = NULL;
45260298fd71SBarry Smith   dm->ops->globaltolocalend          = NULL;
45270298fd71SBarry Smith   dm->ops->localtoglobalbegin        = NULL;
45280298fd71SBarry Smith   dm->ops->localtoglobalend          = NULL;
4529552f7358SJed Brown   dm->ops->destroy                   = DMDestroy_Plex;
4530552f7358SJed Brown   dm->ops->createsubdm               = DMCreateSubDM_Plex;
45312adcc780SMatthew G. Knepley   dm->ops->createsuperdm             = DMCreateSuperDM_Plex;
4532793f3fe5SMatthew G. Knepley   dm->ops->getdimpoints              = DMGetDimPoints_Plex;
4533552f7358SJed Brown   dm->ops->locatepoints              = DMLocatePoints_Plex;
45340709b2feSToby Isaac   dm->ops->projectfunctionlocal      = DMProjectFunctionLocal_Plex;
45350709b2feSToby Isaac   dm->ops->projectfunctionlabellocal = DMProjectFunctionLabelLocal_Plex;
4536bfc4295aSToby Isaac   dm->ops->projectfieldlocal         = DMProjectFieldLocal_Plex;
45378c6c5593SMatthew G. Knepley   dm->ops->projectfieldlabellocal    = DMProjectFieldLabelLocal_Plex;
4538ece3a9fcSMatthew G. Knepley   dm->ops->projectbdfieldlabellocal  = DMProjectBdFieldLabelLocal_Plex;
45390709b2feSToby Isaac   dm->ops->computel2diff             = DMComputeL2Diff_Plex;
4540b698f381SToby Isaac   dm->ops->computel2gradientdiff     = DMComputeL2GradientDiff_Plex;
45412a16baeaSToby Isaac   dm->ops->computel2fielddiff        = DMComputeL2FieldDiff_Plex;
454228d58a37SPierre Jolivet   dm->ops->getneighbors              = DMGetNeighbors_Plex;
45439566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexInsertBoundaryValues_C", DMPlexInsertBoundaryValues_Plex));
45449566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexInsertTimeDerviativeBoundaryValues_C", DMPlexInsertTimeDerivativeBoundaryValues_Plex));
45459566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMSetUpGLVisViewer_C", DMSetUpGLVisViewer_Plex));
45469566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMCreateNeumannOverlap_C", DMCreateNeumannOverlap_Plex));
45479566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetOverlap_C", DMPlexGetOverlap_Plex));
45489566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexDistributeGetDefault_C", DMPlexDistributeGetDefault_Plex));
45499566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexDistributeSetDefault_C", DMPlexDistributeSetDefault_Plex));
45506bc1bd01Sksagiyam   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexReorderGetDefault_C", DMPlexReorderGetDefault_Plex));
45516bc1bd01Sksagiyam   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexReorderSetDefault_C", DMPlexReorderSetDefault_Plex));
45529566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMInterpolateSolution_C", DMInterpolateSolution_Plex));
4553c506a872SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetOverlap_C", DMPlexGetOverlap_Plex));
4554c506a872SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexSetOverlap_C", DMPlexSetOverlap_Plex));
4555d2b2dc1eSMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetUseCeed_C", DMPlexGetUseCeed_Plex));
4556d2b2dc1eSMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexSetUseCeed_C", DMPlexSetUseCeed_Plex));
45573ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4558552f7358SJed Brown }
4559552f7358SJed Brown 
4560d71ae5a4SJacob Faibussowitsch PETSC_INTERN PetscErrorCode DMClone_Plex(DM dm, DM *newdm)
4561d71ae5a4SJacob Faibussowitsch {
456263a16f15SMatthew G. Knepley   DM_Plex *mesh = (DM_Plex *)dm->data;
45636725e60dSJed Brown   PetscSF  face_sf;
456463a16f15SMatthew G. Knepley 
456563a16f15SMatthew G. Knepley   PetscFunctionBegin;
456663a16f15SMatthew G. Knepley   mesh->refct++;
456763a16f15SMatthew G. Knepley   (*newdm)->data = mesh;
45685f06a3ddSJed Brown   PetscCall(DMPlexGetIsoperiodicFaceSF(dm, &face_sf));
45695f06a3ddSJed Brown   PetscCall(DMPlexSetIsoperiodicFaceSF(*newdm, face_sf));
45709566063dSJacob Faibussowitsch   PetscCall(PetscObjectChangeTypeName((PetscObject)*newdm, DMPLEX));
45719566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(*newdm));
45723ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
457363a16f15SMatthew G. Knepley }
457463a16f15SMatthew G. Knepley 
45758818961aSMatthew G Knepley /*MC
4576a1cb98faSBarry Smith   DMPLEX = "plex" - A `DM` object that encapsulates an unstructured mesh, or CW Complex, which can be expressed using a Hasse Diagram.
457720f4b53cSBarry Smith                     In the local representation, `Vec`s contain all unknowns in the interior and shared boundary. This is
45788818961aSMatthew G Knepley                     specified by a PetscSection object. Ownership in the global representation is determined by
4579a1cb98faSBarry Smith                     ownership of the underlying `DMPLEX` points. This is specified by another `PetscSection` object.
45808818961aSMatthew G Knepley 
4581e5893cccSMatthew G. Knepley   Options Database Keys:
4582250712c9SMatthew G. Knepley + -dm_refine_pre                     - Refine mesh before distribution
4583250712c9SMatthew G. Knepley + -dm_refine_uniform_pre             - Choose uniform or generator-based refinement
4584250712c9SMatthew G. Knepley + -dm_refine_volume_limit_pre        - Cell volume limit after pre-refinement using generator
4585250712c9SMatthew G. Knepley . -dm_distribute                     - Distribute mesh across processes
4586250712c9SMatthew G. Knepley . -dm_distribute_overlap             - Number of cells to overlap for distribution
4587250712c9SMatthew G. Knepley . -dm_refine                         - Refine mesh after distribution
4588250712c9SMatthew G. Knepley . -dm_plex_hash_location             - Use grid hashing for point location
4589ddce0771SMatthew G. Knepley . -dm_plex_hash_box_faces <n,m,p>    - The number of divisions in each direction of the grid hash
4590f12cf164SMatthew G. Knepley . -dm_plex_partition_balance         - Attempt to evenly divide points on partition boundary between processes
4591f12cf164SMatthew G. Knepley . -dm_plex_remesh_bd                 - Allow changes to the boundary on remeshing
4592d5b43468SJose E. Roman . -dm_plex_max_projection_height     - Maximum mesh point height used to project locally
4593f12cf164SMatthew G. Knepley . -dm_plex_regular_refinement        - Use special nested projection algorithm for regular refinement
4594aaa8cc7dSPierre Jolivet . -dm_plex_check_all                 - Perform all checks below
4595f12cf164SMatthew G. Knepley . -dm_plex_check_symmetry            - Check that the adjacency information in the mesh is symmetric
4596f12cf164SMatthew G. Knepley . -dm_plex_check_skeleton <celltype> - Check that each cell has the correct number of vertices
4597f12cf164SMatthew 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
4598f12cf164SMatthew G. Knepley . -dm_plex_check_geometry            - Check that cells have positive volume
4599f12cf164SMatthew G. Knepley . -dm_view :mesh.tex:ascii_latex     - View the mesh in LaTeX/TikZ
4600e5893cccSMatthew G. Knepley . -dm_plex_view_scale <num>          - Scale the TikZ
4601e5893cccSMatthew G. Knepley - -dm_plex_print_fem <num>           - View FEM assembly information, such as element vectors and matrices
4602e5893cccSMatthew G. Knepley 
46038818961aSMatthew G Knepley   Level: intermediate
46048818961aSMatthew G Knepley 
46051cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMType`, `DMPlexCreate()`, `DMCreate()`, `DMSetType()`, `PetscSection`
46068818961aSMatthew G Knepley M*/
46078818961aSMatthew G Knepley 
4608d71ae5a4SJacob Faibussowitsch PETSC_EXTERN PetscErrorCode DMCreate_Plex(DM dm)
4609d71ae5a4SJacob Faibussowitsch {
4610552f7358SJed Brown   DM_Plex *mesh;
4611412e9a14SMatthew G. Knepley   PetscInt unit;
4612552f7358SJed Brown 
4613552f7358SJed Brown   PetscFunctionBegin;
4614f39ec787SMatthew G. Knepley   PetscCall(PetscCitationsRegister(PlexCitation, &Plexcite));
4615552f7358SJed Brown   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
46164dfa11a4SJacob Faibussowitsch   PetscCall(PetscNew(&mesh));
4617552f7358SJed Brown   dm->data = mesh;
4618552f7358SJed Brown 
4619552f7358SJed Brown   mesh->refct = 1;
46209566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &mesh->coneSection));
46219566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &mesh->supportSection));
4622552f7358SJed Brown   mesh->refinementUniform      = PETSC_TRUE;
4623552f7358SJed Brown   mesh->refinementLimit        = -1.0;
4624e600fa54SMatthew G. Knepley   mesh->distDefault            = PETSC_TRUE;
46256bc1bd01Sksagiyam   mesh->reorderDefault         = DMPLEX_REORDER_DEFAULT_NOTSET;
46261d1f2f2aSksagiyam   mesh->distributionName       = NULL;
46277d0f5628SVaclav Hapla   mesh->interpolated           = DMPLEX_INTERPOLATED_INVALID;
46287d0f5628SVaclav Hapla   mesh->interpolatedCollective = DMPLEX_INTERPOLATED_INVALID;
4629552f7358SJed Brown 
46309566063dSJacob Faibussowitsch   PetscCall(PetscPartitionerCreate(PetscObjectComm((PetscObject)dm), &mesh->partitioner));
46312e62ab5aSMatthew G. Knepley   mesh->remeshBd = PETSC_FALSE;
4632d9deefdfSMatthew G. Knepley 
46338865f1eaSKarl Rupp   for (unit = 0; unit < NUM_PETSC_UNITS; ++unit) mesh->scale[unit] = 1.0;
4634552f7358SJed Brown 
4635df0420ecSMatthew G. Knepley   mesh->depthState    = -1;
4636ba2698f1SMatthew G. Knepley   mesh->celltypeState = -1;
46376113b454SMatthew G. Knepley   mesh->printTol      = 1.0e-10;
4638552f7358SJed Brown 
46399566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(dm));
46403ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4641552f7358SJed Brown }
4642552f7358SJed Brown 
4643552f7358SJed Brown /*@
4644a1cb98faSBarry Smith   DMPlexCreate - Creates a `DMPLEX` object, which encapsulates an unstructured mesh, or CW complex, which can be expressed using a Hasse Diagram.
4645552f7358SJed Brown 
4646d083f849SBarry Smith   Collective
4647552f7358SJed Brown 
4648552f7358SJed Brown   Input Parameter:
4649a1cb98faSBarry Smith . comm - The communicator for the `DMPLEX` object
4650552f7358SJed Brown 
4651552f7358SJed Brown   Output Parameter:
4652a1cb98faSBarry Smith . mesh - The `DMPLEX` object
4653552f7358SJed Brown 
4654552f7358SJed Brown   Level: beginner
4655552f7358SJed Brown 
465642747ad1SJacob Faibussowitsch .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMType`, `DMCreate()`, `DMSetType()`
4657552f7358SJed Brown @*/
4658d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreate(MPI_Comm comm, DM *mesh)
4659d71ae5a4SJacob Faibussowitsch {
4660552f7358SJed Brown   PetscFunctionBegin;
46614f572ea9SToby Isaac   PetscAssertPointer(mesh, 2);
46629566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, mesh));
46639566063dSJacob Faibussowitsch   PetscCall(DMSetType(*mesh, DMPLEX));
46643ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4665552f7358SJed Brown }
4666552f7358SJed Brown 
4667b09969d6SVaclav Hapla /*@C
4668a1cb98faSBarry Smith   DMPlexBuildFromCellListParallel - Build distributed `DMPLEX` topology from a list of vertices for each cell (common mesh generator output)
4669a1cb98faSBarry Smith 
467020f4b53cSBarry Smith   Collective; No Fortran Support
4671b09969d6SVaclav Hapla 
4672b09969d6SVaclav Hapla   Input Parameters:
4673a1cb98faSBarry Smith + dm          - The `DM`
4674b09969d6SVaclav Hapla . numCells    - The number of cells owned by this process
4675a1cb98faSBarry Smith . numVertices - The number of vertices to be owned by this process, or `PETSC_DECIDE`
4676a1cb98faSBarry Smith . NVertices   - The global number of vertices, or `PETSC_DETERMINE`
4677b09969d6SVaclav Hapla . numCorners  - The number of vertices for each cell
46785e488331SVaclav Hapla - cells       - An array of numCells*numCorners numbers, the global vertex numbers for each cell
4679b09969d6SVaclav Hapla 
4680be8c289dSNicolas Barral   Output Parameters:
4681a1cb98faSBarry Smith + vertexSF         - (Optional) `PetscSF` describing complete vertex ownership
4682be8c289dSNicolas Barral - verticesAdjSaved - (Optional) vertex adjacency array
4683b09969d6SVaclav Hapla 
4684b09969d6SVaclav Hapla   Level: advanced
4685b09969d6SVaclav Hapla 
4686a1cb98faSBarry Smith   Notes:
4687a1cb98faSBarry Smith   Two triangles sharing a face
4688a1cb98faSBarry Smith .vb
4689a1cb98faSBarry Smith 
4690a1cb98faSBarry Smith         2
4691a1cb98faSBarry Smith       / | \
4692a1cb98faSBarry Smith      /  |  \
4693a1cb98faSBarry Smith     /   |   \
4694a1cb98faSBarry Smith    0  0 | 1  3
4695a1cb98faSBarry Smith     \   |   /
4696a1cb98faSBarry Smith      \  |  /
4697a1cb98faSBarry Smith       \ | /
4698a1cb98faSBarry Smith         1
4699a1cb98faSBarry Smith .ve
4700a1cb98faSBarry Smith   would have input
4701a1cb98faSBarry Smith .vb
4702a1cb98faSBarry Smith   numCells = 2, numVertices = 4
4703a1cb98faSBarry Smith   cells = [0 1 2  1 3 2]
4704a1cb98faSBarry Smith .ve
4705a1cb98faSBarry Smith   which would result in the `DMPLEX`
4706a1cb98faSBarry Smith .vb
4707a1cb98faSBarry Smith 
4708a1cb98faSBarry Smith         4
4709a1cb98faSBarry Smith       / | \
4710a1cb98faSBarry Smith      /  |  \
4711a1cb98faSBarry Smith     /   |   \
4712a1cb98faSBarry Smith    2  0 | 1  5
4713a1cb98faSBarry Smith     \   |   /
4714a1cb98faSBarry Smith      \  |  /
4715a1cb98faSBarry Smith       \ | /
4716a1cb98faSBarry Smith         3
4717a1cb98faSBarry Smith .ve
4718a1cb98faSBarry Smith 
4719a1cb98faSBarry Smith   Vertices are implicitly numbered consecutively 0,...,NVertices.
4720a1cb98faSBarry Smith   Each rank owns a chunk of numVertices consecutive vertices.
4721a1cb98faSBarry Smith   If numVertices is `PETSC_DECIDE`, PETSc will distribute them as evenly as possible using PetscLayout.
4722a1cb98faSBarry Smith   If NVertices is `PETSC_DETERMINE` and numVertices is PETSC_DECIDE, NVertices is computed by PETSc as the maximum vertex index in cells + 1.
4723a1cb98faSBarry Smith   If only NVertices is `PETSC_DETERMINE`, it is computed as the sum of numVertices over all ranks.
4724a1cb98faSBarry Smith 
4725a1cb98faSBarry Smith   The cell distribution is arbitrary non-overlapping, independent of the vertex distribution.
4726a1cb98faSBarry Smith 
47271cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildFromCellList()`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildCoordinatesFromCellListParallel()`,
4728a1cb98faSBarry Smith           `PetscSF`
4729b09969d6SVaclav Hapla @*/
4730d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildFromCellListParallel(DM dm, PetscInt numCells, PetscInt numVertices, PetscInt NVertices, PetscInt numCorners, const PetscInt cells[], PetscSF *vertexSF, PetscInt **verticesAdjSaved)
4731d71ae5a4SJacob Faibussowitsch {
47322464107aSksagiyam   PetscSF     sfPoint;
47332464107aSksagiyam   PetscLayout layout;
473482fb893eSVaclav Hapla   PetscInt    numVerticesAdj, *verticesAdj, *cones, c, p;
4735a47d0d45SMatthew G. Knepley 
4736a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
473725b6865aSVaclav Hapla   PetscValidLogicalCollectiveInt(dm, NVertices, 4);
47389566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
473925b6865aSVaclav Hapla   /* Get/check global number of vertices */
474025b6865aSVaclav Hapla   {
474125b6865aSVaclav Hapla     PetscInt       NVerticesInCells, i;
474225b6865aSVaclav Hapla     const PetscInt len = numCells * numCorners;
474325b6865aSVaclav Hapla 
474425b6865aSVaclav Hapla     /* NVerticesInCells = max(cells) + 1 */
474525b6865aSVaclav Hapla     NVerticesInCells = PETSC_MIN_INT;
47469371c9d4SSatish Balay     for (i = 0; i < len; i++)
47479371c9d4SSatish Balay       if (cells[i] > NVerticesInCells) NVerticesInCells = cells[i];
474825b6865aSVaclav Hapla     ++NVerticesInCells;
4749712fec58SPierre Jolivet     PetscCall(MPIU_Allreduce(MPI_IN_PLACE, &NVerticesInCells, 1, MPIU_INT, MPI_MAX, PetscObjectComm((PetscObject)dm)));
475025b6865aSVaclav Hapla 
475125b6865aSVaclav Hapla     if (numVertices == PETSC_DECIDE && NVertices == PETSC_DECIDE) NVertices = NVerticesInCells;
47529371c9d4SSatish Balay     else
47539371c9d4SSatish 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);
475425b6865aSVaclav Hapla   }
47559079aca8SVaclav Hapla   /* Count locally unique vertices */
47569079aca8SVaclav Hapla   {
47579079aca8SVaclav Hapla     PetscHSetI vhash;
47589079aca8SVaclav Hapla     PetscInt   off = 0;
47599079aca8SVaclav Hapla 
47609566063dSJacob Faibussowitsch     PetscCall(PetscHSetICreate(&vhash));
4761a47d0d45SMatthew G. Knepley     for (c = 0; c < numCells; ++c) {
476248a46eb9SPierre Jolivet       for (p = 0; p < numCorners; ++p) PetscCall(PetscHSetIAdd(vhash, cells[c * numCorners + p]));
4763a47d0d45SMatthew G. Knepley     }
47649566063dSJacob Faibussowitsch     PetscCall(PetscHSetIGetSize(vhash, &numVerticesAdj));
47659566063dSJacob Faibussowitsch     if (!verticesAdjSaved) PetscCall(PetscMalloc1(numVerticesAdj, &verticesAdj));
4766ad540459SPierre Jolivet     else verticesAdj = *verticesAdjSaved;
47679566063dSJacob Faibussowitsch     PetscCall(PetscHSetIGetElems(vhash, &off, verticesAdj));
47689566063dSJacob Faibussowitsch     PetscCall(PetscHSetIDestroy(&vhash));
476963a3b9bcSJacob Faibussowitsch     PetscCheck(off == numVerticesAdj, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid number of local vertices %" PetscInt_FMT " should be %" PetscInt_FMT, off, numVerticesAdj);
4770a47d0d45SMatthew G. Knepley   }
47719566063dSJacob Faibussowitsch   PetscCall(PetscSortInt(numVerticesAdj, verticesAdj));
4772a47d0d45SMatthew G. Knepley   /* Create cones */
47739566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, 0, numCells + numVerticesAdj));
47749566063dSJacob Faibussowitsch   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, numCorners));
47759566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm));
47769566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCones(dm, &cones));
4777a47d0d45SMatthew G. Knepley   for (c = 0; c < numCells; ++c) {
4778a47d0d45SMatthew G. Knepley     for (p = 0; p < numCorners; ++p) {
4779a47d0d45SMatthew G. Knepley       const PetscInt gv = cells[c * numCorners + p];
4780a47d0d45SMatthew G. Knepley       PetscInt       lv;
4781a47d0d45SMatthew G. Knepley 
47829079aca8SVaclav Hapla       /* Positions within verticesAdj form 0-based local vertex numbering;
47839079aca8SVaclav Hapla          we need to shift it by numCells to get correct DAG points (cells go first) */
47849566063dSJacob Faibussowitsch       PetscCall(PetscFindInt(gv, numVerticesAdj, verticesAdj, &lv));
478563a3b9bcSJacob Faibussowitsch       PetscCheck(lv >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Could not find global vertex %" PetscInt_FMT " in local connectivity", gv);
4786961cfab0SVaclav Hapla       cones[c * numCorners + p] = lv + numCells;
4787a47d0d45SMatthew G. Knepley     }
4788a47d0d45SMatthew G. Knepley   }
47892464107aSksagiyam   /* Build point sf */
47909566063dSJacob Faibussowitsch   PetscCall(PetscLayoutCreate(PetscObjectComm((PetscObject)dm), &layout));
47919566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetSize(layout, NVertices));
47929566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetLocalSize(layout, numVertices));
47939566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetBlockSize(layout, 1));
47949566063dSJacob Faibussowitsch   PetscCall(PetscSFCreateByMatchingIndices(layout, numVerticesAdj, verticesAdj, NULL, numCells, numVerticesAdj, verticesAdj, NULL, numCells, vertexSF, &sfPoint));
47959566063dSJacob Faibussowitsch   PetscCall(PetscLayoutDestroy(&layout));
47969566063dSJacob Faibussowitsch   if (!verticesAdjSaved) PetscCall(PetscFree(verticesAdj));
47979566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)sfPoint, "point SF"));
47982464107aSksagiyam   if (dm->sf) {
47992464107aSksagiyam     const char *prefix;
48002464107aSksagiyam 
48019566063dSJacob Faibussowitsch     PetscCall(PetscObjectGetOptionsPrefix((PetscObject)dm->sf, &prefix));
48029566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)sfPoint, prefix));
48032464107aSksagiyam   }
48049566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dm, sfPoint));
48059566063dSJacob Faibussowitsch   PetscCall(PetscSFDestroy(&sfPoint));
48069566063dSJacob Faibussowitsch   if (vertexSF) PetscCall(PetscObjectSetName((PetscObject)(*vertexSF), "Vertex Ownership SF"));
4807a47d0d45SMatthew G. Knepley   /* Fill in the rest of the topology structure */
48089566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
48099566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
48109566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
48113ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4812a47d0d45SMatthew G. Knepley }
4813a47d0d45SMatthew G. Knepley 
4814b09969d6SVaclav Hapla /*@C
4815a1cb98faSBarry Smith   DMPlexBuildCoordinatesFromCellListParallel - Build `DM` coordinates from a list of coordinates for each owned vertex (common mesh generator output)
4816a1cb98faSBarry Smith 
481720f4b53cSBarry Smith   Collective; No Fortran Support
4818b09969d6SVaclav Hapla 
4819b09969d6SVaclav Hapla   Input Parameters:
4820a1cb98faSBarry Smith + dm           - The `DM`
4821b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
4822a1cb98faSBarry Smith . sfVert       - `PetscSF` describing complete vertex ownership
4823b09969d6SVaclav Hapla - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
4824b09969d6SVaclav Hapla 
4825b09969d6SVaclav Hapla   Level: advanced
4826b09969d6SVaclav Hapla 
48271cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildFromCellListParallel()`
4828b09969d6SVaclav Hapla @*/
4829d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildCoordinatesFromCellListParallel(DM dm, PetscInt spaceDim, PetscSF sfVert, const PetscReal vertexCoords[])
4830d71ae5a4SJacob Faibussowitsch {
4831a47d0d45SMatthew G. Knepley   PetscSection coordSection;
4832a47d0d45SMatthew G. Knepley   Vec          coordinates;
4833a47d0d45SMatthew G. Knepley   PetscScalar *coords;
48341edcf0b2SVaclav Hapla   PetscInt     numVertices, numVerticesAdj, coordSize, v, vStart, vEnd;
4835a47d0d45SMatthew G. Knepley 
4836a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
48379566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
48389566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
48391dca8a05SBarry Smith   PetscCheck(vStart >= 0 && vEnd >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "DM is not set up properly. DMPlexBuildFromCellList() should be called first.");
48409566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, spaceDim));
48419566063dSJacob Faibussowitsch   PetscCall(PetscSFGetGraph(sfVert, &numVertices, &numVerticesAdj, NULL, NULL));
48421dca8a05SBarry 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);
48439566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
48449566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
48459566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, spaceDim));
48469566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, vStart, vEnd));
48471edcf0b2SVaclav Hapla   for (v = vStart; v < vEnd; ++v) {
48489566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, spaceDim));
48499566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, spaceDim));
4850a47d0d45SMatthew G. Knepley   }
48519566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
48529566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
48539566063dSJacob Faibussowitsch   PetscCall(VecCreate(PetscObjectComm((PetscObject)dm), &coordinates));
48549566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, spaceDim));
48559566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
48569566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
48579566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
48589566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
4859a47d0d45SMatthew G. Knepley   {
4860a47d0d45SMatthew G. Knepley     MPI_Datatype coordtype;
4861a47d0d45SMatthew G. Knepley 
4862a47d0d45SMatthew G. Knepley     /* Need a temp buffer for coords if we have complex/single */
48639566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_contiguous(spaceDim, MPIU_SCALAR, &coordtype));
48649566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_commit(&coordtype));
486521016a8bSBarry Smith #if defined(PETSC_USE_COMPLEX)
486621016a8bSBarry Smith     {
486721016a8bSBarry Smith       PetscScalar *svertexCoords;
486821016a8bSBarry Smith       PetscInt     i;
48699566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numVertices * spaceDim, &svertexCoords));
48703612f820SVaclav Hapla       for (i = 0; i < numVertices * spaceDim; i++) svertexCoords[i] = vertexCoords[i];
48719566063dSJacob Faibussowitsch       PetscCall(PetscSFBcastBegin(sfVert, coordtype, svertexCoords, coords, MPI_REPLACE));
48729566063dSJacob Faibussowitsch       PetscCall(PetscSFBcastEnd(sfVert, coordtype, svertexCoords, coords, MPI_REPLACE));
48739566063dSJacob Faibussowitsch       PetscCall(PetscFree(svertexCoords));
487421016a8bSBarry Smith     }
487521016a8bSBarry Smith #else
48769566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastBegin(sfVert, coordtype, vertexCoords, coords, MPI_REPLACE));
48779566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastEnd(sfVert, coordtype, vertexCoords, coords, MPI_REPLACE));
487821016a8bSBarry Smith #endif
48799566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_free(&coordtype));
4880a47d0d45SMatthew G. Knepley   }
48819566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
48829566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
48839566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
48849566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
48853ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4886a47d0d45SMatthew G. Knepley }
4887a47d0d45SMatthew G. Knepley 
4888c3edce3dSSatish Balay /*@
4889a1cb98faSBarry Smith   DMPlexCreateFromCellListParallelPetsc - Create distributed `DMPLEX` from a list of vertices for each cell (common mesh generator output)
4890a1cb98faSBarry Smith 
4891a1cb98faSBarry Smith   Collective
4892a47d0d45SMatthew G. Knepley 
4893a47d0d45SMatthew G. Knepley   Input Parameters:
4894a47d0d45SMatthew G. Knepley + comm         - The communicator
4895a47d0d45SMatthew G. Knepley . dim          - The topological dimension of the mesh
4896a47d0d45SMatthew G. Knepley . numCells     - The number of cells owned by this process
4897a1cb98faSBarry Smith . numVertices  - The number of vertices owned by this process, or `PETSC_DECIDE`
4898a1cb98faSBarry Smith . NVertices    - The global number of vertices, or `PETSC_DECIDE`
4899a47d0d45SMatthew G. Knepley . numCorners   - The number of vertices for each cell
4900a47d0d45SMatthew G. Knepley . interpolate  - Flag indicating that intermediate mesh entities (faces, edges) should be created automatically
4901a47d0d45SMatthew G. Knepley . cells        - An array of numCells*numCorners numbers, the global vertex numbers for each cell
4902a47d0d45SMatthew G. Knepley . spaceDim     - The spatial dimension used for coordinates
4903a47d0d45SMatthew G. Knepley - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
4904a47d0d45SMatthew G. Knepley 
4905d8d19677SJose E. Roman   Output Parameters:
4906a1cb98faSBarry Smith + dm          - The `DM`
4907a1cb98faSBarry Smith . vertexSF    - (Optional) `PetscSF` describing complete vertex ownership
490860225df5SJacob Faibussowitsch - verticesAdj - (Optional) vertex adjacency array
4909a47d0d45SMatthew G. Knepley 
4910b09969d6SVaclav Hapla   Level: intermediate
4911a47d0d45SMatthew G. Knepley 
4912a1cb98faSBarry Smith   Notes:
4913a1cb98faSBarry Smith   This function is just a convenient sequence of `DMCreate()`, `DMSetType()`, `DMSetDimension()`,
4914a1cb98faSBarry Smith   `DMPlexBuildFromCellListParallel()`, `DMPlexInterpolate()`, `DMPlexBuildCoordinatesFromCellListParallel()`
4915a1cb98faSBarry Smith 
4916a1cb98faSBarry Smith   See `DMPlexBuildFromCellListParallel()` for an example and details about the topology-related parameters.
4917a1cb98faSBarry Smith 
4918a1cb98faSBarry Smith   See `DMPlexBuildCoordinatesFromCellListParallel()` for details about the geometry-related parameters.
4919a1cb98faSBarry Smith 
49201cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListPetsc()`, `DMPlexBuildFromCellListParallel()`, `DMPlexBuildCoordinatesFromCellListParallel()`, `DMPlexCreateFromDAG()`, `DMPlexCreate()`
4921a47d0d45SMatthew G. Knepley @*/
4922d71ae5a4SJacob 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)
4923d71ae5a4SJacob Faibussowitsch {
4924a47d0d45SMatthew G. Knepley   PetscSF sfVert;
4925a47d0d45SMatthew G. Knepley 
4926a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
49279566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
49289566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
4929a47d0d45SMatthew G. Knepley   PetscValidLogicalCollectiveInt(*dm, dim, 2);
4930064a246eSJacob Faibussowitsch   PetscValidLogicalCollectiveInt(*dm, spaceDim, 9);
49319566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
49329566063dSJacob Faibussowitsch   PetscCall(DMPlexBuildFromCellListParallel(*dm, numCells, numVertices, NVertices, numCorners, cells, &sfVert, verticesAdj));
4933a47d0d45SMatthew G. Knepley   if (interpolate) {
49345fd9971aSMatthew G. Knepley     DM idm;
4935a47d0d45SMatthew G. Knepley 
49369566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
49379566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
4938a47d0d45SMatthew G. Knepley     *dm = idm;
4939a47d0d45SMatthew G. Knepley   }
49409566063dSJacob Faibussowitsch   PetscCall(DMPlexBuildCoordinatesFromCellListParallel(*dm, spaceDim, sfVert, vertexCoords));
494118d54ad4SMichael Lange   if (vertexSF) *vertexSF = sfVert;
49429566063dSJacob Faibussowitsch   else PetscCall(PetscSFDestroy(&sfVert));
49433ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4944a47d0d45SMatthew G. Knepley }
4945a47d0d45SMatthew G. Knepley 
4946b09969d6SVaclav Hapla /*@C
4947a1cb98faSBarry Smith   DMPlexBuildFromCellList - Build `DMPLEX` topology from a list of vertices for each cell (common mesh generator output)
4948a1cb98faSBarry Smith 
494920f4b53cSBarry Smith   Collective; No Fortran Support
49509298eaa6SMatthew G Knepley 
49519298eaa6SMatthew G Knepley   Input Parameters:
4952a1cb98faSBarry Smith + dm          - The `DM`
4953b09969d6SVaclav Hapla . numCells    - The number of cells owned by this process
4954a1cb98faSBarry Smith . numVertices - The number of vertices owned by this process, or `PETSC_DETERMINE`
49559298eaa6SMatthew G Knepley . numCorners  - The number of vertices for each cell
49565e488331SVaclav Hapla - cells       - An array of numCells*numCorners numbers, the global vertex numbers for each cell
49579298eaa6SMatthew G Knepley 
4958b09969d6SVaclav Hapla   Level: advanced
49599298eaa6SMatthew G Knepley 
4960b09969d6SVaclav Hapla   Notes:
4961b09969d6SVaclav Hapla   Two triangles sharing a face
4962a1cb98faSBarry Smith .vb
49639298eaa6SMatthew G Knepley 
4964a1cb98faSBarry Smith         2
4965a1cb98faSBarry Smith       / | \
4966a1cb98faSBarry Smith      /  |  \
4967a1cb98faSBarry Smith     /   |   \
4968a1cb98faSBarry Smith    0  0 | 1  3
4969a1cb98faSBarry Smith     \   |   /
4970a1cb98faSBarry Smith      \  |  /
4971a1cb98faSBarry Smith       \ | /
4972a1cb98faSBarry Smith         1
4973a1cb98faSBarry Smith .ve
4974a1cb98faSBarry Smith   would have input
4975a1cb98faSBarry Smith .vb
4976a1cb98faSBarry Smith   numCells = 2, numVertices = 4
4977a1cb98faSBarry Smith   cells = [0 1 2  1 3 2]
4978a1cb98faSBarry Smith .ve
4979a1cb98faSBarry Smith   which would result in the `DMPLEX`
4980a1cb98faSBarry Smith .vb
4981a1cb98faSBarry Smith 
4982a1cb98faSBarry Smith         4
4983a1cb98faSBarry Smith       / | \
4984a1cb98faSBarry Smith      /  |  \
4985a1cb98faSBarry Smith     /   |   \
4986a1cb98faSBarry Smith    2  0 | 1  5
4987a1cb98faSBarry Smith     \   |   /
4988a1cb98faSBarry Smith      \  |  /
4989a1cb98faSBarry Smith       \ | /
4990a1cb98faSBarry Smith         3
4991a1cb98faSBarry Smith .ve
4992a1cb98faSBarry Smith 
4993a1cb98faSBarry Smith   If numVertices is `PETSC_DETERMINE`, it is computed by PETSc as the maximum vertex index in cells + 1.
499425b6865aSVaclav Hapla 
49951cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildFromCellListParallel()`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromCellListPetsc()`
4996b09969d6SVaclav Hapla @*/
4997d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildFromCellList(DM dm, PetscInt numCells, PetscInt numVertices, PetscInt numCorners, const PetscInt cells[])
4998d71ae5a4SJacob Faibussowitsch {
4999961cfab0SVaclav Hapla   PetscInt *cones, c, p, dim;
5000b09969d6SVaclav Hapla 
5001b09969d6SVaclav Hapla   PetscFunctionBegin;
50029566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
50039566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
500425b6865aSVaclav Hapla   /* Get/check global number of vertices */
500525b6865aSVaclav Hapla   {
500625b6865aSVaclav Hapla     PetscInt       NVerticesInCells, i;
500725b6865aSVaclav Hapla     const PetscInt len = numCells * numCorners;
500825b6865aSVaclav Hapla 
500925b6865aSVaclav Hapla     /* NVerticesInCells = max(cells) + 1 */
501025b6865aSVaclav Hapla     NVerticesInCells = PETSC_MIN_INT;
50119371c9d4SSatish Balay     for (i = 0; i < len; i++)
50129371c9d4SSatish Balay       if (cells[i] > NVerticesInCells) NVerticesInCells = cells[i];
501325b6865aSVaclav Hapla     ++NVerticesInCells;
501425b6865aSVaclav Hapla 
501525b6865aSVaclav Hapla     if (numVertices == PETSC_DECIDE) numVertices = NVerticesInCells;
50169371c9d4SSatish Balay     else
50179371c9d4SSatish 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);
501825b6865aSVaclav Hapla   }
50199566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
502048a46eb9SPierre Jolivet   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, numCorners));
50219566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm));
50229566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCones(dm, &cones));
5023b09969d6SVaclav Hapla   for (c = 0; c < numCells; ++c) {
5024ad540459SPierre Jolivet     for (p = 0; p < numCorners; ++p) cones[c * numCorners + p] = cells[c * numCorners + p] + numCells;
5025b09969d6SVaclav Hapla   }
50269566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
50279566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
50289566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
50293ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5030b09969d6SVaclav Hapla }
5031b09969d6SVaclav Hapla 
5032b09969d6SVaclav Hapla /*@C
5033a1cb98faSBarry Smith   DMPlexBuildCoordinatesFromCellList - Build `DM` coordinates from a list of coordinates for each owned vertex (common mesh generator output)
5034a1cb98faSBarry Smith 
503520f4b53cSBarry Smith   Collective; No Fortran Support
5036b09969d6SVaclav Hapla 
5037b09969d6SVaclav Hapla   Input Parameters:
5038a1cb98faSBarry Smith + dm           - The `DM`
5039b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
5040b09969d6SVaclav Hapla - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
5041b09969d6SVaclav Hapla 
5042b09969d6SVaclav Hapla   Level: advanced
5043b09969d6SVaclav Hapla 
50441cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildCoordinatesFromCellListParallel()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexBuildFromCellList()`
5045b09969d6SVaclav Hapla @*/
5046d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildCoordinatesFromCellList(DM dm, PetscInt spaceDim, const PetscReal vertexCoords[])
5047d71ae5a4SJacob Faibussowitsch {
5048b09969d6SVaclav Hapla   PetscSection coordSection;
5049b09969d6SVaclav Hapla   Vec          coordinates;
5050b09969d6SVaclav Hapla   DM           cdm;
5051b09969d6SVaclav Hapla   PetscScalar *coords;
50521edcf0b2SVaclav Hapla   PetscInt     v, vStart, vEnd, d;
5053b09969d6SVaclav Hapla 
5054b09969d6SVaclav Hapla   PetscFunctionBegin;
50559566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
50569566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
50571dca8a05SBarry Smith   PetscCheck(vStart >= 0 && vEnd >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "DM is not set up properly. DMPlexBuildFromCellList() should be called first.");
50589566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, spaceDim));
50599566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
50609566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
50619566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, spaceDim));
50629566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, vStart, vEnd));
50631edcf0b2SVaclav Hapla   for (v = vStart; v < vEnd; ++v) {
50649566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, spaceDim));
50659566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, spaceDim));
5066b09969d6SVaclav Hapla   }
50679566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
5068b09969d6SVaclav Hapla 
50699566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dm, &cdm));
50709566063dSJacob Faibussowitsch   PetscCall(DMCreateLocalVector(cdm, &coordinates));
50719566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, spaceDim));
50729566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
50739566063dSJacob Faibussowitsch   PetscCall(VecGetArrayWrite(coordinates, &coords));
50741edcf0b2SVaclav Hapla   for (v = 0; v < vEnd - vStart; ++v) {
5075ad540459SPierre Jolivet     for (d = 0; d < spaceDim; ++d) coords[v * spaceDim + d] = vertexCoords[v * spaceDim + d];
5076b09969d6SVaclav Hapla   }
50779566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayWrite(coordinates, &coords));
50789566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
50799566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
50809566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
50813ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5082b09969d6SVaclav Hapla }
5083b09969d6SVaclav Hapla 
5084b09969d6SVaclav Hapla /*@
5085a1cb98faSBarry Smith   DMPlexCreateFromCellListPetsc - Create `DMPLEX` from a list of vertices for each cell (common mesh generator output), but only process 0 takes in the input
50863df08285SMatthew G. Knepley 
5087a1cb98faSBarry Smith   Collective
5088b09969d6SVaclav Hapla 
5089b09969d6SVaclav Hapla   Input Parameters:
5090b09969d6SVaclav Hapla + comm         - The communicator
5091b09969d6SVaclav Hapla . dim          - The topological dimension of the mesh
50923df08285SMatthew G. Knepley . numCells     - The number of cells, only on process 0
5093a1cb98faSBarry Smith . numVertices  - The number of vertices owned by this process, or `PETSC_DECIDE`, only on process 0
50943df08285SMatthew G. Knepley . numCorners   - The number of vertices for each cell, only on process 0
5095b09969d6SVaclav Hapla . interpolate  - Flag indicating that intermediate mesh entities (faces, edges) should be created automatically
50963df08285SMatthew G. Knepley . cells        - An array of numCells*numCorners numbers, the vertices for each cell, only on process 0
5097b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
50983df08285SMatthew G. Knepley - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex, only on process 0
5099b09969d6SVaclav Hapla 
5100b09969d6SVaclav Hapla   Output Parameter:
5101a1cb98faSBarry Smith . dm - The `DM`, which only has points on process 0
510225b6865aSVaclav Hapla 
5103b09969d6SVaclav Hapla   Level: intermediate
5104b09969d6SVaclav Hapla 
5105a1cb98faSBarry Smith   Notes:
5106a1cb98faSBarry Smith   This function is just a convenient sequence of `DMCreate()`, `DMSetType()`, `DMSetDimension()`, `DMPlexBuildFromCellList()`,
5107a1cb98faSBarry Smith   `DMPlexInterpolate()`, `DMPlexBuildCoordinatesFromCellList()`
5108a1cb98faSBarry Smith 
5109a1cb98faSBarry Smith   See `DMPlexBuildFromCellList()` for an example and details about the topology-related parameters.
5110a1cb98faSBarry Smith   See `DMPlexBuildCoordinatesFromCellList()` for details about the geometry-related parameters.
5111a1cb98faSBarry Smith   See `DMPlexCreateFromCellListParallelPetsc()` for parallel input
5112a1cb98faSBarry Smith 
51131cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildFromCellList()`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromDAG()`, `DMPlexCreate()`
51149298eaa6SMatthew G Knepley @*/
5115d71ae5a4SJacob 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)
5116d71ae5a4SJacob Faibussowitsch {
51173df08285SMatthew G. Knepley   PetscMPIInt rank;
51189298eaa6SMatthew G Knepley 
51199298eaa6SMatthew G Knepley   PetscFunctionBegin;
512028b400f6SJacob 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.");
51219566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
51229566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
51239566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
51249566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
5125c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildFromCellList(*dm, numCells, numVertices, numCorners, cells));
51269566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildFromCellList(*dm, 0, 0, 0, NULL));
51279298eaa6SMatthew G Knepley   if (interpolate) {
51285fd9971aSMatthew G. Knepley     DM idm;
51299298eaa6SMatthew G Knepley 
51309566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
51319566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
51329298eaa6SMatthew G Knepley     *dm = idm;
51339298eaa6SMatthew G Knepley   }
5134c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildCoordinatesFromCellList(*dm, spaceDim, vertexCoords));
51359566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildCoordinatesFromCellList(*dm, spaceDim, NULL));
51363ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
51379298eaa6SMatthew G Knepley }
51389298eaa6SMatthew G Knepley 
5139939f6067SMatthew G. Knepley /*@
514020f4b53cSBarry Smith   DMPlexCreateFromDAG - This takes as input the adjacency-list representation of the Directed Acyclic Graph (Hasse Diagram) encoding a mesh, and produces a `DM`
5141939f6067SMatthew G. Knepley 
5142939f6067SMatthew G. Knepley   Input Parameters:
514320f4b53cSBarry Smith + dm               - The empty `DM` object, usually from `DMCreate()` and `DMSetDimension()`
5144939f6067SMatthew G. Knepley . depth            - The depth of the DAG
514520f4b53cSBarry Smith . numPoints        - Array of size depth + 1 containing the number of points at each `depth`
5146939f6067SMatthew G. Knepley . coneSize         - The cone size of each point
5147939f6067SMatthew G. Knepley . cones            - The concatenation of the cone points for each point, the cone list must be oriented correctly for each point
5148939f6067SMatthew G. Knepley . coneOrientations - The orientation of each cone point
514920f4b53cSBarry Smith - vertexCoords     - An array of `numPoints`[0]*spacedim numbers representing the coordinates of each vertex, with spacedim the value set via `DMSetCoordinateDim()`
5150939f6067SMatthew G. Knepley 
5151939f6067SMatthew G. Knepley   Output Parameter:
515220f4b53cSBarry Smith . dm - The `DM`
515320f4b53cSBarry Smith 
515420f4b53cSBarry Smith   Level: advanced
5155939f6067SMatthew G. Knepley 
5156a1cb98faSBarry Smith   Note:
5157a1cb98faSBarry Smith   Two triangles sharing a face would have input
5158a1cb98faSBarry Smith .vb
5159a1cb98faSBarry Smith   depth = 1, numPoints = [4 2], coneSize = [3 3 0 0 0 0]
5160a1cb98faSBarry Smith   cones = [2 3 4  3 5 4], coneOrientations = [0 0 0  0 0 0]
5161a1cb98faSBarry Smith  vertexCoords = [-1.0 0.0  0.0 -1.0  0.0 1.0  1.0 0.0]
5162a1cb98faSBarry Smith .ve
5163939f6067SMatthew G. Knepley   which would result in the DMPlex
5164a1cb98faSBarry Smith .vb
5165a1cb98faSBarry Smith         4
5166a1cb98faSBarry Smith       / | \
5167a1cb98faSBarry Smith      /  |  \
5168a1cb98faSBarry Smith     /   |   \
5169a1cb98faSBarry Smith    2  0 | 1  5
5170a1cb98faSBarry Smith     \   |   /
5171a1cb98faSBarry Smith      \  |  /
5172a1cb98faSBarry Smith       \ | /
5173a1cb98faSBarry Smith         3
5174a1cb98faSBarry Smith .ve
5175a1cb98faSBarry Smith   Notice that all points are numbered consecutively, unlike `DMPlexCreateFromCellListPetsc()`
5176939f6067SMatthew G. Knepley 
51771cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`
5178939f6067SMatthew G. Knepley @*/
5179d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateFromDAG(DM dm, PetscInt depth, const PetscInt numPoints[], const PetscInt coneSize[], const PetscInt cones[], const PetscInt coneOrientations[], const PetscScalar vertexCoords[])
5180d71ae5a4SJacob Faibussowitsch {
51819298eaa6SMatthew G Knepley   Vec          coordinates;
51829298eaa6SMatthew G Knepley   PetscSection coordSection;
51839298eaa6SMatthew G Knepley   PetscScalar *coords;
5184811e8653SToby Isaac   PetscInt     coordSize, firstVertex = -1, pStart = 0, pEnd = 0, p, v, dim, dimEmbed, d, off;
51859298eaa6SMatthew G Knepley 
51869298eaa6SMatthew G Knepley   PetscFunctionBegin;
51879566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
51889566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &dimEmbed));
518963a3b9bcSJacob Faibussowitsch   PetscCheck(dimEmbed >= dim, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Embedding dimension %" PetscInt_FMT " cannot be less than intrinsic dimension %" PetscInt_FMT, dimEmbed, dim);
51909298eaa6SMatthew G Knepley   for (d = 0; d <= depth; ++d) pEnd += numPoints[d];
51919566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, pStart, pEnd));
51929298eaa6SMatthew G Knepley   for (p = pStart; p < pEnd; ++p) {
51939566063dSJacob Faibussowitsch     PetscCall(DMPlexSetConeSize(dm, p, coneSize[p - pStart]));
5194ad540459SPierre Jolivet     if (firstVertex < 0 && !coneSize[p - pStart]) firstVertex = p - pStart;
519597e052ccSToby Isaac   }
51961dca8a05SBarry Smith   PetscCheck(firstVertex >= 0 || !numPoints[0], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Expected %" PetscInt_FMT " vertices but could not find any", numPoints[0]);
51979566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm)); /* Allocate space for cones */
51989298eaa6SMatthew G Knepley   for (p = pStart, off = 0; p < pEnd; off += coneSize[p - pStart], ++p) {
51999566063dSJacob Faibussowitsch     PetscCall(DMPlexSetCone(dm, p, &cones[off]));
52009566063dSJacob Faibussowitsch     PetscCall(DMPlexSetConeOrientation(dm, p, &coneOrientations[off]));
52019298eaa6SMatthew G Knepley   }
52029566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
52039566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
52049298eaa6SMatthew G Knepley   /* Build coordinates */
52059566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
52069566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
52079566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dimEmbed));
52089566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numPoints[0]));
52099298eaa6SMatthew G Knepley   for (v = firstVertex; v < firstVertex + numPoints[0]; ++v) {
52109566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, dimEmbed));
52119566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dimEmbed));
52129298eaa6SMatthew G Knepley   }
52139566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
52149566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
52159566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
52169566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
52179566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
52189566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, dimEmbed));
52199566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
52209318fe57SMatthew G. Knepley   if (vertexCoords) {
52219566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
52229298eaa6SMatthew G Knepley     for (v = 0; v < numPoints[0]; ++v) {
52239298eaa6SMatthew G Knepley       PetscInt off;
52249298eaa6SMatthew G Knepley 
52259566063dSJacob Faibussowitsch       PetscCall(PetscSectionGetOffset(coordSection, v + firstVertex, &off));
5226ad540459SPierre Jolivet       for (d = 0; d < dimEmbed; ++d) coords[off + d] = vertexCoords[v * dimEmbed + d];
52279298eaa6SMatthew G Knepley     }
52289318fe57SMatthew G. Knepley   }
52299566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
52309566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
52319566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
52323ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
52339298eaa6SMatthew G Knepley }
52348415267dSToby Isaac 
5235a4e35b19SJacob Faibussowitsch /*
5236a1cb98faSBarry Smith   DMPlexCreateCellVertexFromFile - Create a `DMPLEX` mesh from a simple cell-vertex file.
5237a1cb98faSBarry Smith 
5238a1cb98faSBarry Smith   Collective
52398ca92349SMatthew G. Knepley 
52408ca92349SMatthew G. Knepley + comm        - The MPI communicator
52418ca92349SMatthew G. Knepley . filename    - Name of the .dat file
52428ca92349SMatthew G. Knepley - interpolate - Create faces and edges in the mesh
52438ca92349SMatthew G. Knepley 
52448ca92349SMatthew G. Knepley   Output Parameter:
5245a1cb98faSBarry Smith . dm  - The `DM` object representing the mesh
52468ca92349SMatthew G. Knepley 
52478ca92349SMatthew G. Knepley   Level: beginner
52488ca92349SMatthew G. Knepley 
5249a1cb98faSBarry Smith   Note:
5250a1cb98faSBarry Smith   The format is the simplest possible:
5251a1cb98faSBarry Smith .vb
5252a1cb98faSBarry Smith   Ne
5253a1cb98faSBarry Smith   v0 v1 ... vk
5254a1cb98faSBarry Smith   Nv
5255a1cb98faSBarry Smith   x y z marker
5256a1cb98faSBarry Smith .ve
5257a1cb98faSBarry Smith 
5258a1cb98faSBarry Smith   Developer Note:
5259a1cb98faSBarry Smith   Should use a `PetscViewer` not a filename
5260a1cb98faSBarry Smith 
52611cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromFile()`, `DMPlexCreateMedFromFile()`, `DMPlexCreateGmsh()`, `DMPlexCreate()`
5262a4e35b19SJacob Faibussowitsch */
5263ff6a9541SJacob Faibussowitsch static PetscErrorCode DMPlexCreateCellVertexFromFile(MPI_Comm comm, const char filename[], PetscBool interpolate, DM *dm)
5264d71ae5a4SJacob Faibussowitsch {
52658ca92349SMatthew G. Knepley   DMLabel      marker;
52668ca92349SMatthew G. Knepley   PetscViewer  viewer;
52678ca92349SMatthew G. Knepley   Vec          coordinates;
52688ca92349SMatthew G. Knepley   PetscSection coordSection;
52698ca92349SMatthew G. Knepley   PetscScalar *coords;
52708ca92349SMatthew G. Knepley   char         line[PETSC_MAX_PATH_LEN];
52718ca92349SMatthew G. Knepley   PetscInt     dim = 3, cdim = 3, coordSize, v, c, d;
52728ca92349SMatthew G. Knepley   PetscMPIInt  rank;
5273f8d5e320SMatthew G. Knepley   int          snum, Nv, Nc, Ncn, Nl;
52748ca92349SMatthew G. Knepley 
52758ca92349SMatthew G. Knepley   PetscFunctionBegin;
52769566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
52779566063dSJacob Faibussowitsch   PetscCall(PetscViewerCreate(comm, &viewer));
52789566063dSJacob Faibussowitsch   PetscCall(PetscViewerSetType(viewer, PETSCVIEWERASCII));
52799566063dSJacob Faibussowitsch   PetscCall(PetscViewerFileSetMode(viewer, FILE_MODE_READ));
52809566063dSJacob Faibussowitsch   PetscCall(PetscViewerFileSetName(viewer, filename));
5281dd400576SPatrick Sanan   if (rank == 0) {
52829566063dSJacob Faibussowitsch     PetscCall(PetscViewerRead(viewer, line, 4, NULL, PETSC_STRING));
5283f8d5e320SMatthew G. Knepley     snum = sscanf(line, "%d %d %d %d", &Nc, &Nv, &Ncn, &Nl);
528408401ef6SPierre Jolivet     PetscCheck(snum == 4, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
528525ce1634SJed Brown   } else {
5286f8d5e320SMatthew G. Knepley     Nc = Nv = Ncn = Nl = 0;
52878ca92349SMatthew G. Knepley   }
52889566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
52899566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
52909566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(*dm, 0, Nc + Nv));
52919566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
52929566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(*dm, cdim));
52938ca92349SMatthew G. Knepley   /* Read topology */
5294dd400576SPatrick Sanan   if (rank == 0) {
5295f8d5e320SMatthew G. Knepley     char     format[PETSC_MAX_PATH_LEN];
5296f8d5e320SMatthew G. Knepley     PetscInt cone[8];
52978ca92349SMatthew G. Knepley     int      vbuf[8], v;
52988ca92349SMatthew G. Knepley 
52999371c9d4SSatish Balay     for (c = 0; c < Ncn; ++c) {
53009371c9d4SSatish Balay       format[c * 3 + 0] = '%';
53019371c9d4SSatish Balay       format[c * 3 + 1] = 'd';
53029371c9d4SSatish Balay       format[c * 3 + 2] = ' ';
53039371c9d4SSatish Balay     }
5304f8d5e320SMatthew G. Knepley     format[Ncn * 3 - 1] = '\0';
53059566063dSJacob Faibussowitsch     for (c = 0; c < Nc; ++c) PetscCall(DMPlexSetConeSize(*dm, c, Ncn));
53069566063dSJacob Faibussowitsch     PetscCall(DMSetUp(*dm));
53078ca92349SMatthew G. Knepley     for (c = 0; c < Nc; ++c) {
53089566063dSJacob Faibussowitsch       PetscCall(PetscViewerRead(viewer, line, Ncn, NULL, PETSC_STRING));
5309f8d5e320SMatthew G. Knepley       switch (Ncn) {
5310d71ae5a4SJacob Faibussowitsch       case 2:
5311d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1]);
5312d71ae5a4SJacob Faibussowitsch         break;
5313d71ae5a4SJacob Faibussowitsch       case 3:
5314d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2]);
5315d71ae5a4SJacob Faibussowitsch         break;
5316d71ae5a4SJacob Faibussowitsch       case 4:
5317d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3]);
5318d71ae5a4SJacob Faibussowitsch         break;
5319d71ae5a4SJacob Faibussowitsch       case 6:
5320d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3], &vbuf[4], &vbuf[5]);
5321d71ae5a4SJacob Faibussowitsch         break;
5322d71ae5a4SJacob Faibussowitsch       case 8:
5323d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3], &vbuf[4], &vbuf[5], &vbuf[6], &vbuf[7]);
5324d71ae5a4SJacob Faibussowitsch         break;
5325d71ae5a4SJacob Faibussowitsch       default:
5326d71ae5a4SJacob Faibussowitsch         SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "No cell shape with %d vertices", Ncn);
5327f8d5e320SMatthew G. Knepley       }
532808401ef6SPierre Jolivet       PetscCheck(snum == Ncn, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
5329f8d5e320SMatthew G. Knepley       for (v = 0; v < Ncn; ++v) cone[v] = vbuf[v] + Nc;
53308ca92349SMatthew G. Knepley       /* Hexahedra are inverted */
5331f8d5e320SMatthew G. Knepley       if (Ncn == 8) {
53328ca92349SMatthew G. Knepley         PetscInt tmp = cone[1];
53338ca92349SMatthew G. Knepley         cone[1]      = cone[3];
53348ca92349SMatthew G. Knepley         cone[3]      = tmp;
53358ca92349SMatthew G. Knepley       }
53369566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCone(*dm, c, cone));
53378ca92349SMatthew G. Knepley     }
53388ca92349SMatthew G. Knepley   }
53399566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(*dm));
53409566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(*dm));
53418ca92349SMatthew G. Knepley   /* Read coordinates */
53429566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(*dm, &coordSection));
53439566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
53449566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, cdim));
53459566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, Nc, Nc + Nv));
53468ca92349SMatthew G. Knepley   for (v = Nc; v < Nc + Nv; ++v) {
53479566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, cdim));
53489566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, cdim));
53498ca92349SMatthew G. Knepley   }
53509566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
53519566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
53529566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
53539566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
53549566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
53559566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, cdim));
53569566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
53579566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
5358dd400576SPatrick Sanan   if (rank == 0) {
5359f8d5e320SMatthew G. Knepley     char   format[PETSC_MAX_PATH_LEN];
53608ca92349SMatthew G. Knepley     double x[3];
5361f8d5e320SMatthew G. Knepley     int    l, val[3];
53628ca92349SMatthew G. Knepley 
5363f8d5e320SMatthew G. Knepley     if (Nl) {
53649371c9d4SSatish Balay       for (l = 0; l < Nl; ++l) {
53659371c9d4SSatish Balay         format[l * 3 + 0] = '%';
53669371c9d4SSatish Balay         format[l * 3 + 1] = 'd';
53679371c9d4SSatish Balay         format[l * 3 + 2] = ' ';
53689371c9d4SSatish Balay       }
5369f8d5e320SMatthew G. Knepley       format[Nl * 3 - 1] = '\0';
53709566063dSJacob Faibussowitsch       PetscCall(DMCreateLabel(*dm, "marker"));
53719566063dSJacob Faibussowitsch       PetscCall(DMGetLabel(*dm, "marker", &marker));
5372f8d5e320SMatthew G. Knepley     }
53738ca92349SMatthew G. Knepley     for (v = 0; v < Nv; ++v) {
53749566063dSJacob Faibussowitsch       PetscCall(PetscViewerRead(viewer, line, 3 + Nl, NULL, PETSC_STRING));
5375f8d5e320SMatthew G. Knepley       snum = sscanf(line, "%lg %lg %lg", &x[0], &x[1], &x[2]);
537608401ef6SPierre Jolivet       PetscCheck(snum == 3, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
5377f8d5e320SMatthew G. Knepley       switch (Nl) {
5378d71ae5a4SJacob Faibussowitsch       case 0:
5379d71ae5a4SJacob Faibussowitsch         snum = 0;
5380d71ae5a4SJacob Faibussowitsch         break;
5381d71ae5a4SJacob Faibussowitsch       case 1:
5382d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0]);
5383d71ae5a4SJacob Faibussowitsch         break;
5384d71ae5a4SJacob Faibussowitsch       case 2:
5385d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0], &val[1]);
5386d71ae5a4SJacob Faibussowitsch         break;
5387d71ae5a4SJacob Faibussowitsch       case 3:
5388d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0], &val[1], &val[2]);
5389d71ae5a4SJacob Faibussowitsch         break;
5390d71ae5a4SJacob Faibussowitsch       default:
5391d71ae5a4SJacob Faibussowitsch         SETERRQ(PETSC_COMM_SELF, PETSC_ERR_SUP, "Request support for %d labels", Nl);
5392f8d5e320SMatthew G. Knepley       }
539308401ef6SPierre Jolivet       PetscCheck(snum == Nl, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
53948ca92349SMatthew G. Knepley       for (d = 0; d < cdim; ++d) coords[v * cdim + d] = x[d];
53959566063dSJacob Faibussowitsch       for (l = 0; l < Nl; ++l) PetscCall(DMLabelSetValue(marker, v + Nc, val[l]));
53968ca92349SMatthew G. Knepley     }
53978ca92349SMatthew G. Knepley   }
53989566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
53999566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(*dm, coordinates));
54009566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
54019566063dSJacob Faibussowitsch   PetscCall(PetscViewerDestroy(&viewer));
54028ca92349SMatthew G. Knepley   if (interpolate) {
54038ca92349SMatthew G. Knepley     DM      idm;
54048ca92349SMatthew G. Knepley     DMLabel bdlabel;
54058ca92349SMatthew G. Knepley 
54069566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
54079566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
54088ca92349SMatthew G. Knepley     *dm = idm;
54098ca92349SMatthew G. Knepley 
5410f8d5e320SMatthew G. Knepley     if (!Nl) {
54119566063dSJacob Faibussowitsch       PetscCall(DMCreateLabel(*dm, "marker"));
54129566063dSJacob Faibussowitsch       PetscCall(DMGetLabel(*dm, "marker", &bdlabel));
54139566063dSJacob Faibussowitsch       PetscCall(DMPlexMarkBoundaryFaces(*dm, PETSC_DETERMINE, bdlabel));
54149566063dSJacob Faibussowitsch       PetscCall(DMPlexLabelComplete(*dm, bdlabel));
54158ca92349SMatthew G. Knepley     }
5416f8d5e320SMatthew G. Knepley   }
54173ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
54188ca92349SMatthew G. Knepley }
54198ca92349SMatthew G. Knepley 
54208ca92349SMatthew G. Knepley /*@C
5421a1cb98faSBarry Smith   DMPlexCreateFromFile - This takes a filename and produces a `DM`
5422a1cb98faSBarry Smith 
5423a1cb98faSBarry Smith   Collective
5424ca522641SMatthew G. Knepley 
5425ca522641SMatthew G. Knepley   Input Parameters:
5426ca522641SMatthew G. Knepley + comm        - The communicator
5427ca522641SMatthew G. Knepley . filename    - A file name
5428a1cb98faSBarry Smith . plexname    - The object name of the resulting `DM`, also used for intra-datafile lookup by some formats
5429ca522641SMatthew G. Knepley - interpolate - Flag to create intermediate mesh pieces (edges, faces)
5430ca522641SMatthew G. Knepley 
5431ca522641SMatthew G. Knepley   Output Parameter:
5432a1cb98faSBarry Smith . dm - The `DM`
5433ca522641SMatthew G. Knepley 
5434a1cb98faSBarry Smith   Options Database Key:
5435a1cb98faSBarry Smith . -dm_plex_create_from_hdf5_xdmf - use the `PETSC_VIEWER_HDF5_XDMF` format for reading HDF5
543602ef0d99SVaclav Hapla 
543737fdd005SBarry Smith   Use `-dm_plex_create_ prefix` to pass options to the internal `PetscViewer`, e.g.
5438bca97951SVaclav Hapla $ -dm_plex_create_viewer_hdf5_collective
5439bca97951SVaclav Hapla 
5440ca522641SMatthew G. Knepley   Level: beginner
5441ca522641SMatthew G. Knepley 
5442a1cb98faSBarry Smith   Notes:
5443a1cb98faSBarry Smith   Using `PETSCVIEWERHDF5` type with `PETSC_VIEWER_HDF5_PETSC` format, one can save multiple `DMPLEX`
5444a1cb98faSBarry Smith   meshes in a single HDF5 file. This in turn requires one to name the `DMPLEX` object with `PetscObjectSetName()`
5445a1cb98faSBarry Smith   before saving it with `DMView()` and before loading it with `DMLoad()` for identification of the mesh object.
5446a1cb98faSBarry Smith   The input parameter name is thus used to name the `DMPLEX` object when `DMPlexCreateFromFile()` internally
5447a1cb98faSBarry Smith   calls `DMLoad()`. Currently, name is ignored for other viewer types and/or formats.
5448a1cb98faSBarry Smith 
54491cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromDAG()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`, `PetscObjectSetName()`, `DMView()`, `DMLoad()`
5450ca522641SMatthew G. Knepley @*/
5451d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateFromFile(MPI_Comm comm, const char filename[], const char plexname[], PetscBool interpolate, DM *dm)
5452d71ae5a4SJacob Faibussowitsch {
5453ef3a5affSJacob Faibussowitsch   const char  extGmsh[]      = ".msh";
5454ef3a5affSJacob Faibussowitsch   const char  extGmsh2[]     = ".msh2";
5455ef3a5affSJacob Faibussowitsch   const char  extGmsh4[]     = ".msh4";
5456ef3a5affSJacob Faibussowitsch   const char  extCGNS[]      = ".cgns";
5457ef3a5affSJacob Faibussowitsch   const char  extExodus[]    = ".exo";
5458ef3a5affSJacob Faibussowitsch   const char  extExodus_e[]  = ".e";
5459ef3a5affSJacob Faibussowitsch   const char  extGenesis[]   = ".gen";
5460ef3a5affSJacob Faibussowitsch   const char  extFluent[]    = ".cas";
5461ef3a5affSJacob Faibussowitsch   const char  extHDF5[]      = ".h5";
54626f2c871aSStefano Zampini   const char  extXDMFHDF5[]  = ".xdmf.h5";
5463ef3a5affSJacob Faibussowitsch   const char  extMed[]       = ".med";
5464ef3a5affSJacob Faibussowitsch   const char  extPLY[]       = ".ply";
5465ef3a5affSJacob Faibussowitsch   const char  extEGADSLite[] = ".egadslite";
5466ef3a5affSJacob Faibussowitsch   const char  extEGADS[]     = ".egads";
5467ef3a5affSJacob Faibussowitsch   const char  extIGES[]      = ".igs";
5468ef3a5affSJacob Faibussowitsch   const char  extSTEP[]      = ".stp";
5469ef3a5affSJacob Faibussowitsch   const char  extCV[]        = ".dat";
5470ca522641SMatthew G. Knepley   size_t      len;
54716f2c871aSStefano Zampini   PetscBool   isGmsh, isGmsh2, isGmsh4, isCGNS, isExodus, isGenesis, isFluent, isHDF5, isMed, isPLY, isEGADSLite, isEGADS, isIGES, isSTEP, isCV, isXDMFHDF5;
5472ca522641SMatthew G. Knepley   PetscMPIInt rank;
5473ca522641SMatthew G. Knepley 
5474ca522641SMatthew G. Knepley   PetscFunctionBegin;
54754f572ea9SToby Isaac   PetscAssertPointer(filename, 2);
54764f572ea9SToby Isaac   if (plexname) PetscAssertPointer(plexname, 3);
54774f572ea9SToby Isaac   PetscAssertPointer(dm, 5);
54789566063dSJacob Faibussowitsch   PetscCall(DMInitializePackage());
54799566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_CreateFromFile, 0, 0, 0, 0));
54809566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
54819566063dSJacob Faibussowitsch   PetscCall(PetscStrlen(filename, &len));
548228b400f6SJacob Faibussowitsch   PetscCheck(len, comm, PETSC_ERR_ARG_WRONG, "Filename must be a valid path");
5483ef3a5affSJacob Faibussowitsch 
54849371c9d4SSatish Balay #define CheckExtension(extension__, is_extension__) \
54859371c9d4SSatish Balay   do { \
5486274aaeaaSJacob Faibussowitsch     PetscAssert(sizeof(extension__), comm, PETSC_ERR_PLIB, "Zero-size extension: %s", extension__); \
5487274aaeaaSJacob Faibussowitsch     /* don't count the null-terminator at the end */ \
5488274aaeaaSJacob Faibussowitsch     const size_t ext_len = sizeof(extension__) - 1; \
5489274aaeaaSJacob Faibussowitsch     if (len < ext_len) { \
5490ef3a5affSJacob Faibussowitsch       is_extension__ = PETSC_FALSE; \
5491ef3a5affSJacob Faibussowitsch     } else { \
5492274aaeaaSJacob Faibussowitsch       PetscCall(PetscStrncmp(filename + len - ext_len, extension__, ext_len, &is_extension__)); \
5493ef3a5affSJacob Faibussowitsch     } \
5494ef3a5affSJacob Faibussowitsch   } while (0)
5495ef3a5affSJacob Faibussowitsch 
5496ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh, isGmsh);
5497ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh2, isGmsh2);
5498ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh4, isGmsh4);
5499ef3a5affSJacob Faibussowitsch   CheckExtension(extCGNS, isCGNS);
5500ef3a5affSJacob Faibussowitsch   CheckExtension(extExodus, isExodus);
5501ef3a5affSJacob Faibussowitsch   if (!isExodus) CheckExtension(extExodus_e, isExodus);
5502ef3a5affSJacob Faibussowitsch   CheckExtension(extGenesis, isGenesis);
5503ef3a5affSJacob Faibussowitsch   CheckExtension(extFluent, isFluent);
5504ef3a5affSJacob Faibussowitsch   CheckExtension(extHDF5, isHDF5);
5505ef3a5affSJacob Faibussowitsch   CheckExtension(extMed, isMed);
5506ef3a5affSJacob Faibussowitsch   CheckExtension(extPLY, isPLY);
5507ef3a5affSJacob Faibussowitsch   CheckExtension(extEGADSLite, isEGADSLite);
5508ef3a5affSJacob Faibussowitsch   CheckExtension(extEGADS, isEGADS);
5509ef3a5affSJacob Faibussowitsch   CheckExtension(extIGES, isIGES);
5510ef3a5affSJacob Faibussowitsch   CheckExtension(extSTEP, isSTEP);
5511ef3a5affSJacob Faibussowitsch   CheckExtension(extCV, isCV);
55126f2c871aSStefano Zampini   CheckExtension(extXDMFHDF5, isXDMFHDF5);
5513ef3a5affSJacob Faibussowitsch 
5514ef3a5affSJacob Faibussowitsch #undef CheckExtension
5515ef3a5affSJacob Faibussowitsch 
5516de78e4feSLisandro Dalcin   if (isGmsh || isGmsh2 || isGmsh4) {
55179566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateGmshFromFile(comm, filename, interpolate, dm));
5518ca522641SMatthew G. Knepley   } else if (isCGNS) {
55199566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateCGNSFromFile(comm, filename, interpolate, dm));
552090c68965SMatthew G. Knepley   } else if (isExodus || isGenesis) {
55219566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateExodusFromFile(comm, filename, interpolate, dm));
55222f0bd6dcSMichael Lange   } else if (isFluent) {
55239566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFluentFromFile(comm, filename, interpolate, dm));
5524cc2f8f65SMatthew G. Knepley   } else if (isHDF5) {
5525cc2f8f65SMatthew G. Knepley     PetscViewer viewer;
5526cc2f8f65SMatthew G. Knepley 
552743b242b4SVaclav 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 */
55286f2c871aSStefano Zampini     PetscCall(PetscOptionsGetBool(NULL, NULL, "-dm_plex_create_from_hdf5_xdmf", &isXDMFHDF5, NULL));
55299566063dSJacob Faibussowitsch     PetscCall(PetscViewerCreate(comm, &viewer));
55309566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetType(viewer, PETSCVIEWERHDF5));
55319566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetOptionsPrefix(viewer, "dm_plex_create_"));
55329566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetFromOptions(viewer));
55339566063dSJacob Faibussowitsch     PetscCall(PetscViewerFileSetMode(viewer, FILE_MODE_READ));
55349566063dSJacob Faibussowitsch     PetscCall(PetscViewerFileSetName(viewer, filename));
5535cd7e8a5eSksagiyam 
55369566063dSJacob Faibussowitsch     PetscCall(DMCreate(comm, dm));
55379566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)(*dm), plexname));
55389566063dSJacob Faibussowitsch     PetscCall(DMSetType(*dm, DMPLEX));
55396f2c871aSStefano Zampini     if (isXDMFHDF5) PetscCall(PetscViewerPushFormat(viewer, PETSC_VIEWER_HDF5_XDMF));
55409566063dSJacob Faibussowitsch     PetscCall(DMLoad(*dm, viewer));
55416f2c871aSStefano Zampini     if (isXDMFHDF5) PetscCall(PetscViewerPopFormat(viewer));
55429566063dSJacob Faibussowitsch     PetscCall(PetscViewerDestroy(&viewer));
55435fd9971aSMatthew G. Knepley 
55445fd9971aSMatthew G. Knepley     if (interpolate) {
55455fd9971aSMatthew G. Knepley       DM idm;
55465fd9971aSMatthew G. Knepley 
55479566063dSJacob Faibussowitsch       PetscCall(DMPlexInterpolate(*dm, &idm));
55489566063dSJacob Faibussowitsch       PetscCall(DMDestroy(dm));
55495fd9971aSMatthew G. Knepley       *dm = idm;
55505fd9971aSMatthew G. Knepley     }
5551707dd687SMichael Lange   } else if (isMed) {
55529566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateMedFromFile(comm, filename, interpolate, dm));
5553f2801cd6SMatthew G. Knepley   } else if (isPLY) {
55549566063dSJacob Faibussowitsch     PetscCall(DMPlexCreatePLYFromFile(comm, filename, interpolate, dm));
5555c1cad2e7SMatthew G. Knepley   } else if (isEGADSLite || isEGADS || isIGES || isSTEP) {
55569566063dSJacob Faibussowitsch     if (isEGADSLite) PetscCall(DMPlexCreateEGADSLiteFromFile(comm, filename, dm));
55579566063dSJacob Faibussowitsch     else PetscCall(DMPlexCreateEGADSFromFile(comm, filename, dm));
55587bee2925SMatthew Knepley     if (!interpolate) {
55597bee2925SMatthew Knepley       DM udm;
55607bee2925SMatthew Knepley 
55619566063dSJacob Faibussowitsch       PetscCall(DMPlexUninterpolate(*dm, &udm));
55629566063dSJacob Faibussowitsch       PetscCall(DMDestroy(dm));
55637bee2925SMatthew Knepley       *dm = udm;
55647bee2925SMatthew Knepley     }
55658ca92349SMatthew G. Knepley   } else if (isCV) {
55669566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateCellVertexFromFile(comm, filename, interpolate, dm));
556798921bdaSJacob Faibussowitsch   } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Cannot load file %s: unrecognized extension", filename);
55689566063dSJacob Faibussowitsch   PetscCall(PetscStrlen(plexname, &len));
55699566063dSJacob Faibussowitsch   if (len) PetscCall(PetscObjectSetName((PetscObject)(*dm), plexname));
55709566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_CreateFromFile, 0, 0, 0, 0));
55713ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5572ca522641SMatthew G. Knepley }
557312b8a6daSStefano Zampini 
55749f6c5813SMatthew G. Knepley /*@C
55759f6c5813SMatthew 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.
55769f6c5813SMatthew G. Knepley 
55770528010dSStefano Zampini   Input Parameters:
55780528010dSStefano Zampini + tr     - The `DMPlexTransform`
55790528010dSStefano Zampini - prefix - An options prefix, or NULL
55809f6c5813SMatthew G. Knepley 
55819f6c5813SMatthew G. Knepley   Output Parameter:
55829f6c5813SMatthew G. Knepley . dm - The `DM`
55839f6c5813SMatthew G. Knepley 
55849f6c5813SMatthew G. Knepley   Level: beginner
55859f6c5813SMatthew G. Knepley 
558620f4b53cSBarry Smith   Notes:
558720f4b53cSBarry 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.
558820f4b53cSBarry Smith 
55899f6c5813SMatthew G. Knepley .seealso: `DMPlexCreateFromFile`, `DMPlexCreateFromDAG()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`
55909f6c5813SMatthew G. Knepley @*/
55910528010dSStefano Zampini PetscErrorCode DMPlexCreateEphemeral(DMPlexTransform tr, const char prefix[], DM *dm)
55929f6c5813SMatthew G. Knepley {
55930528010dSStefano Zampini   DM           bdm, bcdm, cdm;
55940528010dSStefano Zampini   Vec          coordinates, coordinatesNew;
55950528010dSStefano Zampini   PetscSection cs;
55960528010dSStefano Zampini   PetscInt     dim, cdim, Nl;
55979f6c5813SMatthew G. Knepley 
55989f6c5813SMatthew G. Knepley   PetscFunctionBegin;
55999f6c5813SMatthew G. Knepley   PetscCall(DMCreate(PetscObjectComm((PetscObject)tr), dm));
56009f6c5813SMatthew G. Knepley   PetscCall(DMSetType(*dm, DMPLEX));
56010528010dSStefano Zampini   ((DM_Plex *)(*dm)->data)->interpolated = DMPLEX_INTERPOLATED_FULL;
56020528010dSStefano Zampini   // Handle coordinates
56030528010dSStefano Zampini   PetscCall(DMPlexTransformGetDM(tr, &bdm));
56040528010dSStefano Zampini   PetscCall(DMGetCoordinateDim(bdm, &cdim));
56050528010dSStefano Zampini   PetscCall(DMSetCoordinateDim(*dm, cdim));
56060528010dSStefano Zampini   PetscCall(DMGetDimension(bdm, &dim));
56070528010dSStefano Zampini   PetscCall(DMSetDimension(*dm, dim));
56080528010dSStefano Zampini   PetscCall(DMGetCoordinateDM(bdm, &bcdm));
56090528010dSStefano Zampini   PetscCall(DMGetCoordinateDM(*dm, &cdm));
56100528010dSStefano Zampini   PetscCall(DMCopyDisc(bcdm, cdm));
56110528010dSStefano Zampini   PetscCall(DMGetLocalSection(cdm, &cs));
56120528010dSStefano Zampini   PetscCall(PetscSectionSetNumFields(cs, 1));
56130528010dSStefano Zampini   PetscCall(PetscSectionSetFieldComponents(cs, 0, cdim));
56140528010dSStefano Zampini   PetscCall(DMGetCoordinatesLocal(bdm, &coordinates));
56150528010dSStefano Zampini   PetscCall(VecDuplicate(coordinates, &coordinatesNew));
56160528010dSStefano Zampini   PetscCall(VecCopy(coordinates, coordinatesNew));
56170528010dSStefano Zampini   PetscCall(DMSetCoordinatesLocal(*dm, coordinatesNew));
56180528010dSStefano Zampini   PetscCall(VecDestroy(&coordinatesNew));
56199f6c5813SMatthew G. Knepley 
56209f6c5813SMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)tr));
56219f6c5813SMatthew G. Knepley   PetscCall(DMPlexTransformDestroy(&((DM_Plex *)(*dm)->data)->tr));
56229f6c5813SMatthew G. Knepley   ((DM_Plex *)(*dm)->data)->tr = tr;
56230528010dSStefano Zampini   PetscCall(DMPlexDistributeSetDefault(*dm, PETSC_FALSE));
56240528010dSStefano Zampini   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)*dm, prefix));
56250528010dSStefano Zampini   PetscCall(DMSetFromOptions(*dm));
56269f6c5813SMatthew G. Knepley 
56279f6c5813SMatthew G. Knepley   PetscCall(DMGetNumLabels(bdm, &Nl));
56289f6c5813SMatthew G. Knepley   for (PetscInt l = 0; l < Nl; ++l) {
56299f6c5813SMatthew G. Knepley     DMLabel     label, labelNew;
56309f6c5813SMatthew G. Knepley     const char *lname;
56319f6c5813SMatthew G. Knepley     PetscBool   isDepth, isCellType;
56329f6c5813SMatthew G. Knepley 
56339f6c5813SMatthew G. Knepley     PetscCall(DMGetLabelName(bdm, l, &lname));
56349f6c5813SMatthew G. Knepley     PetscCall(PetscStrcmp(lname, "depth", &isDepth));
56359f6c5813SMatthew G. Knepley     if (isDepth) continue;
56369f6c5813SMatthew G. Knepley     PetscCall(PetscStrcmp(lname, "celltype", &isCellType));
56379f6c5813SMatthew G. Knepley     if (isCellType) continue;
56389f6c5813SMatthew G. Knepley     PetscCall(DMCreateLabel(*dm, lname));
56399f6c5813SMatthew G. Knepley     PetscCall(DMGetLabel(bdm, lname, &label));
56409f6c5813SMatthew G. Knepley     PetscCall(DMGetLabel(*dm, lname, &labelNew));
56419f6c5813SMatthew G. Knepley     PetscCall(DMLabelSetType(labelNew, DMLABELEPHEMERAL));
56429f6c5813SMatthew G. Knepley     PetscCall(DMLabelEphemeralSetLabel(labelNew, label));
56439f6c5813SMatthew G. Knepley     PetscCall(DMLabelEphemeralSetTransform(labelNew, tr));
56449f6c5813SMatthew G. Knepley     PetscCall(DMLabelSetUp(labelNew));
56459f6c5813SMatthew G. Knepley   }
56463ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
56479f6c5813SMatthew G. Knepley }
5648