xref: /petsc/src/dm/impls/plex/plexcreate.c (revision 1b742f0101dde2a03f52d9572cb99370cb7719ff)
1552f7358SJed Brown #define PETSCDM_DLL
2af0996ceSBarry Smith #include <petsc/private/dmpleximpl.h> /*I   "petscdmplex.h"   I*/
3cc4c1da9SBarry Smith #include <petsc/private/hashseti.h>
40c312b8eSJed Brown #include <petscsf.h>
5cc4c1da9SBarry Smith #include <petscdmplextransform.h> /*I   "petscdmplextransform.h"   I*/
69f6c5813SMatthew G. Knepley #include <petscdmlabelephemeral.h>
7b7f5c055SJed Brown #include <petsc/private/kernels/blockmatmult.h>
8b7f5c055SJed Brown #include <petsc/private/kernels/blockinvert.h>
9552f7358SJed Brown 
10d0812dedSMatthew G. Knepley #ifdef PETSC_HAVE_UNISTD_H
11d0812dedSMatthew G. Knepley   #include <unistd.h>
12d0812dedSMatthew G. Knepley #endif
13d0812dedSMatthew G. Knepley #include <errno.h>
14d0812dedSMatthew G. Knepley 
15708be2fdSJed Brown PetscLogEvent DMPLEX_CreateFromFile, DMPLEX_CreateFromOptions, DMPLEX_BuildFromCellList, DMPLEX_BuildCoordinatesFromCellList;
1658cd63d5SVaclav Hapla 
179318fe57SMatthew G. Knepley /* External function declarations here */
189318fe57SMatthew G. Knepley static PetscErrorCode DMInitialize_Plex(DM dm);
199318fe57SMatthew G. Knepley 
20e600fa54SMatthew G. Knepley /* This copies internal things in the Plex structure that we generally want when making a new, related Plex */
21d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCopy_Internal(DM dmin, PetscBool copyPeriodicity, PetscBool copyOverlap, DM dmout)
22d71ae5a4SJacob Faibussowitsch {
234fb89dddSMatthew G. Knepley   const PetscReal     *maxCell, *Lstart, *L;
2412a88998SMatthew G. Knepley   VecType              vecType;
2512a88998SMatthew G. Knepley   MatType              matType;
265962854dSMatthew G. Knepley   PetscBool            dist, useCeed;
27adc21957SMatthew G. Knepley   DMReorderDefaultFlag reorder;
28e600fa54SMatthew G. Knepley 
29e600fa54SMatthew G. Knepley   PetscFunctionBegin;
3012a88998SMatthew G. Knepley   PetscCall(DMGetVecType(dmin, &vecType));
3112a88998SMatthew G. Knepley   PetscCall(DMSetVecType(dmout, vecType));
3212a88998SMatthew G. Knepley   PetscCall(DMGetMatType(dmin, &matType));
3312a88998SMatthew G. Knepley   PetscCall(DMSetMatType(dmout, matType));
34e600fa54SMatthew G. Knepley   if (copyPeriodicity) {
354fb89dddSMatthew G. Knepley     PetscCall(DMGetPeriodicity(dmin, &maxCell, &Lstart, &L));
364fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dmout, maxCell, Lstart, L));
373d0e8ed9SDavid Salac     PetscCall(DMLocalizeCoordinates(dmout));
38e600fa54SMatthew G. Knepley   }
399566063dSJacob Faibussowitsch   PetscCall(DMPlexDistributeGetDefault(dmin, &dist));
409566063dSJacob Faibussowitsch   PetscCall(DMPlexDistributeSetDefault(dmout, dist));
416bc1bd01Sksagiyam   PetscCall(DMPlexReorderGetDefault(dmin, &reorder));
426bc1bd01Sksagiyam   PetscCall(DMPlexReorderSetDefault(dmout, reorder));
435962854dSMatthew G. Knepley   PetscCall(DMPlexGetUseCeed(dmin, &useCeed));
445962854dSMatthew G. Knepley   PetscCall(DMPlexSetUseCeed(dmout, useCeed));
45e600fa54SMatthew G. Knepley   ((DM_Plex *)dmout->data)->useHashLocation = ((DM_Plex *)dmin->data)->useHashLocation;
465962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printSetValues  = ((DM_Plex *)dmin->data)->printSetValues;
475962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printFEM        = ((DM_Plex *)dmin->data)->printFEM;
485962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printFVM        = ((DM_Plex *)dmin->data)->printFVM;
495962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printL2         = ((DM_Plex *)dmin->data)->printL2;
505962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printLocate     = ((DM_Plex *)dmin->data)->printLocate;
515962854dSMatthew G. Knepley   ((DM_Plex *)dmout->data)->printTol        = ((DM_Plex *)dmin->data)->printTol;
521baa6e33SBarry Smith   if (copyOverlap) PetscCall(DMPlexSetOverlap_Plex(dmout, dmin, 0));
533ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
54e600fa54SMatthew G. Knepley }
55e600fa54SMatthew G. Knepley 
569318fe57SMatthew G. Knepley /* Replace dm with the contents of ndm, and then destroy ndm
579318fe57SMatthew G. Knepley    - Share the DM_Plex structure
589318fe57SMatthew G. Knepley    - Share the coordinates
599318fe57SMatthew G. Knepley    - Share the SF
609318fe57SMatthew G. Knepley */
61d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexReplace_Internal(DM dm, DM *ndm)
62d71ae5a4SJacob Faibussowitsch {
639318fe57SMatthew G. Knepley   PetscSF          sf;
649318fe57SMatthew G. Knepley   DM               dmNew = *ndm, coordDM, coarseDM;
659318fe57SMatthew G. Knepley   Vec              coords;
664fb89dddSMatthew G. Knepley   const PetscReal *maxCell, *Lstart, *L;
679318fe57SMatthew G. Knepley   PetscInt         dim, cdim;
689318fe57SMatthew G. Knepley 
699318fe57SMatthew G. Knepley   PetscFunctionBegin;
709318fe57SMatthew G. Knepley   if (dm == dmNew) {
719566063dSJacob Faibussowitsch     PetscCall(DMDestroy(ndm));
723ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
739318fe57SMatthew G. Knepley   }
749318fe57SMatthew G. Knepley   dm->setupcalled = dmNew->setupcalled;
75d0812dedSMatthew G. Knepley   if (!dm->hdr.name) {
76d0812dedSMatthew G. Knepley     const char *name;
77d0812dedSMatthew G. Knepley 
78d0812dedSMatthew G. Knepley     PetscCall(PetscObjectGetName((PetscObject)*ndm, &name));
79d0812dedSMatthew G. Knepley     PetscCall(PetscObjectSetName((PetscObject)dm, name));
80d0812dedSMatthew G. Knepley   }
819566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dmNew, &dim));
829566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
839566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dmNew, &cdim));
849566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, cdim));
859566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dmNew, &sf));
869566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dm, sf));
879566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dmNew, &coordDM));
889566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dmNew, &coords));
899566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDM(dm, coordDM));
909566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coords));
916858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dmNew, &coordDM));
926858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocal(dmNew, &coords));
936858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinateDM(dm, coordDM));
946858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinatesLocal(dm, coords));
959318fe57SMatthew G. Knepley   /* Do not want to create the coordinate field if it does not already exist, so do not call DMGetCoordinateField() */
966858538eSMatthew G. Knepley   PetscCall(DMFieldDestroy(&dm->coordinates[0].field));
976858538eSMatthew G. Knepley   dm->coordinates[0].field            = dmNew->coordinates[0].field;
9861a622f3SMatthew G. Knepley   ((DM_Plex *)dmNew->data)->coordFunc = ((DM_Plex *)dm->data)->coordFunc;
994fb89dddSMatthew G. Knepley   PetscCall(DMGetPeriodicity(dmNew, &maxCell, &Lstart, &L));
1004fb89dddSMatthew G. Knepley   PetscCall(DMSetPeriodicity(dm, maxCell, Lstart, L));
1016925d1c4SMatthew G. Knepley   PetscCall(DMPlexGetGlobalToNaturalSF(dmNew, &sf));
1026925d1c4SMatthew G. Knepley   PetscCall(DMPlexSetGlobalToNaturalSF(dm, sf));
1039566063dSJacob Faibussowitsch   PetscCall(DMDestroy_Plex(dm));
1049566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(dm));
1059318fe57SMatthew G. Knepley   dm->data = dmNew->data;
1069318fe57SMatthew G. Knepley   ((DM_Plex *)dmNew->data)->refct++;
1071fca310dSJames Wright   {
1081fca310dSJames Wright     PetscInt       num_face_sfs;
1091fca310dSJames Wright     const PetscSF *sfs;
1101fca310dSJames Wright     PetscCall(DMPlexGetIsoperiodicFaceSF(dm, &num_face_sfs, &sfs));
1111fca310dSJames Wright     PetscCall(DMPlexSetIsoperiodicFaceSF(dm, num_face_sfs, (PetscSF *)sfs)); // for the compose function effect on dm
1121fca310dSJames Wright   }
1139566063dSJacob Faibussowitsch   PetscCall(DMDestroyLabelLinkList_Internal(dm));
1149566063dSJacob Faibussowitsch   PetscCall(DMCopyLabels(dmNew, dm, PETSC_OWN_POINTER, PETSC_TRUE, DM_COPY_LABELS_FAIL));
1159566063dSJacob Faibussowitsch   PetscCall(DMGetCoarseDM(dmNew, &coarseDM));
1169566063dSJacob Faibussowitsch   PetscCall(DMSetCoarseDM(dm, coarseDM));
1179566063dSJacob Faibussowitsch   PetscCall(DMDestroy(ndm));
1183ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1199318fe57SMatthew G. Knepley }
1209318fe57SMatthew G. Knepley 
1219318fe57SMatthew G. Knepley /* Swap dm with the contents of dmNew
1229318fe57SMatthew G. Knepley    - Swap the DM_Plex structure
1239318fe57SMatthew G. Knepley    - Swap the coordinates
1249318fe57SMatthew G. Knepley    - Swap the point PetscSF
1259318fe57SMatthew G. Knepley */
126d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexSwap_Static(DM dmA, DM dmB)
127d71ae5a4SJacob Faibussowitsch {
1289318fe57SMatthew G. Knepley   DM          coordDMA, coordDMB;
1299318fe57SMatthew G. Knepley   Vec         coordsA, coordsB;
1309318fe57SMatthew G. Knepley   PetscSF     sfA, sfB;
1319318fe57SMatthew G. Knepley   DMField     fieldTmp;
1329318fe57SMatthew G. Knepley   void       *tmp;
1339318fe57SMatthew G. Knepley   DMLabelLink listTmp;
1349318fe57SMatthew G. Knepley   DMLabel     depthTmp;
1359318fe57SMatthew G. Knepley   PetscInt    tmpI;
1369318fe57SMatthew G. Knepley 
1379318fe57SMatthew G. Knepley   PetscFunctionBegin;
1383ba16761SJacob Faibussowitsch   if (dmA == dmB) PetscFunctionReturn(PETSC_SUCCESS);
1399566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dmA, &sfA));
1409566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dmB, &sfB));
1419566063dSJacob Faibussowitsch   PetscCall(PetscObjectReference((PetscObject)sfA));
1429566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dmA, sfB));
1439566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dmB, sfA));
1449566063dSJacob Faibussowitsch   PetscCall(PetscObjectDereference((PetscObject)sfA));
1459318fe57SMatthew G. Knepley 
1469566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dmA, &coordDMA));
1479566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dmB, &coordDMB));
1489566063dSJacob Faibussowitsch   PetscCall(PetscObjectReference((PetscObject)coordDMA));
1499566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDM(dmA, coordDMB));
1509566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDM(dmB, coordDMA));
1519566063dSJacob Faibussowitsch   PetscCall(PetscObjectDereference((PetscObject)coordDMA));
1529318fe57SMatthew G. Knepley 
1539566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dmA, &coordsA));
1549566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dmB, &coordsB));
1559566063dSJacob Faibussowitsch   PetscCall(PetscObjectReference((PetscObject)coordsA));
1569566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dmA, coordsB));
1579566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dmB, coordsA));
1589566063dSJacob Faibussowitsch   PetscCall(PetscObjectDereference((PetscObject)coordsA));
1599318fe57SMatthew G. Knepley 
1606858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dmA, &coordDMA));
1616858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dmB, &coordDMB));
1626858538eSMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)coordDMA));
1636858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinateDM(dmA, coordDMB));
1646858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinateDM(dmB, coordDMA));
1656858538eSMatthew G. Knepley   PetscCall(PetscObjectDereference((PetscObject)coordDMA));
1666858538eSMatthew G. Knepley 
1676858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocal(dmA, &coordsA));
1686858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocal(dmB, &coordsB));
1696858538eSMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)coordsA));
1706858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinatesLocal(dmA, coordsB));
1716858538eSMatthew G. Knepley   PetscCall(DMSetCellCoordinatesLocal(dmB, coordsA));
1726858538eSMatthew G. Knepley   PetscCall(PetscObjectDereference((PetscObject)coordsA));
1736858538eSMatthew G. Knepley 
1746858538eSMatthew G. Knepley   fieldTmp                  = dmA->coordinates[0].field;
1756858538eSMatthew G. Knepley   dmA->coordinates[0].field = dmB->coordinates[0].field;
1766858538eSMatthew G. Knepley   dmB->coordinates[0].field = fieldTmp;
1776858538eSMatthew G. Knepley   fieldTmp                  = dmA->coordinates[1].field;
1786858538eSMatthew G. Knepley   dmA->coordinates[1].field = dmB->coordinates[1].field;
1796858538eSMatthew G. Knepley   dmB->coordinates[1].field = fieldTmp;
1809318fe57SMatthew G. Knepley   tmp                       = dmA->data;
1819318fe57SMatthew G. Knepley   dmA->data                 = dmB->data;
1829318fe57SMatthew G. Knepley   dmB->data                 = tmp;
1839318fe57SMatthew G. Knepley   listTmp                   = dmA->labels;
1849318fe57SMatthew G. Knepley   dmA->labels               = dmB->labels;
1859318fe57SMatthew G. Knepley   dmB->labels               = listTmp;
1869318fe57SMatthew G. Knepley   depthTmp                  = dmA->depthLabel;
1879318fe57SMatthew G. Knepley   dmA->depthLabel           = dmB->depthLabel;
1889318fe57SMatthew G. Knepley   dmB->depthLabel           = depthTmp;
1899318fe57SMatthew G. Knepley   depthTmp                  = dmA->celltypeLabel;
1909318fe57SMatthew G. Knepley   dmA->celltypeLabel        = dmB->celltypeLabel;
1919318fe57SMatthew G. Knepley   dmB->celltypeLabel        = depthTmp;
1929318fe57SMatthew G. Knepley   tmpI                      = dmA->levelup;
1939318fe57SMatthew G. Knepley   dmA->levelup              = dmB->levelup;
1949318fe57SMatthew G. Knepley   dmB->levelup              = tmpI;
1953ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1969318fe57SMatthew G. Knepley }
1979318fe57SMatthew G. Knepley 
1983431e603SJed Brown PetscErrorCode DMPlexInterpolateInPlace_Internal(DM dm)
199d71ae5a4SJacob Faibussowitsch {
2009318fe57SMatthew G. Knepley   DM idm;
2019318fe57SMatthew G. Knepley 
2029318fe57SMatthew G. Knepley   PetscFunctionBegin;
2039566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolate(dm, &idm));
2049566063dSJacob Faibussowitsch   PetscCall(DMPlexCopyCoordinates(dm, idm));
20569d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &idm));
2063ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2079318fe57SMatthew G. Knepley }
2089318fe57SMatthew G. Knepley 
2099318fe57SMatthew G. Knepley /*@C
2109318fe57SMatthew G. Knepley   DMPlexCreateCoordinateSpace - Creates a finite element space for the coordinates
2119318fe57SMatthew G. Knepley 
21220f4b53cSBarry Smith   Collective
2139318fe57SMatthew G. Knepley 
2149318fe57SMatthew G. Knepley   Input Parameters:
21560225df5SJacob Faibussowitsch + dm        - The `DMPLEX`
21620f4b53cSBarry Smith . degree    - The degree of the finite element or `PETSC_DECIDE`
217e44f6aebSMatthew G. Knepley . project   - Flag to project current coordinates into the space
2189318fe57SMatthew G. Knepley - coordFunc - An optional function to map new points from refinement to the surface
2199318fe57SMatthew G. Knepley 
2209318fe57SMatthew G. Knepley   Level: advanced
2219318fe57SMatthew G. Knepley 
2221cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `PetscPointFunc`, `PetscFECreateLagrange()`, `DMGetCoordinateDM()`
2239318fe57SMatthew G. Knepley @*/
224e44f6aebSMatthew G. Knepley PetscErrorCode DMPlexCreateCoordinateSpace(DM dm, PetscInt degree, PetscBool project, PetscPointFunc coordFunc)
225d71ae5a4SJacob Faibussowitsch {
2269318fe57SMatthew G. Knepley   DM_Plex *mesh = (DM_Plex *)dm->data;
227e44f6aebSMatthew G. Knepley   PetscFE  fe   = NULL;
2289318fe57SMatthew G. Knepley   DM       cdm;
2291df12153SMatthew G. Knepley   PetscInt dim, dE, qorder, height;
2309318fe57SMatthew G. Knepley 
231e44f6aebSMatthew G. Knepley   PetscFunctionBegin;
2329566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
2339566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &dE));
2349318fe57SMatthew G. Knepley   qorder = degree;
235e44f6aebSMatthew G. Knepley   PetscCall(DMGetCoordinateDM(dm, &cdm));
236d0609cedSBarry Smith   PetscObjectOptionsBegin((PetscObject)cdm);
237dc431b0cSMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-default_quadrature_order", "Quadrature order is one less than quadrature points per edge", "DMPlexCreateCoordinateSpace", qorder, &qorder, NULL, 0));
238d0609cedSBarry Smith   PetscOptionsEnd();
2391df12153SMatthew G. Knepley   PetscCall(DMPlexGetVTKCellHeight(dm, &height));
240e44f6aebSMatthew G. Knepley   if (degree >= 0) {
241e44f6aebSMatthew G. Knepley     DMPolytopeType ct = DM_POLYTOPE_UNKNOWN;
242e44f6aebSMatthew G. Knepley     PetscInt       cStart, cEnd, gct;
243dc431b0cSMatthew G. Knepley 
2441df12153SMatthew G. Knepley     PetscCall(DMPlexGetHeightStratum(dm, height, &cStart, &cEnd));
245dc431b0cSMatthew G. Knepley     if (cEnd > cStart) PetscCall(DMPlexGetCellType(dm, cStart, &ct));
246e44f6aebSMatthew G. Knepley     gct = (PetscInt)ct;
247e44f6aebSMatthew G. Knepley     PetscCall(MPIU_Allreduce(MPI_IN_PLACE, &gct, 1, MPIU_INT, MPI_MIN, PetscObjectComm((PetscObject)dm)));
248e44f6aebSMatthew G. Knepley     ct = (DMPolytopeType)gct;
249e44f6aebSMatthew G. Knepley     // Work around current bug in PetscDualSpaceSetUp_Lagrange()
250e44f6aebSMatthew G. Knepley     //   Can be seen in plex_tutorials-ex10_1
251e44f6aebSMatthew G. Knepley     if (ct != DM_POLYTOPE_SEG_PRISM_TENSOR && ct != DM_POLYTOPE_TRI_PRISM_TENSOR && ct != DM_POLYTOPE_QUAD_PRISM_TENSOR) PetscCall(PetscFECreateLagrangeByCell(PETSC_COMM_SELF, dim, dE, ct, degree, qorder, &fe));
2524f9ab2b4SJed Brown   }
253e44f6aebSMatthew G. Knepley   PetscCall(DMSetCoordinateDisc(dm, fe, project));
2549566063dSJacob Faibussowitsch   PetscCall(PetscFEDestroy(&fe));
2559318fe57SMatthew G. Knepley   mesh->coordFunc = coordFunc;
2563ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2579318fe57SMatthew G. Knepley }
2589318fe57SMatthew G. Knepley 
2591df5d5c5SMatthew G. Knepley /*@
2601df5d5c5SMatthew G. Knepley   DMPlexCreateDoublet - Creates a mesh of two cells of the specified type, optionally with later refinement.
2611df5d5c5SMatthew G. Knepley 
262d083f849SBarry Smith   Collective
2631df5d5c5SMatthew G. Knepley 
2641df5d5c5SMatthew G. Knepley   Input Parameters:
265a1cb98faSBarry Smith + comm            - The communicator for the `DM` object
2661df5d5c5SMatthew G. Knepley . dim             - The spatial dimension
2671df5d5c5SMatthew G. Knepley . simplex         - Flag for simplicial cells, otherwise they are tensor product cells
2681df5d5c5SMatthew G. Knepley . interpolate     - Flag to create intermediate mesh pieces (edges, faces)
2691df5d5c5SMatthew G. Knepley - refinementLimit - A nonzero number indicates the largest admissible volume for a refined cell
2701df5d5c5SMatthew G. Knepley 
2711df5d5c5SMatthew G. Knepley   Output Parameter:
27260225df5SJacob Faibussowitsch . newdm - The `DM` object
2731df5d5c5SMatthew G. Knepley 
2741df5d5c5SMatthew G. Knepley   Level: beginner
2751df5d5c5SMatthew G. Knepley 
2761cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMSetType()`, `DMCreate()`
2771df5d5c5SMatthew G. Knepley @*/
278d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateDoublet(MPI_Comm comm, PetscInt dim, PetscBool simplex, PetscBool interpolate, PetscReal refinementLimit, DM *newdm)
279d71ae5a4SJacob Faibussowitsch {
2801df5d5c5SMatthew G. Knepley   DM          dm;
2811df5d5c5SMatthew G. Knepley   PetscMPIInt rank;
2821df5d5c5SMatthew G. Knepley 
2831df5d5c5SMatthew G. Knepley   PetscFunctionBegin;
2849566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, &dm));
2859566063dSJacob Faibussowitsch   PetscCall(DMSetType(dm, DMPLEX));
2869566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
28746139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
2889566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
289ce78fa2fSMatthew G. Knepley   switch (dim) {
290ce78fa2fSMatthew G. Knepley   case 2:
2919566063dSJacob Faibussowitsch     if (simplex) PetscCall(PetscObjectSetName((PetscObject)dm, "triangular"));
2929566063dSJacob Faibussowitsch     else PetscCall(PetscObjectSetName((PetscObject)dm, "quadrilateral"));
293ce78fa2fSMatthew G. Knepley     break;
294ce78fa2fSMatthew G. Knepley   case 3:
2959566063dSJacob Faibussowitsch     if (simplex) PetscCall(PetscObjectSetName((PetscObject)dm, "tetrahedral"));
2969566063dSJacob Faibussowitsch     else PetscCall(PetscObjectSetName((PetscObject)dm, "hexahedral"));
297ce78fa2fSMatthew G. Knepley     break;
298d71ae5a4SJacob Faibussowitsch   default:
299d71ae5a4SJacob Faibussowitsch     SETERRQ(comm, PETSC_ERR_ARG_OUTOFRANGE, "Cannot make meshes for dimension %" PetscInt_FMT, dim);
300ce78fa2fSMatthew G. Knepley   }
3011df5d5c5SMatthew G. Knepley   if (rank) {
3021df5d5c5SMatthew G. Knepley     PetscInt numPoints[2] = {0, 0};
3039566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, NULL, NULL, NULL, NULL));
3041df5d5c5SMatthew G. Knepley   } else {
3051df5d5c5SMatthew G. Knepley     switch (dim) {
3061df5d5c5SMatthew G. Knepley     case 2:
3071df5d5c5SMatthew G. Knepley       if (simplex) {
3081df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]        = {4, 2};
3091df5d5c5SMatthew G. Knepley         PetscInt    coneSize[6]         = {3, 3, 0, 0, 0, 0};
3101df5d5c5SMatthew G. Knepley         PetscInt    cones[6]            = {2, 3, 4, 5, 4, 3};
3111df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
3121df5d5c5SMatthew G. Knepley         PetscScalar vertexCoords[8]     = {-0.5, 0.5, 0.0, 0.0, 0.0, 1.0, 0.5, 0.5};
3131df5d5c5SMatthew G. Knepley 
3149566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
3151df5d5c5SMatthew G. Knepley       } else {
3161df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]        = {6, 2};
3171df5d5c5SMatthew G. Knepley         PetscInt    coneSize[8]         = {4, 4, 0, 0, 0, 0, 0, 0};
3181df5d5c5SMatthew G. Knepley         PetscInt    cones[8]            = {2, 3, 4, 5, 3, 6, 7, 4};
3191df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
3201df5d5c5SMatthew 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};
3211df5d5c5SMatthew G. Knepley 
3229566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
3231df5d5c5SMatthew G. Knepley       }
3241df5d5c5SMatthew G. Knepley       break;
3251df5d5c5SMatthew G. Knepley     case 3:
3261df5d5c5SMatthew G. Knepley       if (simplex) {
3271df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]        = {5, 2};
3281df5d5c5SMatthew G. Knepley         PetscInt    coneSize[7]         = {4, 4, 0, 0, 0, 0, 0};
3291df5d5c5SMatthew G. Knepley         PetscInt    cones[8]            = {4, 3, 5, 2, 5, 3, 4, 6};
3301df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
3311df5d5c5SMatthew 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};
3321df5d5c5SMatthew G. Knepley 
3339566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
3341df5d5c5SMatthew G. Knepley       } else {
3351df5d5c5SMatthew G. Knepley         PetscInt    numPoints[2]         = {12, 2};
3361df5d5c5SMatthew G. Knepley         PetscInt    coneSize[14]         = {8, 8, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
3371df5d5c5SMatthew G. Knepley         PetscInt    cones[16]            = {2, 3, 4, 5, 6, 7, 8, 9, 5, 4, 10, 11, 7, 12, 13, 8};
3381df5d5c5SMatthew G. Knepley         PetscInt    coneOrientations[16] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
3399371c9d4SSatish 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};
3401df5d5c5SMatthew G. Knepley 
3419566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
3421df5d5c5SMatthew G. Knepley       }
3431df5d5c5SMatthew G. Knepley       break;
344d71ae5a4SJacob Faibussowitsch     default:
345d71ae5a4SJacob Faibussowitsch       SETERRQ(comm, PETSC_ERR_ARG_OUTOFRANGE, "Cannot make meshes for dimension %" PetscInt_FMT, dim);
3461df5d5c5SMatthew G. Knepley     }
3471df5d5c5SMatthew G. Knepley   }
34846139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
3491df5d5c5SMatthew G. Knepley   *newdm = dm;
3501df5d5c5SMatthew G. Knepley   if (refinementLimit > 0.0) {
3511df5d5c5SMatthew G. Knepley     DM          rdm;
3521df5d5c5SMatthew G. Knepley     const char *name;
3531df5d5c5SMatthew G. Knepley 
3549566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementUniform(*newdm, PETSC_FALSE));
3559566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementLimit(*newdm, refinementLimit));
3569566063dSJacob Faibussowitsch     PetscCall(DMRefine(*newdm, comm, &rdm));
3579566063dSJacob Faibussowitsch     PetscCall(PetscObjectGetName((PetscObject)*newdm, &name));
3589566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)rdm, name));
3599566063dSJacob Faibussowitsch     PetscCall(DMDestroy(newdm));
3601df5d5c5SMatthew G. Knepley     *newdm = rdm;
3611df5d5c5SMatthew G. Knepley   }
3621df5d5c5SMatthew G. Knepley   if (interpolate) {
3635fd9971aSMatthew G. Knepley     DM idm;
3641df5d5c5SMatthew G. Knepley 
3659566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*newdm, &idm));
3669566063dSJacob Faibussowitsch     PetscCall(DMDestroy(newdm));
3671df5d5c5SMatthew G. Knepley     *newdm = idm;
3681df5d5c5SMatthew G. Knepley   }
3693ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3701df5d5c5SMatthew G. Knepley }
3711df5d5c5SMatthew G. Knepley 
372d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Tensor_1D_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[])
373d71ae5a4SJacob Faibussowitsch {
3749318fe57SMatthew G. Knepley   const PetscInt numVertices    = 2;
3759318fe57SMatthew G. Knepley   PetscInt       markerRight    = 1;
3769318fe57SMatthew G. Knepley   PetscInt       markerLeft     = 1;
3779318fe57SMatthew G. Knepley   PetscBool      markerSeparate = PETSC_FALSE;
3789318fe57SMatthew G. Knepley   Vec            coordinates;
3799318fe57SMatthew G. Knepley   PetscSection   coordSection;
3809318fe57SMatthew G. Knepley   PetscScalar   *coords;
3819318fe57SMatthew G. Knepley   PetscInt       coordSize;
3829318fe57SMatthew G. Knepley   PetscMPIInt    rank;
3839318fe57SMatthew G. Knepley   PetscInt       cdim = 1, v;
384552f7358SJed Brown 
3859318fe57SMatthew G. Knepley   PetscFunctionBegin;
3869566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
3879318fe57SMatthew G. Knepley   if (markerSeparate) {
3889318fe57SMatthew G. Knepley     markerRight = 2;
3899318fe57SMatthew G. Knepley     markerLeft  = 1;
3909318fe57SMatthew G. Knepley   }
3919566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
392c5853193SPierre Jolivet   if (rank == 0) {
3939566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numVertices));
3949566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
3959566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", 0, markerLeft));
3969566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", 1, markerRight));
3979318fe57SMatthew G. Knepley   }
3989566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
3999566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
4009318fe57SMatthew G. Knepley   /* Build coordinates */
4019566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, cdim));
4029566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
4039566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
4049566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, 0, numVertices));
4059566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, cdim));
4069318fe57SMatthew G. Knepley   for (v = 0; v < numVertices; ++v) {
4079566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, cdim));
4089566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, cdim));
4099318fe57SMatthew G. Knepley   }
4109566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
4119566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
4129566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
4139566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
4149566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
4159566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, cdim));
4169566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
4179566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
4189318fe57SMatthew G. Knepley   coords[0] = lower[0];
4199318fe57SMatthew G. Knepley   coords[1] = upper[0];
4209566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
4219566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
4229566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
4233ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4249318fe57SMatthew G. Knepley }
42526492d91SMatthew G. Knepley 
426d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Tensor_2D_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[])
427d71ae5a4SJacob Faibussowitsch {
4281df21d24SMatthew G. Knepley   const PetscInt numVertices    = (edges[0] + 1) * (edges[1] + 1);
4291df21d24SMatthew G. Knepley   const PetscInt numEdges       = edges[0] * (edges[1] + 1) + (edges[0] + 1) * edges[1];
430552f7358SJed Brown   PetscInt       markerTop      = 1;
431552f7358SJed Brown   PetscInt       markerBottom   = 1;
432552f7358SJed Brown   PetscInt       markerRight    = 1;
433552f7358SJed Brown   PetscInt       markerLeft     = 1;
434552f7358SJed Brown   PetscBool      markerSeparate = PETSC_FALSE;
435552f7358SJed Brown   Vec            coordinates;
436552f7358SJed Brown   PetscSection   coordSection;
437552f7358SJed Brown   PetscScalar   *coords;
438552f7358SJed Brown   PetscInt       coordSize;
439552f7358SJed Brown   PetscMPIInt    rank;
440552f7358SJed Brown   PetscInt       v, vx, vy;
441552f7358SJed Brown 
442552f7358SJed Brown   PetscFunctionBegin;
4439566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
444552f7358SJed Brown   if (markerSeparate) {
4451df21d24SMatthew G. Knepley     markerTop    = 3;
4461df21d24SMatthew G. Knepley     markerBottom = 1;
4471df21d24SMatthew G. Knepley     markerRight  = 2;
4481df21d24SMatthew G. Knepley     markerLeft   = 4;
449552f7358SJed Brown   }
4509566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
451dd400576SPatrick Sanan   if (rank == 0) {
452552f7358SJed Brown     PetscInt e, ex, ey;
453552f7358SJed Brown 
4549566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numEdges + numVertices));
45548a46eb9SPierre Jolivet     for (e = 0; e < numEdges; ++e) PetscCall(DMPlexSetConeSize(dm, e, 2));
4569566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
457552f7358SJed Brown     for (vx = 0; vx <= edges[0]; vx++) {
458552f7358SJed Brown       for (ey = 0; ey < edges[1]; ey++) {
459552f7358SJed Brown         PetscInt edge   = vx * edges[1] + ey + edges[0] * (edges[1] + 1);
460552f7358SJed Brown         PetscInt vertex = ey * (edges[0] + 1) + vx + numEdges;
461da80777bSKarl Rupp         PetscInt cone[2];
462552f7358SJed Brown 
4639371c9d4SSatish Balay         cone[0] = vertex;
4649371c9d4SSatish Balay         cone[1] = vertex + edges[0] + 1;
4659566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, edge, cone));
466552f7358SJed Brown         if (vx == edges[0]) {
4679566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
4689566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
469552f7358SJed Brown           if (ey == edges[1] - 1) {
4709566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
4719566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerRight));
472552f7358SJed Brown           }
473552f7358SJed Brown         } else if (vx == 0) {
4749566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
4759566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
476552f7358SJed Brown           if (ey == edges[1] - 1) {
4779566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
4789566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerLeft));
479552f7358SJed Brown           }
480552f7358SJed Brown         }
481552f7358SJed Brown       }
482552f7358SJed Brown     }
483552f7358SJed Brown     for (vy = 0; vy <= edges[1]; vy++) {
484552f7358SJed Brown       for (ex = 0; ex < edges[0]; ex++) {
485552f7358SJed Brown         PetscInt edge   = vy * edges[0] + ex;
486552f7358SJed Brown         PetscInt vertex = vy * (edges[0] + 1) + ex + numEdges;
487da80777bSKarl Rupp         PetscInt cone[2];
488552f7358SJed Brown 
4899371c9d4SSatish Balay         cone[0] = vertex;
4909371c9d4SSatish Balay         cone[1] = vertex + 1;
4919566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, edge, cone));
492552f7358SJed Brown         if (vy == edges[1]) {
4939566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
4949566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
495552f7358SJed Brown           if (ex == edges[0] - 1) {
4969566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
4979566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerTop));
498552f7358SJed Brown           }
499552f7358SJed Brown         } else if (vy == 0) {
5009566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
5019566063dSJacob Faibussowitsch           PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
502552f7358SJed Brown           if (ex == edges[0] - 1) {
5039566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
5049566063dSJacob Faibussowitsch             PetscCall(DMSetLabelValue(dm, "Face Sets", cone[1], markerBottom));
505552f7358SJed Brown           }
506552f7358SJed Brown         }
507552f7358SJed Brown       }
508552f7358SJed Brown     }
509552f7358SJed Brown   }
5109566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
5119566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
512552f7358SJed Brown   /* Build coordinates */
5139566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, 2));
5149566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
5159566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
5169566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, numEdges, numEdges + numVertices));
5179566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, 2));
518552f7358SJed Brown   for (v = numEdges; v < numEdges + numVertices; ++v) {
5199566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, 2));
5209566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, 2));
521552f7358SJed Brown   }
5229566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
5239566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
5249566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
5259566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
5269566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
5279566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, 2));
5289566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
5299566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
530552f7358SJed Brown   for (vy = 0; vy <= edges[1]; ++vy) {
531552f7358SJed Brown     for (vx = 0; vx <= edges[0]; ++vx) {
532552f7358SJed Brown       coords[(vy * (edges[0] + 1) + vx) * 2 + 0] = lower[0] + ((upper[0] - lower[0]) / edges[0]) * vx;
533552f7358SJed Brown       coords[(vy * (edges[0] + 1) + vx) * 2 + 1] = lower[1] + ((upper[1] - lower[1]) / edges[1]) * vy;
534552f7358SJed Brown     }
535552f7358SJed Brown   }
5369566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
5379566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
5389566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
5393ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
540552f7358SJed Brown }
541552f7358SJed Brown 
542d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Tensor_3D_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt faces[])
543d71ae5a4SJacob Faibussowitsch {
5449e8abbc3SMichael Lange   PetscInt     vertices[3], numVertices;
5457b59f5a9SMichael Lange   PetscInt     numFaces       = 2 * faces[0] * faces[1] + 2 * faces[1] * faces[2] + 2 * faces[0] * faces[2];
546c2df9bbfSMatthew G. Knepley   PetscInt     markerTop      = 1;
547c2df9bbfSMatthew G. Knepley   PetscInt     markerBottom   = 1;
548c2df9bbfSMatthew G. Knepley   PetscInt     markerFront    = 1;
549c2df9bbfSMatthew G. Knepley   PetscInt     markerBack     = 1;
550c2df9bbfSMatthew G. Knepley   PetscInt     markerRight    = 1;
551c2df9bbfSMatthew G. Knepley   PetscInt     markerLeft     = 1;
552c2df9bbfSMatthew G. Knepley   PetscBool    markerSeparate = PETSC_FALSE;
553552f7358SJed Brown   Vec          coordinates;
554552f7358SJed Brown   PetscSection coordSection;
555552f7358SJed Brown   PetscScalar *coords;
556552f7358SJed Brown   PetscInt     coordSize;
557552f7358SJed Brown   PetscMPIInt  rank;
558552f7358SJed Brown   PetscInt     v, vx, vy, vz;
5597b59f5a9SMichael Lange   PetscInt     voffset, iface = 0, cone[4];
560552f7358SJed Brown 
561552f7358SJed Brown   PetscFunctionBegin;
5621dca8a05SBarry 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");
5639566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
564c2df9bbfSMatthew G. Knepley   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
565c2df9bbfSMatthew G. Knepley   if (markerSeparate) {
566c2df9bbfSMatthew G. Knepley     markerBottom = 1;
567c2df9bbfSMatthew G. Knepley     markerTop    = 2;
568c2df9bbfSMatthew G. Knepley     markerFront  = 3;
569c2df9bbfSMatthew G. Knepley     markerBack   = 4;
570c2df9bbfSMatthew G. Knepley     markerRight  = 5;
571c2df9bbfSMatthew G. Knepley     markerLeft   = 6;
572c2df9bbfSMatthew G. Knepley   }
5739371c9d4SSatish Balay   vertices[0] = faces[0] + 1;
5749371c9d4SSatish Balay   vertices[1] = faces[1] + 1;
5759371c9d4SSatish Balay   vertices[2] = faces[2] + 1;
5769e8abbc3SMichael Lange   numVertices = vertices[0] * vertices[1] * vertices[2];
577dd400576SPatrick Sanan   if (rank == 0) {
578552f7358SJed Brown     PetscInt f;
579552f7358SJed Brown 
5809566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numFaces + numVertices));
58148a46eb9SPierre Jolivet     for (f = 0; f < numFaces; ++f) PetscCall(DMPlexSetConeSize(dm, f, 4));
5829566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
5837b59f5a9SMichael Lange 
5847b59f5a9SMichael Lange     /* Side 0 (Top) */
5857b59f5a9SMichael Lange     for (vy = 0; vy < faces[1]; vy++) {
5867b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
5877b59f5a9SMichael Lange         voffset = numFaces + vertices[0] * vertices[1] * (vertices[2] - 1) + vy * vertices[0] + vx;
5889371c9d4SSatish Balay         cone[0] = voffset;
5899371c9d4SSatish Balay         cone[1] = voffset + 1;
5909371c9d4SSatish Balay         cone[2] = voffset + vertices[0] + 1;
5919371c9d4SSatish Balay         cone[3] = voffset + vertices[0];
5929566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
593c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerTop));
594c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerTop));
595c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerTop));
596c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerTop));
597c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 1, markerTop));
5987b59f5a9SMichael Lange         iface++;
599552f7358SJed Brown       }
600552f7358SJed Brown     }
6017b59f5a9SMichael Lange 
6027b59f5a9SMichael Lange     /* Side 1 (Bottom) */
6037b59f5a9SMichael Lange     for (vy = 0; vy < faces[1]; vy++) {
6047b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
6057b59f5a9SMichael Lange         voffset = numFaces + vy * (faces[0] + 1) + vx;
6069371c9d4SSatish Balay         cone[0] = voffset + 1;
6079371c9d4SSatish Balay         cone[1] = voffset;
6089371c9d4SSatish Balay         cone[2] = voffset + vertices[0];
6099371c9d4SSatish Balay         cone[3] = voffset + vertices[0] + 1;
6109566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
611c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerBottom));
612c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerBottom));
613c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerBottom));
614c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerBottom));
615c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 1, markerBottom));
6167b59f5a9SMichael Lange         iface++;
617552f7358SJed Brown       }
618552f7358SJed Brown     }
6197b59f5a9SMichael Lange 
6207b59f5a9SMichael Lange     /* Side 2 (Front) */
6217b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
6227b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
6237b59f5a9SMichael Lange         voffset = numFaces + vz * vertices[0] * vertices[1] + vx;
6249371c9d4SSatish Balay         cone[0] = voffset;
6259371c9d4SSatish Balay         cone[1] = voffset + 1;
6269371c9d4SSatish Balay         cone[2] = voffset + vertices[0] * vertices[1] + 1;
6279371c9d4SSatish Balay         cone[3] = voffset + vertices[0] * vertices[1];
6289566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
629c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerFront));
630c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerFront));
631c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerFront));
632c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 0, markerFront));
633c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 1, markerFront));
6347b59f5a9SMichael Lange         iface++;
635552f7358SJed Brown       }
6367b59f5a9SMichael Lange     }
6377b59f5a9SMichael Lange 
6387b59f5a9SMichael Lange     /* Side 3 (Back) */
6397b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
6407b59f5a9SMichael Lange       for (vx = 0; vx < faces[0]; vx++) {
6417b59f5a9SMichael Lange         voffset = numFaces + vz * vertices[0] * vertices[1] + vertices[0] * (vertices[1] - 1) + vx;
6429371c9d4SSatish Balay         cone[0] = voffset + vertices[0] * vertices[1];
6439371c9d4SSatish Balay         cone[1] = voffset + vertices[0] * vertices[1] + 1;
6449371c9d4SSatish Balay         cone[2] = voffset + 1;
6459371c9d4SSatish Balay         cone[3] = voffset;
6469566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
647c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerBack));
648c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerBack));
649c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 1, markerBack));
650c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 0, markerBack));
651c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 1, markerBack));
6527b59f5a9SMichael Lange         iface++;
6537b59f5a9SMichael Lange       }
6547b59f5a9SMichael Lange     }
6557b59f5a9SMichael Lange 
6567b59f5a9SMichael Lange     /* Side 4 (Left) */
6577b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
6587b59f5a9SMichael Lange       for (vy = 0; vy < faces[1]; vy++) {
6597b59f5a9SMichael Lange         voffset = numFaces + vz * vertices[0] * vertices[1] + vy * vertices[0];
6609371c9d4SSatish Balay         cone[0] = voffset;
6619371c9d4SSatish Balay         cone[1] = voffset + vertices[0] * vertices[1];
6629371c9d4SSatish Balay         cone[2] = voffset + vertices[0] * vertices[1] + vertices[0];
6639371c9d4SSatish Balay         cone[3] = voffset + vertices[0];
6649566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
665c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerLeft));
666c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerLeft));
667c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerLeft));
668c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[1] + 0, markerLeft));
669c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + vertices[0], markerLeft));
6707b59f5a9SMichael Lange         iface++;
6717b59f5a9SMichael Lange       }
6727b59f5a9SMichael Lange     }
6737b59f5a9SMichael Lange 
6747b59f5a9SMichael Lange     /* Side 5 (Right) */
6757b59f5a9SMichael Lange     for (vz = 0; vz < faces[2]; vz++) {
6767b59f5a9SMichael Lange       for (vy = 0; vy < faces[1]; vy++) {
677aab5bcd8SJed Brown         voffset = numFaces + vz * vertices[0] * vertices[1] + vy * vertices[0] + faces[0];
6789371c9d4SSatish Balay         cone[0] = voffset + vertices[0] * vertices[1];
6799371c9d4SSatish Balay         cone[1] = voffset;
6809371c9d4SSatish Balay         cone[2] = voffset + vertices[0];
6819371c9d4SSatish Balay         cone[3] = voffset + vertices[0] * vertices[1] + vertices[0];
6829566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, iface, cone));
683c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", iface, markerRight));
684c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + 0, markerRight));
685c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] + 0, markerRight));
686c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + 0, markerRight));
687c2df9bbfSMatthew G. Knepley         PetscCall(DMSetLabelValue(dm, "marker", voffset + vertices[0] * vertices[1] + vertices[0], markerRight));
6887b59f5a9SMichael Lange         iface++;
6897b59f5a9SMichael Lange       }
690552f7358SJed Brown     }
691552f7358SJed Brown   }
6929566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
6939566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
694552f7358SJed Brown   /* Build coordinates */
6959566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, 3));
6969566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
6979566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
6989566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, numFaces, numFaces + numVertices));
6999566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, 3));
700552f7358SJed Brown   for (v = numFaces; v < numFaces + numVertices; ++v) {
7019566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, 3));
7029566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, 3));
703552f7358SJed Brown   }
7049566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
7059566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
7069566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
7079566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
7089566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
7099566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, 3));
7109566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
7119566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
712552f7358SJed Brown   for (vz = 0; vz <= faces[2]; ++vz) {
713552f7358SJed Brown     for (vy = 0; vy <= faces[1]; ++vy) {
714552f7358SJed Brown       for (vx = 0; vx <= faces[0]; ++vx) {
715552f7358SJed Brown         coords[((vz * (faces[1] + 1) + vy) * (faces[0] + 1) + vx) * 3 + 0] = lower[0] + ((upper[0] - lower[0]) / faces[0]) * vx;
716552f7358SJed Brown         coords[((vz * (faces[1] + 1) + vy) * (faces[0] + 1) + vx) * 3 + 1] = lower[1] + ((upper[1] - lower[1]) / faces[1]) * vy;
717552f7358SJed Brown         coords[((vz * (faces[1] + 1) + vy) * (faces[0] + 1) + vx) * 3 + 2] = lower[2] + ((upper[2] - lower[2]) / faces[2]) * vz;
718552f7358SJed Brown       }
719552f7358SJed Brown     }
720552f7358SJed Brown   }
7219566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
7229566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
7239566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
7243ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
725552f7358SJed Brown }
726552f7358SJed Brown 
727d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxSurfaceMesh_Internal(DM dm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], PetscBool interpolate)
728d71ae5a4SJacob Faibussowitsch {
7299318fe57SMatthew G. Knepley   PetscFunctionBegin;
7309318fe57SMatthew G. Knepley   PetscValidLogicalCollectiveInt(dm, dim, 2);
73146139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
7329566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim - 1));
7339566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, dim));
7349318fe57SMatthew G. Knepley   switch (dim) {
735d71ae5a4SJacob Faibussowitsch   case 1:
736d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexCreateBoxSurfaceMesh_Tensor_1D_Internal(dm, lower, upper, faces));
737d71ae5a4SJacob Faibussowitsch     break;
738d71ae5a4SJacob Faibussowitsch   case 2:
739d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexCreateBoxSurfaceMesh_Tensor_2D_Internal(dm, lower, upper, faces));
740d71ae5a4SJacob Faibussowitsch     break;
741d71ae5a4SJacob Faibussowitsch   case 3:
742d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexCreateBoxSurfaceMesh_Tensor_3D_Internal(dm, lower, upper, faces));
743d71ae5a4SJacob Faibussowitsch     break;
744d71ae5a4SJacob Faibussowitsch   default:
745d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Dimension not supported: %" PetscInt_FMT, dim);
7469318fe57SMatthew G. Knepley   }
74746139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
7489566063dSJacob Faibussowitsch   if (interpolate) PetscCall(DMPlexInterpolateInPlace_Internal(dm));
7493ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
7509318fe57SMatthew G. Knepley }
7519318fe57SMatthew G. Knepley 
7529318fe57SMatthew G. Knepley /*@C
7539318fe57SMatthew G. Knepley   DMPlexCreateBoxSurfaceMesh - Creates a mesh on the surface of the tensor product of unit intervals (box) using tensor cells (hexahedra).
7549318fe57SMatthew G. Knepley 
7559318fe57SMatthew G. Knepley   Collective
7569318fe57SMatthew G. Knepley 
7579318fe57SMatthew G. Knepley   Input Parameters:
758a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
75920f4b53cSBarry Smith . dim         - The spatial dimension of the box, so the resulting mesh is has dimension `dim`-1
76020f4b53cSBarry Smith . faces       - Number of faces per dimension, or `NULL` for (1,) in 1D and (2, 2) in 2D and (1, 1, 1) in 3D
76120f4b53cSBarry Smith . lower       - The lower left corner, or `NULL` for (0, 0, 0)
76220f4b53cSBarry Smith . upper       - The upper right corner, or `NULL` for (1, 1, 1)
7639318fe57SMatthew G. Knepley - interpolate - Flag to create intermediate mesh pieces (edges, faces)
7649318fe57SMatthew G. Knepley 
7659318fe57SMatthew G. Knepley   Output Parameter:
766a1cb98faSBarry Smith . dm - The `DM` object
7679318fe57SMatthew G. Knepley 
7689318fe57SMatthew G. Knepley   Level: beginner
7699318fe57SMatthew G. Knepley 
7701cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMSetFromOptions()`, `DMPlexCreateBoxMesh()`, `DMPlexCreateFromFile()`, `DMSetType()`, `DMCreate()`
7719318fe57SMatthew G. Knepley @*/
772d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateBoxSurfaceMesh(MPI_Comm comm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], PetscBool interpolate, DM *dm)
773d71ae5a4SJacob Faibussowitsch {
7749318fe57SMatthew G. Knepley   PetscInt  fac[3] = {1, 1, 1};
7759318fe57SMatthew G. Knepley   PetscReal low[3] = {0, 0, 0};
7769318fe57SMatthew G. Knepley   PetscReal upp[3] = {1, 1, 1};
7779318fe57SMatthew G. Knepley 
7789318fe57SMatthew G. Knepley   PetscFunctionBegin;
7799566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
7809566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
7819566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBoxSurfaceMesh_Internal(*dm, dim, faces ? faces : fac, lower ? lower : low, upper ? upper : upp, interpolate));
7823ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
7839318fe57SMatthew G. Knepley }
7849318fe57SMatthew G. Knepley 
785d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateLineMesh_Internal(DM dm, PetscInt segments, PetscReal lower, PetscReal upper, DMBoundaryType bd)
786d71ae5a4SJacob Faibussowitsch {
787fdbf62faSLisandro Dalcin   PetscInt     i, fStart, fEnd, numCells = 0, numVerts = 0;
788fdbf62faSLisandro Dalcin   PetscInt     numPoints[2], *coneSize, *cones, *coneOrientations;
789fdbf62faSLisandro Dalcin   PetscScalar *vertexCoords;
790fdbf62faSLisandro Dalcin   PetscReal    L, maxCell;
791fdbf62faSLisandro Dalcin   PetscBool    markerSeparate = PETSC_FALSE;
792fdbf62faSLisandro Dalcin   PetscInt     markerLeft = 1, faceMarkerLeft = 1;
793fdbf62faSLisandro Dalcin   PetscInt     markerRight = 1, faceMarkerRight = 2;
794fdbf62faSLisandro Dalcin   PetscBool    wrap = (bd == DM_BOUNDARY_PERIODIC || bd == DM_BOUNDARY_TWIST) ? PETSC_TRUE : PETSC_FALSE;
795fdbf62faSLisandro Dalcin   PetscMPIInt  rank;
796fdbf62faSLisandro Dalcin 
797fdbf62faSLisandro Dalcin   PetscFunctionBegin;
7984f572ea9SToby Isaac   PetscAssertPointer(dm, 1);
799fdbf62faSLisandro Dalcin 
8009566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, 1));
8019566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "marker"));
8029566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "Face Sets"));
803fdbf62faSLisandro Dalcin 
8049566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
805dd400576SPatrick Sanan   if (rank == 0) numCells = segments;
806dd400576SPatrick Sanan   if (rank == 0) numVerts = segments + (wrap ? 0 : 1);
807fdbf62faSLisandro Dalcin 
8089371c9d4SSatish Balay   numPoints[0] = numVerts;
8099371c9d4SSatish Balay   numPoints[1] = numCells;
8109566063dSJacob Faibussowitsch   PetscCall(PetscMalloc4(numCells + numVerts, &coneSize, numCells * 2, &cones, numCells + numVerts, &coneOrientations, numVerts, &vertexCoords));
8119566063dSJacob Faibussowitsch   PetscCall(PetscArrayzero(coneOrientations, numCells + numVerts));
812ad540459SPierre Jolivet   for (i = 0; i < numCells; ++i) coneSize[i] = 2;
813ad540459SPierre Jolivet   for (i = 0; i < numVerts; ++i) coneSize[numCells + i] = 0;
8149371c9d4SSatish Balay   for (i = 0; i < numCells; ++i) {
8159371c9d4SSatish Balay     cones[2 * i]     = numCells + i % numVerts;
8169371c9d4SSatish Balay     cones[2 * i + 1] = numCells + (i + 1) % numVerts;
8179371c9d4SSatish Balay   }
818ad540459SPierre Jolivet   for (i = 0; i < numVerts; ++i) vertexCoords[i] = lower + (upper - lower) * ((PetscReal)i / (PetscReal)numCells);
8199566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateFromDAG(dm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
8209566063dSJacob Faibussowitsch   PetscCall(PetscFree4(coneSize, cones, coneOrientations, vertexCoords));
821fdbf62faSLisandro Dalcin 
8229566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
8239371c9d4SSatish Balay   if (markerSeparate) {
8249371c9d4SSatish Balay     markerLeft  = faceMarkerLeft;
8259371c9d4SSatish Balay     markerRight = faceMarkerRight;
8269371c9d4SSatish Balay   }
827dd400576SPatrick Sanan   if (!wrap && rank == 0) {
8289566063dSJacob Faibussowitsch     PetscCall(DMPlexGetHeightStratum(dm, 1, &fStart, &fEnd));
8299566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", fStart, markerLeft));
8309566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "marker", fEnd - 1, markerRight));
8319566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "Face Sets", fStart, faceMarkerLeft));
8329566063dSJacob Faibussowitsch     PetscCall(DMSetLabelValue(dm, "Face Sets", fEnd - 1, faceMarkerRight));
833fdbf62faSLisandro Dalcin   }
834fdbf62faSLisandro Dalcin   if (wrap) {
835fdbf62faSLisandro Dalcin     L       = upper - lower;
836fdbf62faSLisandro Dalcin     maxCell = (PetscReal)1.1 * (L / (PetscReal)PetscMax(1, segments));
8374fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dm, &maxCell, &lower, &L));
838fdbf62faSLisandro Dalcin   }
8399566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
8403ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
841fdbf62faSLisandro Dalcin }
842fdbf62faSLisandro Dalcin 
843d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxMesh_Simplex_Internal(DM dm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[], PetscBool interpolate)
844d71ae5a4SJacob Faibussowitsch {
8459318fe57SMatthew G. Knepley   DM      boundary, vol;
846c22d3578SMatthew G. Knepley   DMLabel bdlabel;
847d6218766SMatthew G. Knepley 
848d6218766SMatthew G. Knepley   PetscFunctionBegin;
8494f572ea9SToby Isaac   PetscAssertPointer(dm, 1);
850c22d3578SMatthew 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");
8519566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &boundary));
8529566063dSJacob Faibussowitsch   PetscCall(DMSetType(boundary, DMPLEX));
8539566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBoxSurfaceMesh_Internal(boundary, dim, faces, lower, upper, PETSC_FALSE));
8549566063dSJacob Faibussowitsch   PetscCall(DMPlexGenerate(boundary, NULL, interpolate, &vol));
855c22d3578SMatthew G. Knepley   PetscCall(DMGetLabel(vol, "marker", &bdlabel));
856c22d3578SMatthew G. Knepley   if (bdlabel) PetscCall(DMPlexLabelComplete(vol, bdlabel));
8575de52c6dSVaclav Hapla   PetscCall(DMPlexCopy_Internal(dm, PETSC_TRUE, PETSC_FALSE, vol));
85869d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
8599566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&boundary));
8603ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
861d6218766SMatthew G. Knepley }
862d6218766SMatthew G. Knepley 
863d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateCubeMesh_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[], DMBoundaryType bdX, DMBoundaryType bdY, DMBoundaryType bdZ)
864d71ae5a4SJacob Faibussowitsch {
865ed0e4b50SMatthew G. Knepley   DMLabel     cutLabel  = NULL;
866f4eb4c5dSMatthew G. Knepley   PetscInt    markerTop = 1, faceMarkerTop = 1;
867f4eb4c5dSMatthew G. Knepley   PetscInt    markerBottom = 1, faceMarkerBottom = 1;
868f4eb4c5dSMatthew G. Knepley   PetscInt    markerFront = 1, faceMarkerFront = 1;
869f4eb4c5dSMatthew G. Knepley   PetscInt    markerBack = 1, faceMarkerBack = 1;
870f4eb4c5dSMatthew G. Knepley   PetscInt    markerRight = 1, faceMarkerRight = 1;
871f4eb4c5dSMatthew G. Knepley   PetscInt    markerLeft = 1, faceMarkerLeft = 1;
8723dfda0b1SToby Isaac   PetscInt    dim;
873d8211ee3SMatthew G. Knepley   PetscBool   markerSeparate = PETSC_FALSE, cutMarker = PETSC_FALSE;
8743dfda0b1SToby Isaac   PetscMPIInt rank;
8753dfda0b1SToby Isaac 
8763dfda0b1SToby Isaac   PetscFunctionBegin;
8779566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
8789566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
8799566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "marker"));
8809566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "Face Sets"));
8819566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_periodic_cut", &cutMarker, NULL));
8829371c9d4SSatish 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) {
8839371c9d4SSatish Balay     if (cutMarker) {
8849371c9d4SSatish Balay       PetscCall(DMCreateLabel(dm, "periodic_cut"));
8859371c9d4SSatish Balay       PetscCall(DMGetLabel(dm, "periodic_cut", &cutLabel));
8869371c9d4SSatish Balay     }
887d8211ee3SMatthew G. Knepley   }
8883dfda0b1SToby Isaac   switch (dim) {
8893dfda0b1SToby Isaac   case 2:
890f4eb4c5dSMatthew G. Knepley     faceMarkerTop    = 3;
891f4eb4c5dSMatthew G. Knepley     faceMarkerBottom = 1;
892f4eb4c5dSMatthew G. Knepley     faceMarkerRight  = 2;
893f4eb4c5dSMatthew G. Knepley     faceMarkerLeft   = 4;
8943dfda0b1SToby Isaac     break;
8953dfda0b1SToby Isaac   case 3:
896f4eb4c5dSMatthew G. Knepley     faceMarkerBottom = 1;
897f4eb4c5dSMatthew G. Knepley     faceMarkerTop    = 2;
898f4eb4c5dSMatthew G. Knepley     faceMarkerFront  = 3;
899f4eb4c5dSMatthew G. Knepley     faceMarkerBack   = 4;
900f4eb4c5dSMatthew G. Knepley     faceMarkerRight  = 5;
901f4eb4c5dSMatthew G. Knepley     faceMarkerLeft   = 6;
9023dfda0b1SToby Isaac     break;
903d71ae5a4SJacob Faibussowitsch   default:
904d71ae5a4SJacob Faibussowitsch     SETERRQ(PETSC_COMM_SELF, PETSC_ERR_SUP, "Dimension %" PetscInt_FMT " not supported", dim);
9053dfda0b1SToby Isaac   }
9069566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
907f4eb4c5dSMatthew G. Knepley   if (markerSeparate) {
908f4eb4c5dSMatthew G. Knepley     markerBottom = faceMarkerBottom;
909f4eb4c5dSMatthew G. Knepley     markerTop    = faceMarkerTop;
910f4eb4c5dSMatthew G. Knepley     markerFront  = faceMarkerFront;
911f4eb4c5dSMatthew G. Knepley     markerBack   = faceMarkerBack;
912f4eb4c5dSMatthew G. Knepley     markerRight  = faceMarkerRight;
913f4eb4c5dSMatthew G. Knepley     markerLeft   = faceMarkerLeft;
9143dfda0b1SToby Isaac   }
9153dfda0b1SToby Isaac   {
916dd400576SPatrick Sanan     const PetscInt numXEdges    = rank == 0 ? edges[0] : 0;
917dd400576SPatrick Sanan     const PetscInt numYEdges    = rank == 0 ? edges[1] : 0;
918dd400576SPatrick Sanan     const PetscInt numZEdges    = rank == 0 ? edges[2] : 0;
919dd400576SPatrick Sanan     const PetscInt numXVertices = rank == 0 ? (bdX == DM_BOUNDARY_PERIODIC || bdX == DM_BOUNDARY_TWIST ? edges[0] : edges[0] + 1) : 0;
920dd400576SPatrick Sanan     const PetscInt numYVertices = rank == 0 ? (bdY == DM_BOUNDARY_PERIODIC || bdY == DM_BOUNDARY_TWIST ? edges[1] : edges[1] + 1) : 0;
921dd400576SPatrick Sanan     const PetscInt numZVertices = rank == 0 ? (bdZ == DM_BOUNDARY_PERIODIC || bdZ == DM_BOUNDARY_TWIST ? edges[2] : edges[2] + 1) : 0;
9223dfda0b1SToby Isaac     const PetscInt numCells     = numXEdges * numYEdges * numZEdges;
9233dfda0b1SToby Isaac     const PetscInt numXFaces    = numYEdges * numZEdges;
9243dfda0b1SToby Isaac     const PetscInt numYFaces    = numXEdges * numZEdges;
9253dfda0b1SToby Isaac     const PetscInt numZFaces    = numXEdges * numYEdges;
9263dfda0b1SToby Isaac     const PetscInt numTotXFaces = numXVertices * numXFaces;
9273dfda0b1SToby Isaac     const PetscInt numTotYFaces = numYVertices * numYFaces;
9283dfda0b1SToby Isaac     const PetscInt numTotZFaces = numZVertices * numZFaces;
9293dfda0b1SToby Isaac     const PetscInt numFaces     = numTotXFaces + numTotYFaces + numTotZFaces;
9303dfda0b1SToby Isaac     const PetscInt numTotXEdges = numXEdges * numYVertices * numZVertices;
9313dfda0b1SToby Isaac     const PetscInt numTotYEdges = numYEdges * numXVertices * numZVertices;
9323dfda0b1SToby Isaac     const PetscInt numTotZEdges = numZEdges * numXVertices * numYVertices;
9333dfda0b1SToby Isaac     const PetscInt numVertices  = numXVertices * numYVertices * numZVertices;
9343dfda0b1SToby Isaac     const PetscInt numEdges     = numTotXEdges + numTotYEdges + numTotZEdges;
9353dfda0b1SToby Isaac     const PetscInt firstVertex  = (dim == 2) ? numFaces : numCells;
9363dfda0b1SToby Isaac     const PetscInt firstXFace   = (dim == 2) ? 0 : numCells + numVertices;
9373dfda0b1SToby Isaac     const PetscInt firstYFace   = firstXFace + numTotXFaces;
9383dfda0b1SToby Isaac     const PetscInt firstZFace   = firstYFace + numTotYFaces;
9393dfda0b1SToby Isaac     const PetscInt firstXEdge   = numCells + numFaces + numVertices;
9403dfda0b1SToby Isaac     const PetscInt firstYEdge   = firstXEdge + numTotXEdges;
9413dfda0b1SToby Isaac     const PetscInt firstZEdge   = firstYEdge + numTotYEdges;
9423dfda0b1SToby Isaac     Vec            coordinates;
9433dfda0b1SToby Isaac     PetscSection   coordSection;
9443dfda0b1SToby Isaac     PetscScalar   *coords;
9453dfda0b1SToby Isaac     PetscInt       coordSize;
9463dfda0b1SToby Isaac     PetscInt       v, vx, vy, vz;
9473dfda0b1SToby Isaac     PetscInt       c, f, fx, fy, fz, e, ex, ey, ez;
9483dfda0b1SToby Isaac 
9499566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numCells + numFaces + numEdges + numVertices));
95048a46eb9SPierre Jolivet     for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 6));
95148a46eb9SPierre Jolivet     for (f = firstXFace; f < firstXFace + numFaces; ++f) PetscCall(DMPlexSetConeSize(dm, f, 4));
95248a46eb9SPierre Jolivet     for (e = firstXEdge; e < firstXEdge + numEdges; ++e) PetscCall(DMPlexSetConeSize(dm, e, 2));
9539566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
9543dfda0b1SToby Isaac     /* Build cells */
9553dfda0b1SToby Isaac     for (fz = 0; fz < numZEdges; ++fz) {
9563dfda0b1SToby Isaac       for (fy = 0; fy < numYEdges; ++fy) {
9573dfda0b1SToby Isaac         for (fx = 0; fx < numXEdges; ++fx) {
9583dfda0b1SToby Isaac           PetscInt cell  = (fz * numYEdges + fy) * numXEdges + fx;
9593dfda0b1SToby Isaac           PetscInt faceB = firstZFace + (fy * numXEdges + fx) * numZVertices + fz;
9603dfda0b1SToby Isaac           PetscInt faceT = firstZFace + (fy * numXEdges + fx) * numZVertices + ((fz + 1) % numZVertices);
9613dfda0b1SToby Isaac           PetscInt faceF = firstYFace + (fz * numXEdges + fx) * numYVertices + fy;
9623dfda0b1SToby Isaac           PetscInt faceK = firstYFace + (fz * numXEdges + fx) * numYVertices + ((fy + 1) % numYVertices);
9633dfda0b1SToby Isaac           PetscInt faceL = firstXFace + (fz * numYEdges + fy) * numXVertices + fx;
9643dfda0b1SToby Isaac           PetscInt faceR = firstXFace + (fz * numYEdges + fy) * numXVertices + ((fx + 1) % numXVertices);
9653dfda0b1SToby Isaac           /* B,  T,  F,  K,  R,  L */
966b5a892a1SMatthew G. Knepley           PetscInt ornt[6] = {-2, 0, 0, -3, 0, -2}; /* ??? */
96742206facSLisandro Dalcin           PetscInt cone[6];
9683dfda0b1SToby Isaac 
9693dfda0b1SToby Isaac           /* no boundary twisting in 3D */
9709371c9d4SSatish Balay           cone[0] = faceB;
9719371c9d4SSatish Balay           cone[1] = faceT;
9729371c9d4SSatish Balay           cone[2] = faceF;
9739371c9d4SSatish Balay           cone[3] = faceK;
9749371c9d4SSatish Balay           cone[4] = faceR;
9759371c9d4SSatish Balay           cone[5] = faceL;
9769566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, cell, cone));
9779566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, cell, ornt));
9789566063dSJacob Faibussowitsch           if (bdX != DM_BOUNDARY_NONE && fx == numXEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, cell, 2));
9799566063dSJacob Faibussowitsch           if (bdY != DM_BOUNDARY_NONE && fy == numYEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, cell, 2));
9809566063dSJacob Faibussowitsch           if (bdZ != DM_BOUNDARY_NONE && fz == numZEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, cell, 2));
9813dfda0b1SToby Isaac         }
9823dfda0b1SToby Isaac       }
9833dfda0b1SToby Isaac     }
9843dfda0b1SToby Isaac     /* Build x faces */
9853dfda0b1SToby Isaac     for (fz = 0; fz < numZEdges; ++fz) {
9863dfda0b1SToby Isaac       for (fy = 0; fy < numYEdges; ++fy) {
9873dfda0b1SToby Isaac         for (fx = 0; fx < numXVertices; ++fx) {
9883dfda0b1SToby Isaac           PetscInt face    = firstXFace + (fz * numYEdges + fy) * numXVertices + fx;
9893dfda0b1SToby Isaac           PetscInt edgeL   = firstZEdge + (fy * numXVertices + fx) * numZEdges + fz;
9903dfda0b1SToby Isaac           PetscInt edgeR   = firstZEdge + (((fy + 1) % numYVertices) * numXVertices + fx) * numZEdges + fz;
9913dfda0b1SToby Isaac           PetscInt edgeB   = firstYEdge + (fz * numXVertices + fx) * numYEdges + fy;
9923dfda0b1SToby Isaac           PetscInt edgeT   = firstYEdge + (((fz + 1) % numZVertices) * numXVertices + fx) * numYEdges + fy;
993b5a892a1SMatthew G. Knepley           PetscInt ornt[4] = {0, 0, -1, -1};
9943dfda0b1SToby Isaac           PetscInt cone[4];
9953dfda0b1SToby Isaac 
9963dfda0b1SToby Isaac           if (dim == 3) {
9973dfda0b1SToby Isaac             /* markers */
9983dfda0b1SToby Isaac             if (bdX != DM_BOUNDARY_PERIODIC) {
9993dfda0b1SToby Isaac               if (fx == numXVertices - 1) {
10009566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerRight));
10019566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerRight));
10029371c9d4SSatish Balay               } else if (fx == 0) {
10039566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerLeft));
10049566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerLeft));
10053dfda0b1SToby Isaac               }
10063dfda0b1SToby Isaac             }
10073dfda0b1SToby Isaac           }
10089371c9d4SSatish Balay           cone[0] = edgeB;
10099371c9d4SSatish Balay           cone[1] = edgeR;
10109371c9d4SSatish Balay           cone[2] = edgeT;
10119371c9d4SSatish Balay           cone[3] = edgeL;
10129566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, face, cone));
10139566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, face, ornt));
10143dfda0b1SToby Isaac         }
10153dfda0b1SToby Isaac       }
10163dfda0b1SToby Isaac     }
10173dfda0b1SToby Isaac     /* Build y faces */
10183dfda0b1SToby Isaac     for (fz = 0; fz < numZEdges; ++fz) {
101942206facSLisandro Dalcin       for (fx = 0; fx < numXEdges; ++fx) {
10203dfda0b1SToby Isaac         for (fy = 0; fy < numYVertices; ++fy) {
10213dfda0b1SToby Isaac           PetscInt face    = firstYFace + (fz * numXEdges + fx) * numYVertices + fy;
10223dfda0b1SToby Isaac           PetscInt edgeL   = firstZEdge + (fy * numXVertices + fx) * numZEdges + fz;
10233dfda0b1SToby Isaac           PetscInt edgeR   = firstZEdge + (fy * numXVertices + ((fx + 1) % numXVertices)) * numZEdges + fz;
10243dfda0b1SToby Isaac           PetscInt edgeB   = firstXEdge + (fz * numYVertices + fy) * numXEdges + fx;
10253dfda0b1SToby Isaac           PetscInt edgeT   = firstXEdge + (((fz + 1) % numZVertices) * numYVertices + fy) * numXEdges + fx;
1026b5a892a1SMatthew G. Knepley           PetscInt ornt[4] = {0, 0, -1, -1};
10273dfda0b1SToby Isaac           PetscInt cone[4];
10283dfda0b1SToby Isaac 
10293dfda0b1SToby Isaac           if (dim == 3) {
10303dfda0b1SToby Isaac             /* markers */
10313dfda0b1SToby Isaac             if (bdY != DM_BOUNDARY_PERIODIC) {
10323dfda0b1SToby Isaac               if (fy == numYVertices - 1) {
10339566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerBack));
10349566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerBack));
10359371c9d4SSatish Balay               } else if (fy == 0) {
10369566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerFront));
10379566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerFront));
10383dfda0b1SToby Isaac               }
10393dfda0b1SToby Isaac             }
10403dfda0b1SToby Isaac           }
10419371c9d4SSatish Balay           cone[0] = edgeB;
10429371c9d4SSatish Balay           cone[1] = edgeR;
10439371c9d4SSatish Balay           cone[2] = edgeT;
10449371c9d4SSatish Balay           cone[3] = edgeL;
10459566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, face, cone));
10469566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, face, ornt));
10473dfda0b1SToby Isaac         }
10483dfda0b1SToby Isaac       }
10493dfda0b1SToby Isaac     }
10503dfda0b1SToby Isaac     /* Build z faces */
10513dfda0b1SToby Isaac     for (fy = 0; fy < numYEdges; ++fy) {
10523dfda0b1SToby Isaac       for (fx = 0; fx < numXEdges; ++fx) {
10533dfda0b1SToby Isaac         for (fz = 0; fz < numZVertices; fz++) {
10543dfda0b1SToby Isaac           PetscInt face    = firstZFace + (fy * numXEdges + fx) * numZVertices + fz;
10553dfda0b1SToby Isaac           PetscInt edgeL   = firstYEdge + (fz * numXVertices + fx) * numYEdges + fy;
10563dfda0b1SToby Isaac           PetscInt edgeR   = firstYEdge + (fz * numXVertices + ((fx + 1) % numXVertices)) * numYEdges + fy;
10573dfda0b1SToby Isaac           PetscInt edgeB   = firstXEdge + (fz * numYVertices + fy) * numXEdges + fx;
10583dfda0b1SToby Isaac           PetscInt edgeT   = firstXEdge + (fz * numYVertices + ((fy + 1) % numYVertices)) * numXEdges + fx;
1059b5a892a1SMatthew G. Knepley           PetscInt ornt[4] = {0, 0, -1, -1};
10603dfda0b1SToby Isaac           PetscInt cone[4];
10613dfda0b1SToby Isaac 
10623dfda0b1SToby Isaac           if (dim == 2) {
10639371c9d4SSatish Balay             if (bdX == DM_BOUNDARY_TWIST && fx == numXEdges - 1) {
10649371c9d4SSatish Balay               edgeR += numYEdges - 1 - 2 * fy;
10659371c9d4SSatish Balay               ornt[1] = -1;
10669371c9d4SSatish Balay             }
10679371c9d4SSatish Balay             if (bdY == DM_BOUNDARY_TWIST && fy == numYEdges - 1) {
10689371c9d4SSatish Balay               edgeT += numXEdges - 1 - 2 * fx;
10699371c9d4SSatish Balay               ornt[2] = 0;
10709371c9d4SSatish Balay             }
10719566063dSJacob Faibussowitsch             if (bdX != DM_BOUNDARY_NONE && fx == numXEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, face, 2));
10729566063dSJacob Faibussowitsch             if (bdY != DM_BOUNDARY_NONE && fy == numYEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, face, 2));
1073d1c88043SMatthew G. Knepley           } else {
10743dfda0b1SToby Isaac             /* markers */
10753dfda0b1SToby Isaac             if (bdZ != DM_BOUNDARY_PERIODIC) {
10763dfda0b1SToby Isaac               if (fz == numZVertices - 1) {
10779566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerTop));
10789566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerTop));
10799371c9d4SSatish Balay               } else if (fz == 0) {
10809566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerBottom));
10819566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerBottom));
10823dfda0b1SToby Isaac               }
10833dfda0b1SToby Isaac             }
10843dfda0b1SToby Isaac           }
10859371c9d4SSatish Balay           cone[0] = edgeB;
10869371c9d4SSatish Balay           cone[1] = edgeR;
10879371c9d4SSatish Balay           cone[2] = edgeT;
10889371c9d4SSatish Balay           cone[3] = edgeL;
10899566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, face, cone));
10909566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, face, ornt));
10913dfda0b1SToby Isaac         }
10923dfda0b1SToby Isaac       }
10933dfda0b1SToby Isaac     }
10943dfda0b1SToby Isaac     /* Build Z edges*/
10953dfda0b1SToby Isaac     for (vy = 0; vy < numYVertices; vy++) {
10963dfda0b1SToby Isaac       for (vx = 0; vx < numXVertices; vx++) {
10973dfda0b1SToby Isaac         for (ez = 0; ez < numZEdges; ez++) {
10983dfda0b1SToby Isaac           const PetscInt edge    = firstZEdge + (vy * numXVertices + vx) * numZEdges + ez;
10993dfda0b1SToby Isaac           const PetscInt vertexB = firstVertex + (ez * numYVertices + vy) * numXVertices + vx;
11003dfda0b1SToby Isaac           const PetscInt vertexT = firstVertex + (((ez + 1) % numZVertices) * numYVertices + vy) * numXVertices + vx;
11013dfda0b1SToby Isaac           PetscInt       cone[2];
11023dfda0b1SToby Isaac 
11039371c9d4SSatish Balay           cone[0] = vertexB;
11049371c9d4SSatish Balay           cone[1] = vertexT;
1105c2df9bbfSMatthew G. Knepley           PetscCall(DMPlexSetCone(dm, edge, cone));
11063dfda0b1SToby Isaac           if (dim == 3) {
11073dfda0b1SToby Isaac             if (bdX != DM_BOUNDARY_PERIODIC) {
11083dfda0b1SToby Isaac               if (vx == numXVertices - 1) {
11099566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
1110c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
1111c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
1112c2df9bbfSMatthew G. Knepley               } else if (vx == 0) {
11139566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
1114c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
1115c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
11163dfda0b1SToby Isaac               }
11173dfda0b1SToby Isaac             }
11183dfda0b1SToby Isaac             if (bdY != DM_BOUNDARY_PERIODIC) {
11193dfda0b1SToby Isaac               if (vy == numYVertices - 1) {
11209566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBack));
1121c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBack));
1122c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBack));
1123c2df9bbfSMatthew G. Knepley               } else if (vy == 0) {
11249566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerFront));
1125c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerFront));
1126c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerFront));
11273dfda0b1SToby Isaac               }
11283dfda0b1SToby Isaac             }
11293dfda0b1SToby Isaac           }
11303dfda0b1SToby Isaac         }
11313dfda0b1SToby Isaac       }
11323dfda0b1SToby Isaac     }
11333dfda0b1SToby Isaac     /* Build Y edges*/
11343dfda0b1SToby Isaac     for (vz = 0; vz < numZVertices; vz++) {
11353dfda0b1SToby Isaac       for (vx = 0; vx < numXVertices; vx++) {
11363dfda0b1SToby Isaac         for (ey = 0; ey < numYEdges; ey++) {
11373dfda0b1SToby Isaac           const PetscInt nextv   = (dim == 2 && bdY == DM_BOUNDARY_TWIST && ey == numYEdges - 1) ? (numXVertices - vx - 1) : (vz * numYVertices + ((ey + 1) % numYVertices)) * numXVertices + vx;
11383dfda0b1SToby Isaac           const PetscInt edge    = firstYEdge + (vz * numXVertices + vx) * numYEdges + ey;
11393dfda0b1SToby Isaac           const PetscInt vertexF = firstVertex + (vz * numYVertices + ey) * numXVertices + vx;
11403dfda0b1SToby Isaac           const PetscInt vertexK = firstVertex + nextv;
11413dfda0b1SToby Isaac           PetscInt       cone[2];
11423dfda0b1SToby Isaac 
11439371c9d4SSatish Balay           cone[0] = vertexF;
11449371c9d4SSatish Balay           cone[1] = vertexK;
11459566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, edge, cone));
11463dfda0b1SToby Isaac           if (dim == 2) {
11473dfda0b1SToby Isaac             if ((bdX != DM_BOUNDARY_PERIODIC) && (bdX != DM_BOUNDARY_TWIST)) {
11483dfda0b1SToby Isaac               if (vx == numXVertices - 1) {
11499566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerRight));
11509566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
11519566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
1152c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
1153d8211ee3SMatthew G. Knepley               } else if (vx == 0) {
11549566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerLeft));
11559566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
11569566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
1157c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
11583dfda0b1SToby Isaac               }
1159d8211ee3SMatthew G. Knepley             } else {
11604c67ea77SStefano Zampini               if (vx == 0 && cutLabel) {
11619566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, edge, 1));
11629566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, cone[0], 1));
1163c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMLabelSetValue(cutLabel, cone[1], 1));
11643dfda0b1SToby Isaac               }
1165d8211ee3SMatthew G. Knepley             }
1166d8211ee3SMatthew G. Knepley           } else {
11673dfda0b1SToby Isaac             if (bdX != DM_BOUNDARY_PERIODIC) {
11683dfda0b1SToby Isaac               if (vx == numXVertices - 1) {
11699566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
1170c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
1171c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
1172d8211ee3SMatthew G. Knepley               } else if (vx == 0) {
11739566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
1174c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
1175c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
11763dfda0b1SToby Isaac               }
11773dfda0b1SToby Isaac             }
11783dfda0b1SToby Isaac             if (bdZ != DM_BOUNDARY_PERIODIC) {
11793dfda0b1SToby Isaac               if (vz == numZVertices - 1) {
11809566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
1181c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
1182c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
1183d8211ee3SMatthew G. Knepley               } else if (vz == 0) {
11849566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
1185c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
1186c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
11873dfda0b1SToby Isaac               }
11883dfda0b1SToby Isaac             }
11893dfda0b1SToby Isaac           }
11903dfda0b1SToby Isaac         }
11913dfda0b1SToby Isaac       }
11923dfda0b1SToby Isaac     }
11933dfda0b1SToby Isaac     /* Build X edges*/
11943dfda0b1SToby Isaac     for (vz = 0; vz < numZVertices; vz++) {
11953dfda0b1SToby Isaac       for (vy = 0; vy < numYVertices; vy++) {
11963dfda0b1SToby Isaac         for (ex = 0; ex < numXEdges; ex++) {
11973dfda0b1SToby Isaac           const PetscInt nextv   = (dim == 2 && bdX == DM_BOUNDARY_TWIST && ex == numXEdges - 1) ? (numYVertices - vy - 1) * numXVertices : (vz * numYVertices + vy) * numXVertices + (ex + 1) % numXVertices;
11983dfda0b1SToby Isaac           const PetscInt edge    = firstXEdge + (vz * numYVertices + vy) * numXEdges + ex;
11993dfda0b1SToby Isaac           const PetscInt vertexL = firstVertex + (vz * numYVertices + vy) * numXVertices + ex;
12003dfda0b1SToby Isaac           const PetscInt vertexR = firstVertex + nextv;
12013dfda0b1SToby Isaac           PetscInt       cone[2];
12023dfda0b1SToby Isaac 
12039371c9d4SSatish Balay           cone[0] = vertexL;
12049371c9d4SSatish Balay           cone[1] = vertexR;
12059566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, edge, cone));
12063dfda0b1SToby Isaac           if (dim == 2) {
12073dfda0b1SToby Isaac             if ((bdY != DM_BOUNDARY_PERIODIC) && (bdY != DM_BOUNDARY_TWIST)) {
12083dfda0b1SToby Isaac               if (vy == numYVertices - 1) {
12099566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerTop));
12109566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
12119566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
1212c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
1213d8211ee3SMatthew G. Knepley               } else if (vy == 0) {
12149566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerBottom));
12159566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
12169566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
1217c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
12183dfda0b1SToby Isaac               }
1219d8211ee3SMatthew G. Knepley             } else {
12204c67ea77SStefano Zampini               if (vy == 0 && cutLabel) {
12219566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, edge, 1));
12229566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, cone[0], 1));
1223c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMLabelSetValue(cutLabel, cone[1], 1));
12243dfda0b1SToby Isaac               }
1225d8211ee3SMatthew G. Knepley             }
1226d8211ee3SMatthew G. Knepley           } else {
12273dfda0b1SToby Isaac             if (bdY != DM_BOUNDARY_PERIODIC) {
12283dfda0b1SToby Isaac               if (vy == numYVertices - 1) {
12299566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBack));
1230c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBack));
1231c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBack));
1232c2df9bbfSMatthew G. Knepley               } else if (vy == 0) {
12339566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerFront));
1234c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerFront));
1235c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerFront));
12363dfda0b1SToby Isaac               }
12373dfda0b1SToby Isaac             }
12383dfda0b1SToby Isaac             if (bdZ != DM_BOUNDARY_PERIODIC) {
12393dfda0b1SToby Isaac               if (vz == numZVertices - 1) {
12409566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
1241c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
1242c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
1243c2df9bbfSMatthew G. Knepley               } else if (vz == 0) {
12449566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
1245c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
1246c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
12473dfda0b1SToby Isaac               }
12483dfda0b1SToby Isaac             }
12493dfda0b1SToby Isaac           }
12503dfda0b1SToby Isaac         }
12513dfda0b1SToby Isaac       }
12523dfda0b1SToby Isaac     }
12539566063dSJacob Faibussowitsch     PetscCall(DMPlexSymmetrize(dm));
12549566063dSJacob Faibussowitsch     PetscCall(DMPlexStratify(dm));
12553dfda0b1SToby Isaac     /* Build coordinates */
12569566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &coordSection));
12579566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetNumFields(coordSection, 1));
12589566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
12599566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numVertices));
12603dfda0b1SToby Isaac     for (v = firstVertex; v < firstVertex + numVertices; ++v) {
12619566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetDof(coordSection, v, dim));
12629566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
12633dfda0b1SToby Isaac     }
12649566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetUp(coordSection));
12659566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
12669566063dSJacob Faibussowitsch     PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
12679566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
12689566063dSJacob Faibussowitsch     PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
12699566063dSJacob Faibussowitsch     PetscCall(VecSetBlockSize(coordinates, dim));
12709566063dSJacob Faibussowitsch     PetscCall(VecSetType(coordinates, VECSTANDARD));
12719566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
12723dfda0b1SToby Isaac     for (vz = 0; vz < numZVertices; ++vz) {
12733dfda0b1SToby Isaac       for (vy = 0; vy < numYVertices; ++vy) {
12743dfda0b1SToby Isaac         for (vx = 0; vx < numXVertices; ++vx) {
12753dfda0b1SToby Isaac           coords[((vz * numYVertices + vy) * numXVertices + vx) * dim + 0] = lower[0] + ((upper[0] - lower[0]) / numXEdges) * vx;
12763dfda0b1SToby Isaac           coords[((vz * numYVertices + vy) * numXVertices + vx) * dim + 1] = lower[1] + ((upper[1] - lower[1]) / numYEdges) * vy;
1277ad540459SPierre Jolivet           if (dim == 3) coords[((vz * numYVertices + vy) * numXVertices + vx) * dim + 2] = lower[2] + ((upper[2] - lower[2]) / numZEdges) * vz;
12783dfda0b1SToby Isaac         }
12793dfda0b1SToby Isaac       }
12803dfda0b1SToby Isaac     }
12819566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(coordinates, &coords));
12829566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, coordinates));
12839566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&coordinates));
12843dfda0b1SToby Isaac   }
12853ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
12863dfda0b1SToby Isaac }
12873dfda0b1SToby Isaac 
1288d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxMesh_Tensor_Internal(DM dm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[])
1289d71ae5a4SJacob Faibussowitsch {
12909318fe57SMatthew G. Knepley   DMBoundaryType bdt[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
12919318fe57SMatthew G. Knepley   PetscInt       fac[3] = {0, 0, 0}, d;
1292552f7358SJed Brown 
1293552f7358SJed Brown   PetscFunctionBegin;
12944f572ea9SToby Isaac   PetscAssertPointer(dm, 1);
12959318fe57SMatthew G. Knepley   PetscValidLogicalCollectiveInt(dm, dim, 2);
12969566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
12979371c9d4SSatish Balay   for (d = 0; d < dim; ++d) {
12989371c9d4SSatish Balay     fac[d] = faces[d];
12999371c9d4SSatish Balay     bdt[d] = periodicity[d];
13009371c9d4SSatish Balay   }
13019566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateCubeMesh_Internal(dm, lower, upper, fac, bdt[0], bdt[1], bdt[2]));
13029371c9d4SSatish 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))) {
13036858538eSMatthew G. Knepley     PetscReal L[3]       = {-1., -1., 0.};
13046858538eSMatthew G. Knepley     PetscReal maxCell[3] = {-1., -1., 0.};
1305552f7358SJed Brown 
13069318fe57SMatthew G. Knepley     for (d = 0; d < dim; ++d) {
13076858538eSMatthew G. Knepley       if (periodicity[d] != DM_BOUNDARY_NONE) {
13089318fe57SMatthew G. Knepley         L[d]       = upper[d] - lower[d];
13099318fe57SMatthew G. Knepley         maxCell[d] = 1.1 * (L[d] / PetscMax(1, faces[d]));
1310768d5fceSMatthew G. Knepley       }
13116858538eSMatthew G. Knepley     }
13124fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dm, maxCell, lower, L));
1313768d5fceSMatthew G. Knepley   }
13149566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
13153ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
13169318fe57SMatthew G. Knepley }
13179318fe57SMatthew G. Knepley 
13185dca41c3SJed 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)
1319d71ae5a4SJacob Faibussowitsch {
13209318fe57SMatthew G. Knepley   PetscFunctionBegin;
132146139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
13225dca41c3SJed Brown   if (shape == DM_SHAPE_ZBOX) PetscCall(DMPlexCreateBoxMesh_Tensor_SFC_Internal(dm, dim, faces, lower, upper, periodicity, interpolate));
13236725e60dSJed Brown   else if (dim == 1) PetscCall(DMPlexCreateLineMesh_Internal(dm, faces[0], lower[0], upper[0], periodicity[0]));
13249566063dSJacob Faibussowitsch   else if (simplex) PetscCall(DMPlexCreateBoxMesh_Simplex_Internal(dm, dim, faces, lower, upper, periodicity, interpolate));
13259566063dSJacob Faibussowitsch   else PetscCall(DMPlexCreateBoxMesh_Tensor_Internal(dm, dim, faces, lower, upper, periodicity));
13269318fe57SMatthew G. Knepley   if (!interpolate && dim > 1 && !simplex) {
1327768d5fceSMatthew G. Knepley     DM udm;
1328768d5fceSMatthew G. Knepley 
13299566063dSJacob Faibussowitsch     PetscCall(DMPlexUninterpolate(dm, &udm));
13309566063dSJacob Faibussowitsch     PetscCall(DMPlexCopyCoordinates(dm, udm));
133169d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &udm));
1332768d5fceSMatthew G. Knepley   }
133346139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
13343ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1335c8c68bd8SToby Isaac }
1336c8c68bd8SToby Isaac 
1337768d5fceSMatthew G. Knepley /*@C
1338768d5fceSMatthew G. Knepley   DMPlexCreateBoxMesh - Creates a mesh on the tensor product of unit intervals (box) using simplices or tensor cells (hexahedra).
1339768d5fceSMatthew G. Knepley 
1340d083f849SBarry Smith   Collective
1341768d5fceSMatthew G. Knepley 
1342768d5fceSMatthew G. Knepley   Input Parameters:
1343a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
1344768d5fceSMatthew G. Knepley . dim         - The spatial dimension
1345a1cb98faSBarry Smith . simplex     - `PETSC_TRUE` for simplices, `PETSC_FALSE` for tensor cells
134620f4b53cSBarry Smith . faces       - Number of faces per dimension, or `NULL` for (1,) in 1D and (2, 2) in 2D and (1, 1, 1) in 3D
134720f4b53cSBarry Smith . lower       - The lower left corner, or `NULL` for (0, 0, 0)
134820f4b53cSBarry Smith . upper       - The upper right corner, or `NULL` for (1, 1, 1)
134920f4b53cSBarry Smith . periodicity - The boundary type for the X,Y,Z direction, or `NULL` for `DM_BOUNDARY_NONE`
1350768d5fceSMatthew G. Knepley - interpolate - Flag to create intermediate mesh pieces (edges, faces)
1351768d5fceSMatthew G. Knepley 
1352768d5fceSMatthew G. Knepley   Output Parameter:
1353a1cb98faSBarry Smith . dm - The `DM` object
1354768d5fceSMatthew G. Knepley 
1355768d5fceSMatthew G. Knepley   Level: beginner
1356768d5fceSMatthew G. Knepley 
1357a1cb98faSBarry Smith   Note:
1358a1cb98faSBarry Smith   To customize this mesh using options, use
1359a1cb98faSBarry Smith .vb
1360a1cb98faSBarry Smith   DMCreate(comm, &dm);
1361a1cb98faSBarry Smith   DMSetType(dm, DMPLEX);
1362a1cb98faSBarry Smith   DMSetFromOptions(dm);
1363a1cb98faSBarry Smith .ve
1364a1cb98faSBarry Smith   and use the options in `DMSetFromOptions()`.
1365a1cb98faSBarry Smith 
1366a4e35b19SJacob Faibussowitsch   Here is the numbering returned for 2 faces in each direction for tensor cells\:
1367a1cb98faSBarry Smith .vb
1368a1cb98faSBarry Smith  10---17---11---18----12
1369a1cb98faSBarry Smith   |         |         |
1370a1cb98faSBarry Smith   |         |         |
1371a1cb98faSBarry Smith  20    2   22    3    24
1372a1cb98faSBarry Smith   |         |         |
1373a1cb98faSBarry Smith   |         |         |
1374a1cb98faSBarry Smith   7---15----8---16----9
1375a1cb98faSBarry Smith   |         |         |
1376a1cb98faSBarry Smith   |         |         |
1377a1cb98faSBarry Smith  19    0   21    1   23
1378a1cb98faSBarry Smith   |         |         |
1379a1cb98faSBarry Smith   |         |         |
1380a1cb98faSBarry Smith   4---13----5---14----6
1381a1cb98faSBarry Smith .ve
1382a1cb98faSBarry Smith   and for simplicial cells
1383a1cb98faSBarry Smith .vb
1384a1cb98faSBarry Smith  14----8---15----9----16
1385a1cb98faSBarry Smith   |\     5  |\      7 |
1386a1cb98faSBarry Smith   | \       | \       |
1387a1cb98faSBarry Smith  13   2    14    3    15
1388a1cb98faSBarry Smith   | 4   \   | 6   \   |
1389a1cb98faSBarry Smith   |       \ |       \ |
1390a1cb98faSBarry Smith  11----6---12----7----13
1391a1cb98faSBarry Smith   |\        |\        |
1392a1cb98faSBarry Smith   | \    1  | \     3 |
1393a1cb98faSBarry Smith  10   0    11    1    12
1394a1cb98faSBarry Smith   | 0   \   | 2   \   |
1395a1cb98faSBarry Smith   |       \ |       \ |
1396a1cb98faSBarry Smith   8----4----9----5----10
1397a1cb98faSBarry Smith .ve
1398a1cb98faSBarry Smith 
13991cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMSetFromOptions()`, `DMPlexCreateFromFile()`, `DMPlexCreateHexCylinderMesh()`, `DMSetType()`, `DMCreate()`
1400768d5fceSMatthew G. Knepley @*/
1401d71ae5a4SJacob 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)
1402d71ae5a4SJacob Faibussowitsch {
14039318fe57SMatthew G. Knepley   PetscInt       fac[3] = {1, 1, 1};
1404fdbf62faSLisandro Dalcin   PetscReal      low[3] = {0, 0, 0};
1405fdbf62faSLisandro Dalcin   PetscReal      upp[3] = {1, 1, 1};
1406fdbf62faSLisandro Dalcin   DMBoundaryType bdt[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
1407552f7358SJed Brown 
1408768d5fceSMatthew G. Knepley   PetscFunctionBegin;
14099566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
14109566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
14115dca41c3SJed Brown   PetscCall(DMPlexCreateBoxMesh_Internal(*dm, DM_SHAPE_BOX, dim, simplex, faces ? faces : fac, lower ? lower : low, upper ? upper : upp, periodicity ? periodicity : bdt, interpolate));
14127ff04441SMatthew G. Knepley   if (periodicity) PetscCall(DMLocalizeCoordinates(*dm));
14133ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
14149318fe57SMatthew G. Knepley }
1415fdbf62faSLisandro Dalcin 
1416d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateWedgeBoxMesh_Internal(DM dm, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[])
1417d71ae5a4SJacob Faibussowitsch {
14189318fe57SMatthew G. Knepley   DM       bdm, vol;
14199318fe57SMatthew G. Knepley   PetscInt i;
14209318fe57SMatthew G. Knepley 
14219318fe57SMatthew G. Knepley   PetscFunctionBegin;
14221fcf445aSMatthew G. Knepley   // TODO Now we can support periodicity
142308401ef6SPierre Jolivet   for (i = 0; i < 3; ++i) PetscCheck(periodicity[i] == DM_BOUNDARY_NONE, PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Periodicity not yet supported");
14249566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &bdm));
14259566063dSJacob Faibussowitsch   PetscCall(DMSetType(bdm, DMPLEX));
14269566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(bdm, 2));
142746139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, bdm, 0, 0, 0));
14289566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBoxMesh_Simplex_Internal(bdm, 2, faces, lower, upper, periodicity, PETSC_TRUE));
14291fcf445aSMatthew G. Knepley   PetscCall(DMPlexExtrude(bdm, faces[2], upper[2] - lower[2], PETSC_TRUE, PETSC_FALSE, PETSC_FALSE, NULL, NULL, &vol));
143046139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, bdm, 0, 0, 0));
14319566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&bdm));
143269d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
14339318fe57SMatthew G. Knepley   if (lower[2] != 0.0) {
14349318fe57SMatthew G. Knepley     Vec          v;
14359318fe57SMatthew G. Knepley     PetscScalar *x;
14369318fe57SMatthew G. Knepley     PetscInt     cDim, n;
14379318fe57SMatthew G. Knepley 
14389566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinatesLocal(dm, &v));
14399566063dSJacob Faibussowitsch     PetscCall(VecGetBlockSize(v, &cDim));
14409566063dSJacob Faibussowitsch     PetscCall(VecGetLocalSize(v, &n));
14419566063dSJacob Faibussowitsch     PetscCall(VecGetArray(v, &x));
14429318fe57SMatthew G. Knepley     x += cDim;
14439318fe57SMatthew G. Knepley     for (i = 0; i < n; i += cDim) x[i] += lower[2];
14449566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(v, &x));
14459566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, v));
14469318fe57SMatthew G. Knepley   }
14473ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1448552f7358SJed Brown }
1449552f7358SJed Brown 
145000dabe28SStefano Zampini /*@
145139f4f5dbSPierre Jolivet   DMPlexCreateWedgeBoxMesh - Creates a 3-D mesh tessellating the (x,y) plane and extruding in the third direction using wedge cells.
145200dabe28SStefano Zampini 
1453d083f849SBarry Smith   Collective
145400dabe28SStefano Zampini 
145500dabe28SStefano Zampini   Input Parameters:
1456a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
145720f4b53cSBarry Smith . faces       - Number of faces per dimension, or `NULL` for (1, 1, 1)
145820f4b53cSBarry Smith . lower       - The lower left corner, or `NULL` for (0, 0, 0)
145920f4b53cSBarry Smith . upper       - The upper right corner, or `NULL` for (1, 1, 1)
146020f4b53cSBarry Smith . periodicity - The boundary type for the X,Y,Z direction, or `NULL` for `DM_BOUNDARY_NONE`
1461a1cb98faSBarry Smith . orderHeight - If `PETSC_TRUE`, orders the extruded cells in the height first. Otherwise, orders the cell on the layers first
146200dabe28SStefano Zampini - interpolate - Flag to create intermediate mesh pieces (edges, faces)
146300dabe28SStefano Zampini 
146400dabe28SStefano Zampini   Output Parameter:
1465a1cb98faSBarry Smith . dm - The `DM` object
146600dabe28SStefano Zampini 
146700dabe28SStefano Zampini   Level: beginner
146800dabe28SStefano Zampini 
14691cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateHexCylinderMesh()`, `DMPlexCreateWedgeCylinderMesh()`, `DMExtrude()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
147000dabe28SStefano Zampini @*/
1471d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateWedgeBoxMesh(MPI_Comm comm, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[], PetscBool orderHeight, PetscBool interpolate, DM *dm)
1472d71ae5a4SJacob Faibussowitsch {
14739318fe57SMatthew G. Knepley   PetscInt       fac[3] = {1, 1, 1};
147400dabe28SStefano Zampini   PetscReal      low[3] = {0, 0, 0};
147500dabe28SStefano Zampini   PetscReal      upp[3] = {1, 1, 1};
147600dabe28SStefano Zampini   DMBoundaryType bdt[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
147700dabe28SStefano Zampini 
147800dabe28SStefano Zampini   PetscFunctionBegin;
14799566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
14809566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
14819566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateWedgeBoxMesh_Internal(*dm, faces ? faces : fac, lower ? lower : low, upper ? upper : upp, periodicity ? periodicity : bdt));
1482d410b0cfSMatthew G. Knepley   if (!interpolate) {
1483d410b0cfSMatthew G. Knepley     DM udm;
148400dabe28SStefano Zampini 
14859566063dSJacob Faibussowitsch     PetscCall(DMPlexUninterpolate(*dm, &udm));
148669d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(*dm, &udm));
148700dabe28SStefano Zampini   }
14887ff04441SMatthew G. Knepley   if (periodicity) PetscCall(DMLocalizeCoordinates(*dm));
14893ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
149000dabe28SStefano Zampini }
149100dabe28SStefano Zampini 
1492cfb853baSMatthew G. Knepley /*
1493cfb853baSMatthew 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.
1494cfb853baSMatthew G. Knepley 
1495cfb853baSMatthew G. Knepley   Input Parameters:
1496cfb853baSMatthew G. Knepley + len - The length of the tuple
1497cfb853baSMatthew G. Knepley . max - The maximum for each dimension, so values are in [0, max)
1498cfb853baSMatthew G. Knepley - tup - A tuple of length len+1: tup[len] > 0 indicates a stopping condition
1499cfb853baSMatthew G. Knepley 
1500cfb853baSMatthew G. Knepley   Output Parameter:
150120f4b53cSBarry Smith . tup - A tuple of `len` integers whose entries are at most `max`
1502cfb853baSMatthew G. Knepley 
1503cfb853baSMatthew G. Knepley   Level: developer
1504cfb853baSMatthew G. Knepley 
150520f4b53cSBarry Smith   Note:
150620f4b53cSBarry Smith   Ordering is lexicographic with lowest index as least significant in ordering.
150720f4b53cSBarry 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}.
150820f4b53cSBarry Smith 
1509cfb853baSMatthew G. Knepley .seealso: PetscDualSpaceTensorPointLexicographic_Internal(), PetscDualSpaceLatticePointLexicographic_Internal()
1510cfb853baSMatthew G. Knepley */
1511cfb853baSMatthew G. Knepley static PetscErrorCode DMPlexTensorPointLexicographic_Private(PetscInt len, const PetscInt max[], PetscInt tup[])
1512cfb853baSMatthew G. Knepley {
1513cfb853baSMatthew G. Knepley   PetscInt i;
1514cfb853baSMatthew G. Knepley 
1515cfb853baSMatthew G. Knepley   PetscFunctionBegin;
1516cfb853baSMatthew G. Knepley   for (i = 0; i < len; ++i) {
1517cfb853baSMatthew G. Knepley     if (tup[i] < max[i] - 1) {
1518cfb853baSMatthew G. Knepley       break;
1519cfb853baSMatthew G. Knepley     } else {
1520cfb853baSMatthew G. Knepley       tup[i] = 0;
1521cfb853baSMatthew G. Knepley     }
1522cfb853baSMatthew G. Knepley   }
1523cfb853baSMatthew G. Knepley   if (i == len) tup[i - 1] = max[i - 1];
1524cfb853baSMatthew G. Knepley   else ++tup[i];
15253ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1526cfb853baSMatthew G. Knepley }
1527cfb853baSMatthew G. Knepley 
1528cfb853baSMatthew G. Knepley static PetscInt TupleToIndex_Private(PetscInt len, const PetscInt max[], const PetscInt tup[])
1529cfb853baSMatthew G. Knepley {
1530cfb853baSMatthew G. Knepley   PetscInt i, idx = tup[len - 1];
1531cfb853baSMatthew G. Knepley 
1532cfb853baSMatthew G. Knepley   for (i = len - 2; i >= 0; --i) {
1533cfb853baSMatthew G. Knepley     idx *= max[i];
1534cfb853baSMatthew G. Knepley     idx += tup[i];
1535cfb853baSMatthew G. Knepley   }
1536cfb853baSMatthew G. Knepley   return idx;
1537cfb853baSMatthew G. Knepley }
1538cfb853baSMatthew G. Knepley 
1539cfb853baSMatthew G. Knepley static PetscErrorCode DestroyExtent_Private(void *extent)
1540cfb853baSMatthew G. Knepley {
1541cfb853baSMatthew G. Knepley   return PetscFree(extent);
1542cfb853baSMatthew G. Knepley }
1543cfb853baSMatthew G. Knepley 
1544cfb853baSMatthew G. Knepley static PetscErrorCode DMPlexCreateHypercubicMesh_Internal(DM dm, PetscInt dim, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[], const DMBoundaryType bd[])
1545cfb853baSMatthew G. Knepley {
1546cfb853baSMatthew G. Knepley   Vec          coordinates;
1547cfb853baSMatthew G. Knepley   PetscSection coordSection;
1548cfb853baSMatthew G. Knepley   DMLabel      cutLabel    = NULL;
1549cfb853baSMatthew G. Knepley   PetscBool    cutMarker   = PETSC_FALSE;
1550cfb853baSMatthew G. Knepley   PetscBool    periodic    = PETSC_FALSE;
1551cfb853baSMatthew G. Knepley   PetscInt     numCells    = 1, c;
1552cfb853baSMatthew G. Knepley   PetscInt     numVertices = 1, v;
1553cfb853baSMatthew G. Knepley   PetscScalar *coords;
1554cfb853baSMatthew G. Knepley   PetscInt    *vertices, *vert, *vtmp, *supp, cone[2];
1555cfb853baSMatthew G. Knepley   PetscInt     d, e, cell = 0, coordSize;
1556cfb853baSMatthew G. Knepley   PetscMPIInt  rank;
1557cfb853baSMatthew G. Knepley 
1558cfb853baSMatthew G. Knepley   PetscFunctionBegin;
1559cfb853baSMatthew G. Knepley   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
1560cfb853baSMatthew G. Knepley   PetscCall(DMSetDimension(dm, dim));
1561cfb853baSMatthew G. Knepley   PetscCall(PetscCalloc4(dim, &vertices, dim, &vert, dim, &vtmp, 2 * dim, &supp));
1562cfb853baSMatthew G. Knepley   PetscCall(DMCreateLabel(dm, "marker"));
1563cfb853baSMatthew G. Knepley   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_periodic_cut", &cutMarker, NULL));
1564cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) periodic = (periodic || bd[d] == DM_BOUNDARY_PERIODIC) ? PETSC_TRUE : PETSC_FALSE;
1565cfb853baSMatthew G. Knepley   if (periodic && cutMarker) {
1566cfb853baSMatthew G. Knepley     PetscCall(DMCreateLabel(dm, "periodic_cut"));
1567cfb853baSMatthew G. Knepley     PetscCall(DMGetLabel(dm, "periodic_cut", &cutLabel));
1568cfb853baSMatthew G. Knepley   }
1569cfb853baSMatthew 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");
1570cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) {
1571cfb853baSMatthew G. Knepley     vertices[d] = edges[d];
1572cfb853baSMatthew G. Knepley     numVertices *= vertices[d];
1573cfb853baSMatthew G. Knepley   }
1574cfb853baSMatthew G. Knepley   numCells = numVertices * dim;
1575cfb853baSMatthew G. Knepley   PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
1576cfb853baSMatthew G. Knepley   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, 2));
1577cfb853baSMatthew G. Knepley   for (v = numCells; v < numCells + numVertices; ++v) PetscCall(DMPlexSetSupportSize(dm, v, 2 * dim));
1578cfb853baSMatthew G. Knepley   /* TODO Loop over boundary and reset support sizes */
1579cfb853baSMatthew G. Knepley   PetscCall(DMSetUp(dm)); /* Allocate space for cones and supports */
1580cfb853baSMatthew G. Knepley   /* Build cell cones and vertex supports */
1581cfb853baSMatthew G. Knepley   PetscCall(DMCreateLabel(dm, "celltype"));
1582cfb853baSMatthew G. Knepley   while (vert[dim - 1] < vertices[dim - 1]) {
1583cfb853baSMatthew G. Knepley     const PetscInt vertex = TupleToIndex_Private(dim, vertices, vert) + numCells;
1584cfb853baSMatthew G. Knepley     PetscInt       s      = 0;
1585cfb853baSMatthew G. Knepley 
15863ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "Vertex %" PetscInt_FMT ":", vertex));
15873ba16761SJacob Faibussowitsch     for (d = 0; d < dim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %" PetscInt_FMT, vert[d]));
15883ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
1589cfb853baSMatthew G. Knepley     PetscCall(DMPlexSetCellType(dm, vertex, DM_POLYTOPE_POINT));
1590cfb853baSMatthew G. Knepley     for (d = 0; d < dim; ++d) {
1591cfb853baSMatthew G. Knepley       for (e = 0; e < dim; ++e) vtmp[e] = vert[e];
1592cfb853baSMatthew G. Knepley       vtmp[d] = (vert[d] + 1) % vertices[d];
1593cfb853baSMatthew G. Knepley       cone[0] = vertex;
1594cfb853baSMatthew G. Knepley       cone[1] = TupleToIndex_Private(dim, vertices, vtmp) + numCells;
15953ba16761SJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Vertex %" PetscInt_FMT ":", cone[1]));
15963ba16761SJacob Faibussowitsch       for (e = 0; e < dim; ++e) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %" PetscInt_FMT, vtmp[e]));
15973ba16761SJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
1598cfb853baSMatthew G. Knepley       PetscCall(DMPlexSetCone(dm, cell, cone));
1599cfb853baSMatthew G. Knepley       PetscCall(DMPlexSetCellType(dm, cell, DM_POLYTOPE_SEGMENT));
16003ba16761SJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Edge %" PetscInt_FMT " (%" PetscInt_FMT " %" PetscInt_FMT ")\n", cell, cone[0], cone[1]));
1601cfb853baSMatthew G. Knepley       ++cell;
1602cfb853baSMatthew G. Knepley     }
1603cfb853baSMatthew G. Knepley     for (d = 0; d < dim; ++d) {
1604cfb853baSMatthew G. Knepley       for (e = 0; e < dim; ++e) vtmp[e] = vert[e];
1605cfb853baSMatthew G. Knepley       vtmp[d]   = (vert[d] + vertices[d] - 1) % vertices[d];
1606cfb853baSMatthew G. Knepley       supp[s++] = TupleToIndex_Private(dim, vertices, vtmp) * dim + d;
1607cfb853baSMatthew G. Knepley       supp[s++] = (vertex - numCells) * dim + d;
1608cfb853baSMatthew G. Knepley       PetscCall(DMPlexSetSupport(dm, vertex, supp));
1609cfb853baSMatthew G. Knepley     }
1610cfb853baSMatthew G. Knepley     PetscCall(DMPlexTensorPointLexicographic_Private(dim, vertices, vert));
1611cfb853baSMatthew G. Knepley   }
1612cfb853baSMatthew G. Knepley   PetscCall(DMPlexStratify(dm));
1613cfb853baSMatthew G. Knepley   /* Build coordinates */
1614cfb853baSMatthew G. Knepley   PetscCall(DMGetCoordinateSection(dm, &coordSection));
1615cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetNumFields(coordSection, 1));
1616cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
1617cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetChart(coordSection, numCells, numCells + numVertices));
1618cfb853baSMatthew G. Knepley   for (v = numCells; v < numCells + numVertices; ++v) {
1619cfb853baSMatthew G. Knepley     PetscCall(PetscSectionSetDof(coordSection, v, dim));
1620cfb853baSMatthew G. Knepley     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
1621cfb853baSMatthew G. Knepley   }
1622cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetUp(coordSection));
1623cfb853baSMatthew G. Knepley   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
1624cfb853baSMatthew G. Knepley   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
1625cfb853baSMatthew G. Knepley   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
1626cfb853baSMatthew G. Knepley   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
1627cfb853baSMatthew G. Knepley   PetscCall(VecSetBlockSize(coordinates, dim));
1628cfb853baSMatthew G. Knepley   PetscCall(VecSetType(coordinates, VECSTANDARD));
1629cfb853baSMatthew G. Knepley   PetscCall(VecGetArray(coordinates, &coords));
1630cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) vert[d] = 0;
1631cfb853baSMatthew G. Knepley   while (vert[dim - 1] < vertices[dim - 1]) {
1632cfb853baSMatthew G. Knepley     const PetscInt vertex = TupleToIndex_Private(dim, vertices, vert);
1633cfb853baSMatthew G. Knepley 
1634cfb853baSMatthew G. Knepley     for (d = 0; d < dim; ++d) coords[vertex * dim + d] = lower[d] + ((upper[d] - lower[d]) / vertices[d]) * vert[d];
16353ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "Vertex %" PetscInt_FMT ":", vertex));
16363ba16761SJacob Faibussowitsch     for (d = 0; d < dim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %" PetscInt_FMT, vert[d]));
16373ba16761SJacob Faibussowitsch     for (d = 0; d < dim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %g", (double)PetscRealPart(coords[vertex * dim + d])));
16383ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
1639cfb853baSMatthew G. Knepley     PetscCall(DMPlexTensorPointLexicographic_Private(dim, vertices, vert));
1640cfb853baSMatthew G. Knepley   }
1641cfb853baSMatthew G. Knepley   PetscCall(VecRestoreArray(coordinates, &coords));
1642cfb853baSMatthew G. Knepley   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
1643cfb853baSMatthew G. Knepley   PetscCall(VecDestroy(&coordinates));
1644cfb853baSMatthew G. Knepley   PetscCall(PetscFree4(vertices, vert, vtmp, supp));
1645cfb853baSMatthew G. Knepley   //PetscCall(DMSetPeriodicity(dm, NULL, lower, upper));
1646cfb853baSMatthew G. Knepley   // Attach the extent
1647cfb853baSMatthew G. Knepley   {
1648cfb853baSMatthew G. Knepley     PetscContainer c;
1649cfb853baSMatthew G. Knepley     PetscInt      *extent;
1650cfb853baSMatthew G. Knepley 
1651cfb853baSMatthew G. Knepley     PetscCall(PetscMalloc1(dim, &extent));
1652cfb853baSMatthew G. Knepley     for (PetscInt d = 0; d < dim; ++d) extent[d] = edges[d];
1653cfb853baSMatthew G. Knepley     PetscCall(PetscContainerCreate(PETSC_COMM_SELF, &c));
1654cfb853baSMatthew G. Knepley     PetscCall(PetscContainerSetUserDestroy(c, DestroyExtent_Private));
1655cfb853baSMatthew G. Knepley     PetscCall(PetscContainerSetPointer(c, extent));
1656cfb853baSMatthew G. Knepley     PetscCall(PetscObjectCompose((PetscObject)dm, "_extent", (PetscObject)c));
1657cfb853baSMatthew G. Knepley     PetscCall(PetscContainerDestroy(&c));
1658cfb853baSMatthew G. Knepley   }
16593ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1660cfb853baSMatthew G. Knepley }
1661cfb853baSMatthew G. Knepley 
1662cfb853baSMatthew G. Knepley /*@C
1663aaa8cc7dSPierre Jolivet   DMPlexCreateHypercubicMesh - Creates a periodic mesh on the tensor product of unit intervals using only vertices and edges.
1664cfb853baSMatthew G. Knepley 
1665cfb853baSMatthew G. Knepley   Collective
1666cfb853baSMatthew G. Knepley 
1667cfb853baSMatthew G. Knepley   Input Parameters:
1668cfb853baSMatthew G. Knepley + comm  - The communicator for the DM object
1669cfb853baSMatthew G. Knepley . dim   - The spatial dimension
167020f4b53cSBarry Smith . edges - Number of edges per dimension, or `NULL` for (1,) in 1D and (2, 2) in 2D and (1, 1, 1) in 3D
167120f4b53cSBarry Smith . lower - The lower left corner, or `NULL` for (0, 0, 0)
167220f4b53cSBarry Smith - upper - The upper right corner, or `NULL` for (1, 1, 1)
1673cfb853baSMatthew G. Knepley 
1674cfb853baSMatthew G. Knepley   Output Parameter:
1675cfb853baSMatthew G. Knepley . dm - The DM object
1676cfb853baSMatthew G. Knepley 
167720f4b53cSBarry Smith   Level: beginner
167820f4b53cSBarry Smith 
167920f4b53cSBarry Smith   Note:
168020f4b53cSBarry Smith   If you want to customize this mesh using options, you just need to
168120f4b53cSBarry Smith .vb
168220f4b53cSBarry Smith   DMCreate(comm, &dm);
168320f4b53cSBarry Smith   DMSetType(dm, DMPLEX);
168420f4b53cSBarry Smith   DMSetFromOptions(dm);
168520f4b53cSBarry Smith .ve
168620f4b53cSBarry Smith   and use the options on the `DMSetFromOptions()` page.
1687cfb853baSMatthew G. Knepley 
1688cfb853baSMatthew G. Knepley   The vertices are numbered is lexicographic order, and the dim edges exiting a vertex in the positive orthant are number consecutively,
168920f4b53cSBarry Smith .vb
169020f4b53cSBarry Smith  18--0-19--2-20--4-18
169120f4b53cSBarry Smith   |     |     |     |
169220f4b53cSBarry Smith  13    15    17    13
169320f4b53cSBarry Smith   |     |     |     |
169420f4b53cSBarry Smith  24-12-25-14-26-16-24
169520f4b53cSBarry Smith   |     |     |     |
169620f4b53cSBarry Smith   7     9    11     7
169720f4b53cSBarry Smith   |     |     |     |
169820f4b53cSBarry Smith  21--6-22--8-23-10-21
169920f4b53cSBarry Smith   |     |     |     |
170020f4b53cSBarry Smith   1     3     5     1
170120f4b53cSBarry Smith   |     |     |     |
170220f4b53cSBarry Smith  18--0-19--2-20--4-18
170320f4b53cSBarry Smith .ve
1704cfb853baSMatthew G. Knepley 
170576fbde31SPierre Jolivet .seealso: `DMSetFromOptions()`, `DMPlexCreateFromFile()`, `DMPlexCreateHexCylinderMesh()`, `DMSetType()`, `DMCreate()`
1706cfb853baSMatthew G. Knepley @*/
1707cfb853baSMatthew G. Knepley PetscErrorCode DMPlexCreateHypercubicMesh(MPI_Comm comm, PetscInt dim, const PetscInt edges[], const PetscReal lower[], const PetscReal upper[], DM *dm)
1708cfb853baSMatthew G. Knepley {
1709cfb853baSMatthew G. Knepley   PetscInt       *edg;
1710cfb853baSMatthew G. Knepley   PetscReal      *low, *upp;
1711cfb853baSMatthew G. Knepley   DMBoundaryType *bdt;
1712cfb853baSMatthew G. Knepley   PetscInt        d;
1713cfb853baSMatthew G. Knepley 
1714cfb853baSMatthew G. Knepley   PetscFunctionBegin;
1715cfb853baSMatthew G. Knepley   PetscCall(DMCreate(comm, dm));
1716cfb853baSMatthew G. Knepley   PetscCall(DMSetType(*dm, DMPLEX));
1717cfb853baSMatthew G. Knepley   PetscCall(PetscMalloc4(dim, &edg, dim, &low, dim, &upp, dim, &bdt));
1718cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) {
1719cfb853baSMatthew G. Knepley     edg[d] = edges ? edges[d] : 1;
1720cfb853baSMatthew G. Knepley     low[d] = lower ? lower[d] : 0.;
1721cfb853baSMatthew G. Knepley     upp[d] = upper ? upper[d] : 1.;
1722cfb853baSMatthew G. Knepley     bdt[d] = DM_BOUNDARY_PERIODIC;
1723cfb853baSMatthew G. Knepley   }
1724cfb853baSMatthew G. Knepley   PetscCall(DMPlexCreateHypercubicMesh_Internal(*dm, dim, low, upp, edg, bdt));
1725cfb853baSMatthew G. Knepley   PetscCall(PetscFree4(edg, low, upp, bdt));
17263ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1727cfb853baSMatthew G. Knepley }
1728cfb853baSMatthew G. Knepley 
1729cc4c1da9SBarry Smith /*@
1730a1cb98faSBarry Smith   DMPlexSetOptionsPrefix - Sets the prefix used for searching for all `DM` options in the database.
1731a9074c1eSMatthew G. Knepley 
173220f4b53cSBarry Smith   Logically Collective
1733a9074c1eSMatthew G. Knepley 
1734a9074c1eSMatthew G. Knepley   Input Parameters:
173520f4b53cSBarry Smith + dm     - the `DM` context
1736a9074c1eSMatthew G. Knepley - prefix - the prefix to prepend to all option names
1737a9074c1eSMatthew G. Knepley 
1738a1cb98faSBarry Smith   Level: advanced
1739a1cb98faSBarry Smith 
1740a1cb98faSBarry Smith   Note:
1741a9074c1eSMatthew G. Knepley   A hyphen (-) must NOT be given at the beginning of the prefix name.
1742a9074c1eSMatthew G. Knepley   The first character of all runtime options is AUTOMATICALLY the hyphen.
1743a9074c1eSMatthew G. Knepley 
17441cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `SNESSetFromOptions()`
1745a9074c1eSMatthew G. Knepley @*/
1746d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexSetOptionsPrefix(DM dm, const char prefix[])
1747d71ae5a4SJacob Faibussowitsch {
1748a9074c1eSMatthew G. Knepley   DM_Plex *mesh = (DM_Plex *)dm->data;
1749a9074c1eSMatthew G. Knepley 
1750a9074c1eSMatthew G. Knepley   PetscFunctionBegin;
1751a9074c1eSMatthew G. Knepley   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
17529566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)dm, prefix));
17539566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)mesh->partitioner, prefix));
17543ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1755a9074c1eSMatthew G. Knepley }
1756a9074c1eSMatthew G. Knepley 
17579318fe57SMatthew G. Knepley /* Remap geometry to cylinder
175861a622f3SMatthew G. Knepley    TODO: This only works for a single refinement, then it is broken
175961a622f3SMatthew G. Knepley 
17609318fe57SMatthew G. Knepley      Interior square: Linear interpolation is correct
17619318fe57SMatthew G. Knepley      The other cells all have vertices on rays from the origin. We want to uniformly expand the spacing
17629318fe57SMatthew G. Knepley      such that the last vertex is on the unit circle. So the closest and farthest vertices are at distance
17630510c589SMatthew G. Knepley 
17649318fe57SMatthew G. Knepley        phi     = arctan(y/x)
17659318fe57SMatthew G. Knepley        d_close = sqrt(1/8 + 1/4 sin^2(phi))
17669318fe57SMatthew G. Knepley        d_far   = sqrt(1/2 + sin^2(phi))
17670510c589SMatthew G. Knepley 
17689318fe57SMatthew G. Knepley      so we remap them using
17690510c589SMatthew G. Knepley 
17709318fe57SMatthew G. Knepley        x_new = x_close + (x - x_close) (1 - d_close) / (d_far - d_close)
17719318fe57SMatthew G. Knepley        y_new = y_close + (y - y_close) (1 - d_close) / (d_far - d_close)
17720510c589SMatthew G. Knepley 
17739318fe57SMatthew G. Knepley      If pi/4 < phi < 3pi/4 or -3pi/4 < phi < -pi/4, then we switch x and y.
17749318fe57SMatthew G. Knepley */
1775d71ae5a4SJacob 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[])
1776d71ae5a4SJacob Faibussowitsch {
17779318fe57SMatthew G. Knepley   const PetscReal dis = 1.0 / PetscSqrtReal(2.0);
17789318fe57SMatthew G. Knepley   const PetscReal ds2 = 0.5 * dis;
177922cc497dSMatthew G. Knepley 
17809318fe57SMatthew G. Knepley   if ((PetscAbsScalar(u[0]) <= ds2) && (PetscAbsScalar(u[1]) <= ds2)) {
17819318fe57SMatthew G. Knepley     f0[0] = u[0];
17829318fe57SMatthew G. Knepley     f0[1] = u[1];
17839318fe57SMatthew G. Knepley   } else {
17849318fe57SMatthew G. Knepley     PetscReal phi, sinp, cosp, dc, df, x, y, xc, yc;
17850510c589SMatthew G. Knepley 
17869318fe57SMatthew G. Knepley     x    = PetscRealPart(u[0]);
17879318fe57SMatthew G. Knepley     y    = PetscRealPart(u[1]);
17889318fe57SMatthew G. Knepley     phi  = PetscAtan2Real(y, x);
17899318fe57SMatthew G. Knepley     sinp = PetscSinReal(phi);
17909318fe57SMatthew G. Knepley     cosp = PetscCosReal(phi);
17919318fe57SMatthew G. Knepley     if ((PetscAbsReal(phi) > PETSC_PI / 4.0) && (PetscAbsReal(phi) < 3.0 * PETSC_PI / 4.0)) {
17929318fe57SMatthew G. Knepley       dc = PetscAbsReal(ds2 / sinp);
17939318fe57SMatthew G. Knepley       df = PetscAbsReal(dis / sinp);
17949318fe57SMatthew G. Knepley       xc = ds2 * x / PetscAbsReal(y);
17959318fe57SMatthew G. Knepley       yc = ds2 * PetscSignReal(y);
17969318fe57SMatthew G. Knepley     } else {
17979318fe57SMatthew G. Knepley       dc = PetscAbsReal(ds2 / cosp);
17989318fe57SMatthew G. Knepley       df = PetscAbsReal(dis / cosp);
17999318fe57SMatthew G. Knepley       xc = ds2 * PetscSignReal(x);
18009318fe57SMatthew G. Knepley       yc = ds2 * y / PetscAbsReal(x);
18019318fe57SMatthew G. Knepley     }
18029318fe57SMatthew G. Knepley     f0[0] = xc + (u[0] - xc) * (1.0 - dc) / (df - dc);
18039318fe57SMatthew G. Knepley     f0[1] = yc + (u[1] - yc) * (1.0 - dc) / (df - dc);
18049318fe57SMatthew G. Knepley   }
18059318fe57SMatthew G. Knepley   f0[2] = u[2];
18069318fe57SMatthew G. Knepley }
18070510c589SMatthew G. Knepley 
1808d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateHexCylinderMesh_Internal(DM dm, DMBoundaryType periodicZ)
1809d71ae5a4SJacob Faibussowitsch {
18100510c589SMatthew G. Knepley   const PetscInt dim = 3;
18119318fe57SMatthew G. Knepley   PetscInt       numCells, numVertices;
1812d8c47e87SMatthew G. Knepley   PetscMPIInt    rank;
18130510c589SMatthew G. Knepley 
18140510c589SMatthew G. Knepley   PetscFunctionBegin;
181546139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
18169566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
18179566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
18180510c589SMatthew G. Knepley   /* Create topology */
18190510c589SMatthew G. Knepley   {
18200510c589SMatthew G. Knepley     PetscInt cone[8], c;
18210510c589SMatthew G. Knepley 
1822dd400576SPatrick Sanan     numCells    = rank == 0 ? 5 : 0;
1823dd400576SPatrick Sanan     numVertices = rank == 0 ? 16 : 0;
1824006a8963SMatthew G. Knepley     if (periodicZ == DM_BOUNDARY_PERIODIC) {
1825ae8bcbbbSMatthew G. Knepley       numCells *= 3;
1826dd400576SPatrick Sanan       numVertices = rank == 0 ? 24 : 0;
1827006a8963SMatthew G. Knepley     }
18289566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
18299566063dSJacob Faibussowitsch     for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 8));
18309566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm));
1831dd400576SPatrick Sanan     if (rank == 0) {
1832006a8963SMatthew G. Knepley       if (periodicZ == DM_BOUNDARY_PERIODIC) {
18339371c9d4SSatish Balay         cone[0] = 15;
18349371c9d4SSatish Balay         cone[1] = 18;
18359371c9d4SSatish Balay         cone[2] = 17;
18369371c9d4SSatish Balay         cone[3] = 16;
18379371c9d4SSatish Balay         cone[4] = 31;
18389371c9d4SSatish Balay         cone[5] = 32;
18399371c9d4SSatish Balay         cone[6] = 33;
18409371c9d4SSatish Balay         cone[7] = 34;
18419566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
18429371c9d4SSatish Balay         cone[0] = 16;
18439371c9d4SSatish Balay         cone[1] = 17;
18449371c9d4SSatish Balay         cone[2] = 24;
18459371c9d4SSatish Balay         cone[3] = 23;
18469371c9d4SSatish Balay         cone[4] = 32;
18479371c9d4SSatish Balay         cone[5] = 36;
18489371c9d4SSatish Balay         cone[6] = 37;
18499371c9d4SSatish Balay         cone[7] = 33; /* 22 25 26 21 */
18509566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
18519371c9d4SSatish Balay         cone[0] = 18;
18529371c9d4SSatish Balay         cone[1] = 27;
18539371c9d4SSatish Balay         cone[2] = 24;
18549371c9d4SSatish Balay         cone[3] = 17;
18559371c9d4SSatish Balay         cone[4] = 34;
18569371c9d4SSatish Balay         cone[5] = 33;
18579371c9d4SSatish Balay         cone[6] = 37;
18589371c9d4SSatish Balay         cone[7] = 38;
18599566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
18609371c9d4SSatish Balay         cone[0] = 29;
18619371c9d4SSatish Balay         cone[1] = 27;
18629371c9d4SSatish Balay         cone[2] = 18;
18639371c9d4SSatish Balay         cone[3] = 15;
18649371c9d4SSatish Balay         cone[4] = 35;
18659371c9d4SSatish Balay         cone[5] = 31;
18669371c9d4SSatish Balay         cone[6] = 34;
18679371c9d4SSatish Balay         cone[7] = 38;
18689566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
18699371c9d4SSatish Balay         cone[0] = 29;
18709371c9d4SSatish Balay         cone[1] = 15;
18719371c9d4SSatish Balay         cone[2] = 16;
18729371c9d4SSatish Balay         cone[3] = 23;
18739371c9d4SSatish Balay         cone[4] = 35;
18749371c9d4SSatish Balay         cone[5] = 36;
18759371c9d4SSatish Balay         cone[6] = 32;
18769371c9d4SSatish Balay         cone[7] = 31;
18779566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
1878006a8963SMatthew G. Knepley 
18799371c9d4SSatish Balay         cone[0] = 31;
18809371c9d4SSatish Balay         cone[1] = 34;
18819371c9d4SSatish Balay         cone[2] = 33;
18829371c9d4SSatish Balay         cone[3] = 32;
18839371c9d4SSatish Balay         cone[4] = 19;
18849371c9d4SSatish Balay         cone[5] = 22;
18859371c9d4SSatish Balay         cone[6] = 21;
18869371c9d4SSatish Balay         cone[7] = 20;
18879566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 5, cone));
18889371c9d4SSatish Balay         cone[0] = 32;
18899371c9d4SSatish Balay         cone[1] = 33;
18909371c9d4SSatish Balay         cone[2] = 37;
18919371c9d4SSatish Balay         cone[3] = 36;
18929371c9d4SSatish Balay         cone[4] = 22;
18939371c9d4SSatish Balay         cone[5] = 25;
18949371c9d4SSatish Balay         cone[6] = 26;
18959371c9d4SSatish Balay         cone[7] = 21;
18969566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 6, cone));
18979371c9d4SSatish Balay         cone[0] = 34;
18989371c9d4SSatish Balay         cone[1] = 38;
18999371c9d4SSatish Balay         cone[2] = 37;
19009371c9d4SSatish Balay         cone[3] = 33;
19019371c9d4SSatish Balay         cone[4] = 20;
19029371c9d4SSatish Balay         cone[5] = 21;
19039371c9d4SSatish Balay         cone[6] = 26;
19049371c9d4SSatish Balay         cone[7] = 28;
19059566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 7, cone));
19069371c9d4SSatish Balay         cone[0] = 35;
19079371c9d4SSatish Balay         cone[1] = 38;
19089371c9d4SSatish Balay         cone[2] = 34;
19099371c9d4SSatish Balay         cone[3] = 31;
19109371c9d4SSatish Balay         cone[4] = 30;
19119371c9d4SSatish Balay         cone[5] = 19;
19129371c9d4SSatish Balay         cone[6] = 20;
19139371c9d4SSatish Balay         cone[7] = 28;
19149566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 8, cone));
19159371c9d4SSatish Balay         cone[0] = 35;
19169371c9d4SSatish Balay         cone[1] = 31;
19179371c9d4SSatish Balay         cone[2] = 32;
19189371c9d4SSatish Balay         cone[3] = 36;
19199371c9d4SSatish Balay         cone[4] = 30;
19209371c9d4SSatish Balay         cone[5] = 25;
19219371c9d4SSatish Balay         cone[6] = 22;
19229371c9d4SSatish Balay         cone[7] = 19;
19239566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 9, cone));
1924ae8bcbbbSMatthew G. Knepley 
19259371c9d4SSatish Balay         cone[0] = 19;
19269371c9d4SSatish Balay         cone[1] = 20;
19279371c9d4SSatish Balay         cone[2] = 21;
19289371c9d4SSatish Balay         cone[3] = 22;
19299371c9d4SSatish Balay         cone[4] = 15;
19309371c9d4SSatish Balay         cone[5] = 16;
19319371c9d4SSatish Balay         cone[6] = 17;
19329371c9d4SSatish Balay         cone[7] = 18;
19339566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 10, cone));
19349371c9d4SSatish Balay         cone[0] = 22;
19359371c9d4SSatish Balay         cone[1] = 21;
19369371c9d4SSatish Balay         cone[2] = 26;
19379371c9d4SSatish Balay         cone[3] = 25;
19389371c9d4SSatish Balay         cone[4] = 16;
19399371c9d4SSatish Balay         cone[5] = 23;
19409371c9d4SSatish Balay         cone[6] = 24;
19419371c9d4SSatish Balay         cone[7] = 17;
19429566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 11, cone));
19439371c9d4SSatish Balay         cone[0] = 20;
19449371c9d4SSatish Balay         cone[1] = 28;
19459371c9d4SSatish Balay         cone[2] = 26;
19469371c9d4SSatish Balay         cone[3] = 21;
19479371c9d4SSatish Balay         cone[4] = 18;
19489371c9d4SSatish Balay         cone[5] = 17;
19499371c9d4SSatish Balay         cone[6] = 24;
19509371c9d4SSatish Balay         cone[7] = 27;
19519566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 12, cone));
19529371c9d4SSatish Balay         cone[0] = 30;
19539371c9d4SSatish Balay         cone[1] = 28;
19549371c9d4SSatish Balay         cone[2] = 20;
19559371c9d4SSatish Balay         cone[3] = 19;
19569371c9d4SSatish Balay         cone[4] = 29;
19579371c9d4SSatish Balay         cone[5] = 15;
19589371c9d4SSatish Balay         cone[6] = 18;
19599371c9d4SSatish Balay         cone[7] = 27;
19609566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 13, cone));
19619371c9d4SSatish Balay         cone[0] = 30;
19629371c9d4SSatish Balay         cone[1] = 19;
19639371c9d4SSatish Balay         cone[2] = 22;
19649371c9d4SSatish Balay         cone[3] = 25;
19659371c9d4SSatish Balay         cone[4] = 29;
19669371c9d4SSatish Balay         cone[5] = 23;
19679371c9d4SSatish Balay         cone[6] = 16;
19689371c9d4SSatish Balay         cone[7] = 15;
19699566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 14, cone));
1970006a8963SMatthew G. Knepley       } else {
19719371c9d4SSatish Balay         cone[0] = 5;
19729371c9d4SSatish Balay         cone[1] = 8;
19739371c9d4SSatish Balay         cone[2] = 7;
19749371c9d4SSatish Balay         cone[3] = 6;
19759371c9d4SSatish Balay         cone[4] = 9;
19769371c9d4SSatish Balay         cone[5] = 12;
19779371c9d4SSatish Balay         cone[6] = 11;
19789371c9d4SSatish Balay         cone[7] = 10;
19799566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
19809371c9d4SSatish Balay         cone[0] = 6;
19819371c9d4SSatish Balay         cone[1] = 7;
19829371c9d4SSatish Balay         cone[2] = 14;
19839371c9d4SSatish Balay         cone[3] = 13;
19849371c9d4SSatish Balay         cone[4] = 12;
19859371c9d4SSatish Balay         cone[5] = 15;
19869371c9d4SSatish Balay         cone[6] = 16;
19879371c9d4SSatish Balay         cone[7] = 11;
19889566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
19899371c9d4SSatish Balay         cone[0] = 8;
19909371c9d4SSatish Balay         cone[1] = 17;
19919371c9d4SSatish Balay         cone[2] = 14;
19929371c9d4SSatish Balay         cone[3] = 7;
19939371c9d4SSatish Balay         cone[4] = 10;
19949371c9d4SSatish Balay         cone[5] = 11;
19959371c9d4SSatish Balay         cone[6] = 16;
19969371c9d4SSatish Balay         cone[7] = 18;
19979566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
19989371c9d4SSatish Balay         cone[0] = 19;
19999371c9d4SSatish Balay         cone[1] = 17;
20009371c9d4SSatish Balay         cone[2] = 8;
20019371c9d4SSatish Balay         cone[3] = 5;
20029371c9d4SSatish Balay         cone[4] = 20;
20039371c9d4SSatish Balay         cone[5] = 9;
20049371c9d4SSatish Balay         cone[6] = 10;
20059371c9d4SSatish Balay         cone[7] = 18;
20069566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
20079371c9d4SSatish Balay         cone[0] = 19;
20089371c9d4SSatish Balay         cone[1] = 5;
20099371c9d4SSatish Balay         cone[2] = 6;
20109371c9d4SSatish Balay         cone[3] = 13;
20119371c9d4SSatish Balay         cone[4] = 20;
20129371c9d4SSatish Balay         cone[5] = 15;
20139371c9d4SSatish Balay         cone[6] = 12;
20149371c9d4SSatish Balay         cone[7] = 9;
20159566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
2016006a8963SMatthew G. Knepley       }
2017d8c47e87SMatthew G. Knepley     }
20189566063dSJacob Faibussowitsch     PetscCall(DMPlexSymmetrize(dm));
20199566063dSJacob Faibussowitsch     PetscCall(DMPlexStratify(dm));
20200510c589SMatthew G. Knepley   }
2021dbc1dc17SMatthew G. Knepley   /* Create cube geometry */
20220510c589SMatthew G. Knepley   {
20230510c589SMatthew G. Knepley     Vec             coordinates;
20240510c589SMatthew G. Knepley     PetscSection    coordSection;
20250510c589SMatthew G. Knepley     PetscScalar    *coords;
20260510c589SMatthew G. Knepley     PetscInt        coordSize, v;
20270510c589SMatthew G. Knepley     const PetscReal dis = 1.0 / PetscSqrtReal(2.0);
20280510c589SMatthew G. Knepley     const PetscReal ds2 = dis / 2.0;
20290510c589SMatthew G. Knepley 
20300510c589SMatthew G. Knepley     /* Build coordinates */
20319566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &coordSection));
20329566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetNumFields(coordSection, 1));
20339566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
20349566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetChart(coordSection, numCells, numCells + numVertices));
20350510c589SMatthew G. Knepley     for (v = numCells; v < numCells + numVertices; ++v) {
20369566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetDof(coordSection, v, dim));
20379566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
20380510c589SMatthew G. Knepley     }
20399566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetUp(coordSection));
20409566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
20419566063dSJacob Faibussowitsch     PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
20429566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
20439566063dSJacob Faibussowitsch     PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
20449566063dSJacob Faibussowitsch     PetscCall(VecSetBlockSize(coordinates, dim));
20459566063dSJacob Faibussowitsch     PetscCall(VecSetType(coordinates, VECSTANDARD));
20469566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
2047dd400576SPatrick Sanan     if (rank == 0) {
20489371c9d4SSatish Balay       coords[0 * dim + 0]  = -ds2;
20499371c9d4SSatish Balay       coords[0 * dim + 1]  = -ds2;
20509371c9d4SSatish Balay       coords[0 * dim + 2]  = 0.0;
20519371c9d4SSatish Balay       coords[1 * dim + 0]  = ds2;
20529371c9d4SSatish Balay       coords[1 * dim + 1]  = -ds2;
20539371c9d4SSatish Balay       coords[1 * dim + 2]  = 0.0;
20549371c9d4SSatish Balay       coords[2 * dim + 0]  = ds2;
20559371c9d4SSatish Balay       coords[2 * dim + 1]  = ds2;
20569371c9d4SSatish Balay       coords[2 * dim + 2]  = 0.0;
20579371c9d4SSatish Balay       coords[3 * dim + 0]  = -ds2;
20589371c9d4SSatish Balay       coords[3 * dim + 1]  = ds2;
20599371c9d4SSatish Balay       coords[3 * dim + 2]  = 0.0;
20609371c9d4SSatish Balay       coords[4 * dim + 0]  = -ds2;
20619371c9d4SSatish Balay       coords[4 * dim + 1]  = -ds2;
20629371c9d4SSatish Balay       coords[4 * dim + 2]  = 1.0;
20639371c9d4SSatish Balay       coords[5 * dim + 0]  = -ds2;
20649371c9d4SSatish Balay       coords[5 * dim + 1]  = ds2;
20659371c9d4SSatish Balay       coords[5 * dim + 2]  = 1.0;
20669371c9d4SSatish Balay       coords[6 * dim + 0]  = ds2;
20679371c9d4SSatish Balay       coords[6 * dim + 1]  = ds2;
20689371c9d4SSatish Balay       coords[6 * dim + 2]  = 1.0;
20699371c9d4SSatish Balay       coords[7 * dim + 0]  = ds2;
20709371c9d4SSatish Balay       coords[7 * dim + 1]  = -ds2;
20719371c9d4SSatish Balay       coords[7 * dim + 2]  = 1.0;
20729371c9d4SSatish Balay       coords[8 * dim + 0]  = dis;
20739371c9d4SSatish Balay       coords[8 * dim + 1]  = -dis;
20749371c9d4SSatish Balay       coords[8 * dim + 2]  = 0.0;
20759371c9d4SSatish Balay       coords[9 * dim + 0]  = dis;
20769371c9d4SSatish Balay       coords[9 * dim + 1]  = dis;
20779371c9d4SSatish Balay       coords[9 * dim + 2]  = 0.0;
20789371c9d4SSatish Balay       coords[10 * dim + 0] = dis;
20799371c9d4SSatish Balay       coords[10 * dim + 1] = -dis;
20809371c9d4SSatish Balay       coords[10 * dim + 2] = 1.0;
20819371c9d4SSatish Balay       coords[11 * dim + 0] = dis;
20829371c9d4SSatish Balay       coords[11 * dim + 1] = dis;
20839371c9d4SSatish Balay       coords[11 * dim + 2] = 1.0;
20849371c9d4SSatish Balay       coords[12 * dim + 0] = -dis;
20859371c9d4SSatish Balay       coords[12 * dim + 1] = dis;
20869371c9d4SSatish Balay       coords[12 * dim + 2] = 0.0;
20879371c9d4SSatish Balay       coords[13 * dim + 0] = -dis;
20889371c9d4SSatish Balay       coords[13 * dim + 1] = dis;
20899371c9d4SSatish Balay       coords[13 * dim + 2] = 1.0;
20909371c9d4SSatish Balay       coords[14 * dim + 0] = -dis;
20919371c9d4SSatish Balay       coords[14 * dim + 1] = -dis;
20929371c9d4SSatish Balay       coords[14 * dim + 2] = 0.0;
20939371c9d4SSatish Balay       coords[15 * dim + 0] = -dis;
20949371c9d4SSatish Balay       coords[15 * dim + 1] = -dis;
20959371c9d4SSatish Balay       coords[15 * dim + 2] = 1.0;
2096ae8bcbbbSMatthew G. Knepley       if (periodicZ == DM_BOUNDARY_PERIODIC) {
20979371c9d4SSatish Balay         /* 15 31 19 */ coords[16 * dim + 0] = -ds2;
20989371c9d4SSatish Balay         coords[16 * dim + 1]                = -ds2;
20999371c9d4SSatish Balay         coords[16 * dim + 2]                = 0.5;
21009371c9d4SSatish Balay         /* 16 32 22 */ coords[17 * dim + 0] = ds2;
21019371c9d4SSatish Balay         coords[17 * dim + 1]                = -ds2;
21029371c9d4SSatish Balay         coords[17 * dim + 2]                = 0.5;
21039371c9d4SSatish Balay         /* 17 33 21 */ coords[18 * dim + 0] = ds2;
21049371c9d4SSatish Balay         coords[18 * dim + 1]                = ds2;
21059371c9d4SSatish Balay         coords[18 * dim + 2]                = 0.5;
21069371c9d4SSatish Balay         /* 18 34 20 */ coords[19 * dim + 0] = -ds2;
21079371c9d4SSatish Balay         coords[19 * dim + 1]                = ds2;
21089371c9d4SSatish Balay         coords[19 * dim + 2]                = 0.5;
21099371c9d4SSatish Balay         /* 29 35 30 */ coords[20 * dim + 0] = -dis;
21109371c9d4SSatish Balay         coords[20 * dim + 1]                = -dis;
21119371c9d4SSatish Balay         coords[20 * dim + 2]                = 0.5;
21129371c9d4SSatish Balay         /* 23 36 25 */ coords[21 * dim + 0] = dis;
21139371c9d4SSatish Balay         coords[21 * dim + 1]                = -dis;
21149371c9d4SSatish Balay         coords[21 * dim + 2]                = 0.5;
21159371c9d4SSatish Balay         /* 24 37 26 */ coords[22 * dim + 0] = dis;
21169371c9d4SSatish Balay         coords[22 * dim + 1]                = dis;
21179371c9d4SSatish Balay         coords[22 * dim + 2]                = 0.5;
21189371c9d4SSatish Balay         /* 27 38 28 */ coords[23 * dim + 0] = -dis;
21199371c9d4SSatish Balay         coords[23 * dim + 1]                = dis;
21209371c9d4SSatish Balay         coords[23 * dim + 2]                = 0.5;
2121ae8bcbbbSMatthew G. Knepley       }
2122d8c47e87SMatthew G. Knepley     }
21239566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(coordinates, &coords));
21249566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, coordinates));
21259566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&coordinates));
21260510c589SMatthew G. Knepley   }
2127006a8963SMatthew G. Knepley   /* Create periodicity */
2128006a8963SMatthew G. Knepley   if (periodicZ == DM_BOUNDARY_PERIODIC || periodicZ == DM_BOUNDARY_TWIST) {
21296858538eSMatthew G. Knepley     PetscReal L[3]       = {-1., -1., 0.};
21306858538eSMatthew G. Knepley     PetscReal maxCell[3] = {-1., -1., 0.};
2131006a8963SMatthew G. Knepley     PetscReal lower[3]   = {0.0, 0.0, 0.0};
2132ae8bcbbbSMatthew G. Knepley     PetscReal upper[3]   = {1.0, 1.0, 1.5};
21336858538eSMatthew G. Knepley     PetscInt  numZCells  = 3;
2134006a8963SMatthew G. Knepley 
21356858538eSMatthew G. Knepley     L[2]       = upper[2] - lower[2];
21366858538eSMatthew G. Knepley     maxCell[2] = 1.1 * (L[2] / numZCells);
21374fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dm, maxCell, lower, L));
2138006a8963SMatthew G. Knepley   }
2139dbc1dc17SMatthew G. Knepley   {
21409318fe57SMatthew G. Knepley     DM          cdm;
21419318fe57SMatthew G. Knepley     PetscDS     cds;
21429318fe57SMatthew G. Knepley     PetscScalar c[2] = {1.0, 1.0};
2143dbc1dc17SMatthew G. Knepley 
2144e44f6aebSMatthew G. Knepley     PetscCall(DMPlexCreateCoordinateSpace(dm, 1, PETSC_TRUE, snapToCylinder));
21459566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
21469566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
21479566063dSJacob Faibussowitsch     PetscCall(PetscDSSetConstants(cds, 2, c));
2148dbc1dc17SMatthew G. Knepley   }
214946139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
215046139095SJed Brown 
21519318fe57SMatthew G. Knepley   /* Wait for coordinate creation before doing in-place modification */
21529566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolateInPlace_Internal(dm));
21533ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
21540510c589SMatthew G. Knepley }
21550510c589SMatthew G. Knepley 
215624119c2aSMatthew G. Knepley /*@
21579318fe57SMatthew G. Knepley   DMPlexCreateHexCylinderMesh - Creates a mesh on the tensor product of the unit interval with the circle (cylinder) using hexahedra.
215824119c2aSMatthew G. Knepley 
2159d083f849SBarry Smith   Collective
216024119c2aSMatthew G. Knepley 
216124119c2aSMatthew G. Knepley   Input Parameters:
2162a1cb98faSBarry Smith + comm      - The communicator for the `DM` object
21639318fe57SMatthew G. Knepley - periodicZ - The boundary type for the Z direction
216424119c2aSMatthew G. Knepley 
216524119c2aSMatthew G. Knepley   Output Parameter:
216620f4b53cSBarry Smith . dm - The `DM` object
216724119c2aSMatthew G. Knepley 
216824119c2aSMatthew G. Knepley   Level: beginner
216924119c2aSMatthew G. Knepley 
2170a1cb98faSBarry Smith   Note:
2171a4e35b19SJacob Faibussowitsch   Here is the output numbering looking from the bottom of the cylinder\:
2172a1cb98faSBarry Smith .vb
2173a1cb98faSBarry Smith        17-----14
2174a1cb98faSBarry Smith         |     |
2175a1cb98faSBarry Smith         |  2  |
2176a1cb98faSBarry Smith         |     |
2177a1cb98faSBarry Smith  17-----8-----7-----14
2178a1cb98faSBarry Smith   |     |     |     |
2179a1cb98faSBarry Smith   |  3  |  0  |  1  |
2180a1cb98faSBarry Smith   |     |     |     |
2181a1cb98faSBarry Smith  19-----5-----6-----13
2182a1cb98faSBarry Smith         |     |
2183a1cb98faSBarry Smith         |  4  |
2184a1cb98faSBarry Smith         |     |
2185a1cb98faSBarry Smith        19-----13
2186a1cb98faSBarry Smith 
2187a1cb98faSBarry Smith  and up through the top
2188a1cb98faSBarry Smith 
2189a1cb98faSBarry Smith        18-----16
2190a1cb98faSBarry Smith         |     |
2191a1cb98faSBarry Smith         |  2  |
2192a1cb98faSBarry Smith         |     |
2193a1cb98faSBarry Smith  18----10----11-----16
2194a1cb98faSBarry Smith   |     |     |     |
2195a1cb98faSBarry Smith   |  3  |  0  |  1  |
2196a1cb98faSBarry Smith   |     |     |     |
2197a1cb98faSBarry Smith  20-----9----12-----15
2198a1cb98faSBarry Smith         |     |
2199a1cb98faSBarry Smith         |  4  |
2200a1cb98faSBarry Smith         |     |
2201a1cb98faSBarry Smith        20-----15
2202a1cb98faSBarry Smith .ve
2203a1cb98faSBarry Smith 
22041cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
220524119c2aSMatthew G. Knepley @*/
2206d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateHexCylinderMesh(MPI_Comm comm, DMBoundaryType periodicZ, DM *dm)
2207d71ae5a4SJacob Faibussowitsch {
22089318fe57SMatthew G. Knepley   PetscFunctionBegin;
22094f572ea9SToby Isaac   PetscAssertPointer(dm, 3);
22109566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
22119566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
22129566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateHexCylinderMesh_Internal(*dm, periodicZ));
22133ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
22149318fe57SMatthew G. Knepley }
22159318fe57SMatthew G. Knepley 
2216d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateWedgeCylinderMesh_Internal(DM dm, PetscInt n, PetscBool interpolate)
2217d71ae5a4SJacob Faibussowitsch {
221824119c2aSMatthew G. Knepley   const PetscInt dim = 3;
2219412e9a14SMatthew G. Knepley   PetscInt       numCells, numVertices, v;
22209fe9f049SMatthew G. Knepley   PetscMPIInt    rank;
222124119c2aSMatthew G. Knepley 
222224119c2aSMatthew G. Knepley   PetscFunctionBegin;
222363a3b9bcSJacob Faibussowitsch   PetscCheck(n >= 0, PetscObjectComm((PetscObject)dm), PETSC_ERR_ARG_OUTOFRANGE, "Number of wedges %" PetscInt_FMT " cannot be negative", n);
222446139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
22259566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
22269566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
2227412e9a14SMatthew G. Knepley   /* Must create the celltype label here so that we do not automatically try to compute the types */
22289566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "celltype"));
222924119c2aSMatthew G. Knepley   /* Create topology */
223024119c2aSMatthew G. Knepley   {
223124119c2aSMatthew G. Knepley     PetscInt cone[6], c;
223224119c2aSMatthew G. Knepley 
2233dd400576SPatrick Sanan     numCells    = rank == 0 ? n : 0;
2234dd400576SPatrick Sanan     numVertices = rank == 0 ? 2 * (n + 1) : 0;
22359566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
22369566063dSJacob Faibussowitsch     for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 6));
22379566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm));
223824119c2aSMatthew G. Knepley     for (c = 0; c < numCells; c++) {
22399371c9d4SSatish Balay       cone[0] = c + n * 1;
22409371c9d4SSatish Balay       cone[1] = (c + 1) % n + n * 1;
22419371c9d4SSatish Balay       cone[2] = 0 + 3 * n;
22429371c9d4SSatish Balay       cone[3] = c + n * 2;
22439371c9d4SSatish Balay       cone[4] = (c + 1) % n + n * 2;
22449371c9d4SSatish Balay       cone[5] = 1 + 3 * n;
22459566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCone(dm, c, cone));
22469566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCellType(dm, c, DM_POLYTOPE_TRI_PRISM_TENSOR));
224724119c2aSMatthew G. Knepley     }
22489566063dSJacob Faibussowitsch     PetscCall(DMPlexSymmetrize(dm));
22499566063dSJacob Faibussowitsch     PetscCall(DMPlexStratify(dm));
225024119c2aSMatthew G. Knepley   }
225148a46eb9SPierre Jolivet   for (v = numCells; v < numCells + numVertices; ++v) PetscCall(DMPlexSetCellType(dm, v, DM_POLYTOPE_POINT));
225224119c2aSMatthew G. Knepley   /* Create cylinder geometry */
225324119c2aSMatthew G. Knepley   {
225424119c2aSMatthew G. Knepley     Vec          coordinates;
225524119c2aSMatthew G. Knepley     PetscSection coordSection;
225624119c2aSMatthew G. Knepley     PetscScalar *coords;
2257412e9a14SMatthew G. Knepley     PetscInt     coordSize, c;
225824119c2aSMatthew G. Knepley 
225924119c2aSMatthew G. Knepley     /* Build coordinates */
22609566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &coordSection));
22619566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetNumFields(coordSection, 1));
22629566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
22639566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetChart(coordSection, numCells, numCells + numVertices));
226424119c2aSMatthew G. Knepley     for (v = numCells; v < numCells + numVertices; ++v) {
22659566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetDof(coordSection, v, dim));
22669566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
226724119c2aSMatthew G. Knepley     }
22689566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetUp(coordSection));
22699566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
22709566063dSJacob Faibussowitsch     PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
22719566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
22729566063dSJacob Faibussowitsch     PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
22739566063dSJacob Faibussowitsch     PetscCall(VecSetBlockSize(coordinates, dim));
22749566063dSJacob Faibussowitsch     PetscCall(VecSetType(coordinates, VECSTANDARD));
22759566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
227624119c2aSMatthew G. Knepley     for (c = 0; c < numCells; c++) {
22779371c9d4SSatish Balay       coords[(c + 0 * n) * dim + 0] = PetscCosReal(2.0 * c * PETSC_PI / n);
22789371c9d4SSatish Balay       coords[(c + 0 * n) * dim + 1] = PetscSinReal(2.0 * c * PETSC_PI / n);
22799371c9d4SSatish Balay       coords[(c + 0 * n) * dim + 2] = 1.0;
22809371c9d4SSatish Balay       coords[(c + 1 * n) * dim + 0] = PetscCosReal(2.0 * c * PETSC_PI / n);
22819371c9d4SSatish Balay       coords[(c + 1 * n) * dim + 1] = PetscSinReal(2.0 * c * PETSC_PI / n);
22829371c9d4SSatish Balay       coords[(c + 1 * n) * dim + 2] = 0.0;
228324119c2aSMatthew G. Knepley     }
2284dd400576SPatrick Sanan     if (rank == 0) {
22859371c9d4SSatish Balay       coords[(2 * n + 0) * dim + 0] = 0.0;
22869371c9d4SSatish Balay       coords[(2 * n + 0) * dim + 1] = 0.0;
22879371c9d4SSatish Balay       coords[(2 * n + 0) * dim + 2] = 1.0;
22889371c9d4SSatish Balay       coords[(2 * n + 1) * dim + 0] = 0.0;
22899371c9d4SSatish Balay       coords[(2 * n + 1) * dim + 1] = 0.0;
22909371c9d4SSatish Balay       coords[(2 * n + 1) * dim + 2] = 0.0;
22919fe9f049SMatthew G. Knepley     }
22929566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(coordinates, &coords));
22939566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, coordinates));
22949566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&coordinates));
229524119c2aSMatthew G. Knepley   }
229646139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
22979318fe57SMatthew G. Knepley   /* Interpolate */
22989566063dSJacob Faibussowitsch   if (interpolate) PetscCall(DMPlexInterpolateInPlace_Internal(dm));
22993ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
23009318fe57SMatthew G. Knepley }
23019318fe57SMatthew G. Knepley 
23029318fe57SMatthew G. Knepley /*@
23039318fe57SMatthew G. Knepley   DMPlexCreateWedgeCylinderMesh - Creates a mesh on the tensor product of the unit interval with the circle (cylinder) using wedges.
23049318fe57SMatthew G. Knepley 
23059318fe57SMatthew G. Knepley   Collective
23069318fe57SMatthew G. Knepley 
23079318fe57SMatthew G. Knepley   Input Parameters:
2308a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
23099318fe57SMatthew G. Knepley . n           - The number of wedges around the origin
23109318fe57SMatthew G. Knepley - interpolate - Create edges and faces
23119318fe57SMatthew G. Knepley 
23129318fe57SMatthew G. Knepley   Output Parameter:
2313a1cb98faSBarry Smith . dm - The `DM` object
23149318fe57SMatthew G. Knepley 
23159318fe57SMatthew G. Knepley   Level: beginner
23169318fe57SMatthew G. Knepley 
23171cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateHexCylinderMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
23189318fe57SMatthew G. Knepley @*/
2319d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateWedgeCylinderMesh(MPI_Comm comm, PetscInt n, PetscBool interpolate, DM *dm)
2320d71ae5a4SJacob Faibussowitsch {
23219318fe57SMatthew G. Knepley   PetscFunctionBegin;
23224f572ea9SToby Isaac   PetscAssertPointer(dm, 4);
23239566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
23249566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
23259566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateWedgeCylinderMesh_Internal(*dm, n, interpolate));
23263ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
232724119c2aSMatthew G. Knepley }
232824119c2aSMatthew G. Knepley 
2329d71ae5a4SJacob Faibussowitsch static inline PetscReal DiffNormReal(PetscInt dim, const PetscReal x[], const PetscReal y[])
2330d71ae5a4SJacob Faibussowitsch {
233165a81367SMatthew G. Knepley   PetscReal prod = 0.0;
233265a81367SMatthew G. Knepley   PetscInt  i;
233365a81367SMatthew G. Knepley   for (i = 0; i < dim; ++i) prod += PetscSqr(x[i] - y[i]);
233465a81367SMatthew G. Knepley   return PetscSqrtReal(prod);
233565a81367SMatthew G. Knepley }
2336dd2b43ebSStefano Zampini 
2337d71ae5a4SJacob Faibussowitsch static inline PetscReal DotReal(PetscInt dim, const PetscReal x[], const PetscReal y[])
2338d71ae5a4SJacob Faibussowitsch {
233965a81367SMatthew G. Knepley   PetscReal prod = 0.0;
234065a81367SMatthew G. Knepley   PetscInt  i;
234165a81367SMatthew G. Knepley   for (i = 0; i < dim; ++i) prod += x[i] * y[i];
234265a81367SMatthew G. Knepley   return prod;
234365a81367SMatthew G. Knepley }
234465a81367SMatthew G. Knepley 
234551a74b61SMatthew G. Knepley /* The first constant is the sphere radius */
2346d71ae5a4SJacob 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[])
2347d71ae5a4SJacob Faibussowitsch {
234851a74b61SMatthew G. Knepley   PetscReal r     = PetscRealPart(constants[0]);
234951a74b61SMatthew G. Knepley   PetscReal norm2 = 0.0, fac;
235051a74b61SMatthew G. Knepley   PetscInt  n     = uOff[1] - uOff[0], d;
235151a74b61SMatthew G. Knepley 
235251a74b61SMatthew G. Knepley   for (d = 0; d < n; ++d) norm2 += PetscSqr(PetscRealPart(u[d]));
235351a74b61SMatthew G. Knepley   fac = r / PetscSqrtReal(norm2);
235451a74b61SMatthew G. Knepley   for (d = 0; d < n; ++d) f0[d] = u[d] * fac;
235551a74b61SMatthew G. Knepley }
235651a74b61SMatthew G. Knepley 
2357d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateSphereMesh_Internal(DM dm, PetscInt dim, PetscBool simplex, PetscReal R)
2358d71ae5a4SJacob Faibussowitsch {
235965a81367SMatthew G. Knepley   const PetscInt embedDim = dim + 1;
236065a81367SMatthew G. Knepley   PetscSection   coordSection;
236165a81367SMatthew G. Knepley   Vec            coordinates;
236265a81367SMatthew G. Knepley   PetscScalar   *coords;
236365a81367SMatthew G. Knepley   PetscReal     *coordsIn;
236407c565c5SJose E. Roman   PetscInt       numCells, numEdges, numVerts = 0, firstVertex = 0, v, firstEdge, coordSize, d, e;
236565a81367SMatthew G. Knepley   PetscMPIInt    rank;
236665a81367SMatthew G. Knepley 
236765a81367SMatthew G. Knepley   PetscFunctionBegin;
23689318fe57SMatthew G. Knepley   PetscValidLogicalCollectiveBool(dm, simplex, 3);
236946139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
23709566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
23719566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, dim + 1));
23729566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
237365a81367SMatthew G. Knepley   switch (dim) {
23745c344501SMatthew G. Knepley   case 1:
23755c344501SMatthew G. Knepley     numCells = 16;
23765c344501SMatthew G. Knepley     numVerts = numCells;
23775c344501SMatthew G. Knepley 
23785c344501SMatthew G. Knepley     // Build Topology
23795c344501SMatthew G. Knepley     PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
23805c344501SMatthew G. Knepley     for (PetscInt c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
23815c344501SMatthew G. Knepley     PetscCall(DMSetUp(dm));
23825c344501SMatthew G. Knepley     for (PetscInt c = 0; c < numCells; ++c) {
23835c344501SMatthew G. Knepley       PetscInt cone[2];
23845c344501SMatthew G. Knepley 
23855c344501SMatthew G. Knepley       cone[0] = c + numCells;
23865c344501SMatthew G. Knepley       cone[1] = (c + 1) % numVerts + numCells;
23875c344501SMatthew G. Knepley       PetscCall(DMPlexSetCone(dm, c, cone));
23885c344501SMatthew G. Knepley     }
23895c344501SMatthew G. Knepley     PetscCall(DMPlexSymmetrize(dm));
23905c344501SMatthew G. Knepley     PetscCall(DMPlexStratify(dm));
23915c344501SMatthew G. Knepley     PetscCall(PetscMalloc1(numVerts * embedDim, &coordsIn));
23925c344501SMatthew G. Knepley     for (PetscInt v = 0; v < numVerts; ++v) {
23935c344501SMatthew G. Knepley       const PetscReal rad = 2. * PETSC_PI * v / numVerts;
23945c344501SMatthew G. Knepley 
23955c344501SMatthew G. Knepley       coordsIn[v * embedDim + 0] = PetscCosReal(rad);
23965c344501SMatthew G. Knepley       coordsIn[v * embedDim + 1] = PetscSinReal(rad);
23975c344501SMatthew G. Knepley     }
23985c344501SMatthew G. Knepley     break;
239965a81367SMatthew G. Knepley   case 2:
240065a81367SMatthew G. Knepley     if (simplex) {
240151a74b61SMatthew G. Knepley       const PetscReal radius    = PetscSqrtReal(1 + PETSC_PHI * PETSC_PHI) / (1.0 + PETSC_PHI);
240251a74b61SMatthew G. Knepley       const PetscReal edgeLen   = 2.0 / (1.0 + PETSC_PHI) * (R / radius);
240365a81367SMatthew G. Knepley       const PetscInt  degree    = 5;
240451a74b61SMatthew G. Knepley       PetscReal       vertex[3] = {0.0, 1.0 / (1.0 + PETSC_PHI), PETSC_PHI / (1.0 + PETSC_PHI)};
240565a81367SMatthew G. Knepley       PetscInt        s[3]      = {1, 1, 1};
240665a81367SMatthew G. Knepley       PetscInt        cone[3];
240707c565c5SJose E. Roman       PetscInt       *graph;
240865a81367SMatthew G. Knepley 
24099371c9d4SSatish Balay       vertex[0] *= R / radius;
24109371c9d4SSatish Balay       vertex[1] *= R / radius;
24119371c9d4SSatish Balay       vertex[2] *= R / radius;
2412dd400576SPatrick Sanan       numCells    = rank == 0 ? 20 : 0;
2413dd400576SPatrick Sanan       numVerts    = rank == 0 ? 12 : 0;
241465a81367SMatthew G. Knepley       firstVertex = numCells;
241551a74b61SMatthew G. Knepley       /* Use icosahedron, which for a R-sphere has coordinates which are all cyclic permutations of
241665a81367SMatthew G. Knepley 
241765a81367SMatthew G. Knepley            (0, \pm 1/\phi+1, \pm \phi/\phi+1)
241865a81367SMatthew G. Knepley 
241965a81367SMatthew G. Knepley          where \phi^2 - \phi - 1 = 0, meaning \phi is the golden ratio \frac{1 + \sqrt{5}}{2}. The edge
242051a74b61SMatthew G. Knepley          length is then given by 2/(1+\phi) = 2 * 0.38197 = 0.76393.
242165a81367SMatthew G. Knepley       */
242265a81367SMatthew G. Knepley       /* Construct vertices */
24239566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2424dd400576SPatrick Sanan       if (rank == 0) {
242507c565c5SJose E. Roman         for (PetscInt p = 0, i = 0; p < embedDim; ++p) {
242665a81367SMatthew G. Knepley           for (s[1] = -1; s[1] < 2; s[1] += 2) {
242765a81367SMatthew G. Knepley             for (s[2] = -1; s[2] < 2; s[2] += 2) {
242865a81367SMatthew G. Knepley               for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[(d + p) % embedDim] * vertex[(d + p) % embedDim];
242965a81367SMatthew G. Knepley               ++i;
243065a81367SMatthew G. Knepley             }
243165a81367SMatthew G. Knepley           }
243265a81367SMatthew G. Knepley         }
243345da822fSValeria Barra       }
243465a81367SMatthew G. Knepley       /* Construct graph */
24359566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * numVerts, &graph));
243607c565c5SJose E. Roman       for (PetscInt i = 0; i < numVerts; ++i) {
243707c565c5SJose E. Roman         PetscInt k = 0;
243807c565c5SJose E. Roman         for (PetscInt j = 0; j < numVerts; ++j) {
24399371c9d4SSatish Balay           if (PetscAbsReal(DiffNormReal(embedDim, &coordsIn[i * embedDim], &coordsIn[j * embedDim]) - edgeLen) < PETSC_SMALL) {
24409371c9d4SSatish Balay             graph[i * numVerts + j] = 1;
24419371c9d4SSatish Balay             ++k;
24429371c9d4SSatish Balay           }
244365a81367SMatthew G. Knepley         }
244463a3b9bcSJacob Faibussowitsch         PetscCheck(k == degree, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid icosahedron, vertex %" PetscInt_FMT " degree %" PetscInt_FMT " != %" PetscInt_FMT, i, k, degree);
244565a81367SMatthew G. Knepley       }
244665a81367SMatthew G. Knepley       /* Build Topology */
24479566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
244807c565c5SJose E. Roman       for (PetscInt c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
24499566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
245065a81367SMatthew G. Knepley       /* Cells */
245107c565c5SJose E. Roman       for (PetscInt i = 0, c = 0; i < numVerts; ++i) {
245207c565c5SJose E. Roman         for (PetscInt j = 0; j < i; ++j) {
245307c565c5SJose E. Roman           for (PetscInt k = 0; k < j; ++k) {
245465a81367SMatthew G. Knepley             if (graph[i * numVerts + j] && graph[j * numVerts + k] && graph[k * numVerts + i]) {
24559371c9d4SSatish Balay               cone[0] = firstVertex + i;
24569371c9d4SSatish Balay               cone[1] = firstVertex + j;
24579371c9d4SSatish Balay               cone[2] = firstVertex + k;
245865a81367SMatthew G. Knepley               /* Check orientation */
245965a81367SMatthew G. Knepley               {
24609371c9d4SSatish Balay                 const PetscInt epsilon[3][3][3] = {
24619371c9d4SSatish Balay                   {{0, 0, 0},  {0, 0, 1},  {0, -1, 0}},
24629371c9d4SSatish Balay                   {{0, 0, -1}, {0, 0, 0},  {1, 0, 0} },
24639371c9d4SSatish Balay                   {{0, 1, 0},  {-1, 0, 0}, {0, 0, 0} }
24649371c9d4SSatish Balay                 };
246565a81367SMatthew G. Knepley                 PetscReal normal[3];
246665a81367SMatthew G. Knepley                 PetscInt  e, f;
246765a81367SMatthew G. Knepley 
246865a81367SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) {
246965a81367SMatthew G. Knepley                   normal[d] = 0.0;
247065a81367SMatthew G. Knepley                   for (e = 0; e < embedDim; ++e) {
2471ad540459SPierre 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]);
247265a81367SMatthew G. Knepley                   }
247365a81367SMatthew G. Knepley                 }
24749371c9d4SSatish Balay                 if (DotReal(embedDim, normal, &coordsIn[i * embedDim]) < 0) {
24759371c9d4SSatish Balay                   PetscInt tmp = cone[1];
24769371c9d4SSatish Balay                   cone[1]      = cone[2];
24779371c9d4SSatish Balay                   cone[2]      = tmp;
247865a81367SMatthew G. Knepley                 }
247965a81367SMatthew G. Knepley               }
24809566063dSJacob Faibussowitsch               PetscCall(DMPlexSetCone(dm, c++, cone));
248165a81367SMatthew G. Knepley             }
248265a81367SMatthew G. Knepley           }
248365a81367SMatthew G. Knepley         }
248465a81367SMatthew G. Knepley       }
24859566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
24869566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
24879566063dSJacob Faibussowitsch       PetscCall(PetscFree(graph));
248865a81367SMatthew G. Knepley     } else {
24892829fed8SMatthew G. Knepley       /*
24902829fed8SMatthew G. Knepley         12-21--13
24912829fed8SMatthew G. Knepley          |     |
24922829fed8SMatthew G. Knepley         25  4  24
24932829fed8SMatthew G. Knepley          |     |
24942829fed8SMatthew G. Knepley   12-25--9-16--8-24--13
24952829fed8SMatthew G. Knepley    |     |     |     |
24962829fed8SMatthew G. Knepley   23  5 17  0 15  3  22
24972829fed8SMatthew G. Knepley    |     |     |     |
24982829fed8SMatthew G. Knepley   10-20--6-14--7-19--11
24992829fed8SMatthew G. Knepley          |     |
25002829fed8SMatthew G. Knepley         20  1  19
25012829fed8SMatthew G. Knepley          |     |
25022829fed8SMatthew G. Knepley         10-18--11
25032829fed8SMatthew G. Knepley          |     |
25042829fed8SMatthew G. Knepley         23  2  22
25052829fed8SMatthew G. Knepley          |     |
25062829fed8SMatthew G. Knepley         12-21--13
25072829fed8SMatthew G. Knepley        */
25082829fed8SMatthew G. Knepley       PetscInt cone[4], ornt[4];
25092829fed8SMatthew G. Knepley 
2510dd400576SPatrick Sanan       numCells    = rank == 0 ? 6 : 0;
2511dd400576SPatrick Sanan       numEdges    = rank == 0 ? 12 : 0;
2512dd400576SPatrick Sanan       numVerts    = rank == 0 ? 8 : 0;
251365a81367SMatthew G. Knepley       firstVertex = numCells;
251465a81367SMatthew G. Knepley       firstEdge   = numCells + numVerts;
25152829fed8SMatthew G. Knepley       /* Build Topology */
25169566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numEdges + numVerts));
251707c565c5SJose E. Roman       for (PetscInt c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 4));
251848a46eb9SPierre Jolivet       for (e = firstEdge; e < firstEdge + numEdges; ++e) PetscCall(DMPlexSetConeSize(dm, e, 2));
25199566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
2520dd400576SPatrick Sanan       if (rank == 0) {
25212829fed8SMatthew G. Knepley         /* Cell 0 */
25229371c9d4SSatish Balay         cone[0] = 14;
25239371c9d4SSatish Balay         cone[1] = 15;
25249371c9d4SSatish Balay         cone[2] = 16;
25259371c9d4SSatish Balay         cone[3] = 17;
25269566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
25279371c9d4SSatish Balay         ornt[0] = 0;
25289371c9d4SSatish Balay         ornt[1] = 0;
25299371c9d4SSatish Balay         ornt[2] = 0;
25309371c9d4SSatish Balay         ornt[3] = 0;
25319566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 0, ornt));
25322829fed8SMatthew G. Knepley         /* Cell 1 */
25339371c9d4SSatish Balay         cone[0] = 18;
25349371c9d4SSatish Balay         cone[1] = 19;
25359371c9d4SSatish Balay         cone[2] = 14;
25369371c9d4SSatish Balay         cone[3] = 20;
25379566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
25389371c9d4SSatish Balay         ornt[0] = 0;
25399371c9d4SSatish Balay         ornt[1] = 0;
25409371c9d4SSatish Balay         ornt[2] = -1;
25419371c9d4SSatish Balay         ornt[3] = 0;
25429566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 1, ornt));
25432829fed8SMatthew G. Knepley         /* Cell 2 */
25449371c9d4SSatish Balay         cone[0] = 21;
25459371c9d4SSatish Balay         cone[1] = 22;
25469371c9d4SSatish Balay         cone[2] = 18;
25479371c9d4SSatish Balay         cone[3] = 23;
25489566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
25499371c9d4SSatish Balay         ornt[0] = 0;
25509371c9d4SSatish Balay         ornt[1] = 0;
25519371c9d4SSatish Balay         ornt[2] = -1;
25529371c9d4SSatish Balay         ornt[3] = 0;
25539566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 2, ornt));
25542829fed8SMatthew G. Knepley         /* Cell 3 */
25559371c9d4SSatish Balay         cone[0] = 19;
25569371c9d4SSatish Balay         cone[1] = 22;
25579371c9d4SSatish Balay         cone[2] = 24;
25589371c9d4SSatish Balay         cone[3] = 15;
25599566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
25609371c9d4SSatish Balay         ornt[0] = -1;
25619371c9d4SSatish Balay         ornt[1] = -1;
25629371c9d4SSatish Balay         ornt[2] = 0;
25639371c9d4SSatish Balay         ornt[3] = -1;
25649566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 3, ornt));
25652829fed8SMatthew G. Knepley         /* Cell 4 */
25669371c9d4SSatish Balay         cone[0] = 16;
25679371c9d4SSatish Balay         cone[1] = 24;
25689371c9d4SSatish Balay         cone[2] = 21;
25699371c9d4SSatish Balay         cone[3] = 25;
25709566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
25719371c9d4SSatish Balay         ornt[0] = -1;
25729371c9d4SSatish Balay         ornt[1] = -1;
25739371c9d4SSatish Balay         ornt[2] = -1;
25749371c9d4SSatish Balay         ornt[3] = 0;
25759566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 4, ornt));
25762829fed8SMatthew G. Knepley         /* Cell 5 */
25779371c9d4SSatish Balay         cone[0] = 20;
25789371c9d4SSatish Balay         cone[1] = 17;
25799371c9d4SSatish Balay         cone[2] = 25;
25809371c9d4SSatish Balay         cone[3] = 23;
25819566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 5, cone));
25829371c9d4SSatish Balay         ornt[0] = -1;
25839371c9d4SSatish Balay         ornt[1] = -1;
25849371c9d4SSatish Balay         ornt[2] = -1;
25859371c9d4SSatish Balay         ornt[3] = -1;
25869566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 5, ornt));
25872829fed8SMatthew G. Knepley         /* Edges */
25889371c9d4SSatish Balay         cone[0] = 6;
25899371c9d4SSatish Balay         cone[1] = 7;
25909566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 14, cone));
25919371c9d4SSatish Balay         cone[0] = 7;
25929371c9d4SSatish Balay         cone[1] = 8;
25939566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 15, cone));
25949371c9d4SSatish Balay         cone[0] = 8;
25959371c9d4SSatish Balay         cone[1] = 9;
25969566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 16, cone));
25979371c9d4SSatish Balay         cone[0] = 9;
25989371c9d4SSatish Balay         cone[1] = 6;
25999566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 17, cone));
26009371c9d4SSatish Balay         cone[0] = 10;
26019371c9d4SSatish Balay         cone[1] = 11;
26029566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 18, cone));
26039371c9d4SSatish Balay         cone[0] = 11;
26049371c9d4SSatish Balay         cone[1] = 7;
26059566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 19, cone));
26069371c9d4SSatish Balay         cone[0] = 6;
26079371c9d4SSatish Balay         cone[1] = 10;
26089566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 20, cone));
26099371c9d4SSatish Balay         cone[0] = 12;
26109371c9d4SSatish Balay         cone[1] = 13;
26119566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 21, cone));
26129371c9d4SSatish Balay         cone[0] = 13;
26139371c9d4SSatish Balay         cone[1] = 11;
26149566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 22, cone));
26159371c9d4SSatish Balay         cone[0] = 10;
26169371c9d4SSatish Balay         cone[1] = 12;
26179566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 23, cone));
26189371c9d4SSatish Balay         cone[0] = 13;
26199371c9d4SSatish Balay         cone[1] = 8;
26209566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 24, cone));
26219371c9d4SSatish Balay         cone[0] = 12;
26229371c9d4SSatish Balay         cone[1] = 9;
26239566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 25, cone));
262445da822fSValeria Barra       }
26259566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
26269566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
26272829fed8SMatthew G. Knepley       /* Build coordinates */
26289566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2629dd400576SPatrick Sanan       if (rank == 0) {
26309371c9d4SSatish Balay         coordsIn[0 * embedDim + 0] = -R;
26319371c9d4SSatish Balay         coordsIn[0 * embedDim + 1] = R;
26329371c9d4SSatish Balay         coordsIn[0 * embedDim + 2] = -R;
26339371c9d4SSatish Balay         coordsIn[1 * embedDim + 0] = R;
26349371c9d4SSatish Balay         coordsIn[1 * embedDim + 1] = R;
26359371c9d4SSatish Balay         coordsIn[1 * embedDim + 2] = -R;
26369371c9d4SSatish Balay         coordsIn[2 * embedDim + 0] = R;
26379371c9d4SSatish Balay         coordsIn[2 * embedDim + 1] = -R;
26389371c9d4SSatish Balay         coordsIn[2 * embedDim + 2] = -R;
26399371c9d4SSatish Balay         coordsIn[3 * embedDim + 0] = -R;
26409371c9d4SSatish Balay         coordsIn[3 * embedDim + 1] = -R;
26419371c9d4SSatish Balay         coordsIn[3 * embedDim + 2] = -R;
26429371c9d4SSatish Balay         coordsIn[4 * embedDim + 0] = -R;
26439371c9d4SSatish Balay         coordsIn[4 * embedDim + 1] = R;
26449371c9d4SSatish Balay         coordsIn[4 * embedDim + 2] = R;
26459371c9d4SSatish Balay         coordsIn[5 * embedDim + 0] = R;
26469371c9d4SSatish Balay         coordsIn[5 * embedDim + 1] = R;
26479371c9d4SSatish Balay         coordsIn[5 * embedDim + 2] = R;
26489371c9d4SSatish Balay         coordsIn[6 * embedDim + 0] = -R;
26499371c9d4SSatish Balay         coordsIn[6 * embedDim + 1] = -R;
26509371c9d4SSatish Balay         coordsIn[6 * embedDim + 2] = R;
26519371c9d4SSatish Balay         coordsIn[7 * embedDim + 0] = R;
26529371c9d4SSatish Balay         coordsIn[7 * embedDim + 1] = -R;
26539371c9d4SSatish Balay         coordsIn[7 * embedDim + 2] = R;
265465a81367SMatthew G. Knepley       }
265545da822fSValeria Barra     }
265665a81367SMatthew G. Knepley     break;
265765a81367SMatthew G. Knepley   case 3:
2658116ded15SMatthew G. Knepley     if (simplex) {
2659116ded15SMatthew G. Knepley       const PetscReal edgeLen         = 1.0 / PETSC_PHI;
266051a74b61SMatthew G. Knepley       PetscReal       vertexA[4]      = {0.5, 0.5, 0.5, 0.5};
266151a74b61SMatthew G. Knepley       PetscReal       vertexB[4]      = {1.0, 0.0, 0.0, 0.0};
266251a74b61SMatthew G. Knepley       PetscReal       vertexC[4]      = {0.5, 0.5 * PETSC_PHI, 0.5 / PETSC_PHI, 0.0};
2663116ded15SMatthew G. Knepley       const PetscInt  degree          = 12;
2664116ded15SMatthew G. Knepley       PetscInt        s[4]            = {1, 1, 1};
26659371c9d4SSatish Balay       PetscInt        evenPerm[12][4] = {
26669371c9d4SSatish Balay         {0, 1, 2, 3},
26679371c9d4SSatish Balay         {0, 2, 3, 1},
26689371c9d4SSatish Balay         {0, 3, 1, 2},
26699371c9d4SSatish Balay         {1, 0, 3, 2},
26709371c9d4SSatish Balay         {1, 2, 0, 3},
26719371c9d4SSatish Balay         {1, 3, 2, 0},
26729371c9d4SSatish Balay         {2, 0, 1, 3},
26739371c9d4SSatish Balay         {2, 1, 3, 0},
26749371c9d4SSatish Balay         {2, 3, 0, 1},
26759371c9d4SSatish Balay         {3, 0, 2, 1},
26769371c9d4SSatish Balay         {3, 1, 0, 2},
26779371c9d4SSatish Balay         {3, 2, 1, 0}
26789371c9d4SSatish Balay       };
2679116ded15SMatthew G. Knepley       PetscInt  cone[4];
2680116ded15SMatthew G. Knepley       PetscInt *graph, p, i, j, k, l;
2681116ded15SMatthew G. Knepley 
26829371c9d4SSatish Balay       vertexA[0] *= R;
26839371c9d4SSatish Balay       vertexA[1] *= R;
26849371c9d4SSatish Balay       vertexA[2] *= R;
26859371c9d4SSatish Balay       vertexA[3] *= R;
26869371c9d4SSatish Balay       vertexB[0] *= R;
26879371c9d4SSatish Balay       vertexB[1] *= R;
26889371c9d4SSatish Balay       vertexB[2] *= R;
26899371c9d4SSatish Balay       vertexB[3] *= R;
26909371c9d4SSatish Balay       vertexC[0] *= R;
26919371c9d4SSatish Balay       vertexC[1] *= R;
26929371c9d4SSatish Balay       vertexC[2] *= R;
26939371c9d4SSatish Balay       vertexC[3] *= R;
2694dd400576SPatrick Sanan       numCells    = rank == 0 ? 600 : 0;
2695dd400576SPatrick Sanan       numVerts    = rank == 0 ? 120 : 0;
2696116ded15SMatthew G. Knepley       firstVertex = numCells;
2697116ded15SMatthew G. Knepley       /* Use the 600-cell, which for a unit sphere has coordinates which are
2698116ded15SMatthew G. Knepley 
2699116ded15SMatthew G. Knepley            1/2 (\pm 1, \pm 1,    \pm 1, \pm 1)                          16
2700116ded15SMatthew G. Knepley                (\pm 1,    0,       0,      0)  all cyclic permutations   8
2701116ded15SMatthew G. Knepley            1/2 (\pm 1, \pm phi, \pm 1/phi, 0)  all even permutations    96
2702116ded15SMatthew G. Knepley 
2703116ded15SMatthew G. Knepley          where \phi^2 - \phi - 1 = 0, meaning \phi is the golden ratio \frac{1 + \sqrt{5}}{2}. The edge
27046333ae4fSvaleriabarra          length is then given by 1/\phi = 0.61803.
2705116ded15SMatthew G. Knepley 
2706116ded15SMatthew G. Knepley          http://buzzard.pugetsound.edu/sage-practice/ch03s03.html
2707116ded15SMatthew G. Knepley          http://mathworld.wolfram.com/600-Cell.html
2708116ded15SMatthew G. Knepley       */
2709116ded15SMatthew G. Knepley       /* Construct vertices */
27109566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2711116ded15SMatthew G. Knepley       i = 0;
2712dd400576SPatrick Sanan       if (rank == 0) {
2713116ded15SMatthew G. Knepley         for (s[0] = -1; s[0] < 2; s[0] += 2) {
2714116ded15SMatthew G. Knepley           for (s[1] = -1; s[1] < 2; s[1] += 2) {
2715116ded15SMatthew G. Knepley             for (s[2] = -1; s[2] < 2; s[2] += 2) {
2716116ded15SMatthew G. Knepley               for (s[3] = -1; s[3] < 2; s[3] += 2) {
2717116ded15SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[d] * vertexA[d];
2718116ded15SMatthew G. Knepley                 ++i;
2719116ded15SMatthew G. Knepley               }
2720116ded15SMatthew G. Knepley             }
2721116ded15SMatthew G. Knepley           }
2722116ded15SMatthew G. Knepley         }
2723116ded15SMatthew G. Knepley         for (p = 0; p < embedDim; ++p) {
2724116ded15SMatthew G. Knepley           s[1] = s[2] = s[3] = 1;
2725116ded15SMatthew G. Knepley           for (s[0] = -1; s[0] < 2; s[0] += 2) {
2726116ded15SMatthew G. Knepley             for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[(d + p) % embedDim] * vertexB[(d + p) % embedDim];
2727116ded15SMatthew G. Knepley             ++i;
2728116ded15SMatthew G. Knepley           }
2729116ded15SMatthew G. Knepley         }
2730116ded15SMatthew G. Knepley         for (p = 0; p < 12; ++p) {
2731116ded15SMatthew G. Knepley           s[3] = 1;
2732116ded15SMatthew G. Knepley           for (s[0] = -1; s[0] < 2; s[0] += 2) {
2733116ded15SMatthew G. Knepley             for (s[1] = -1; s[1] < 2; s[1] += 2) {
2734116ded15SMatthew G. Knepley               for (s[2] = -1; s[2] < 2; s[2] += 2) {
2735116ded15SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[evenPerm[p][d]] * vertexC[evenPerm[p][d]];
2736116ded15SMatthew G. Knepley                 ++i;
2737116ded15SMatthew G. Knepley               }
2738116ded15SMatthew G. Knepley             }
2739116ded15SMatthew G. Knepley           }
2740116ded15SMatthew G. Knepley         }
274145da822fSValeria Barra       }
274263a3b9bcSJacob Faibussowitsch       PetscCheck(i == numVerts, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid 600-cell, vertices %" PetscInt_FMT " != %" PetscInt_FMT, i, numVerts);
2743116ded15SMatthew G. Knepley       /* Construct graph */
27449566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * numVerts, &graph));
2745116ded15SMatthew G. Knepley       for (i = 0; i < numVerts; ++i) {
2746116ded15SMatthew G. Knepley         for (j = 0, k = 0; j < numVerts; ++j) {
27479371c9d4SSatish Balay           if (PetscAbsReal(DiffNormReal(embedDim, &coordsIn[i * embedDim], &coordsIn[j * embedDim]) - edgeLen) < PETSC_SMALL) {
27489371c9d4SSatish Balay             graph[i * numVerts + j] = 1;
27499371c9d4SSatish Balay             ++k;
27509371c9d4SSatish Balay           }
2751116ded15SMatthew G. Knepley         }
275263a3b9bcSJacob Faibussowitsch         PetscCheck(k == degree, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid 600-cell, vertex %" PetscInt_FMT " degree %" PetscInt_FMT " != %" PetscInt_FMT, i, k, degree);
2753116ded15SMatthew G. Knepley       }
2754116ded15SMatthew G. Knepley       /* Build Topology */
27559566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
275607c565c5SJose E. Roman       for (PetscInt c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
27579566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
2758116ded15SMatthew G. Knepley       /* Cells */
2759dd400576SPatrick Sanan       if (rank == 0) {
276007c565c5SJose E. Roman         for (PetscInt i = 0, c = 0; i < numVerts; ++i) {
2761116ded15SMatthew G. Knepley           for (j = 0; j < i; ++j) {
2762116ded15SMatthew G. Knepley             for (k = 0; k < j; ++k) {
2763116ded15SMatthew G. Knepley               for (l = 0; l < k; ++l) {
27649371c9d4SSatish 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]) {
27659371c9d4SSatish Balay                   cone[0] = firstVertex + i;
27669371c9d4SSatish Balay                   cone[1] = firstVertex + j;
27679371c9d4SSatish Balay                   cone[2] = firstVertex + k;
27689371c9d4SSatish Balay                   cone[3] = firstVertex + l;
2769116ded15SMatthew G. Knepley                   /* Check orientation: https://ef.gy/linear-algebra:normal-vectors-in-higher-dimensional-spaces */
2770116ded15SMatthew G. Knepley                   {
27719371c9d4SSatish Balay                     const PetscInt epsilon[4][4][4][4] = {
27729371c9d4SSatish 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}}},
2773116ded15SMatthew G. Knepley 
27749371c9d4SSatish 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}}},
2775116ded15SMatthew G. Knepley 
27769371c9d4SSatish 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}}},
2777116ded15SMatthew G. Knepley 
27789371c9d4SSatish 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}} }
27799371c9d4SSatish Balay                     };
2780116ded15SMatthew G. Knepley                     PetscReal normal[4];
2781116ded15SMatthew G. Knepley                     PetscInt  e, f, g;
2782116ded15SMatthew G. Knepley 
2783116ded15SMatthew G. Knepley                     for (d = 0; d < embedDim; ++d) {
2784116ded15SMatthew G. Knepley                       normal[d] = 0.0;
2785116ded15SMatthew G. Knepley                       for (e = 0; e < embedDim; ++e) {
2786116ded15SMatthew G. Knepley                         for (f = 0; f < embedDim; ++f) {
2787116ded15SMatthew G. Knepley                           for (g = 0; g < embedDim; ++g) {
2788116ded15SMatthew 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]);
2789116ded15SMatthew G. Knepley                           }
2790116ded15SMatthew G. Knepley                         }
2791116ded15SMatthew G. Knepley                       }
2792116ded15SMatthew G. Knepley                     }
27939371c9d4SSatish Balay                     if (DotReal(embedDim, normal, &coordsIn[i * embedDim]) < 0) {
27949371c9d4SSatish Balay                       PetscInt tmp = cone[1];
27959371c9d4SSatish Balay                       cone[1]      = cone[2];
27969371c9d4SSatish Balay                       cone[2]      = tmp;
27979371c9d4SSatish Balay                     }
2798116ded15SMatthew G. Knepley                   }
27999566063dSJacob Faibussowitsch                   PetscCall(DMPlexSetCone(dm, c++, cone));
2800116ded15SMatthew G. Knepley                 }
2801116ded15SMatthew G. Knepley               }
2802116ded15SMatthew G. Knepley             }
2803116ded15SMatthew G. Knepley           }
2804116ded15SMatthew G. Knepley         }
280545da822fSValeria Barra       }
28069566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
28079566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
28089566063dSJacob Faibussowitsch       PetscCall(PetscFree(graph));
2809116ded15SMatthew G. Knepley     }
2810f4d061e9SPierre Jolivet     break;
2811d71ae5a4SJacob Faibussowitsch   default:
2812d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Unsupported dimension for sphere: %" PetscInt_FMT, dim);
281365a81367SMatthew G. Knepley   }
281465a81367SMatthew G. Knepley   /* Create coordinates */
28159566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
28169566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
28179566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, embedDim));
28189566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numVerts));
28192829fed8SMatthew G. Knepley   for (v = firstVertex; v < firstVertex + numVerts; ++v) {
28209566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, embedDim));
28219566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, embedDim));
28222829fed8SMatthew G. Knepley   }
28239566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
28249566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
28259566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
28269566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, embedDim));
28279566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
28289566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
28299566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
28309566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
28319371c9d4SSatish Balay   for (v = 0; v < numVerts; ++v)
2832ad540459SPierre Jolivet     for (d = 0; d < embedDim; ++d) coords[v * embedDim + d] = coordsIn[v * embedDim + d];
28339566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
28349566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
28359566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
28369566063dSJacob Faibussowitsch   PetscCall(PetscFree(coordsIn));
283751a74b61SMatthew G. Knepley   {
283851a74b61SMatthew G. Knepley     DM          cdm;
283951a74b61SMatthew G. Knepley     PetscDS     cds;
28409318fe57SMatthew G. Knepley     PetscScalar c = R;
284151a74b61SMatthew G. Knepley 
2842e44f6aebSMatthew G. Knepley     PetscCall(DMPlexCreateCoordinateSpace(dm, 1, PETSC_TRUE, snapToSphere));
28439566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
28449566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
28459566063dSJacob Faibussowitsch     PetscCall(PetscDSSetConstants(cds, 1, &c));
284651a74b61SMatthew G. Knepley   }
284746139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
28489318fe57SMatthew G. Knepley   /* Wait for coordinate creation before doing in-place modification */
28499566063dSJacob Faibussowitsch   if (simplex) PetscCall(DMPlexInterpolateInPlace_Internal(dm));
28503ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
28519318fe57SMatthew G. Knepley }
28529318fe57SMatthew G. Knepley 
2853b7f5c055SJed Brown typedef void (*TPSEvaluateFunc)(const PetscReal[], PetscReal *, PetscReal[], PetscReal (*)[3]);
2854b7f5c055SJed Brown 
2855b7f5c055SJed Brown /*
2856b7f5c055SJed Brown  The Schwarz P implicit surface is
2857b7f5c055SJed Brown 
2858b7f5c055SJed Brown      f(x) = cos(x0) + cos(x1) + cos(x2) = 0
2859b7f5c055SJed Brown */
2860d71ae5a4SJacob Faibussowitsch static void TPSEvaluate_SchwarzP(const PetscReal y[3], PetscReal *f, PetscReal grad[], PetscReal (*hess)[3])
2861d71ae5a4SJacob Faibussowitsch {
2862b7f5c055SJed Brown   PetscReal c[3] = {PetscCosReal(y[0] * PETSC_PI), PetscCosReal(y[1] * PETSC_PI), PetscCosReal(y[2] * PETSC_PI)};
2863b7f5c055SJed Brown   PetscReal g[3] = {-PetscSinReal(y[0] * PETSC_PI), -PetscSinReal(y[1] * PETSC_PI), -PetscSinReal(y[2] * PETSC_PI)};
2864b7f5c055SJed Brown   f[0]           = c[0] + c[1] + c[2];
2865b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) {
2866b7f5c055SJed Brown     grad[i] = PETSC_PI * g[i];
2867ad540459SPierre Jolivet     for (PetscInt j = 0; j < 3; j++) hess[i][j] = (i == j) ? -PetscSqr(PETSC_PI) * c[i] : 0.;
2868b7f5c055SJed Brown   }
2869b7f5c055SJed Brown }
2870b7f5c055SJed Brown 
28714663dae6SJed Brown // u[] is a tentative normal on input. Replace with the implicit function gradient in the same direction
2872d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSExtrudeNormalFunc_SchwarzP(PetscInt dim, PetscReal time, const PetscReal x[], PetscInt r, PetscScalar u[], void *ctx)
2873d71ae5a4SJacob Faibussowitsch {
2874ad540459SPierre Jolivet   for (PetscInt i = 0; i < 3; i++) u[i] = -PETSC_PI * PetscSinReal(x[i] * PETSC_PI);
28753ba16761SJacob Faibussowitsch   return PETSC_SUCCESS;
28764663dae6SJed Brown }
28774663dae6SJed Brown 
2878b7f5c055SJed Brown /*
2879b7f5c055SJed Brown  The Gyroid implicit surface is
2880b7f5c055SJed Brown 
2881b7f5c055SJed 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)
2882b7f5c055SJed Brown 
2883b7f5c055SJed Brown */
2884d71ae5a4SJacob Faibussowitsch static void TPSEvaluate_Gyroid(const PetscReal y[3], PetscReal *f, PetscReal grad[], PetscReal (*hess)[3])
2885d71ae5a4SJacob Faibussowitsch {
2886b7f5c055SJed Brown   PetscReal s[3] = {PetscSinReal(PETSC_PI * y[0]), PetscSinReal(PETSC_PI * (y[1] + .5)), PetscSinReal(PETSC_PI * (y[2] + .25))};
2887b7f5c055SJed Brown   PetscReal c[3] = {PetscCosReal(PETSC_PI * y[0]), PetscCosReal(PETSC_PI * (y[1] + .5)), PetscCosReal(PETSC_PI * (y[2] + .25))};
2888b7f5c055SJed Brown   f[0]           = s[0] * c[1] + s[1] * c[2] + s[2] * c[0];
2889b7f5c055SJed Brown   grad[0]        = PETSC_PI * (c[0] * c[1] - s[2] * s[0]);
2890b7f5c055SJed Brown   grad[1]        = PETSC_PI * (c[1] * c[2] - s[0] * s[1]);
2891b7f5c055SJed Brown   grad[2]        = PETSC_PI * (c[2] * c[0] - s[1] * s[2]);
2892b7f5c055SJed Brown   hess[0][0]     = -PetscSqr(PETSC_PI) * (s[0] * c[1] + s[2] * c[0]);
2893b7f5c055SJed Brown   hess[0][1]     = -PetscSqr(PETSC_PI) * (c[0] * s[1]);
2894b7f5c055SJed Brown   hess[0][2]     = -PetscSqr(PETSC_PI) * (c[2] * s[0]);
2895b7f5c055SJed Brown   hess[1][0]     = -PetscSqr(PETSC_PI) * (s[1] * c[2] + s[0] * c[1]);
2896b7f5c055SJed Brown   hess[1][1]     = -PetscSqr(PETSC_PI) * (c[1] * s[2]);
2897b7f5c055SJed Brown   hess[2][2]     = -PetscSqr(PETSC_PI) * (c[0] * s[1]);
2898b7f5c055SJed Brown   hess[2][0]     = -PetscSqr(PETSC_PI) * (s[2] * c[0] + s[1] * c[2]);
2899b7f5c055SJed Brown   hess[2][1]     = -PetscSqr(PETSC_PI) * (c[2] * s[0]);
2900b7f5c055SJed Brown   hess[2][2]     = -PetscSqr(PETSC_PI) * (c[1] * s[2]);
2901b7f5c055SJed Brown }
2902b7f5c055SJed Brown 
29034663dae6SJed Brown // u[] is a tentative normal on input. Replace with the implicit function gradient in the same direction
2904d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSExtrudeNormalFunc_Gyroid(PetscInt dim, PetscReal time, const PetscReal x[], PetscInt r, PetscScalar u[], void *ctx)
2905d71ae5a4SJacob Faibussowitsch {
29064663dae6SJed Brown   PetscReal s[3] = {PetscSinReal(PETSC_PI * x[0]), PetscSinReal(PETSC_PI * (x[1] + .5)), PetscSinReal(PETSC_PI * (x[2] + .25))};
29074663dae6SJed Brown   PetscReal c[3] = {PetscCosReal(PETSC_PI * x[0]), PetscCosReal(PETSC_PI * (x[1] + .5)), PetscCosReal(PETSC_PI * (x[2] + .25))};
29084663dae6SJed Brown   u[0]           = PETSC_PI * (c[0] * c[1] - s[2] * s[0]);
29094663dae6SJed Brown   u[1]           = PETSC_PI * (c[1] * c[2] - s[0] * s[1]);
29104663dae6SJed Brown   u[2]           = PETSC_PI * (c[2] * c[0] - s[1] * s[2]);
29113ba16761SJacob Faibussowitsch   return PETSC_SUCCESS;
29124663dae6SJed Brown }
29134663dae6SJed Brown 
2914b7f5c055SJed Brown /*
2915b7f5c055SJed Brown    We wish to solve
2916b7f5c055SJed Brown 
2917b7f5c055SJed Brown          min_y || y - x ||^2  subject to f(y) = 0
2918b7f5c055SJed Brown 
2919b7f5c055SJed Brown    Let g(y) = grad(f).  The minimization problem is equivalent to asking to satisfy
2920b7f5c055SJed 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
2921b7f5c055SJed Brown    tangent space and ask for both components in the tangent space to be zero.
2922b7f5c055SJed Brown 
2923b7f5c055SJed Brown    Take g to be a column vector and compute the "full QR" factorization Q R = g,
2924b7f5c055SJed Brown    where Q = I - 2 n n^T is a symmetric orthogonal matrix.
2925b7f5c055SJed Brown    The first column of Q is parallel to g so the remaining two columns span the null space.
2926b7f5c055SJed Brown    Let Qn = Q[:,1:] be those remaining columns.  Then Qn Qn^T is an orthogonal projector into the tangent space.
2927da81f932SPierre Jolivet    Since Q is symmetric, this is equivalent to multiplying by Q and taking the last two entries.
2928b7f5c055SJed Brown    In total, we have a system of 3 equations in 3 unknowns:
2929b7f5c055SJed Brown 
2930b7f5c055SJed Brown      f(y) = 0                       1 equation
2931b7f5c055SJed Brown      Qn^T (y - x) = 0               2 equations
2932b7f5c055SJed Brown 
2933b7f5c055SJed Brown    Here, we compute the residual and Jacobian of this system.
2934b7f5c055SJed Brown */
2935d71ae5a4SJacob Faibussowitsch static void TPSNearestPointResJac(TPSEvaluateFunc feval, const PetscScalar x[], const PetscScalar y[], PetscScalar res[], PetscScalar J[])
2936d71ae5a4SJacob Faibussowitsch {
2937b7f5c055SJed Brown   PetscReal yreal[3] = {PetscRealPart(y[0]), PetscRealPart(y[1]), PetscRealPart(y[2])};
2938b7f5c055SJed Brown   PetscReal d[3]     = {PetscRealPart(y[0] - x[0]), PetscRealPart(y[1] - x[1]), PetscRealPart(y[2] - x[2])};
29392f0490c0SSatish Balay   PetscReal f, grad[3], n[3], norm, norm_y[3], nd, nd_y[3], sign;
29409371c9d4SSatish Balay   PetscReal n_y[3][3] = {
29419371c9d4SSatish Balay     {0, 0, 0},
29429371c9d4SSatish Balay     {0, 0, 0},
29439371c9d4SSatish Balay     {0, 0, 0}
29449371c9d4SSatish Balay   };
2945b7f5c055SJed Brown 
2946b7f5c055SJed Brown   feval(yreal, &f, grad, n_y);
2947b7f5c055SJed Brown 
2948b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) n[i] = grad[i];
2949b7f5c055SJed Brown   norm = PetscSqrtReal(PetscSqr(n[0]) + PetscSqr(n[1]) + PetscSqr(n[2]));
2950ad540459SPierre Jolivet   for (PetscInt i = 0; i < 3; i++) norm_y[i] = 1. / norm * n[i] * n_y[i][i];
2951b7f5c055SJed Brown 
2952b7f5c055SJed Brown   // Define the Householder reflector
2953b7f5c055SJed Brown   sign = n[0] >= 0 ? 1. : -1.;
2954b7f5c055SJed Brown   n[0] += norm * sign;
2955b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) n_y[0][i] += norm_y[i] * sign;
2956b7f5c055SJed Brown 
2957b7f5c055SJed Brown   norm      = PetscSqrtReal(PetscSqr(n[0]) + PetscSqr(n[1]) + PetscSqr(n[2]));
2958b7f5c055SJed Brown   norm_y[0] = 1. / norm * (n[0] * n_y[0][0]);
2959b7f5c055SJed Brown   norm_y[1] = 1. / norm * (n[0] * n_y[0][1] + n[1] * n_y[1][1]);
2960b7f5c055SJed Brown   norm_y[2] = 1. / norm * (n[0] * n_y[0][2] + n[2] * n_y[2][2]);
2961b7f5c055SJed Brown 
2962b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) {
2963b7f5c055SJed Brown     n[i] /= norm;
2964b7f5c055SJed Brown     for (PetscInt j = 0; j < 3; j++) {
2965b7f5c055SJed Brown       // note that n[i] is n_old[i]/norm when executing the code below
2966b7f5c055SJed Brown       n_y[i][j] = n_y[i][j] / norm - n[i] / norm * norm_y[j];
2967b7f5c055SJed Brown     }
2968b7f5c055SJed Brown   }
2969b7f5c055SJed Brown 
2970b7f5c055SJed Brown   nd = n[0] * d[0] + n[1] * d[1] + n[2] * d[2];
2971b7f5c055SJed 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];
2972b7f5c055SJed Brown 
2973b7f5c055SJed Brown   res[0] = f;
2974b7f5c055SJed Brown   res[1] = d[1] - 2 * n[1] * nd;
2975b7f5c055SJed Brown   res[2] = d[2] - 2 * n[2] * nd;
2976b7f5c055SJed Brown   // J[j][i] is J_{ij} (column major)
2977b7f5c055SJed Brown   for (PetscInt j = 0; j < 3; j++) {
2978b7f5c055SJed Brown     J[0 + j * 3] = grad[j];
2979b7f5c055SJed Brown     J[1 + j * 3] = (j == 1) * 1. - 2 * (n_y[1][j] * nd + n[1] * nd_y[j]);
2980b7f5c055SJed Brown     J[2 + j * 3] = (j == 2) * 1. - 2 * (n_y[2][j] * nd + n[2] * nd_y[j]);
2981b7f5c055SJed Brown   }
2982b7f5c055SJed Brown }
2983b7f5c055SJed Brown 
2984b7f5c055SJed Brown /*
2985b7f5c055SJed Brown    Project x to the nearest point on the implicit surface using Newton's method.
2986b7f5c055SJed Brown */
2987d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSNearestPoint(TPSEvaluateFunc feval, PetscScalar x[])
2988d71ae5a4SJacob Faibussowitsch {
2989b7f5c055SJed Brown   PetscScalar y[3] = {x[0], x[1], x[2]}; // Initial guess
2990b7f5c055SJed Brown 
2991b7f5c055SJed Brown   PetscFunctionBegin;
2992b7f5c055SJed Brown   for (PetscInt iter = 0; iter < 10; iter++) {
2993b7f5c055SJed Brown     PetscScalar res[3], J[9];
2994b7f5c055SJed Brown     PetscReal   resnorm;
2995b7f5c055SJed Brown     TPSNearestPointResJac(feval, x, y, res, J);
2996b7f5c055SJed Brown     resnorm = PetscSqrtReal(PetscSqr(PetscRealPart(res[0])) + PetscSqr(PetscRealPart(res[1])) + PetscSqr(PetscRealPart(res[2])));
2997b7f5c055SJed Brown     if (0) { // Turn on this monitor if you need to confirm quadratic convergence
299863a3b9bcSJacob 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])));
2999b7f5c055SJed Brown     }
3000b7f5c055SJed Brown     if (resnorm < PETSC_SMALL) break;
3001b7f5c055SJed Brown 
3002b7f5c055SJed Brown     // Take the Newton step
30039566063dSJacob Faibussowitsch     PetscCall(PetscKernel_A_gets_inverse_A_3(J, 0., PETSC_FALSE, NULL));
3004b7f5c055SJed Brown     PetscKernel_v_gets_v_minus_A_times_w_3(y, J, res);
3005b7f5c055SJed Brown   }
3006b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) x[i] = y[i];
30073ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3008b7f5c055SJed Brown }
3009b7f5c055SJed Brown 
3010b7f5c055SJed Brown const char *const DMPlexTPSTypes[] = {"SCHWARZ_P", "GYROID", "DMPlexTPSType", "DMPLEX_TPS_", NULL};
3011b7f5c055SJed Brown 
3012d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateTPSMesh_Internal(DM dm, DMPlexTPSType tpstype, const PetscInt extent[], const DMBoundaryType periodic[], PetscBool tps_distribute, PetscInt refinements, PetscInt layers, PetscReal thickness)
3013d71ae5a4SJacob Faibussowitsch {
3014b7f5c055SJed Brown   PetscMPIInt rank;
3015b7f5c055SJed Brown   PetscInt    topoDim = 2, spaceDim = 3, numFaces = 0, numVertices = 0, numEdges = 0;
3016b7f5c055SJed Brown   PetscInt(*edges)[2] = NULL, *edgeSets = NULL;
3017b7f5c055SJed Brown   PetscInt           *cells_flat = NULL;
3018b7f5c055SJed Brown   PetscReal          *vtxCoords  = NULL;
3019b7f5c055SJed Brown   TPSEvaluateFunc     evalFunc   = NULL;
30208434afd1SBarry Smith   PetscSimplePointFn *normalFunc = NULL;
3021b7f5c055SJed Brown   DMLabel             label;
3022b7f5c055SJed Brown 
3023b7f5c055SJed Brown   PetscFunctionBegin;
302446139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
30259566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
302663a3b9bcSJacob 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);
3027b7f5c055SJed Brown   switch (tpstype) {
3028b7f5c055SJed Brown   case DMPLEX_TPS_SCHWARZ_P:
3029b7f5c055SJed 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");
3030c5853193SPierre Jolivet     if (rank == 0) {
3031b7f5c055SJed Brown       PetscInt(*cells)[6][4][4] = NULL; // [junction, junction-face, cell, conn]
3032b7f5c055SJed Brown       PetscInt  Njunctions = 0, Ncuts = 0, Npipes[3], vcount;
3033b7f5c055SJed Brown       PetscReal L = 1;
3034b7f5c055SJed Brown 
3035b7f5c055SJed Brown       Npipes[0]   = (extent[0] + 1) * extent[1] * extent[2];
3036b7f5c055SJed Brown       Npipes[1]   = extent[0] * (extent[1] + 1) * extent[2];
3037b7f5c055SJed Brown       Npipes[2]   = extent[0] * extent[1] * (extent[2] + 1);
3038b7f5c055SJed Brown       Njunctions  = extent[0] * extent[1] * extent[2];
3039b7f5c055SJed Brown       Ncuts       = 2 * (extent[0] * extent[1] + extent[1] * extent[2] + extent[2] * extent[0]);
3040b7f5c055SJed Brown       numVertices = 4 * (Npipes[0] + Npipes[1] + Npipes[2]) + 8 * Njunctions;
30419566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(3 * numVertices, &vtxCoords));
30429566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Njunctions, &cells));
30439566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Ncuts * 4, &edges));
30449566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Ncuts * 4, &edgeSets));
3045b7f5c055SJed Brown       // x-normal pipes
3046b7f5c055SJed Brown       vcount = 0;
3047b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0] + 1; i++) {
3048b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3049b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3050b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3051b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * i - 1) * L;
3052b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * j * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3053b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * k * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3054b7f5c055SJed Brown             }
3055b7f5c055SJed Brown           }
3056b7f5c055SJed Brown         }
3057b7f5c055SJed Brown       }
3058b7f5c055SJed Brown       // y-normal pipes
3059b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3060b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1] + 1; j++) {
3061b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3062b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3063b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * i * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3064b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * j - 1) * L;
3065b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * k * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3066b7f5c055SJed Brown             }
3067b7f5c055SJed Brown           }
3068b7f5c055SJed Brown         }
3069b7f5c055SJed Brown       }
3070b7f5c055SJed Brown       // z-normal pipes
3071b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3072b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3073b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2] + 1; k++) {
3074b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3075b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * i * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3076b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * j * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3077b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * k - 1) * L;
3078b7f5c055SJed Brown             }
3079b7f5c055SJed Brown           }
3080b7f5c055SJed Brown         }
3081b7f5c055SJed Brown       }
3082b7f5c055SJed Brown       // junctions
3083b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3084b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3085b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3086b7f5c055SJed Brown             const PetscInt J = (i * extent[1] + j) * extent[2] + k, Jvoff = (Npipes[0] + Npipes[1] + Npipes[2]) * 4 + J * 8;
3087b7f5c055SJed Brown             PetscCheck(vcount / 3 == Jvoff, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Unexpected vertex count");
3088b7f5c055SJed Brown             for (PetscInt ii = 0; ii < 2; ii++) {
3089b7f5c055SJed Brown               for (PetscInt jj = 0; jj < 2; jj++) {
3090b7f5c055SJed Brown                 for (PetscInt kk = 0; kk < 2; kk++) {
3091b7f5c055SJed Brown                   double Ls           = (1 - sqrt(2) / 4) * L;
3092b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * i * L + (2 * ii - 1) * Ls;
3093b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * j * L + (2 * jj - 1) * Ls;
3094b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * k * L + (2 * kk - 1) * Ls;
3095b7f5c055SJed Brown                 }
3096b7f5c055SJed Brown               }
3097b7f5c055SJed Brown             }
3098b7f5c055SJed Brown             const PetscInt jfaces[3][2][4] = {
3099b7f5c055SJed Brown               {{3, 1, 0, 2}, {7, 5, 4, 6}}, // x-aligned
3100b7f5c055SJed Brown               {{5, 4, 0, 1}, {7, 6, 2, 3}}, // y-aligned
3101b7f5c055SJed Brown               {{6, 2, 0, 4}, {7, 3, 1, 5}}  // z-aligned
3102b7f5c055SJed Brown             };
3103b7f5c055SJed Brown             const PetscInt pipe_lo[3] = {// vertex numbers of pipes
31049371c9d4SSatish 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};
3105b7f5c055SJed Brown             const PetscInt pipe_hi[3] = {// vertex numbers of pipes
31069371c9d4SSatish 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};
3107b7f5c055SJed Brown             for (PetscInt dir = 0; dir < 3; dir++) { // x,y,z
3108b7f5c055SJed Brown               const PetscInt ijk[3] = {i, j, k};
3109b7f5c055SJed Brown               for (PetscInt l = 0; l < 4; l++) { // rotations
3110b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][0] = pipe_lo[dir] + l;
3111b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][1] = Jvoff + jfaces[dir][0][l];
3112b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][2] = Jvoff + jfaces[dir][0][(l - 1 + 4) % 4];
3113b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][3] = pipe_lo[dir] + (l - 1 + 4) % 4;
3114b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][0] = Jvoff + jfaces[dir][1][l];
3115b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][1] = pipe_hi[dir] + l;
3116b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][2] = pipe_hi[dir] + (l - 1 + 4) % 4;
3117b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][3] = Jvoff + jfaces[dir][1][(l - 1 + 4) % 4];
3118b7f5c055SJed Brown                 if (ijk[dir] == 0) {
3119b7f5c055SJed Brown                   edges[numEdges][0] = pipe_lo[dir] + l;
3120b7f5c055SJed Brown                   edges[numEdges][1] = pipe_lo[dir] + (l + 1) % 4;
3121b7f5c055SJed Brown                   edgeSets[numEdges] = dir * 2 + 1;
3122b7f5c055SJed Brown                   numEdges++;
3123b7f5c055SJed Brown                 }
3124b7f5c055SJed Brown                 if (ijk[dir] + 1 == extent[dir]) {
3125b7f5c055SJed Brown                   edges[numEdges][0] = pipe_hi[dir] + l;
3126b7f5c055SJed Brown                   edges[numEdges][1] = pipe_hi[dir] + (l + 1) % 4;
3127b7f5c055SJed Brown                   edgeSets[numEdges] = dir * 2 + 2;
3128b7f5c055SJed Brown                   numEdges++;
3129b7f5c055SJed Brown                 }
3130b7f5c055SJed Brown               }
3131b7f5c055SJed Brown             }
3132b7f5c055SJed Brown           }
3133b7f5c055SJed Brown         }
3134b7f5c055SJed Brown       }
313563a3b9bcSJacob Faibussowitsch       PetscCheck(numEdges == Ncuts * 4, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Edge count %" PetscInt_FMT " incompatible with number of cuts %" PetscInt_FMT, numEdges, Ncuts);
3136b7f5c055SJed Brown       numFaces   = 24 * Njunctions;
3137b7f5c055SJed Brown       cells_flat = cells[0][0][0];
3138b7f5c055SJed Brown     }
3139b7f5c055SJed Brown     evalFunc   = TPSEvaluate_SchwarzP;
31404663dae6SJed Brown     normalFunc = TPSExtrudeNormalFunc_SchwarzP;
3141b7f5c055SJed Brown     break;
3142b7f5c055SJed Brown   case DMPLEX_TPS_GYROID:
3143c5853193SPierre Jolivet     if (rank == 0) {
3144b7f5c055SJed Brown       // This is a coarse mesh approximation of the gyroid shifted to being the zero of the level set
3145b7f5c055SJed Brown       //
3146b7f5c055SJed 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)
3147b7f5c055SJed Brown       //
3148b7f5c055SJed Brown       // on the cell [0,2]^3.
3149b7f5c055SJed Brown       //
3150b7f5c055SJed Brown       // Think about dividing that cell into four columns, and focus on the column [0,1]x[0,1]x[0,2].
3151b7f5c055SJed Brown       // If you looked at the gyroid in that column at different slices of z you would see that it kind of spins
3152b7f5c055SJed Brown       // like a boomerang:
3153b7f5c055SJed Brown       //
3154b7f5c055SJed Brown       //     z = 0          z = 1/4        z = 1/2        z = 3/4     //
3155b7f5c055SJed Brown       //     -----          -------        -------        -------     //
3156b7f5c055SJed Brown       //                                                              //
3157b7f5c055SJed Brown       //     +       +      +       +      +       +      +   \   +   //
3158b7f5c055SJed Brown       //      \                                   /            \      //
3159b7f5c055SJed Brown       //       \            `-_   _-'            /              }     //
3160b7f5c055SJed Brown       //        *-_            `-'            _-'              /      //
3161b7f5c055SJed Brown       //     +     `-+      +       +      +-'     +      +   /   +   //
3162b7f5c055SJed Brown       //                                                              //
3163b7f5c055SJed Brown       //                                                              //
3164b7f5c055SJed Brown       //     z = 1          z = 5/4        z = 3/2        z = 7/4     //
3165b7f5c055SJed Brown       //     -----          -------        -------        -------     //
3166b7f5c055SJed Brown       //                                                              //
3167b7f5c055SJed Brown       //     +-_     +      +       +      +     _-+      +   /   +   //
3168b7f5c055SJed Brown       //        `-_            _-_            _-`            /        //
3169b7f5c055SJed Brown       //           \        _-'   `-_        /              {         //
3170b7f5c055SJed Brown       //            \                       /                \        //
3171b7f5c055SJed Brown       //     +       +      +       +      +       +      +   \   +   //
3172b7f5c055SJed Brown       //
3173b7f5c055SJed Brown       //
3174b7f5c055SJed Brown       // This course mesh approximates each of these slices by two line segments,
3175b7f5c055SJed Brown       // and then connects the segments in consecutive layers with quadrilateral faces.
3176b7f5c055SJed Brown       // All of the end points of the segments are multiples of 1/4 except for the
3177b7f5c055SJed Brown       // point * in the picture for z = 0 above and the similar points in other layers.
3178b7f5c055SJed Brown       // That point is at (gamma, gamma, 0), where gamma is calculated below.
3179b7f5c055SJed Brown       //
3180b7f5c055SJed Brown       // The column  [1,2]x[1,2]x[0,2] looks the same as this column;
3181b7f5c055SJed Brown       // The columns [1,2]x[0,1]x[0,2] and [0,1]x[1,2]x[0,2] are mirror images.
3182b7f5c055SJed Brown       //
3183b7f5c055SJed Brown       // As for how this method turned into the names given to the vertices:
3184b7f5c055SJed Brown       // that was not systematic, it was just the way it worked out in my handwritten notes.
3185b7f5c055SJed Brown 
3186b7f5c055SJed Brown       PetscInt facesPerBlock = 64;
3187b7f5c055SJed Brown       PetscInt vertsPerBlock = 56;
3188b7f5c055SJed Brown       PetscInt extentPlus[3];
3189b7f5c055SJed Brown       PetscInt numBlocks, numBlocksPlus;
31909371c9d4SSatish 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;
31919371c9d4SSatish Balay       const PetscInt pattern[64][4] = {
31929371c9d4SSatish Balay         /* face to vertex within the coarse discretization of a single gyroid block */
3193b7f5c055SJed Brown         /* layer 0 */
31949371c9d4SSatish Balay         {A,           C,           K,           G          },
31959371c9d4SSatish Balay         {C,           B,           II,          K          },
31969371c9d4SSatish Balay         {D,           A,           H,           L          },
31979371c9d4SSatish Balay         {B + 56 * 1,  D,           L,           J          },
31989371c9d4SSatish Balay         {E,           B + 56 * 1,  J,           N          },
31999371c9d4SSatish Balay         {A + 56 * 2,  E,           N,           H + 56 * 2 },
32009371c9d4SSatish Balay         {F,           A + 56 * 2,  G + 56 * 2,  M          },
32019371c9d4SSatish Balay         {B,           F,           M,           II         },
3202b7f5c055SJed Brown         /* layer 1 */
32039371c9d4SSatish Balay         {G,           K,           Q,           O          },
32049371c9d4SSatish Balay         {K,           II,          P,           Q          },
32059371c9d4SSatish Balay         {L,           H,           O + 56 * 1,  R          },
32069371c9d4SSatish Balay         {J,           L,           R,           P          },
32079371c9d4SSatish Balay         {N,           J,           P,           S          },
32089371c9d4SSatish Balay         {H + 56 * 2,  N,           S,           O + 56 * 3 },
32099371c9d4SSatish Balay         {M,           G + 56 * 2,  O + 56 * 2,  T          },
32109371c9d4SSatish Balay         {II,          M,           T,           P          },
3211b7f5c055SJed Brown         /* layer 2 */
32129371c9d4SSatish Balay         {O,           Q,           Y,           U          },
32139371c9d4SSatish Balay         {Q,           P,           W,           Y          },
32149371c9d4SSatish Balay         {R,           O + 56 * 1,  U + 56 * 1,  Ap         },
32159371c9d4SSatish Balay         {P,           R,           Ap,          W          },
32169371c9d4SSatish Balay         {S,           P,           X,           Bp         },
32179371c9d4SSatish Balay         {O + 56 * 3,  S,           Bp,          V + 56 * 1 },
32189371c9d4SSatish Balay         {T,           O + 56 * 2,  V,           Z          },
32199371c9d4SSatish Balay         {P,           T,           Z,           X          },
3220b7f5c055SJed Brown         /* layer 3 */
32219371c9d4SSatish Balay         {U,           Y,           Ep,          Dp         },
32229371c9d4SSatish Balay         {Y,           W,           Cp,          Ep         },
32239371c9d4SSatish Balay         {Ap,          U + 56 * 1,  Dp + 56 * 1, Gp         },
32249371c9d4SSatish Balay         {W,           Ap,          Gp,          Cp         },
32259371c9d4SSatish Balay         {Bp,          X,           Cp + 56 * 2, Fp         },
32269371c9d4SSatish Balay         {V + 56 * 1,  Bp,          Fp,          Dp + 56 * 1},
32279371c9d4SSatish Balay         {Z,           V,           Dp,          Hp         },
32289371c9d4SSatish Balay         {X,           Z,           Hp,          Cp + 56 * 2},
3229b7f5c055SJed Brown         /* layer 4 */
32309371c9d4SSatish Balay         {Dp,          Ep,          Mp,          Kp         },
32319371c9d4SSatish Balay         {Ep,          Cp,          Ip,          Mp         },
32329371c9d4SSatish Balay         {Gp,          Dp + 56 * 1, Lp,          Np         },
32339371c9d4SSatish Balay         {Cp,          Gp,          Np,          Jp         },
32349371c9d4SSatish Balay         {Fp,          Cp + 56 * 2, Jp + 56 * 2, Pp         },
32359371c9d4SSatish Balay         {Dp + 56 * 1, Fp,          Pp,          Lp         },
32369371c9d4SSatish Balay         {Hp,          Dp,          Kp,          Op         },
32379371c9d4SSatish Balay         {Cp + 56 * 2, Hp,          Op,          Ip + 56 * 2},
3238b7f5c055SJed Brown         /* layer 5 */
32399371c9d4SSatish Balay         {Kp,          Mp,          Sp,          Rp         },
32409371c9d4SSatish Balay         {Mp,          Ip,          Qp,          Sp         },
32419371c9d4SSatish Balay         {Np,          Lp,          Rp,          Tp         },
32429371c9d4SSatish Balay         {Jp,          Np,          Tp,          Qp + 56 * 1},
32439371c9d4SSatish Balay         {Pp,          Jp + 56 * 2, Qp + 56 * 3, Up         },
32449371c9d4SSatish Balay         {Lp,          Pp,          Up,          Rp         },
32459371c9d4SSatish Balay         {Op,          Kp,          Rp,          Vp         },
32469371c9d4SSatish Balay         {Ip + 56 * 2, Op,          Vp,          Qp + 56 * 2},
3247b7f5c055SJed Brown         /* layer 6 */
32489371c9d4SSatish Balay         {Rp,          Sp,          Aq,          Yp         },
32499371c9d4SSatish Balay         {Sp,          Qp,          Wp,          Aq         },
32509371c9d4SSatish Balay         {Tp,          Rp,          Yp,          Cq         },
32519371c9d4SSatish Balay         {Qp + 56 * 1, Tp,          Cq,          Wp + 56 * 1},
32529371c9d4SSatish Balay         {Up,          Qp + 56 * 3, Xp + 56 * 1, Dq         },
32539371c9d4SSatish Balay         {Rp,          Up,          Dq,          Zp         },
32549371c9d4SSatish Balay         {Vp,          Rp,          Zp,          Bq         },
32559371c9d4SSatish Balay         {Qp + 56 * 2, Vp,          Bq,          Xp         },
3256b7f5c055SJed Brown         /* layer 7 (the top is the periodic image of the bottom of layer 0) */
32579371c9d4SSatish Balay         {Yp,          Aq,          C + 56 * 4,  A + 56 * 4 },
32589371c9d4SSatish Balay         {Aq,          Wp,          B + 56 * 4,  C + 56 * 4 },
32599371c9d4SSatish Balay         {Cq,          Yp,          A + 56 * 4,  D + 56 * 4 },
32609371c9d4SSatish Balay         {Wp + 56 * 1, Cq,          D + 56 * 4,  B + 56 * 5 },
32619371c9d4SSatish Balay         {Dq,          Xp + 56 * 1, B + 56 * 5,  E + 56 * 4 },
32629371c9d4SSatish Balay         {Zp,          Dq,          E + 56 * 4,  A + 56 * 6 },
32639371c9d4SSatish Balay         {Bq,          Zp,          A + 56 * 6,  F + 56 * 4 },
32649371c9d4SSatish Balay         {Xp,          Bq,          F + 56 * 4,  B + 56 * 4 }
3265b7f5c055SJed Brown       };
3266b7f5c055SJed Brown       const PetscReal gamma                = PetscAcosReal((PetscSqrtReal(3.) - 1.) / PetscSqrtReal(2.)) / PETSC_PI;
32679371c9d4SSatish Balay       const PetscReal patternCoords[56][3] = {
3268bee3fc89SBarry Smith         {1.,        0.,        0.  }, /* A  */
3269bee3fc89SBarry Smith         {0.,        1.,        0.  }, /* B  */
3270bee3fc89SBarry Smith         {gamma,     gamma,     0.  }, /* C  */
3271bee3fc89SBarry Smith         {1 + gamma, 1 - gamma, 0.  }, /* D  */
3272bee3fc89SBarry Smith         {2 - gamma, 2 - gamma, 0.  }, /* E  */
3273bee3fc89SBarry Smith         {1 - gamma, 1 + gamma, 0.  }, /* F  */
3274b7f5c055SJed Brown 
3275bee3fc89SBarry Smith         {.5,        0,         .25 }, /* G  */
3276bee3fc89SBarry Smith         {1.5,       0.,        .25 }, /* H  */
3277bee3fc89SBarry Smith         {.5,        1.,        .25 }, /* II */
3278bee3fc89SBarry Smith         {1.5,       1.,        .25 }, /* J  */
3279bee3fc89SBarry Smith         {.25,       .5,        .25 }, /* K  */
3280bee3fc89SBarry Smith         {1.25,      .5,        .25 }, /* L  */
3281bee3fc89SBarry Smith         {.75,       1.5,       .25 }, /* M  */
3282bee3fc89SBarry Smith         {1.75,      1.5,       .25 }, /* N  */
3283b7f5c055SJed Brown 
3284bee3fc89SBarry Smith         {0.,        0.,        .5  }, /* O  */
3285bee3fc89SBarry Smith         {1.,        1.,        .5  }, /* P  */
3286bee3fc89SBarry Smith         {gamma,     1 - gamma, .5  }, /* Q  */
3287bee3fc89SBarry Smith         {1 + gamma, gamma,     .5  }, /* R  */
3288bee3fc89SBarry Smith         {2 - gamma, 1 + gamma, .5  }, /* S  */
3289bee3fc89SBarry Smith         {1 - gamma, 2 - gamma, .5  }, /* T  */
3290b7f5c055SJed Brown 
3291bee3fc89SBarry Smith         {0.,        .5,        .75 }, /* U  */
3292bee3fc89SBarry Smith         {0.,        1.5,       .75 }, /* V  */
3293bee3fc89SBarry Smith         {1.,        .5,        .75 }, /* W  */
3294bee3fc89SBarry Smith         {1.,        1.5,       .75 }, /* X  */
3295bee3fc89SBarry Smith         {.5,        .75,       .75 }, /* Y  */
3296bee3fc89SBarry Smith         {.5,        1.75,      .75 }, /* Z  */
3297bee3fc89SBarry Smith         {1.5,       .25,       .75 }, /* Ap */
3298bee3fc89SBarry Smith         {1.5,       1.25,      .75 }, /* Bp */
3299b7f5c055SJed Brown 
3300bee3fc89SBarry Smith         {1.,        0.,        1.  }, /* Cp */
3301bee3fc89SBarry Smith         {0.,        1.,        1.  }, /* Dp */
3302bee3fc89SBarry Smith         {1 - gamma, 1 - gamma, 1.  }, /* Ep */
3303bee3fc89SBarry Smith         {1 + gamma, 1 + gamma, 1.  }, /* Fp */
3304bee3fc89SBarry Smith         {2 - gamma, gamma,     1.  }, /* Gp */
3305bee3fc89SBarry Smith         {gamma,     2 - gamma, 1.  }, /* Hp */
3306b7f5c055SJed Brown 
3307bee3fc89SBarry Smith         {.5,        0.,        1.25}, /* Ip */
3308bee3fc89SBarry Smith         {1.5,       0.,        1.25}, /* Jp */
3309bee3fc89SBarry Smith         {.5,        1.,        1.25}, /* Kp */
3310bee3fc89SBarry Smith         {1.5,       1.,        1.25}, /* Lp */
3311bee3fc89SBarry Smith         {.75,       .5,        1.25}, /* Mp */
3312bee3fc89SBarry Smith         {1.75,      .5,        1.25}, /* Np */
3313bee3fc89SBarry Smith         {.25,       1.5,       1.25}, /* Op */
3314bee3fc89SBarry Smith         {1.25,      1.5,       1.25}, /* Pp */
3315b7f5c055SJed Brown 
3316bee3fc89SBarry Smith         {0.,        0.,        1.5 }, /* Qp */
3317bee3fc89SBarry Smith         {1.,        1.,        1.5 }, /* Rp */
3318bee3fc89SBarry Smith         {1 - gamma, gamma,     1.5 }, /* Sp */
3319bee3fc89SBarry Smith         {2 - gamma, 1 - gamma, 1.5 }, /* Tp */
3320bee3fc89SBarry Smith         {1 + gamma, 2 - gamma, 1.5 }, /* Up */
3321bee3fc89SBarry Smith         {gamma,     1 + gamma, 1.5 }, /* Vp */
3322b7f5c055SJed Brown 
3323bee3fc89SBarry Smith         {0.,        .5,        1.75}, /* Wp */
3324bee3fc89SBarry Smith         {0.,        1.5,       1.75}, /* Xp */
3325bee3fc89SBarry Smith         {1.,        .5,        1.75}, /* Yp */
3326bee3fc89SBarry Smith         {1.,        1.5,       1.75}, /* Zp */
3327bee3fc89SBarry Smith         {.5,        .25,       1.75}, /* Aq */
3328bee3fc89SBarry Smith         {.5,        1.25,      1.75}, /* Bq */
3329bee3fc89SBarry Smith         {1.5,       .75,       1.75}, /* Cq */
3330bee3fc89SBarry Smith         {1.5,       1.75,      1.75}, /* Dq */
3331b7f5c055SJed Brown       };
3332b7f5c055SJed Brown       PetscInt(*cells)[64][4] = NULL;
3333b7f5c055SJed Brown       PetscBool *seen;
3334b7f5c055SJed Brown       PetscInt  *vertToTrueVert;
3335b7f5c055SJed Brown       PetscInt   count;
3336b7f5c055SJed Brown 
3337b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) extentPlus[i] = extent[i] + 1;
3338b7f5c055SJed Brown       numBlocks = 1;
3339b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) numBlocks *= extent[i];
3340b7f5c055SJed Brown       numBlocksPlus = 1;
3341b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) numBlocksPlus *= extentPlus[i];
3342b7f5c055SJed Brown       numFaces = numBlocks * facesPerBlock;
33439566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numBlocks, &cells));
33449566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numBlocksPlus * vertsPerBlock, &seen));
3345b7f5c055SJed Brown       for (PetscInt k = 0; k < extent[2]; k++) {
3346b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3347b7f5c055SJed Brown           for (PetscInt i = 0; i < extent[0]; i++) {
3348b7f5c055SJed Brown             for (PetscInt f = 0; f < facesPerBlock; f++) {
3349b7f5c055SJed Brown               for (PetscInt v = 0; v < 4; v++) {
3350b7f5c055SJed Brown                 PetscInt vertRaw     = pattern[f][v];
3351b7f5c055SJed Brown                 PetscInt blockidx    = vertRaw / 56;
3352b7f5c055SJed Brown                 PetscInt patternvert = vertRaw % 56;
3353b7f5c055SJed Brown                 PetscInt xplus       = (blockidx & 1);
3354b7f5c055SJed Brown                 PetscInt yplus       = (blockidx & 2) >> 1;
3355b7f5c055SJed Brown                 PetscInt zplus       = (blockidx & 4) >> 2;
3356b7f5c055SJed Brown                 PetscInt zcoord      = (periodic && periodic[2] == DM_BOUNDARY_PERIODIC) ? ((k + zplus) % extent[2]) : (k + zplus);
3357b7f5c055SJed Brown                 PetscInt ycoord      = (periodic && periodic[1] == DM_BOUNDARY_PERIODIC) ? ((j + yplus) % extent[1]) : (j + yplus);
3358b7f5c055SJed Brown                 PetscInt xcoord      = (periodic && periodic[0] == DM_BOUNDARY_PERIODIC) ? ((i + xplus) % extent[0]) : (i + xplus);
3359b7f5c055SJed Brown                 PetscInt vert        = ((zcoord * extentPlus[1] + ycoord) * extentPlus[0] + xcoord) * 56 + patternvert;
3360b7f5c055SJed Brown 
3361b7f5c055SJed Brown                 cells[(k * extent[1] + j) * extent[0] + i][f][v] = vert;
3362b7f5c055SJed Brown                 seen[vert]                                       = PETSC_TRUE;
3363b7f5c055SJed Brown               }
3364b7f5c055SJed Brown             }
3365b7f5c055SJed Brown           }
3366b7f5c055SJed Brown         }
3367b7f5c055SJed Brown       }
33689371c9d4SSatish Balay       for (PetscInt i = 0; i < numBlocksPlus * vertsPerBlock; i++)
33699371c9d4SSatish Balay         if (seen[i]) numVertices++;
3370b7f5c055SJed Brown       count = 0;
33719566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numBlocksPlus * vertsPerBlock, &vertToTrueVert));
33729566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numVertices * 3, &vtxCoords));
3373b7f5c055SJed Brown       for (PetscInt i = 0; i < numBlocksPlus * vertsPerBlock; i++) vertToTrueVert[i] = -1;
3374b7f5c055SJed Brown       for (PetscInt k = 0; k < extentPlus[2]; k++) {
3375b7f5c055SJed Brown         for (PetscInt j = 0; j < extentPlus[1]; j++) {
3376b7f5c055SJed Brown           for (PetscInt i = 0; i < extentPlus[0]; i++) {
3377b7f5c055SJed Brown             for (PetscInt v = 0; v < vertsPerBlock; v++) {
3378b7f5c055SJed Brown               PetscInt vIdx = ((k * extentPlus[1] + j) * extentPlus[0] + i) * vertsPerBlock + v;
3379b7f5c055SJed Brown 
3380b7f5c055SJed Brown               if (seen[vIdx]) {
3381b7f5c055SJed Brown                 PetscInt thisVert;
3382b7f5c055SJed Brown 
3383b7f5c055SJed Brown                 vertToTrueVert[vIdx] = thisVert = count++;
3384b7f5c055SJed Brown 
3385b7f5c055SJed Brown                 for (PetscInt d = 0; d < 3; d++) vtxCoords[3 * thisVert + d] = patternCoords[v][d];
3386b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 0] += i * 2;
3387b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 1] += j * 2;
3388b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 2] += k * 2;
3389b7f5c055SJed Brown               }
3390b7f5c055SJed Brown             }
3391b7f5c055SJed Brown           }
3392b7f5c055SJed Brown         }
3393b7f5c055SJed Brown       }
3394b7f5c055SJed Brown       for (PetscInt i = 0; i < numBlocks; i++) {
3395b7f5c055SJed Brown         for (PetscInt f = 0; f < facesPerBlock; f++) {
3396ad540459SPierre Jolivet           for (PetscInt v = 0; v < 4; v++) cells[i][f][v] = vertToTrueVert[cells[i][f][v]];
3397b7f5c055SJed Brown         }
3398b7f5c055SJed Brown       }
33999566063dSJacob Faibussowitsch       PetscCall(PetscFree(vertToTrueVert));
34009566063dSJacob Faibussowitsch       PetscCall(PetscFree(seen));
3401b7f5c055SJed Brown       cells_flat = cells[0][0];
3402b7f5c055SJed Brown       numEdges   = 0;
3403b7f5c055SJed Brown       for (PetscInt i = 0; i < numFaces; i++) {
3404b7f5c055SJed Brown         for (PetscInt e = 0; e < 4; e++) {
3405b7f5c055SJed Brown           PetscInt         ev[]       = {cells_flat[i * 4 + e], cells_flat[i * 4 + ((e + 1) % 4)]};
3406b7f5c055SJed Brown           const PetscReal *evCoords[] = {&vtxCoords[3 * ev[0]], &vtxCoords[3 * ev[1]]};
3407b7f5c055SJed Brown 
3408b7f5c055SJed Brown           for (PetscInt d = 0; d < 3; d++) {
3409b7f5c055SJed Brown             if (!periodic || periodic[0] != DM_BOUNDARY_PERIODIC) {
3410b7f5c055SJed Brown               if (evCoords[0][d] == 0. && evCoords[1][d] == 0.) numEdges++;
3411b7f5c055SJed Brown               if (evCoords[0][d] == 2. * extent[d] && evCoords[1][d] == 2. * extent[d]) numEdges++;
3412b7f5c055SJed Brown             }
3413b7f5c055SJed Brown           }
3414b7f5c055SJed Brown         }
3415b7f5c055SJed Brown       }
34169566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numEdges, &edges));
34179566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numEdges, &edgeSets));
3418b7f5c055SJed Brown       for (PetscInt edge = 0, i = 0; i < numFaces; i++) {
3419b7f5c055SJed Brown         for (PetscInt e = 0; e < 4; e++) {
3420b7f5c055SJed Brown           PetscInt         ev[]       = {cells_flat[i * 4 + e], cells_flat[i * 4 + ((e + 1) % 4)]};
3421b7f5c055SJed Brown           const PetscReal *evCoords[] = {&vtxCoords[3 * ev[0]], &vtxCoords[3 * ev[1]]};
3422b7f5c055SJed Brown 
3423b7f5c055SJed Brown           for (PetscInt d = 0; d < 3; d++) {
3424b7f5c055SJed Brown             if (!periodic || periodic[d] != DM_BOUNDARY_PERIODIC) {
3425b7f5c055SJed Brown               if (evCoords[0][d] == 0. && evCoords[1][d] == 0.) {
3426b7f5c055SJed Brown                 edges[edge][0]   = ev[0];
3427b7f5c055SJed Brown                 edges[edge][1]   = ev[1];
3428b7f5c055SJed Brown                 edgeSets[edge++] = 2 * d;
3429b7f5c055SJed Brown               }
3430b7f5c055SJed Brown               if (evCoords[0][d] == 2. * extent[d] && evCoords[1][d] == 2. * extent[d]) {
3431b7f5c055SJed Brown                 edges[edge][0]   = ev[0];
3432b7f5c055SJed Brown                 edges[edge][1]   = ev[1];
3433b7f5c055SJed Brown                 edgeSets[edge++] = 2 * d + 1;
3434b7f5c055SJed Brown               }
3435b7f5c055SJed Brown             }
3436b7f5c055SJed Brown           }
3437b7f5c055SJed Brown         }
3438b7f5c055SJed Brown       }
3439b7f5c055SJed Brown     }
3440b7f5c055SJed Brown     evalFunc   = TPSEvaluate_Gyroid;
34414663dae6SJed Brown     normalFunc = TPSExtrudeNormalFunc_Gyroid;
3442b7f5c055SJed Brown     break;
3443b7f5c055SJed Brown   }
3444b7f5c055SJed Brown 
34459566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, topoDim));
3446c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildFromCellList(dm, numFaces, numVertices, 4, cells_flat));
34479566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildFromCellList(dm, 0, 0, 0, NULL));
34489566063dSJacob Faibussowitsch   PetscCall(PetscFree(cells_flat));
3449b7f5c055SJed Brown   {
3450b7f5c055SJed Brown     DM idm;
34519566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(dm, &idm));
345269d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &idm));
3453b7f5c055SJed Brown   }
3454c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildCoordinatesFromCellList(dm, spaceDim, vtxCoords));
34559566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildCoordinatesFromCellList(dm, spaceDim, NULL));
34569566063dSJacob Faibussowitsch   PetscCall(PetscFree(vtxCoords));
3457b7f5c055SJed Brown 
34589566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "Face Sets"));
34599566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "Face Sets", &label));
3460b7f5c055SJed Brown   for (PetscInt e = 0; e < numEdges; e++) {
3461b7f5c055SJed Brown     PetscInt        njoin;
3462b7f5c055SJed Brown     const PetscInt *join, verts[] = {numFaces + edges[e][0], numFaces + edges[e][1]};
34639566063dSJacob Faibussowitsch     PetscCall(DMPlexGetJoin(dm, 2, verts, &njoin, &join));
346463a3b9bcSJacob 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]);
34659566063dSJacob Faibussowitsch     PetscCall(DMLabelSetValue(label, join[0], edgeSets[e]));
34669566063dSJacob Faibussowitsch     PetscCall(DMPlexRestoreJoin(dm, 2, verts, &njoin, &join));
3467b7f5c055SJed Brown   }
34689566063dSJacob Faibussowitsch   PetscCall(PetscFree(edges));
34699566063dSJacob Faibussowitsch   PetscCall(PetscFree(edgeSets));
34701436d7faSJed Brown   if (tps_distribute) {
34711436d7faSJed Brown     DM               pdm = NULL;
34721436d7faSJed Brown     PetscPartitioner part;
34731436d7faSJed Brown 
34749566063dSJacob Faibussowitsch     PetscCall(DMPlexGetPartitioner(dm, &part));
34759566063dSJacob Faibussowitsch     PetscCall(PetscPartitionerSetFromOptions(part));
34769566063dSJacob Faibussowitsch     PetscCall(DMPlexDistribute(dm, 0, NULL, &pdm));
347748a46eb9SPierre Jolivet     if (pdm) PetscCall(DMPlexReplace_Internal(dm, &pdm));
34781436d7faSJed Brown     // Do not auto-distribute again
34799566063dSJacob Faibussowitsch     PetscCall(DMPlexDistributeSetDefault(dm, PETSC_FALSE));
34801436d7faSJed Brown   }
3481b7f5c055SJed Brown 
34829566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
3483b7f5c055SJed Brown   for (PetscInt refine = 0; refine < refinements; refine++) {
3484b7f5c055SJed Brown     PetscInt     m;
3485b7f5c055SJed Brown     DM           dmf;
3486b7f5c055SJed Brown     Vec          X;
3487b7f5c055SJed Brown     PetscScalar *x;
34889566063dSJacob Faibussowitsch     PetscCall(DMRefine(dm, MPI_COMM_NULL, &dmf));
348969d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmf));
3490b7f5c055SJed Brown 
34919566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinatesLocal(dm, &X));
34929566063dSJacob Faibussowitsch     PetscCall(VecGetLocalSize(X, &m));
34939566063dSJacob Faibussowitsch     PetscCall(VecGetArray(X, &x));
349448a46eb9SPierre Jolivet     for (PetscInt i = 0; i < m; i += 3) PetscCall(TPSNearestPoint(evalFunc, &x[i]));
34959566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(X, &x));
3496b7f5c055SJed Brown   }
3497b7f5c055SJed Brown 
3498b7f5c055SJed Brown   // Face Sets has already been propagated to new vertices during refinement; this propagates to the initial vertices.
34999566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "Face Sets", &label));
35009566063dSJacob Faibussowitsch   PetscCall(DMPlexLabelComplete(dm, label));
3501b7f5c055SJed Brown 
350246139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
350346139095SJed Brown 
3504b7f5c055SJed Brown   if (thickness > 0) {
35054663dae6SJed Brown     DM              edm, cdm, ecdm;
35064663dae6SJed Brown     DMPlexTransform tr;
35074663dae6SJed Brown     const char     *prefix;
35084663dae6SJed Brown     PetscOptions    options;
35094663dae6SJed Brown     // Code from DMPlexExtrude
35104663dae6SJed Brown     PetscCall(DMPlexTransformCreate(PetscObjectComm((PetscObject)dm), &tr));
35114663dae6SJed Brown     PetscCall(DMPlexTransformSetDM(tr, dm));
35124663dae6SJed Brown     PetscCall(DMPlexTransformSetType(tr, DMPLEXEXTRUDE));
35134663dae6SJed Brown     PetscCall(PetscObjectGetOptionsPrefix((PetscObject)dm, &prefix));
35144663dae6SJed Brown     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)tr, prefix));
35154663dae6SJed Brown     PetscCall(PetscObjectGetOptions((PetscObject)dm, &options));
35164663dae6SJed Brown     PetscCall(PetscObjectSetOptions((PetscObject)tr, options));
35174663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetLayers(tr, layers));
35184663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetThickness(tr, thickness));
35194663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetTensor(tr, PETSC_FALSE));
35204663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetSymmetric(tr, PETSC_TRUE));
35214663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetNormalFunction(tr, normalFunc));
35224663dae6SJed Brown     PetscCall(DMPlexTransformSetFromOptions(tr));
35234663dae6SJed Brown     PetscCall(PetscObjectSetOptions((PetscObject)tr, NULL));
35244663dae6SJed Brown     PetscCall(DMPlexTransformSetUp(tr));
35254663dae6SJed Brown     PetscCall(PetscObjectViewFromOptions((PetscObject)tr, NULL, "-dm_plex_tps_transform_view"));
35264663dae6SJed Brown     PetscCall(DMPlexTransformApply(tr, dm, &edm));
35274663dae6SJed Brown     PetscCall(DMCopyDisc(dm, edm));
35284663dae6SJed Brown     PetscCall(DMGetCoordinateDM(dm, &cdm));
35294663dae6SJed Brown     PetscCall(DMGetCoordinateDM(edm, &ecdm));
35304663dae6SJed Brown     PetscCall(DMCopyDisc(cdm, ecdm));
35314663dae6SJed Brown     PetscCall(DMPlexTransformCreateDiscLabels(tr, edm));
35324663dae6SJed Brown     PetscCall(DMPlexTransformDestroy(&tr));
35334663dae6SJed Brown     if (edm) {
35344663dae6SJed Brown       ((DM_Plex *)edm->data)->printFEM    = ((DM_Plex *)dm->data)->printFEM;
35354663dae6SJed Brown       ((DM_Plex *)edm->data)->printL2     = ((DM_Plex *)dm->data)->printL2;
3536f5867de0SMatthew G. Knepley       ((DM_Plex *)edm->data)->printLocate = ((DM_Plex *)dm->data)->printLocate;
35374663dae6SJed Brown     }
353869d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &edm));
3539b7f5c055SJed Brown   }
35403ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3541b7f5c055SJed Brown }
3542b7f5c055SJed Brown 
3543b7f5c055SJed Brown /*@
3544b7f5c055SJed Brown   DMPlexCreateTPSMesh - Create a distributed, interpolated mesh of a triply-periodic surface
3545b7f5c055SJed Brown 
3546b7f5c055SJed Brown   Collective
3547b7f5c055SJed Brown 
3548b7f5c055SJed Brown   Input Parameters:
3549a1cb98faSBarry Smith + comm           - The communicator for the `DM` object
3550b7f5c055SJed Brown . tpstype        - Type of triply-periodic surface
3551b7f5c055SJed Brown . extent         - Array of length 3 containing number of periods in each direction
355220f4b53cSBarry Smith . periodic       - array of length 3 with periodicity, or `NULL` for non-periodic
35531436d7faSJed Brown . tps_distribute - Distribute 2D manifold mesh prior to refinement and extrusion (more scalable)
3554817da375SSatish Balay . refinements    - Number of factor-of-2 refinements of 2D manifold mesh
35551436d7faSJed Brown . layers         - Number of cell layers extruded in normal direction
3556817da375SSatish Balay - thickness      - Thickness in normal direction
3557b7f5c055SJed Brown 
3558b7f5c055SJed Brown   Output Parameter:
3559a1cb98faSBarry Smith . dm - The `DM` object
3560a1cb98faSBarry Smith 
3561a1cb98faSBarry Smith   Level: beginner
3562b7f5c055SJed Brown 
3563b7f5c055SJed Brown   Notes:
356415229ffcSPierre Jolivet   This meshes the surface of the Schwarz P or Gyroid surfaces.  Schwarz P is the simplest member of the triply-periodic minimal surfaces.
35651d27aa22SBarry Smith   <https://en.wikipedia.org/wiki/Schwarz_minimal_surface#Schwarz_P_(%22Primitive%22)> and can be cut with "clean" boundaries.
35661d27aa22SBarry 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.
3567b7f5c055SJed Brown   Our implementation creates a very coarse mesh of the surface and refines (by 4-way splitting) as many times as requested.
3568b7f5c055SJed Brown   On each refinement, all vertices are projected to their nearest point on the surface.
3569b7f5c055SJed Brown   This projection could readily be extended to related surfaces.
3570b7f5c055SJed Brown 
35711d27aa22SBarry Smith   See {cite}`maskery2018insights`
35721d27aa22SBarry Smith 
35731d27aa22SBarry Smith   The face (edge) sets for the Schwarz P surface are numbered $1(-x), 2(+x), 3(-y), 4(+y), 5(-z), 6(+z)$.
35741d27aa22SBarry Smith   When the mesh is refined, "Face Sets" contain the new vertices (created during refinement).
35751d27aa22SBarry Smith   Use `DMPlexLabelComplete()` to propagate to coarse-level vertices.
3576b7f5c055SJed Brown 
357760225df5SJacob Faibussowitsch   Developer Notes:
3578b7f5c055SJed Brown   The Gyroid mesh does not currently mark boundary sets.
3579b7f5c055SJed Brown 
35801cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateSphereMesh()`, `DMSetType()`, `DMCreate()`
3581b7f5c055SJed Brown @*/
3582d71ae5a4SJacob 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)
3583d71ae5a4SJacob Faibussowitsch {
3584b7f5c055SJed Brown   PetscFunctionBegin;
35859566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
35869566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
35879566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateTPSMesh_Internal(*dm, tpstype, extent, periodic, tps_distribute, refinements, layers, thickness));
35883ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3589b7f5c055SJed Brown }
3590b7f5c055SJed Brown 
35919318fe57SMatthew G. Knepley /*@
35929318fe57SMatthew G. Knepley   DMPlexCreateSphereMesh - Creates a mesh on the d-dimensional sphere, S^d.
35939318fe57SMatthew G. Knepley 
35949318fe57SMatthew G. Knepley   Collective
35959318fe57SMatthew G. Knepley 
35969318fe57SMatthew G. Knepley   Input Parameters:
3597a1cb98faSBarry Smith + comm    - The communicator for the `DM` object
35989318fe57SMatthew G. Knepley . dim     - The dimension
35999318fe57SMatthew G. Knepley . simplex - Use simplices, or tensor product cells
36009318fe57SMatthew G. Knepley - R       - The radius
36019318fe57SMatthew G. Knepley 
36029318fe57SMatthew G. Knepley   Output Parameter:
3603a1cb98faSBarry Smith . dm - The `DM` object
36049318fe57SMatthew G. Knepley 
36059318fe57SMatthew G. Knepley   Level: beginner
36069318fe57SMatthew G. Knepley 
36071cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBallMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
36089318fe57SMatthew G. Knepley @*/
3609d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateSphereMesh(MPI_Comm comm, PetscInt dim, PetscBool simplex, PetscReal R, DM *dm)
3610d71ae5a4SJacob Faibussowitsch {
36119318fe57SMatthew G. Knepley   PetscFunctionBegin;
36124f572ea9SToby Isaac   PetscAssertPointer(dm, 5);
36139566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
36149566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
36159566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateSphereMesh_Internal(*dm, dim, simplex, R));
36163ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
36179318fe57SMatthew G. Knepley }
36189318fe57SMatthew G. Knepley 
3619d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBallMesh_Internal(DM dm, PetscInt dim, PetscReal R)
3620d71ae5a4SJacob Faibussowitsch {
36219318fe57SMatthew G. Knepley   DM          sdm, vol;
36229318fe57SMatthew G. Knepley   DMLabel     bdlabel;
3623dd2b43ebSStefano Zampini   const char *prefix;
36249318fe57SMatthew G. Knepley 
36259318fe57SMatthew G. Knepley   PetscFunctionBegin;
36269566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &sdm));
36279566063dSJacob Faibussowitsch   PetscCall(DMSetType(sdm, DMPLEX));
3628dd2b43ebSStefano Zampini   PetscCall(DMGetOptionsPrefix(dm, &prefix));
3629dd2b43ebSStefano Zampini   PetscCall(DMSetOptionsPrefix(sdm, prefix));
3630dd2b43ebSStefano Zampini   PetscCall(DMAppendOptionsPrefix(sdm, "bd_"));
3631dd2b43ebSStefano Zampini   PetscCall(DMPlexDistributeSetDefault(sdm, PETSC_FALSE));
36329566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateSphereMesh_Internal(sdm, dim - 1, PETSC_TRUE, R));
36339566063dSJacob Faibussowitsch   PetscCall(DMSetFromOptions(sdm));
36349566063dSJacob Faibussowitsch   PetscCall(DMViewFromOptions(sdm, NULL, "-dm_view"));
36359566063dSJacob Faibussowitsch   PetscCall(DMPlexGenerate(sdm, NULL, PETSC_TRUE, &vol));
36369566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&sdm));
363769d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
36389566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "marker"));
36399566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "marker", &bdlabel));
36409566063dSJacob Faibussowitsch   PetscCall(DMPlexMarkBoundaryFaces(dm, PETSC_DETERMINE, bdlabel));
36419566063dSJacob Faibussowitsch   PetscCall(DMPlexLabelComplete(dm, bdlabel));
36423ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
364351a74b61SMatthew G. Knepley }
364451a74b61SMatthew G. Knepley 
364551a74b61SMatthew G. Knepley /*@
364651a74b61SMatthew G. Knepley   DMPlexCreateBallMesh - Creates a simplex mesh on the d-dimensional ball, B^d.
364751a74b61SMatthew G. Knepley 
364851a74b61SMatthew G. Knepley   Collective
364951a74b61SMatthew G. Knepley 
365051a74b61SMatthew G. Knepley   Input Parameters:
3651a1cb98faSBarry Smith + comm - The communicator for the `DM` object
365251a74b61SMatthew G. Knepley . dim  - The dimension
365351a74b61SMatthew G. Knepley - R    - The radius
365451a74b61SMatthew G. Knepley 
365551a74b61SMatthew G. Knepley   Output Parameter:
3656a1cb98faSBarry Smith . dm - The `DM` object
365751a74b61SMatthew G. Knepley 
3658a1cb98faSBarry Smith   Options Database Key:
365960225df5SJacob Faibussowitsch . bd_dm_refine - This will refine the surface mesh preserving the sphere geometry
366051a74b61SMatthew G. Knepley 
366151a74b61SMatthew G. Knepley   Level: beginner
366251a74b61SMatthew G. Knepley 
36631cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateSphereMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
366451a74b61SMatthew G. Knepley @*/
3665d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateBallMesh(MPI_Comm comm, PetscInt dim, PetscReal R, DM *dm)
3666d71ae5a4SJacob Faibussowitsch {
366751a74b61SMatthew G. Knepley   PetscFunctionBegin;
36689566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
36699566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
36709566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBallMesh_Internal(*dm, dim, R));
36713ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
36722829fed8SMatthew G. Knepley }
36732829fed8SMatthew G. Knepley 
3674d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateReferenceCell_Internal(DM rdm, DMPolytopeType ct)
3675d71ae5a4SJacob Faibussowitsch {
36760a6ba040SMatthew G. Knepley   PetscFunctionBegin;
36779318fe57SMatthew G. Knepley   switch (ct) {
36789371c9d4SSatish Balay   case DM_POLYTOPE_POINT: {
36799318fe57SMatthew G. Knepley     PetscInt    numPoints[1]        = {1};
36809318fe57SMatthew G. Knepley     PetscInt    coneSize[1]         = {0};
36819318fe57SMatthew G. Knepley     PetscInt    cones[1]            = {0};
36829318fe57SMatthew G. Knepley     PetscInt    coneOrientations[1] = {0};
36839318fe57SMatthew G. Knepley     PetscScalar vertexCoords[1]     = {0.0};
36849318fe57SMatthew G. Knepley 
36859566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 0));
36869566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 0, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36879371c9d4SSatish Balay   } break;
36889371c9d4SSatish Balay   case DM_POLYTOPE_SEGMENT: {
36899318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {2, 1};
36909318fe57SMatthew G. Knepley     PetscInt    coneSize[3]         = {2, 0, 0};
36919318fe57SMatthew G. Knepley     PetscInt    cones[2]            = {1, 2};
36929318fe57SMatthew G. Knepley     PetscInt    coneOrientations[2] = {0, 0};
36939318fe57SMatthew G. Knepley     PetscScalar vertexCoords[2]     = {-1.0, 1.0};
36949318fe57SMatthew G. Knepley 
36959566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 1));
36969566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
36979371c9d4SSatish Balay   } break;
36989371c9d4SSatish Balay   case DM_POLYTOPE_POINT_PRISM_TENSOR: {
3699b5a892a1SMatthew G. Knepley     PetscInt    numPoints[2]        = {2, 1};
3700b5a892a1SMatthew G. Knepley     PetscInt    coneSize[3]         = {2, 0, 0};
3701b5a892a1SMatthew G. Knepley     PetscInt    cones[2]            = {1, 2};
3702b5a892a1SMatthew G. Knepley     PetscInt    coneOrientations[2] = {0, 0};
3703b5a892a1SMatthew G. Knepley     PetscScalar vertexCoords[2]     = {-1.0, 1.0};
3704b5a892a1SMatthew G. Knepley 
37059566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 1));
37069566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37079371c9d4SSatish Balay   } break;
37089371c9d4SSatish Balay   case DM_POLYTOPE_TRIANGLE: {
37099318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {3, 1};
37109318fe57SMatthew G. Knepley     PetscInt    coneSize[4]         = {3, 0, 0, 0};
37119318fe57SMatthew G. Knepley     PetscInt    cones[3]            = {1, 2, 3};
37129318fe57SMatthew G. Knepley     PetscInt    coneOrientations[3] = {0, 0, 0};
37139318fe57SMatthew G. Knepley     PetscScalar vertexCoords[6]     = {-1.0, -1.0, 1.0, -1.0, -1.0, 1.0};
37149318fe57SMatthew G. Knepley 
37159566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
37169566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37179371c9d4SSatish Balay   } break;
37189371c9d4SSatish Balay   case DM_POLYTOPE_QUADRILATERAL: {
37199318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
37209318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
37219318fe57SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
37229318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
37239318fe57SMatthew G. Knepley     PetscScalar vertexCoords[8]     = {-1.0, -1.0, 1.0, -1.0, 1.0, 1.0, -1.0, 1.0};
37249318fe57SMatthew G. Knepley 
37259566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
37269566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37279371c9d4SSatish Balay   } break;
37289371c9d4SSatish Balay   case DM_POLYTOPE_SEG_PRISM_TENSOR: {
37299318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
37309318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
37319318fe57SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
37329318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
37339318fe57SMatthew G. Knepley     PetscScalar vertexCoords[8]     = {-1.0, -1.0, 1.0, -1.0, -1.0, 1.0, 1.0, 1.0};
37349318fe57SMatthew G. Knepley 
37359566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
37369566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37379371c9d4SSatish Balay   } break;
37389371c9d4SSatish Balay   case DM_POLYTOPE_TETRAHEDRON: {
37399318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
37409318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
3741f0edb160SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
37429318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
3743f0edb160SMatthew 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};
37449318fe57SMatthew G. Knepley 
37459566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37469566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37479371c9d4SSatish Balay   } break;
37489371c9d4SSatish Balay   case DM_POLYTOPE_HEXAHEDRON: {
37499318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {8, 1};
37509318fe57SMatthew G. Knepley     PetscInt    coneSize[9]         = {8, 0, 0, 0, 0, 0, 0, 0, 0};
3751f0edb160SMatthew G. Knepley     PetscInt    cones[8]            = {1, 2, 3, 4, 5, 6, 7, 8};
37529318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
37539371c9d4SSatish 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};
37549318fe57SMatthew G. Knepley 
37559566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37569566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37579371c9d4SSatish Balay   } break;
37589371c9d4SSatish Balay   case DM_POLYTOPE_TRI_PRISM: {
37599318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {6, 1};
37609318fe57SMatthew G. Knepley     PetscInt    coneSize[7]         = {6, 0, 0, 0, 0, 0, 0};
3761f0edb160SMatthew G. Knepley     PetscInt    cones[6]            = {1, 2, 3, 4, 5, 6};
37629318fe57SMatthew G. Knepley     PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
37639371c9d4SSatish 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};
37649318fe57SMatthew G. Knepley 
37659566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37669566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37679371c9d4SSatish Balay   } break;
37689371c9d4SSatish Balay   case DM_POLYTOPE_TRI_PRISM_TENSOR: {
37699318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {6, 1};
37709318fe57SMatthew G. Knepley     PetscInt    coneSize[7]         = {6, 0, 0, 0, 0, 0, 0};
37719318fe57SMatthew G. Knepley     PetscInt    cones[6]            = {1, 2, 3, 4, 5, 6};
37729318fe57SMatthew G. Knepley     PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
37739371c9d4SSatish 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};
37749318fe57SMatthew G. Knepley 
37759566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37769566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37779371c9d4SSatish Balay   } break;
37789371c9d4SSatish Balay   case DM_POLYTOPE_QUAD_PRISM_TENSOR: {
37799318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {8, 1};
37809318fe57SMatthew G. Knepley     PetscInt    coneSize[9]         = {8, 0, 0, 0, 0, 0, 0, 0, 0};
37819318fe57SMatthew G. Knepley     PetscInt    cones[8]            = {1, 2, 3, 4, 5, 6, 7, 8};
37829318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
37839371c9d4SSatish 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};
37849318fe57SMatthew G. Knepley 
37859566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37869566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37879371c9d4SSatish Balay   } break;
37889371c9d4SSatish Balay   case DM_POLYTOPE_PYRAMID: {
37899318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {5, 1};
37909318fe57SMatthew G. Knepley     PetscInt    coneSize[6]         = {5, 0, 0, 0, 0, 0};
3791f0edb160SMatthew G. Knepley     PetscInt    cones[5]            = {1, 2, 3, 4, 5};
37929318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
37939371c9d4SSatish 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};
37949318fe57SMatthew G. Knepley 
37959566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
37969566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
37979371c9d4SSatish Balay   } break;
3798d71ae5a4SJacob Faibussowitsch   default:
3799d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)rdm), PETSC_ERR_ARG_WRONG, "Cannot create reference cell for cell type %s", DMPolytopeTypes[ct]);
38009318fe57SMatthew G. Knepley   }
38019318fe57SMatthew G. Knepley   {
38029318fe57SMatthew G. Knepley     PetscInt Nv, v;
38039318fe57SMatthew G. Knepley 
38049318fe57SMatthew G. Knepley     /* Must create the celltype label here so that we do not automatically try to compute the types */
38059566063dSJacob Faibussowitsch     PetscCall(DMCreateLabel(rdm, "celltype"));
38069566063dSJacob Faibussowitsch     PetscCall(DMPlexSetCellType(rdm, 0, ct));
38079566063dSJacob Faibussowitsch     PetscCall(DMPlexGetChart(rdm, NULL, &Nv));
38089566063dSJacob Faibussowitsch     for (v = 1; v < Nv; ++v) PetscCall(DMPlexSetCellType(rdm, v, DM_POLYTOPE_POINT));
38099318fe57SMatthew G. Knepley   }
38109566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolateInPlace_Internal(rdm));
38119566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)rdm, DMPolytopeTypes[ct]));
38123ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
38130a6ba040SMatthew G. Knepley }
38140a6ba040SMatthew G. Knepley 
38159318fe57SMatthew G. Knepley /*@
3816a1cb98faSBarry Smith   DMPlexCreateReferenceCell - Create a `DMPLEX` with the appropriate FEM reference cell
38179318fe57SMatthew G. Knepley 
38189318fe57SMatthew G. Knepley   Collective
38199318fe57SMatthew G. Knepley 
38209318fe57SMatthew G. Knepley   Input Parameters:
38219318fe57SMatthew G. Knepley + comm - The communicator
38229318fe57SMatthew G. Knepley - ct   - The cell type of the reference cell
38239318fe57SMatthew G. Knepley 
38249318fe57SMatthew G. Knepley   Output Parameter:
38259318fe57SMatthew G. Knepley . refdm - The reference cell
38269318fe57SMatthew G. Knepley 
38279318fe57SMatthew G. Knepley   Level: intermediate
38289318fe57SMatthew G. Knepley 
382942747ad1SJacob Faibussowitsch .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBoxMesh()`
38309318fe57SMatthew G. Knepley @*/
3831d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateReferenceCell(MPI_Comm comm, DMPolytopeType ct, DM *refdm)
3832d71ae5a4SJacob Faibussowitsch {
38330a6ba040SMatthew G. Knepley   PetscFunctionBegin;
38349566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, refdm));
38359566063dSJacob Faibussowitsch   PetscCall(DMSetType(*refdm, DMPLEX));
38369566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateReferenceCell_Internal(*refdm, ct));
38373ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
38389318fe57SMatthew G. Knepley }
383979a015ccSMatthew G. Knepley 
3840d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoundaryLabel_Private(DM dm, const char name[])
3841d71ae5a4SJacob Faibussowitsch {
38429318fe57SMatthew G. Knepley   DM        plex;
38439318fe57SMatthew G. Knepley   DMLabel   label;
38449318fe57SMatthew G. Knepley   PetscBool hasLabel;
38450a6ba040SMatthew G. Knepley 
3846c22d3578SMatthew G. Knepley   PetscFunctionBegin;
38479566063dSJacob Faibussowitsch   PetscCall(DMHasLabel(dm, name, &hasLabel));
38483ba16761SJacob Faibussowitsch   if (hasLabel) PetscFunctionReturn(PETSC_SUCCESS);
38499566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, name));
38509566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, name, &label));
38519566063dSJacob Faibussowitsch   PetscCall(DMConvert(dm, DMPLEX, &plex));
38529566063dSJacob Faibussowitsch   PetscCall(DMPlexMarkBoundaryFaces(plex, 1, label));
38531c8afea9SMatthew G. Knepley   PetscCall(DMPlexLabelComplete(plex, label));
38549566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&plex));
38553ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
38569318fe57SMatthew G. Knepley }
3857acdc6f61SToby Isaac 
3858669647acSMatthew G. Knepley /*
3859669647acSMatthew 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.
3860669647acSMatthew G. Knepley 
3861669647acSMatthew G. Knepley     (x, y) -> (r, theta) = (x[1], (x[0] - lower[0]) * 2\pi/(upper[0] - lower[0]))
3862669647acSMatthew G. Knepley */
3863d71ae5a4SJacob 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[])
3864d71ae5a4SJacob Faibussowitsch {
3865669647acSMatthew G. Knepley   const PetscReal low = PetscRealPart(constants[0]);
3866669647acSMatthew G. Knepley   const PetscReal upp = PetscRealPart(constants[1]);
3867669647acSMatthew G. Knepley   const PetscReal r   = PetscRealPart(u[1]);
3868669647acSMatthew G. Knepley   const PetscReal th  = 2. * PETSC_PI * (PetscRealPart(u[0]) - low) / (upp - low);
3869669647acSMatthew G. Knepley 
3870669647acSMatthew G. Knepley   f0[0] = r * PetscCosReal(th);
3871669647acSMatthew G. Knepley   f0[1] = r * PetscSinReal(th);
3872669647acSMatthew G. Knepley }
3873669647acSMatthew G. Knepley 
38744e22dd4cSMatthew G. Knepley PETSC_EXTERN PetscErrorCode PetscOptionsFindPairPrefix_Private(PetscOptions, const char pre[], const char name[], const char *option[], const char *value[], PetscBool *flg);
38754e22dd4cSMatthew G. Knepley 
38765dca41c3SJed Brown const char *const DMPlexShapes[] = {"box", "box_surface", "ball", "sphere", "cylinder", "schwarz_p", "gyroid", "doublet", "annulus", "hypercubic", "zbox", "unknown", "DMPlexShape", "DM_SHAPE_", NULL};
38779318fe57SMatthew G. Knepley 
3878d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateFromOptions_Internal(PetscOptionItems *PetscOptionsObject, PetscBool *useCoordSpace, DM dm)
3879d71ae5a4SJacob Faibussowitsch {
38809318fe57SMatthew G. Knepley   DMPlexShape    shape   = DM_SHAPE_BOX;
38819318fe57SMatthew G. Knepley   DMPolytopeType cell    = DM_POLYTOPE_TRIANGLE;
38829318fe57SMatthew G. Knepley   PetscInt       dim     = 2;
38839318fe57SMatthew G. Knepley   PetscBool      simplex = PETSC_TRUE, interpolate = PETSC_TRUE, adjCone = PETSC_FALSE, adjClosure = PETSC_TRUE, refDomain = PETSC_FALSE;
3884d0812dedSMatthew G. Knepley   PetscBool      flg, flg2, fflg, strflg, bdfflg, nameflg;
38859318fe57SMatthew G. Knepley   MPI_Comm       comm;
3886ed5e4e85SVaclav Hapla   char           filename[PETSC_MAX_PATH_LEN]   = "<unspecified>";
3887ed5e4e85SVaclav Hapla   char           bdFilename[PETSC_MAX_PATH_LEN] = "<unspecified>";
3888ed5e4e85SVaclav Hapla   char           plexname[PETSC_MAX_PATH_LEN]   = "";
38894e22dd4cSMatthew G. Knepley   const char    *option;
38909318fe57SMatthew G. Knepley 
38919318fe57SMatthew G. Knepley   PetscFunctionBegin;
3892708be2fdSJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_CreateFromOptions, dm, 0, 0, 0));
38939566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)dm, &comm));
38949318fe57SMatthew G. Knepley   /* TODO Turn this into a registration interface */
38959566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_filename", "File containing a mesh", "DMPlexCreateFromFile", filename, filename, sizeof(filename), &fflg));
3896d0812dedSMatthew G. Knepley   PetscCall(PetscOptionsString("-dm_plex_file_contents", "Contents of a file format in a string", "DMPlexCreateFromFile", filename, filename, sizeof(filename), &strflg));
38979566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_boundary_filename", "File containing a mesh boundary", "DMPlexCreateFromFile", bdFilename, bdFilename, sizeof(bdFilename), &bdfflg));
38989566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_name", "Name of the mesh in the file", "DMPlexCreateFromFile", plexname, plexname, sizeof(plexname), &nameflg));
38999566063dSJacob Faibussowitsch   PetscCall(PetscOptionsEnum("-dm_plex_cell", "Cell shape", "", DMPolytopeTypes, (PetscEnum)cell, (PetscEnum *)&cell, NULL));
39009566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_reference_cell_domain", "Use a reference cell domain", "", refDomain, &refDomain, NULL));
39019566063dSJacob Faibussowitsch   PetscCall(PetscOptionsEnum("-dm_plex_shape", "Shape for built-in mesh", "", DMPlexShapes, (PetscEnum)shape, (PetscEnum *)&shape, &flg));
39029566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_plex_dim", "Topological dimension of the mesh", "DMGetDimension", dim, &dim, &flg, 0));
39039566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_simplex", "Mesh cell shape", "", simplex, &simplex, &flg));
39049566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_interpolate", "Flag to create edges and faces automatically", "", interpolate, &interpolate, &flg));
39059566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_adj_cone", "Set adjacency direction", "DMSetBasicAdjacency", adjCone, &adjCone, &flg));
39069566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_adj_closure", "Set adjacency size", "DMSetBasicAdjacency", adjClosure, &adjClosure, &flg2));
39079566063dSJacob Faibussowitsch   if (flg || flg2) PetscCall(DMSetBasicAdjacency(dm, adjCone, adjClosure));
39089318fe57SMatthew G. Knepley 
390961a622f3SMatthew G. Knepley   switch (cell) {
391061a622f3SMatthew G. Knepley   case DM_POLYTOPE_POINT:
391161a622f3SMatthew G. Knepley   case DM_POLYTOPE_SEGMENT:
391261a622f3SMatthew G. Knepley   case DM_POLYTOPE_POINT_PRISM_TENSOR:
391361a622f3SMatthew G. Knepley   case DM_POLYTOPE_TRIANGLE:
391461a622f3SMatthew G. Knepley   case DM_POLYTOPE_QUADRILATERAL:
391561a622f3SMatthew G. Knepley   case DM_POLYTOPE_TETRAHEDRON:
3916d71ae5a4SJacob Faibussowitsch   case DM_POLYTOPE_HEXAHEDRON:
3917d71ae5a4SJacob Faibussowitsch     *useCoordSpace = PETSC_TRUE;
3918d71ae5a4SJacob Faibussowitsch     break;
3919d71ae5a4SJacob Faibussowitsch   default:
3920d71ae5a4SJacob Faibussowitsch     *useCoordSpace = PETSC_FALSE;
3921d71ae5a4SJacob Faibussowitsch     break;
392261a622f3SMatthew G. Knepley   }
392361a622f3SMatthew G. Knepley 
39249318fe57SMatthew G. Knepley   if (fflg) {
39259318fe57SMatthew G. Knepley     DM          dmnew;
39261e4a82c4SMatthew G. Knepley     const char *name;
39279318fe57SMatthew G. Knepley 
39281e4a82c4SMatthew G. Knepley     PetscCall(PetscObjectGetName((PetscObject)dm, &name));
39291e4a82c4SMatthew G. Knepley     PetscCall(DMPlexCreateFromFile(PetscObjectComm((PetscObject)dm), filename, nameflg ? plexname : name, interpolate, &dmnew));
39305de52c6dSVaclav Hapla     PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
393169d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmnew));
39329318fe57SMatthew G. Knepley   } else if (refDomain) {
39339566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateReferenceCell_Internal(dm, cell));
39349318fe57SMatthew G. Knepley   } else if (bdfflg) {
39359318fe57SMatthew G. Knepley     DM          bdm, dmnew;
39361e4a82c4SMatthew G. Knepley     const char *name;
39379318fe57SMatthew G. Knepley 
39381e4a82c4SMatthew G. Knepley     PetscCall(PetscObjectGetName((PetscObject)dm, &name));
39391e4a82c4SMatthew G. Knepley     PetscCall(DMPlexCreateFromFile(PetscObjectComm((PetscObject)dm), bdFilename, nameflg ? plexname : name, interpolate, &bdm));
39409566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)bdm, "bd_"));
39419566063dSJacob Faibussowitsch     PetscCall(DMSetFromOptions(bdm));
39429566063dSJacob Faibussowitsch     PetscCall(DMPlexGenerate(bdm, NULL, interpolate, &dmnew));
39439566063dSJacob Faibussowitsch     PetscCall(DMDestroy(&bdm));
39445de52c6dSVaclav Hapla     PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
394569d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmnew));
3946d0812dedSMatthew G. Knepley   } else if (strflg) {
3947d0812dedSMatthew G. Knepley     DM          dmnew;
3948d0812dedSMatthew G. Knepley     PetscViewer viewer;
3949d0812dedSMatthew G. Knepley     const char *contents;
3950d0812dedSMatthew G. Knepley     char       *strname;
3951d0812dedSMatthew G. Knepley     char        tmpdir[PETSC_MAX_PATH_LEN];
3952d0812dedSMatthew G. Knepley     char        tmpfilename[PETSC_MAX_PATH_LEN];
3953d0812dedSMatthew G. Knepley     char        name[PETSC_MAX_PATH_LEN];
3954d0812dedSMatthew G. Knepley     MPI_Comm    comm;
3955d0812dedSMatthew G. Knepley     PetscMPIInt rank;
3956d0812dedSMatthew G. Knepley 
3957d0812dedSMatthew G. Knepley     PetscCall(PetscObjectGetComm((PetscObject)dm, &comm));
3958d0812dedSMatthew G. Knepley     PetscCallMPI(MPI_Comm_rank(comm, &rank));
3959d0812dedSMatthew G. Knepley     PetscCall(PetscStrchr(filename, ':', &strname));
3960d0812dedSMatthew G. Knepley     PetscCheck(strname, comm, PETSC_ERR_ARG_WRONG, "File contents must have the form \"ext:string_name\", not %s", filename);
3961d0812dedSMatthew G. Knepley     strname[0] = '\0';
3962d0812dedSMatthew G. Knepley     ++strname;
3963d0812dedSMatthew G. Knepley     PetscCall(PetscDLSym(NULL, strname, (void **)&contents));
3964d0812dedSMatthew G. Knepley     PetscCheck(contents, comm, PETSC_ERR_ARG_WRONG, "Could not locate mesh string %s", strname);
3965d0812dedSMatthew G. Knepley     PetscCall(PetscGetTmp(comm, tmpdir, PETSC_MAX_PATH_LEN));
3966ed32af8cSMatthew G. Knepley     PetscCall(PetscStrlcat(tmpdir, "/meshXXXXXX", PETSC_MAX_PATH_LEN));
3967ed32af8cSMatthew G. Knepley     PetscCall(PetscMkdtemp(tmpdir));
3968ed32af8cSMatthew G. Knepley     PetscCall(PetscSNPrintf(tmpfilename, PETSC_MAX_PATH_LEN, "%s/mesh.%s", tmpdir, filename));
3969d0812dedSMatthew G. Knepley     PetscCall(PetscViewerASCIIOpen(comm, tmpfilename, &viewer));
3970d0812dedSMatthew G. Knepley     PetscCall(PetscViewerASCIIPrintf(viewer, "%s\n", contents));
3971d0812dedSMatthew G. Knepley     PetscCall(PetscViewerDestroy(&viewer));
3972d0812dedSMatthew G. Knepley     PetscCall(DMPlexCreateFromFile(PetscObjectComm((PetscObject)dm), tmpfilename, plexname, interpolate, &dmnew));
3973ed32af8cSMatthew G. Knepley     PetscCall(PetscRMTree(tmpdir));
3974d0812dedSMatthew G. Knepley     PetscCall(PetscSNPrintf(name, PETSC_MAX_PATH_LEN, "%s Mesh", strname));
3975d0812dedSMatthew G. Knepley     PetscCall(PetscObjectSetName((PetscObject)dm, name));
3976d0812dedSMatthew G. Knepley     PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
3977d0812dedSMatthew G. Knepley     PetscCall(DMPlexReplace_Internal(dm, &dmnew));
39789318fe57SMatthew G. Knepley   } else {
39799566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)dm, DMPlexShapes[shape]));
39809318fe57SMatthew G. Knepley     switch (shape) {
3981669647acSMatthew G. Knepley     case DM_SHAPE_BOX:
39825dca41c3SJed Brown     case DM_SHAPE_ZBOX:
3983669647acSMatthew G. Knepley     case DM_SHAPE_ANNULUS: {
39849318fe57SMatthew G. Knepley       PetscInt       faces[3]  = {0, 0, 0};
39859318fe57SMatthew G. Knepley       PetscReal      lower[3]  = {0, 0, 0};
39869318fe57SMatthew G. Knepley       PetscReal      upper[3]  = {1, 1, 1};
39879318fe57SMatthew G. Knepley       DMBoundaryType bdt[3]    = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
3988669647acSMatthew G. Knepley       PetscBool      isAnnular = shape == DM_SHAPE_ANNULUS ? PETSC_TRUE : PETSC_FALSE;
39899318fe57SMatthew G. Knepley       PetscInt       i, n;
39909318fe57SMatthew G. Knepley 
39919318fe57SMatthew G. Knepley       n = dim;
39929318fe57SMatthew G. Knepley       for (i = 0; i < dim; ++i) faces[i] = (dim == 1 ? 1 : 4 - dim);
39939566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", faces, &n, &flg));
39949318fe57SMatthew G. Knepley       n = 3;
39959566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
399663a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Lower box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
39979318fe57SMatthew G. Knepley       n = 3;
39989566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
399963a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Upper box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
40009318fe57SMatthew G. Knepley       n = 3;
40019566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnumArray("-dm_plex_box_bd", "Boundary type for each dimension", "", DMBoundaryTypes, (PetscEnum *)bdt, &n, &flg));
400263a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Box boundary types had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
4003669647acSMatthew G. Knepley 
4004669647acSMatthew G. Knepley       PetscCheck(!isAnnular || dim == 2, comm, PETSC_ERR_ARG_OUTOFRANGE, "Only two dimensional annuli have been implemented");
4005669647acSMatthew G. Knepley       if (isAnnular)
4006669647acSMatthew G. Knepley         for (i = 0; i < dim - 1; ++i) bdt[i] = DM_BOUNDARY_PERIODIC;
4007669647acSMatthew G. Knepley 
40089318fe57SMatthew G. Knepley       switch (cell) {
400961a622f3SMatthew G. Knepley       case DM_POLYTOPE_TRI_PRISM_TENSOR:
40109566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateWedgeBoxMesh_Internal(dm, faces, lower, upper, bdt));
4011d410b0cfSMatthew G. Knepley         if (!interpolate) {
4012d410b0cfSMatthew G. Knepley           DM udm;
4013d410b0cfSMatthew G. Knepley 
40149566063dSJacob Faibussowitsch           PetscCall(DMPlexUninterpolate(dm, &udm));
401569d8a87bSksagiyam           PetscCall(DMPlexReplace_Internal(dm, &udm));
4016d410b0cfSMatthew G. Knepley         }
40179318fe57SMatthew G. Knepley         break;
4018d71ae5a4SJacob Faibussowitsch       default:
40195dca41c3SJed Brown         PetscCall(DMPlexCreateBoxMesh_Internal(dm, shape, dim, simplex, faces, lower, upper, bdt, interpolate));
4020d71ae5a4SJacob Faibussowitsch         break;
40219318fe57SMatthew G. Knepley       }
4022669647acSMatthew G. Knepley       if (isAnnular) {
4023669647acSMatthew G. Knepley         DM          cdm;
4024669647acSMatthew G. Knepley         PetscDS     cds;
4025669647acSMatthew G. Knepley         PetscScalar bounds[2] = {lower[0], upper[0]};
4026669647acSMatthew G. Knepley 
4027669647acSMatthew G. Knepley         // Fix coordinates for annular region
4028669647acSMatthew G. Knepley         PetscCall(DMSetPeriodicity(dm, NULL, NULL, NULL));
4029669647acSMatthew G. Knepley         PetscCall(DMSetCellCoordinatesLocal(dm, NULL));
4030669647acSMatthew G. Knepley         PetscCall(DMSetCellCoordinates(dm, NULL));
4031e44f6aebSMatthew G. Knepley         PetscCall(DMPlexCreateCoordinateSpace(dm, 1, PETSC_TRUE, NULL));
4032669647acSMatthew G. Knepley         PetscCall(DMGetCoordinateDM(dm, &cdm));
4033669647acSMatthew G. Knepley         PetscCall(DMGetDS(cdm, &cds));
4034669647acSMatthew G. Knepley         PetscCall(PetscDSSetConstants(cds, 2, bounds));
4035669647acSMatthew G. Knepley         PetscCall(DMPlexRemapGeometry(dm, 0.0, boxToAnnulus));
4036669647acSMatthew G. Knepley       }
40379371c9d4SSatish Balay     } break;
40389371c9d4SSatish Balay     case DM_SHAPE_BOX_SURFACE: {
40399318fe57SMatthew G. Knepley       PetscInt  faces[3] = {0, 0, 0};
40409318fe57SMatthew G. Knepley       PetscReal lower[3] = {0, 0, 0};
40419318fe57SMatthew G. Knepley       PetscReal upper[3] = {1, 1, 1};
40429318fe57SMatthew G. Knepley       PetscInt  i, n;
40439318fe57SMatthew G. Knepley 
40449318fe57SMatthew G. Knepley       n = dim + 1;
40459318fe57SMatthew G. Knepley       for (i = 0; i < dim + 1; ++i) faces[i] = (dim + 1 == 1 ? 1 : 4 - (dim + 1));
40469566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", faces, &n, &flg));
40479318fe57SMatthew G. Knepley       n = 3;
40489566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
404963a3b9bcSJacob 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);
40509318fe57SMatthew G. Knepley       n = 3;
40519566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
405263a3b9bcSJacob 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);
40539566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateBoxSurfaceMesh_Internal(dm, dim + 1, faces, lower, upper, interpolate));
40549371c9d4SSatish Balay     } break;
40559371c9d4SSatish Balay     case DM_SHAPE_SPHERE: {
40569318fe57SMatthew G. Knepley       PetscReal R = 1.0;
40579318fe57SMatthew G. Knepley 
40589566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_sphere_radius", "Radius of the sphere", "", R, &R, &flg));
40599566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateSphereMesh_Internal(dm, dim, simplex, R));
40609371c9d4SSatish Balay     } break;
40619371c9d4SSatish Balay     case DM_SHAPE_BALL: {
40629318fe57SMatthew G. Knepley       PetscReal R = 1.0;
40639318fe57SMatthew G. Knepley 
40649566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_ball_radius", "Radius of the ball", "", R, &R, &flg));
40659566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateBallMesh_Internal(dm, dim, R));
40669371c9d4SSatish Balay     } break;
40679371c9d4SSatish Balay     case DM_SHAPE_CYLINDER: {
40689318fe57SMatthew G. Knepley       DMBoundaryType bdt = DM_BOUNDARY_NONE;
40699318fe57SMatthew G. Knepley       PetscInt       Nw  = 6;
40709318fe57SMatthew G. Knepley 
40719566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnum("-dm_plex_cylinder_bd", "Boundary type in the z direction", "", DMBoundaryTypes, (PetscEnum)bdt, (PetscEnum *)&bdt, NULL));
40729566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_cylinder_num_wedges", "Number of wedges around the cylinder", "", Nw, &Nw, NULL));
40739318fe57SMatthew G. Knepley       switch (cell) {
4074d71ae5a4SJacob Faibussowitsch       case DM_POLYTOPE_TRI_PRISM_TENSOR:
4075d71ae5a4SJacob Faibussowitsch         PetscCall(DMPlexCreateWedgeCylinderMesh_Internal(dm, Nw, interpolate));
4076d71ae5a4SJacob Faibussowitsch         break;
4077d71ae5a4SJacob Faibussowitsch       default:
4078d71ae5a4SJacob Faibussowitsch         PetscCall(DMPlexCreateHexCylinderMesh_Internal(dm, bdt));
4079d71ae5a4SJacob Faibussowitsch         break;
40809318fe57SMatthew G. Knepley       }
40819371c9d4SSatish Balay     } break;
4082b7f5c055SJed Brown     case DM_SHAPE_SCHWARZ_P: // fallthrough
40839371c9d4SSatish Balay     case DM_SHAPE_GYROID: {
4084b7f5c055SJed Brown       PetscInt       extent[3] = {1, 1, 1}, refine = 0, layers = 0, three;
4085b7f5c055SJed Brown       PetscReal      thickness   = 0.;
4086b7f5c055SJed Brown       DMBoundaryType periodic[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
4087b7f5c055SJed Brown       DMPlexTPSType  tps_type    = shape == DM_SHAPE_SCHWARZ_P ? DMPLEX_TPS_SCHWARZ_P : DMPLEX_TPS_GYROID;
40881436d7faSJed Brown       PetscBool      tps_distribute;
40899566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_tps_extent", "Number of replicas for each of three dimensions", NULL, extent, (three = 3, &three), NULL));
40909566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_tps_refine", "Number of refinements", NULL, refine, &refine, NULL));
40919566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnumArray("-dm_plex_tps_periodic", "Periodicity in each of three dimensions", NULL, DMBoundaryTypes, (PetscEnum *)periodic, (three = 3, &three), NULL));
40929566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_tps_layers", "Number of layers in volumetric extrusion (or zero to not extrude)", NULL, layers, &layers, NULL));
40939566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_tps_thickness", "Thickness of volumetric extrusion", NULL, thickness, &thickness, NULL));
40949566063dSJacob Faibussowitsch       PetscCall(DMPlexDistributeGetDefault(dm, &tps_distribute));
40959566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_tps_distribute", "Distribute the 2D mesh prior to refinement and extrusion", NULL, tps_distribute, &tps_distribute, NULL));
40969566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateTPSMesh_Internal(dm, tps_type, extent, periodic, tps_distribute, refine, layers, thickness));
40979371c9d4SSatish Balay     } break;
40989371c9d4SSatish Balay     case DM_SHAPE_DOUBLET: {
409905bd46c0SStefano Zampini       DM        dmnew;
410005bd46c0SStefano Zampini       PetscReal rl = 0.0;
410105bd46c0SStefano Zampini 
410205bd46c0SStefano Zampini       PetscCall(PetscOptionsReal("-dm_plex_doublet_refinementlimit", "Refinement limit", NULL, rl, &rl, NULL));
410305bd46c0SStefano Zampini       PetscCall(DMPlexCreateDoublet(PetscObjectComm((PetscObject)dm), dim, simplex, interpolate, rl, &dmnew));
41045de52c6dSVaclav Hapla       PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
410569d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &dmnew));
41069371c9d4SSatish Balay     } break;
4107cfb853baSMatthew G. Knepley     case DM_SHAPE_HYPERCUBIC: {
4108cfb853baSMatthew G. Knepley       PetscInt       *edges;
4109cfb853baSMatthew G. Knepley       PetscReal      *lower, *upper;
4110cfb853baSMatthew G. Knepley       DMBoundaryType *bdt;
4111cfb853baSMatthew G. Knepley       PetscInt        n, d;
4112cfb853baSMatthew G. Knepley 
4113cfb853baSMatthew G. Knepley       *useCoordSpace = PETSC_FALSE;
4114cfb853baSMatthew G. Knepley       PetscCall(PetscMalloc4(dim, &edges, dim, &lower, dim, &upper, dim, &bdt));
4115cfb853baSMatthew G. Knepley       for (d = 0; d < dim; ++d) {
4116cfb853baSMatthew G. Knepley         edges[d] = 1;
4117cfb853baSMatthew G. Knepley         lower[d] = 0.;
4118cfb853baSMatthew G. Knepley         upper[d] = 1.;
4119cfb853baSMatthew G. Knepley         bdt[d]   = DM_BOUNDARY_PERIODIC;
4120cfb853baSMatthew G. Knepley       }
4121cfb853baSMatthew G. Knepley       n = dim;
4122cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", edges, &n, &flg));
4123cfb853baSMatthew G. Knepley       n = dim;
4124cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
4125cfb853baSMatthew 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);
4126cfb853baSMatthew G. Knepley       n = dim;
4127cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
4128cfb853baSMatthew 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);
4129cfb853baSMatthew G. Knepley       n = dim;
4130cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsEnumArray("-dm_plex_box_bd", "Boundary type for each dimension", "", DMBoundaryTypes, (PetscEnum *)bdt, &n, &flg));
4131cfb853baSMatthew 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);
4132cfb853baSMatthew G. Knepley       PetscCall(DMPlexCreateHypercubicMesh_Internal(dm, dim, lower, upper, edges, bdt));
4133cfb853baSMatthew G. Knepley       PetscCall(PetscFree4(edges, lower, upper, bdt));
4134cfb853baSMatthew G. Knepley     } break;
4135d71ae5a4SJacob Faibussowitsch     default:
4136d71ae5a4SJacob Faibussowitsch       SETERRQ(comm, PETSC_ERR_SUP, "Domain shape %s is unsupported", DMPlexShapes[shape]);
41379318fe57SMatthew G. Knepley     }
41389318fe57SMatthew G. Knepley   }
41399566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
414048a46eb9SPierre Jolivet   if (!((PetscObject)dm)->name && nameflg) PetscCall(PetscObjectSetName((PetscObject)dm, plexname));
41414e22dd4cSMatthew G. Knepley   // Allow label creation
41424e22dd4cSMatthew G. Knepley   PetscCall(PetscOptionsFindPairPrefix_Private(NULL, ((PetscObject)dm)->prefix, "-dm_plex_label_", &option, NULL, &flg));
41434e22dd4cSMatthew G. Knepley   if (flg) {
41444e22dd4cSMatthew G. Knepley     DMLabel     label;
41454e22dd4cSMatthew G. Knepley     PetscInt    points[1024], n = 1024;
41464e22dd4cSMatthew G. Knepley     char        fulloption[PETSC_MAX_PATH_LEN];
41474e22dd4cSMatthew G. Knepley     const char *name = &option[14];
41484e22dd4cSMatthew G. Knepley 
41494e22dd4cSMatthew G. Knepley     PetscCall(DMCreateLabel(dm, name));
41504e22dd4cSMatthew G. Knepley     PetscCall(DMGetLabel(dm, name, &label));
41514e22dd4cSMatthew G. Knepley     fulloption[0] = '-';
41524e22dd4cSMatthew G. Knepley     fulloption[1] = 0;
41534e22dd4cSMatthew G. Knepley     PetscCall(PetscStrlcat(fulloption, option, PETSC_MAX_PATH_LEN));
41544e22dd4cSMatthew G. Knepley     PetscCall(PetscOptionsGetIntArray(NULL, ((PetscObject)dm)->prefix, fulloption, points, &n, NULL));
41554e22dd4cSMatthew G. Knepley     for (PetscInt p = 0; p < n; ++p) PetscCall(DMLabelSetValue(label, points[p], 1));
41564e22dd4cSMatthew G. Knepley   }
4157dd0eeac9SMatthew G. Knepley   // Allow cohesive label creation
4158dd0eeac9SMatthew G. Knepley   //   Faces are input, completed, and all points are marked with their depth
4159dd0eeac9SMatthew G. Knepley   PetscCall(PetscOptionsFindPairPrefix_Private(NULL, ((PetscObject)dm)->prefix, "-dm_plex_cohesive_label_", &option, NULL, &flg));
4160dd0eeac9SMatthew G. Knepley   if (flg) {
4161dd0eeac9SMatthew G. Knepley     DMLabel  label;
4162dd0eeac9SMatthew G. Knepley     PetscInt points[1024], n, pStart, pEnd, Nl = 1;
4163dd0eeac9SMatthew G. Knepley     char     fulloption[PETSC_MAX_PATH_LEN];
4164dd0eeac9SMatthew G. Knepley     char     name[PETSC_MAX_PATH_LEN];
4165dd0eeac9SMatthew G. Knepley     size_t   len;
4166dd0eeac9SMatthew G. Knepley 
4167dd0eeac9SMatthew G. Knepley     PetscCall(DMPlexGetChart(dm, &pStart, &pEnd));
4168dd0eeac9SMatthew G. Knepley     PetscCall(PetscStrncpy(name, &option[23], PETSC_MAX_PATH_LEN));
4169dd0eeac9SMatthew G. Knepley     PetscCall(PetscStrlen(name, &len));
4170dd0eeac9SMatthew G. Knepley     if (name[len - 1] == '0') Nl = 10;
4171dd0eeac9SMatthew G. Knepley     for (PetscInt l = 0; l < Nl; ++l) {
4172dd0eeac9SMatthew G. Knepley       if (l > 0) name[len - 1] = '0' + l;
4173dd0eeac9SMatthew G. Knepley       fulloption[0] = 0;
4174dd0eeac9SMatthew G. Knepley       PetscCall(PetscStrlcat(fulloption, "-dm_plex_cohesive_label_", 32));
4175dd0eeac9SMatthew G. Knepley       PetscCall(PetscStrlcat(fulloption, name, PETSC_MAX_PATH_LEN - 32));
4176dd0eeac9SMatthew G. Knepley       n = 1024;
4177dd0eeac9SMatthew G. Knepley       PetscCall(PetscOptionsGetIntArray(NULL, ((PetscObject)dm)->prefix, fulloption, points, &n, &flg));
4178dd0eeac9SMatthew G. Knepley       if (!flg) break;
4179dd0eeac9SMatthew G. Knepley       PetscCall(DMCreateLabel(dm, name));
4180dd0eeac9SMatthew G. Knepley       PetscCall(DMGetLabel(dm, name, &label));
4181dd0eeac9SMatthew G. Knepley       if (pStart >= pEnd) n = 0;
4182dd0eeac9SMatthew G. Knepley       for (PetscInt p = 0; p < n; ++p) {
4183dd0eeac9SMatthew G. Knepley         const PetscInt point   = points[p];
4184dd0eeac9SMatthew G. Knepley         PetscInt      *closure = NULL;
4185dd0eeac9SMatthew G. Knepley         PetscInt       clSize, pdepth;
4186dd0eeac9SMatthew G. Knepley 
4187dd0eeac9SMatthew G. Knepley         PetscCall(DMPlexGetPointDepth(dm, point, &pdepth));
4188dd0eeac9SMatthew G. Knepley         PetscCall(DMLabelSetValue(label, point, pdepth));
4189dd0eeac9SMatthew G. Knepley         PetscCall(DMPlexGetTransitiveClosure(dm, point, PETSC_TRUE, &clSize, &closure));
4190dd0eeac9SMatthew G. Knepley         for (PetscInt cl = 0; cl < clSize * 2; cl += 2) {
4191dd0eeac9SMatthew G. Knepley           PetscCall(DMPlexGetPointDepth(dm, closure[cl], &pdepth));
4192dd0eeac9SMatthew G. Knepley           PetscCall(DMLabelSetValue(label, closure[cl], pdepth));
4193dd0eeac9SMatthew G. Knepley         }
4194dd0eeac9SMatthew G. Knepley         PetscCall(DMPlexRestoreTransitiveClosure(dm, point, PETSC_TRUE, &clSize, &closure));
4195dd0eeac9SMatthew G. Knepley       }
4196dd0eeac9SMatthew G. Knepley       PetscCall(DMPlexOrientLabel(dm, label));
41970542aa8cSMatthew G. Knepley       PetscCall(DMPlexLabelCohesiveComplete(dm, label, NULL, 1, PETSC_FALSE, PETSC_FALSE, NULL));
4198dd0eeac9SMatthew G. Knepley     }
4199dd0eeac9SMatthew G. Knepley   }
4200708be2fdSJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_CreateFromOptions, dm, 0, 0, 0));
42013ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
42020a6ba040SMatthew G. Knepley }
42030a6ba040SMatthew G. Knepley 
4204d71ae5a4SJacob Faibussowitsch PetscErrorCode DMSetFromOptions_NonRefinement_Plex(DM dm, PetscOptionItems *PetscOptionsObject)
4205d71ae5a4SJacob Faibussowitsch {
42060a6ba040SMatthew G. Knepley   DM_Plex  *mesh = (DM_Plex *)dm->data;
42077f9d8d6cSVaclav Hapla   PetscBool flg, flg2;
42089318fe57SMatthew G. Knepley   char      bdLabel[PETSC_MAX_PATH_LEN];
4209adc21957SMatthew G. Knepley   char      method[PETSC_MAX_PATH_LEN];
42100a6ba040SMatthew G. Knepley 
42110a6ba040SMatthew G. Knepley   PetscFunctionBegin;
42120a6ba040SMatthew G. Knepley   /* Handle viewing */
42139566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_print_set_values", "Output all set values info", "DMPlexMatSetClosure", PETSC_FALSE, &mesh->printSetValues, NULL));
42145962854dSMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_fem", "Debug output level for all fem computations", "DMPlexSNESComputeResidualFEM", 0, &mesh->printFEM, NULL, 0));
42155962854dSMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_fvm", "Debug output level for all fvm computations", "DMPlexSNESComputeResidualFVM", 0, &mesh->printFVM, NULL, 0));
42169566063dSJacob Faibussowitsch   PetscCall(PetscOptionsReal("-dm_plex_print_tol", "Tolerance for FEM output", "DMPlexSNESComputeResidualFEM", mesh->printTol, &mesh->printTol, NULL));
42179566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_l2", "Debug output level all L2 diff computations", "DMComputeL2Diff", 0, &mesh->printL2, NULL, 0));
4218f5867de0SMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_locate", "Debug output level all point location computations", "DMLocatePoints", 0, &mesh->printLocate, NULL, 0));
42199566063dSJacob Faibussowitsch   PetscCall(DMMonitorSetFromOptions(dm, "-dm_plex_monitor_throughput", "Monitor the simulation throughput", "DMPlexMonitorThroughput", DMPlexMonitorThroughput, NULL, &flg));
42209566063dSJacob Faibussowitsch   if (flg) PetscCall(PetscLogDefaultBegin());
42219318fe57SMatthew G. Knepley   /* Labeling */
42229566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_boundary_label", "Label to mark the mesh boundary", "", bdLabel, bdLabel, sizeof(bdLabel), &flg));
42239566063dSJacob Faibussowitsch   if (flg) PetscCall(DMPlexCreateBoundaryLabel_Private(dm, bdLabel));
4224953fc75cSMatthew G. Knepley   /* Point Location */
42259566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_hash_location", "Use grid hashing for point location", "DMInterpolate", PETSC_FALSE, &mesh->useHashLocation, NULL));
42260848f4b5SMatthew G. Knepley   /* Partitioning and distribution */
42279566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_partition_balance", "Attempt to evenly divide points on partition boundary between processes", "DMPlexSetPartitionBalance", PETSC_FALSE, &mesh->partitionBalance, NULL));
4228d02c7345SMatthew G. Knepley   /* Reordering */
4229adc21957SMatthew G. Knepley   PetscCall(PetscOptionsBool("-dm_reorder_section", "Compute point permutation for local section", "DMReorderSectionSetDefault", PETSC_FALSE, &flg2, &flg));
4230adc21957SMatthew G. Knepley   if (flg) PetscCall(DMReorderSectionSetDefault(dm, flg2 ? DM_REORDER_DEFAULT_TRUE : DM_REORDER_DEFAULT_FALSE));
4231adc21957SMatthew G. Knepley   PetscCall(PetscOptionsString("-dm_reorder_section_type", "Reordering method for local section", "DMReorderSectionSetType", method, method, PETSC_MAX_PATH_LEN, &flg));
4232adc21957SMatthew G. Knepley   if (flg) PetscCall(DMReorderSectionSetType(dm, method));
42332e62ab5aSMatthew G. Knepley   /* Generation and remeshing */
42349566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_remesh_bd", "Allow changes to the boundary on remeshing", "DMAdapt", PETSC_FALSE, &mesh->remeshBd, NULL));
4235b29cfa1cSToby Isaac   /* Projection behavior */
4236d5b43468SJose E. Roman   PetscCall(PetscOptionsBoundedInt("-dm_plex_max_projection_height", "Maximum mesh point height used to project locally", "DMPlexSetMaxProjectionHeight", 0, &mesh->maxProjectionHeight, NULL, 0));
42379566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_regular_refinement", "Use special nested projection algorithm for regular refinement", "DMPlexSetRegularRefinement", mesh->regularRefinement, &mesh->regularRefinement, NULL));
4238f12cf164SMatthew G. Knepley   /* Checking structure */
4239f12cf164SMatthew G. Knepley   {
42407f9d8d6cSVaclav Hapla     PetscBool all = PETSC_FALSE;
4241f12cf164SMatthew G. Knepley 
42427f9d8d6cSVaclav Hapla     PetscCall(PetscOptionsBool("-dm_plex_check_all", "Perform all basic checks", "DMPlexCheck", PETSC_FALSE, &all, NULL));
42437f9d8d6cSVaclav Hapla     if (all) {
42447f9d8d6cSVaclav Hapla       PetscCall(DMPlexCheck(dm));
42457f9d8d6cSVaclav Hapla     } else {
42469566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_symmetry", "Check that the adjacency information in the mesh is symmetric", "DMPlexCheckSymmetry", PETSC_FALSE, &flg, &flg2));
42477f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckSymmetry(dm));
42489566063dSJacob 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));
42497f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckSkeleton(dm, 0));
42509566063dSJacob 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));
42517f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckFaces(dm, 0));
42529566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_geometry", "Check that cells have positive volume", "DMPlexCheckGeometry", PETSC_FALSE, &flg, &flg2));
42537f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckGeometry(dm));
42549566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_pointsf", "Check some necessary conditions for PointSF", "DMPlexCheckPointSF", PETSC_FALSE, &flg, &flg2));
4255d7d32a9aSMatthew G. Knepley       if (flg && flg2) PetscCall(DMPlexCheckPointSF(dm, NULL, PETSC_FALSE));
42569566063dSJacob 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));
42577f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckInterfaceCones(dm));
42587f9d8d6cSVaclav Hapla     }
42599566063dSJacob Faibussowitsch     PetscCall(PetscOptionsBool("-dm_plex_check_cell_shape", "Check cell shape", "DMPlexCheckCellShape", PETSC_FALSE, &flg, &flg2));
42609566063dSJacob Faibussowitsch     if (flg && flg2) PetscCall(DMPlexCheckCellShape(dm, PETSC_TRUE, PETSC_DETERMINE));
4261f12cf164SMatthew G. Knepley   }
42629318fe57SMatthew G. Knepley   {
42639318fe57SMatthew G. Knepley     PetscReal scale = 1.0;
42644f3833eaSMatthew G. Knepley 
42659566063dSJacob Faibussowitsch     PetscCall(PetscOptionsReal("-dm_plex_scale", "Scale factor for mesh coordinates", "DMPlexScale", scale, &scale, &flg));
42669318fe57SMatthew G. Knepley     if (flg) {
42679318fe57SMatthew G. Knepley       Vec coordinates, coordinatesLocal;
42689318fe57SMatthew G. Knepley 
42699566063dSJacob Faibussowitsch       PetscCall(DMGetCoordinates(dm, &coordinates));
42709566063dSJacob Faibussowitsch       PetscCall(DMGetCoordinatesLocal(dm, &coordinatesLocal));
42719566063dSJacob Faibussowitsch       PetscCall(VecScale(coordinates, scale));
42729566063dSJacob Faibussowitsch       PetscCall(VecScale(coordinatesLocal, scale));
42739318fe57SMatthew G. Knepley     }
42749318fe57SMatthew G. Knepley   }
42759566063dSJacob Faibussowitsch   PetscCall(PetscPartitionerSetFromOptions(mesh->partitioner));
42763ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
427768d4fef7SMatthew G. Knepley }
427868d4fef7SMatthew G. Knepley 
4279d71ae5a4SJacob Faibussowitsch PetscErrorCode DMSetFromOptions_Overlap_Plex(DM dm, PetscOptionItems *PetscOptionsObject, PetscInt *overlap)
4280d71ae5a4SJacob Faibussowitsch {
4281c506a872SMatthew G. Knepley   PetscInt  numOvLabels = 16, numOvExLabels = 16;
4282c506a872SMatthew G. Knepley   char     *ovLabelNames[16], *ovExLabelNames[16];
4283c506a872SMatthew G. Knepley   PetscInt  numOvValues = 16, numOvExValues = 16, l;
4284c506a872SMatthew G. Knepley   PetscBool flg;
4285c506a872SMatthew G. Knepley 
4286c506a872SMatthew G. Knepley   PetscFunctionBegin;
4287c506a872SMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_distribute_overlap", "The size of the overlap halo", "DMPlexDistribute", *overlap, overlap, NULL, 0));
4288c506a872SMatthew G. Knepley   PetscCall(PetscOptionsStringArray("-dm_distribute_overlap_labels", "List of overlap label names", "DMPlexDistribute", ovLabelNames, &numOvLabels, &flg));
4289c506a872SMatthew G. Knepley   if (!flg) numOvLabels = 0;
4290c506a872SMatthew G. Knepley   if (numOvLabels) {
4291c506a872SMatthew G. Knepley     ((DM_Plex *)dm->data)->numOvLabels = numOvLabels;
4292c506a872SMatthew G. Knepley     for (l = 0; l < numOvLabels; ++l) {
4293c506a872SMatthew G. Knepley       PetscCall(DMGetLabel(dm, ovLabelNames[l], &((DM_Plex *)dm->data)->ovLabels[l]));
4294c506a872SMatthew G. Knepley       PetscCheck(((DM_Plex *)dm->data)->ovLabels[l], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid label name %s", ovLabelNames[l]);
4295c506a872SMatthew G. Knepley       PetscCall(PetscFree(ovLabelNames[l]));
4296c506a872SMatthew G. Knepley     }
4297c506a872SMatthew G. Knepley     PetscCall(PetscOptionsIntArray("-dm_distribute_overlap_values", "List of overlap label values", "DMPlexDistribute", ((DM_Plex *)dm->data)->ovValues, &numOvValues, &flg));
4298c506a872SMatthew G. Knepley     if (!flg) numOvValues = 0;
4299c506a872SMatthew 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);
4300c506a872SMatthew G. Knepley 
4301c506a872SMatthew G. Knepley     PetscCall(PetscOptionsStringArray("-dm_distribute_overlap_exclude_labels", "List of overlap exclude label names", "DMPlexDistribute", ovExLabelNames, &numOvExLabels, &flg));
4302c506a872SMatthew G. Knepley     if (!flg) numOvExLabels = 0;
4303c506a872SMatthew G. Knepley     ((DM_Plex *)dm->data)->numOvExLabels = numOvExLabels;
4304c506a872SMatthew G. Knepley     for (l = 0; l < numOvExLabels; ++l) {
4305c506a872SMatthew G. Knepley       PetscCall(DMGetLabel(dm, ovExLabelNames[l], &((DM_Plex *)dm->data)->ovExLabels[l]));
4306c506a872SMatthew G. Knepley       PetscCheck(((DM_Plex *)dm->data)->ovExLabels[l], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid label name %s", ovExLabelNames[l]);
4307c506a872SMatthew G. Knepley       PetscCall(PetscFree(ovExLabelNames[l]));
4308c506a872SMatthew G. Knepley     }
4309c506a872SMatthew G. Knepley     PetscCall(PetscOptionsIntArray("-dm_distribute_overlap_exclude_values", "List of overlap exclude label values", "DMPlexDistribute", ((DM_Plex *)dm->data)->ovExValues, &numOvExValues, &flg));
4310c506a872SMatthew G. Knepley     if (!flg) numOvExValues = 0;
4311c506a872SMatthew 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);
4312c506a872SMatthew G. Knepley   }
43133ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4314c506a872SMatthew G. Knepley }
4315c506a872SMatthew G. Knepley 
4316d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMSetFromOptions_Plex(DM dm, PetscOptionItems *PetscOptionsObject)
4317d71ae5a4SJacob Faibussowitsch {
4318bdf63967SMatthew G. Knepley   PetscFunctionList    ordlist;
4319bdf63967SMatthew G. Knepley   char                 oname[256];
43204e22dd4cSMatthew G. Knepley   char                 sublabelname[PETSC_MAX_PATH_LEN] = "";
4321adc21957SMatthew G. Knepley   DMReorderDefaultFlag reorder;
4322d410b0cfSMatthew G. Knepley   PetscReal            volume    = -1.0;
43239318fe57SMatthew G. Knepley   PetscInt             prerefine = 0, refine = 0, r, coarsen = 0, overlap = 0, extLayers = 0, dim;
4324*1b742f01SMatthew G. Knepley   PetscBool            uniformOrig = PETSC_FALSE, created = PETSC_FALSE, uniform = PETSC_TRUE, distribute, saveSF = PETSC_FALSE, interpolate = PETSC_TRUE, coordSpace = PETSC_TRUE, remap = PETSC_TRUE, ghostCells = PETSC_FALSE, isHierarchy, flg;
432568d4fef7SMatthew G. Knepley 
432668d4fef7SMatthew G. Knepley   PetscFunctionBegin;
4327d0609cedSBarry Smith   PetscOptionsHeadBegin(PetscOptionsObject, "DMPlex Options");
4328dd4c3f67SMatthew G. Knepley   if (dm->cloneOpts) goto non_refine;
43299318fe57SMatthew G. Knepley   /* Handle automatic creation */
43309566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
43316bc1bd01Sksagiyam   if (dim < 0) {
43326bc1bd01Sksagiyam     PetscCall(DMPlexCreateFromOptions_Internal(PetscOptionsObject, &coordSpace, dm));
43336bc1bd01Sksagiyam     created = PETSC_TRUE;
43346bc1bd01Sksagiyam   }
43356bc1bd01Sksagiyam   PetscCall(DMGetDimension(dm, &dim));
4336d89e6e46SMatthew G. Knepley   /* Handle interpolation before distribution */
43379566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_interpolate_pre", "Flag to interpolate mesh before distribution", "", interpolate, &interpolate, &flg));
4338d89e6e46SMatthew G. Knepley   if (flg) {
4339d89e6e46SMatthew G. Knepley     DMPlexInterpolatedFlag interpolated;
4340d89e6e46SMatthew G. Knepley 
43419566063dSJacob Faibussowitsch     PetscCall(DMPlexIsInterpolated(dm, &interpolated));
4342d89e6e46SMatthew G. Knepley     if (interpolated == DMPLEX_INTERPOLATED_FULL && !interpolate) {
4343d89e6e46SMatthew G. Knepley       DM udm;
4344d89e6e46SMatthew G. Knepley 
43459566063dSJacob Faibussowitsch       PetscCall(DMPlexUninterpolate(dm, &udm));
434669d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &udm));
4347d89e6e46SMatthew G. Knepley     } else if (interpolated != DMPLEX_INTERPOLATED_FULL && interpolate) {
4348d89e6e46SMatthew G. Knepley       DM idm;
4349d89e6e46SMatthew G. Knepley 
43509566063dSJacob Faibussowitsch       PetscCall(DMPlexInterpolate(dm, &idm));
435169d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &idm));
4352d89e6e46SMatthew G. Knepley     }
4353d89e6e46SMatthew G. Knepley   }
43544e22dd4cSMatthew G. Knepley   // Handle submesh selection before distribution
43554e22dd4cSMatthew G. Knepley   PetscCall(PetscOptionsString("-dm_plex_submesh", "Label to use for submesh selection", "", sublabelname, sublabelname, PETSC_MAX_PATH_LEN, &flg));
43564e22dd4cSMatthew G. Knepley   if (flg) {
43574e22dd4cSMatthew G. Knepley     DM              subdm;
43584e22dd4cSMatthew G. Knepley     DMLabel         label;
43594e22dd4cSMatthew G. Knepley     IS              valueIS, pointIS;
43604e22dd4cSMatthew G. Knepley     const PetscInt *values, *points;
43614e22dd4cSMatthew G. Knepley     PetscBool       markedFaces = PETSC_FALSE;
43624e22dd4cSMatthew G. Knepley     PetscInt        Nv, value, Np;
43634e22dd4cSMatthew G. Knepley 
43644e22dd4cSMatthew G. Knepley     PetscCall(DMGetLabel(dm, sublabelname, &label));
43654e22dd4cSMatthew G. Knepley     PetscCall(DMLabelGetNumValues(label, &Nv));
43664e22dd4cSMatthew G. Knepley     PetscCheck(Nv == 1, PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Only a single label value is currently supported for submesh selection, not %" PetscInt_FMT, Nv);
43674e22dd4cSMatthew G. Knepley     PetscCall(DMLabelGetValueIS(label, &valueIS));
43684e22dd4cSMatthew G. Knepley     PetscCall(ISGetIndices(valueIS, &values));
43694e22dd4cSMatthew G. Knepley     value = values[0];
43704e22dd4cSMatthew G. Knepley     PetscCall(ISRestoreIndices(valueIS, &values));
43714e22dd4cSMatthew G. Knepley     PetscCall(ISDestroy(&valueIS));
43724e22dd4cSMatthew G. Knepley     PetscCall(DMLabelGetStratumSize(label, value, &Np));
43734e22dd4cSMatthew G. Knepley     PetscCall(DMLabelGetStratumIS(label, value, &pointIS));
43744e22dd4cSMatthew G. Knepley     PetscCall(ISGetIndices(pointIS, &points));
43754e22dd4cSMatthew G. Knepley     for (PetscInt p = 0; p < Np; ++p) {
43764e22dd4cSMatthew G. Knepley       PetscInt pdepth;
43774e22dd4cSMatthew G. Knepley 
43784e22dd4cSMatthew G. Knepley       PetscCall(DMPlexGetPointDepth(dm, points[p], &pdepth));
43794e22dd4cSMatthew G. Knepley       if (pdepth) {
43804e22dd4cSMatthew G. Knepley         markedFaces = PETSC_TRUE;
43814e22dd4cSMatthew G. Knepley         break;
43824e22dd4cSMatthew G. Knepley       }
43834e22dd4cSMatthew G. Knepley     }
43844e22dd4cSMatthew G. Knepley     PetscCall(ISRestoreIndices(pointIS, &points));
43854e22dd4cSMatthew G. Knepley     PetscCall(ISDestroy(&pointIS));
43864e22dd4cSMatthew G. Knepley     PetscCall(DMPlexCreateSubmesh(dm, label, value, markedFaces, &subdm));
43874e22dd4cSMatthew G. Knepley     PetscCall(DMPlexReplace_Internal(dm, &subdm));
43884e22dd4cSMatthew G. Knepley     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
43894e22dd4cSMatthew G. Knepley   }
43909b44eab4SMatthew G. Knepley   /* Handle DMPlex refinement before distribution */
43919566063dSJacob Faibussowitsch   PetscCall(DMPlexGetRefinementUniform(dm, &uniformOrig));
43929566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine_pre", "The number of refinements before distribution", "DMCreate", prerefine, &prerefine, NULL, 0));
43939566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_remap_pre", "Flag to control coordinate remapping", "DMCreate", remap, &remap, NULL));
43949566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_uniform_pre", "Flag for uniform refinement before distribution", "DMCreate", uniform, &uniform, &flg));
43959566063dSJacob Faibussowitsch   if (flg) PetscCall(DMPlexSetRefinementUniform(dm, uniform));
43969566063dSJacob Faibussowitsch   PetscCall(PetscOptionsReal("-dm_refine_volume_limit_pre", "The maximum cell volume after refinement before distribution", "DMCreate", volume, &volume, &flg));
43979318fe57SMatthew G. Knepley   if (flg) {
43989566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementUniform(dm, PETSC_FALSE));
43999566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementLimit(dm, volume));
44009318fe57SMatthew G. Knepley     prerefine = PetscMax(prerefine, 1);
44019318fe57SMatthew G. Knepley   }
4402b23db253SStefano Zampini   if (prerefine) PetscCall(DMLocalizeCoordinates(dm));
44039b44eab4SMatthew G. Knepley   for (r = 0; r < prerefine; ++r) {
44049b44eab4SMatthew G. Knepley     DM             rdm;
44059b44eab4SMatthew G. Knepley     PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
44069b44eab4SMatthew G. Knepley 
4407dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
44089566063dSJacob Faibussowitsch     PetscCall(DMRefine(dm, PetscObjectComm((PetscObject)dm), &rdm));
440969d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &rdm));
4410dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
441161a622f3SMatthew G. Knepley     if (coordFunc && remap) {
44129566063dSJacob Faibussowitsch       PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
44139b44eab4SMatthew G. Knepley       ((DM_Plex *)dm->data)->coordFunc = coordFunc;
44149b44eab4SMatthew G. Knepley     }
44159b44eab4SMatthew G. Knepley   }
44169566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, uniformOrig));
44179318fe57SMatthew G. Knepley   /* Handle DMPlex extrusion before distribution */
44189566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_extrude", "The number of layers to extrude", "", extLayers, &extLayers, NULL, 0));
44199318fe57SMatthew G. Knepley   if (extLayers) {
44209318fe57SMatthew G. Knepley     DM edm;
44219318fe57SMatthew G. Knepley 
44229566063dSJacob Faibussowitsch     PetscCall(DMExtrude(dm, extLayers, &edm));
442369d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &edm));
442448d16a33SMatthew G. Knepley     ((DM_Plex *)dm->data)->coordFunc = NULL;
4425dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4426d410b0cfSMatthew G. Knepley     extLayers = 0;
44275e17fc22SAidan Hamilton     PetscCall(DMGetDimension(dm, &dim));
44289318fe57SMatthew G. Knepley   }
4429bdf63967SMatthew G. Knepley   /* Handle DMPlex reordering before distribution */
44306bc1bd01Sksagiyam   PetscCall(DMPlexReorderGetDefault(dm, &reorder));
44319566063dSJacob Faibussowitsch   PetscCall(MatGetOrderingList(&ordlist));
44326bc1bd01Sksagiyam   PetscCall(PetscStrncpy(oname, MATORDERINGNATURAL, sizeof(oname)));
44339566063dSJacob Faibussowitsch   PetscCall(PetscOptionsFList("-dm_plex_reorder", "Set mesh reordering type", "DMPlexGetOrdering", ordlist, MATORDERINGNATURAL, oname, sizeof(oname), &flg));
4434adc21957SMatthew G. Knepley   if (reorder == DM_REORDER_DEFAULT_TRUE || flg) {
4435bdf63967SMatthew G. Knepley     DM pdm;
4436bdf63967SMatthew G. Knepley     IS perm;
4437bdf63967SMatthew G. Knepley 
44389566063dSJacob Faibussowitsch     PetscCall(DMPlexGetOrdering(dm, oname, NULL, &perm));
44399566063dSJacob Faibussowitsch     PetscCall(DMPlexPermute(dm, perm, &pdm));
44409566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&perm));
444169d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &pdm));
4442dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4443bdf63967SMatthew G. Knepley   }
44449b44eab4SMatthew G. Knepley   /* Handle DMPlex distribution */
44459566063dSJacob Faibussowitsch   PetscCall(DMPlexDistributeGetDefault(dm, &distribute));
4446c506a872SMatthew G. Knepley   PetscCall(PetscOptionsBool("-dm_distribute", "Flag to redistribute a mesh among processes", "DMPlexDistribute", distribute, &distribute, NULL));
4447a286e215SMatthew G. Knepley   PetscCall(PetscOptionsBool("-dm_distribute_save_sf", "Flag to save the migration SF", "DMPlexSetMigrationSF", saveSF, &saveSF, NULL));
4448dbbe0bcdSBarry Smith   PetscCall(DMSetFromOptions_Overlap_Plex(dm, PetscOptionsObject, &overlap));
44499b44eab4SMatthew G. Knepley   if (distribute) {
44509b44eab4SMatthew G. Knepley     DM               pdm = NULL;
44519b44eab4SMatthew G. Knepley     PetscPartitioner part;
4452a286e215SMatthew G. Knepley     PetscSF          sfMigration;
44539b44eab4SMatthew G. Knepley 
44549566063dSJacob Faibussowitsch     PetscCall(DMPlexGetPartitioner(dm, &part));
44559566063dSJacob Faibussowitsch     PetscCall(PetscPartitionerSetFromOptions(part));
4456a286e215SMatthew G. Knepley     PetscCall(DMPlexDistribute(dm, overlap, &sfMigration, &pdm));
445748a46eb9SPierre Jolivet     if (pdm) PetscCall(DMPlexReplace_Internal(dm, &pdm));
4458a286e215SMatthew G. Knepley     if (saveSF) PetscCall(DMPlexSetMigrationSF(dm, sfMigration));
4459a286e215SMatthew G. Knepley     PetscCall(PetscSFDestroy(&sfMigration));
44609b44eab4SMatthew G. Knepley   }
4461d2b2dc1eSMatthew G. Knepley   /* Must check CEED options before creating function space for coordinates */
4462d2b2dc1eSMatthew G. Knepley   {
4463d2b2dc1eSMatthew G. Knepley     PetscBool useCeed = PETSC_FALSE, flg;
4464d2b2dc1eSMatthew G. Knepley 
4465d2b2dc1eSMatthew G. Knepley     PetscCall(PetscOptionsBool("-dm_plex_use_ceed", "Use LibCEED as the FEM backend", "DMPlexSetUseCeed", useCeed, &useCeed, &flg));
4466d2b2dc1eSMatthew G. Knepley     if (flg) PetscCall(DMPlexSetUseCeed(dm, useCeed));
4467d2b2dc1eSMatthew G. Knepley   }
44689318fe57SMatthew G. Knepley   /* Create coordinate space */
44699318fe57SMatthew G. Knepley   if (created) {
447061a622f3SMatthew G. Knepley     DM_Plex  *mesh   = (DM_Plex *)dm->data;
4471e44f6aebSMatthew G. Knepley     PetscInt  degree = 1, deg;
44725515ebd3SMatthew G. Knepley     PetscInt  height = 0;
44735515ebd3SMatthew G. Knepley     DM        cdm;
4474c3db174cSMatthew G. Knepley     PetscBool flg, localize = PETSC_TRUE, sparseLocalize = PETSC_TRUE;
44759318fe57SMatthew G. Knepley 
44769566063dSJacob Faibussowitsch     PetscCall(PetscOptionsBool("-dm_coord_space", "Use an FEM space for coordinates", "", coordSpace, &coordSpace, &flg));
44779566063dSJacob Faibussowitsch     PetscCall(PetscOptionsInt("-dm_coord_petscspace_degree", "FEM degree for coordinate space", "", degree, &degree, NULL));
4478e44f6aebSMatthew G. Knepley     PetscCall(DMGetCoordinateDegree_Internal(dm, &deg));
4479e44f6aebSMatthew G. Knepley     if (coordSpace && deg <= 1) PetscCall(DMPlexCreateCoordinateSpace(dm, degree, PETSC_TRUE, mesh->coordFunc));
44805515ebd3SMatthew G. Knepley     PetscCall(DMGetCoordinateDM(dm, &cdm));
448161a622f3SMatthew G. Knepley     if (flg && !coordSpace) {
448261a622f3SMatthew G. Knepley       PetscDS      cds;
448361a622f3SMatthew G. Knepley       PetscObject  obj;
448461a622f3SMatthew G. Knepley       PetscClassId id;
448561a622f3SMatthew G. Knepley 
44869566063dSJacob Faibussowitsch       PetscCall(DMGetDS(cdm, &cds));
44879566063dSJacob Faibussowitsch       PetscCall(PetscDSGetDiscretization(cds, 0, &obj));
44889566063dSJacob Faibussowitsch       PetscCall(PetscObjectGetClassId(obj, &id));
448961a622f3SMatthew G. Knepley       if (id == PETSCFE_CLASSID) {
449061a622f3SMatthew G. Knepley         PetscContainer dummy;
449161a622f3SMatthew G. Knepley 
44929566063dSJacob Faibussowitsch         PetscCall(PetscContainerCreate(PETSC_COMM_SELF, &dummy));
44939566063dSJacob Faibussowitsch         PetscCall(PetscObjectSetName((PetscObject)dummy, "coordinates"));
44949566063dSJacob Faibussowitsch         PetscCall(DMSetField(cdm, 0, NULL, (PetscObject)dummy));
44959566063dSJacob Faibussowitsch         PetscCall(PetscContainerDestroy(&dummy));
44969566063dSJacob Faibussowitsch         PetscCall(DMClearDS(cdm));
449761a622f3SMatthew G. Knepley       }
449861a622f3SMatthew G. Knepley       mesh->coordFunc = NULL;
449961a622f3SMatthew G. Knepley     }
4500c3db174cSMatthew G. Knepley     PetscCall(PetscOptionsBool("-dm_localize", "Localize mesh coordinates", "", localize, &localize, NULL));
4501c3db174cSMatthew G. Knepley     PetscCall(PetscOptionsBool("-dm_sparse_localize", "Localize only necessary cells", "DMSetSparseLocalize", sparseLocalize, &sparseLocalize, &flg));
4502c3db174cSMatthew G. Knepley     if (flg) PetscCall(DMSetSparseLocalize(dm, sparseLocalize));
45035515ebd3SMatthew G. Knepley     PetscCall(PetscOptionsInt("-dm_localize_height", "Localize edges and faces in addition to cells", "", height, &height, &flg));
45045515ebd3SMatthew G. Knepley     if (flg) PetscCall(DMPlexSetMaxProjectionHeight(cdm, height));
4505c3db174cSMatthew G. Knepley     if (localize) PetscCall(DMLocalizeCoordinates(dm));
45069318fe57SMatthew G. Knepley   }
450768d4fef7SMatthew G. Knepley   /* Handle DMPlex refinement */
450861a622f3SMatthew G. Knepley   remap = PETSC_TRUE;
45099566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine", "The number of uniform refinements", "DMCreate", refine, &refine, NULL, 0));
45109566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_remap", "Flag to control coordinate remapping", "DMCreate", remap, &remap, NULL));
45119566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine_hierarchy", "The number of uniform refinements", "DMCreate", refine, &refine, &isHierarchy, 0));
45129566063dSJacob Faibussowitsch   if (refine) PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
451368d4fef7SMatthew G. Knepley   if (refine && isHierarchy) {
4514acdc6f61SToby Isaac     DM *dms, coarseDM;
451568d4fef7SMatthew G. Knepley 
45169566063dSJacob Faibussowitsch     PetscCall(DMGetCoarseDM(dm, &coarseDM));
45179566063dSJacob Faibussowitsch     PetscCall(PetscObjectReference((PetscObject)coarseDM));
45189566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(refine, &dms));
45199566063dSJacob Faibussowitsch     PetscCall(DMRefineHierarchy(dm, refine, dms));
452068d4fef7SMatthew G. Knepley     /* Total hack since we do not pass in a pointer */
45219566063dSJacob Faibussowitsch     PetscCall(DMPlexSwap_Static(dm, dms[refine - 1]));
452268d4fef7SMatthew G. Knepley     if (refine == 1) {
45239566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dm, dms[0]));
45249566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dm, PETSC_TRUE));
452568d4fef7SMatthew G. Knepley     } else {
45269566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dm, dms[refine - 2]));
45279566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dm, PETSC_TRUE));
45289566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dms[0], dms[refine - 1]));
45299566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dms[0], PETSC_TRUE));
453068d4fef7SMatthew G. Knepley     }
45319566063dSJacob Faibussowitsch     PetscCall(DMSetCoarseDM(dms[refine - 1], coarseDM));
45329566063dSJacob Faibussowitsch     PetscCall(PetscObjectDereference((PetscObject)coarseDM));
453368d4fef7SMatthew G. Knepley     /* Free DMs */
453468d4fef7SMatthew G. Knepley     for (r = 0; r < refine; ++r) {
4535dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dms[r], PetscOptionsObject));
45369566063dSJacob Faibussowitsch       PetscCall(DMDestroy(&dms[r]));
453768d4fef7SMatthew G. Knepley     }
45389566063dSJacob Faibussowitsch     PetscCall(PetscFree(dms));
453968d4fef7SMatthew G. Knepley   } else {
454068d4fef7SMatthew G. Knepley     for (r = 0; r < refine; ++r) {
45419318fe57SMatthew G. Knepley       DM             rdm;
454251a74b61SMatthew G. Knepley       PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
454368d4fef7SMatthew G. Knepley 
4544dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
45459566063dSJacob Faibussowitsch       PetscCall(DMRefine(dm, PetscObjectComm((PetscObject)dm), &rdm));
454668d4fef7SMatthew G. Knepley       /* Total hack since we do not pass in a pointer */
454769d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &rdm));
4548dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
454961a622f3SMatthew G. Knepley       if (coordFunc && remap) {
45509566063dSJacob Faibussowitsch         PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
455151a74b61SMatthew G. Knepley         ((DM_Plex *)dm->data)->coordFunc = coordFunc;
455251a74b61SMatthew G. Knepley       }
455368d4fef7SMatthew G. Knepley     }
455468d4fef7SMatthew G. Knepley   }
45553cf6fe12SMatthew G. Knepley   /* Handle DMPlex coarsening */
45569566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_coarsen", "Coarsen the mesh", "DMCreate", coarsen, &coarsen, NULL, 0));
45579566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_coarsen_hierarchy", "The number of coarsenings", "DMCreate", coarsen, &coarsen, &isHierarchy, 0));
4558b653a561SMatthew G. Knepley   if (coarsen && isHierarchy) {
4559b653a561SMatthew G. Knepley     DM *dms;
4560b653a561SMatthew G. Knepley 
45619566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(coarsen, &dms));
45629566063dSJacob Faibussowitsch     PetscCall(DMCoarsenHierarchy(dm, coarsen, dms));
4563b653a561SMatthew G. Knepley     /* Free DMs */
4564b653a561SMatthew G. Knepley     for (r = 0; r < coarsen; ++r) {
4565dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dms[r], PetscOptionsObject));
45669566063dSJacob Faibussowitsch       PetscCall(DMDestroy(&dms[r]));
4567b653a561SMatthew G. Knepley     }
45689566063dSJacob Faibussowitsch     PetscCall(PetscFree(dms));
4569b653a561SMatthew G. Knepley   } else {
4570b653a561SMatthew G. Knepley     for (r = 0; r < coarsen; ++r) {
45719318fe57SMatthew G. Knepley       DM             cdm;
45729318fe57SMatthew G. Knepley       PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
45733cf6fe12SMatthew G. Knepley 
4574dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
45759566063dSJacob Faibussowitsch       PetscCall(DMCoarsen(dm, PetscObjectComm((PetscObject)dm), &cdm));
45763cf6fe12SMatthew G. Knepley       /* Total hack since we do not pass in a pointer */
457769d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &cdm));
4578dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
45799318fe57SMatthew G. Knepley       if (coordFunc) {
45809566063dSJacob Faibussowitsch         PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
45819318fe57SMatthew G. Knepley         ((DM_Plex *)dm->data)->coordFunc = coordFunc;
45829318fe57SMatthew G. Knepley       }
45833cf6fe12SMatthew G. Knepley     }
4584b653a561SMatthew G. Knepley   }
4585be664eb1SMatthew G. Knepley   // Handle coordinate remapping
4586be664eb1SMatthew G. Knepley   remap = PETSC_FALSE;
4587be664eb1SMatthew G. Knepley   PetscCall(PetscOptionsBool("-dm_coord_remap", "Flag to control coordinate remapping", "", remap, &remap, NULL));
4588be664eb1SMatthew G. Knepley   if (remap) {
4589be664eb1SMatthew G. Knepley     DMPlexCoordMap map     = DM_COORD_MAP_NONE;
4590be664eb1SMatthew G. Knepley     PetscPointFunc mapFunc = NULL;
4591be664eb1SMatthew G. Knepley     PetscScalar    params[16];
4592f45b553cSPierre Jolivet     PetscInt       Np = PETSC_STATIC_ARRAY_LENGTH(params), cdim;
4593be664eb1SMatthew G. Knepley     MPI_Comm       comm;
4594be664eb1SMatthew G. Knepley 
4595be664eb1SMatthew G. Knepley     PetscCall(PetscObjectGetComm((PetscObject)dm, &comm));
4596be664eb1SMatthew G. Knepley     PetscCall(DMGetCoordinateDim(dm, &cdim));
4597be664eb1SMatthew G. Knepley     PetscCall(PetscOptionsScalarArray("-dm_coord_map_params", "Parameters for the coordinate remapping", "", params, &Np, &flg));
4598be664eb1SMatthew G. Knepley     if (!flg) Np = 0;
4599be664eb1SMatthew G. Knepley     // TODO Allow user to pass a map function by name
4600be664eb1SMatthew G. Knepley     PetscCall(PetscOptionsEnum("-dm_coord_map", "Coordinate mapping for built-in mesh", "", DMPlexCoordMaps, (PetscEnum)map, (PetscEnum *)&map, &flg));
4601be664eb1SMatthew G. Knepley     if (flg) {
4602be664eb1SMatthew G. Knepley       switch (map) {
4603be664eb1SMatthew G. Knepley       case DM_COORD_MAP_NONE:
4604be664eb1SMatthew G. Knepley         mapFunc = coordMap_identity;
4605be664eb1SMatthew G. Knepley         break;
4606be664eb1SMatthew G. Knepley       case DM_COORD_MAP_SHEAR:
4607be664eb1SMatthew G. Knepley         mapFunc = coordMap_shear;
4608be664eb1SMatthew G. Knepley         if (!Np) {
4609be664eb1SMatthew G. Knepley           Np        = cdim + 1;
4610be664eb1SMatthew G. Knepley           params[0] = 0;
4611be664eb1SMatthew G. Knepley           for (PetscInt d = 1; d <= cdim; ++d) params[d] = 1.0;
4612be664eb1SMatthew G. Knepley         }
4613be664eb1SMatthew G. Knepley         PetscCheck(Np == cdim + 1, comm, PETSC_ERR_ARG_WRONG, "The shear coordinate map must have cdim + 1 = %" PetscInt_FMT " parameters, not %" PetscInt_FMT, cdim + 1, Np);
4614be664eb1SMatthew G. Knepley         break;
4615be664eb1SMatthew G. Knepley       case DM_COORD_MAP_FLARE:
4616be664eb1SMatthew G. Knepley         mapFunc = coordMap_flare;
4617be664eb1SMatthew G. Knepley         if (!Np) {
4618be664eb1SMatthew G. Knepley           Np        = cdim + 1;
4619be664eb1SMatthew G. Knepley           params[0] = 0;
4620be664eb1SMatthew G. Knepley           for (PetscInt d = 1; d <= cdim; ++d) params[d] = 1.0;
4621be664eb1SMatthew G. Knepley         }
4622be664eb1SMatthew G. Knepley         PetscCheck(Np == cdim + 1, comm, PETSC_ERR_ARG_WRONG, "The flare coordinate map must have cdim + 1 = %" PetscInt_FMT " parameters, not %" PetscInt_FMT, cdim + 1, Np);
4623be664eb1SMatthew G. Knepley         break;
4624be664eb1SMatthew G. Knepley       case DM_COORD_MAP_ANNULUS:
4625be664eb1SMatthew G. Knepley         mapFunc = coordMap_annulus;
4626be664eb1SMatthew G. Knepley         if (!Np) {
4627be664eb1SMatthew G. Knepley           Np        = 2;
4628be664eb1SMatthew G. Knepley           params[0] = 1.;
4629be664eb1SMatthew G. Knepley           params[1] = 2.;
4630be664eb1SMatthew G. Knepley         }
4631be664eb1SMatthew G. Knepley         PetscCheck(Np == 2, comm, PETSC_ERR_ARG_WRONG, "The annulus coordinate map must have 2 parameters, not %" PetscInt_FMT, Np);
4632be664eb1SMatthew G. Knepley         break;
4633be664eb1SMatthew G. Knepley       case DM_COORD_MAP_SHELL:
4634be664eb1SMatthew G. Knepley         mapFunc = coordMap_shell;
4635be664eb1SMatthew G. Knepley         if (!Np) {
4636be664eb1SMatthew G. Knepley           Np        = 2;
4637be664eb1SMatthew G. Knepley           params[0] = 1.;
4638be664eb1SMatthew G. Knepley           params[1] = 2.;
4639be664eb1SMatthew G. Knepley         }
4640be664eb1SMatthew G. Knepley         PetscCheck(Np == 2, comm, PETSC_ERR_ARG_WRONG, "The spherical shell coordinate map must have 2 parameters, not %" PetscInt_FMT, Np);
4641be664eb1SMatthew G. Knepley         break;
4642be664eb1SMatthew G. Knepley       default:
4643be664eb1SMatthew G. Knepley         mapFunc = coordMap_identity;
4644be664eb1SMatthew G. Knepley       }
4645be664eb1SMatthew G. Knepley     }
4646be664eb1SMatthew G. Knepley     if (Np) {
4647be664eb1SMatthew G. Knepley       DM      cdm;
4648be664eb1SMatthew G. Knepley       PetscDS cds;
4649be664eb1SMatthew G. Knepley 
4650be664eb1SMatthew G. Knepley       PetscCall(DMGetCoordinateDM(dm, &cdm));
4651be664eb1SMatthew G. Knepley       PetscCall(DMGetDS(cdm, &cds));
4652be664eb1SMatthew G. Knepley       PetscCall(PetscDSSetConstants(cds, Np, params));
4653be664eb1SMatthew G. Knepley     }
4654be664eb1SMatthew G. Knepley     PetscCall(DMPlexRemapGeometry(dm, 0.0, mapFunc));
4655be664eb1SMatthew G. Knepley   }
4656909dfd52SMatthew G. Knepley   /* Handle ghost cells */
46579566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_create_fv_ghost_cells", "Flag to create finite volume ghost cells on the boundary", "DMCreate", ghostCells, &ghostCells, NULL));
4658909dfd52SMatthew G. Knepley   if (ghostCells) {
4659909dfd52SMatthew G. Knepley     DM   gdm;
4660909dfd52SMatthew G. Knepley     char lname[PETSC_MAX_PATH_LEN];
4661909dfd52SMatthew G. Knepley 
4662909dfd52SMatthew G. Knepley     lname[0] = '\0';
46639566063dSJacob Faibussowitsch     PetscCall(PetscOptionsString("-dm_plex_fv_ghost_cells_label", "Label name for ghost cells boundary", "DMCreate", lname, lname, sizeof(lname), &flg));
46649566063dSJacob Faibussowitsch     PetscCall(DMPlexConstructGhostCells(dm, flg ? lname : NULL, NULL, &gdm));
466569d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &gdm));
4666909dfd52SMatthew G. Knepley   }
46676913077dSMatthew G. Knepley   /* Handle 1D order */
4668adc21957SMatthew G. Knepley   if (reorder != DM_REORDER_DEFAULT_FALSE && dim == 1) {
46696913077dSMatthew G. Knepley     DM           cdm, rdm;
46706913077dSMatthew G. Knepley     PetscDS      cds;
46716913077dSMatthew G. Knepley     PetscObject  obj;
46726913077dSMatthew G. Knepley     PetscClassId id = PETSC_OBJECT_CLASSID;
46736913077dSMatthew G. Knepley     IS           perm;
46746bc1bd01Sksagiyam     PetscInt     Nf;
46756913077dSMatthew G. Knepley     PetscBool    distributed;
46766913077dSMatthew G. Knepley 
46779566063dSJacob Faibussowitsch     PetscCall(DMPlexIsDistributed(dm, &distributed));
46789566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
46799566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
46809566063dSJacob Faibussowitsch     PetscCall(PetscDSGetNumFields(cds, &Nf));
46816913077dSMatthew G. Knepley     if (Nf) {
46829566063dSJacob Faibussowitsch       PetscCall(PetscDSGetDiscretization(cds, 0, &obj));
46839566063dSJacob Faibussowitsch       PetscCall(PetscObjectGetClassId(obj, &id));
46846913077dSMatthew G. Knepley     }
46856bc1bd01Sksagiyam     if (!distributed && id != PETSCFE_CLASSID) {
46869566063dSJacob Faibussowitsch       PetscCall(DMPlexGetOrdering1D(dm, &perm));
46879566063dSJacob Faibussowitsch       PetscCall(DMPlexPermute(dm, perm, &rdm));
468869d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &rdm));
46899566063dSJacob Faibussowitsch       PetscCall(ISDestroy(&perm));
46906913077dSMatthew G. Knepley     }
46916913077dSMatthew G. Knepley   }
46923cf6fe12SMatthew G. Knepley /* Handle */
4693dd4c3f67SMatthew G. Knepley non_refine:
4694dbbe0bcdSBarry Smith   PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4695d0609cedSBarry Smith   PetscOptionsHeadEnd();
46963ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
46970a6ba040SMatthew G. Knepley }
46980a6ba040SMatthew G. Knepley 
4699d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMCreateGlobalVector_Plex(DM dm, Vec *vec)
4700d71ae5a4SJacob Faibussowitsch {
4701552f7358SJed Brown   PetscFunctionBegin;
47029566063dSJacob Faibussowitsch   PetscCall(DMCreateGlobalVector_Section_Private(dm, vec));
47039566063dSJacob Faibussowitsch   /* PetscCall(VecSetOperation(*vec, VECOP_DUPLICATE, (void(*)(void)) VecDuplicate_MPI_DM)); */
47049566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEW, (void (*)(void))VecView_Plex));
47059566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEWNATIVE, (void (*)(void))VecView_Plex_Native));
47069566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOAD, (void (*)(void))VecLoad_Plex));
47079566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOADNATIVE, (void (*)(void))VecLoad_Plex_Native));
47083ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4709552f7358SJed Brown }
4710552f7358SJed Brown 
4711d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMCreateLocalVector_Plex(DM dm, Vec *vec)
4712d71ae5a4SJacob Faibussowitsch {
4713552f7358SJed Brown   PetscFunctionBegin;
47149566063dSJacob Faibussowitsch   PetscCall(DMCreateLocalVector_Section_Private(dm, vec));
47159566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEW, (void (*)(void))VecView_Plex_Local));
47169566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOAD, (void (*)(void))VecLoad_Plex_Local));
47173ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4718552f7358SJed Brown }
4719552f7358SJed Brown 
4720d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMGetDimPoints_Plex(DM dm, PetscInt dim, PetscInt *pStart, PetscInt *pEnd)
4721d71ae5a4SJacob Faibussowitsch {
4722793f3fe5SMatthew G. Knepley   PetscInt depth, d;
4723793f3fe5SMatthew G. Knepley 
4724793f3fe5SMatthew G. Knepley   PetscFunctionBegin;
47259566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepth(dm, &depth));
4726793f3fe5SMatthew G. Knepley   if (depth == 1) {
47279566063dSJacob Faibussowitsch     PetscCall(DMGetDimension(dm, &d));
47289566063dSJacob Faibussowitsch     if (dim == 0) PetscCall(DMPlexGetDepthStratum(dm, dim, pStart, pEnd));
47299566063dSJacob Faibussowitsch     else if (dim == d) PetscCall(DMPlexGetDepthStratum(dm, 1, pStart, pEnd));
47309371c9d4SSatish Balay     else {
47319371c9d4SSatish Balay       *pStart = 0;
47329371c9d4SSatish Balay       *pEnd   = 0;
47339371c9d4SSatish Balay     }
4734793f3fe5SMatthew G. Knepley   } else {
47359566063dSJacob Faibussowitsch     PetscCall(DMPlexGetDepthStratum(dm, dim, pStart, pEnd));
4736793f3fe5SMatthew G. Knepley   }
47373ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4738793f3fe5SMatthew G. Knepley }
4739793f3fe5SMatthew G. Knepley 
4740d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMGetNeighbors_Plex(DM dm, PetscInt *nranks, const PetscMPIInt *ranks[])
4741d71ae5a4SJacob Faibussowitsch {
4742502a2867SDave May   PetscSF            sf;
47430a19bb7dSprj-   PetscInt           niranks, njranks, n;
47440a19bb7dSprj-   const PetscMPIInt *iranks, *jranks;
47450a19bb7dSprj-   DM_Plex           *data = (DM_Plex *)dm->data;
4746502a2867SDave May 
47472f356facSMatthew G. Knepley   PetscFunctionBegin;
47489566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dm, &sf));
47490a19bb7dSprj-   if (!data->neighbors) {
47509566063dSJacob Faibussowitsch     PetscCall(PetscSFSetUp(sf));
47519566063dSJacob Faibussowitsch     PetscCall(PetscSFGetRootRanks(sf, &njranks, &jranks, NULL, NULL, NULL));
47529566063dSJacob Faibussowitsch     PetscCall(PetscSFGetLeafRanks(sf, &niranks, &iranks, NULL, NULL));
47539566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(njranks + niranks + 1, &data->neighbors));
47549566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(data->neighbors + 1, jranks, njranks));
47559566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(data->neighbors + njranks + 1, iranks, niranks));
47560a19bb7dSprj-     n = njranks + niranks;
47579566063dSJacob Faibussowitsch     PetscCall(PetscSortRemoveDupsMPIInt(&n, data->neighbors + 1));
47580a19bb7dSprj-     /* The following cast should never fail: can't have more neighbors than PETSC_MPI_INT_MAX */
47599566063dSJacob Faibussowitsch     PetscCall(PetscMPIIntCast(n, data->neighbors));
47600a19bb7dSprj-   }
47610a19bb7dSprj-   if (nranks) *nranks = data->neighbors[0];
47620a19bb7dSprj-   if (ranks) {
47630a19bb7dSprj-     if (data->neighbors[0]) *ranks = data->neighbors + 1;
47640a19bb7dSprj-     else *ranks = NULL;
47650a19bb7dSprj-   }
47663ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4767502a2867SDave May }
4768502a2867SDave May 
47691eb70e55SToby Isaac PETSC_INTERN PetscErrorCode DMInterpolateSolution_Plex(DM, DM, Mat, Vec, Vec);
47701eb70e55SToby Isaac 
4771d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMInitialize_Plex(DM dm)
4772d71ae5a4SJacob Faibussowitsch {
4773552f7358SJed Brown   PetscFunctionBegin;
4774552f7358SJed Brown   dm->ops->view                      = DMView_Plex;
47752c40f234SMatthew G. Knepley   dm->ops->load                      = DMLoad_Plex;
4776552f7358SJed Brown   dm->ops->setfromoptions            = DMSetFromOptions_Plex;
477738221697SMatthew G. Knepley   dm->ops->clone                     = DMClone_Plex;
4778552f7358SJed Brown   dm->ops->setup                     = DMSetUp_Plex;
47791bb6d2a8SBarry Smith   dm->ops->createlocalsection        = DMCreateLocalSection_Plex;
4780adc21957SMatthew G. Knepley   dm->ops->createsectionpermutation  = DMCreateSectionPermutation_Plex;
478166ad2231SToby Isaac   dm->ops->createdefaultconstraints  = DMCreateDefaultConstraints_Plex;
4782552f7358SJed Brown   dm->ops->createglobalvector        = DMCreateGlobalVector_Plex;
4783552f7358SJed Brown   dm->ops->createlocalvector         = DMCreateLocalVector_Plex;
4784184d77edSJed Brown   dm->ops->getlocaltoglobalmapping   = NULL;
47850298fd71SBarry Smith   dm->ops->createfieldis             = NULL;
4786552f7358SJed Brown   dm->ops->createcoordinatedm        = DMCreateCoordinateDM_Plex;
4787f19dbd58SToby Isaac   dm->ops->createcoordinatefield     = DMCreateCoordinateField_Plex;
47880a6ba040SMatthew G. Knepley   dm->ops->getcoloring               = NULL;
4789552f7358SJed Brown   dm->ops->creatematrix              = DMCreateMatrix_Plex;
4790bceba477SMatthew G. Knepley   dm->ops->createinterpolation       = DMCreateInterpolation_Plex;
4791bd041c0cSMatthew G. Knepley   dm->ops->createmassmatrix          = DMCreateMassMatrix_Plex;
4792b4937a87SMatthew G. Knepley   dm->ops->createmassmatrixlumped    = DMCreateMassMatrixLumped_Plex;
47935a84ad33SLisandro Dalcin   dm->ops->createinjection           = DMCreateInjection_Plex;
4794552f7358SJed Brown   dm->ops->refine                    = DMRefine_Plex;
47950a6ba040SMatthew G. Knepley   dm->ops->coarsen                   = DMCoarsen_Plex;
47960a6ba040SMatthew G. Knepley   dm->ops->refinehierarchy           = DMRefineHierarchy_Plex;
4797b653a561SMatthew G. Knepley   dm->ops->coarsenhierarchy          = DMCoarsenHierarchy_Plex;
4798d410b0cfSMatthew G. Knepley   dm->ops->extrude                   = DMExtrude_Plex;
47990298fd71SBarry Smith   dm->ops->globaltolocalbegin        = NULL;
48000298fd71SBarry Smith   dm->ops->globaltolocalend          = NULL;
48010298fd71SBarry Smith   dm->ops->localtoglobalbegin        = NULL;
48020298fd71SBarry Smith   dm->ops->localtoglobalend          = NULL;
4803552f7358SJed Brown   dm->ops->destroy                   = DMDestroy_Plex;
4804552f7358SJed Brown   dm->ops->createsubdm               = DMCreateSubDM_Plex;
48052adcc780SMatthew G. Knepley   dm->ops->createsuperdm             = DMCreateSuperDM_Plex;
4806793f3fe5SMatthew G. Knepley   dm->ops->getdimpoints              = DMGetDimPoints_Plex;
4807552f7358SJed Brown   dm->ops->locatepoints              = DMLocatePoints_Plex;
48080709b2feSToby Isaac   dm->ops->projectfunctionlocal      = DMProjectFunctionLocal_Plex;
48090709b2feSToby Isaac   dm->ops->projectfunctionlabellocal = DMProjectFunctionLabelLocal_Plex;
4810bfc4295aSToby Isaac   dm->ops->projectfieldlocal         = DMProjectFieldLocal_Plex;
48118c6c5593SMatthew G. Knepley   dm->ops->projectfieldlabellocal    = DMProjectFieldLabelLocal_Plex;
4812ece3a9fcSMatthew G. Knepley   dm->ops->projectbdfieldlabellocal  = DMProjectBdFieldLabelLocal_Plex;
48130709b2feSToby Isaac   dm->ops->computel2diff             = DMComputeL2Diff_Plex;
4814b698f381SToby Isaac   dm->ops->computel2gradientdiff     = DMComputeL2GradientDiff_Plex;
48152a16baeaSToby Isaac   dm->ops->computel2fielddiff        = DMComputeL2FieldDiff_Plex;
481628d58a37SPierre Jolivet   dm->ops->getneighbors              = DMGetNeighbors_Plex;
48176c6a6b79SMatthew G. Knepley   dm->ops->getlocalboundingbox       = DMGetLocalBoundingBox_Coordinates;
4818907a3e9cSStefano Zampini   dm->ops->createdomaindecomposition = DMCreateDomainDecomposition_Plex;
4819907a3e9cSStefano Zampini   dm->ops->createddscatters          = DMCreateDomainDecompositionScatters_Plex;
48209566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexInsertBoundaryValues_C", DMPlexInsertBoundaryValues_Plex));
48216c51210dSStefano Zampini   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexInsertTimeDerivativeBoundaryValues_C", DMPlexInsertTimeDerivativeBoundaryValues_Plex));
48229566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMSetUpGLVisViewer_C", DMSetUpGLVisViewer_Plex));
48239566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMCreateNeumannOverlap_C", DMCreateNeumannOverlap_Plex));
48249566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexDistributeGetDefault_C", DMPlexDistributeGetDefault_Plex));
48259566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexDistributeSetDefault_C", DMPlexDistributeSetDefault_Plex));
48266bc1bd01Sksagiyam   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexReorderGetDefault_C", DMPlexReorderGetDefault_Plex));
48276bc1bd01Sksagiyam   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexReorderSetDefault_C", DMPlexReorderSetDefault_Plex));
4828adc21957SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMReorderSectionGetDefault_C", DMReorderSectionGetDefault_Plex));
4829adc21957SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMReorderSectionSetDefault_C", DMReorderSectionSetDefault_Plex));
4830adc21957SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMReorderSectionGetType_C", DMReorderSectionGetType_Plex));
4831adc21957SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMReorderSectionSetType_C", DMReorderSectionSetType_Plex));
48329566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMInterpolateSolution_C", DMInterpolateSolution_Plex));
4833c506a872SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetOverlap_C", DMPlexGetOverlap_Plex));
4834c506a872SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexSetOverlap_C", DMPlexSetOverlap_Plex));
4835d2b2dc1eSMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetUseCeed_C", DMPlexGetUseCeed_Plex));
4836d2b2dc1eSMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexSetUseCeed_C", DMPlexSetUseCeed_Plex));
48373ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4838552f7358SJed Brown }
4839552f7358SJed Brown 
4840d71ae5a4SJacob Faibussowitsch PETSC_INTERN PetscErrorCode DMClone_Plex(DM dm, DM *newdm)
4841d71ae5a4SJacob Faibussowitsch {
484263a16f15SMatthew G. Knepley   DM_Plex       *mesh = (DM_Plex *)dm->data;
48431fca310dSJames Wright   const PetscSF *face_sfs;
48441fca310dSJames Wright   PetscInt       num_face_sfs;
484563a16f15SMatthew G. Knepley 
484663a16f15SMatthew G. Knepley   PetscFunctionBegin;
484763a16f15SMatthew G. Knepley   mesh->refct++;
484863a16f15SMatthew G. Knepley   (*newdm)->data = mesh;
48491fca310dSJames Wright   PetscCall(DMPlexGetIsoperiodicFaceSF(dm, &num_face_sfs, &face_sfs));
48501fca310dSJames Wright   PetscCall(DMPlexSetIsoperiodicFaceSF(*newdm, num_face_sfs, (PetscSF *)face_sfs));
48519566063dSJacob Faibussowitsch   PetscCall(PetscObjectChangeTypeName((PetscObject)*newdm, DMPLEX));
48529566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(*newdm));
48533ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
485463a16f15SMatthew G. Knepley }
485563a16f15SMatthew G. Knepley 
48568818961aSMatthew G Knepley /*MC
4857a1cb98faSBarry Smith   DMPLEX = "plex" - A `DM` object that encapsulates an unstructured mesh, or CW Complex, which can be expressed using a Hasse Diagram.
485820f4b53cSBarry Smith                     In the local representation, `Vec`s contain all unknowns in the interior and shared boundary. This is
48598818961aSMatthew G Knepley                     specified by a PetscSection object. Ownership in the global representation is determined by
4860a1cb98faSBarry Smith                     ownership of the underlying `DMPLEX` points. This is specified by another `PetscSection` object.
48618818961aSMatthew G Knepley 
4862e5893cccSMatthew G. Knepley   Options Database Keys:
4863250712c9SMatthew G. Knepley + -dm_refine_pre                     - Refine mesh before distribution
4864250712c9SMatthew G. Knepley + -dm_refine_uniform_pre             - Choose uniform or generator-based refinement
4865250712c9SMatthew G. Knepley + -dm_refine_volume_limit_pre        - Cell volume limit after pre-refinement using generator
4866250712c9SMatthew G. Knepley . -dm_distribute                     - Distribute mesh across processes
4867250712c9SMatthew G. Knepley . -dm_distribute_overlap             - Number of cells to overlap for distribution
4868250712c9SMatthew G. Knepley . -dm_refine                         - Refine mesh after distribution
4869c3db174cSMatthew G. Knepley . -dm_localize <bool>                - Whether to localize coordinates for periodic meshes
4870c3db174cSMatthew G. Knepley . -dm_sparse_localize <bool>         - Whether to only localize cells on the periodic boundary
4871250712c9SMatthew G. Knepley . -dm_plex_hash_location             - Use grid hashing for point location
4872ddce0771SMatthew G. Knepley . -dm_plex_hash_box_faces <n,m,p>    - The number of divisions in each direction of the grid hash
4873f12cf164SMatthew G. Knepley . -dm_plex_partition_balance         - Attempt to evenly divide points on partition boundary between processes
4874f12cf164SMatthew G. Knepley . -dm_plex_remesh_bd                 - Allow changes to the boundary on remeshing
4875d5b43468SJose E. Roman . -dm_plex_max_projection_height     - Maximum mesh point height used to project locally
4876f12cf164SMatthew G. Knepley . -dm_plex_regular_refinement        - Use special nested projection algorithm for regular refinement
4877d02c7345SMatthew G. Knepley . -dm_plex_reorder_section           - Use specialized blocking if available
4878aaa8cc7dSPierre Jolivet . -dm_plex_check_all                 - Perform all checks below
4879f12cf164SMatthew G. Knepley . -dm_plex_check_symmetry            - Check that the adjacency information in the mesh is symmetric
4880f12cf164SMatthew G. Knepley . -dm_plex_check_skeleton <celltype> - Check that each cell has the correct number of vertices
4881f12cf164SMatthew 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
4882f12cf164SMatthew G. Knepley . -dm_plex_check_geometry            - Check that cells have positive volume
4883f12cf164SMatthew G. Knepley . -dm_view :mesh.tex:ascii_latex     - View the mesh in LaTeX/TikZ
4884e5893cccSMatthew G. Knepley . -dm_plex_view_scale <num>          - Scale the TikZ
48855962854dSMatthew G. Knepley . -dm_plex_print_fem <num>           - View FEM assembly information, such as element vectors and matrices
48865962854dSMatthew G. Knepley - -dm_plex_print_fvm <num>           - View FVM assembly information, such as flux updates
4887e5893cccSMatthew G. Knepley 
48888818961aSMatthew G Knepley   Level: intermediate
48898818961aSMatthew G Knepley 
48901cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMType`, `DMPlexCreate()`, `DMCreate()`, `DMSetType()`, `PetscSection`
48918818961aSMatthew G Knepley M*/
48928818961aSMatthew G Knepley 
4893d71ae5a4SJacob Faibussowitsch PETSC_EXTERN PetscErrorCode DMCreate_Plex(DM dm)
4894d71ae5a4SJacob Faibussowitsch {
4895552f7358SJed Brown   DM_Plex *mesh;
4896412e9a14SMatthew G. Knepley   PetscInt unit;
4897552f7358SJed Brown 
4898552f7358SJed Brown   PetscFunctionBegin;
4899f39ec787SMatthew G. Knepley   PetscCall(PetscCitationsRegister(PlexCitation, &Plexcite));
4900552f7358SJed Brown   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
49014dfa11a4SJacob Faibussowitsch   PetscCall(PetscNew(&mesh));
4902adc21957SMatthew G. Knepley   dm->reorderSection = DM_REORDER_DEFAULT_NOTSET;
4903552f7358SJed Brown   dm->data           = mesh;
4904552f7358SJed Brown 
4905552f7358SJed Brown   mesh->refct = 1;
49069566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &mesh->coneSection));
49079566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &mesh->supportSection));
4908552f7358SJed Brown   mesh->refinementUniform      = PETSC_TRUE;
4909552f7358SJed Brown   mesh->refinementLimit        = -1.0;
4910e600fa54SMatthew G. Knepley   mesh->distDefault            = PETSC_TRUE;
4911adc21957SMatthew G. Knepley   mesh->reorderDefault         = DM_REORDER_DEFAULT_NOTSET;
49121d1f2f2aSksagiyam   mesh->distributionName       = NULL;
49137d0f5628SVaclav Hapla   mesh->interpolated           = DMPLEX_INTERPOLATED_INVALID;
49147d0f5628SVaclav Hapla   mesh->interpolatedCollective = DMPLEX_INTERPOLATED_INVALID;
4915552f7358SJed Brown 
49169566063dSJacob Faibussowitsch   PetscCall(PetscPartitionerCreate(PetscObjectComm((PetscObject)dm), &mesh->partitioner));
49172e62ab5aSMatthew G. Knepley   mesh->remeshBd = PETSC_FALSE;
4918d9deefdfSMatthew G. Knepley 
49198865f1eaSKarl Rupp   for (unit = 0; unit < NUM_PETSC_UNITS; ++unit) mesh->scale[unit] = 1.0;
4920552f7358SJed Brown 
4921df0420ecSMatthew G. Knepley   mesh->depthState    = -1;
4922ba2698f1SMatthew G. Knepley   mesh->celltypeState = -1;
49236113b454SMatthew G. Knepley   mesh->printTol      = 1.0e-10;
4924552f7358SJed Brown 
49259566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(dm));
49263ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4927552f7358SJed Brown }
4928552f7358SJed Brown 
4929552f7358SJed Brown /*@
4930a1cb98faSBarry Smith   DMPlexCreate - Creates a `DMPLEX` object, which encapsulates an unstructured mesh, or CW complex, which can be expressed using a Hasse Diagram.
4931552f7358SJed Brown 
4932d083f849SBarry Smith   Collective
4933552f7358SJed Brown 
4934552f7358SJed Brown   Input Parameter:
4935a1cb98faSBarry Smith . comm - The communicator for the `DMPLEX` object
4936552f7358SJed Brown 
4937552f7358SJed Brown   Output Parameter:
4938a1cb98faSBarry Smith . mesh - The `DMPLEX` object
4939552f7358SJed Brown 
4940552f7358SJed Brown   Level: beginner
4941552f7358SJed Brown 
494242747ad1SJacob Faibussowitsch .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMType`, `DMCreate()`, `DMSetType()`
4943552f7358SJed Brown @*/
4944d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreate(MPI_Comm comm, DM *mesh)
4945d71ae5a4SJacob Faibussowitsch {
4946552f7358SJed Brown   PetscFunctionBegin;
49474f572ea9SToby Isaac   PetscAssertPointer(mesh, 2);
49489566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, mesh));
49499566063dSJacob Faibussowitsch   PetscCall(DMSetType(*mesh, DMPLEX));
49503ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4951552f7358SJed Brown }
4952552f7358SJed Brown 
4953b09969d6SVaclav Hapla /*@C
4954a1cb98faSBarry Smith   DMPlexBuildFromCellListParallel - Build distributed `DMPLEX` topology from a list of vertices for each cell (common mesh generator output)
4955a1cb98faSBarry Smith 
495620f4b53cSBarry Smith   Collective; No Fortran Support
4957b09969d6SVaclav Hapla 
4958b09969d6SVaclav Hapla   Input Parameters:
4959a1cb98faSBarry Smith + dm          - The `DM`
4960b09969d6SVaclav Hapla . numCells    - The number of cells owned by this process
4961a1cb98faSBarry Smith . numVertices - The number of vertices to be owned by this process, or `PETSC_DECIDE`
4962a1cb98faSBarry Smith . NVertices   - The global number of vertices, or `PETSC_DETERMINE`
4963b09969d6SVaclav Hapla . numCorners  - The number of vertices for each cell
49645e488331SVaclav Hapla - cells       - An array of numCells*numCorners numbers, the global vertex numbers for each cell
4965b09969d6SVaclav Hapla 
4966be8c289dSNicolas Barral   Output Parameters:
4967a1cb98faSBarry Smith + vertexSF         - (Optional) `PetscSF` describing complete vertex ownership
4968be8c289dSNicolas Barral - verticesAdjSaved - (Optional) vertex adjacency array
4969b09969d6SVaclav Hapla 
4970b09969d6SVaclav Hapla   Level: advanced
4971b09969d6SVaclav Hapla 
4972a1cb98faSBarry Smith   Notes:
4973a1cb98faSBarry Smith   Two triangles sharing a face
4974a1cb98faSBarry Smith .vb
4975a1cb98faSBarry Smith 
4976a1cb98faSBarry Smith         2
4977a1cb98faSBarry Smith       / | \
4978a1cb98faSBarry Smith      /  |  \
4979a1cb98faSBarry Smith     /   |   \
4980a1cb98faSBarry Smith    0  0 | 1  3
4981a1cb98faSBarry Smith     \   |   /
4982a1cb98faSBarry Smith      \  |  /
4983a1cb98faSBarry Smith       \ | /
4984a1cb98faSBarry Smith         1
4985a1cb98faSBarry Smith .ve
4986a1cb98faSBarry Smith   would have input
4987a1cb98faSBarry Smith .vb
4988a1cb98faSBarry Smith   numCells = 2, numVertices = 4
4989a1cb98faSBarry Smith   cells = [0 1 2  1 3 2]
4990a1cb98faSBarry Smith .ve
4991a1cb98faSBarry Smith   which would result in the `DMPLEX`
4992a1cb98faSBarry Smith .vb
4993a1cb98faSBarry Smith 
4994a1cb98faSBarry Smith         4
4995a1cb98faSBarry Smith       / | \
4996a1cb98faSBarry Smith      /  |  \
4997a1cb98faSBarry Smith     /   |   \
4998a1cb98faSBarry Smith    2  0 | 1  5
4999a1cb98faSBarry Smith     \   |   /
5000a1cb98faSBarry Smith      \  |  /
5001a1cb98faSBarry Smith       \ | /
5002a1cb98faSBarry Smith         3
5003a1cb98faSBarry Smith .ve
5004a1cb98faSBarry Smith 
5005a1cb98faSBarry Smith   Vertices are implicitly numbered consecutively 0,...,NVertices.
5006a1cb98faSBarry Smith   Each rank owns a chunk of numVertices consecutive vertices.
5007a1cb98faSBarry Smith   If numVertices is `PETSC_DECIDE`, PETSc will distribute them as evenly as possible using PetscLayout.
5008a1cb98faSBarry Smith   If NVertices is `PETSC_DETERMINE` and numVertices is PETSC_DECIDE, NVertices is computed by PETSc as the maximum vertex index in cells + 1.
5009a1cb98faSBarry Smith   If only NVertices is `PETSC_DETERMINE`, it is computed as the sum of numVertices over all ranks.
5010a1cb98faSBarry Smith 
5011a1cb98faSBarry Smith   The cell distribution is arbitrary non-overlapping, independent of the vertex distribution.
5012a1cb98faSBarry Smith 
50131cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildFromCellList()`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildCoordinatesFromCellListParallel()`,
5014a1cb98faSBarry Smith           `PetscSF`
5015b09969d6SVaclav Hapla @*/
5016d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildFromCellListParallel(DM dm, PetscInt numCells, PetscInt numVertices, PetscInt NVertices, PetscInt numCorners, const PetscInt cells[], PetscSF *vertexSF, PetscInt **verticesAdjSaved)
5017d71ae5a4SJacob Faibussowitsch {
50182464107aSksagiyam   PetscSF     sfPoint;
50192464107aSksagiyam   PetscLayout layout;
502082fb893eSVaclav Hapla   PetscInt    numVerticesAdj, *verticesAdj, *cones, c, p;
5021a47d0d45SMatthew G. Knepley 
5022a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
502325b6865aSVaclav Hapla   PetscValidLogicalCollectiveInt(dm, NVertices, 4);
50249566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
502525b6865aSVaclav Hapla   /* Get/check global number of vertices */
502625b6865aSVaclav Hapla   {
502725b6865aSVaclav Hapla     PetscInt       NVerticesInCells, i;
502825b6865aSVaclav Hapla     const PetscInt len = numCells * numCorners;
502925b6865aSVaclav Hapla 
503025b6865aSVaclav Hapla     /* NVerticesInCells = max(cells) + 1 */
503125b6865aSVaclav Hapla     NVerticesInCells = PETSC_MIN_INT;
50329371c9d4SSatish Balay     for (i = 0; i < len; i++)
50339371c9d4SSatish Balay       if (cells[i] > NVerticesInCells) NVerticesInCells = cells[i];
503425b6865aSVaclav Hapla     ++NVerticesInCells;
5035712fec58SPierre Jolivet     PetscCall(MPIU_Allreduce(MPI_IN_PLACE, &NVerticesInCells, 1, MPIU_INT, MPI_MAX, PetscObjectComm((PetscObject)dm)));
503625b6865aSVaclav Hapla 
503725b6865aSVaclav Hapla     if (numVertices == PETSC_DECIDE && NVertices == PETSC_DECIDE) NVertices = NVerticesInCells;
50389371c9d4SSatish Balay     else
50399371c9d4SSatish 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);
504025b6865aSVaclav Hapla   }
50419079aca8SVaclav Hapla   /* Count locally unique vertices */
50429079aca8SVaclav Hapla   {
50439079aca8SVaclav Hapla     PetscHSetI vhash;
50449079aca8SVaclav Hapla     PetscInt   off = 0;
50459079aca8SVaclav Hapla 
50469566063dSJacob Faibussowitsch     PetscCall(PetscHSetICreate(&vhash));
5047a47d0d45SMatthew G. Knepley     for (c = 0; c < numCells; ++c) {
504848a46eb9SPierre Jolivet       for (p = 0; p < numCorners; ++p) PetscCall(PetscHSetIAdd(vhash, cells[c * numCorners + p]));
5049a47d0d45SMatthew G. Knepley     }
50509566063dSJacob Faibussowitsch     PetscCall(PetscHSetIGetSize(vhash, &numVerticesAdj));
50519566063dSJacob Faibussowitsch     if (!verticesAdjSaved) PetscCall(PetscMalloc1(numVerticesAdj, &verticesAdj));
5052ad540459SPierre Jolivet     else verticesAdj = *verticesAdjSaved;
50539566063dSJacob Faibussowitsch     PetscCall(PetscHSetIGetElems(vhash, &off, verticesAdj));
50549566063dSJacob Faibussowitsch     PetscCall(PetscHSetIDestroy(&vhash));
505563a3b9bcSJacob Faibussowitsch     PetscCheck(off == numVerticesAdj, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid number of local vertices %" PetscInt_FMT " should be %" PetscInt_FMT, off, numVerticesAdj);
5056a47d0d45SMatthew G. Knepley   }
50579566063dSJacob Faibussowitsch   PetscCall(PetscSortInt(numVerticesAdj, verticesAdj));
5058a47d0d45SMatthew G. Knepley   /* Create cones */
50599566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, 0, numCells + numVerticesAdj));
50609566063dSJacob Faibussowitsch   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, numCorners));
50619566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm));
50629566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCones(dm, &cones));
5063a47d0d45SMatthew G. Knepley   for (c = 0; c < numCells; ++c) {
5064a47d0d45SMatthew G. Knepley     for (p = 0; p < numCorners; ++p) {
5065a47d0d45SMatthew G. Knepley       const PetscInt gv = cells[c * numCorners + p];
5066a47d0d45SMatthew G. Knepley       PetscInt       lv;
5067a47d0d45SMatthew G. Knepley 
50689079aca8SVaclav Hapla       /* Positions within verticesAdj form 0-based local vertex numbering;
50699079aca8SVaclav Hapla          we need to shift it by numCells to get correct DAG points (cells go first) */
50709566063dSJacob Faibussowitsch       PetscCall(PetscFindInt(gv, numVerticesAdj, verticesAdj, &lv));
507163a3b9bcSJacob Faibussowitsch       PetscCheck(lv >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Could not find global vertex %" PetscInt_FMT " in local connectivity", gv);
5072961cfab0SVaclav Hapla       cones[c * numCorners + p] = lv + numCells;
5073a47d0d45SMatthew G. Knepley     }
5074a47d0d45SMatthew G. Knepley   }
50752464107aSksagiyam   /* Build point sf */
50769566063dSJacob Faibussowitsch   PetscCall(PetscLayoutCreate(PetscObjectComm((PetscObject)dm), &layout));
50779566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetSize(layout, NVertices));
50789566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetLocalSize(layout, numVertices));
50799566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetBlockSize(layout, 1));
50809566063dSJacob Faibussowitsch   PetscCall(PetscSFCreateByMatchingIndices(layout, numVerticesAdj, verticesAdj, NULL, numCells, numVerticesAdj, verticesAdj, NULL, numCells, vertexSF, &sfPoint));
50819566063dSJacob Faibussowitsch   PetscCall(PetscLayoutDestroy(&layout));
50829566063dSJacob Faibussowitsch   if (!verticesAdjSaved) PetscCall(PetscFree(verticesAdj));
50839566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)sfPoint, "point SF"));
50842464107aSksagiyam   if (dm->sf) {
50852464107aSksagiyam     const char *prefix;
50862464107aSksagiyam 
50879566063dSJacob Faibussowitsch     PetscCall(PetscObjectGetOptionsPrefix((PetscObject)dm->sf, &prefix));
50889566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)sfPoint, prefix));
50892464107aSksagiyam   }
50909566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dm, sfPoint));
50919566063dSJacob Faibussowitsch   PetscCall(PetscSFDestroy(&sfPoint));
5092f4f49eeaSPierre Jolivet   if (vertexSF) PetscCall(PetscObjectSetName((PetscObject)*vertexSF, "Vertex Ownership SF"));
5093a47d0d45SMatthew G. Knepley   /* Fill in the rest of the topology structure */
50949566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
50959566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
50969566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
50973ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5098a47d0d45SMatthew G. Knepley }
5099a47d0d45SMatthew G. Knepley 
5100cc4c1da9SBarry Smith /*@
5101a1cb98faSBarry Smith   DMPlexBuildCoordinatesFromCellListParallel - Build `DM` coordinates from a list of coordinates for each owned vertex (common mesh generator output)
5102a1cb98faSBarry Smith 
510320f4b53cSBarry Smith   Collective; No Fortran Support
5104b09969d6SVaclav Hapla 
5105b09969d6SVaclav Hapla   Input Parameters:
5106a1cb98faSBarry Smith + dm           - The `DM`
5107b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
5108a1cb98faSBarry Smith . sfVert       - `PetscSF` describing complete vertex ownership
5109b09969d6SVaclav Hapla - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
5110b09969d6SVaclav Hapla 
5111b09969d6SVaclav Hapla   Level: advanced
5112b09969d6SVaclav Hapla 
51131cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildFromCellListParallel()`
5114b09969d6SVaclav Hapla @*/
5115d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildCoordinatesFromCellListParallel(DM dm, PetscInt spaceDim, PetscSF sfVert, const PetscReal vertexCoords[])
5116d71ae5a4SJacob Faibussowitsch {
5117a47d0d45SMatthew G. Knepley   PetscSection coordSection;
5118a47d0d45SMatthew G. Knepley   Vec          coordinates;
5119a47d0d45SMatthew G. Knepley   PetscScalar *coords;
51201edcf0b2SVaclav Hapla   PetscInt     numVertices, numVerticesAdj, coordSize, v, vStart, vEnd;
5121a47d0d45SMatthew G. Knepley 
5122a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
51239566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
51249566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
51251dca8a05SBarry Smith   PetscCheck(vStart >= 0 && vEnd >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "DM is not set up properly. DMPlexBuildFromCellList() should be called first.");
51269566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, spaceDim));
51279566063dSJacob Faibussowitsch   PetscCall(PetscSFGetGraph(sfVert, &numVertices, &numVerticesAdj, NULL, NULL));
51281dca8a05SBarry 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);
51299566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
51309566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
51319566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, spaceDim));
51329566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, vStart, vEnd));
51331edcf0b2SVaclav Hapla   for (v = vStart; v < vEnd; ++v) {
51349566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, spaceDim));
51359566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, spaceDim));
5136a47d0d45SMatthew G. Knepley   }
51379566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
51389566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
51399566063dSJacob Faibussowitsch   PetscCall(VecCreate(PetscObjectComm((PetscObject)dm), &coordinates));
51409566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, spaceDim));
51419566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
51429566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
51439566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
51449566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
5145a47d0d45SMatthew G. Knepley   {
5146a47d0d45SMatthew G. Knepley     MPI_Datatype coordtype;
5147a47d0d45SMatthew G. Knepley 
5148a47d0d45SMatthew G. Knepley     /* Need a temp buffer for coords if we have complex/single */
51499566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_contiguous(spaceDim, MPIU_SCALAR, &coordtype));
51509566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_commit(&coordtype));
515121016a8bSBarry Smith #if defined(PETSC_USE_COMPLEX)
515221016a8bSBarry Smith     {
515321016a8bSBarry Smith       PetscScalar *svertexCoords;
515421016a8bSBarry Smith       PetscInt     i;
51559566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numVertices * spaceDim, &svertexCoords));
51563612f820SVaclav Hapla       for (i = 0; i < numVertices * spaceDim; i++) svertexCoords[i] = vertexCoords[i];
51579566063dSJacob Faibussowitsch       PetscCall(PetscSFBcastBegin(sfVert, coordtype, svertexCoords, coords, MPI_REPLACE));
51589566063dSJacob Faibussowitsch       PetscCall(PetscSFBcastEnd(sfVert, coordtype, svertexCoords, coords, MPI_REPLACE));
51599566063dSJacob Faibussowitsch       PetscCall(PetscFree(svertexCoords));
516021016a8bSBarry Smith     }
516121016a8bSBarry Smith #else
51629566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastBegin(sfVert, coordtype, vertexCoords, coords, MPI_REPLACE));
51639566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastEnd(sfVert, coordtype, vertexCoords, coords, MPI_REPLACE));
516421016a8bSBarry Smith #endif
51659566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_free(&coordtype));
5166a47d0d45SMatthew G. Knepley   }
51679566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
51689566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
51699566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
51709566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
51713ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5172a47d0d45SMatthew G. Knepley }
5173a47d0d45SMatthew G. Knepley 
5174c3edce3dSSatish Balay /*@
5175a1cb98faSBarry Smith   DMPlexCreateFromCellListParallelPetsc - Create distributed `DMPLEX` from a list of vertices for each cell (common mesh generator output)
5176a1cb98faSBarry Smith 
5177a1cb98faSBarry Smith   Collective
5178a47d0d45SMatthew G. Knepley 
5179a47d0d45SMatthew G. Knepley   Input Parameters:
5180a47d0d45SMatthew G. Knepley + comm         - The communicator
5181a47d0d45SMatthew G. Knepley . dim          - The topological dimension of the mesh
5182a47d0d45SMatthew G. Knepley . numCells     - The number of cells owned by this process
5183a1cb98faSBarry Smith . numVertices  - The number of vertices owned by this process, or `PETSC_DECIDE`
5184a1cb98faSBarry Smith . NVertices    - The global number of vertices, or `PETSC_DECIDE`
5185a47d0d45SMatthew G. Knepley . numCorners   - The number of vertices for each cell
5186a47d0d45SMatthew G. Knepley . interpolate  - Flag indicating that intermediate mesh entities (faces, edges) should be created automatically
5187a47d0d45SMatthew G. Knepley . cells        - An array of numCells*numCorners numbers, the global vertex numbers for each cell
5188a47d0d45SMatthew G. Knepley . spaceDim     - The spatial dimension used for coordinates
5189a47d0d45SMatthew G. Knepley - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
5190a47d0d45SMatthew G. Knepley 
5191d8d19677SJose E. Roman   Output Parameters:
5192a1cb98faSBarry Smith + dm          - The `DM`
5193a1cb98faSBarry Smith . vertexSF    - (Optional) `PetscSF` describing complete vertex ownership
519460225df5SJacob Faibussowitsch - verticesAdj - (Optional) vertex adjacency array
5195a47d0d45SMatthew G. Knepley 
5196b09969d6SVaclav Hapla   Level: intermediate
5197a47d0d45SMatthew G. Knepley 
5198a1cb98faSBarry Smith   Notes:
5199a1cb98faSBarry Smith   This function is just a convenient sequence of `DMCreate()`, `DMSetType()`, `DMSetDimension()`,
5200a1cb98faSBarry Smith   `DMPlexBuildFromCellListParallel()`, `DMPlexInterpolate()`, `DMPlexBuildCoordinatesFromCellListParallel()`
5201a1cb98faSBarry Smith 
5202a1cb98faSBarry Smith   See `DMPlexBuildFromCellListParallel()` for an example and details about the topology-related parameters.
5203a1cb98faSBarry Smith 
5204a1cb98faSBarry Smith   See `DMPlexBuildCoordinatesFromCellListParallel()` for details about the geometry-related parameters.
5205a1cb98faSBarry Smith 
52061cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListPetsc()`, `DMPlexBuildFromCellListParallel()`, `DMPlexBuildCoordinatesFromCellListParallel()`, `DMPlexCreateFromDAG()`, `DMPlexCreate()`
5207a47d0d45SMatthew G. Knepley @*/
5208d71ae5a4SJacob 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)
5209d71ae5a4SJacob Faibussowitsch {
5210a47d0d45SMatthew G. Knepley   PetscSF sfVert;
5211a47d0d45SMatthew G. Knepley 
5212a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
52139566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
52149566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
5215a47d0d45SMatthew G. Knepley   PetscValidLogicalCollectiveInt(*dm, dim, 2);
5216064a246eSJacob Faibussowitsch   PetscValidLogicalCollectiveInt(*dm, spaceDim, 9);
52179566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
52189566063dSJacob Faibussowitsch   PetscCall(DMPlexBuildFromCellListParallel(*dm, numCells, numVertices, NVertices, numCorners, cells, &sfVert, verticesAdj));
5219a47d0d45SMatthew G. Knepley   if (interpolate) {
52205fd9971aSMatthew G. Knepley     DM idm;
5221a47d0d45SMatthew G. Knepley 
52229566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
52239566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
5224a47d0d45SMatthew G. Knepley     *dm = idm;
5225a47d0d45SMatthew G. Knepley   }
52269566063dSJacob Faibussowitsch   PetscCall(DMPlexBuildCoordinatesFromCellListParallel(*dm, spaceDim, sfVert, vertexCoords));
522718d54ad4SMichael Lange   if (vertexSF) *vertexSF = sfVert;
52289566063dSJacob Faibussowitsch   else PetscCall(PetscSFDestroy(&sfVert));
52293ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5230a47d0d45SMatthew G. Knepley }
5231a47d0d45SMatthew G. Knepley 
5232cc4c1da9SBarry Smith /*@
5233a1cb98faSBarry Smith   DMPlexBuildFromCellList - Build `DMPLEX` topology from a list of vertices for each cell (common mesh generator output)
5234a1cb98faSBarry Smith 
523520f4b53cSBarry Smith   Collective; No Fortran Support
52369298eaa6SMatthew G Knepley 
52379298eaa6SMatthew G Knepley   Input Parameters:
5238a1cb98faSBarry Smith + dm          - The `DM`
5239b09969d6SVaclav Hapla . numCells    - The number of cells owned by this process
5240a1cb98faSBarry Smith . numVertices - The number of vertices owned by this process, or `PETSC_DETERMINE`
52419298eaa6SMatthew G Knepley . numCorners  - The number of vertices for each cell
5242a3b724e8SBarry Smith - cells       - An array of `numCells` x `numCorners` numbers, the global vertex numbers for each cell
52439298eaa6SMatthew G Knepley 
5244b09969d6SVaclav Hapla   Level: advanced
52459298eaa6SMatthew G Knepley 
5246b09969d6SVaclav Hapla   Notes:
5247b09969d6SVaclav Hapla   Two triangles sharing a face
5248a1cb98faSBarry Smith .vb
52499298eaa6SMatthew G Knepley 
5250a1cb98faSBarry Smith         2
5251a1cb98faSBarry Smith       / | \
5252a1cb98faSBarry Smith      /  |  \
5253a1cb98faSBarry Smith     /   |   \
5254a1cb98faSBarry Smith    0  0 | 1  3
5255a1cb98faSBarry Smith     \   |   /
5256a1cb98faSBarry Smith      \  |  /
5257a1cb98faSBarry Smith       \ | /
5258a1cb98faSBarry Smith         1
5259a1cb98faSBarry Smith .ve
5260a1cb98faSBarry Smith   would have input
5261a1cb98faSBarry Smith .vb
5262a1cb98faSBarry Smith   numCells = 2, numVertices = 4
5263a1cb98faSBarry Smith   cells = [0 1 2  1 3 2]
5264a1cb98faSBarry Smith .ve
5265a1cb98faSBarry Smith   which would result in the `DMPLEX`
5266a1cb98faSBarry Smith .vb
5267a1cb98faSBarry Smith 
5268a1cb98faSBarry Smith         4
5269a1cb98faSBarry Smith       / | \
5270a1cb98faSBarry Smith      /  |  \
5271a1cb98faSBarry Smith     /   |   \
5272a1cb98faSBarry Smith    2  0 | 1  5
5273a1cb98faSBarry Smith     \   |   /
5274a1cb98faSBarry Smith      \  |  /
5275a1cb98faSBarry Smith       \ | /
5276a1cb98faSBarry Smith         3
5277a1cb98faSBarry Smith .ve
5278a1cb98faSBarry Smith 
5279a1cb98faSBarry Smith   If numVertices is `PETSC_DETERMINE`, it is computed by PETSc as the maximum vertex index in cells + 1.
528025b6865aSVaclav Hapla 
52811cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildFromCellListParallel()`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromCellListPetsc()`
5282b09969d6SVaclav Hapla @*/
5283d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildFromCellList(DM dm, PetscInt numCells, PetscInt numVertices, PetscInt numCorners, const PetscInt cells[])
5284d71ae5a4SJacob Faibussowitsch {
5285961cfab0SVaclav Hapla   PetscInt *cones, c, p, dim;
5286b09969d6SVaclav Hapla 
5287b09969d6SVaclav Hapla   PetscFunctionBegin;
52889566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
52899566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
529025b6865aSVaclav Hapla   /* Get/check global number of vertices */
529125b6865aSVaclav Hapla   {
529225b6865aSVaclav Hapla     PetscInt       NVerticesInCells, i;
529325b6865aSVaclav Hapla     const PetscInt len = numCells * numCorners;
529425b6865aSVaclav Hapla 
529525b6865aSVaclav Hapla     /* NVerticesInCells = max(cells) + 1 */
529625b6865aSVaclav Hapla     NVerticesInCells = PETSC_MIN_INT;
52979371c9d4SSatish Balay     for (i = 0; i < len; i++)
52989371c9d4SSatish Balay       if (cells[i] > NVerticesInCells) NVerticesInCells = cells[i];
529925b6865aSVaclav Hapla     ++NVerticesInCells;
530025b6865aSVaclav Hapla 
530125b6865aSVaclav Hapla     if (numVertices == PETSC_DECIDE) numVertices = NVerticesInCells;
53029371c9d4SSatish Balay     else
53039371c9d4SSatish 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);
530425b6865aSVaclav Hapla   }
53059566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
530648a46eb9SPierre Jolivet   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, numCorners));
53079566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm));
53089566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCones(dm, &cones));
5309b09969d6SVaclav Hapla   for (c = 0; c < numCells; ++c) {
5310ad540459SPierre Jolivet     for (p = 0; p < numCorners; ++p) cones[c * numCorners + p] = cells[c * numCorners + p] + numCells;
5311b09969d6SVaclav Hapla   }
53129566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
53139566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
53149566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
53153ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5316b09969d6SVaclav Hapla }
5317b09969d6SVaclav Hapla 
5318cc4c1da9SBarry Smith /*@
5319a1cb98faSBarry Smith   DMPlexBuildCoordinatesFromCellList - Build `DM` coordinates from a list of coordinates for each owned vertex (common mesh generator output)
5320a1cb98faSBarry Smith 
5321cc4c1da9SBarry Smith   Collective
5322b09969d6SVaclav Hapla 
5323b09969d6SVaclav Hapla   Input Parameters:
5324a1cb98faSBarry Smith + dm           - The `DM`
5325b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
5326b09969d6SVaclav Hapla - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
5327b09969d6SVaclav Hapla 
5328b09969d6SVaclav Hapla   Level: advanced
5329b09969d6SVaclav Hapla 
53301cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildCoordinatesFromCellListParallel()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexBuildFromCellList()`
5331b09969d6SVaclav Hapla @*/
5332d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildCoordinatesFromCellList(DM dm, PetscInt spaceDim, const PetscReal vertexCoords[])
5333d71ae5a4SJacob Faibussowitsch {
5334b09969d6SVaclav Hapla   PetscSection coordSection;
5335b09969d6SVaclav Hapla   Vec          coordinates;
5336b09969d6SVaclav Hapla   DM           cdm;
5337b09969d6SVaclav Hapla   PetscScalar *coords;
53381edcf0b2SVaclav Hapla   PetscInt     v, vStart, vEnd, d;
5339b09969d6SVaclav Hapla 
5340b09969d6SVaclav Hapla   PetscFunctionBegin;
53419566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
53429566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
53431dca8a05SBarry Smith   PetscCheck(vStart >= 0 && vEnd >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "DM is not set up properly. DMPlexBuildFromCellList() should be called first.");
53449566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, spaceDim));
53459566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
53469566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
53479566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, spaceDim));
53489566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, vStart, vEnd));
53491edcf0b2SVaclav Hapla   for (v = vStart; v < vEnd; ++v) {
53509566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, spaceDim));
53519566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, spaceDim));
5352b09969d6SVaclav Hapla   }
53539566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
5354b09969d6SVaclav Hapla 
53559566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dm, &cdm));
53569566063dSJacob Faibussowitsch   PetscCall(DMCreateLocalVector(cdm, &coordinates));
53579566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, spaceDim));
53589566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
53599566063dSJacob Faibussowitsch   PetscCall(VecGetArrayWrite(coordinates, &coords));
53601edcf0b2SVaclav Hapla   for (v = 0; v < vEnd - vStart; ++v) {
5361ad540459SPierre Jolivet     for (d = 0; d < spaceDim; ++d) coords[v * spaceDim + d] = vertexCoords[v * spaceDim + d];
5362b09969d6SVaclav Hapla   }
53639566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayWrite(coordinates, &coords));
53649566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
53659566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
53669566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
53673ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5368b09969d6SVaclav Hapla }
5369b09969d6SVaclav Hapla 
5370b09969d6SVaclav Hapla /*@
5371a1cb98faSBarry Smith   DMPlexCreateFromCellListPetsc - Create `DMPLEX` from a list of vertices for each cell (common mesh generator output), but only process 0 takes in the input
53723df08285SMatthew G. Knepley 
5373a1cb98faSBarry Smith   Collective
5374b09969d6SVaclav Hapla 
5375b09969d6SVaclav Hapla   Input Parameters:
5376b09969d6SVaclav Hapla + comm         - The communicator
5377b09969d6SVaclav Hapla . dim          - The topological dimension of the mesh
53783df08285SMatthew G. Knepley . numCells     - The number of cells, only on process 0
5379a1cb98faSBarry Smith . numVertices  - The number of vertices owned by this process, or `PETSC_DECIDE`, only on process 0
53803df08285SMatthew G. Knepley . numCorners   - The number of vertices for each cell, only on process 0
5381b09969d6SVaclav Hapla . interpolate  - Flag indicating that intermediate mesh entities (faces, edges) should be created automatically
53823df08285SMatthew G. Knepley . cells        - An array of numCells*numCorners numbers, the vertices for each cell, only on process 0
5383b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
53843df08285SMatthew G. Knepley - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex, only on process 0
5385b09969d6SVaclav Hapla 
5386b09969d6SVaclav Hapla   Output Parameter:
5387a1cb98faSBarry Smith . dm - The `DM`, which only has points on process 0
538825b6865aSVaclav Hapla 
5389b09969d6SVaclav Hapla   Level: intermediate
5390b09969d6SVaclav Hapla 
5391a1cb98faSBarry Smith   Notes:
5392a1cb98faSBarry Smith   This function is just a convenient sequence of `DMCreate()`, `DMSetType()`, `DMSetDimension()`, `DMPlexBuildFromCellList()`,
5393a1cb98faSBarry Smith   `DMPlexInterpolate()`, `DMPlexBuildCoordinatesFromCellList()`
5394a1cb98faSBarry Smith 
5395a1cb98faSBarry Smith   See `DMPlexBuildFromCellList()` for an example and details about the topology-related parameters.
5396a1cb98faSBarry Smith   See `DMPlexBuildCoordinatesFromCellList()` for details about the geometry-related parameters.
5397a1cb98faSBarry Smith   See `DMPlexCreateFromCellListParallelPetsc()` for parallel input
5398a1cb98faSBarry Smith 
53991cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildFromCellList()`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromDAG()`, `DMPlexCreate()`
54009298eaa6SMatthew G Knepley @*/
5401d71ae5a4SJacob 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)
5402d71ae5a4SJacob Faibussowitsch {
54033df08285SMatthew G. Knepley   PetscMPIInt rank;
54049298eaa6SMatthew G Knepley 
54059298eaa6SMatthew G Knepley   PetscFunctionBegin;
540628b400f6SJacob 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.");
54079566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
54089566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
54099566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
54109566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
5411c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildFromCellList(*dm, numCells, numVertices, numCorners, cells));
54129566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildFromCellList(*dm, 0, 0, 0, NULL));
54139298eaa6SMatthew G Knepley   if (interpolate) {
54145fd9971aSMatthew G. Knepley     DM idm;
54159298eaa6SMatthew G Knepley 
54169566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
54179566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
54189298eaa6SMatthew G Knepley     *dm = idm;
54199298eaa6SMatthew G Knepley   }
5420c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildCoordinatesFromCellList(*dm, spaceDim, vertexCoords));
54219566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildCoordinatesFromCellList(*dm, spaceDim, NULL));
54223ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
54239298eaa6SMatthew G Knepley }
54249298eaa6SMatthew G Knepley 
5425939f6067SMatthew G. Knepley /*@
542620f4b53cSBarry Smith   DMPlexCreateFromDAG - This takes as input the adjacency-list representation of the Directed Acyclic Graph (Hasse Diagram) encoding a mesh, and produces a `DM`
5427939f6067SMatthew G. Knepley 
5428939f6067SMatthew G. Knepley   Input Parameters:
542920f4b53cSBarry Smith + dm               - The empty `DM` object, usually from `DMCreate()` and `DMSetDimension()`
5430939f6067SMatthew G. Knepley . depth            - The depth of the DAG
543120f4b53cSBarry Smith . numPoints        - Array of size depth + 1 containing the number of points at each `depth`
5432939f6067SMatthew G. Knepley . coneSize         - The cone size of each point
5433939f6067SMatthew G. Knepley . cones            - The concatenation of the cone points for each point, the cone list must be oriented correctly for each point
5434939f6067SMatthew G. Knepley . coneOrientations - The orientation of each cone point
543520f4b53cSBarry Smith - vertexCoords     - An array of `numPoints`[0]*spacedim numbers representing the coordinates of each vertex, with spacedim the value set via `DMSetCoordinateDim()`
5436939f6067SMatthew G. Knepley 
5437939f6067SMatthew G. Knepley   Output Parameter:
543820f4b53cSBarry Smith . dm - The `DM`
543920f4b53cSBarry Smith 
544020f4b53cSBarry Smith   Level: advanced
5441939f6067SMatthew G. Knepley 
5442a1cb98faSBarry Smith   Note:
5443a1cb98faSBarry Smith   Two triangles sharing a face would have input
5444a1cb98faSBarry Smith .vb
5445a1cb98faSBarry Smith   depth = 1, numPoints = [4 2], coneSize = [3 3 0 0 0 0]
5446a1cb98faSBarry Smith   cones = [2 3 4  3 5 4], coneOrientations = [0 0 0  0 0 0]
5447a1cb98faSBarry Smith  vertexCoords = [-1.0 0.0  0.0 -1.0  0.0 1.0  1.0 0.0]
5448a1cb98faSBarry Smith .ve
5449939f6067SMatthew G. Knepley   which would result in the DMPlex
5450a1cb98faSBarry Smith .vb
5451a1cb98faSBarry Smith         4
5452a1cb98faSBarry Smith       / | \
5453a1cb98faSBarry Smith      /  |  \
5454a1cb98faSBarry Smith     /   |   \
5455a1cb98faSBarry Smith    2  0 | 1  5
5456a1cb98faSBarry Smith     \   |   /
5457a1cb98faSBarry Smith      \  |  /
5458a1cb98faSBarry Smith       \ | /
5459a1cb98faSBarry Smith         3
5460a1cb98faSBarry Smith .ve
5461a1cb98faSBarry Smith   Notice that all points are numbered consecutively, unlike `DMPlexCreateFromCellListPetsc()`
5462939f6067SMatthew G. Knepley 
54631cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`
5464939f6067SMatthew G. Knepley @*/
5465d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateFromDAG(DM dm, PetscInt depth, const PetscInt numPoints[], const PetscInt coneSize[], const PetscInt cones[], const PetscInt coneOrientations[], const PetscScalar vertexCoords[])
5466d71ae5a4SJacob Faibussowitsch {
54679298eaa6SMatthew G Knepley   Vec          coordinates;
54689298eaa6SMatthew G Knepley   PetscSection coordSection;
54699298eaa6SMatthew G Knepley   PetscScalar *coords;
5470811e8653SToby Isaac   PetscInt     coordSize, firstVertex = -1, pStart = 0, pEnd = 0, p, v, dim, dimEmbed, d, off;
54719298eaa6SMatthew G Knepley 
54729298eaa6SMatthew G Knepley   PetscFunctionBegin;
54739566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
54749566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &dimEmbed));
547563a3b9bcSJacob Faibussowitsch   PetscCheck(dimEmbed >= dim, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Embedding dimension %" PetscInt_FMT " cannot be less than intrinsic dimension %" PetscInt_FMT, dimEmbed, dim);
54769298eaa6SMatthew G Knepley   for (d = 0; d <= depth; ++d) pEnd += numPoints[d];
54779566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, pStart, pEnd));
54789298eaa6SMatthew G Knepley   for (p = pStart; p < pEnd; ++p) {
54799566063dSJacob Faibussowitsch     PetscCall(DMPlexSetConeSize(dm, p, coneSize[p - pStart]));
5480ad540459SPierre Jolivet     if (firstVertex < 0 && !coneSize[p - pStart]) firstVertex = p - pStart;
548197e052ccSToby Isaac   }
54821dca8a05SBarry Smith   PetscCheck(firstVertex >= 0 || !numPoints[0], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Expected %" PetscInt_FMT " vertices but could not find any", numPoints[0]);
54839566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm)); /* Allocate space for cones */
54849298eaa6SMatthew G Knepley   for (p = pStart, off = 0; p < pEnd; off += coneSize[p - pStart], ++p) {
54859566063dSJacob Faibussowitsch     PetscCall(DMPlexSetCone(dm, p, &cones[off]));
54869566063dSJacob Faibussowitsch     PetscCall(DMPlexSetConeOrientation(dm, p, &coneOrientations[off]));
54879298eaa6SMatthew G Knepley   }
54889566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
54899566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
54909298eaa6SMatthew G Knepley   /* Build coordinates */
54919566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
54929566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
54939566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dimEmbed));
54949566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numPoints[0]));
54959298eaa6SMatthew G Knepley   for (v = firstVertex; v < firstVertex + numPoints[0]; ++v) {
54969566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, dimEmbed));
54979566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dimEmbed));
54989298eaa6SMatthew G Knepley   }
54999566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
55009566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
55019566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
55029566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
55039566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
55049566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, dimEmbed));
55059566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
55069318fe57SMatthew G. Knepley   if (vertexCoords) {
55079566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
55089298eaa6SMatthew G Knepley     for (v = 0; v < numPoints[0]; ++v) {
55099298eaa6SMatthew G Knepley       PetscInt off;
55109298eaa6SMatthew G Knepley 
55119566063dSJacob Faibussowitsch       PetscCall(PetscSectionGetOffset(coordSection, v + firstVertex, &off));
5512ad540459SPierre Jolivet       for (d = 0; d < dimEmbed; ++d) coords[off + d] = vertexCoords[v * dimEmbed + d];
55139298eaa6SMatthew G Knepley     }
55149318fe57SMatthew G. Knepley   }
55159566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
55169566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
55179566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
55183ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
55199298eaa6SMatthew G Knepley }
55208415267dSToby Isaac 
5521a4e35b19SJacob Faibussowitsch /*
5522a1cb98faSBarry Smith   DMPlexCreateCellVertexFromFile - Create a `DMPLEX` mesh from a simple cell-vertex file.
5523a1cb98faSBarry Smith 
5524a1cb98faSBarry Smith   Collective
55258ca92349SMatthew G. Knepley 
55268ca92349SMatthew G. Knepley + comm        - The MPI communicator
55278ca92349SMatthew G. Knepley . filename    - Name of the .dat file
55288ca92349SMatthew G. Knepley - interpolate - Create faces and edges in the mesh
55298ca92349SMatthew G. Knepley 
55308ca92349SMatthew G. Knepley   Output Parameter:
5531a1cb98faSBarry Smith . dm  - The `DM` object representing the mesh
55328ca92349SMatthew G. Knepley 
55338ca92349SMatthew G. Knepley   Level: beginner
55348ca92349SMatthew G. Knepley 
5535a1cb98faSBarry Smith   Note:
5536a1cb98faSBarry Smith   The format is the simplest possible:
5537a1cb98faSBarry Smith .vb
5538d0812dedSMatthew G. Knepley   dim Ne Nv Nc Nl
5539d0812dedSMatthew G. Knepley   v_1 v_2 ... v_Nc
5540d0812dedSMatthew G. Knepley   ...
5541d0812dedSMatthew G. Knepley   x y z marker_1 ... marker_Nl
5542a1cb98faSBarry Smith .ve
5543a1cb98faSBarry Smith 
5544a1cb98faSBarry Smith   Developer Note:
5545a1cb98faSBarry Smith   Should use a `PetscViewer` not a filename
5546a1cb98faSBarry Smith 
55476afe31f6SMartin Diehl .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromFile()`, `DMPlexCreateGmsh()`, `DMPlexCreate()`
5548a4e35b19SJacob Faibussowitsch */
5549ff6a9541SJacob Faibussowitsch static PetscErrorCode DMPlexCreateCellVertexFromFile(MPI_Comm comm, const char filename[], PetscBool interpolate, DM *dm)
5550d71ae5a4SJacob Faibussowitsch {
55518ca92349SMatthew G. Knepley   DMLabel      marker;
55528ca92349SMatthew G. Knepley   PetscViewer  viewer;
55538ca92349SMatthew G. Knepley   Vec          coordinates;
55548ca92349SMatthew G. Knepley   PetscSection coordSection;
55558ca92349SMatthew G. Knepley   PetscScalar *coords;
55568ca92349SMatthew G. Knepley   char         line[PETSC_MAX_PATH_LEN];
5557d0812dedSMatthew G. Knepley   PetscInt     cdim, coordSize, v, c, d;
55588ca92349SMatthew G. Knepley   PetscMPIInt  rank;
5559d0812dedSMatthew G. Knepley   int          snum, dim, Nv, Nc, Ncn, Nl;
55608ca92349SMatthew G. Knepley 
55618ca92349SMatthew G. Knepley   PetscFunctionBegin;
55629566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
55639566063dSJacob Faibussowitsch   PetscCall(PetscViewerCreate(comm, &viewer));
55649566063dSJacob Faibussowitsch   PetscCall(PetscViewerSetType(viewer, PETSCVIEWERASCII));
55659566063dSJacob Faibussowitsch   PetscCall(PetscViewerFileSetMode(viewer, FILE_MODE_READ));
55669566063dSJacob Faibussowitsch   PetscCall(PetscViewerFileSetName(viewer, filename));
5567dd400576SPatrick Sanan   if (rank == 0) {
5568d0812dedSMatthew G. Knepley     PetscCall(PetscViewerRead(viewer, line, 5, NULL, PETSC_STRING));
5569d0812dedSMatthew G. Knepley     snum = sscanf(line, "%d %d %d %d %d", &dim, &Nc, &Nv, &Ncn, &Nl);
5570d0812dedSMatthew G. Knepley     PetscCheck(snum == 5, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
557125ce1634SJed Brown   } else {
5572f8d5e320SMatthew G. Knepley     Nc = Nv = Ncn = Nl = 0;
55738ca92349SMatthew G. Knepley   }
5574d0812dedSMatthew G. Knepley   PetscCallMPI(MPI_Bcast(&dim, 1, MPI_INT, 0, comm));
5575d0812dedSMatthew G. Knepley   cdim = (PetscInt)dim;
55769566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
55779566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
55789566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(*dm, 0, Nc + Nv));
5579d0812dedSMatthew G. Knepley   PetscCall(DMSetDimension(*dm, (PetscInt)dim));
55809566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(*dm, cdim));
55818ca92349SMatthew G. Knepley   /* Read topology */
5582dd400576SPatrick Sanan   if (rank == 0) {
5583f8d5e320SMatthew G. Knepley     char     format[PETSC_MAX_PATH_LEN];
5584f8d5e320SMatthew G. Knepley     PetscInt cone[8];
55858ca92349SMatthew G. Knepley     int      vbuf[8], v;
55868ca92349SMatthew G. Knepley 
55879371c9d4SSatish Balay     for (c = 0; c < Ncn; ++c) {
55889371c9d4SSatish Balay       format[c * 3 + 0] = '%';
55899371c9d4SSatish Balay       format[c * 3 + 1] = 'd';
55909371c9d4SSatish Balay       format[c * 3 + 2] = ' ';
55919371c9d4SSatish Balay     }
5592f8d5e320SMatthew G. Knepley     format[Ncn * 3 - 1] = '\0';
55939566063dSJacob Faibussowitsch     for (c = 0; c < Nc; ++c) PetscCall(DMPlexSetConeSize(*dm, c, Ncn));
55949566063dSJacob Faibussowitsch     PetscCall(DMSetUp(*dm));
55958ca92349SMatthew G. Knepley     for (c = 0; c < Nc; ++c) {
55969566063dSJacob Faibussowitsch       PetscCall(PetscViewerRead(viewer, line, Ncn, NULL, PETSC_STRING));
5597f8d5e320SMatthew G. Knepley       switch (Ncn) {
5598d71ae5a4SJacob Faibussowitsch       case 2:
5599d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1]);
5600d71ae5a4SJacob Faibussowitsch         break;
5601d71ae5a4SJacob Faibussowitsch       case 3:
5602d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2]);
5603d71ae5a4SJacob Faibussowitsch         break;
5604d71ae5a4SJacob Faibussowitsch       case 4:
5605d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3]);
5606d71ae5a4SJacob Faibussowitsch         break;
5607d71ae5a4SJacob Faibussowitsch       case 6:
5608d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3], &vbuf[4], &vbuf[5]);
5609d71ae5a4SJacob Faibussowitsch         break;
5610d71ae5a4SJacob Faibussowitsch       case 8:
5611d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3], &vbuf[4], &vbuf[5], &vbuf[6], &vbuf[7]);
5612d71ae5a4SJacob Faibussowitsch         break;
5613d71ae5a4SJacob Faibussowitsch       default:
5614d71ae5a4SJacob Faibussowitsch         SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "No cell shape with %d vertices", Ncn);
5615f8d5e320SMatthew G. Knepley       }
561608401ef6SPierre Jolivet       PetscCheck(snum == Ncn, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
5617f8d5e320SMatthew G. Knepley       for (v = 0; v < Ncn; ++v) cone[v] = vbuf[v] + Nc;
56188ca92349SMatthew G. Knepley       /* Hexahedra are inverted */
5619f8d5e320SMatthew G. Knepley       if (Ncn == 8) {
56208ca92349SMatthew G. Knepley         PetscInt tmp = cone[1];
56218ca92349SMatthew G. Knepley         cone[1]      = cone[3];
56228ca92349SMatthew G. Knepley         cone[3]      = tmp;
56238ca92349SMatthew G. Knepley       }
56249566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCone(*dm, c, cone));
56258ca92349SMatthew G. Knepley     }
56268ca92349SMatthew G. Knepley   }
56279566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(*dm));
56289566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(*dm));
56298ca92349SMatthew G. Knepley   /* Read coordinates */
56309566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(*dm, &coordSection));
56319566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
56329566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, cdim));
56339566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, Nc, Nc + Nv));
56348ca92349SMatthew G. Knepley   for (v = Nc; v < Nc + Nv; ++v) {
56359566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, cdim));
56369566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, cdim));
56378ca92349SMatthew G. Knepley   }
56389566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
56399566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
56409566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
56419566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
56429566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
56439566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, cdim));
56449566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
56459566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
5646dd400576SPatrick Sanan   if (rank == 0) {
5647f8d5e320SMatthew G. Knepley     char   format[PETSC_MAX_PATH_LEN];
56488ca92349SMatthew G. Knepley     double x[3];
5649f8d5e320SMatthew G. Knepley     int    l, val[3];
56508ca92349SMatthew G. Knepley 
5651f8d5e320SMatthew G. Knepley     if (Nl) {
56529371c9d4SSatish Balay       for (l = 0; l < Nl; ++l) {
56539371c9d4SSatish Balay         format[l * 3 + 0] = '%';
56549371c9d4SSatish Balay         format[l * 3 + 1] = 'd';
56559371c9d4SSatish Balay         format[l * 3 + 2] = ' ';
56569371c9d4SSatish Balay       }
5657f8d5e320SMatthew G. Knepley       format[Nl * 3 - 1] = '\0';
56589566063dSJacob Faibussowitsch       PetscCall(DMCreateLabel(*dm, "marker"));
56599566063dSJacob Faibussowitsch       PetscCall(DMGetLabel(*dm, "marker", &marker));
5660f8d5e320SMatthew G. Knepley     }
56618ca92349SMatthew G. Knepley     for (v = 0; v < Nv; ++v) {
56629566063dSJacob Faibussowitsch       PetscCall(PetscViewerRead(viewer, line, 3 + Nl, NULL, PETSC_STRING));
5663f8d5e320SMatthew G. Knepley       snum = sscanf(line, "%lg %lg %lg", &x[0], &x[1], &x[2]);
566408401ef6SPierre Jolivet       PetscCheck(snum == 3, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
5665f8d5e320SMatthew G. Knepley       switch (Nl) {
5666d71ae5a4SJacob Faibussowitsch       case 0:
5667d71ae5a4SJacob Faibussowitsch         snum = 0;
5668d71ae5a4SJacob Faibussowitsch         break;
5669d71ae5a4SJacob Faibussowitsch       case 1:
5670d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0]);
5671d71ae5a4SJacob Faibussowitsch         break;
5672d71ae5a4SJacob Faibussowitsch       case 2:
5673d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0], &val[1]);
5674d71ae5a4SJacob Faibussowitsch         break;
5675d71ae5a4SJacob Faibussowitsch       case 3:
5676d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0], &val[1], &val[2]);
5677d71ae5a4SJacob Faibussowitsch         break;
5678d71ae5a4SJacob Faibussowitsch       default:
5679d71ae5a4SJacob Faibussowitsch         SETERRQ(PETSC_COMM_SELF, PETSC_ERR_SUP, "Request support for %d labels", Nl);
5680f8d5e320SMatthew G. Knepley       }
568108401ef6SPierre Jolivet       PetscCheck(snum == Nl, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
56828ca92349SMatthew G. Knepley       for (d = 0; d < cdim; ++d) coords[v * cdim + d] = x[d];
56839566063dSJacob Faibussowitsch       for (l = 0; l < Nl; ++l) PetscCall(DMLabelSetValue(marker, v + Nc, val[l]));
56848ca92349SMatthew G. Knepley     }
56858ca92349SMatthew G. Knepley   }
56869566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
56879566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(*dm, coordinates));
56889566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
56899566063dSJacob Faibussowitsch   PetscCall(PetscViewerDestroy(&viewer));
56908ca92349SMatthew G. Knepley   if (interpolate) {
56918ca92349SMatthew G. Knepley     DM      idm;
56928ca92349SMatthew G. Knepley     DMLabel bdlabel;
56938ca92349SMatthew G. Knepley 
56949566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
56959566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
56968ca92349SMatthew G. Knepley     *dm = idm;
56978ca92349SMatthew G. Knepley 
5698f8d5e320SMatthew G. Knepley     if (!Nl) {
56999566063dSJacob Faibussowitsch       PetscCall(DMCreateLabel(*dm, "marker"));
57009566063dSJacob Faibussowitsch       PetscCall(DMGetLabel(*dm, "marker", &bdlabel));
57019566063dSJacob Faibussowitsch       PetscCall(DMPlexMarkBoundaryFaces(*dm, PETSC_DETERMINE, bdlabel));
57029566063dSJacob Faibussowitsch       PetscCall(DMPlexLabelComplete(*dm, bdlabel));
57038ca92349SMatthew G. Knepley     }
5704f8d5e320SMatthew G. Knepley   }
57053ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
57068ca92349SMatthew G. Knepley }
57078ca92349SMatthew G. Knepley 
5708cc4c1da9SBarry Smith /*@
5709a1cb98faSBarry Smith   DMPlexCreateFromFile - This takes a filename and produces a `DM`
5710a1cb98faSBarry Smith 
5711a1cb98faSBarry Smith   Collective
5712ca522641SMatthew G. Knepley 
5713ca522641SMatthew G. Knepley   Input Parameters:
5714ca522641SMatthew G. Knepley + comm        - The communicator
5715ca522641SMatthew G. Knepley . filename    - A file name
5716a1cb98faSBarry Smith . plexname    - The object name of the resulting `DM`, also used for intra-datafile lookup by some formats
5717ca522641SMatthew G. Knepley - interpolate - Flag to create intermediate mesh pieces (edges, faces)
5718ca522641SMatthew G. Knepley 
5719ca522641SMatthew G. Knepley   Output Parameter:
5720a1cb98faSBarry Smith . dm - The `DM`
5721ca522641SMatthew G. Knepley 
5722a1cb98faSBarry Smith   Options Database Key:
5723a1cb98faSBarry Smith . -dm_plex_create_from_hdf5_xdmf - use the `PETSC_VIEWER_HDF5_XDMF` format for reading HDF5
572402ef0d99SVaclav Hapla 
572537fdd005SBarry Smith   Use `-dm_plex_create_ prefix` to pass options to the internal `PetscViewer`, e.g.
5726bca97951SVaclav Hapla $ -dm_plex_create_viewer_hdf5_collective
5727bca97951SVaclav Hapla 
5728ca522641SMatthew G. Knepley   Level: beginner
5729ca522641SMatthew G. Knepley 
5730a1cb98faSBarry Smith   Notes:
5731a1cb98faSBarry Smith   Using `PETSCVIEWERHDF5` type with `PETSC_VIEWER_HDF5_PETSC` format, one can save multiple `DMPLEX`
5732a1cb98faSBarry Smith   meshes in a single HDF5 file. This in turn requires one to name the `DMPLEX` object with `PetscObjectSetName()`
5733a1cb98faSBarry Smith   before saving it with `DMView()` and before loading it with `DMLoad()` for identification of the mesh object.
5734a1cb98faSBarry Smith   The input parameter name is thus used to name the `DMPLEX` object when `DMPlexCreateFromFile()` internally
5735a1cb98faSBarry Smith   calls `DMLoad()`. Currently, name is ignored for other viewer types and/or formats.
5736a1cb98faSBarry Smith 
57371cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromDAG()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`, `PetscObjectSetName()`, `DMView()`, `DMLoad()`
5738ca522641SMatthew G. Knepley @*/
5739d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateFromFile(MPI_Comm comm, const char filename[], const char plexname[], PetscBool interpolate, DM *dm)
5740d71ae5a4SJacob Faibussowitsch {
5741ef3a5affSJacob Faibussowitsch   const char  extGmsh[]      = ".msh";
5742ef3a5affSJacob Faibussowitsch   const char  extGmsh2[]     = ".msh2";
5743ef3a5affSJacob Faibussowitsch   const char  extGmsh4[]     = ".msh4";
5744ef3a5affSJacob Faibussowitsch   const char  extCGNS[]      = ".cgns";
5745ef3a5affSJacob Faibussowitsch   const char  extExodus[]    = ".exo";
5746ef3a5affSJacob Faibussowitsch   const char  extExodus_e[]  = ".e";
5747ef3a5affSJacob Faibussowitsch   const char  extGenesis[]   = ".gen";
5748ef3a5affSJacob Faibussowitsch   const char  extFluent[]    = ".cas";
5749ef3a5affSJacob Faibussowitsch   const char  extHDF5[]      = ".h5";
57506f2c871aSStefano Zampini   const char  extXDMFHDF5[]  = ".xdmf.h5";
5751ef3a5affSJacob Faibussowitsch   const char  extPLY[]       = ".ply";
5752ef3a5affSJacob Faibussowitsch   const char  extEGADSLite[] = ".egadslite";
5753ef3a5affSJacob Faibussowitsch   const char  extEGADS[]     = ".egads";
5754ef3a5affSJacob Faibussowitsch   const char  extIGES[]      = ".igs";
5755ef3a5affSJacob Faibussowitsch   const char  extSTEP[]      = ".stp";
5756ef3a5affSJacob Faibussowitsch   const char  extCV[]        = ".dat";
5757ca522641SMatthew G. Knepley   size_t      len;
57586afe31f6SMartin Diehl   PetscBool   isGmsh, isGmsh2, isGmsh4, isCGNS, isExodus, isGenesis, isFluent, isHDF5, isPLY, isEGADSLite, isEGADS, isIGES, isSTEP, isCV, isXDMFHDF5;
5759ca522641SMatthew G. Knepley   PetscMPIInt rank;
5760ca522641SMatthew G. Knepley 
5761ca522641SMatthew G. Knepley   PetscFunctionBegin;
57624f572ea9SToby Isaac   PetscAssertPointer(filename, 2);
57634f572ea9SToby Isaac   if (plexname) PetscAssertPointer(plexname, 3);
57644f572ea9SToby Isaac   PetscAssertPointer(dm, 5);
57659566063dSJacob Faibussowitsch   PetscCall(DMInitializePackage());
57669566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_CreateFromFile, 0, 0, 0, 0));
57679566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
57689566063dSJacob Faibussowitsch   PetscCall(PetscStrlen(filename, &len));
576928b400f6SJacob Faibussowitsch   PetscCheck(len, comm, PETSC_ERR_ARG_WRONG, "Filename must be a valid path");
5770ef3a5affSJacob Faibussowitsch 
57719371c9d4SSatish Balay #define CheckExtension(extension__, is_extension__) \
57729371c9d4SSatish Balay   do { \
5773274aaeaaSJacob Faibussowitsch     PetscAssert(sizeof(extension__), comm, PETSC_ERR_PLIB, "Zero-size extension: %s", extension__); \
5774274aaeaaSJacob Faibussowitsch     /* don't count the null-terminator at the end */ \
5775274aaeaaSJacob Faibussowitsch     const size_t ext_len = sizeof(extension__) - 1; \
5776274aaeaaSJacob Faibussowitsch     if (len < ext_len) { \
5777ef3a5affSJacob Faibussowitsch       is_extension__ = PETSC_FALSE; \
5778ef3a5affSJacob Faibussowitsch     } else { \
5779274aaeaaSJacob Faibussowitsch       PetscCall(PetscStrncmp(filename + len - ext_len, extension__, ext_len, &is_extension__)); \
5780ef3a5affSJacob Faibussowitsch     } \
5781ef3a5affSJacob Faibussowitsch   } while (0)
5782ef3a5affSJacob Faibussowitsch 
5783ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh, isGmsh);
5784ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh2, isGmsh2);
5785ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh4, isGmsh4);
5786ef3a5affSJacob Faibussowitsch   CheckExtension(extCGNS, isCGNS);
5787ef3a5affSJacob Faibussowitsch   CheckExtension(extExodus, isExodus);
5788ef3a5affSJacob Faibussowitsch   if (!isExodus) CheckExtension(extExodus_e, isExodus);
5789ef3a5affSJacob Faibussowitsch   CheckExtension(extGenesis, isGenesis);
5790ef3a5affSJacob Faibussowitsch   CheckExtension(extFluent, isFluent);
5791ef3a5affSJacob Faibussowitsch   CheckExtension(extHDF5, isHDF5);
5792ef3a5affSJacob Faibussowitsch   CheckExtension(extPLY, isPLY);
5793ef3a5affSJacob Faibussowitsch   CheckExtension(extEGADSLite, isEGADSLite);
5794ef3a5affSJacob Faibussowitsch   CheckExtension(extEGADS, isEGADS);
5795ef3a5affSJacob Faibussowitsch   CheckExtension(extIGES, isIGES);
5796ef3a5affSJacob Faibussowitsch   CheckExtension(extSTEP, isSTEP);
5797ef3a5affSJacob Faibussowitsch   CheckExtension(extCV, isCV);
57986f2c871aSStefano Zampini   CheckExtension(extXDMFHDF5, isXDMFHDF5);
5799ef3a5affSJacob Faibussowitsch 
5800ef3a5affSJacob Faibussowitsch #undef CheckExtension
5801ef3a5affSJacob Faibussowitsch 
5802de78e4feSLisandro Dalcin   if (isGmsh || isGmsh2 || isGmsh4) {
58039566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateGmshFromFile(comm, filename, interpolate, dm));
5804ca522641SMatthew G. Knepley   } else if (isCGNS) {
58059566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateCGNSFromFile(comm, filename, interpolate, dm));
580690c68965SMatthew G. Knepley   } else if (isExodus || isGenesis) {
58079566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateExodusFromFile(comm, filename, interpolate, dm));
58082f0bd6dcSMichael Lange   } else if (isFluent) {
58099566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFluentFromFile(comm, filename, interpolate, dm));
5810cc2f8f65SMatthew G. Knepley   } else if (isHDF5) {
5811cc2f8f65SMatthew G. Knepley     PetscViewer viewer;
5812cc2f8f65SMatthew G. Knepley 
581343b242b4SVaclav 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 */
58146f2c871aSStefano Zampini     PetscCall(PetscOptionsGetBool(NULL, NULL, "-dm_plex_create_from_hdf5_xdmf", &isXDMFHDF5, NULL));
58159566063dSJacob Faibussowitsch     PetscCall(PetscViewerCreate(comm, &viewer));
58169566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetType(viewer, PETSCVIEWERHDF5));
58179566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetOptionsPrefix(viewer, "dm_plex_create_"));
58189566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetFromOptions(viewer));
58199566063dSJacob Faibussowitsch     PetscCall(PetscViewerFileSetMode(viewer, FILE_MODE_READ));
58209566063dSJacob Faibussowitsch     PetscCall(PetscViewerFileSetName(viewer, filename));
5821cd7e8a5eSksagiyam 
58229566063dSJacob Faibussowitsch     PetscCall(DMCreate(comm, dm));
5823f4f49eeaSPierre Jolivet     PetscCall(PetscObjectSetName((PetscObject)*dm, plexname));
58249566063dSJacob Faibussowitsch     PetscCall(DMSetType(*dm, DMPLEX));
58256f2c871aSStefano Zampini     if (isXDMFHDF5) PetscCall(PetscViewerPushFormat(viewer, PETSC_VIEWER_HDF5_XDMF));
58269566063dSJacob Faibussowitsch     PetscCall(DMLoad(*dm, viewer));
58276f2c871aSStefano Zampini     if (isXDMFHDF5) PetscCall(PetscViewerPopFormat(viewer));
58289566063dSJacob Faibussowitsch     PetscCall(PetscViewerDestroy(&viewer));
58295fd9971aSMatthew G. Knepley 
58305fd9971aSMatthew G. Knepley     if (interpolate) {
58315fd9971aSMatthew G. Knepley       DM idm;
58325fd9971aSMatthew G. Knepley 
58339566063dSJacob Faibussowitsch       PetscCall(DMPlexInterpolate(*dm, &idm));
58349566063dSJacob Faibussowitsch       PetscCall(DMDestroy(dm));
58355fd9971aSMatthew G. Knepley       *dm = idm;
58365fd9971aSMatthew G. Knepley     }
5837f2801cd6SMatthew G. Knepley   } else if (isPLY) {
58389566063dSJacob Faibussowitsch     PetscCall(DMPlexCreatePLYFromFile(comm, filename, interpolate, dm));
5839c1cad2e7SMatthew G. Knepley   } else if (isEGADSLite || isEGADS || isIGES || isSTEP) {
58409566063dSJacob Faibussowitsch     if (isEGADSLite) PetscCall(DMPlexCreateEGADSLiteFromFile(comm, filename, dm));
58419566063dSJacob Faibussowitsch     else PetscCall(DMPlexCreateEGADSFromFile(comm, filename, dm));
58427bee2925SMatthew Knepley     if (!interpolate) {
58437bee2925SMatthew Knepley       DM udm;
58447bee2925SMatthew Knepley 
58459566063dSJacob Faibussowitsch       PetscCall(DMPlexUninterpolate(*dm, &udm));
58469566063dSJacob Faibussowitsch       PetscCall(DMDestroy(dm));
58477bee2925SMatthew Knepley       *dm = udm;
58487bee2925SMatthew Knepley     }
58498ca92349SMatthew G. Knepley   } else if (isCV) {
58509566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateCellVertexFromFile(comm, filename, interpolate, dm));
585198921bdaSJacob Faibussowitsch   } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Cannot load file %s: unrecognized extension", filename);
58529566063dSJacob Faibussowitsch   PetscCall(PetscStrlen(plexname, &len));
5853f4f49eeaSPierre Jolivet   if (len) PetscCall(PetscObjectSetName((PetscObject)*dm, plexname));
58549566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_CreateFromFile, 0, 0, 0, 0));
58553ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5856ca522641SMatthew G. Knepley }
585712b8a6daSStefano Zampini 
5858cc4c1da9SBarry Smith /*@
58599f6c5813SMatthew 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.
58609f6c5813SMatthew G. Knepley 
58610528010dSStefano Zampini   Input Parameters:
58620528010dSStefano Zampini + tr     - The `DMPlexTransform`
58630528010dSStefano Zampini - prefix - An options prefix, or NULL
58649f6c5813SMatthew G. Knepley 
58659f6c5813SMatthew G. Knepley   Output Parameter:
58669f6c5813SMatthew G. Knepley . dm - The `DM`
58679f6c5813SMatthew G. Knepley 
58689f6c5813SMatthew G. Knepley   Level: beginner
58699f6c5813SMatthew G. Knepley 
587020f4b53cSBarry Smith   Notes:
587120f4b53cSBarry 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.
587220f4b53cSBarry Smith 
58739f6c5813SMatthew G. Knepley .seealso: `DMPlexCreateFromFile`, `DMPlexCreateFromDAG()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`
58749f6c5813SMatthew G. Knepley @*/
58750528010dSStefano Zampini PetscErrorCode DMPlexCreateEphemeral(DMPlexTransform tr, const char prefix[], DM *dm)
58769f6c5813SMatthew G. Knepley {
58770528010dSStefano Zampini   DM           bdm, bcdm, cdm;
58780528010dSStefano Zampini   Vec          coordinates, coordinatesNew;
58790528010dSStefano Zampini   PetscSection cs;
58800528010dSStefano Zampini   PetscInt     dim, cdim, Nl;
58819f6c5813SMatthew G. Knepley 
58829f6c5813SMatthew G. Knepley   PetscFunctionBegin;
58839f6c5813SMatthew G. Knepley   PetscCall(DMCreate(PetscObjectComm((PetscObject)tr), dm));
58849f6c5813SMatthew G. Knepley   PetscCall(DMSetType(*dm, DMPLEX));
58850528010dSStefano Zampini   ((DM_Plex *)(*dm)->data)->interpolated = DMPLEX_INTERPOLATED_FULL;
58860528010dSStefano Zampini   // Handle coordinates
58870528010dSStefano Zampini   PetscCall(DMPlexTransformGetDM(tr, &bdm));
58880528010dSStefano Zampini   PetscCall(DMGetCoordinateDim(bdm, &cdim));
58890528010dSStefano Zampini   PetscCall(DMSetCoordinateDim(*dm, cdim));
58900528010dSStefano Zampini   PetscCall(DMGetDimension(bdm, &dim));
58910528010dSStefano Zampini   PetscCall(DMSetDimension(*dm, dim));
58920528010dSStefano Zampini   PetscCall(DMGetCoordinateDM(bdm, &bcdm));
58930528010dSStefano Zampini   PetscCall(DMGetCoordinateDM(*dm, &cdm));
58940528010dSStefano Zampini   PetscCall(DMCopyDisc(bcdm, cdm));
58950528010dSStefano Zampini   PetscCall(DMGetLocalSection(cdm, &cs));
58960528010dSStefano Zampini   PetscCall(PetscSectionSetNumFields(cs, 1));
58970528010dSStefano Zampini   PetscCall(PetscSectionSetFieldComponents(cs, 0, cdim));
58980528010dSStefano Zampini   PetscCall(DMGetCoordinatesLocal(bdm, &coordinates));
58990528010dSStefano Zampini   PetscCall(VecDuplicate(coordinates, &coordinatesNew));
59000528010dSStefano Zampini   PetscCall(VecCopy(coordinates, coordinatesNew));
59010528010dSStefano Zampini   PetscCall(DMSetCoordinatesLocal(*dm, coordinatesNew));
59020528010dSStefano Zampini   PetscCall(VecDestroy(&coordinatesNew));
59039f6c5813SMatthew G. Knepley 
59049f6c5813SMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)tr));
59059f6c5813SMatthew G. Knepley   PetscCall(DMPlexTransformDestroy(&((DM_Plex *)(*dm)->data)->tr));
59069f6c5813SMatthew G. Knepley   ((DM_Plex *)(*dm)->data)->tr = tr;
59070528010dSStefano Zampini   PetscCall(DMPlexDistributeSetDefault(*dm, PETSC_FALSE));
59080528010dSStefano Zampini   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)*dm, prefix));
59090528010dSStefano Zampini   PetscCall(DMSetFromOptions(*dm));
59109f6c5813SMatthew G. Knepley 
59119f6c5813SMatthew G. Knepley   PetscCall(DMGetNumLabels(bdm, &Nl));
59129f6c5813SMatthew G. Knepley   for (PetscInt l = 0; l < Nl; ++l) {
59139f6c5813SMatthew G. Knepley     DMLabel     label, labelNew;
59149f6c5813SMatthew G. Knepley     const char *lname;
59159f6c5813SMatthew G. Knepley     PetscBool   isDepth, isCellType;
59169f6c5813SMatthew G. Knepley 
59179f6c5813SMatthew G. Knepley     PetscCall(DMGetLabelName(bdm, l, &lname));
59189f6c5813SMatthew G. Knepley     PetscCall(PetscStrcmp(lname, "depth", &isDepth));
59199f6c5813SMatthew G. Knepley     if (isDepth) continue;
59209f6c5813SMatthew G. Knepley     PetscCall(PetscStrcmp(lname, "celltype", &isCellType));
59219f6c5813SMatthew G. Knepley     if (isCellType) continue;
59229f6c5813SMatthew G. Knepley     PetscCall(DMCreateLabel(*dm, lname));
59239f6c5813SMatthew G. Knepley     PetscCall(DMGetLabel(bdm, lname, &label));
59249f6c5813SMatthew G. Knepley     PetscCall(DMGetLabel(*dm, lname, &labelNew));
59259f6c5813SMatthew G. Knepley     PetscCall(DMLabelSetType(labelNew, DMLABELEPHEMERAL));
59269f6c5813SMatthew G. Knepley     PetscCall(DMLabelEphemeralSetLabel(labelNew, label));
59279f6c5813SMatthew G. Knepley     PetscCall(DMLabelEphemeralSetTransform(labelNew, tr));
59289f6c5813SMatthew G. Knepley     PetscCall(DMLabelSetUp(labelNew));
59299f6c5813SMatthew G. Knepley   }
59303ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
59319f6c5813SMatthew G. Knepley }
5932