xref: /petsc/src/dm/impls/plex/plexcreate.c (revision c29ce622fa97c279dda1474b2f4e55cdcf02f6de)
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 
8434054ae39SJames Wright // Creates "Face Sets" label based on the standard box labeling conventions
8444054ae39SJames Wright static PetscErrorCode DMPlexSetBoxLabel_Internal(DM dm)
8454054ae39SJames Wright {
8466ff49feeSJames Wright   DM              cdm;
8476ff49feeSJames Wright   PetscSection    csection;
8486ff49feeSJames Wright   Vec             coordinates;
8494054ae39SJames Wright   DMLabel         label;
8506ff49feeSJames Wright   IS              faces_is;
8514054ae39SJames Wright   PetscInt        dim, num_face;
8524054ae39SJames Wright   const PetscInt *faces;
8534054ae39SJames Wright   PetscInt        faceMarkerBottom, faceMarkerTop, faceMarkerFront, faceMarkerBack, faceMarkerRight, faceMarkerLeft;
8544054ae39SJames Wright 
8554054ae39SJames Wright   PetscFunctionBeginUser;
8564054ae39SJames Wright   PetscCall(DMGetDimension(dm, &dim));
8576ff49feeSJames Wright   PetscCheck((dim == 2) || (dim == 3), PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "DMPlex box labeling only supports 2D and 3D meshes, recieved DM of dimension %" PetscInt_FMT, dim);
8584054ae39SJames Wright   // Get Face Sets label
8594054ae39SJames Wright   PetscCall(DMGetLabel(dm, "Face Sets", &label));
8604054ae39SJames Wright   if (label) {
8614054ae39SJames Wright     PetscCall(DMLabelReset(label));
8624054ae39SJames Wright   } else {
8634054ae39SJames Wright     PetscCall(DMCreateLabel(dm, "Face Sets"));
8644054ae39SJames Wright     PetscCall(DMGetLabel(dm, "Face Sets", &label));
8654054ae39SJames Wright   }
8664054ae39SJames Wright   PetscCall(DMPlexMarkBoundaryFaces(dm, 1, label));
8676ff49feeSJames Wright   PetscCall(DMGetStratumIS(dm, "Face Sets", 1, &faces_is));
8686ff49feeSJames Wright   if (!faces_is) PetscFunctionReturn(PETSC_SUCCESS); // No faces on rank
8694054ae39SJames Wright 
8704054ae39SJames Wright   switch (dim) {
8714054ae39SJames Wright   case 2:
8724054ae39SJames Wright     faceMarkerTop    = 3;
8734054ae39SJames Wright     faceMarkerBottom = 1;
8744054ae39SJames Wright     faceMarkerRight  = 2;
8754054ae39SJames Wright     faceMarkerLeft   = 4;
8764054ae39SJames Wright     break;
8774054ae39SJames Wright   case 3:
8784054ae39SJames Wright     faceMarkerBottom = 1;
8794054ae39SJames Wright     faceMarkerTop    = 2;
8804054ae39SJames Wright     faceMarkerFront  = 3;
8814054ae39SJames Wright     faceMarkerBack   = 4;
8824054ae39SJames Wright     faceMarkerRight  = 5;
8834054ae39SJames Wright     faceMarkerLeft   = 6;
8844054ae39SJames Wright     break;
8854054ae39SJames Wright   default:
8864054ae39SJames Wright     SETERRQ(PETSC_COMM_SELF, PETSC_ERR_SUP, "Dimension %" PetscInt_FMT " not supported", dim);
8874054ae39SJames Wright   }
8884054ae39SJames Wright 
8896ff49feeSJames Wright   PetscCall(ISGetLocalSize(faces_is, &num_face));
8906ff49feeSJames Wright   PetscCall(ISGetIndices(faces_is, &faces));
8916ff49feeSJames Wright   PetscCall(DMGetCoordinatesLocal(dm, &coordinates));
8926ff49feeSJames Wright   PetscCall(DMGetCoordinateDM(dm, &cdm));
8936ff49feeSJames Wright   PetscCall(DMGetLocalSection(cdm, &csection));
8944054ae39SJames Wright   for (PetscInt f = 0; f < num_face; ++f) {
8956ff49feeSJames Wright     PetscScalar *coords = NULL;
8966ff49feeSJames Wright     PetscInt     face = faces[f], flip = 1, label_value = -1, coords_size;
8974054ae39SJames Wright 
8984054ae39SJames Wright     { // Determine if orientation of face is flipped
8994054ae39SJames Wright       PetscInt        num_cells_support, num_faces, start = -1;
9004054ae39SJames Wright       const PetscInt *orients, *cell_faces, *cells;
9014054ae39SJames Wright 
9024054ae39SJames Wright       PetscCall(DMPlexGetSupport(dm, face, &cells));
9034054ae39SJames Wright       PetscCall(DMPlexGetSupportSize(dm, face, &num_cells_support));
9044054ae39SJames Wright       PetscCheck(num_cells_support == 1, PETSC_COMM_SELF, PETSC_ERR_ARG_INCOMP, "Expected one cell in support of exterior face, but got %" PetscInt_FMT " cells", num_cells_support);
9054054ae39SJames Wright       PetscCall(DMPlexGetCone(dm, cells[0], &cell_faces));
9064054ae39SJames Wright       PetscCall(DMPlexGetConeSize(dm, cells[0], &num_faces));
9074054ae39SJames Wright       for (PetscInt i = 0; i < num_faces; i++) {
9084054ae39SJames Wright         if (cell_faces[i] == face) start = i;
9094054ae39SJames Wright       }
9104054ae39SJames Wright       PetscCheck(start >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_CORRUPT, "Could not find face %" PetscInt_FMT " in cone of its support", face);
9114054ae39SJames Wright       PetscCall(DMPlexGetConeOrientation(dm, cells[0], &orients));
9124054ae39SJames Wright       if (orients[start] < 0) flip = -1;
9134054ae39SJames Wright     }
9144054ae39SJames Wright 
9156ff49feeSJames Wright     // Cannot use DMPlexComputeCellGeometryFVM() for high-order geometry, so must calculate normal vectors manually
9166ff49feeSJames Wright     // Use the vertices (depth 0) of coordinate DM to calculate normal vector
9176ff49feeSJames Wright     PetscCall(DMPlexVecGetClosureAtDepth_Internal(cdm, csection, coordinates, face, 0, &coords_size, &coords));
9184054ae39SJames Wright     switch (dim) {
9194054ae39SJames Wright     case 2: {
9206ff49feeSJames Wright       PetscScalar vec[2];
9216ff49feeSJames Wright 
9226ff49feeSJames Wright       for (PetscInt d = 0; d < dim; ++d) vec[d] = flip * (PetscRealPart(coords[1 * dim + d]) - PetscRealPart(coords[0 * dim + d]));
9236ff49feeSJames Wright       PetscScalar normal[] = {vec[1], -vec[0]};
9246ff49feeSJames Wright       if (PetscAbsScalar(normal[0]) > PetscAbsScalar(normal[1])) {
9256ff49feeSJames Wright         label_value = PetscRealPart(normal[0]) > 0 ? faceMarkerRight : faceMarkerLeft;
9264054ae39SJames Wright       } else {
9276ff49feeSJames Wright         label_value = PetscRealPart(normal[1]) > 0 ? faceMarkerTop : faceMarkerBottom;
9284054ae39SJames Wright       }
9294054ae39SJames Wright     } break;
9304054ae39SJames Wright     case 3: {
9316ff49feeSJames Wright       PetscScalar vec1[3], vec2[3], normal[3];
9326ff49feeSJames Wright 
9336ff49feeSJames Wright       for (PetscInt d = 0; d < dim; ++d) {
9346ff49feeSJames Wright         vec1[d] = PetscRealPart(coords[1 * dim + d]) - PetscRealPart(coords[0 * dim + d]);
9356ff49feeSJames Wright         vec2[d] = PetscRealPart(coords[2 * dim + d]) - PetscRealPart(coords[1 * dim + d]);
9366ff49feeSJames Wright       }
9376ff49feeSJames Wright 
9386ff49feeSJames Wright       // Calculate normal vector via cross-product
9396ff49feeSJames Wright       normal[0] = flip * ((vec1[1] * vec2[2]) - (vec1[2] * vec2[1]));
9406ff49feeSJames Wright       normal[1] = flip * ((vec1[2] * vec2[0]) - (vec1[0] * vec2[2]));
9416ff49feeSJames Wright       normal[2] = flip * ((vec1[0] * vec2[1]) - (vec1[1] * vec2[0]));
9426ff49feeSJames Wright 
9436ff49feeSJames Wright       if (PetscAbsScalar(normal[0]) > PetscAbsScalar(normal[1])) {
9446ff49feeSJames Wright         if (PetscAbsScalar(normal[0]) > PetscAbsScalar(normal[2])) {
9456ff49feeSJames Wright           label_value = PetscRealPart(normal[0]) > 0 ? faceMarkerRight : faceMarkerLeft;
9464054ae39SJames Wright         } else {
9476ff49feeSJames Wright           label_value = PetscRealPart(normal[2]) > 0 ? faceMarkerTop : faceMarkerBottom;
9484054ae39SJames Wright         }
9494054ae39SJames Wright       } else {
9506ff49feeSJames Wright         if (PetscAbsScalar(normal[1]) > PetscAbsScalar(normal[2])) {
9516ff49feeSJames Wright           label_value = PetscRealPart(normal[1]) > 0 ? faceMarkerBack : faceMarkerFront;
9524054ae39SJames Wright         } else {
9536ff49feeSJames Wright           label_value = PetscRealPart(normal[2]) > 0 ? faceMarkerTop : faceMarkerBottom;
9544054ae39SJames Wright         }
9554054ae39SJames Wright       }
9564054ae39SJames Wright     } break;
9574054ae39SJames Wright     }
9584054ae39SJames Wright 
9594054ae39SJames Wright     PetscInt previous_label_value; // always 1 due to DMPlexMarkBoundaryFaces call above
9604054ae39SJames Wright     PetscCall(DMGetLabelValue(dm, "Face Sets", face, &previous_label_value));
9614054ae39SJames Wright     PetscCall(DMClearLabelValue(dm, "Face Sets", face, previous_label_value));
9624054ae39SJames Wright     PetscCall(DMSetLabelValue(dm, "Face Sets", face, label_value));
9636ff49feeSJames Wright     PetscCall(DMPlexVecRestoreClosure(cdm, csection, coordinates, face, &coords_size, &coords));
9644054ae39SJames Wright   }
9656ff49feeSJames Wright   PetscCall(ISRestoreIndices(faces_is, &faces));
9666ff49feeSJames Wright   PetscCall(ISDestroy(&faces_is));
9674054ae39SJames Wright   PetscFunctionReturn(PETSC_SUCCESS);
9684054ae39SJames Wright }
9694054ae39SJames Wright 
970d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxMesh_Simplex_Internal(DM dm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[], PetscBool interpolate)
971d71ae5a4SJacob Faibussowitsch {
9729318fe57SMatthew G. Knepley   DM      boundary, vol;
973c22d3578SMatthew G. Knepley   DMLabel bdlabel;
974d6218766SMatthew G. Knepley 
975d6218766SMatthew G. Knepley   PetscFunctionBegin;
9764f572ea9SToby Isaac   PetscAssertPointer(dm, 1);
977c22d3578SMatthew 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");
9789566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &boundary));
9799566063dSJacob Faibussowitsch   PetscCall(DMSetType(boundary, DMPLEX));
9809566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBoxSurfaceMesh_Internal(boundary, dim, faces, lower, upper, PETSC_FALSE));
9819566063dSJacob Faibussowitsch   PetscCall(DMPlexGenerate(boundary, NULL, interpolate, &vol));
982c22d3578SMatthew G. Knepley   PetscCall(DMGetLabel(vol, "marker", &bdlabel));
983c22d3578SMatthew G. Knepley   if (bdlabel) PetscCall(DMPlexLabelComplete(vol, bdlabel));
9845de52c6dSVaclav Hapla   PetscCall(DMPlexCopy_Internal(dm, PETSC_TRUE, PETSC_FALSE, vol));
98569d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
9864054ae39SJames Wright   if (interpolate) {
9874054ae39SJames Wright     PetscCall(DMPlexInterpolateInPlace_Internal(dm));
9884054ae39SJames Wright     PetscCall(DMPlexSetBoxLabel_Internal(dm));
9894054ae39SJames Wright   }
9909566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&boundary));
9913ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
992d6218766SMatthew G. Knepley }
993d6218766SMatthew G. Knepley 
994d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateCubeMesh_Internal(DM dm, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[], DMBoundaryType bdX, DMBoundaryType bdY, DMBoundaryType bdZ)
995d71ae5a4SJacob Faibussowitsch {
996ed0e4b50SMatthew G. Knepley   DMLabel     cutLabel  = NULL;
997f4eb4c5dSMatthew G. Knepley   PetscInt    markerTop = 1, faceMarkerTop = 1;
998f4eb4c5dSMatthew G. Knepley   PetscInt    markerBottom = 1, faceMarkerBottom = 1;
999f4eb4c5dSMatthew G. Knepley   PetscInt    markerFront = 1, faceMarkerFront = 1;
1000f4eb4c5dSMatthew G. Knepley   PetscInt    markerBack = 1, faceMarkerBack = 1;
1001f4eb4c5dSMatthew G. Knepley   PetscInt    markerRight = 1, faceMarkerRight = 1;
1002f4eb4c5dSMatthew G. Knepley   PetscInt    markerLeft = 1, faceMarkerLeft = 1;
10033dfda0b1SToby Isaac   PetscInt    dim;
1004d8211ee3SMatthew G. Knepley   PetscBool   markerSeparate = PETSC_FALSE, cutMarker = PETSC_FALSE;
10053dfda0b1SToby Isaac   PetscMPIInt rank;
10063dfda0b1SToby Isaac 
10073dfda0b1SToby Isaac   PetscFunctionBegin;
10089566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
10099566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
10109566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "marker"));
10119566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "Face Sets"));
10129566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_periodic_cut", &cutMarker, NULL));
10139371c9d4SSatish 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) {
10149371c9d4SSatish Balay     if (cutMarker) {
10159371c9d4SSatish Balay       PetscCall(DMCreateLabel(dm, "periodic_cut"));
10169371c9d4SSatish Balay       PetscCall(DMGetLabel(dm, "periodic_cut", &cutLabel));
10179371c9d4SSatish Balay     }
1018d8211ee3SMatthew G. Knepley   }
10193dfda0b1SToby Isaac   switch (dim) {
10203dfda0b1SToby Isaac   case 2:
1021f4eb4c5dSMatthew G. Knepley     faceMarkerTop    = 3;
1022f4eb4c5dSMatthew G. Knepley     faceMarkerBottom = 1;
1023f4eb4c5dSMatthew G. Knepley     faceMarkerRight  = 2;
1024f4eb4c5dSMatthew G. Knepley     faceMarkerLeft   = 4;
10253dfda0b1SToby Isaac     break;
10263dfda0b1SToby Isaac   case 3:
1027f4eb4c5dSMatthew G. Knepley     faceMarkerBottom = 1;
1028f4eb4c5dSMatthew G. Knepley     faceMarkerTop    = 2;
1029f4eb4c5dSMatthew G. Knepley     faceMarkerFront  = 3;
1030f4eb4c5dSMatthew G. Knepley     faceMarkerBack   = 4;
1031f4eb4c5dSMatthew G. Knepley     faceMarkerRight  = 5;
1032f4eb4c5dSMatthew G. Knepley     faceMarkerLeft   = 6;
10333dfda0b1SToby Isaac     break;
1034d71ae5a4SJacob Faibussowitsch   default:
1035d71ae5a4SJacob Faibussowitsch     SETERRQ(PETSC_COMM_SELF, PETSC_ERR_SUP, "Dimension %" PetscInt_FMT " not supported", dim);
10363dfda0b1SToby Isaac   }
10379566063dSJacob Faibussowitsch   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_separate_marker", &markerSeparate, NULL));
1038f4eb4c5dSMatthew G. Knepley   if (markerSeparate) {
1039f4eb4c5dSMatthew G. Knepley     markerBottom = faceMarkerBottom;
1040f4eb4c5dSMatthew G. Knepley     markerTop    = faceMarkerTop;
1041f4eb4c5dSMatthew G. Knepley     markerFront  = faceMarkerFront;
1042f4eb4c5dSMatthew G. Knepley     markerBack   = faceMarkerBack;
1043f4eb4c5dSMatthew G. Knepley     markerRight  = faceMarkerRight;
1044f4eb4c5dSMatthew G. Knepley     markerLeft   = faceMarkerLeft;
10453dfda0b1SToby Isaac   }
10463dfda0b1SToby Isaac   {
1047dd400576SPatrick Sanan     const PetscInt numXEdges    = rank == 0 ? edges[0] : 0;
1048dd400576SPatrick Sanan     const PetscInt numYEdges    = rank == 0 ? edges[1] : 0;
1049dd400576SPatrick Sanan     const PetscInt numZEdges    = rank == 0 ? edges[2] : 0;
1050dd400576SPatrick Sanan     const PetscInt numXVertices = rank == 0 ? (bdX == DM_BOUNDARY_PERIODIC || bdX == DM_BOUNDARY_TWIST ? edges[0] : edges[0] + 1) : 0;
1051dd400576SPatrick Sanan     const PetscInt numYVertices = rank == 0 ? (bdY == DM_BOUNDARY_PERIODIC || bdY == DM_BOUNDARY_TWIST ? edges[1] : edges[1] + 1) : 0;
1052dd400576SPatrick Sanan     const PetscInt numZVertices = rank == 0 ? (bdZ == DM_BOUNDARY_PERIODIC || bdZ == DM_BOUNDARY_TWIST ? edges[2] : edges[2] + 1) : 0;
10533dfda0b1SToby Isaac     const PetscInt numCells     = numXEdges * numYEdges * numZEdges;
10543dfda0b1SToby Isaac     const PetscInt numXFaces    = numYEdges * numZEdges;
10553dfda0b1SToby Isaac     const PetscInt numYFaces    = numXEdges * numZEdges;
10563dfda0b1SToby Isaac     const PetscInt numZFaces    = numXEdges * numYEdges;
10573dfda0b1SToby Isaac     const PetscInt numTotXFaces = numXVertices * numXFaces;
10583dfda0b1SToby Isaac     const PetscInt numTotYFaces = numYVertices * numYFaces;
10593dfda0b1SToby Isaac     const PetscInt numTotZFaces = numZVertices * numZFaces;
10603dfda0b1SToby Isaac     const PetscInt numFaces     = numTotXFaces + numTotYFaces + numTotZFaces;
10613dfda0b1SToby Isaac     const PetscInt numTotXEdges = numXEdges * numYVertices * numZVertices;
10623dfda0b1SToby Isaac     const PetscInt numTotYEdges = numYEdges * numXVertices * numZVertices;
10633dfda0b1SToby Isaac     const PetscInt numTotZEdges = numZEdges * numXVertices * numYVertices;
10643dfda0b1SToby Isaac     const PetscInt numVertices  = numXVertices * numYVertices * numZVertices;
10653dfda0b1SToby Isaac     const PetscInt numEdges     = numTotXEdges + numTotYEdges + numTotZEdges;
10663dfda0b1SToby Isaac     const PetscInt firstVertex  = (dim == 2) ? numFaces : numCells;
10673dfda0b1SToby Isaac     const PetscInt firstXFace   = (dim == 2) ? 0 : numCells + numVertices;
10683dfda0b1SToby Isaac     const PetscInt firstYFace   = firstXFace + numTotXFaces;
10693dfda0b1SToby Isaac     const PetscInt firstZFace   = firstYFace + numTotYFaces;
10703dfda0b1SToby Isaac     const PetscInt firstXEdge   = numCells + numFaces + numVertices;
10713dfda0b1SToby Isaac     const PetscInt firstYEdge   = firstXEdge + numTotXEdges;
10723dfda0b1SToby Isaac     const PetscInt firstZEdge   = firstYEdge + numTotYEdges;
10733dfda0b1SToby Isaac     Vec            coordinates;
10743dfda0b1SToby Isaac     PetscSection   coordSection;
10753dfda0b1SToby Isaac     PetscScalar   *coords;
10763dfda0b1SToby Isaac     PetscInt       coordSize;
10773dfda0b1SToby Isaac     PetscInt       v, vx, vy, vz;
10783dfda0b1SToby Isaac     PetscInt       c, f, fx, fy, fz, e, ex, ey, ez;
10793dfda0b1SToby Isaac 
10809566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numCells + numFaces + numEdges + numVertices));
108148a46eb9SPierre Jolivet     for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 6));
108248a46eb9SPierre Jolivet     for (f = firstXFace; f < firstXFace + numFaces; ++f) PetscCall(DMPlexSetConeSize(dm, f, 4));
108348a46eb9SPierre Jolivet     for (e = firstXEdge; e < firstXEdge + numEdges; ++e) PetscCall(DMPlexSetConeSize(dm, e, 2));
10849566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm)); /* Allocate space for cones */
10853dfda0b1SToby Isaac     /* Build cells */
10863dfda0b1SToby Isaac     for (fz = 0; fz < numZEdges; ++fz) {
10873dfda0b1SToby Isaac       for (fy = 0; fy < numYEdges; ++fy) {
10883dfda0b1SToby Isaac         for (fx = 0; fx < numXEdges; ++fx) {
10893dfda0b1SToby Isaac           PetscInt cell  = (fz * numYEdges + fy) * numXEdges + fx;
10903dfda0b1SToby Isaac           PetscInt faceB = firstZFace + (fy * numXEdges + fx) * numZVertices + fz;
10913dfda0b1SToby Isaac           PetscInt faceT = firstZFace + (fy * numXEdges + fx) * numZVertices + ((fz + 1) % numZVertices);
10923dfda0b1SToby Isaac           PetscInt faceF = firstYFace + (fz * numXEdges + fx) * numYVertices + fy;
10933dfda0b1SToby Isaac           PetscInt faceK = firstYFace + (fz * numXEdges + fx) * numYVertices + ((fy + 1) % numYVertices);
10943dfda0b1SToby Isaac           PetscInt faceL = firstXFace + (fz * numYEdges + fy) * numXVertices + fx;
10953dfda0b1SToby Isaac           PetscInt faceR = firstXFace + (fz * numYEdges + fy) * numXVertices + ((fx + 1) % numXVertices);
10963dfda0b1SToby Isaac           /* B,  T,  F,  K,  R,  L */
1097b5a892a1SMatthew G. Knepley           PetscInt ornt[6] = {-2, 0, 0, -3, 0, -2}; /* ??? */
109842206facSLisandro Dalcin           PetscInt cone[6];
10993dfda0b1SToby Isaac 
11003dfda0b1SToby Isaac           /* no boundary twisting in 3D */
11019371c9d4SSatish Balay           cone[0] = faceB;
11029371c9d4SSatish Balay           cone[1] = faceT;
11039371c9d4SSatish Balay           cone[2] = faceF;
11049371c9d4SSatish Balay           cone[3] = faceK;
11059371c9d4SSatish Balay           cone[4] = faceR;
11069371c9d4SSatish Balay           cone[5] = faceL;
11079566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, cell, cone));
11089566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, cell, ornt));
11099566063dSJacob Faibussowitsch           if (bdX != DM_BOUNDARY_NONE && fx == numXEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, cell, 2));
11109566063dSJacob Faibussowitsch           if (bdY != DM_BOUNDARY_NONE && fy == numYEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, cell, 2));
11119566063dSJacob Faibussowitsch           if (bdZ != DM_BOUNDARY_NONE && fz == numZEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, cell, 2));
11123dfda0b1SToby Isaac         }
11133dfda0b1SToby Isaac       }
11143dfda0b1SToby Isaac     }
11153dfda0b1SToby Isaac     /* Build x faces */
11163dfda0b1SToby Isaac     for (fz = 0; fz < numZEdges; ++fz) {
11173dfda0b1SToby Isaac       for (fy = 0; fy < numYEdges; ++fy) {
11183dfda0b1SToby Isaac         for (fx = 0; fx < numXVertices; ++fx) {
11193dfda0b1SToby Isaac           PetscInt face    = firstXFace + (fz * numYEdges + fy) * numXVertices + fx;
11203dfda0b1SToby Isaac           PetscInt edgeL   = firstZEdge + (fy * numXVertices + fx) * numZEdges + fz;
11213dfda0b1SToby Isaac           PetscInt edgeR   = firstZEdge + (((fy + 1) % numYVertices) * numXVertices + fx) * numZEdges + fz;
11223dfda0b1SToby Isaac           PetscInt edgeB   = firstYEdge + (fz * numXVertices + fx) * numYEdges + fy;
11233dfda0b1SToby Isaac           PetscInt edgeT   = firstYEdge + (((fz + 1) % numZVertices) * numXVertices + fx) * numYEdges + fy;
1124b5a892a1SMatthew G. Knepley           PetscInt ornt[4] = {0, 0, -1, -1};
11253dfda0b1SToby Isaac           PetscInt cone[4];
11263dfda0b1SToby Isaac 
11273dfda0b1SToby Isaac           if (dim == 3) {
11283dfda0b1SToby Isaac             /* markers */
11293dfda0b1SToby Isaac             if (bdX != DM_BOUNDARY_PERIODIC) {
11303dfda0b1SToby Isaac               if (fx == numXVertices - 1) {
11319566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerRight));
11329566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerRight));
11339371c9d4SSatish Balay               } else if (fx == 0) {
11349566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerLeft));
11359566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerLeft));
11363dfda0b1SToby Isaac               }
11373dfda0b1SToby Isaac             }
11383dfda0b1SToby Isaac           }
11399371c9d4SSatish Balay           cone[0] = edgeB;
11409371c9d4SSatish Balay           cone[1] = edgeR;
11419371c9d4SSatish Balay           cone[2] = edgeT;
11429371c9d4SSatish Balay           cone[3] = edgeL;
11439566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, face, cone));
11449566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, face, ornt));
11453dfda0b1SToby Isaac         }
11463dfda0b1SToby Isaac       }
11473dfda0b1SToby Isaac     }
11483dfda0b1SToby Isaac     /* Build y faces */
11493dfda0b1SToby Isaac     for (fz = 0; fz < numZEdges; ++fz) {
115042206facSLisandro Dalcin       for (fx = 0; fx < numXEdges; ++fx) {
11513dfda0b1SToby Isaac         for (fy = 0; fy < numYVertices; ++fy) {
11523dfda0b1SToby Isaac           PetscInt face    = firstYFace + (fz * numXEdges + fx) * numYVertices + fy;
11533dfda0b1SToby Isaac           PetscInt edgeL   = firstZEdge + (fy * numXVertices + fx) * numZEdges + fz;
11543dfda0b1SToby Isaac           PetscInt edgeR   = firstZEdge + (fy * numXVertices + ((fx + 1) % numXVertices)) * numZEdges + fz;
11553dfda0b1SToby Isaac           PetscInt edgeB   = firstXEdge + (fz * numYVertices + fy) * numXEdges + fx;
11563dfda0b1SToby Isaac           PetscInt edgeT   = firstXEdge + (((fz + 1) % numZVertices) * numYVertices + fy) * numXEdges + fx;
1157b5a892a1SMatthew G. Knepley           PetscInt ornt[4] = {0, 0, -1, -1};
11583dfda0b1SToby Isaac           PetscInt cone[4];
11593dfda0b1SToby Isaac 
11603dfda0b1SToby Isaac           if (dim == 3) {
11613dfda0b1SToby Isaac             /* markers */
11623dfda0b1SToby Isaac             if (bdY != DM_BOUNDARY_PERIODIC) {
11633dfda0b1SToby Isaac               if (fy == numYVertices - 1) {
11649566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerBack));
11659566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerBack));
11669371c9d4SSatish Balay               } else if (fy == 0) {
11679566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerFront));
11689566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerFront));
11693dfda0b1SToby Isaac               }
11703dfda0b1SToby Isaac             }
11713dfda0b1SToby Isaac           }
11729371c9d4SSatish Balay           cone[0] = edgeB;
11739371c9d4SSatish Balay           cone[1] = edgeR;
11749371c9d4SSatish Balay           cone[2] = edgeT;
11759371c9d4SSatish Balay           cone[3] = edgeL;
11769566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, face, cone));
11779566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, face, ornt));
11783dfda0b1SToby Isaac         }
11793dfda0b1SToby Isaac       }
11803dfda0b1SToby Isaac     }
11813dfda0b1SToby Isaac     /* Build z faces */
11823dfda0b1SToby Isaac     for (fy = 0; fy < numYEdges; ++fy) {
11833dfda0b1SToby Isaac       for (fx = 0; fx < numXEdges; ++fx) {
11843dfda0b1SToby Isaac         for (fz = 0; fz < numZVertices; fz++) {
11853dfda0b1SToby Isaac           PetscInt face    = firstZFace + (fy * numXEdges + fx) * numZVertices + fz;
11863dfda0b1SToby Isaac           PetscInt edgeL   = firstYEdge + (fz * numXVertices + fx) * numYEdges + fy;
11873dfda0b1SToby Isaac           PetscInt edgeR   = firstYEdge + (fz * numXVertices + ((fx + 1) % numXVertices)) * numYEdges + fy;
11883dfda0b1SToby Isaac           PetscInt edgeB   = firstXEdge + (fz * numYVertices + fy) * numXEdges + fx;
11893dfda0b1SToby Isaac           PetscInt edgeT   = firstXEdge + (fz * numYVertices + ((fy + 1) % numYVertices)) * numXEdges + fx;
1190b5a892a1SMatthew G. Knepley           PetscInt ornt[4] = {0, 0, -1, -1};
11913dfda0b1SToby Isaac           PetscInt cone[4];
11923dfda0b1SToby Isaac 
11933dfda0b1SToby Isaac           if (dim == 2) {
11949371c9d4SSatish Balay             if (bdX == DM_BOUNDARY_TWIST && fx == numXEdges - 1) {
11959371c9d4SSatish Balay               edgeR += numYEdges - 1 - 2 * fy;
11969371c9d4SSatish Balay               ornt[1] = -1;
11979371c9d4SSatish Balay             }
11989371c9d4SSatish Balay             if (bdY == DM_BOUNDARY_TWIST && fy == numYEdges - 1) {
11999371c9d4SSatish Balay               edgeT += numXEdges - 1 - 2 * fx;
12009371c9d4SSatish Balay               ornt[2] = 0;
12019371c9d4SSatish Balay             }
12029566063dSJacob Faibussowitsch             if (bdX != DM_BOUNDARY_NONE && fx == numXEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, face, 2));
12039566063dSJacob Faibussowitsch             if (bdY != DM_BOUNDARY_NONE && fy == numYEdges - 1 && cutLabel) PetscCall(DMLabelSetValue(cutLabel, face, 2));
1204d1c88043SMatthew G. Knepley           } else {
12053dfda0b1SToby Isaac             /* markers */
12063dfda0b1SToby Isaac             if (bdZ != DM_BOUNDARY_PERIODIC) {
12073dfda0b1SToby Isaac               if (fz == numZVertices - 1) {
12089566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerTop));
12099566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerTop));
12109371c9d4SSatish Balay               } else if (fz == 0) {
12119566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", face, faceMarkerBottom));
12129566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", face, markerBottom));
12133dfda0b1SToby Isaac               }
12143dfda0b1SToby Isaac             }
12153dfda0b1SToby Isaac           }
12169371c9d4SSatish Balay           cone[0] = edgeB;
12179371c9d4SSatish Balay           cone[1] = edgeR;
12189371c9d4SSatish Balay           cone[2] = edgeT;
12199371c9d4SSatish Balay           cone[3] = edgeL;
12209566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, face, cone));
12219566063dSJacob Faibussowitsch           PetscCall(DMPlexSetConeOrientation(dm, face, ornt));
12223dfda0b1SToby Isaac         }
12233dfda0b1SToby Isaac       }
12243dfda0b1SToby Isaac     }
12253dfda0b1SToby Isaac     /* Build Z edges*/
12263dfda0b1SToby Isaac     for (vy = 0; vy < numYVertices; vy++) {
12273dfda0b1SToby Isaac       for (vx = 0; vx < numXVertices; vx++) {
12283dfda0b1SToby Isaac         for (ez = 0; ez < numZEdges; ez++) {
12293dfda0b1SToby Isaac           const PetscInt edge    = firstZEdge + (vy * numXVertices + vx) * numZEdges + ez;
12303dfda0b1SToby Isaac           const PetscInt vertexB = firstVertex + (ez * numYVertices + vy) * numXVertices + vx;
12313dfda0b1SToby Isaac           const PetscInt vertexT = firstVertex + (((ez + 1) % numZVertices) * numYVertices + vy) * numXVertices + vx;
12323dfda0b1SToby Isaac           PetscInt       cone[2];
12333dfda0b1SToby Isaac 
12349371c9d4SSatish Balay           cone[0] = vertexB;
12359371c9d4SSatish Balay           cone[1] = vertexT;
1236c2df9bbfSMatthew G. Knepley           PetscCall(DMPlexSetCone(dm, edge, cone));
12373dfda0b1SToby Isaac           if (dim == 3) {
12383dfda0b1SToby Isaac             if (bdX != DM_BOUNDARY_PERIODIC) {
12393dfda0b1SToby Isaac               if (vx == numXVertices - 1) {
12409566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
1241c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
1242c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
1243c2df9bbfSMatthew G. Knepley               } else if (vx == 0) {
12449566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
1245c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
1246c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
12473dfda0b1SToby Isaac               }
12483dfda0b1SToby Isaac             }
12493dfda0b1SToby Isaac             if (bdY != DM_BOUNDARY_PERIODIC) {
12503dfda0b1SToby Isaac               if (vy == numYVertices - 1) {
12519566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBack));
1252c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBack));
1253c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBack));
1254c2df9bbfSMatthew G. Knepley               } else if (vy == 0) {
12559566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerFront));
1256c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerFront));
1257c2df9bbfSMatthew G. Knepley                 if (ez == numZEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerFront));
12583dfda0b1SToby Isaac               }
12593dfda0b1SToby Isaac             }
12603dfda0b1SToby Isaac           }
12613dfda0b1SToby Isaac         }
12623dfda0b1SToby Isaac       }
12633dfda0b1SToby Isaac     }
12643dfda0b1SToby Isaac     /* Build Y edges*/
12653dfda0b1SToby Isaac     for (vz = 0; vz < numZVertices; vz++) {
12663dfda0b1SToby Isaac       for (vx = 0; vx < numXVertices; vx++) {
12673dfda0b1SToby Isaac         for (ey = 0; ey < numYEdges; ey++) {
12683dfda0b1SToby Isaac           const PetscInt nextv   = (dim == 2 && bdY == DM_BOUNDARY_TWIST && ey == numYEdges - 1) ? (numXVertices - vx - 1) : (vz * numYVertices + ((ey + 1) % numYVertices)) * numXVertices + vx;
12693dfda0b1SToby Isaac           const PetscInt edge    = firstYEdge + (vz * numXVertices + vx) * numYEdges + ey;
12703dfda0b1SToby Isaac           const PetscInt vertexF = firstVertex + (vz * numYVertices + ey) * numXVertices + vx;
12713dfda0b1SToby Isaac           const PetscInt vertexK = firstVertex + nextv;
12723dfda0b1SToby Isaac           PetscInt       cone[2];
12733dfda0b1SToby Isaac 
12749371c9d4SSatish Balay           cone[0] = vertexF;
12759371c9d4SSatish Balay           cone[1] = vertexK;
12769566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, edge, cone));
12773dfda0b1SToby Isaac           if (dim == 2) {
12783dfda0b1SToby Isaac             if ((bdX != DM_BOUNDARY_PERIODIC) && (bdX != DM_BOUNDARY_TWIST)) {
12793dfda0b1SToby Isaac               if (vx == numXVertices - 1) {
12809566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerRight));
12819566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
12829566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
1283c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
1284d8211ee3SMatthew G. Knepley               } else if (vx == 0) {
12859566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerLeft));
12869566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
12879566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
1288c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
12893dfda0b1SToby Isaac               }
1290d8211ee3SMatthew G. Knepley             } else {
12914c67ea77SStefano Zampini               if (vx == 0 && cutLabel) {
12929566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, edge, 1));
12939566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, cone[0], 1));
1294c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMLabelSetValue(cutLabel, cone[1], 1));
12953dfda0b1SToby Isaac               }
1296d8211ee3SMatthew G. Knepley             }
1297d8211ee3SMatthew G. Knepley           } else {
12983dfda0b1SToby Isaac             if (bdX != DM_BOUNDARY_PERIODIC) {
12993dfda0b1SToby Isaac               if (vx == numXVertices - 1) {
13009566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerRight));
1301c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerRight));
1302c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerRight));
1303d8211ee3SMatthew G. Knepley               } else if (vx == 0) {
13049566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerLeft));
1305c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerLeft));
1306c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerLeft));
13073dfda0b1SToby Isaac               }
13083dfda0b1SToby Isaac             }
13093dfda0b1SToby Isaac             if (bdZ != DM_BOUNDARY_PERIODIC) {
13103dfda0b1SToby Isaac               if (vz == numZVertices - 1) {
13119566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
1312c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
1313c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
1314d8211ee3SMatthew G. Knepley               } else if (vz == 0) {
13159566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
1316c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
1317c2df9bbfSMatthew G. Knepley                 if (ey == numYEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
13183dfda0b1SToby Isaac               }
13193dfda0b1SToby Isaac             }
13203dfda0b1SToby Isaac           }
13213dfda0b1SToby Isaac         }
13223dfda0b1SToby Isaac       }
13233dfda0b1SToby Isaac     }
13243dfda0b1SToby Isaac     /* Build X edges*/
13253dfda0b1SToby Isaac     for (vz = 0; vz < numZVertices; vz++) {
13263dfda0b1SToby Isaac       for (vy = 0; vy < numYVertices; vy++) {
13273dfda0b1SToby Isaac         for (ex = 0; ex < numXEdges; ex++) {
13283dfda0b1SToby Isaac           const PetscInt nextv   = (dim == 2 && bdX == DM_BOUNDARY_TWIST && ex == numXEdges - 1) ? (numYVertices - vy - 1) * numXVertices : (vz * numYVertices + vy) * numXVertices + (ex + 1) % numXVertices;
13293dfda0b1SToby Isaac           const PetscInt edge    = firstXEdge + (vz * numYVertices + vy) * numXEdges + ex;
13303dfda0b1SToby Isaac           const PetscInt vertexL = firstVertex + (vz * numYVertices + vy) * numXVertices + ex;
13313dfda0b1SToby Isaac           const PetscInt vertexR = firstVertex + nextv;
13323dfda0b1SToby Isaac           PetscInt       cone[2];
13333dfda0b1SToby Isaac 
13349371c9d4SSatish Balay           cone[0] = vertexL;
13359371c9d4SSatish Balay           cone[1] = vertexR;
13369566063dSJacob Faibussowitsch           PetscCall(DMPlexSetCone(dm, edge, cone));
13373dfda0b1SToby Isaac           if (dim == 2) {
13383dfda0b1SToby Isaac             if ((bdY != DM_BOUNDARY_PERIODIC) && (bdY != DM_BOUNDARY_TWIST)) {
13393dfda0b1SToby Isaac               if (vy == numYVertices - 1) {
13409566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerTop));
13419566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
13429566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
1343c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
1344d8211ee3SMatthew G. Knepley               } else if (vy == 0) {
13459566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "Face Sets", edge, faceMarkerBottom));
13469566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
13479566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
1348c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
13493dfda0b1SToby Isaac               }
1350d8211ee3SMatthew G. Knepley             } else {
13514c67ea77SStefano Zampini               if (vy == 0 && cutLabel) {
13529566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, edge, 1));
13539566063dSJacob Faibussowitsch                 PetscCall(DMLabelSetValue(cutLabel, cone[0], 1));
1354c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMLabelSetValue(cutLabel, cone[1], 1));
13553dfda0b1SToby Isaac               }
1356d8211ee3SMatthew G. Knepley             }
1357d8211ee3SMatthew G. Knepley           } else {
13583dfda0b1SToby Isaac             if (bdY != DM_BOUNDARY_PERIODIC) {
13593dfda0b1SToby Isaac               if (vy == numYVertices - 1) {
13609566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBack));
1361c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBack));
1362c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBack));
1363c2df9bbfSMatthew G. Knepley               } else if (vy == 0) {
13649566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerFront));
1365c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerFront));
1366c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerFront));
13673dfda0b1SToby Isaac               }
13683dfda0b1SToby Isaac             }
13693dfda0b1SToby Isaac             if (bdZ != DM_BOUNDARY_PERIODIC) {
13703dfda0b1SToby Isaac               if (vz == numZVertices - 1) {
13719566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerTop));
1372c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerTop));
1373c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerTop));
1374c2df9bbfSMatthew G. Knepley               } else if (vz == 0) {
13759566063dSJacob Faibussowitsch                 PetscCall(DMSetLabelValue(dm, "marker", edge, markerBottom));
1376c2df9bbfSMatthew G. Knepley                 PetscCall(DMSetLabelValue(dm, "marker", cone[0], markerBottom));
1377c2df9bbfSMatthew G. Knepley                 if (ex == numXEdges - 1) PetscCall(DMSetLabelValue(dm, "marker", cone[1], markerBottom));
13783dfda0b1SToby Isaac               }
13793dfda0b1SToby Isaac             }
13803dfda0b1SToby Isaac           }
13813dfda0b1SToby Isaac         }
13823dfda0b1SToby Isaac       }
13833dfda0b1SToby Isaac     }
13849566063dSJacob Faibussowitsch     PetscCall(DMPlexSymmetrize(dm));
13859566063dSJacob Faibussowitsch     PetscCall(DMPlexStratify(dm));
13863dfda0b1SToby Isaac     /* Build coordinates */
13879566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &coordSection));
13889566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetNumFields(coordSection, 1));
13899566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
13909566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numVertices));
13913dfda0b1SToby Isaac     for (v = firstVertex; v < firstVertex + numVertices; ++v) {
13929566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetDof(coordSection, v, dim));
13939566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
13943dfda0b1SToby Isaac     }
13959566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetUp(coordSection));
13969566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
13979566063dSJacob Faibussowitsch     PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
13989566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
13999566063dSJacob Faibussowitsch     PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
14009566063dSJacob Faibussowitsch     PetscCall(VecSetBlockSize(coordinates, dim));
14019566063dSJacob Faibussowitsch     PetscCall(VecSetType(coordinates, VECSTANDARD));
14029566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
14033dfda0b1SToby Isaac     for (vz = 0; vz < numZVertices; ++vz) {
14043dfda0b1SToby Isaac       for (vy = 0; vy < numYVertices; ++vy) {
14053dfda0b1SToby Isaac         for (vx = 0; vx < numXVertices; ++vx) {
14063dfda0b1SToby Isaac           coords[((vz * numYVertices + vy) * numXVertices + vx) * dim + 0] = lower[0] + ((upper[0] - lower[0]) / numXEdges) * vx;
14073dfda0b1SToby Isaac           coords[((vz * numYVertices + vy) * numXVertices + vx) * dim + 1] = lower[1] + ((upper[1] - lower[1]) / numYEdges) * vy;
1408ad540459SPierre Jolivet           if (dim == 3) coords[((vz * numYVertices + vy) * numXVertices + vx) * dim + 2] = lower[2] + ((upper[2] - lower[2]) / numZEdges) * vz;
14093dfda0b1SToby Isaac         }
14103dfda0b1SToby Isaac       }
14113dfda0b1SToby Isaac     }
14129566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(coordinates, &coords));
14139566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, coordinates));
14149566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&coordinates));
14153dfda0b1SToby Isaac   }
14163ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
14173dfda0b1SToby Isaac }
14183dfda0b1SToby Isaac 
1419d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoxMesh_Tensor_Internal(DM dm, PetscInt dim, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[])
1420d71ae5a4SJacob Faibussowitsch {
14219318fe57SMatthew G. Knepley   DMBoundaryType bdt[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
14229318fe57SMatthew G. Knepley   PetscInt       fac[3] = {0, 0, 0}, d;
1423552f7358SJed Brown 
1424552f7358SJed Brown   PetscFunctionBegin;
14254f572ea9SToby Isaac   PetscAssertPointer(dm, 1);
14269318fe57SMatthew G. Knepley   PetscValidLogicalCollectiveInt(dm, dim, 2);
14279566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
14289371c9d4SSatish Balay   for (d = 0; d < dim; ++d) {
14299371c9d4SSatish Balay     fac[d] = faces[d];
14309371c9d4SSatish Balay     bdt[d] = periodicity[d];
14319371c9d4SSatish Balay   }
14329566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateCubeMesh_Internal(dm, lower, upper, fac, bdt[0], bdt[1], bdt[2]));
14339371c9d4SSatish 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))) {
14346858538eSMatthew G. Knepley     PetscReal L[3]       = {-1., -1., 0.};
14356858538eSMatthew G. Knepley     PetscReal maxCell[3] = {-1., -1., 0.};
1436552f7358SJed Brown 
14379318fe57SMatthew G. Knepley     for (d = 0; d < dim; ++d) {
14386858538eSMatthew G. Knepley       if (periodicity[d] != DM_BOUNDARY_NONE) {
14399318fe57SMatthew G. Knepley         L[d]       = upper[d] - lower[d];
14409318fe57SMatthew G. Knepley         maxCell[d] = 1.1 * (L[d] / PetscMax(1, faces[d]));
1441768d5fceSMatthew G. Knepley       }
14426858538eSMatthew G. Knepley     }
14434fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dm, maxCell, lower, L));
1444768d5fceSMatthew G. Knepley   }
14459566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
14463ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
14479318fe57SMatthew G. Knepley }
14489318fe57SMatthew G. Knepley 
14495dca41c3SJed 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)
1450d71ae5a4SJacob Faibussowitsch {
14519318fe57SMatthew G. Knepley   PetscFunctionBegin;
145246139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
14535dca41c3SJed Brown   if (shape == DM_SHAPE_ZBOX) PetscCall(DMPlexCreateBoxMesh_Tensor_SFC_Internal(dm, dim, faces, lower, upper, periodicity, interpolate));
14546725e60dSJed Brown   else if (dim == 1) PetscCall(DMPlexCreateLineMesh_Internal(dm, faces[0], lower[0], upper[0], periodicity[0]));
14559566063dSJacob Faibussowitsch   else if (simplex) PetscCall(DMPlexCreateBoxMesh_Simplex_Internal(dm, dim, faces, lower, upper, periodicity, interpolate));
14569566063dSJacob Faibussowitsch   else PetscCall(DMPlexCreateBoxMesh_Tensor_Internal(dm, dim, faces, lower, upper, periodicity));
14579318fe57SMatthew G. Knepley   if (!interpolate && dim > 1 && !simplex) {
1458768d5fceSMatthew G. Knepley     DM udm;
1459768d5fceSMatthew G. Knepley 
14609566063dSJacob Faibussowitsch     PetscCall(DMPlexUninterpolate(dm, &udm));
14619566063dSJacob Faibussowitsch     PetscCall(DMPlexCopyCoordinates(dm, udm));
146269d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &udm));
1463768d5fceSMatthew G. Knepley   }
146446139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
14653ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1466c8c68bd8SToby Isaac }
1467c8c68bd8SToby Isaac 
14685d83a8b1SBarry Smith /*@
1469768d5fceSMatthew G. Knepley   DMPlexCreateBoxMesh - Creates a mesh on the tensor product of unit intervals (box) using simplices or tensor cells (hexahedra).
1470768d5fceSMatthew G. Knepley 
1471d083f849SBarry Smith   Collective
1472768d5fceSMatthew G. Knepley 
1473768d5fceSMatthew G. Knepley   Input Parameters:
1474a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
1475768d5fceSMatthew G. Knepley . dim         - The spatial dimension
1476a1cb98faSBarry Smith . simplex     - `PETSC_TRUE` for simplices, `PETSC_FALSE` for tensor cells
147720f4b53cSBarry Smith . faces       - Number of faces per dimension, or `NULL` for (1,) in 1D and (2, 2) in 2D and (1, 1, 1) in 3D
147820f4b53cSBarry Smith . lower       - The lower left corner, or `NULL` for (0, 0, 0)
147920f4b53cSBarry Smith . upper       - The upper right corner, or `NULL` for (1, 1, 1)
148020f4b53cSBarry Smith . periodicity - The boundary type for the X,Y,Z direction, or `NULL` for `DM_BOUNDARY_NONE`
1481768d5fceSMatthew G. Knepley - interpolate - Flag to create intermediate mesh pieces (edges, faces)
1482768d5fceSMatthew G. Knepley 
1483768d5fceSMatthew G. Knepley   Output Parameter:
1484a1cb98faSBarry Smith . dm - The `DM` object
1485768d5fceSMatthew G. Knepley 
1486768d5fceSMatthew G. Knepley   Level: beginner
1487768d5fceSMatthew G. Knepley 
1488a1cb98faSBarry Smith   Note:
1489a1cb98faSBarry Smith   To customize this mesh using options, use
1490a1cb98faSBarry Smith .vb
1491a1cb98faSBarry Smith   DMCreate(comm, &dm);
1492a1cb98faSBarry Smith   DMSetType(dm, DMPLEX);
1493a1cb98faSBarry Smith   DMSetFromOptions(dm);
1494a1cb98faSBarry Smith .ve
1495a1cb98faSBarry Smith   and use the options in `DMSetFromOptions()`.
1496a1cb98faSBarry Smith 
1497a4e35b19SJacob Faibussowitsch   Here is the numbering returned for 2 faces in each direction for tensor cells\:
1498a1cb98faSBarry Smith .vb
1499a1cb98faSBarry Smith  10---17---11---18----12
1500a1cb98faSBarry Smith   |         |         |
1501a1cb98faSBarry Smith   |         |         |
1502a1cb98faSBarry Smith  20    2   22    3    24
1503a1cb98faSBarry Smith   |         |         |
1504a1cb98faSBarry Smith   |         |         |
1505a1cb98faSBarry Smith   7---15----8---16----9
1506a1cb98faSBarry Smith   |         |         |
1507a1cb98faSBarry Smith   |         |         |
1508a1cb98faSBarry Smith  19    0   21    1   23
1509a1cb98faSBarry Smith   |         |         |
1510a1cb98faSBarry Smith   |         |         |
1511a1cb98faSBarry Smith   4---13----5---14----6
1512a1cb98faSBarry Smith .ve
1513a1cb98faSBarry Smith   and for simplicial cells
1514a1cb98faSBarry Smith .vb
1515a1cb98faSBarry Smith  14----8---15----9----16
1516a1cb98faSBarry Smith   |\     5  |\      7 |
1517a1cb98faSBarry Smith   | \       | \       |
1518a1cb98faSBarry Smith  13   2    14    3    15
1519a1cb98faSBarry Smith   | 4   \   | 6   \   |
1520a1cb98faSBarry Smith   |       \ |       \ |
1521a1cb98faSBarry Smith  11----6---12----7----13
1522a1cb98faSBarry Smith   |\        |\        |
1523a1cb98faSBarry Smith   | \    1  | \     3 |
1524a1cb98faSBarry Smith  10   0    11    1    12
1525a1cb98faSBarry Smith   | 0   \   | 2   \   |
1526a1cb98faSBarry Smith   |       \ |       \ |
1527a1cb98faSBarry Smith   8----4----9----5----10
1528a1cb98faSBarry Smith .ve
1529a1cb98faSBarry Smith 
15301cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMSetFromOptions()`, `DMPlexCreateFromFile()`, `DMPlexCreateHexCylinderMesh()`, `DMSetType()`, `DMCreate()`
1531768d5fceSMatthew G. Knepley @*/
1532d71ae5a4SJacob 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)
1533d71ae5a4SJacob Faibussowitsch {
15349318fe57SMatthew G. Knepley   PetscInt       fac[3] = {1, 1, 1};
1535fdbf62faSLisandro Dalcin   PetscReal      low[3] = {0, 0, 0};
1536fdbf62faSLisandro Dalcin   PetscReal      upp[3] = {1, 1, 1};
1537fdbf62faSLisandro Dalcin   DMBoundaryType bdt[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
1538552f7358SJed Brown 
1539768d5fceSMatthew G. Knepley   PetscFunctionBegin;
15409566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
15419566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
15425dca41c3SJed Brown   PetscCall(DMPlexCreateBoxMesh_Internal(*dm, DM_SHAPE_BOX, dim, simplex, faces ? faces : fac, lower ? lower : low, upper ? upper : upp, periodicity ? periodicity : bdt, interpolate));
15437ff04441SMatthew G. Knepley   if (periodicity) PetscCall(DMLocalizeCoordinates(*dm));
15443ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
15459318fe57SMatthew G. Knepley }
1546fdbf62faSLisandro Dalcin 
1547d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateWedgeBoxMesh_Internal(DM dm, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[])
1548d71ae5a4SJacob Faibussowitsch {
15499318fe57SMatthew G. Knepley   DM       bdm, vol;
15509318fe57SMatthew G. Knepley   PetscInt i;
15519318fe57SMatthew G. Knepley 
15529318fe57SMatthew G. Knepley   PetscFunctionBegin;
15531fcf445aSMatthew G. Knepley   // TODO Now we can support periodicity
155408401ef6SPierre Jolivet   for (i = 0; i < 3; ++i) PetscCheck(periodicity[i] == DM_BOUNDARY_NONE, PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Periodicity not yet supported");
15559566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &bdm));
15569566063dSJacob Faibussowitsch   PetscCall(DMSetType(bdm, DMPLEX));
15579566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(bdm, 2));
155846139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, bdm, 0, 0, 0));
15599566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBoxMesh_Simplex_Internal(bdm, 2, faces, lower, upper, periodicity, PETSC_TRUE));
15601fcf445aSMatthew G. Knepley   PetscCall(DMPlexExtrude(bdm, faces[2], upper[2] - lower[2], PETSC_TRUE, PETSC_FALSE, PETSC_FALSE, NULL, NULL, &vol));
156146139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, bdm, 0, 0, 0));
15629566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&bdm));
156369d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
15649318fe57SMatthew G. Knepley   if (lower[2] != 0.0) {
15659318fe57SMatthew G. Knepley     Vec          v;
15669318fe57SMatthew G. Knepley     PetscScalar *x;
15679318fe57SMatthew G. Knepley     PetscInt     cDim, n;
15689318fe57SMatthew G. Knepley 
15699566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinatesLocal(dm, &v));
15709566063dSJacob Faibussowitsch     PetscCall(VecGetBlockSize(v, &cDim));
15719566063dSJacob Faibussowitsch     PetscCall(VecGetLocalSize(v, &n));
15729566063dSJacob Faibussowitsch     PetscCall(VecGetArray(v, &x));
15739318fe57SMatthew G. Knepley     x += cDim;
15749318fe57SMatthew G. Knepley     for (i = 0; i < n; i += cDim) x[i] += lower[2];
15759566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(v, &x));
15769566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, v));
15779318fe57SMatthew G. Knepley   }
15783ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1579552f7358SJed Brown }
1580552f7358SJed Brown 
158100dabe28SStefano Zampini /*@
158239f4f5dbSPierre Jolivet   DMPlexCreateWedgeBoxMesh - Creates a 3-D mesh tessellating the (x,y) plane and extruding in the third direction using wedge cells.
158300dabe28SStefano Zampini 
1584d083f849SBarry Smith   Collective
158500dabe28SStefano Zampini 
158600dabe28SStefano Zampini   Input Parameters:
1587a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
158820f4b53cSBarry Smith . faces       - Number of faces per dimension, or `NULL` for (1, 1, 1)
158920f4b53cSBarry Smith . lower       - The lower left corner, or `NULL` for (0, 0, 0)
159020f4b53cSBarry Smith . upper       - The upper right corner, or `NULL` for (1, 1, 1)
159120f4b53cSBarry Smith . periodicity - The boundary type for the X,Y,Z direction, or `NULL` for `DM_BOUNDARY_NONE`
1592a1cb98faSBarry Smith . orderHeight - If `PETSC_TRUE`, orders the extruded cells in the height first. Otherwise, orders the cell on the layers first
159300dabe28SStefano Zampini - interpolate - Flag to create intermediate mesh pieces (edges, faces)
159400dabe28SStefano Zampini 
159500dabe28SStefano Zampini   Output Parameter:
1596a1cb98faSBarry Smith . dm - The `DM` object
159700dabe28SStefano Zampini 
159800dabe28SStefano Zampini   Level: beginner
159900dabe28SStefano Zampini 
16001cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateHexCylinderMesh()`, `DMPlexCreateWedgeCylinderMesh()`, `DMExtrude()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
160100dabe28SStefano Zampini @*/
1602d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateWedgeBoxMesh(MPI_Comm comm, const PetscInt faces[], const PetscReal lower[], const PetscReal upper[], const DMBoundaryType periodicity[], PetscBool orderHeight, PetscBool interpolate, DM *dm)
1603d71ae5a4SJacob Faibussowitsch {
16049318fe57SMatthew G. Knepley   PetscInt       fac[3] = {1, 1, 1};
160500dabe28SStefano Zampini   PetscReal      low[3] = {0, 0, 0};
160600dabe28SStefano Zampini   PetscReal      upp[3] = {1, 1, 1};
160700dabe28SStefano Zampini   DMBoundaryType bdt[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
160800dabe28SStefano Zampini 
160900dabe28SStefano Zampini   PetscFunctionBegin;
16109566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
16119566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
16129566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateWedgeBoxMesh_Internal(*dm, faces ? faces : fac, lower ? lower : low, upper ? upper : upp, periodicity ? periodicity : bdt));
1613d410b0cfSMatthew G. Knepley   if (!interpolate) {
1614d410b0cfSMatthew G. Knepley     DM udm;
161500dabe28SStefano Zampini 
16169566063dSJacob Faibussowitsch     PetscCall(DMPlexUninterpolate(*dm, &udm));
161769d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(*dm, &udm));
161800dabe28SStefano Zampini   }
16197ff04441SMatthew G. Knepley   if (periodicity) PetscCall(DMLocalizeCoordinates(*dm));
16203ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
162100dabe28SStefano Zampini }
162200dabe28SStefano Zampini 
1623cfb853baSMatthew G. Knepley /*
1624cfb853baSMatthew 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.
1625cfb853baSMatthew G. Knepley 
1626cfb853baSMatthew G. Knepley   Input Parameters:
1627cfb853baSMatthew G. Knepley + len - The length of the tuple
1628cfb853baSMatthew G. Knepley . max - The maximum for each dimension, so values are in [0, max)
1629cfb853baSMatthew G. Knepley - tup - A tuple of length len+1: tup[len] > 0 indicates a stopping condition
1630cfb853baSMatthew G. Knepley 
1631cfb853baSMatthew G. Knepley   Output Parameter:
163220f4b53cSBarry Smith . tup - A tuple of `len` integers whose entries are at most `max`
1633cfb853baSMatthew G. Knepley 
1634cfb853baSMatthew G. Knepley   Level: developer
1635cfb853baSMatthew G. Knepley 
163620f4b53cSBarry Smith   Note:
163720f4b53cSBarry Smith   Ordering is lexicographic with lowest index as least significant in ordering.
163820f4b53cSBarry 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}.
163920f4b53cSBarry Smith 
1640cfb853baSMatthew G. Knepley .seealso: PetscDualSpaceTensorPointLexicographic_Internal(), PetscDualSpaceLatticePointLexicographic_Internal()
1641cfb853baSMatthew G. Knepley */
1642cfb853baSMatthew G. Knepley static PetscErrorCode DMPlexTensorPointLexicographic_Private(PetscInt len, const PetscInt max[], PetscInt tup[])
1643cfb853baSMatthew G. Knepley {
1644cfb853baSMatthew G. Knepley   PetscInt i;
1645cfb853baSMatthew G. Knepley 
1646cfb853baSMatthew G. Knepley   PetscFunctionBegin;
1647cfb853baSMatthew G. Knepley   for (i = 0; i < len; ++i) {
1648cfb853baSMatthew G. Knepley     if (tup[i] < max[i] - 1) {
1649cfb853baSMatthew G. Knepley       break;
1650cfb853baSMatthew G. Knepley     } else {
1651cfb853baSMatthew G. Knepley       tup[i] = 0;
1652cfb853baSMatthew G. Knepley     }
1653cfb853baSMatthew G. Knepley   }
1654cfb853baSMatthew G. Knepley   if (i == len) tup[i - 1] = max[i - 1];
1655cfb853baSMatthew G. Knepley   else ++tup[i];
16563ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1657cfb853baSMatthew G. Knepley }
1658cfb853baSMatthew G. Knepley 
1659cfb853baSMatthew G. Knepley static PetscInt TupleToIndex_Private(PetscInt len, const PetscInt max[], const PetscInt tup[])
1660cfb853baSMatthew G. Knepley {
1661cfb853baSMatthew G. Knepley   PetscInt i, idx = tup[len - 1];
1662cfb853baSMatthew G. Knepley 
1663cfb853baSMatthew G. Knepley   for (i = len - 2; i >= 0; --i) {
1664cfb853baSMatthew G. Knepley     idx *= max[i];
1665cfb853baSMatthew G. Knepley     idx += tup[i];
1666cfb853baSMatthew G. Knepley   }
1667cfb853baSMatthew G. Knepley   return idx;
1668cfb853baSMatthew G. Knepley }
1669cfb853baSMatthew G. Knepley 
1670cfb853baSMatthew G. Knepley static PetscErrorCode DestroyExtent_Private(void *extent)
1671cfb853baSMatthew G. Knepley {
1672cfb853baSMatthew G. Knepley   return PetscFree(extent);
1673cfb853baSMatthew G. Knepley }
1674cfb853baSMatthew G. Knepley 
1675cfb853baSMatthew G. Knepley static PetscErrorCode DMPlexCreateHypercubicMesh_Internal(DM dm, PetscInt dim, const PetscReal lower[], const PetscReal upper[], const PetscInt edges[], const DMBoundaryType bd[])
1676cfb853baSMatthew G. Knepley {
1677cfb853baSMatthew G. Knepley   Vec          coordinates;
1678cfb853baSMatthew G. Knepley   PetscSection coordSection;
1679cfb853baSMatthew G. Knepley   DMLabel      cutLabel    = NULL;
1680cfb853baSMatthew G. Knepley   PetscBool    cutMarker   = PETSC_FALSE;
1681cfb853baSMatthew G. Knepley   PetscBool    periodic    = PETSC_FALSE;
1682cfb853baSMatthew G. Knepley   PetscInt     numCells    = 1, c;
1683cfb853baSMatthew G. Knepley   PetscInt     numVertices = 1, v;
1684cfb853baSMatthew G. Knepley   PetscScalar *coords;
1685cfb853baSMatthew G. Knepley   PetscInt    *vertices, *vert, *vtmp, *supp, cone[2];
1686cfb853baSMatthew G. Knepley   PetscInt     d, e, cell = 0, coordSize;
1687cfb853baSMatthew G. Knepley   PetscMPIInt  rank;
1688cfb853baSMatthew G. Knepley 
1689cfb853baSMatthew G. Knepley   PetscFunctionBegin;
1690cfb853baSMatthew G. Knepley   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
1691cfb853baSMatthew G. Knepley   PetscCall(DMSetDimension(dm, dim));
1692cfb853baSMatthew G. Knepley   PetscCall(PetscCalloc4(dim, &vertices, dim, &vert, dim, &vtmp, 2 * dim, &supp));
1693cfb853baSMatthew G. Knepley   PetscCall(DMCreateLabel(dm, "marker"));
1694cfb853baSMatthew G. Knepley   PetscCall(PetscOptionsGetBool(((PetscObject)dm)->options, ((PetscObject)dm)->prefix, "-dm_plex_periodic_cut", &cutMarker, NULL));
1695cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) periodic = (periodic || bd[d] == DM_BOUNDARY_PERIODIC) ? PETSC_TRUE : PETSC_FALSE;
1696cfb853baSMatthew G. Knepley   if (periodic && cutMarker) {
1697cfb853baSMatthew G. Knepley     PetscCall(DMCreateLabel(dm, "periodic_cut"));
1698cfb853baSMatthew G. Knepley     PetscCall(DMGetLabel(dm, "periodic_cut", &cutLabel));
1699cfb853baSMatthew G. Knepley   }
1700cfb853baSMatthew 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");
1701cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) {
1702cfb853baSMatthew G. Knepley     vertices[d] = edges[d];
1703cfb853baSMatthew G. Knepley     numVertices *= vertices[d];
1704cfb853baSMatthew G. Knepley   }
1705cfb853baSMatthew G. Knepley   numCells = numVertices * dim;
1706cfb853baSMatthew G. Knepley   PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
1707cfb853baSMatthew G. Knepley   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, 2));
1708cfb853baSMatthew G. Knepley   for (v = numCells; v < numCells + numVertices; ++v) PetscCall(DMPlexSetSupportSize(dm, v, 2 * dim));
1709cfb853baSMatthew G. Knepley   /* TODO Loop over boundary and reset support sizes */
1710cfb853baSMatthew G. Knepley   PetscCall(DMSetUp(dm)); /* Allocate space for cones and supports */
1711cfb853baSMatthew G. Knepley   /* Build cell cones and vertex supports */
1712cfb853baSMatthew G. Knepley   PetscCall(DMCreateLabel(dm, "celltype"));
1713cfb853baSMatthew G. Knepley   while (vert[dim - 1] < vertices[dim - 1]) {
1714cfb853baSMatthew G. Knepley     const PetscInt vertex = TupleToIndex_Private(dim, vertices, vert) + numCells;
1715cfb853baSMatthew G. Knepley     PetscInt       s      = 0;
1716cfb853baSMatthew G. Knepley 
17173ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "Vertex %" PetscInt_FMT ":", vertex));
17183ba16761SJacob Faibussowitsch     for (d = 0; d < dim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %" PetscInt_FMT, vert[d]));
17193ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
1720cfb853baSMatthew G. Knepley     PetscCall(DMPlexSetCellType(dm, vertex, DM_POLYTOPE_POINT));
1721cfb853baSMatthew G. Knepley     for (d = 0; d < dim; ++d) {
1722cfb853baSMatthew G. Knepley       for (e = 0; e < dim; ++e) vtmp[e] = vert[e];
1723cfb853baSMatthew G. Knepley       vtmp[d] = (vert[d] + 1) % vertices[d];
1724cfb853baSMatthew G. Knepley       cone[0] = vertex;
1725cfb853baSMatthew G. Knepley       cone[1] = TupleToIndex_Private(dim, vertices, vtmp) + numCells;
17263ba16761SJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Vertex %" PetscInt_FMT ":", cone[1]));
17273ba16761SJacob Faibussowitsch       for (e = 0; e < dim; ++e) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %" PetscInt_FMT, vtmp[e]));
17283ba16761SJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
1729cfb853baSMatthew G. Knepley       PetscCall(DMPlexSetCone(dm, cell, cone));
1730cfb853baSMatthew G. Knepley       PetscCall(DMPlexSetCellType(dm, cell, DM_POLYTOPE_SEGMENT));
17313ba16761SJacob Faibussowitsch       PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Edge %" PetscInt_FMT " (%" PetscInt_FMT " %" PetscInt_FMT ")\n", cell, cone[0], cone[1]));
1732cfb853baSMatthew G. Knepley       ++cell;
1733cfb853baSMatthew G. Knepley     }
1734cfb853baSMatthew G. Knepley     for (d = 0; d < dim; ++d) {
1735cfb853baSMatthew G. Knepley       for (e = 0; e < dim; ++e) vtmp[e] = vert[e];
1736cfb853baSMatthew G. Knepley       vtmp[d]   = (vert[d] + vertices[d] - 1) % vertices[d];
1737cfb853baSMatthew G. Knepley       supp[s++] = TupleToIndex_Private(dim, vertices, vtmp) * dim + d;
1738cfb853baSMatthew G. Knepley       supp[s++] = (vertex - numCells) * dim + d;
1739cfb853baSMatthew G. Knepley       PetscCall(DMPlexSetSupport(dm, vertex, supp));
1740cfb853baSMatthew G. Knepley     }
1741cfb853baSMatthew G. Knepley     PetscCall(DMPlexTensorPointLexicographic_Private(dim, vertices, vert));
1742cfb853baSMatthew G. Knepley   }
1743cfb853baSMatthew G. Knepley   PetscCall(DMPlexStratify(dm));
1744cfb853baSMatthew G. Knepley   /* Build coordinates */
1745cfb853baSMatthew G. Knepley   PetscCall(DMGetCoordinateSection(dm, &coordSection));
1746cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetNumFields(coordSection, 1));
1747cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
1748cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetChart(coordSection, numCells, numCells + numVertices));
1749cfb853baSMatthew G. Knepley   for (v = numCells; v < numCells + numVertices; ++v) {
1750cfb853baSMatthew G. Knepley     PetscCall(PetscSectionSetDof(coordSection, v, dim));
1751cfb853baSMatthew G. Knepley     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
1752cfb853baSMatthew G. Knepley   }
1753cfb853baSMatthew G. Knepley   PetscCall(PetscSectionSetUp(coordSection));
1754cfb853baSMatthew G. Knepley   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
1755cfb853baSMatthew G. Knepley   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
1756cfb853baSMatthew G. Knepley   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
1757cfb853baSMatthew G. Knepley   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
1758cfb853baSMatthew G. Knepley   PetscCall(VecSetBlockSize(coordinates, dim));
1759cfb853baSMatthew G. Knepley   PetscCall(VecSetType(coordinates, VECSTANDARD));
1760cfb853baSMatthew G. Knepley   PetscCall(VecGetArray(coordinates, &coords));
1761cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) vert[d] = 0;
1762cfb853baSMatthew G. Knepley   while (vert[dim - 1] < vertices[dim - 1]) {
1763cfb853baSMatthew G. Knepley     const PetscInt vertex = TupleToIndex_Private(dim, vertices, vert);
1764cfb853baSMatthew G. Knepley 
1765cfb853baSMatthew G. Knepley     for (d = 0; d < dim; ++d) coords[vertex * dim + d] = lower[d] + ((upper[d] - lower[d]) / vertices[d]) * vert[d];
17663ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "Vertex %" PetscInt_FMT ":", vertex));
17673ba16761SJacob Faibussowitsch     for (d = 0; d < dim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %" PetscInt_FMT, vert[d]));
17683ba16761SJacob Faibussowitsch     for (d = 0; d < dim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, " %g", (double)PetscRealPart(coords[vertex * dim + d])));
17693ba16761SJacob Faibussowitsch     PetscCall(PetscPrintf(PETSC_COMM_SELF, "\n"));
1770cfb853baSMatthew G. Knepley     PetscCall(DMPlexTensorPointLexicographic_Private(dim, vertices, vert));
1771cfb853baSMatthew G. Knepley   }
1772cfb853baSMatthew G. Knepley   PetscCall(VecRestoreArray(coordinates, &coords));
1773cfb853baSMatthew G. Knepley   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
1774cfb853baSMatthew G. Knepley   PetscCall(VecDestroy(&coordinates));
1775cfb853baSMatthew G. Knepley   PetscCall(PetscFree4(vertices, vert, vtmp, supp));
1776cfb853baSMatthew G. Knepley   //PetscCall(DMSetPeriodicity(dm, NULL, lower, upper));
1777cfb853baSMatthew G. Knepley   // Attach the extent
1778cfb853baSMatthew G. Knepley   {
1779cfb853baSMatthew G. Knepley     PetscContainer c;
1780cfb853baSMatthew G. Knepley     PetscInt      *extent;
1781cfb853baSMatthew G. Knepley 
1782cfb853baSMatthew G. Knepley     PetscCall(PetscMalloc1(dim, &extent));
1783cfb853baSMatthew G. Knepley     for (PetscInt d = 0; d < dim; ++d) extent[d] = edges[d];
1784cfb853baSMatthew G. Knepley     PetscCall(PetscContainerCreate(PETSC_COMM_SELF, &c));
1785cfb853baSMatthew G. Knepley     PetscCall(PetscContainerSetUserDestroy(c, DestroyExtent_Private));
1786cfb853baSMatthew G. Knepley     PetscCall(PetscContainerSetPointer(c, extent));
1787cfb853baSMatthew G. Knepley     PetscCall(PetscObjectCompose((PetscObject)dm, "_extent", (PetscObject)c));
1788cfb853baSMatthew G. Knepley     PetscCall(PetscContainerDestroy(&c));
1789cfb853baSMatthew G. Knepley   }
17903ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1791cfb853baSMatthew G. Knepley }
1792cfb853baSMatthew G. Knepley 
1793cfb853baSMatthew G. Knepley /*@C
1794aaa8cc7dSPierre Jolivet   DMPlexCreateHypercubicMesh - Creates a periodic mesh on the tensor product of unit intervals using only vertices and edges.
1795cfb853baSMatthew G. Knepley 
1796cfb853baSMatthew G. Knepley   Collective
1797cfb853baSMatthew G. Knepley 
1798cfb853baSMatthew G. Knepley   Input Parameters:
1799cfb853baSMatthew G. Knepley + comm  - The communicator for the DM object
1800cfb853baSMatthew G. Knepley . dim   - The spatial dimension
180120f4b53cSBarry Smith . edges - Number of edges per dimension, or `NULL` for (1,) in 1D and (2, 2) in 2D and (1, 1, 1) in 3D
180220f4b53cSBarry Smith . lower - The lower left corner, or `NULL` for (0, 0, 0)
180320f4b53cSBarry Smith - upper - The upper right corner, or `NULL` for (1, 1, 1)
1804cfb853baSMatthew G. Knepley 
1805cfb853baSMatthew G. Knepley   Output Parameter:
1806cfb853baSMatthew G. Knepley . dm - The DM object
1807cfb853baSMatthew G. Knepley 
180820f4b53cSBarry Smith   Level: beginner
180920f4b53cSBarry Smith 
181020f4b53cSBarry Smith   Note:
181120f4b53cSBarry Smith   If you want to customize this mesh using options, you just need to
181220f4b53cSBarry Smith .vb
181320f4b53cSBarry Smith   DMCreate(comm, &dm);
181420f4b53cSBarry Smith   DMSetType(dm, DMPLEX);
181520f4b53cSBarry Smith   DMSetFromOptions(dm);
181620f4b53cSBarry Smith .ve
181720f4b53cSBarry Smith   and use the options on the `DMSetFromOptions()` page.
1818cfb853baSMatthew G. Knepley 
1819cfb853baSMatthew G. Knepley   The vertices are numbered is lexicographic order, and the dim edges exiting a vertex in the positive orthant are number consecutively,
182020f4b53cSBarry Smith .vb
182120f4b53cSBarry Smith  18--0-19--2-20--4-18
182220f4b53cSBarry Smith   |     |     |     |
182320f4b53cSBarry Smith  13    15    17    13
182420f4b53cSBarry Smith   |     |     |     |
182520f4b53cSBarry Smith  24-12-25-14-26-16-24
182620f4b53cSBarry Smith   |     |     |     |
182720f4b53cSBarry Smith   7     9    11     7
182820f4b53cSBarry Smith   |     |     |     |
182920f4b53cSBarry Smith  21--6-22--8-23-10-21
183020f4b53cSBarry Smith   |     |     |     |
183120f4b53cSBarry Smith   1     3     5     1
183220f4b53cSBarry Smith   |     |     |     |
183320f4b53cSBarry Smith  18--0-19--2-20--4-18
183420f4b53cSBarry Smith .ve
1835cfb853baSMatthew G. Knepley 
183676fbde31SPierre Jolivet .seealso: `DMSetFromOptions()`, `DMPlexCreateFromFile()`, `DMPlexCreateHexCylinderMesh()`, `DMSetType()`, `DMCreate()`
1837cfb853baSMatthew G. Knepley @*/
1838cfb853baSMatthew G. Knepley PetscErrorCode DMPlexCreateHypercubicMesh(MPI_Comm comm, PetscInt dim, const PetscInt edges[], const PetscReal lower[], const PetscReal upper[], DM *dm)
1839cfb853baSMatthew G. Knepley {
1840cfb853baSMatthew G. Knepley   PetscInt       *edg;
1841cfb853baSMatthew G. Knepley   PetscReal      *low, *upp;
1842cfb853baSMatthew G. Knepley   DMBoundaryType *bdt;
1843cfb853baSMatthew G. Knepley   PetscInt        d;
1844cfb853baSMatthew G. Knepley 
1845cfb853baSMatthew G. Knepley   PetscFunctionBegin;
1846cfb853baSMatthew G. Knepley   PetscCall(DMCreate(comm, dm));
1847cfb853baSMatthew G. Knepley   PetscCall(DMSetType(*dm, DMPLEX));
1848cfb853baSMatthew G. Knepley   PetscCall(PetscMalloc4(dim, &edg, dim, &low, dim, &upp, dim, &bdt));
1849cfb853baSMatthew G. Knepley   for (d = 0; d < dim; ++d) {
1850cfb853baSMatthew G. Knepley     edg[d] = edges ? edges[d] : 1;
1851cfb853baSMatthew G. Knepley     low[d] = lower ? lower[d] : 0.;
1852cfb853baSMatthew G. Knepley     upp[d] = upper ? upper[d] : 1.;
1853cfb853baSMatthew G. Knepley     bdt[d] = DM_BOUNDARY_PERIODIC;
1854cfb853baSMatthew G. Knepley   }
1855cfb853baSMatthew G. Knepley   PetscCall(DMPlexCreateHypercubicMesh_Internal(*dm, dim, low, upp, edg, bdt));
1856cfb853baSMatthew G. Knepley   PetscCall(PetscFree4(edg, low, upp, bdt));
18573ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1858cfb853baSMatthew G. Knepley }
1859cfb853baSMatthew G. Knepley 
1860cc4c1da9SBarry Smith /*@
1861a1cb98faSBarry Smith   DMPlexSetOptionsPrefix - Sets the prefix used for searching for all `DM` options in the database.
1862a9074c1eSMatthew G. Knepley 
186320f4b53cSBarry Smith   Logically Collective
1864a9074c1eSMatthew G. Knepley 
1865a9074c1eSMatthew G. Knepley   Input Parameters:
186620f4b53cSBarry Smith + dm     - the `DM` context
1867a9074c1eSMatthew G. Knepley - prefix - the prefix to prepend to all option names
1868a9074c1eSMatthew G. Knepley 
1869a1cb98faSBarry Smith   Level: advanced
1870a1cb98faSBarry Smith 
1871a1cb98faSBarry Smith   Note:
1872a9074c1eSMatthew G. Knepley   A hyphen (-) must NOT be given at the beginning of the prefix name.
1873a9074c1eSMatthew G. Knepley   The first character of all runtime options is AUTOMATICALLY the hyphen.
1874a9074c1eSMatthew G. Knepley 
18751cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `SNESSetFromOptions()`
1876a9074c1eSMatthew G. Knepley @*/
1877d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexSetOptionsPrefix(DM dm, const char prefix[])
1878d71ae5a4SJacob Faibussowitsch {
1879a9074c1eSMatthew G. Knepley   DM_Plex *mesh = (DM_Plex *)dm->data;
1880a9074c1eSMatthew G. Knepley 
1881a9074c1eSMatthew G. Knepley   PetscFunctionBegin;
1882a9074c1eSMatthew G. Knepley   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
18839566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)dm, prefix));
18849566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)mesh->partitioner, prefix));
18853ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1886a9074c1eSMatthew G. Knepley }
1887a9074c1eSMatthew G. Knepley 
18889318fe57SMatthew G. Knepley /* Remap geometry to cylinder
188961a622f3SMatthew G. Knepley    TODO: This only works for a single refinement, then it is broken
189061a622f3SMatthew G. Knepley 
18919318fe57SMatthew G. Knepley      Interior square: Linear interpolation is correct
18929318fe57SMatthew G. Knepley      The other cells all have vertices on rays from the origin. We want to uniformly expand the spacing
18939318fe57SMatthew G. Knepley      such that the last vertex is on the unit circle. So the closest and farthest vertices are at distance
18940510c589SMatthew G. Knepley 
18959318fe57SMatthew G. Knepley        phi     = arctan(y/x)
18969318fe57SMatthew G. Knepley        d_close = sqrt(1/8 + 1/4 sin^2(phi))
18979318fe57SMatthew G. Knepley        d_far   = sqrt(1/2 + sin^2(phi))
18980510c589SMatthew G. Knepley 
18999318fe57SMatthew G. Knepley      so we remap them using
19000510c589SMatthew G. Knepley 
19019318fe57SMatthew G. Knepley        x_new = x_close + (x - x_close) (1 - d_close) / (d_far - d_close)
19029318fe57SMatthew G. Knepley        y_new = y_close + (y - y_close) (1 - d_close) / (d_far - d_close)
19030510c589SMatthew G. Knepley 
19049318fe57SMatthew G. Knepley      If pi/4 < phi < 3pi/4 or -3pi/4 < phi < -pi/4, then we switch x and y.
19059318fe57SMatthew G. Knepley */
1906d71ae5a4SJacob 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[])
1907d71ae5a4SJacob Faibussowitsch {
19089318fe57SMatthew G. Knepley   const PetscReal dis = 1.0 / PetscSqrtReal(2.0);
19099318fe57SMatthew G. Knepley   const PetscReal ds2 = 0.5 * dis;
191022cc497dSMatthew G. Knepley 
19119318fe57SMatthew G. Knepley   if ((PetscAbsScalar(u[0]) <= ds2) && (PetscAbsScalar(u[1]) <= ds2)) {
19129318fe57SMatthew G. Knepley     f0[0] = u[0];
19139318fe57SMatthew G. Knepley     f0[1] = u[1];
19149318fe57SMatthew G. Knepley   } else {
19159318fe57SMatthew G. Knepley     PetscReal phi, sinp, cosp, dc, df, x, y, xc, yc;
19160510c589SMatthew G. Knepley 
19179318fe57SMatthew G. Knepley     x    = PetscRealPart(u[0]);
19189318fe57SMatthew G. Knepley     y    = PetscRealPart(u[1]);
19199318fe57SMatthew G. Knepley     phi  = PetscAtan2Real(y, x);
19209318fe57SMatthew G. Knepley     sinp = PetscSinReal(phi);
19219318fe57SMatthew G. Knepley     cosp = PetscCosReal(phi);
19229318fe57SMatthew G. Knepley     if ((PetscAbsReal(phi) > PETSC_PI / 4.0) && (PetscAbsReal(phi) < 3.0 * PETSC_PI / 4.0)) {
19239318fe57SMatthew G. Knepley       dc = PetscAbsReal(ds2 / sinp);
19249318fe57SMatthew G. Knepley       df = PetscAbsReal(dis / sinp);
19259318fe57SMatthew G. Knepley       xc = ds2 * x / PetscAbsReal(y);
19269318fe57SMatthew G. Knepley       yc = ds2 * PetscSignReal(y);
19279318fe57SMatthew G. Knepley     } else {
19289318fe57SMatthew G. Knepley       dc = PetscAbsReal(ds2 / cosp);
19299318fe57SMatthew G. Knepley       df = PetscAbsReal(dis / cosp);
19309318fe57SMatthew G. Knepley       xc = ds2 * PetscSignReal(x);
19319318fe57SMatthew G. Knepley       yc = ds2 * y / PetscAbsReal(x);
19329318fe57SMatthew G. Knepley     }
19339318fe57SMatthew G. Knepley     f0[0] = xc + (u[0] - xc) * (1.0 - dc) / (df - dc);
19349318fe57SMatthew G. Knepley     f0[1] = yc + (u[1] - yc) * (1.0 - dc) / (df - dc);
19359318fe57SMatthew G. Knepley   }
19369318fe57SMatthew G. Knepley   f0[2] = u[2];
19379318fe57SMatthew G. Knepley }
19380510c589SMatthew G. Knepley 
193949704ca5SMatthew G. Knepley static PetscErrorCode DMPlexCreateHexCylinderMesh_Internal(DM dm, DMBoundaryType periodicZ, PetscInt Nr)
1940d71ae5a4SJacob Faibussowitsch {
19410510c589SMatthew G. Knepley   const PetscInt dim = 3;
19429318fe57SMatthew G. Knepley   PetscInt       numCells, numVertices;
1943d8c47e87SMatthew G. Knepley   PetscMPIInt    rank;
19440510c589SMatthew G. Knepley 
19450510c589SMatthew G. Knepley   PetscFunctionBegin;
194646139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
19479566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
19489566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
19490510c589SMatthew G. Knepley   /* Create topology */
19500510c589SMatthew G. Knepley   {
19510510c589SMatthew G. Knepley     PetscInt cone[8], c;
19520510c589SMatthew G. Knepley 
1953dd400576SPatrick Sanan     numCells    = rank == 0 ? 5 : 0;
1954dd400576SPatrick Sanan     numVertices = rank == 0 ? 16 : 0;
1955006a8963SMatthew G. Knepley     if (periodicZ == DM_BOUNDARY_PERIODIC) {
1956ae8bcbbbSMatthew G. Knepley       numCells *= 3;
1957dd400576SPatrick Sanan       numVertices = rank == 0 ? 24 : 0;
1958006a8963SMatthew G. Knepley     }
19599566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
19609566063dSJacob Faibussowitsch     for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 8));
19619566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm));
1962dd400576SPatrick Sanan     if (rank == 0) {
1963006a8963SMatthew G. Knepley       if (periodicZ == DM_BOUNDARY_PERIODIC) {
19649371c9d4SSatish Balay         cone[0] = 15;
19659371c9d4SSatish Balay         cone[1] = 18;
19669371c9d4SSatish Balay         cone[2] = 17;
19679371c9d4SSatish Balay         cone[3] = 16;
19689371c9d4SSatish Balay         cone[4] = 31;
19699371c9d4SSatish Balay         cone[5] = 32;
19709371c9d4SSatish Balay         cone[6] = 33;
19719371c9d4SSatish Balay         cone[7] = 34;
19729566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
19739371c9d4SSatish Balay         cone[0] = 16;
19749371c9d4SSatish Balay         cone[1] = 17;
19759371c9d4SSatish Balay         cone[2] = 24;
19769371c9d4SSatish Balay         cone[3] = 23;
19779371c9d4SSatish Balay         cone[4] = 32;
19789371c9d4SSatish Balay         cone[5] = 36;
19799371c9d4SSatish Balay         cone[6] = 37;
19809371c9d4SSatish Balay         cone[7] = 33; /* 22 25 26 21 */
19819566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
19829371c9d4SSatish Balay         cone[0] = 18;
19839371c9d4SSatish Balay         cone[1] = 27;
19849371c9d4SSatish Balay         cone[2] = 24;
19859371c9d4SSatish Balay         cone[3] = 17;
19869371c9d4SSatish Balay         cone[4] = 34;
19879371c9d4SSatish Balay         cone[5] = 33;
19889371c9d4SSatish Balay         cone[6] = 37;
19899371c9d4SSatish Balay         cone[7] = 38;
19909566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
19919371c9d4SSatish Balay         cone[0] = 29;
19929371c9d4SSatish Balay         cone[1] = 27;
19939371c9d4SSatish Balay         cone[2] = 18;
19949371c9d4SSatish Balay         cone[3] = 15;
19959371c9d4SSatish Balay         cone[4] = 35;
19969371c9d4SSatish Balay         cone[5] = 31;
19979371c9d4SSatish Balay         cone[6] = 34;
19989371c9d4SSatish Balay         cone[7] = 38;
19999566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
20009371c9d4SSatish Balay         cone[0] = 29;
20019371c9d4SSatish Balay         cone[1] = 15;
20029371c9d4SSatish Balay         cone[2] = 16;
20039371c9d4SSatish Balay         cone[3] = 23;
20049371c9d4SSatish Balay         cone[4] = 35;
20059371c9d4SSatish Balay         cone[5] = 36;
20069371c9d4SSatish Balay         cone[6] = 32;
20079371c9d4SSatish Balay         cone[7] = 31;
20089566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
2009006a8963SMatthew G. Knepley 
20109371c9d4SSatish Balay         cone[0] = 31;
20119371c9d4SSatish Balay         cone[1] = 34;
20129371c9d4SSatish Balay         cone[2] = 33;
20139371c9d4SSatish Balay         cone[3] = 32;
20149371c9d4SSatish Balay         cone[4] = 19;
20159371c9d4SSatish Balay         cone[5] = 22;
20169371c9d4SSatish Balay         cone[6] = 21;
20179371c9d4SSatish Balay         cone[7] = 20;
20189566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 5, cone));
20199371c9d4SSatish Balay         cone[0] = 32;
20209371c9d4SSatish Balay         cone[1] = 33;
20219371c9d4SSatish Balay         cone[2] = 37;
20229371c9d4SSatish Balay         cone[3] = 36;
20239371c9d4SSatish Balay         cone[4] = 22;
20249371c9d4SSatish Balay         cone[5] = 25;
20259371c9d4SSatish Balay         cone[6] = 26;
20269371c9d4SSatish Balay         cone[7] = 21;
20279566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 6, cone));
20289371c9d4SSatish Balay         cone[0] = 34;
20299371c9d4SSatish Balay         cone[1] = 38;
20309371c9d4SSatish Balay         cone[2] = 37;
20319371c9d4SSatish Balay         cone[3] = 33;
20329371c9d4SSatish Balay         cone[4] = 20;
20339371c9d4SSatish Balay         cone[5] = 21;
20349371c9d4SSatish Balay         cone[6] = 26;
20359371c9d4SSatish Balay         cone[7] = 28;
20369566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 7, cone));
20379371c9d4SSatish Balay         cone[0] = 35;
20389371c9d4SSatish Balay         cone[1] = 38;
20399371c9d4SSatish Balay         cone[2] = 34;
20409371c9d4SSatish Balay         cone[3] = 31;
20419371c9d4SSatish Balay         cone[4] = 30;
20429371c9d4SSatish Balay         cone[5] = 19;
20439371c9d4SSatish Balay         cone[6] = 20;
20449371c9d4SSatish Balay         cone[7] = 28;
20459566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 8, cone));
20469371c9d4SSatish Balay         cone[0] = 35;
20479371c9d4SSatish Balay         cone[1] = 31;
20489371c9d4SSatish Balay         cone[2] = 32;
20499371c9d4SSatish Balay         cone[3] = 36;
20509371c9d4SSatish Balay         cone[4] = 30;
20519371c9d4SSatish Balay         cone[5] = 25;
20529371c9d4SSatish Balay         cone[6] = 22;
20539371c9d4SSatish Balay         cone[7] = 19;
20549566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 9, cone));
2055ae8bcbbbSMatthew G. Knepley 
20569371c9d4SSatish Balay         cone[0] = 19;
20579371c9d4SSatish Balay         cone[1] = 20;
20589371c9d4SSatish Balay         cone[2] = 21;
20599371c9d4SSatish Balay         cone[3] = 22;
20609371c9d4SSatish Balay         cone[4] = 15;
20619371c9d4SSatish Balay         cone[5] = 16;
20629371c9d4SSatish Balay         cone[6] = 17;
20639371c9d4SSatish Balay         cone[7] = 18;
20649566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 10, cone));
20659371c9d4SSatish Balay         cone[0] = 22;
20669371c9d4SSatish Balay         cone[1] = 21;
20679371c9d4SSatish Balay         cone[2] = 26;
20689371c9d4SSatish Balay         cone[3] = 25;
20699371c9d4SSatish Balay         cone[4] = 16;
20709371c9d4SSatish Balay         cone[5] = 23;
20719371c9d4SSatish Balay         cone[6] = 24;
20729371c9d4SSatish Balay         cone[7] = 17;
20739566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 11, cone));
20749371c9d4SSatish Balay         cone[0] = 20;
20759371c9d4SSatish Balay         cone[1] = 28;
20769371c9d4SSatish Balay         cone[2] = 26;
20779371c9d4SSatish Balay         cone[3] = 21;
20789371c9d4SSatish Balay         cone[4] = 18;
20799371c9d4SSatish Balay         cone[5] = 17;
20809371c9d4SSatish Balay         cone[6] = 24;
20819371c9d4SSatish Balay         cone[7] = 27;
20829566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 12, cone));
20839371c9d4SSatish Balay         cone[0] = 30;
20849371c9d4SSatish Balay         cone[1] = 28;
20859371c9d4SSatish Balay         cone[2] = 20;
20869371c9d4SSatish Balay         cone[3] = 19;
20879371c9d4SSatish Balay         cone[4] = 29;
20889371c9d4SSatish Balay         cone[5] = 15;
20899371c9d4SSatish Balay         cone[6] = 18;
20909371c9d4SSatish Balay         cone[7] = 27;
20919566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 13, cone));
20929371c9d4SSatish Balay         cone[0] = 30;
20939371c9d4SSatish Balay         cone[1] = 19;
20949371c9d4SSatish Balay         cone[2] = 22;
20959371c9d4SSatish Balay         cone[3] = 25;
20969371c9d4SSatish Balay         cone[4] = 29;
20979371c9d4SSatish Balay         cone[5] = 23;
20989371c9d4SSatish Balay         cone[6] = 16;
20999371c9d4SSatish Balay         cone[7] = 15;
21009566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 14, cone));
2101006a8963SMatthew G. Knepley       } else {
21029371c9d4SSatish Balay         cone[0] = 5;
21039371c9d4SSatish Balay         cone[1] = 8;
21049371c9d4SSatish Balay         cone[2] = 7;
21059371c9d4SSatish Balay         cone[3] = 6;
21069371c9d4SSatish Balay         cone[4] = 9;
21079371c9d4SSatish Balay         cone[5] = 12;
21089371c9d4SSatish Balay         cone[6] = 11;
21099371c9d4SSatish Balay         cone[7] = 10;
21109566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
21119371c9d4SSatish Balay         cone[0] = 6;
21129371c9d4SSatish Balay         cone[1] = 7;
21139371c9d4SSatish Balay         cone[2] = 14;
21149371c9d4SSatish Balay         cone[3] = 13;
21159371c9d4SSatish Balay         cone[4] = 12;
21169371c9d4SSatish Balay         cone[5] = 15;
21179371c9d4SSatish Balay         cone[6] = 16;
21189371c9d4SSatish Balay         cone[7] = 11;
21199566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
21209371c9d4SSatish Balay         cone[0] = 8;
21219371c9d4SSatish Balay         cone[1] = 17;
21229371c9d4SSatish Balay         cone[2] = 14;
21239371c9d4SSatish Balay         cone[3] = 7;
21249371c9d4SSatish Balay         cone[4] = 10;
21259371c9d4SSatish Balay         cone[5] = 11;
21269371c9d4SSatish Balay         cone[6] = 16;
21279371c9d4SSatish Balay         cone[7] = 18;
21289566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
21299371c9d4SSatish Balay         cone[0] = 19;
21309371c9d4SSatish Balay         cone[1] = 17;
21319371c9d4SSatish Balay         cone[2] = 8;
21329371c9d4SSatish Balay         cone[3] = 5;
21339371c9d4SSatish Balay         cone[4] = 20;
21349371c9d4SSatish Balay         cone[5] = 9;
21359371c9d4SSatish Balay         cone[6] = 10;
21369371c9d4SSatish Balay         cone[7] = 18;
21379566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
21389371c9d4SSatish Balay         cone[0] = 19;
21399371c9d4SSatish Balay         cone[1] = 5;
21409371c9d4SSatish Balay         cone[2] = 6;
21419371c9d4SSatish Balay         cone[3] = 13;
21429371c9d4SSatish Balay         cone[4] = 20;
21439371c9d4SSatish Balay         cone[5] = 15;
21449371c9d4SSatish Balay         cone[6] = 12;
21459371c9d4SSatish Balay         cone[7] = 9;
21469566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
2147006a8963SMatthew G. Knepley       }
2148d8c47e87SMatthew G. Knepley     }
21499566063dSJacob Faibussowitsch     PetscCall(DMPlexSymmetrize(dm));
21509566063dSJacob Faibussowitsch     PetscCall(DMPlexStratify(dm));
21510510c589SMatthew G. Knepley   }
2152dbc1dc17SMatthew G. Knepley   /* Create cube geometry */
21530510c589SMatthew G. Knepley   {
21540510c589SMatthew G. Knepley     Vec             coordinates;
21550510c589SMatthew G. Knepley     PetscSection    coordSection;
21560510c589SMatthew G. Knepley     PetscScalar    *coords;
21570510c589SMatthew G. Knepley     PetscInt        coordSize, v;
21580510c589SMatthew G. Knepley     const PetscReal dis = 1.0 / PetscSqrtReal(2.0);
21590510c589SMatthew G. Knepley     const PetscReal ds2 = dis / 2.0;
21600510c589SMatthew G. Knepley 
21610510c589SMatthew G. Knepley     /* Build coordinates */
21629566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &coordSection));
21639566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetNumFields(coordSection, 1));
21649566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
21659566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetChart(coordSection, numCells, numCells + numVertices));
21660510c589SMatthew G. Knepley     for (v = numCells; v < numCells + numVertices; ++v) {
21679566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetDof(coordSection, v, dim));
21689566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
21690510c589SMatthew G. Knepley     }
21709566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetUp(coordSection));
21719566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
21729566063dSJacob Faibussowitsch     PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
21739566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
21749566063dSJacob Faibussowitsch     PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
21759566063dSJacob Faibussowitsch     PetscCall(VecSetBlockSize(coordinates, dim));
21769566063dSJacob Faibussowitsch     PetscCall(VecSetType(coordinates, VECSTANDARD));
21779566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
2178dd400576SPatrick Sanan     if (rank == 0) {
21799371c9d4SSatish Balay       coords[0 * dim + 0]  = -ds2;
21809371c9d4SSatish Balay       coords[0 * dim + 1]  = -ds2;
21819371c9d4SSatish Balay       coords[0 * dim + 2]  = 0.0;
21829371c9d4SSatish Balay       coords[1 * dim + 0]  = ds2;
21839371c9d4SSatish Balay       coords[1 * dim + 1]  = -ds2;
21849371c9d4SSatish Balay       coords[1 * dim + 2]  = 0.0;
21859371c9d4SSatish Balay       coords[2 * dim + 0]  = ds2;
21869371c9d4SSatish Balay       coords[2 * dim + 1]  = ds2;
21879371c9d4SSatish Balay       coords[2 * dim + 2]  = 0.0;
21889371c9d4SSatish Balay       coords[3 * dim + 0]  = -ds2;
21899371c9d4SSatish Balay       coords[3 * dim + 1]  = ds2;
21909371c9d4SSatish Balay       coords[3 * dim + 2]  = 0.0;
21919371c9d4SSatish Balay       coords[4 * dim + 0]  = -ds2;
21929371c9d4SSatish Balay       coords[4 * dim + 1]  = -ds2;
21939371c9d4SSatish Balay       coords[4 * dim + 2]  = 1.0;
21949371c9d4SSatish Balay       coords[5 * dim + 0]  = -ds2;
21959371c9d4SSatish Balay       coords[5 * dim + 1]  = ds2;
21969371c9d4SSatish Balay       coords[5 * dim + 2]  = 1.0;
21979371c9d4SSatish Balay       coords[6 * dim + 0]  = ds2;
21989371c9d4SSatish Balay       coords[6 * dim + 1]  = ds2;
21999371c9d4SSatish Balay       coords[6 * dim + 2]  = 1.0;
22009371c9d4SSatish Balay       coords[7 * dim + 0]  = ds2;
22019371c9d4SSatish Balay       coords[7 * dim + 1]  = -ds2;
22029371c9d4SSatish Balay       coords[7 * dim + 2]  = 1.0;
22039371c9d4SSatish Balay       coords[8 * dim + 0]  = dis;
22049371c9d4SSatish Balay       coords[8 * dim + 1]  = -dis;
22059371c9d4SSatish Balay       coords[8 * dim + 2]  = 0.0;
22069371c9d4SSatish Balay       coords[9 * dim + 0]  = dis;
22079371c9d4SSatish Balay       coords[9 * dim + 1]  = dis;
22089371c9d4SSatish Balay       coords[9 * dim + 2]  = 0.0;
22099371c9d4SSatish Balay       coords[10 * dim + 0] = dis;
22109371c9d4SSatish Balay       coords[10 * dim + 1] = -dis;
22119371c9d4SSatish Balay       coords[10 * dim + 2] = 1.0;
22129371c9d4SSatish Balay       coords[11 * dim + 0] = dis;
22139371c9d4SSatish Balay       coords[11 * dim + 1] = dis;
22149371c9d4SSatish Balay       coords[11 * dim + 2] = 1.0;
22159371c9d4SSatish Balay       coords[12 * dim + 0] = -dis;
22169371c9d4SSatish Balay       coords[12 * dim + 1] = dis;
22179371c9d4SSatish Balay       coords[12 * dim + 2] = 0.0;
22189371c9d4SSatish Balay       coords[13 * dim + 0] = -dis;
22199371c9d4SSatish Balay       coords[13 * dim + 1] = dis;
22209371c9d4SSatish Balay       coords[13 * dim + 2] = 1.0;
22219371c9d4SSatish Balay       coords[14 * dim + 0] = -dis;
22229371c9d4SSatish Balay       coords[14 * dim + 1] = -dis;
22239371c9d4SSatish Balay       coords[14 * dim + 2] = 0.0;
22249371c9d4SSatish Balay       coords[15 * dim + 0] = -dis;
22259371c9d4SSatish Balay       coords[15 * dim + 1] = -dis;
22269371c9d4SSatish Balay       coords[15 * dim + 2] = 1.0;
2227ae8bcbbbSMatthew G. Knepley       if (periodicZ == DM_BOUNDARY_PERIODIC) {
22289371c9d4SSatish Balay         /* 15 31 19 */ coords[16 * dim + 0] = -ds2;
22299371c9d4SSatish Balay         coords[16 * dim + 1]                = -ds2;
22309371c9d4SSatish Balay         coords[16 * dim + 2]                = 0.5;
22319371c9d4SSatish Balay         /* 16 32 22 */ coords[17 * dim + 0] = ds2;
22329371c9d4SSatish Balay         coords[17 * dim + 1]                = -ds2;
22339371c9d4SSatish Balay         coords[17 * dim + 2]                = 0.5;
22349371c9d4SSatish Balay         /* 17 33 21 */ coords[18 * dim + 0] = ds2;
22359371c9d4SSatish Balay         coords[18 * dim + 1]                = ds2;
22369371c9d4SSatish Balay         coords[18 * dim + 2]                = 0.5;
22379371c9d4SSatish Balay         /* 18 34 20 */ coords[19 * dim + 0] = -ds2;
22389371c9d4SSatish Balay         coords[19 * dim + 1]                = ds2;
22399371c9d4SSatish Balay         coords[19 * dim + 2]                = 0.5;
22409371c9d4SSatish Balay         /* 29 35 30 */ coords[20 * dim + 0] = -dis;
22419371c9d4SSatish Balay         coords[20 * dim + 1]                = -dis;
22429371c9d4SSatish Balay         coords[20 * dim + 2]                = 0.5;
22439371c9d4SSatish Balay         /* 23 36 25 */ coords[21 * dim + 0] = dis;
22449371c9d4SSatish Balay         coords[21 * dim + 1]                = -dis;
22459371c9d4SSatish Balay         coords[21 * dim + 2]                = 0.5;
22469371c9d4SSatish Balay         /* 24 37 26 */ coords[22 * dim + 0] = dis;
22479371c9d4SSatish Balay         coords[22 * dim + 1]                = dis;
22489371c9d4SSatish Balay         coords[22 * dim + 2]                = 0.5;
22499371c9d4SSatish Balay         /* 27 38 28 */ coords[23 * dim + 0] = -dis;
22509371c9d4SSatish Balay         coords[23 * dim + 1]                = dis;
22519371c9d4SSatish Balay         coords[23 * dim + 2]                = 0.5;
2252ae8bcbbbSMatthew G. Knepley       }
2253d8c47e87SMatthew G. Knepley     }
22549566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(coordinates, &coords));
22559566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, coordinates));
22569566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&coordinates));
22570510c589SMatthew G. Knepley   }
2258006a8963SMatthew G. Knepley   /* Create periodicity */
2259006a8963SMatthew G. Knepley   if (periodicZ == DM_BOUNDARY_PERIODIC || periodicZ == DM_BOUNDARY_TWIST) {
22606858538eSMatthew G. Knepley     PetscReal L[3]       = {-1., -1., 0.};
22616858538eSMatthew G. Knepley     PetscReal maxCell[3] = {-1., -1., 0.};
2262006a8963SMatthew G. Knepley     PetscReal lower[3]   = {0.0, 0.0, 0.0};
2263ae8bcbbbSMatthew G. Knepley     PetscReal upper[3]   = {1.0, 1.0, 1.5};
22646858538eSMatthew G. Knepley     PetscInt  numZCells  = 3;
2265006a8963SMatthew G. Knepley 
22666858538eSMatthew G. Knepley     L[2]       = upper[2] - lower[2];
22676858538eSMatthew G. Knepley     maxCell[2] = 1.1 * (L[2] / numZCells);
22684fb89dddSMatthew G. Knepley     PetscCall(DMSetPeriodicity(dm, maxCell, lower, L));
2269006a8963SMatthew G. Knepley   }
2270dbc1dc17SMatthew G. Knepley   {
22719318fe57SMatthew G. Knepley     DM          cdm;
22729318fe57SMatthew G. Knepley     PetscDS     cds;
22739318fe57SMatthew G. Knepley     PetscScalar c[2] = {1.0, 1.0};
2274dbc1dc17SMatthew G. Knepley 
227549704ca5SMatthew G. Knepley     PetscCall(DMPlexCreateCoordinateSpace(dm, 1, PETSC_TRUE, NULL));
22769566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
22779566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
22789566063dSJacob Faibussowitsch     PetscCall(PetscDSSetConstants(cds, 2, c));
2279dbc1dc17SMatthew G. Knepley   }
228046139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
228146139095SJed Brown 
22829318fe57SMatthew G. Knepley   /* Wait for coordinate creation before doing in-place modification */
22839566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolateInPlace_Internal(dm));
228449704ca5SMatthew G. Knepley 
228549704ca5SMatthew G. Knepley   char        oldprefix[PETSC_MAX_PATH_LEN];
228649704ca5SMatthew G. Knepley   const char *prefix;
228749704ca5SMatthew G. Knepley 
228849704ca5SMatthew G. Knepley   PetscCall(PetscObjectGetOptionsPrefix((PetscObject)dm, &prefix));
228949704ca5SMatthew G. Knepley   PetscCall(PetscStrncpy(oldprefix, prefix, PETSC_MAX_PATH_LEN));
229049704ca5SMatthew G. Knepley   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)dm, "petsc_cyl_ref_"));
229149704ca5SMatthew G. Knepley   for (PetscInt r = 0; r < PetscMax(0, Nr); ++r) {
229249704ca5SMatthew G. Knepley     DM rdm;
229349704ca5SMatthew G. Knepley 
229449704ca5SMatthew G. Knepley     PetscCall(DMRefine(dm, PetscObjectComm((PetscObject)dm), &rdm));
229549704ca5SMatthew G. Knepley     PetscCall(DMPlexReplace_Internal(dm, &rdm));
229649704ca5SMatthew G. Knepley   }
229749704ca5SMatthew G. Knepley   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)dm, oldprefix));
229849704ca5SMatthew G. Knepley   PetscCall(DMPlexRemapGeometry(dm, 0.0, snapToCylinder));
229949704ca5SMatthew G. Knepley 
230049704ca5SMatthew G. Knepley   DMLabel         bdlabel, edgelabel;
230149704ca5SMatthew G. Knepley   IS              faceIS;
230249704ca5SMatthew G. Knepley   const PetscInt *faces;
230349704ca5SMatthew G. Knepley   PetscInt        Nf;
230449704ca5SMatthew G. Knepley 
230549704ca5SMatthew G. Knepley   PetscCall(DMCreateLabel(dm, "marker"));
230649704ca5SMatthew G. Knepley   PetscCall(DMGetLabel(dm, "marker", &bdlabel));
230749704ca5SMatthew G. Knepley   PetscCall(DMCreateLabel(dm, "generatrix"));
230849704ca5SMatthew G. Knepley   PetscCall(DMGetLabel(dm, "generatrix", &edgelabel));
230949704ca5SMatthew G. Knepley   PetscCall(DMPlexMarkBoundaryFaces(dm, PETSC_DETERMINE, bdlabel));
231049704ca5SMatthew G. Knepley   // Remove faces on top and bottom
231149704ca5SMatthew G. Knepley   PetscCall(DMLabelGetStratumIS(bdlabel, 1, &faceIS));
2312ba1b3593SJeremy L Thompson   if (faceIS) {
231349704ca5SMatthew G. Knepley     PetscCall(ISGetLocalSize(faceIS, &Nf));
231449704ca5SMatthew G. Knepley     PetscCall(ISGetIndices(faceIS, &faces));
231549704ca5SMatthew G. Knepley     for (PetscInt f = 0; f < Nf; ++f) {
231649704ca5SMatthew G. Knepley       PetscReal vol, normal[3];
231749704ca5SMatthew G. Knepley 
231849704ca5SMatthew G. Knepley       PetscCall(DMPlexComputeCellGeometryFVM(dm, faces[f], &vol, NULL, normal));
231949704ca5SMatthew G. Knepley       if (PetscAbsReal(normal[2]) < PETSC_SMALL) PetscCall(DMLabelSetValue(edgelabel, faces[f], 1));
232049704ca5SMatthew G. Knepley     }
232149704ca5SMatthew G. Knepley     PetscCall(ISRestoreIndices(faceIS, &faces));
232249704ca5SMatthew G. Knepley     PetscCall(ISDestroy(&faceIS));
2323ba1b3593SJeremy L Thompson   }
232449704ca5SMatthew G. Knepley   PetscCall(DMPlexLabelComplete(dm, bdlabel));
232549704ca5SMatthew G. Knepley   PetscCall(DMPlexLabelComplete(dm, edgelabel));
23263ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
23270510c589SMatthew G. Knepley }
23280510c589SMatthew G. Knepley 
232924119c2aSMatthew G. Knepley /*@
23309318fe57SMatthew G. Knepley   DMPlexCreateHexCylinderMesh - Creates a mesh on the tensor product of the unit interval with the circle (cylinder) using hexahedra.
233124119c2aSMatthew G. Knepley 
2332d083f849SBarry Smith   Collective
233324119c2aSMatthew G. Knepley 
233424119c2aSMatthew G. Knepley   Input Parameters:
2335a1cb98faSBarry Smith + comm      - The communicator for the `DM` object
233649704ca5SMatthew G. Knepley . periodicZ - The boundary type for the Z direction
233749704ca5SMatthew G. Knepley - Nr        - The number of refinements to carry out
233824119c2aSMatthew G. Knepley 
233924119c2aSMatthew G. Knepley   Output Parameter:
234020f4b53cSBarry Smith . dm - The `DM` object
234124119c2aSMatthew G. Knepley 
234224119c2aSMatthew G. Knepley   Level: beginner
234324119c2aSMatthew G. Knepley 
2344a1cb98faSBarry Smith   Note:
2345a4e35b19SJacob Faibussowitsch   Here is the output numbering looking from the bottom of the cylinder\:
2346a1cb98faSBarry Smith .vb
2347a1cb98faSBarry Smith        17-----14
2348a1cb98faSBarry Smith         |     |
2349a1cb98faSBarry Smith         |  2  |
2350a1cb98faSBarry Smith         |     |
2351a1cb98faSBarry Smith  17-----8-----7-----14
2352a1cb98faSBarry Smith   |     |     |     |
2353a1cb98faSBarry Smith   |  3  |  0  |  1  |
2354a1cb98faSBarry Smith   |     |     |     |
2355a1cb98faSBarry Smith  19-----5-----6-----13
2356a1cb98faSBarry Smith         |     |
2357a1cb98faSBarry Smith         |  4  |
2358a1cb98faSBarry Smith         |     |
2359a1cb98faSBarry Smith        19-----13
2360a1cb98faSBarry Smith 
2361a1cb98faSBarry Smith  and up through the top
2362a1cb98faSBarry Smith 
2363a1cb98faSBarry Smith        18-----16
2364a1cb98faSBarry Smith         |     |
2365a1cb98faSBarry Smith         |  2  |
2366a1cb98faSBarry Smith         |     |
2367a1cb98faSBarry Smith  18----10----11-----16
2368a1cb98faSBarry Smith   |     |     |     |
2369a1cb98faSBarry Smith   |  3  |  0  |  1  |
2370a1cb98faSBarry Smith   |     |     |     |
2371a1cb98faSBarry Smith  20-----9----12-----15
2372a1cb98faSBarry Smith         |     |
2373a1cb98faSBarry Smith         |  4  |
2374a1cb98faSBarry Smith         |     |
2375a1cb98faSBarry Smith        20-----15
2376a1cb98faSBarry Smith .ve
2377a1cb98faSBarry Smith 
23781cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
237924119c2aSMatthew G. Knepley @*/
238049704ca5SMatthew G. Knepley PetscErrorCode DMPlexCreateHexCylinderMesh(MPI_Comm comm, DMBoundaryType periodicZ, PetscInt Nr, DM *dm)
2381d71ae5a4SJacob Faibussowitsch {
23829318fe57SMatthew G. Knepley   PetscFunctionBegin;
238349704ca5SMatthew G. Knepley   PetscAssertPointer(dm, 4);
23849566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
23859566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
238649704ca5SMatthew G. Knepley   PetscCall(DMPlexCreateHexCylinderMesh_Internal(*dm, periodicZ, Nr));
23873ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
23889318fe57SMatthew G. Knepley }
23899318fe57SMatthew G. Knepley 
2390d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateWedgeCylinderMesh_Internal(DM dm, PetscInt n, PetscBool interpolate)
2391d71ae5a4SJacob Faibussowitsch {
239224119c2aSMatthew G. Knepley   const PetscInt dim = 3;
2393412e9a14SMatthew G. Knepley   PetscInt       numCells, numVertices, v;
23949fe9f049SMatthew G. Knepley   PetscMPIInt    rank;
239524119c2aSMatthew G. Knepley 
239624119c2aSMatthew G. Knepley   PetscFunctionBegin;
239763a3b9bcSJacob Faibussowitsch   PetscCheck(n >= 0, PetscObjectComm((PetscObject)dm), PETSC_ERR_ARG_OUTOFRANGE, "Number of wedges %" PetscInt_FMT " cannot be negative", n);
239846139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
23999566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
24009566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
2401412e9a14SMatthew G. Knepley   /* Must create the celltype label here so that we do not automatically try to compute the types */
24029566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "celltype"));
240324119c2aSMatthew G. Knepley   /* Create topology */
240424119c2aSMatthew G. Knepley   {
240524119c2aSMatthew G. Knepley     PetscInt cone[6], c;
240624119c2aSMatthew G. Knepley 
2407dd400576SPatrick Sanan     numCells    = rank == 0 ? n : 0;
2408dd400576SPatrick Sanan     numVertices = rank == 0 ? 2 * (n + 1) : 0;
24099566063dSJacob Faibussowitsch     PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
24109566063dSJacob Faibussowitsch     for (c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 6));
24119566063dSJacob Faibussowitsch     PetscCall(DMSetUp(dm));
241224119c2aSMatthew G. Knepley     for (c = 0; c < numCells; c++) {
24139371c9d4SSatish Balay       cone[0] = c + n * 1;
24149371c9d4SSatish Balay       cone[1] = (c + 1) % n + n * 1;
24159371c9d4SSatish Balay       cone[2] = 0 + 3 * n;
24169371c9d4SSatish Balay       cone[3] = c + n * 2;
24179371c9d4SSatish Balay       cone[4] = (c + 1) % n + n * 2;
24189371c9d4SSatish Balay       cone[5] = 1 + 3 * n;
24199566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCone(dm, c, cone));
24209566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCellType(dm, c, DM_POLYTOPE_TRI_PRISM_TENSOR));
242124119c2aSMatthew G. Knepley     }
24229566063dSJacob Faibussowitsch     PetscCall(DMPlexSymmetrize(dm));
24239566063dSJacob Faibussowitsch     PetscCall(DMPlexStratify(dm));
242424119c2aSMatthew G. Knepley   }
242548a46eb9SPierre Jolivet   for (v = numCells; v < numCells + numVertices; ++v) PetscCall(DMPlexSetCellType(dm, v, DM_POLYTOPE_POINT));
242624119c2aSMatthew G. Knepley   /* Create cylinder geometry */
242724119c2aSMatthew G. Knepley   {
242824119c2aSMatthew G. Knepley     Vec          coordinates;
242924119c2aSMatthew G. Knepley     PetscSection coordSection;
243024119c2aSMatthew G. Knepley     PetscScalar *coords;
2431412e9a14SMatthew G. Knepley     PetscInt     coordSize, c;
243224119c2aSMatthew G. Knepley 
243324119c2aSMatthew G. Knepley     /* Build coordinates */
24349566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &coordSection));
24359566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetNumFields(coordSection, 1));
24369566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dim));
24379566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetChart(coordSection, numCells, numCells + numVertices));
243824119c2aSMatthew G. Knepley     for (v = numCells; v < numCells + numVertices; ++v) {
24399566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetDof(coordSection, v, dim));
24409566063dSJacob Faibussowitsch       PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dim));
244124119c2aSMatthew G. Knepley     }
24429566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetUp(coordSection));
24439566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
24449566063dSJacob Faibussowitsch     PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
24459566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
24469566063dSJacob Faibussowitsch     PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
24479566063dSJacob Faibussowitsch     PetscCall(VecSetBlockSize(coordinates, dim));
24489566063dSJacob Faibussowitsch     PetscCall(VecSetType(coordinates, VECSTANDARD));
24499566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
245024119c2aSMatthew G. Knepley     for (c = 0; c < numCells; c++) {
24519371c9d4SSatish Balay       coords[(c + 0 * n) * dim + 0] = PetscCosReal(2.0 * c * PETSC_PI / n);
24529371c9d4SSatish Balay       coords[(c + 0 * n) * dim + 1] = PetscSinReal(2.0 * c * PETSC_PI / n);
24539371c9d4SSatish Balay       coords[(c + 0 * n) * dim + 2] = 1.0;
24549371c9d4SSatish Balay       coords[(c + 1 * n) * dim + 0] = PetscCosReal(2.0 * c * PETSC_PI / n);
24559371c9d4SSatish Balay       coords[(c + 1 * n) * dim + 1] = PetscSinReal(2.0 * c * PETSC_PI / n);
24569371c9d4SSatish Balay       coords[(c + 1 * n) * dim + 2] = 0.0;
245724119c2aSMatthew G. Knepley     }
2458dd400576SPatrick Sanan     if (rank == 0) {
24599371c9d4SSatish Balay       coords[(2 * n + 0) * dim + 0] = 0.0;
24609371c9d4SSatish Balay       coords[(2 * n + 0) * dim + 1] = 0.0;
24619371c9d4SSatish Balay       coords[(2 * n + 0) * dim + 2] = 1.0;
24629371c9d4SSatish Balay       coords[(2 * n + 1) * dim + 0] = 0.0;
24639371c9d4SSatish Balay       coords[(2 * n + 1) * dim + 1] = 0.0;
24649371c9d4SSatish Balay       coords[(2 * n + 1) * dim + 2] = 0.0;
24659fe9f049SMatthew G. Knepley     }
24669566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(coordinates, &coords));
24679566063dSJacob Faibussowitsch     PetscCall(DMSetCoordinatesLocal(dm, coordinates));
24689566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&coordinates));
246924119c2aSMatthew G. Knepley   }
247046139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
24719318fe57SMatthew G. Knepley   /* Interpolate */
24729566063dSJacob Faibussowitsch   if (interpolate) PetscCall(DMPlexInterpolateInPlace_Internal(dm));
24733ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
24749318fe57SMatthew G. Knepley }
24759318fe57SMatthew G. Knepley 
24769318fe57SMatthew G. Knepley /*@
24779318fe57SMatthew G. Knepley   DMPlexCreateWedgeCylinderMesh - Creates a mesh on the tensor product of the unit interval with the circle (cylinder) using wedges.
24789318fe57SMatthew G. Knepley 
24799318fe57SMatthew G. Knepley   Collective
24809318fe57SMatthew G. Knepley 
24819318fe57SMatthew G. Knepley   Input Parameters:
2482a1cb98faSBarry Smith + comm        - The communicator for the `DM` object
24839318fe57SMatthew G. Knepley . n           - The number of wedges around the origin
24849318fe57SMatthew G. Knepley - interpolate - Create edges and faces
24859318fe57SMatthew G. Knepley 
24869318fe57SMatthew G. Knepley   Output Parameter:
2487a1cb98faSBarry Smith . dm - The `DM` object
24889318fe57SMatthew G. Knepley 
24899318fe57SMatthew G. Knepley   Level: beginner
24909318fe57SMatthew G. Knepley 
24911cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateHexCylinderMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
24929318fe57SMatthew G. Knepley @*/
2493d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateWedgeCylinderMesh(MPI_Comm comm, PetscInt n, PetscBool interpolate, DM *dm)
2494d71ae5a4SJacob Faibussowitsch {
24959318fe57SMatthew G. Knepley   PetscFunctionBegin;
24964f572ea9SToby Isaac   PetscAssertPointer(dm, 4);
24979566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
24989566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
24999566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateWedgeCylinderMesh_Internal(*dm, n, interpolate));
25003ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
250124119c2aSMatthew G. Knepley }
250224119c2aSMatthew G. Knepley 
2503d71ae5a4SJacob Faibussowitsch static inline PetscReal DiffNormReal(PetscInt dim, const PetscReal x[], const PetscReal y[])
2504d71ae5a4SJacob Faibussowitsch {
250565a81367SMatthew G. Knepley   PetscReal prod = 0.0;
250665a81367SMatthew G. Knepley   PetscInt  i;
250765a81367SMatthew G. Knepley   for (i = 0; i < dim; ++i) prod += PetscSqr(x[i] - y[i]);
250865a81367SMatthew G. Knepley   return PetscSqrtReal(prod);
250965a81367SMatthew G. Knepley }
2510dd2b43ebSStefano Zampini 
2511d71ae5a4SJacob Faibussowitsch static inline PetscReal DotReal(PetscInt dim, const PetscReal x[], const PetscReal y[])
2512d71ae5a4SJacob Faibussowitsch {
251365a81367SMatthew G. Knepley   PetscReal prod = 0.0;
251465a81367SMatthew G. Knepley   PetscInt  i;
251565a81367SMatthew G. Knepley   for (i = 0; i < dim; ++i) prod += x[i] * y[i];
251665a81367SMatthew G. Knepley   return prod;
251765a81367SMatthew G. Knepley }
251865a81367SMatthew G. Knepley 
251951a74b61SMatthew G. Knepley /* The first constant is the sphere radius */
2520d71ae5a4SJacob 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[])
2521d71ae5a4SJacob Faibussowitsch {
252251a74b61SMatthew G. Knepley   PetscReal r     = PetscRealPart(constants[0]);
252351a74b61SMatthew G. Knepley   PetscReal norm2 = 0.0, fac;
252451a74b61SMatthew G. Knepley   PetscInt  n     = uOff[1] - uOff[0], d;
252551a74b61SMatthew G. Knepley 
252651a74b61SMatthew G. Knepley   for (d = 0; d < n; ++d) norm2 += PetscSqr(PetscRealPart(u[d]));
252751a74b61SMatthew G. Knepley   fac = r / PetscSqrtReal(norm2);
252851a74b61SMatthew G. Knepley   for (d = 0; d < n; ++d) f0[d] = u[d] * fac;
252951a74b61SMatthew G. Knepley }
253051a74b61SMatthew G. Knepley 
2531d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateSphereMesh_Internal(DM dm, PetscInt dim, PetscBool simplex, PetscReal R)
2532d71ae5a4SJacob Faibussowitsch {
253365a81367SMatthew G. Knepley   const PetscInt embedDim = dim + 1;
253465a81367SMatthew G. Knepley   PetscSection   coordSection;
253565a81367SMatthew G. Knepley   Vec            coordinates;
253665a81367SMatthew G. Knepley   PetscScalar   *coords;
253765a81367SMatthew G. Knepley   PetscReal     *coordsIn;
253807c565c5SJose E. Roman   PetscInt       numCells, numEdges, numVerts = 0, firstVertex = 0, v, firstEdge, coordSize, d, e;
253965a81367SMatthew G. Knepley   PetscMPIInt    rank;
254065a81367SMatthew G. Knepley 
254165a81367SMatthew G. Knepley   PetscFunctionBegin;
25429318fe57SMatthew G. Knepley   PetscValidLogicalCollectiveBool(dm, simplex, 3);
254346139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
25449566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, dim));
25459566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, dim + 1));
25469566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
254765a81367SMatthew G. Knepley   switch (dim) {
25485c344501SMatthew G. Knepley   case 1:
25495c344501SMatthew G. Knepley     numCells = 16;
25505c344501SMatthew G. Knepley     numVerts = numCells;
25515c344501SMatthew G. Knepley 
25525c344501SMatthew G. Knepley     // Build Topology
25535c344501SMatthew G. Knepley     PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
25545c344501SMatthew G. Knepley     for (PetscInt c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
25555c344501SMatthew G. Knepley     PetscCall(DMSetUp(dm));
25565c344501SMatthew G. Knepley     for (PetscInt c = 0; c < numCells; ++c) {
25575c344501SMatthew G. Knepley       PetscInt cone[2];
25585c344501SMatthew G. Knepley 
25595c344501SMatthew G. Knepley       cone[0] = c + numCells;
25605c344501SMatthew G. Knepley       cone[1] = (c + 1) % numVerts + numCells;
25615c344501SMatthew G. Knepley       PetscCall(DMPlexSetCone(dm, c, cone));
25625c344501SMatthew G. Knepley     }
25635c344501SMatthew G. Knepley     PetscCall(DMPlexSymmetrize(dm));
25645c344501SMatthew G. Knepley     PetscCall(DMPlexStratify(dm));
25655c344501SMatthew G. Knepley     PetscCall(PetscMalloc1(numVerts * embedDim, &coordsIn));
25665c344501SMatthew G. Knepley     for (PetscInt v = 0; v < numVerts; ++v) {
25675c344501SMatthew G. Knepley       const PetscReal rad = 2. * PETSC_PI * v / numVerts;
25685c344501SMatthew G. Knepley 
25695c344501SMatthew G. Knepley       coordsIn[v * embedDim + 0] = PetscCosReal(rad);
25705c344501SMatthew G. Knepley       coordsIn[v * embedDim + 1] = PetscSinReal(rad);
25715c344501SMatthew G. Knepley     }
25725c344501SMatthew G. Knepley     break;
257365a81367SMatthew G. Knepley   case 2:
257465a81367SMatthew G. Knepley     if (simplex) {
257551a74b61SMatthew G. Knepley       const PetscReal radius    = PetscSqrtReal(1 + PETSC_PHI * PETSC_PHI) / (1.0 + PETSC_PHI);
257651a74b61SMatthew G. Knepley       const PetscReal edgeLen   = 2.0 / (1.0 + PETSC_PHI) * (R / radius);
257765a81367SMatthew G. Knepley       const PetscInt  degree    = 5;
257851a74b61SMatthew G. Knepley       PetscReal       vertex[3] = {0.0, 1.0 / (1.0 + PETSC_PHI), PETSC_PHI / (1.0 + PETSC_PHI)};
257965a81367SMatthew G. Knepley       PetscInt        s[3]      = {1, 1, 1};
258065a81367SMatthew G. Knepley       PetscInt        cone[3];
258107c565c5SJose E. Roman       PetscInt       *graph;
258265a81367SMatthew G. Knepley 
25839371c9d4SSatish Balay       vertex[0] *= R / radius;
25849371c9d4SSatish Balay       vertex[1] *= R / radius;
25859371c9d4SSatish Balay       vertex[2] *= R / radius;
2586dd400576SPatrick Sanan       numCells    = rank == 0 ? 20 : 0;
2587dd400576SPatrick Sanan       numVerts    = rank == 0 ? 12 : 0;
258865a81367SMatthew G. Knepley       firstVertex = numCells;
258951a74b61SMatthew G. Knepley       /* Use icosahedron, which for a R-sphere has coordinates which are all cyclic permutations of
259065a81367SMatthew G. Knepley 
259165a81367SMatthew G. Knepley            (0, \pm 1/\phi+1, \pm \phi/\phi+1)
259265a81367SMatthew G. Knepley 
259365a81367SMatthew G. Knepley          where \phi^2 - \phi - 1 = 0, meaning \phi is the golden ratio \frac{1 + \sqrt{5}}{2}. The edge
259451a74b61SMatthew G. Knepley          length is then given by 2/(1+\phi) = 2 * 0.38197 = 0.76393.
259565a81367SMatthew G. Knepley       */
259665a81367SMatthew G. Knepley       /* Construct vertices */
25979566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2598dd400576SPatrick Sanan       if (rank == 0) {
259907c565c5SJose E. Roman         for (PetscInt p = 0, i = 0; p < embedDim; ++p) {
260065a81367SMatthew G. Knepley           for (s[1] = -1; s[1] < 2; s[1] += 2) {
260165a81367SMatthew G. Knepley             for (s[2] = -1; s[2] < 2; s[2] += 2) {
260265a81367SMatthew G. Knepley               for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[(d + p) % embedDim] * vertex[(d + p) % embedDim];
260365a81367SMatthew G. Knepley               ++i;
260465a81367SMatthew G. Knepley             }
260565a81367SMatthew G. Knepley           }
260665a81367SMatthew G. Knepley         }
260745da822fSValeria Barra       }
260865a81367SMatthew G. Knepley       /* Construct graph */
26099566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * numVerts, &graph));
261007c565c5SJose E. Roman       for (PetscInt i = 0; i < numVerts; ++i) {
261107c565c5SJose E. Roman         PetscInt k = 0;
261207c565c5SJose E. Roman         for (PetscInt j = 0; j < numVerts; ++j) {
26139371c9d4SSatish Balay           if (PetscAbsReal(DiffNormReal(embedDim, &coordsIn[i * embedDim], &coordsIn[j * embedDim]) - edgeLen) < PETSC_SMALL) {
26149371c9d4SSatish Balay             graph[i * numVerts + j] = 1;
26159371c9d4SSatish Balay             ++k;
26169371c9d4SSatish Balay           }
261765a81367SMatthew G. Knepley         }
261863a3b9bcSJacob Faibussowitsch         PetscCheck(k == degree, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid icosahedron, vertex %" PetscInt_FMT " degree %" PetscInt_FMT " != %" PetscInt_FMT, i, k, degree);
261965a81367SMatthew G. Knepley       }
262065a81367SMatthew G. Knepley       /* Build Topology */
26219566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
262207c565c5SJose E. Roman       for (PetscInt c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
26239566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
262465a81367SMatthew G. Knepley       /* Cells */
262507c565c5SJose E. Roman       for (PetscInt i = 0, c = 0; i < numVerts; ++i) {
262607c565c5SJose E. Roman         for (PetscInt j = 0; j < i; ++j) {
262707c565c5SJose E. Roman           for (PetscInt k = 0; k < j; ++k) {
262865a81367SMatthew G. Knepley             if (graph[i * numVerts + j] && graph[j * numVerts + k] && graph[k * numVerts + i]) {
26299371c9d4SSatish Balay               cone[0] = firstVertex + i;
26309371c9d4SSatish Balay               cone[1] = firstVertex + j;
26319371c9d4SSatish Balay               cone[2] = firstVertex + k;
263265a81367SMatthew G. Knepley               /* Check orientation */
263365a81367SMatthew G. Knepley               {
26349371c9d4SSatish Balay                 const PetscInt epsilon[3][3][3] = {
26359371c9d4SSatish Balay                   {{0, 0, 0},  {0, 0, 1},  {0, -1, 0}},
26369371c9d4SSatish Balay                   {{0, 0, -1}, {0, 0, 0},  {1, 0, 0} },
26379371c9d4SSatish Balay                   {{0, 1, 0},  {-1, 0, 0}, {0, 0, 0} }
26389371c9d4SSatish Balay                 };
263965a81367SMatthew G. Knepley                 PetscReal normal[3];
264065a81367SMatthew G. Knepley                 PetscInt  e, f;
264165a81367SMatthew G. Knepley 
264265a81367SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) {
264365a81367SMatthew G. Knepley                   normal[d] = 0.0;
264465a81367SMatthew G. Knepley                   for (e = 0; e < embedDim; ++e) {
2645ad540459SPierre 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]);
264665a81367SMatthew G. Knepley                   }
264765a81367SMatthew G. Knepley                 }
26489371c9d4SSatish Balay                 if (DotReal(embedDim, normal, &coordsIn[i * embedDim]) < 0) {
26499371c9d4SSatish Balay                   PetscInt tmp = cone[1];
26509371c9d4SSatish Balay                   cone[1]      = cone[2];
26519371c9d4SSatish Balay                   cone[2]      = tmp;
265265a81367SMatthew G. Knepley                 }
265365a81367SMatthew G. Knepley               }
26549566063dSJacob Faibussowitsch               PetscCall(DMPlexSetCone(dm, c++, cone));
265565a81367SMatthew G. Knepley             }
265665a81367SMatthew G. Knepley           }
265765a81367SMatthew G. Knepley         }
265865a81367SMatthew G. Knepley       }
26599566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
26609566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
26619566063dSJacob Faibussowitsch       PetscCall(PetscFree(graph));
266265a81367SMatthew G. Knepley     } else {
26632829fed8SMatthew G. Knepley       /*
26642829fed8SMatthew G. Knepley         12-21--13
26652829fed8SMatthew G. Knepley          |     |
26662829fed8SMatthew G. Knepley         25  4  24
26672829fed8SMatthew G. Knepley          |     |
26682829fed8SMatthew G. Knepley   12-25--9-16--8-24--13
26692829fed8SMatthew G. Knepley    |     |     |     |
26702829fed8SMatthew G. Knepley   23  5 17  0 15  3  22
26712829fed8SMatthew G. Knepley    |     |     |     |
26722829fed8SMatthew G. Knepley   10-20--6-14--7-19--11
26732829fed8SMatthew G. Knepley          |     |
26742829fed8SMatthew G. Knepley         20  1  19
26752829fed8SMatthew G. Knepley          |     |
26762829fed8SMatthew G. Knepley         10-18--11
26772829fed8SMatthew G. Knepley          |     |
26782829fed8SMatthew G. Knepley         23  2  22
26792829fed8SMatthew G. Knepley          |     |
26802829fed8SMatthew G. Knepley         12-21--13
26812829fed8SMatthew G. Knepley        */
26822829fed8SMatthew G. Knepley       PetscInt cone[4], ornt[4];
26832829fed8SMatthew G. Knepley 
2684dd400576SPatrick Sanan       numCells    = rank == 0 ? 6 : 0;
2685dd400576SPatrick Sanan       numEdges    = rank == 0 ? 12 : 0;
2686dd400576SPatrick Sanan       numVerts    = rank == 0 ? 8 : 0;
268765a81367SMatthew G. Knepley       firstVertex = numCells;
268865a81367SMatthew G. Knepley       firstEdge   = numCells + numVerts;
26892829fed8SMatthew G. Knepley       /* Build Topology */
26909566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numEdges + numVerts));
269107c565c5SJose E. Roman       for (PetscInt c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, 4));
269248a46eb9SPierre Jolivet       for (e = firstEdge; e < firstEdge + numEdges; ++e) PetscCall(DMPlexSetConeSize(dm, e, 2));
26939566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
2694dd400576SPatrick Sanan       if (rank == 0) {
26952829fed8SMatthew G. Knepley         /* Cell 0 */
26969371c9d4SSatish Balay         cone[0] = 14;
26979371c9d4SSatish Balay         cone[1] = 15;
26989371c9d4SSatish Balay         cone[2] = 16;
26999371c9d4SSatish Balay         cone[3] = 17;
27009566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 0, cone));
27019371c9d4SSatish Balay         ornt[0] = 0;
27029371c9d4SSatish Balay         ornt[1] = 0;
27039371c9d4SSatish Balay         ornt[2] = 0;
27049371c9d4SSatish Balay         ornt[3] = 0;
27059566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 0, ornt));
27062829fed8SMatthew G. Knepley         /* Cell 1 */
27079371c9d4SSatish Balay         cone[0] = 18;
27089371c9d4SSatish Balay         cone[1] = 19;
27099371c9d4SSatish Balay         cone[2] = 14;
27109371c9d4SSatish Balay         cone[3] = 20;
27119566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 1, cone));
27129371c9d4SSatish Balay         ornt[0] = 0;
27139371c9d4SSatish Balay         ornt[1] = 0;
27149371c9d4SSatish Balay         ornt[2] = -1;
27159371c9d4SSatish Balay         ornt[3] = 0;
27169566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 1, ornt));
27172829fed8SMatthew G. Knepley         /* Cell 2 */
27189371c9d4SSatish Balay         cone[0] = 21;
27199371c9d4SSatish Balay         cone[1] = 22;
27209371c9d4SSatish Balay         cone[2] = 18;
27219371c9d4SSatish Balay         cone[3] = 23;
27229566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 2, cone));
27239371c9d4SSatish Balay         ornt[0] = 0;
27249371c9d4SSatish Balay         ornt[1] = 0;
27259371c9d4SSatish Balay         ornt[2] = -1;
27269371c9d4SSatish Balay         ornt[3] = 0;
27279566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 2, ornt));
27282829fed8SMatthew G. Knepley         /* Cell 3 */
27299371c9d4SSatish Balay         cone[0] = 19;
27309371c9d4SSatish Balay         cone[1] = 22;
27319371c9d4SSatish Balay         cone[2] = 24;
27329371c9d4SSatish Balay         cone[3] = 15;
27339566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 3, cone));
27349371c9d4SSatish Balay         ornt[0] = -1;
27359371c9d4SSatish Balay         ornt[1] = -1;
27369371c9d4SSatish Balay         ornt[2] = 0;
27379371c9d4SSatish Balay         ornt[3] = -1;
27389566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 3, ornt));
27392829fed8SMatthew G. Knepley         /* Cell 4 */
27409371c9d4SSatish Balay         cone[0] = 16;
27419371c9d4SSatish Balay         cone[1] = 24;
27429371c9d4SSatish Balay         cone[2] = 21;
27439371c9d4SSatish Balay         cone[3] = 25;
27449566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 4, cone));
27459371c9d4SSatish Balay         ornt[0] = -1;
27469371c9d4SSatish Balay         ornt[1] = -1;
27479371c9d4SSatish Balay         ornt[2] = -1;
27489371c9d4SSatish Balay         ornt[3] = 0;
27499566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 4, ornt));
27502829fed8SMatthew G. Knepley         /* Cell 5 */
27519371c9d4SSatish Balay         cone[0] = 20;
27529371c9d4SSatish Balay         cone[1] = 17;
27539371c9d4SSatish Balay         cone[2] = 25;
27549371c9d4SSatish Balay         cone[3] = 23;
27559566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 5, cone));
27569371c9d4SSatish Balay         ornt[0] = -1;
27579371c9d4SSatish Balay         ornt[1] = -1;
27589371c9d4SSatish Balay         ornt[2] = -1;
27599371c9d4SSatish Balay         ornt[3] = -1;
27609566063dSJacob Faibussowitsch         PetscCall(DMPlexSetConeOrientation(dm, 5, ornt));
27612829fed8SMatthew G. Knepley         /* Edges */
27629371c9d4SSatish Balay         cone[0] = 6;
27639371c9d4SSatish Balay         cone[1] = 7;
27649566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 14, cone));
27659371c9d4SSatish Balay         cone[0] = 7;
27669371c9d4SSatish Balay         cone[1] = 8;
27679566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 15, cone));
27689371c9d4SSatish Balay         cone[0] = 8;
27699371c9d4SSatish Balay         cone[1] = 9;
27709566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 16, cone));
27719371c9d4SSatish Balay         cone[0] = 9;
27729371c9d4SSatish Balay         cone[1] = 6;
27739566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 17, cone));
27749371c9d4SSatish Balay         cone[0] = 10;
27759371c9d4SSatish Balay         cone[1] = 11;
27769566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 18, cone));
27779371c9d4SSatish Balay         cone[0] = 11;
27789371c9d4SSatish Balay         cone[1] = 7;
27799566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 19, cone));
27809371c9d4SSatish Balay         cone[0] = 6;
27819371c9d4SSatish Balay         cone[1] = 10;
27829566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 20, cone));
27839371c9d4SSatish Balay         cone[0] = 12;
27849371c9d4SSatish Balay         cone[1] = 13;
27859566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 21, cone));
27869371c9d4SSatish Balay         cone[0] = 13;
27879371c9d4SSatish Balay         cone[1] = 11;
27889566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 22, cone));
27899371c9d4SSatish Balay         cone[0] = 10;
27909371c9d4SSatish Balay         cone[1] = 12;
27919566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 23, cone));
27929371c9d4SSatish Balay         cone[0] = 13;
27939371c9d4SSatish Balay         cone[1] = 8;
27949566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 24, cone));
27959371c9d4SSatish Balay         cone[0] = 12;
27969371c9d4SSatish Balay         cone[1] = 9;
27979566063dSJacob Faibussowitsch         PetscCall(DMPlexSetCone(dm, 25, cone));
279845da822fSValeria Barra       }
27999566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
28009566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
28012829fed8SMatthew G. Knepley       /* Build coordinates */
28029566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2803dd400576SPatrick Sanan       if (rank == 0) {
28049371c9d4SSatish Balay         coordsIn[0 * embedDim + 0] = -R;
28059371c9d4SSatish Balay         coordsIn[0 * embedDim + 1] = R;
28069371c9d4SSatish Balay         coordsIn[0 * embedDim + 2] = -R;
28079371c9d4SSatish Balay         coordsIn[1 * embedDim + 0] = R;
28089371c9d4SSatish Balay         coordsIn[1 * embedDim + 1] = R;
28099371c9d4SSatish Balay         coordsIn[1 * embedDim + 2] = -R;
28109371c9d4SSatish Balay         coordsIn[2 * embedDim + 0] = R;
28119371c9d4SSatish Balay         coordsIn[2 * embedDim + 1] = -R;
28129371c9d4SSatish Balay         coordsIn[2 * embedDim + 2] = -R;
28139371c9d4SSatish Balay         coordsIn[3 * embedDim + 0] = -R;
28149371c9d4SSatish Balay         coordsIn[3 * embedDim + 1] = -R;
28159371c9d4SSatish Balay         coordsIn[3 * embedDim + 2] = -R;
28169371c9d4SSatish Balay         coordsIn[4 * embedDim + 0] = -R;
28179371c9d4SSatish Balay         coordsIn[4 * embedDim + 1] = R;
28189371c9d4SSatish Balay         coordsIn[4 * embedDim + 2] = R;
28199371c9d4SSatish Balay         coordsIn[5 * embedDim + 0] = R;
28209371c9d4SSatish Balay         coordsIn[5 * embedDim + 1] = R;
28219371c9d4SSatish Balay         coordsIn[5 * embedDim + 2] = R;
28229371c9d4SSatish Balay         coordsIn[6 * embedDim + 0] = -R;
28239371c9d4SSatish Balay         coordsIn[6 * embedDim + 1] = -R;
28249371c9d4SSatish Balay         coordsIn[6 * embedDim + 2] = R;
28259371c9d4SSatish Balay         coordsIn[7 * embedDim + 0] = R;
28269371c9d4SSatish Balay         coordsIn[7 * embedDim + 1] = -R;
28279371c9d4SSatish Balay         coordsIn[7 * embedDim + 2] = R;
282865a81367SMatthew G. Knepley       }
282945da822fSValeria Barra     }
283065a81367SMatthew G. Knepley     break;
283165a81367SMatthew G. Knepley   case 3:
2832116ded15SMatthew G. Knepley     if (simplex) {
2833116ded15SMatthew G. Knepley       const PetscReal edgeLen         = 1.0 / PETSC_PHI;
283451a74b61SMatthew G. Knepley       PetscReal       vertexA[4]      = {0.5, 0.5, 0.5, 0.5};
283551a74b61SMatthew G. Knepley       PetscReal       vertexB[4]      = {1.0, 0.0, 0.0, 0.0};
283651a74b61SMatthew G. Knepley       PetscReal       vertexC[4]      = {0.5, 0.5 * PETSC_PHI, 0.5 / PETSC_PHI, 0.0};
2837116ded15SMatthew G. Knepley       const PetscInt  degree          = 12;
2838116ded15SMatthew G. Knepley       PetscInt        s[4]            = {1, 1, 1};
28399371c9d4SSatish Balay       PetscInt        evenPerm[12][4] = {
28409371c9d4SSatish Balay         {0, 1, 2, 3},
28419371c9d4SSatish Balay         {0, 2, 3, 1},
28429371c9d4SSatish Balay         {0, 3, 1, 2},
28439371c9d4SSatish Balay         {1, 0, 3, 2},
28449371c9d4SSatish Balay         {1, 2, 0, 3},
28459371c9d4SSatish Balay         {1, 3, 2, 0},
28469371c9d4SSatish Balay         {2, 0, 1, 3},
28479371c9d4SSatish Balay         {2, 1, 3, 0},
28489371c9d4SSatish Balay         {2, 3, 0, 1},
28499371c9d4SSatish Balay         {3, 0, 2, 1},
28509371c9d4SSatish Balay         {3, 1, 0, 2},
28519371c9d4SSatish Balay         {3, 2, 1, 0}
28529371c9d4SSatish Balay       };
2853116ded15SMatthew G. Knepley       PetscInt  cone[4];
2854116ded15SMatthew G. Knepley       PetscInt *graph, p, i, j, k, l;
2855116ded15SMatthew G. Knepley 
28569371c9d4SSatish Balay       vertexA[0] *= R;
28579371c9d4SSatish Balay       vertexA[1] *= R;
28589371c9d4SSatish Balay       vertexA[2] *= R;
28599371c9d4SSatish Balay       vertexA[3] *= R;
28609371c9d4SSatish Balay       vertexB[0] *= R;
28619371c9d4SSatish Balay       vertexB[1] *= R;
28629371c9d4SSatish Balay       vertexB[2] *= R;
28639371c9d4SSatish Balay       vertexB[3] *= R;
28649371c9d4SSatish Balay       vertexC[0] *= R;
28659371c9d4SSatish Balay       vertexC[1] *= R;
28669371c9d4SSatish Balay       vertexC[2] *= R;
28679371c9d4SSatish Balay       vertexC[3] *= R;
2868dd400576SPatrick Sanan       numCells    = rank == 0 ? 600 : 0;
2869dd400576SPatrick Sanan       numVerts    = rank == 0 ? 120 : 0;
2870116ded15SMatthew G. Knepley       firstVertex = numCells;
2871116ded15SMatthew G. Knepley       /* Use the 600-cell, which for a unit sphere has coordinates which are
2872116ded15SMatthew G. Knepley 
2873116ded15SMatthew G. Knepley            1/2 (\pm 1, \pm 1,    \pm 1, \pm 1)                          16
2874116ded15SMatthew G. Knepley                (\pm 1,    0,       0,      0)  all cyclic permutations   8
2875116ded15SMatthew G. Knepley            1/2 (\pm 1, \pm phi, \pm 1/phi, 0)  all even permutations    96
2876116ded15SMatthew G. Knepley 
2877116ded15SMatthew G. Knepley          where \phi^2 - \phi - 1 = 0, meaning \phi is the golden ratio \frac{1 + \sqrt{5}}{2}. The edge
28786333ae4fSvaleriabarra          length is then given by 1/\phi = 0.61803.
2879116ded15SMatthew G. Knepley 
2880116ded15SMatthew G. Knepley          http://buzzard.pugetsound.edu/sage-practice/ch03s03.html
2881116ded15SMatthew G. Knepley          http://mathworld.wolfram.com/600-Cell.html
2882116ded15SMatthew G. Knepley       */
2883116ded15SMatthew G. Knepley       /* Construct vertices */
28849566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * embedDim, &coordsIn));
2885116ded15SMatthew G. Knepley       i = 0;
2886dd400576SPatrick Sanan       if (rank == 0) {
2887116ded15SMatthew G. Knepley         for (s[0] = -1; s[0] < 2; s[0] += 2) {
2888116ded15SMatthew G. Knepley           for (s[1] = -1; s[1] < 2; s[1] += 2) {
2889116ded15SMatthew G. Knepley             for (s[2] = -1; s[2] < 2; s[2] += 2) {
2890116ded15SMatthew G. Knepley               for (s[3] = -1; s[3] < 2; s[3] += 2) {
2891116ded15SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[d] * vertexA[d];
2892116ded15SMatthew G. Knepley                 ++i;
2893116ded15SMatthew G. Knepley               }
2894116ded15SMatthew G. Knepley             }
2895116ded15SMatthew G. Knepley           }
2896116ded15SMatthew G. Knepley         }
2897116ded15SMatthew G. Knepley         for (p = 0; p < embedDim; ++p) {
2898116ded15SMatthew G. Knepley           s[1] = s[2] = s[3] = 1;
2899116ded15SMatthew G. Knepley           for (s[0] = -1; s[0] < 2; s[0] += 2) {
2900116ded15SMatthew G. Knepley             for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[(d + p) % embedDim] * vertexB[(d + p) % embedDim];
2901116ded15SMatthew G. Knepley             ++i;
2902116ded15SMatthew G. Knepley           }
2903116ded15SMatthew G. Knepley         }
2904116ded15SMatthew G. Knepley         for (p = 0; p < 12; ++p) {
2905116ded15SMatthew G. Knepley           s[3] = 1;
2906116ded15SMatthew G. Knepley           for (s[0] = -1; s[0] < 2; s[0] += 2) {
2907116ded15SMatthew G. Knepley             for (s[1] = -1; s[1] < 2; s[1] += 2) {
2908116ded15SMatthew G. Knepley               for (s[2] = -1; s[2] < 2; s[2] += 2) {
2909116ded15SMatthew G. Knepley                 for (d = 0; d < embedDim; ++d) coordsIn[i * embedDim + d] = s[evenPerm[p][d]] * vertexC[evenPerm[p][d]];
2910116ded15SMatthew G. Knepley                 ++i;
2911116ded15SMatthew G. Knepley               }
2912116ded15SMatthew G. Knepley             }
2913116ded15SMatthew G. Knepley           }
2914116ded15SMatthew G. Knepley         }
291545da822fSValeria Barra       }
291663a3b9bcSJacob Faibussowitsch       PetscCheck(i == numVerts, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid 600-cell, vertices %" PetscInt_FMT " != %" PetscInt_FMT, i, numVerts);
2917116ded15SMatthew G. Knepley       /* Construct graph */
29189566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numVerts * numVerts, &graph));
2919116ded15SMatthew G. Knepley       for (i = 0; i < numVerts; ++i) {
2920116ded15SMatthew G. Knepley         for (j = 0, k = 0; j < numVerts; ++j) {
29219371c9d4SSatish Balay           if (PetscAbsReal(DiffNormReal(embedDim, &coordsIn[i * embedDim], &coordsIn[j * embedDim]) - edgeLen) < PETSC_SMALL) {
29229371c9d4SSatish Balay             graph[i * numVerts + j] = 1;
29239371c9d4SSatish Balay             ++k;
29249371c9d4SSatish Balay           }
2925116ded15SMatthew G. Knepley         }
292663a3b9bcSJacob Faibussowitsch         PetscCheck(k == degree, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Invalid 600-cell, vertex %" PetscInt_FMT " degree %" PetscInt_FMT " != %" PetscInt_FMT, i, k, degree);
2927116ded15SMatthew G. Knepley       }
2928116ded15SMatthew G. Knepley       /* Build Topology */
29299566063dSJacob Faibussowitsch       PetscCall(DMPlexSetChart(dm, 0, numCells + numVerts));
293007c565c5SJose E. Roman       for (PetscInt c = 0; c < numCells; c++) PetscCall(DMPlexSetConeSize(dm, c, embedDim));
29319566063dSJacob Faibussowitsch       PetscCall(DMSetUp(dm)); /* Allocate space for cones */
2932116ded15SMatthew G. Knepley       /* Cells */
2933dd400576SPatrick Sanan       if (rank == 0) {
293407c565c5SJose E. Roman         for (PetscInt i = 0, c = 0; i < numVerts; ++i) {
2935116ded15SMatthew G. Knepley           for (j = 0; j < i; ++j) {
2936116ded15SMatthew G. Knepley             for (k = 0; k < j; ++k) {
2937116ded15SMatthew G. Knepley               for (l = 0; l < k; ++l) {
29389371c9d4SSatish 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]) {
29399371c9d4SSatish Balay                   cone[0] = firstVertex + i;
29409371c9d4SSatish Balay                   cone[1] = firstVertex + j;
29419371c9d4SSatish Balay                   cone[2] = firstVertex + k;
29429371c9d4SSatish Balay                   cone[3] = firstVertex + l;
2943116ded15SMatthew G. Knepley                   /* Check orientation: https://ef.gy/linear-algebra:normal-vectors-in-higher-dimensional-spaces */
2944116ded15SMatthew G. Knepley                   {
29459371c9d4SSatish Balay                     const PetscInt epsilon[4][4][4][4] = {
29469371c9d4SSatish 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}}},
2947116ded15SMatthew G. Knepley 
29489371c9d4SSatish 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}}},
2949116ded15SMatthew G. Knepley 
29509371c9d4SSatish 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}}},
2951116ded15SMatthew G. Knepley 
29529371c9d4SSatish 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}} }
29539371c9d4SSatish Balay                     };
2954116ded15SMatthew G. Knepley                     PetscReal normal[4];
2955116ded15SMatthew G. Knepley                     PetscInt  e, f, g;
2956116ded15SMatthew G. Knepley 
2957116ded15SMatthew G. Knepley                     for (d = 0; d < embedDim; ++d) {
2958116ded15SMatthew G. Knepley                       normal[d] = 0.0;
2959116ded15SMatthew G. Knepley                       for (e = 0; e < embedDim; ++e) {
2960116ded15SMatthew G. Knepley                         for (f = 0; f < embedDim; ++f) {
2961116ded15SMatthew G. Knepley                           for (g = 0; g < embedDim; ++g) {
2962116ded15SMatthew 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]);
2963116ded15SMatthew G. Knepley                           }
2964116ded15SMatthew G. Knepley                         }
2965116ded15SMatthew G. Knepley                       }
2966116ded15SMatthew G. Knepley                     }
29679371c9d4SSatish Balay                     if (DotReal(embedDim, normal, &coordsIn[i * embedDim]) < 0) {
29689371c9d4SSatish Balay                       PetscInt tmp = cone[1];
29699371c9d4SSatish Balay                       cone[1]      = cone[2];
29709371c9d4SSatish Balay                       cone[2]      = tmp;
29719371c9d4SSatish Balay                     }
2972116ded15SMatthew G. Knepley                   }
29739566063dSJacob Faibussowitsch                   PetscCall(DMPlexSetCone(dm, c++, cone));
2974116ded15SMatthew G. Knepley                 }
2975116ded15SMatthew G. Knepley               }
2976116ded15SMatthew G. Knepley             }
2977116ded15SMatthew G. Knepley           }
2978116ded15SMatthew G. Knepley         }
297945da822fSValeria Barra       }
29809566063dSJacob Faibussowitsch       PetscCall(DMPlexSymmetrize(dm));
29819566063dSJacob Faibussowitsch       PetscCall(DMPlexStratify(dm));
29829566063dSJacob Faibussowitsch       PetscCall(PetscFree(graph));
2983116ded15SMatthew G. Knepley     }
2984f4d061e9SPierre Jolivet     break;
2985d71ae5a4SJacob Faibussowitsch   default:
2986d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Unsupported dimension for sphere: %" PetscInt_FMT, dim);
298765a81367SMatthew G. Knepley   }
298865a81367SMatthew G. Knepley   /* Create coordinates */
29899566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
29909566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
29919566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, embedDim));
29929566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numVerts));
29932829fed8SMatthew G. Knepley   for (v = firstVertex; v < firstVertex + numVerts; ++v) {
29949566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, embedDim));
29959566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, embedDim));
29962829fed8SMatthew G. Knepley   }
29979566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
29989566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
29999566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
30009566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, embedDim));
30019566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
30029566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
30039566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
30049566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
30059371c9d4SSatish Balay   for (v = 0; v < numVerts; ++v)
3006ad540459SPierre Jolivet     for (d = 0; d < embedDim; ++d) coords[v * embedDim + d] = coordsIn[v * embedDim + d];
30079566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
30089566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
30099566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
30109566063dSJacob Faibussowitsch   PetscCall(PetscFree(coordsIn));
301151a74b61SMatthew G. Knepley   {
301251a74b61SMatthew G. Knepley     DM          cdm;
301351a74b61SMatthew G. Knepley     PetscDS     cds;
30149318fe57SMatthew G. Knepley     PetscScalar c = R;
301551a74b61SMatthew G. Knepley 
3016e44f6aebSMatthew G. Knepley     PetscCall(DMPlexCreateCoordinateSpace(dm, 1, PETSC_TRUE, snapToSphere));
30179566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
30189566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
30199566063dSJacob Faibussowitsch     PetscCall(PetscDSSetConstants(cds, 1, &c));
302051a74b61SMatthew G. Knepley   }
302146139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
30229318fe57SMatthew G. Knepley   /* Wait for coordinate creation before doing in-place modification */
30239566063dSJacob Faibussowitsch   if (simplex) PetscCall(DMPlexInterpolateInPlace_Internal(dm));
30243ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
30259318fe57SMatthew G. Knepley }
30269318fe57SMatthew G. Knepley 
3027b7f5c055SJed Brown typedef void (*TPSEvaluateFunc)(const PetscReal[], PetscReal *, PetscReal[], PetscReal (*)[3]);
3028b7f5c055SJed Brown 
3029b7f5c055SJed Brown /*
3030b7f5c055SJed Brown  The Schwarz P implicit surface is
3031b7f5c055SJed Brown 
3032b7f5c055SJed Brown      f(x) = cos(x0) + cos(x1) + cos(x2) = 0
3033b7f5c055SJed Brown */
3034d71ae5a4SJacob Faibussowitsch static void TPSEvaluate_SchwarzP(const PetscReal y[3], PetscReal *f, PetscReal grad[], PetscReal (*hess)[3])
3035d71ae5a4SJacob Faibussowitsch {
3036b7f5c055SJed Brown   PetscReal c[3] = {PetscCosReal(y[0] * PETSC_PI), PetscCosReal(y[1] * PETSC_PI), PetscCosReal(y[2] * PETSC_PI)};
3037b7f5c055SJed Brown   PetscReal g[3] = {-PetscSinReal(y[0] * PETSC_PI), -PetscSinReal(y[1] * PETSC_PI), -PetscSinReal(y[2] * PETSC_PI)};
3038b7f5c055SJed Brown   f[0]           = c[0] + c[1] + c[2];
3039b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) {
3040b7f5c055SJed Brown     grad[i] = PETSC_PI * g[i];
3041ad540459SPierre Jolivet     for (PetscInt j = 0; j < 3; j++) hess[i][j] = (i == j) ? -PetscSqr(PETSC_PI) * c[i] : 0.;
3042b7f5c055SJed Brown   }
3043b7f5c055SJed Brown }
3044b7f5c055SJed Brown 
30454663dae6SJed Brown // u[] is a tentative normal on input. Replace with the implicit function gradient in the same direction
3046d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSExtrudeNormalFunc_SchwarzP(PetscInt dim, PetscReal time, const PetscReal x[], PetscInt r, PetscScalar u[], void *ctx)
3047d71ae5a4SJacob Faibussowitsch {
3048ad540459SPierre Jolivet   for (PetscInt i = 0; i < 3; i++) u[i] = -PETSC_PI * PetscSinReal(x[i] * PETSC_PI);
30493ba16761SJacob Faibussowitsch   return PETSC_SUCCESS;
30504663dae6SJed Brown }
30514663dae6SJed Brown 
3052b7f5c055SJed Brown /*
3053b7f5c055SJed Brown  The Gyroid implicit surface is
3054b7f5c055SJed Brown 
3055b7f5c055SJed 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)
3056b7f5c055SJed Brown 
3057b7f5c055SJed Brown */
3058d71ae5a4SJacob Faibussowitsch static void TPSEvaluate_Gyroid(const PetscReal y[3], PetscReal *f, PetscReal grad[], PetscReal (*hess)[3])
3059d71ae5a4SJacob Faibussowitsch {
3060b7f5c055SJed Brown   PetscReal s[3] = {PetscSinReal(PETSC_PI * y[0]), PetscSinReal(PETSC_PI * (y[1] + .5)), PetscSinReal(PETSC_PI * (y[2] + .25))};
3061b7f5c055SJed Brown   PetscReal c[3] = {PetscCosReal(PETSC_PI * y[0]), PetscCosReal(PETSC_PI * (y[1] + .5)), PetscCosReal(PETSC_PI * (y[2] + .25))};
3062b7f5c055SJed Brown   f[0]           = s[0] * c[1] + s[1] * c[2] + s[2] * c[0];
3063b7f5c055SJed Brown   grad[0]        = PETSC_PI * (c[0] * c[1] - s[2] * s[0]);
3064b7f5c055SJed Brown   grad[1]        = PETSC_PI * (c[1] * c[2] - s[0] * s[1]);
3065b7f5c055SJed Brown   grad[2]        = PETSC_PI * (c[2] * c[0] - s[1] * s[2]);
3066b7f5c055SJed Brown   hess[0][0]     = -PetscSqr(PETSC_PI) * (s[0] * c[1] + s[2] * c[0]);
3067b7f5c055SJed Brown   hess[0][1]     = -PetscSqr(PETSC_PI) * (c[0] * s[1]);
3068b7f5c055SJed Brown   hess[0][2]     = -PetscSqr(PETSC_PI) * (c[2] * s[0]);
3069b7f5c055SJed Brown   hess[1][0]     = -PetscSqr(PETSC_PI) * (s[1] * c[2] + s[0] * c[1]);
3070b7f5c055SJed Brown   hess[1][1]     = -PetscSqr(PETSC_PI) * (c[1] * s[2]);
3071b7f5c055SJed Brown   hess[2][2]     = -PetscSqr(PETSC_PI) * (c[0] * s[1]);
3072b7f5c055SJed Brown   hess[2][0]     = -PetscSqr(PETSC_PI) * (s[2] * c[0] + s[1] * c[2]);
3073b7f5c055SJed Brown   hess[2][1]     = -PetscSqr(PETSC_PI) * (c[2] * s[0]);
3074b7f5c055SJed Brown   hess[2][2]     = -PetscSqr(PETSC_PI) * (c[1] * s[2]);
3075b7f5c055SJed Brown }
3076b7f5c055SJed Brown 
30774663dae6SJed Brown // u[] is a tentative normal on input. Replace with the implicit function gradient in the same direction
3078d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSExtrudeNormalFunc_Gyroid(PetscInt dim, PetscReal time, const PetscReal x[], PetscInt r, PetscScalar u[], void *ctx)
3079d71ae5a4SJacob Faibussowitsch {
30804663dae6SJed Brown   PetscReal s[3] = {PetscSinReal(PETSC_PI * x[0]), PetscSinReal(PETSC_PI * (x[1] + .5)), PetscSinReal(PETSC_PI * (x[2] + .25))};
30814663dae6SJed Brown   PetscReal c[3] = {PetscCosReal(PETSC_PI * x[0]), PetscCosReal(PETSC_PI * (x[1] + .5)), PetscCosReal(PETSC_PI * (x[2] + .25))};
30824663dae6SJed Brown   u[0]           = PETSC_PI * (c[0] * c[1] - s[2] * s[0]);
30834663dae6SJed Brown   u[1]           = PETSC_PI * (c[1] * c[2] - s[0] * s[1]);
30844663dae6SJed Brown   u[2]           = PETSC_PI * (c[2] * c[0] - s[1] * s[2]);
30853ba16761SJacob Faibussowitsch   return PETSC_SUCCESS;
30864663dae6SJed Brown }
30874663dae6SJed Brown 
3088b7f5c055SJed Brown /*
3089b7f5c055SJed Brown    We wish to solve
3090b7f5c055SJed Brown 
3091b7f5c055SJed Brown          min_y || y - x ||^2  subject to f(y) = 0
3092b7f5c055SJed Brown 
3093b7f5c055SJed Brown    Let g(y) = grad(f).  The minimization problem is equivalent to asking to satisfy
3094b7f5c055SJed 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
3095b7f5c055SJed Brown    tangent space and ask for both components in the tangent space to be zero.
3096b7f5c055SJed Brown 
3097b7f5c055SJed Brown    Take g to be a column vector and compute the "full QR" factorization Q R = g,
3098b7f5c055SJed Brown    where Q = I - 2 n n^T is a symmetric orthogonal matrix.
3099b7f5c055SJed Brown    The first column of Q is parallel to g so the remaining two columns span the null space.
3100b7f5c055SJed Brown    Let Qn = Q[:,1:] be those remaining columns.  Then Qn Qn^T is an orthogonal projector into the tangent space.
3101da81f932SPierre Jolivet    Since Q is symmetric, this is equivalent to multiplying by Q and taking the last two entries.
3102b7f5c055SJed Brown    In total, we have a system of 3 equations in 3 unknowns:
3103b7f5c055SJed Brown 
3104b7f5c055SJed Brown      f(y) = 0                       1 equation
3105b7f5c055SJed Brown      Qn^T (y - x) = 0               2 equations
3106b7f5c055SJed Brown 
3107b7f5c055SJed Brown    Here, we compute the residual and Jacobian of this system.
3108b7f5c055SJed Brown */
3109d71ae5a4SJacob Faibussowitsch static void TPSNearestPointResJac(TPSEvaluateFunc feval, const PetscScalar x[], const PetscScalar y[], PetscScalar res[], PetscScalar J[])
3110d71ae5a4SJacob Faibussowitsch {
3111b7f5c055SJed Brown   PetscReal yreal[3] = {PetscRealPart(y[0]), PetscRealPart(y[1]), PetscRealPart(y[2])};
3112b7f5c055SJed Brown   PetscReal d[3]     = {PetscRealPart(y[0] - x[0]), PetscRealPart(y[1] - x[1]), PetscRealPart(y[2] - x[2])};
31132f0490c0SSatish Balay   PetscReal f, grad[3], n[3], norm, norm_y[3], nd, nd_y[3], sign;
31149371c9d4SSatish Balay   PetscReal n_y[3][3] = {
31159371c9d4SSatish Balay     {0, 0, 0},
31169371c9d4SSatish Balay     {0, 0, 0},
31179371c9d4SSatish Balay     {0, 0, 0}
31189371c9d4SSatish Balay   };
3119b7f5c055SJed Brown 
3120b7f5c055SJed Brown   feval(yreal, &f, grad, n_y);
3121b7f5c055SJed Brown 
3122b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) n[i] = grad[i];
3123b7f5c055SJed Brown   norm = PetscSqrtReal(PetscSqr(n[0]) + PetscSqr(n[1]) + PetscSqr(n[2]));
3124ad540459SPierre Jolivet   for (PetscInt i = 0; i < 3; i++) norm_y[i] = 1. / norm * n[i] * n_y[i][i];
3125b7f5c055SJed Brown 
3126b7f5c055SJed Brown   // Define the Householder reflector
3127b7f5c055SJed Brown   sign = n[0] >= 0 ? 1. : -1.;
3128b7f5c055SJed Brown   n[0] += norm * sign;
3129b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) n_y[0][i] += norm_y[i] * sign;
3130b7f5c055SJed Brown 
3131b7f5c055SJed Brown   norm      = PetscSqrtReal(PetscSqr(n[0]) + PetscSqr(n[1]) + PetscSqr(n[2]));
3132b7f5c055SJed Brown   norm_y[0] = 1. / norm * (n[0] * n_y[0][0]);
3133b7f5c055SJed Brown   norm_y[1] = 1. / norm * (n[0] * n_y[0][1] + n[1] * n_y[1][1]);
3134b7f5c055SJed Brown   norm_y[2] = 1. / norm * (n[0] * n_y[0][2] + n[2] * n_y[2][2]);
3135b7f5c055SJed Brown 
3136b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) {
3137b7f5c055SJed Brown     n[i] /= norm;
3138b7f5c055SJed Brown     for (PetscInt j = 0; j < 3; j++) {
3139b7f5c055SJed Brown       // note that n[i] is n_old[i]/norm when executing the code below
3140b7f5c055SJed Brown       n_y[i][j] = n_y[i][j] / norm - n[i] / norm * norm_y[j];
3141b7f5c055SJed Brown     }
3142b7f5c055SJed Brown   }
3143b7f5c055SJed Brown 
3144b7f5c055SJed Brown   nd = n[0] * d[0] + n[1] * d[1] + n[2] * d[2];
3145b7f5c055SJed 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];
3146b7f5c055SJed Brown 
3147b7f5c055SJed Brown   res[0] = f;
3148b7f5c055SJed Brown   res[1] = d[1] - 2 * n[1] * nd;
3149b7f5c055SJed Brown   res[2] = d[2] - 2 * n[2] * nd;
3150b7f5c055SJed Brown   // J[j][i] is J_{ij} (column major)
3151b7f5c055SJed Brown   for (PetscInt j = 0; j < 3; j++) {
3152b7f5c055SJed Brown     J[0 + j * 3] = grad[j];
3153b7f5c055SJed Brown     J[1 + j * 3] = (j == 1) * 1. - 2 * (n_y[1][j] * nd + n[1] * nd_y[j]);
3154b7f5c055SJed Brown     J[2 + j * 3] = (j == 2) * 1. - 2 * (n_y[2][j] * nd + n[2] * nd_y[j]);
3155b7f5c055SJed Brown   }
3156b7f5c055SJed Brown }
3157b7f5c055SJed Brown 
3158b7f5c055SJed Brown /*
3159b7f5c055SJed Brown    Project x to the nearest point on the implicit surface using Newton's method.
3160b7f5c055SJed Brown */
3161d71ae5a4SJacob Faibussowitsch static PetscErrorCode TPSNearestPoint(TPSEvaluateFunc feval, PetscScalar x[])
3162d71ae5a4SJacob Faibussowitsch {
3163b7f5c055SJed Brown   PetscScalar y[3] = {x[0], x[1], x[2]}; // Initial guess
3164b7f5c055SJed Brown 
3165b7f5c055SJed Brown   PetscFunctionBegin;
3166b7f5c055SJed Brown   for (PetscInt iter = 0; iter < 10; iter++) {
3167b7f5c055SJed Brown     PetscScalar res[3], J[9];
3168b7f5c055SJed Brown     PetscReal   resnorm;
3169b7f5c055SJed Brown     TPSNearestPointResJac(feval, x, y, res, J);
3170b7f5c055SJed Brown     resnorm = PetscSqrtReal(PetscSqr(PetscRealPart(res[0])) + PetscSqr(PetscRealPart(res[1])) + PetscSqr(PetscRealPart(res[2])));
3171b7f5c055SJed Brown     if (0) { // Turn on this monitor if you need to confirm quadratic convergence
317263a3b9bcSJacob 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])));
3173b7f5c055SJed Brown     }
3174b7f5c055SJed Brown     if (resnorm < PETSC_SMALL) break;
3175b7f5c055SJed Brown 
3176b7f5c055SJed Brown     // Take the Newton step
31779566063dSJacob Faibussowitsch     PetscCall(PetscKernel_A_gets_inverse_A_3(J, 0., PETSC_FALSE, NULL));
3178b7f5c055SJed Brown     PetscKernel_v_gets_v_minus_A_times_w_3(y, J, res);
3179b7f5c055SJed Brown   }
3180b7f5c055SJed Brown   for (PetscInt i = 0; i < 3; i++) x[i] = y[i];
31813ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3182b7f5c055SJed Brown }
3183b7f5c055SJed Brown 
3184b7f5c055SJed Brown const char *const DMPlexTPSTypes[] = {"SCHWARZ_P", "GYROID", "DMPlexTPSType", "DMPLEX_TPS_", NULL};
3185b7f5c055SJed Brown 
3186d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateTPSMesh_Internal(DM dm, DMPlexTPSType tpstype, const PetscInt extent[], const DMBoundaryType periodic[], PetscBool tps_distribute, PetscInt refinements, PetscInt layers, PetscReal thickness)
3187d71ae5a4SJacob Faibussowitsch {
3188b7f5c055SJed Brown   PetscMPIInt rank;
3189b7f5c055SJed Brown   PetscInt    topoDim = 2, spaceDim = 3, numFaces = 0, numVertices = 0, numEdges = 0;
3190b7f5c055SJed Brown   PetscInt(*edges)[2] = NULL, *edgeSets = NULL;
3191b7f5c055SJed Brown   PetscInt           *cells_flat = NULL;
3192b7f5c055SJed Brown   PetscReal          *vtxCoords  = NULL;
3193b7f5c055SJed Brown   TPSEvaluateFunc     evalFunc   = NULL;
31948434afd1SBarry Smith   PetscSimplePointFn *normalFunc = NULL;
3195b7f5c055SJed Brown   DMLabel             label;
3196b7f5c055SJed Brown 
3197b7f5c055SJed Brown   PetscFunctionBegin;
319846139095SJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_Generate, dm, 0, 0, 0));
31999566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
320063a3b9bcSJacob 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);
3201b7f5c055SJed Brown   switch (tpstype) {
3202b7f5c055SJed Brown   case DMPLEX_TPS_SCHWARZ_P:
3203b7f5c055SJed 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");
3204c5853193SPierre Jolivet     if (rank == 0) {
3205b7f5c055SJed Brown       PetscInt(*cells)[6][4][4] = NULL; // [junction, junction-face, cell, conn]
3206b7f5c055SJed Brown       PetscInt  Njunctions = 0, Ncuts = 0, Npipes[3], vcount;
3207b7f5c055SJed Brown       PetscReal L = 1;
3208b7f5c055SJed Brown 
3209b7f5c055SJed Brown       Npipes[0]   = (extent[0] + 1) * extent[1] * extent[2];
3210b7f5c055SJed Brown       Npipes[1]   = extent[0] * (extent[1] + 1) * extent[2];
3211b7f5c055SJed Brown       Npipes[2]   = extent[0] * extent[1] * (extent[2] + 1);
3212b7f5c055SJed Brown       Njunctions  = extent[0] * extent[1] * extent[2];
3213b7f5c055SJed Brown       Ncuts       = 2 * (extent[0] * extent[1] + extent[1] * extent[2] + extent[2] * extent[0]);
3214b7f5c055SJed Brown       numVertices = 4 * (Npipes[0] + Npipes[1] + Npipes[2]) + 8 * Njunctions;
32159566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(3 * numVertices, &vtxCoords));
32169566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Njunctions, &cells));
32179566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Ncuts * 4, &edges));
32189566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Ncuts * 4, &edgeSets));
3219b7f5c055SJed Brown       // x-normal pipes
3220b7f5c055SJed Brown       vcount = 0;
3221b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0] + 1; i++) {
3222b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3223b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3224b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3225b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * i - 1) * L;
3226b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * j * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3227b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * k * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3228b7f5c055SJed Brown             }
3229b7f5c055SJed Brown           }
3230b7f5c055SJed Brown         }
3231b7f5c055SJed Brown       }
3232b7f5c055SJed Brown       // y-normal pipes
3233b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3234b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1] + 1; j++) {
3235b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3236b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3237b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * i * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3238b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * j - 1) * L;
3239b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * k * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3240b7f5c055SJed Brown             }
3241b7f5c055SJed Brown           }
3242b7f5c055SJed Brown         }
3243b7f5c055SJed Brown       }
3244b7f5c055SJed Brown       // z-normal pipes
3245b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3246b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3247b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2] + 1; k++) {
3248b7f5c055SJed Brown             for (PetscInt l = 0; l < 4; l++) {
3249b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * i * L + PetscCosReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3250b7f5c055SJed Brown               vtxCoords[vcount++] = 2 * j * L + PetscSinReal((2 * l + 1) * PETSC_PI / 4) * L / 2;
3251b7f5c055SJed Brown               vtxCoords[vcount++] = (2 * k - 1) * L;
3252b7f5c055SJed Brown             }
3253b7f5c055SJed Brown           }
3254b7f5c055SJed Brown         }
3255b7f5c055SJed Brown       }
3256b7f5c055SJed Brown       // junctions
3257b7f5c055SJed Brown       for (PetscInt i = 0; i < extent[0]; i++) {
3258b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3259b7f5c055SJed Brown           for (PetscInt k = 0; k < extent[2]; k++) {
3260b7f5c055SJed Brown             const PetscInt J = (i * extent[1] + j) * extent[2] + k, Jvoff = (Npipes[0] + Npipes[1] + Npipes[2]) * 4 + J * 8;
3261b7f5c055SJed Brown             PetscCheck(vcount / 3 == Jvoff, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Unexpected vertex count");
3262b7f5c055SJed Brown             for (PetscInt ii = 0; ii < 2; ii++) {
3263b7f5c055SJed Brown               for (PetscInt jj = 0; jj < 2; jj++) {
3264b7f5c055SJed Brown                 for (PetscInt kk = 0; kk < 2; kk++) {
3265b7f5c055SJed Brown                   double Ls           = (1 - sqrt(2) / 4) * L;
3266b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * i * L + (2 * ii - 1) * Ls;
3267b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * j * L + (2 * jj - 1) * Ls;
3268b7f5c055SJed Brown                   vtxCoords[vcount++] = 2 * k * L + (2 * kk - 1) * Ls;
3269b7f5c055SJed Brown                 }
3270b7f5c055SJed Brown               }
3271b7f5c055SJed Brown             }
3272b7f5c055SJed Brown             const PetscInt jfaces[3][2][4] = {
3273b7f5c055SJed Brown               {{3, 1, 0, 2}, {7, 5, 4, 6}}, // x-aligned
3274b7f5c055SJed Brown               {{5, 4, 0, 1}, {7, 6, 2, 3}}, // y-aligned
3275b7f5c055SJed Brown               {{6, 2, 0, 4}, {7, 3, 1, 5}}  // z-aligned
3276b7f5c055SJed Brown             };
3277b7f5c055SJed Brown             const PetscInt pipe_lo[3] = {// vertex numbers of pipes
32789371c9d4SSatish 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};
3279b7f5c055SJed Brown             const PetscInt pipe_hi[3] = {// vertex numbers of pipes
32809371c9d4SSatish 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};
3281b7f5c055SJed Brown             for (PetscInt dir = 0; dir < 3; dir++) { // x,y,z
3282b7f5c055SJed Brown               const PetscInt ijk[3] = {i, j, k};
3283b7f5c055SJed Brown               for (PetscInt l = 0; l < 4; l++) { // rotations
3284b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][0] = pipe_lo[dir] + l;
3285b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][1] = Jvoff + jfaces[dir][0][l];
3286b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][2] = Jvoff + jfaces[dir][0][(l - 1 + 4) % 4];
3287b7f5c055SJed Brown                 cells[J][dir * 2 + 0][l][3] = pipe_lo[dir] + (l - 1 + 4) % 4;
3288b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][0] = Jvoff + jfaces[dir][1][l];
3289b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][1] = pipe_hi[dir] + l;
3290b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][2] = pipe_hi[dir] + (l - 1 + 4) % 4;
3291b7f5c055SJed Brown                 cells[J][dir * 2 + 1][l][3] = Jvoff + jfaces[dir][1][(l - 1 + 4) % 4];
3292b7f5c055SJed Brown                 if (ijk[dir] == 0) {
3293b7f5c055SJed Brown                   edges[numEdges][0] = pipe_lo[dir] + l;
3294b7f5c055SJed Brown                   edges[numEdges][1] = pipe_lo[dir] + (l + 1) % 4;
3295b7f5c055SJed Brown                   edgeSets[numEdges] = dir * 2 + 1;
3296b7f5c055SJed Brown                   numEdges++;
3297b7f5c055SJed Brown                 }
3298b7f5c055SJed Brown                 if (ijk[dir] + 1 == extent[dir]) {
3299b7f5c055SJed Brown                   edges[numEdges][0] = pipe_hi[dir] + l;
3300b7f5c055SJed Brown                   edges[numEdges][1] = pipe_hi[dir] + (l + 1) % 4;
3301b7f5c055SJed Brown                   edgeSets[numEdges] = dir * 2 + 2;
3302b7f5c055SJed Brown                   numEdges++;
3303b7f5c055SJed Brown                 }
3304b7f5c055SJed Brown               }
3305b7f5c055SJed Brown             }
3306b7f5c055SJed Brown           }
3307b7f5c055SJed Brown         }
3308b7f5c055SJed Brown       }
330963a3b9bcSJacob Faibussowitsch       PetscCheck(numEdges == Ncuts * 4, PetscObjectComm((PetscObject)dm), PETSC_ERR_PLIB, "Edge count %" PetscInt_FMT " incompatible with number of cuts %" PetscInt_FMT, numEdges, Ncuts);
3310b7f5c055SJed Brown       numFaces   = 24 * Njunctions;
3311b7f5c055SJed Brown       cells_flat = cells[0][0][0];
3312b7f5c055SJed Brown     }
3313b7f5c055SJed Brown     evalFunc   = TPSEvaluate_SchwarzP;
33144663dae6SJed Brown     normalFunc = TPSExtrudeNormalFunc_SchwarzP;
3315b7f5c055SJed Brown     break;
3316b7f5c055SJed Brown   case DMPLEX_TPS_GYROID:
3317c5853193SPierre Jolivet     if (rank == 0) {
3318b7f5c055SJed Brown       // This is a coarse mesh approximation of the gyroid shifted to being the zero of the level set
3319b7f5c055SJed Brown       //
3320b7f5c055SJed 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)
3321b7f5c055SJed Brown       //
3322b7f5c055SJed Brown       // on the cell [0,2]^3.
3323b7f5c055SJed Brown       //
3324b7f5c055SJed Brown       // Think about dividing that cell into four columns, and focus on the column [0,1]x[0,1]x[0,2].
3325b7f5c055SJed Brown       // If you looked at the gyroid in that column at different slices of z you would see that it kind of spins
3326b7f5c055SJed Brown       // like a boomerang:
3327b7f5c055SJed Brown       //
3328b7f5c055SJed Brown       //     z = 0          z = 1/4        z = 1/2        z = 3/4     //
3329b7f5c055SJed Brown       //     -----          -------        -------        -------     //
3330b7f5c055SJed Brown       //                                                              //
3331b7f5c055SJed Brown       //     +       +      +       +      +       +      +   \   +   //
3332b7f5c055SJed Brown       //      \                                   /            \      //
3333b7f5c055SJed Brown       //       \            `-_   _-'            /              }     //
3334b7f5c055SJed Brown       //        *-_            `-'            _-'              /      //
3335b7f5c055SJed Brown       //     +     `-+      +       +      +-'     +      +   /   +   //
3336b7f5c055SJed Brown       //                                                              //
3337b7f5c055SJed Brown       //                                                              //
3338b7f5c055SJed Brown       //     z = 1          z = 5/4        z = 3/2        z = 7/4     //
3339b7f5c055SJed Brown       //     -----          -------        -------        -------     //
3340b7f5c055SJed Brown       //                                                              //
3341b7f5c055SJed Brown       //     +-_     +      +       +      +     _-+      +   /   +   //
3342b7f5c055SJed Brown       //        `-_            _-_            _-`            /        //
3343b7f5c055SJed Brown       //           \        _-'   `-_        /              {         //
3344b7f5c055SJed Brown       //            \                       /                \        //
3345b7f5c055SJed Brown       //     +       +      +       +      +       +      +   \   +   //
3346b7f5c055SJed Brown       //
3347b7f5c055SJed Brown       //
3348b7f5c055SJed Brown       // This course mesh approximates each of these slices by two line segments,
3349b7f5c055SJed Brown       // and then connects the segments in consecutive layers with quadrilateral faces.
3350b7f5c055SJed Brown       // All of the end points of the segments are multiples of 1/4 except for the
3351b7f5c055SJed Brown       // point * in the picture for z = 0 above and the similar points in other layers.
3352b7f5c055SJed Brown       // That point is at (gamma, gamma, 0), where gamma is calculated below.
3353b7f5c055SJed Brown       //
3354b7f5c055SJed Brown       // The column  [1,2]x[1,2]x[0,2] looks the same as this column;
3355b7f5c055SJed Brown       // The columns [1,2]x[0,1]x[0,2] and [0,1]x[1,2]x[0,2] are mirror images.
3356b7f5c055SJed Brown       //
3357b7f5c055SJed Brown       // As for how this method turned into the names given to the vertices:
3358b7f5c055SJed Brown       // that was not systematic, it was just the way it worked out in my handwritten notes.
3359b7f5c055SJed Brown 
3360b7f5c055SJed Brown       PetscInt facesPerBlock = 64;
3361b7f5c055SJed Brown       PetscInt vertsPerBlock = 56;
3362b7f5c055SJed Brown       PetscInt extentPlus[3];
3363b7f5c055SJed Brown       PetscInt numBlocks, numBlocksPlus;
33649371c9d4SSatish 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;
33659371c9d4SSatish Balay       const PetscInt pattern[64][4] = {
33669371c9d4SSatish Balay         /* face to vertex within the coarse discretization of a single gyroid block */
3367b7f5c055SJed Brown         /* layer 0 */
33689371c9d4SSatish Balay         {A,           C,           K,           G          },
33699371c9d4SSatish Balay         {C,           B,           II,          K          },
33709371c9d4SSatish Balay         {D,           A,           H,           L          },
33719371c9d4SSatish Balay         {B + 56 * 1,  D,           L,           J          },
33729371c9d4SSatish Balay         {E,           B + 56 * 1,  J,           N          },
33739371c9d4SSatish Balay         {A + 56 * 2,  E,           N,           H + 56 * 2 },
33749371c9d4SSatish Balay         {F,           A + 56 * 2,  G + 56 * 2,  M          },
33759371c9d4SSatish Balay         {B,           F,           M,           II         },
3376b7f5c055SJed Brown         /* layer 1 */
33779371c9d4SSatish Balay         {G,           K,           Q,           O          },
33789371c9d4SSatish Balay         {K,           II,          P,           Q          },
33799371c9d4SSatish Balay         {L,           H,           O + 56 * 1,  R          },
33809371c9d4SSatish Balay         {J,           L,           R,           P          },
33819371c9d4SSatish Balay         {N,           J,           P,           S          },
33829371c9d4SSatish Balay         {H + 56 * 2,  N,           S,           O + 56 * 3 },
33839371c9d4SSatish Balay         {M,           G + 56 * 2,  O + 56 * 2,  T          },
33849371c9d4SSatish Balay         {II,          M,           T,           P          },
3385b7f5c055SJed Brown         /* layer 2 */
33869371c9d4SSatish Balay         {O,           Q,           Y,           U          },
33879371c9d4SSatish Balay         {Q,           P,           W,           Y          },
33889371c9d4SSatish Balay         {R,           O + 56 * 1,  U + 56 * 1,  Ap         },
33899371c9d4SSatish Balay         {P,           R,           Ap,          W          },
33909371c9d4SSatish Balay         {S,           P,           X,           Bp         },
33919371c9d4SSatish Balay         {O + 56 * 3,  S,           Bp,          V + 56 * 1 },
33929371c9d4SSatish Balay         {T,           O + 56 * 2,  V,           Z          },
33939371c9d4SSatish Balay         {P,           T,           Z,           X          },
3394b7f5c055SJed Brown         /* layer 3 */
33959371c9d4SSatish Balay         {U,           Y,           Ep,          Dp         },
33969371c9d4SSatish Balay         {Y,           W,           Cp,          Ep         },
33979371c9d4SSatish Balay         {Ap,          U + 56 * 1,  Dp + 56 * 1, Gp         },
33989371c9d4SSatish Balay         {W,           Ap,          Gp,          Cp         },
33999371c9d4SSatish Balay         {Bp,          X,           Cp + 56 * 2, Fp         },
34009371c9d4SSatish Balay         {V + 56 * 1,  Bp,          Fp,          Dp + 56 * 1},
34019371c9d4SSatish Balay         {Z,           V,           Dp,          Hp         },
34029371c9d4SSatish Balay         {X,           Z,           Hp,          Cp + 56 * 2},
3403b7f5c055SJed Brown         /* layer 4 */
34049371c9d4SSatish Balay         {Dp,          Ep,          Mp,          Kp         },
34059371c9d4SSatish Balay         {Ep,          Cp,          Ip,          Mp         },
34069371c9d4SSatish Balay         {Gp,          Dp + 56 * 1, Lp,          Np         },
34079371c9d4SSatish Balay         {Cp,          Gp,          Np,          Jp         },
34089371c9d4SSatish Balay         {Fp,          Cp + 56 * 2, Jp + 56 * 2, Pp         },
34099371c9d4SSatish Balay         {Dp + 56 * 1, Fp,          Pp,          Lp         },
34109371c9d4SSatish Balay         {Hp,          Dp,          Kp,          Op         },
34119371c9d4SSatish Balay         {Cp + 56 * 2, Hp,          Op,          Ip + 56 * 2},
3412b7f5c055SJed Brown         /* layer 5 */
34139371c9d4SSatish Balay         {Kp,          Mp,          Sp,          Rp         },
34149371c9d4SSatish Balay         {Mp,          Ip,          Qp,          Sp         },
34159371c9d4SSatish Balay         {Np,          Lp,          Rp,          Tp         },
34169371c9d4SSatish Balay         {Jp,          Np,          Tp,          Qp + 56 * 1},
34179371c9d4SSatish Balay         {Pp,          Jp + 56 * 2, Qp + 56 * 3, Up         },
34189371c9d4SSatish Balay         {Lp,          Pp,          Up,          Rp         },
34199371c9d4SSatish Balay         {Op,          Kp,          Rp,          Vp         },
34209371c9d4SSatish Balay         {Ip + 56 * 2, Op,          Vp,          Qp + 56 * 2},
3421b7f5c055SJed Brown         /* layer 6 */
34229371c9d4SSatish Balay         {Rp,          Sp,          Aq,          Yp         },
34239371c9d4SSatish Balay         {Sp,          Qp,          Wp,          Aq         },
34249371c9d4SSatish Balay         {Tp,          Rp,          Yp,          Cq         },
34259371c9d4SSatish Balay         {Qp + 56 * 1, Tp,          Cq,          Wp + 56 * 1},
34269371c9d4SSatish Balay         {Up,          Qp + 56 * 3, Xp + 56 * 1, Dq         },
34279371c9d4SSatish Balay         {Rp,          Up,          Dq,          Zp         },
34289371c9d4SSatish Balay         {Vp,          Rp,          Zp,          Bq         },
34299371c9d4SSatish Balay         {Qp + 56 * 2, Vp,          Bq,          Xp         },
3430b7f5c055SJed Brown         /* layer 7 (the top is the periodic image of the bottom of layer 0) */
34319371c9d4SSatish Balay         {Yp,          Aq,          C + 56 * 4,  A + 56 * 4 },
34329371c9d4SSatish Balay         {Aq,          Wp,          B + 56 * 4,  C + 56 * 4 },
34339371c9d4SSatish Balay         {Cq,          Yp,          A + 56 * 4,  D + 56 * 4 },
34349371c9d4SSatish Balay         {Wp + 56 * 1, Cq,          D + 56 * 4,  B + 56 * 5 },
34359371c9d4SSatish Balay         {Dq,          Xp + 56 * 1, B + 56 * 5,  E + 56 * 4 },
34369371c9d4SSatish Balay         {Zp,          Dq,          E + 56 * 4,  A + 56 * 6 },
34379371c9d4SSatish Balay         {Bq,          Zp,          A + 56 * 6,  F + 56 * 4 },
34389371c9d4SSatish Balay         {Xp,          Bq,          F + 56 * 4,  B + 56 * 4 }
3439b7f5c055SJed Brown       };
3440b7f5c055SJed Brown       const PetscReal gamma                = PetscAcosReal((PetscSqrtReal(3.) - 1.) / PetscSqrtReal(2.)) / PETSC_PI;
34419371c9d4SSatish Balay       const PetscReal patternCoords[56][3] = {
3442bee3fc89SBarry Smith         {1.,        0.,        0.  }, /* A  */
3443bee3fc89SBarry Smith         {0.,        1.,        0.  }, /* B  */
3444bee3fc89SBarry Smith         {gamma,     gamma,     0.  }, /* C  */
3445bee3fc89SBarry Smith         {1 + gamma, 1 - gamma, 0.  }, /* D  */
3446bee3fc89SBarry Smith         {2 - gamma, 2 - gamma, 0.  }, /* E  */
3447bee3fc89SBarry Smith         {1 - gamma, 1 + gamma, 0.  }, /* F  */
3448b7f5c055SJed Brown 
3449bee3fc89SBarry Smith         {.5,        0,         .25 }, /* G  */
3450bee3fc89SBarry Smith         {1.5,       0.,        .25 }, /* H  */
3451bee3fc89SBarry Smith         {.5,        1.,        .25 }, /* II */
3452bee3fc89SBarry Smith         {1.5,       1.,        .25 }, /* J  */
3453bee3fc89SBarry Smith         {.25,       .5,        .25 }, /* K  */
3454bee3fc89SBarry Smith         {1.25,      .5,        .25 }, /* L  */
3455bee3fc89SBarry Smith         {.75,       1.5,       .25 }, /* M  */
3456bee3fc89SBarry Smith         {1.75,      1.5,       .25 }, /* N  */
3457b7f5c055SJed Brown 
3458bee3fc89SBarry Smith         {0.,        0.,        .5  }, /* O  */
3459bee3fc89SBarry Smith         {1.,        1.,        .5  }, /* P  */
3460bee3fc89SBarry Smith         {gamma,     1 - gamma, .5  }, /* Q  */
3461bee3fc89SBarry Smith         {1 + gamma, gamma,     .5  }, /* R  */
3462bee3fc89SBarry Smith         {2 - gamma, 1 + gamma, .5  }, /* S  */
3463bee3fc89SBarry Smith         {1 - gamma, 2 - gamma, .5  }, /* T  */
3464b7f5c055SJed Brown 
3465bee3fc89SBarry Smith         {0.,        .5,        .75 }, /* U  */
3466bee3fc89SBarry Smith         {0.,        1.5,       .75 }, /* V  */
3467bee3fc89SBarry Smith         {1.,        .5,        .75 }, /* W  */
3468bee3fc89SBarry Smith         {1.,        1.5,       .75 }, /* X  */
3469bee3fc89SBarry Smith         {.5,        .75,       .75 }, /* Y  */
3470bee3fc89SBarry Smith         {.5,        1.75,      .75 }, /* Z  */
3471bee3fc89SBarry Smith         {1.5,       .25,       .75 }, /* Ap */
3472bee3fc89SBarry Smith         {1.5,       1.25,      .75 }, /* Bp */
3473b7f5c055SJed Brown 
3474bee3fc89SBarry Smith         {1.,        0.,        1.  }, /* Cp */
3475bee3fc89SBarry Smith         {0.,        1.,        1.  }, /* Dp */
3476bee3fc89SBarry Smith         {1 - gamma, 1 - gamma, 1.  }, /* Ep */
3477bee3fc89SBarry Smith         {1 + gamma, 1 + gamma, 1.  }, /* Fp */
3478bee3fc89SBarry Smith         {2 - gamma, gamma,     1.  }, /* Gp */
3479bee3fc89SBarry Smith         {gamma,     2 - gamma, 1.  }, /* Hp */
3480b7f5c055SJed Brown 
3481bee3fc89SBarry Smith         {.5,        0.,        1.25}, /* Ip */
3482bee3fc89SBarry Smith         {1.5,       0.,        1.25}, /* Jp */
3483bee3fc89SBarry Smith         {.5,        1.,        1.25}, /* Kp */
3484bee3fc89SBarry Smith         {1.5,       1.,        1.25}, /* Lp */
3485bee3fc89SBarry Smith         {.75,       .5,        1.25}, /* Mp */
3486bee3fc89SBarry Smith         {1.75,      .5,        1.25}, /* Np */
3487bee3fc89SBarry Smith         {.25,       1.5,       1.25}, /* Op */
3488bee3fc89SBarry Smith         {1.25,      1.5,       1.25}, /* Pp */
3489b7f5c055SJed Brown 
3490bee3fc89SBarry Smith         {0.,        0.,        1.5 }, /* Qp */
3491bee3fc89SBarry Smith         {1.,        1.,        1.5 }, /* Rp */
3492bee3fc89SBarry Smith         {1 - gamma, gamma,     1.5 }, /* Sp */
3493bee3fc89SBarry Smith         {2 - gamma, 1 - gamma, 1.5 }, /* Tp */
3494bee3fc89SBarry Smith         {1 + gamma, 2 - gamma, 1.5 }, /* Up */
3495bee3fc89SBarry Smith         {gamma,     1 + gamma, 1.5 }, /* Vp */
3496b7f5c055SJed Brown 
3497bee3fc89SBarry Smith         {0.,        .5,        1.75}, /* Wp */
3498bee3fc89SBarry Smith         {0.,        1.5,       1.75}, /* Xp */
3499bee3fc89SBarry Smith         {1.,        .5,        1.75}, /* Yp */
3500bee3fc89SBarry Smith         {1.,        1.5,       1.75}, /* Zp */
3501bee3fc89SBarry Smith         {.5,        .25,       1.75}, /* Aq */
3502bee3fc89SBarry Smith         {.5,        1.25,      1.75}, /* Bq */
3503bee3fc89SBarry Smith         {1.5,       .75,       1.75}, /* Cq */
3504bee3fc89SBarry Smith         {1.5,       1.75,      1.75}, /* Dq */
3505b7f5c055SJed Brown       };
3506b7f5c055SJed Brown       PetscInt(*cells)[64][4] = NULL;
3507b7f5c055SJed Brown       PetscBool *seen;
3508b7f5c055SJed Brown       PetscInt  *vertToTrueVert;
3509b7f5c055SJed Brown       PetscInt   count;
3510b7f5c055SJed Brown 
3511b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) extentPlus[i] = extent[i] + 1;
3512b7f5c055SJed Brown       numBlocks = 1;
3513b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) numBlocks *= extent[i];
3514b7f5c055SJed Brown       numBlocksPlus = 1;
3515b7f5c055SJed Brown       for (PetscInt i = 0; i < 3; i++) numBlocksPlus *= extentPlus[i];
3516b7f5c055SJed Brown       numFaces = numBlocks * facesPerBlock;
35179566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numBlocks, &cells));
35189566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(numBlocksPlus * vertsPerBlock, &seen));
3519b7f5c055SJed Brown       for (PetscInt k = 0; k < extent[2]; k++) {
3520b7f5c055SJed Brown         for (PetscInt j = 0; j < extent[1]; j++) {
3521b7f5c055SJed Brown           for (PetscInt i = 0; i < extent[0]; i++) {
3522b7f5c055SJed Brown             for (PetscInt f = 0; f < facesPerBlock; f++) {
3523b7f5c055SJed Brown               for (PetscInt v = 0; v < 4; v++) {
3524b7f5c055SJed Brown                 PetscInt vertRaw     = pattern[f][v];
3525b7f5c055SJed Brown                 PetscInt blockidx    = vertRaw / 56;
3526b7f5c055SJed Brown                 PetscInt patternvert = vertRaw % 56;
3527b7f5c055SJed Brown                 PetscInt xplus       = (blockidx & 1);
3528b7f5c055SJed Brown                 PetscInt yplus       = (blockidx & 2) >> 1;
3529b7f5c055SJed Brown                 PetscInt zplus       = (blockidx & 4) >> 2;
3530b7f5c055SJed Brown                 PetscInt zcoord      = (periodic && periodic[2] == DM_BOUNDARY_PERIODIC) ? ((k + zplus) % extent[2]) : (k + zplus);
3531b7f5c055SJed Brown                 PetscInt ycoord      = (periodic && periodic[1] == DM_BOUNDARY_PERIODIC) ? ((j + yplus) % extent[1]) : (j + yplus);
3532b7f5c055SJed Brown                 PetscInt xcoord      = (periodic && periodic[0] == DM_BOUNDARY_PERIODIC) ? ((i + xplus) % extent[0]) : (i + xplus);
3533b7f5c055SJed Brown                 PetscInt vert        = ((zcoord * extentPlus[1] + ycoord) * extentPlus[0] + xcoord) * 56 + patternvert;
3534b7f5c055SJed Brown 
3535b7f5c055SJed Brown                 cells[(k * extent[1] + j) * extent[0] + i][f][v] = vert;
3536b7f5c055SJed Brown                 seen[vert]                                       = PETSC_TRUE;
3537b7f5c055SJed Brown               }
3538b7f5c055SJed Brown             }
3539b7f5c055SJed Brown           }
3540b7f5c055SJed Brown         }
3541b7f5c055SJed Brown       }
35429371c9d4SSatish Balay       for (PetscInt i = 0; i < numBlocksPlus * vertsPerBlock; i++)
35439371c9d4SSatish Balay         if (seen[i]) numVertices++;
3544b7f5c055SJed Brown       count = 0;
35459566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numBlocksPlus * vertsPerBlock, &vertToTrueVert));
35469566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numVertices * 3, &vtxCoords));
3547b7f5c055SJed Brown       for (PetscInt i = 0; i < numBlocksPlus * vertsPerBlock; i++) vertToTrueVert[i] = -1;
3548b7f5c055SJed Brown       for (PetscInt k = 0; k < extentPlus[2]; k++) {
3549b7f5c055SJed Brown         for (PetscInt j = 0; j < extentPlus[1]; j++) {
3550b7f5c055SJed Brown           for (PetscInt i = 0; i < extentPlus[0]; i++) {
3551b7f5c055SJed Brown             for (PetscInt v = 0; v < vertsPerBlock; v++) {
3552b7f5c055SJed Brown               PetscInt vIdx = ((k * extentPlus[1] + j) * extentPlus[0] + i) * vertsPerBlock + v;
3553b7f5c055SJed Brown 
3554b7f5c055SJed Brown               if (seen[vIdx]) {
3555b7f5c055SJed Brown                 PetscInt thisVert;
3556b7f5c055SJed Brown 
3557b7f5c055SJed Brown                 vertToTrueVert[vIdx] = thisVert = count++;
3558b7f5c055SJed Brown 
3559b7f5c055SJed Brown                 for (PetscInt d = 0; d < 3; d++) vtxCoords[3 * thisVert + d] = patternCoords[v][d];
3560b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 0] += i * 2;
3561b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 1] += j * 2;
3562b7f5c055SJed Brown                 vtxCoords[3 * thisVert + 2] += k * 2;
3563b7f5c055SJed Brown               }
3564b7f5c055SJed Brown             }
3565b7f5c055SJed Brown           }
3566b7f5c055SJed Brown         }
3567b7f5c055SJed Brown       }
3568b7f5c055SJed Brown       for (PetscInt i = 0; i < numBlocks; i++) {
3569b7f5c055SJed Brown         for (PetscInt f = 0; f < facesPerBlock; f++) {
3570ad540459SPierre Jolivet           for (PetscInt v = 0; v < 4; v++) cells[i][f][v] = vertToTrueVert[cells[i][f][v]];
3571b7f5c055SJed Brown         }
3572b7f5c055SJed Brown       }
35739566063dSJacob Faibussowitsch       PetscCall(PetscFree(vertToTrueVert));
35749566063dSJacob Faibussowitsch       PetscCall(PetscFree(seen));
3575b7f5c055SJed Brown       cells_flat = cells[0][0];
3576b7f5c055SJed Brown       numEdges   = 0;
3577b7f5c055SJed Brown       for (PetscInt i = 0; i < numFaces; i++) {
3578b7f5c055SJed Brown         for (PetscInt e = 0; e < 4; e++) {
3579b7f5c055SJed Brown           PetscInt         ev[]       = {cells_flat[i * 4 + e], cells_flat[i * 4 + ((e + 1) % 4)]};
3580b7f5c055SJed Brown           const PetscReal *evCoords[] = {&vtxCoords[3 * ev[0]], &vtxCoords[3 * ev[1]]};
3581b7f5c055SJed Brown 
3582b7f5c055SJed Brown           for (PetscInt d = 0; d < 3; d++) {
3583b7f5c055SJed Brown             if (!periodic || periodic[0] != DM_BOUNDARY_PERIODIC) {
3584b7f5c055SJed Brown               if (evCoords[0][d] == 0. && evCoords[1][d] == 0.) numEdges++;
3585b7f5c055SJed Brown               if (evCoords[0][d] == 2. * extent[d] && evCoords[1][d] == 2. * extent[d]) numEdges++;
3586b7f5c055SJed Brown             }
3587b7f5c055SJed Brown           }
3588b7f5c055SJed Brown         }
3589b7f5c055SJed Brown       }
35909566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numEdges, &edges));
35919566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numEdges, &edgeSets));
3592b7f5c055SJed Brown       for (PetscInt edge = 0, i = 0; i < numFaces; i++) {
3593b7f5c055SJed Brown         for (PetscInt e = 0; e < 4; e++) {
3594b7f5c055SJed Brown           PetscInt         ev[]       = {cells_flat[i * 4 + e], cells_flat[i * 4 + ((e + 1) % 4)]};
3595b7f5c055SJed Brown           const PetscReal *evCoords[] = {&vtxCoords[3 * ev[0]], &vtxCoords[3 * ev[1]]};
3596b7f5c055SJed Brown 
3597b7f5c055SJed Brown           for (PetscInt d = 0; d < 3; d++) {
3598b7f5c055SJed Brown             if (!periodic || periodic[d] != DM_BOUNDARY_PERIODIC) {
3599b7f5c055SJed Brown               if (evCoords[0][d] == 0. && evCoords[1][d] == 0.) {
3600b7f5c055SJed Brown                 edges[edge][0]   = ev[0];
3601b7f5c055SJed Brown                 edges[edge][1]   = ev[1];
3602b7f5c055SJed Brown                 edgeSets[edge++] = 2 * d;
3603b7f5c055SJed Brown               }
3604b7f5c055SJed Brown               if (evCoords[0][d] == 2. * extent[d] && evCoords[1][d] == 2. * extent[d]) {
3605b7f5c055SJed Brown                 edges[edge][0]   = ev[0];
3606b7f5c055SJed Brown                 edges[edge][1]   = ev[1];
3607b7f5c055SJed Brown                 edgeSets[edge++] = 2 * d + 1;
3608b7f5c055SJed Brown               }
3609b7f5c055SJed Brown             }
3610b7f5c055SJed Brown           }
3611b7f5c055SJed Brown         }
3612b7f5c055SJed Brown       }
3613b7f5c055SJed Brown     }
3614b7f5c055SJed Brown     evalFunc   = TPSEvaluate_Gyroid;
36154663dae6SJed Brown     normalFunc = TPSExtrudeNormalFunc_Gyroid;
3616b7f5c055SJed Brown     break;
3617b7f5c055SJed Brown   }
3618b7f5c055SJed Brown 
36199566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(dm, topoDim));
3620c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildFromCellList(dm, numFaces, numVertices, 4, cells_flat));
36219566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildFromCellList(dm, 0, 0, 0, NULL));
36229566063dSJacob Faibussowitsch   PetscCall(PetscFree(cells_flat));
3623b7f5c055SJed Brown   {
3624b7f5c055SJed Brown     DM idm;
36259566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(dm, &idm));
362669d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &idm));
3627b7f5c055SJed Brown   }
3628c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildCoordinatesFromCellList(dm, spaceDim, vtxCoords));
36299566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildCoordinatesFromCellList(dm, spaceDim, NULL));
36309566063dSJacob Faibussowitsch   PetscCall(PetscFree(vtxCoords));
3631b7f5c055SJed Brown 
36329566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "Face Sets"));
36339566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "Face Sets", &label));
3634b7f5c055SJed Brown   for (PetscInt e = 0; e < numEdges; e++) {
3635b7f5c055SJed Brown     PetscInt        njoin;
3636b7f5c055SJed Brown     const PetscInt *join, verts[] = {numFaces + edges[e][0], numFaces + edges[e][1]};
36379566063dSJacob Faibussowitsch     PetscCall(DMPlexGetJoin(dm, 2, verts, &njoin, &join));
363863a3b9bcSJacob 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]);
36399566063dSJacob Faibussowitsch     PetscCall(DMLabelSetValue(label, join[0], edgeSets[e]));
36409566063dSJacob Faibussowitsch     PetscCall(DMPlexRestoreJoin(dm, 2, verts, &njoin, &join));
3641b7f5c055SJed Brown   }
36429566063dSJacob Faibussowitsch   PetscCall(PetscFree(edges));
36439566063dSJacob Faibussowitsch   PetscCall(PetscFree(edgeSets));
36441436d7faSJed Brown   if (tps_distribute) {
36451436d7faSJed Brown     DM               pdm = NULL;
36461436d7faSJed Brown     PetscPartitioner part;
36471436d7faSJed Brown 
36489566063dSJacob Faibussowitsch     PetscCall(DMPlexGetPartitioner(dm, &part));
36499566063dSJacob Faibussowitsch     PetscCall(PetscPartitionerSetFromOptions(part));
36509566063dSJacob Faibussowitsch     PetscCall(DMPlexDistribute(dm, 0, NULL, &pdm));
365148a46eb9SPierre Jolivet     if (pdm) PetscCall(DMPlexReplace_Internal(dm, &pdm));
36521436d7faSJed Brown     // Do not auto-distribute again
36539566063dSJacob Faibussowitsch     PetscCall(DMPlexDistributeSetDefault(dm, PETSC_FALSE));
36541436d7faSJed Brown   }
3655b7f5c055SJed Brown 
36569566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
3657b7f5c055SJed Brown   for (PetscInt refine = 0; refine < refinements; refine++) {
3658b7f5c055SJed Brown     PetscInt     m;
3659b7f5c055SJed Brown     DM           dmf;
3660b7f5c055SJed Brown     Vec          X;
3661b7f5c055SJed Brown     PetscScalar *x;
36629566063dSJacob Faibussowitsch     PetscCall(DMRefine(dm, MPI_COMM_NULL, &dmf));
366369d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmf));
3664b7f5c055SJed Brown 
36659566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinatesLocal(dm, &X));
36669566063dSJacob Faibussowitsch     PetscCall(VecGetLocalSize(X, &m));
36679566063dSJacob Faibussowitsch     PetscCall(VecGetArray(X, &x));
366848a46eb9SPierre Jolivet     for (PetscInt i = 0; i < m; i += 3) PetscCall(TPSNearestPoint(evalFunc, &x[i]));
36699566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(X, &x));
3670b7f5c055SJed Brown   }
3671b7f5c055SJed Brown 
3672b7f5c055SJed Brown   // Face Sets has already been propagated to new vertices during refinement; this propagates to the initial vertices.
36739566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "Face Sets", &label));
36749566063dSJacob Faibussowitsch   PetscCall(DMPlexLabelComplete(dm, label));
3675b7f5c055SJed Brown 
367646139095SJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_Generate, dm, 0, 0, 0));
367746139095SJed Brown 
3678b7f5c055SJed Brown   if (thickness > 0) {
36794663dae6SJed Brown     DM              edm, cdm, ecdm;
36804663dae6SJed Brown     DMPlexTransform tr;
36814663dae6SJed Brown     const char     *prefix;
36824663dae6SJed Brown     PetscOptions    options;
36834663dae6SJed Brown     // Code from DMPlexExtrude
36844663dae6SJed Brown     PetscCall(DMPlexTransformCreate(PetscObjectComm((PetscObject)dm), &tr));
36854663dae6SJed Brown     PetscCall(DMPlexTransformSetDM(tr, dm));
36864663dae6SJed Brown     PetscCall(DMPlexTransformSetType(tr, DMPLEXEXTRUDE));
36874663dae6SJed Brown     PetscCall(PetscObjectGetOptionsPrefix((PetscObject)dm, &prefix));
36884663dae6SJed Brown     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)tr, prefix));
36894663dae6SJed Brown     PetscCall(PetscObjectGetOptions((PetscObject)dm, &options));
36904663dae6SJed Brown     PetscCall(PetscObjectSetOptions((PetscObject)tr, options));
36914663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetLayers(tr, layers));
36924663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetThickness(tr, thickness));
36934663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetTensor(tr, PETSC_FALSE));
36944663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetSymmetric(tr, PETSC_TRUE));
36954663dae6SJed Brown     PetscCall(DMPlexTransformExtrudeSetNormalFunction(tr, normalFunc));
36964663dae6SJed Brown     PetscCall(DMPlexTransformSetFromOptions(tr));
36974663dae6SJed Brown     PetscCall(PetscObjectSetOptions((PetscObject)tr, NULL));
36984663dae6SJed Brown     PetscCall(DMPlexTransformSetUp(tr));
36994663dae6SJed Brown     PetscCall(PetscObjectViewFromOptions((PetscObject)tr, NULL, "-dm_plex_tps_transform_view"));
37004663dae6SJed Brown     PetscCall(DMPlexTransformApply(tr, dm, &edm));
37014663dae6SJed Brown     PetscCall(DMCopyDisc(dm, edm));
37024663dae6SJed Brown     PetscCall(DMGetCoordinateDM(dm, &cdm));
37034663dae6SJed Brown     PetscCall(DMGetCoordinateDM(edm, &ecdm));
37044663dae6SJed Brown     PetscCall(DMCopyDisc(cdm, ecdm));
37054663dae6SJed Brown     PetscCall(DMPlexTransformCreateDiscLabels(tr, edm));
37064663dae6SJed Brown     PetscCall(DMPlexTransformDestroy(&tr));
37074663dae6SJed Brown     if (edm) {
37084663dae6SJed Brown       ((DM_Plex *)edm->data)->printFEM    = ((DM_Plex *)dm->data)->printFEM;
37094663dae6SJed Brown       ((DM_Plex *)edm->data)->printL2     = ((DM_Plex *)dm->data)->printL2;
3710f5867de0SMatthew G. Knepley       ((DM_Plex *)edm->data)->printLocate = ((DM_Plex *)dm->data)->printLocate;
37114663dae6SJed Brown     }
371269d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &edm));
3713b7f5c055SJed Brown   }
37143ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3715b7f5c055SJed Brown }
3716b7f5c055SJed Brown 
3717b7f5c055SJed Brown /*@
3718b7f5c055SJed Brown   DMPlexCreateTPSMesh - Create a distributed, interpolated mesh of a triply-periodic surface
3719b7f5c055SJed Brown 
3720b7f5c055SJed Brown   Collective
3721b7f5c055SJed Brown 
3722b7f5c055SJed Brown   Input Parameters:
3723a1cb98faSBarry Smith + comm           - The communicator for the `DM` object
3724b7f5c055SJed Brown . tpstype        - Type of triply-periodic surface
3725b7f5c055SJed Brown . extent         - Array of length 3 containing number of periods in each direction
372620f4b53cSBarry Smith . periodic       - array of length 3 with periodicity, or `NULL` for non-periodic
37271436d7faSJed Brown . tps_distribute - Distribute 2D manifold mesh prior to refinement and extrusion (more scalable)
3728817da375SSatish Balay . refinements    - Number of factor-of-2 refinements of 2D manifold mesh
37291436d7faSJed Brown . layers         - Number of cell layers extruded in normal direction
3730817da375SSatish Balay - thickness      - Thickness in normal direction
3731b7f5c055SJed Brown 
3732b7f5c055SJed Brown   Output Parameter:
3733a1cb98faSBarry Smith . dm - The `DM` object
3734a1cb98faSBarry Smith 
3735a1cb98faSBarry Smith   Level: beginner
3736b7f5c055SJed Brown 
3737b7f5c055SJed Brown   Notes:
373815229ffcSPierre Jolivet   This meshes the surface of the Schwarz P or Gyroid surfaces.  Schwarz P is the simplest member of the triply-periodic minimal surfaces.
37391d27aa22SBarry Smith   <https://en.wikipedia.org/wiki/Schwarz_minimal_surface#Schwarz_P_(%22Primitive%22)> and can be cut with "clean" boundaries.
37401d27aa22SBarry 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.
3741b7f5c055SJed Brown   Our implementation creates a very coarse mesh of the surface and refines (by 4-way splitting) as many times as requested.
3742b7f5c055SJed Brown   On each refinement, all vertices are projected to their nearest point on the surface.
3743b7f5c055SJed Brown   This projection could readily be extended to related surfaces.
3744b7f5c055SJed Brown 
37451d27aa22SBarry Smith   See {cite}`maskery2018insights`
37461d27aa22SBarry Smith 
37471d27aa22SBarry Smith   The face (edge) sets for the Schwarz P surface are numbered $1(-x), 2(+x), 3(-y), 4(+y), 5(-z), 6(+z)$.
37481d27aa22SBarry Smith   When the mesh is refined, "Face Sets" contain the new vertices (created during refinement).
37491d27aa22SBarry Smith   Use `DMPlexLabelComplete()` to propagate to coarse-level vertices.
3750b7f5c055SJed Brown 
375160225df5SJacob Faibussowitsch   Developer Notes:
3752b7f5c055SJed Brown   The Gyroid mesh does not currently mark boundary sets.
3753b7f5c055SJed Brown 
37541cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateSphereMesh()`, `DMSetType()`, `DMCreate()`
3755b7f5c055SJed Brown @*/
3756d71ae5a4SJacob 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)
3757d71ae5a4SJacob Faibussowitsch {
3758b7f5c055SJed Brown   PetscFunctionBegin;
37599566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
37609566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
37619566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateTPSMesh_Internal(*dm, tpstype, extent, periodic, tps_distribute, refinements, layers, thickness));
37623ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3763b7f5c055SJed Brown }
3764b7f5c055SJed Brown 
37659318fe57SMatthew G. Knepley /*@
37669318fe57SMatthew G. Knepley   DMPlexCreateSphereMesh - Creates a mesh on the d-dimensional sphere, S^d.
37679318fe57SMatthew G. Knepley 
37689318fe57SMatthew G. Knepley   Collective
37699318fe57SMatthew G. Knepley 
37709318fe57SMatthew G. Knepley   Input Parameters:
3771a1cb98faSBarry Smith + comm    - The communicator for the `DM` object
37729318fe57SMatthew G. Knepley . dim     - The dimension
37739318fe57SMatthew G. Knepley . simplex - Use simplices, or tensor product cells
37749318fe57SMatthew G. Knepley - R       - The radius
37759318fe57SMatthew G. Knepley 
37769318fe57SMatthew G. Knepley   Output Parameter:
3777a1cb98faSBarry Smith . dm - The `DM` object
37789318fe57SMatthew G. Knepley 
37799318fe57SMatthew G. Knepley   Level: beginner
37809318fe57SMatthew G. Knepley 
37811cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBallMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
37829318fe57SMatthew G. Knepley @*/
3783d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateSphereMesh(MPI_Comm comm, PetscInt dim, PetscBool simplex, PetscReal R, DM *dm)
3784d71ae5a4SJacob Faibussowitsch {
37859318fe57SMatthew G. Knepley   PetscFunctionBegin;
37864f572ea9SToby Isaac   PetscAssertPointer(dm, 5);
37879566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
37889566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
37899566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateSphereMesh_Internal(*dm, dim, simplex, R));
37903ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
37919318fe57SMatthew G. Knepley }
37929318fe57SMatthew G. Knepley 
3793d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBallMesh_Internal(DM dm, PetscInt dim, PetscReal R)
3794d71ae5a4SJacob Faibussowitsch {
37959318fe57SMatthew G. Knepley   DM          sdm, vol;
37969318fe57SMatthew G. Knepley   DMLabel     bdlabel;
3797dd2b43ebSStefano Zampini   const char *prefix;
37989318fe57SMatthew G. Knepley 
37999318fe57SMatthew G. Knepley   PetscFunctionBegin;
38009566063dSJacob Faibussowitsch   PetscCall(DMCreate(PetscObjectComm((PetscObject)dm), &sdm));
38019566063dSJacob Faibussowitsch   PetscCall(DMSetType(sdm, DMPLEX));
3802dd2b43ebSStefano Zampini   PetscCall(DMGetOptionsPrefix(dm, &prefix));
3803dd2b43ebSStefano Zampini   PetscCall(DMSetOptionsPrefix(sdm, prefix));
3804dd2b43ebSStefano Zampini   PetscCall(DMAppendOptionsPrefix(sdm, "bd_"));
3805dd2b43ebSStefano Zampini   PetscCall(DMPlexDistributeSetDefault(sdm, PETSC_FALSE));
38069566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateSphereMesh_Internal(sdm, dim - 1, PETSC_TRUE, R));
38079566063dSJacob Faibussowitsch   PetscCall(DMSetFromOptions(sdm));
38089566063dSJacob Faibussowitsch   PetscCall(DMViewFromOptions(sdm, NULL, "-dm_view"));
38099566063dSJacob Faibussowitsch   PetscCall(DMPlexGenerate(sdm, NULL, PETSC_TRUE, &vol));
38109566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&sdm));
381169d8a87bSksagiyam   PetscCall(DMPlexReplace_Internal(dm, &vol));
38129566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, "marker"));
38139566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "marker", &bdlabel));
38149566063dSJacob Faibussowitsch   PetscCall(DMPlexMarkBoundaryFaces(dm, PETSC_DETERMINE, bdlabel));
38159566063dSJacob Faibussowitsch   PetscCall(DMPlexLabelComplete(dm, bdlabel));
38163ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
381751a74b61SMatthew G. Knepley }
381851a74b61SMatthew G. Knepley 
381951a74b61SMatthew G. Knepley /*@
382051a74b61SMatthew G. Knepley   DMPlexCreateBallMesh - Creates a simplex mesh on the d-dimensional ball, B^d.
382151a74b61SMatthew G. Knepley 
382251a74b61SMatthew G. Knepley   Collective
382351a74b61SMatthew G. Knepley 
382451a74b61SMatthew G. Knepley   Input Parameters:
3825a1cb98faSBarry Smith + comm - The communicator for the `DM` object
382651a74b61SMatthew G. Knepley . dim  - The dimension
382751a74b61SMatthew G. Knepley - R    - The radius
382851a74b61SMatthew G. Knepley 
382951a74b61SMatthew G. Knepley   Output Parameter:
3830a1cb98faSBarry Smith . dm - The `DM` object
383151a74b61SMatthew G. Knepley 
3832a1cb98faSBarry Smith   Options Database Key:
383360225df5SJacob Faibussowitsch . bd_dm_refine - This will refine the surface mesh preserving the sphere geometry
383451a74b61SMatthew G. Knepley 
383551a74b61SMatthew G. Knepley   Level: beginner
383651a74b61SMatthew G. Knepley 
38371cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateSphereMesh()`, `DMPlexCreateBoxMesh()`, `DMSetType()`, `DMCreate()`
383851a74b61SMatthew G. Knepley @*/
3839d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateBallMesh(MPI_Comm comm, PetscInt dim, PetscReal R, DM *dm)
3840d71ae5a4SJacob Faibussowitsch {
384151a74b61SMatthew G. Knepley   PetscFunctionBegin;
38429566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
38439566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
38449566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateBallMesh_Internal(*dm, dim, R));
38453ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
38462829fed8SMatthew G. Knepley }
38472829fed8SMatthew G. Knepley 
3848d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateReferenceCell_Internal(DM rdm, DMPolytopeType ct)
3849d71ae5a4SJacob Faibussowitsch {
38500a6ba040SMatthew G. Knepley   PetscFunctionBegin;
38519318fe57SMatthew G. Knepley   switch (ct) {
38529371c9d4SSatish Balay   case DM_POLYTOPE_POINT: {
38539318fe57SMatthew G. Knepley     PetscInt    numPoints[1]        = {1};
38549318fe57SMatthew G. Knepley     PetscInt    coneSize[1]         = {0};
38559318fe57SMatthew G. Knepley     PetscInt    cones[1]            = {0};
38569318fe57SMatthew G. Knepley     PetscInt    coneOrientations[1] = {0};
38579318fe57SMatthew G. Knepley     PetscScalar vertexCoords[1]     = {0.0};
38589318fe57SMatthew G. Knepley 
38599566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 0));
38609566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 0, numPoints, coneSize, cones, coneOrientations, vertexCoords));
38619371c9d4SSatish Balay   } break;
38629371c9d4SSatish Balay   case DM_POLYTOPE_SEGMENT: {
38639318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {2, 1};
38649318fe57SMatthew G. Knepley     PetscInt    coneSize[3]         = {2, 0, 0};
38659318fe57SMatthew G. Knepley     PetscInt    cones[2]            = {1, 2};
38669318fe57SMatthew G. Knepley     PetscInt    coneOrientations[2] = {0, 0};
38679318fe57SMatthew G. Knepley     PetscScalar vertexCoords[2]     = {-1.0, 1.0};
38689318fe57SMatthew G. Knepley 
38699566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 1));
38709566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
38719371c9d4SSatish Balay   } break;
38729371c9d4SSatish Balay   case DM_POLYTOPE_POINT_PRISM_TENSOR: {
3873b5a892a1SMatthew G. Knepley     PetscInt    numPoints[2]        = {2, 1};
3874b5a892a1SMatthew G. Knepley     PetscInt    coneSize[3]         = {2, 0, 0};
3875b5a892a1SMatthew G. Knepley     PetscInt    cones[2]            = {1, 2};
3876b5a892a1SMatthew G. Knepley     PetscInt    coneOrientations[2] = {0, 0};
3877b5a892a1SMatthew G. Knepley     PetscScalar vertexCoords[2]     = {-1.0, 1.0};
3878b5a892a1SMatthew G. Knepley 
38799566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 1));
38809566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
38819371c9d4SSatish Balay   } break;
38829371c9d4SSatish Balay   case DM_POLYTOPE_TRIANGLE: {
38839318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {3, 1};
38849318fe57SMatthew G. Knepley     PetscInt    coneSize[4]         = {3, 0, 0, 0};
38859318fe57SMatthew G. Knepley     PetscInt    cones[3]            = {1, 2, 3};
38869318fe57SMatthew G. Knepley     PetscInt    coneOrientations[3] = {0, 0, 0};
38879318fe57SMatthew G. Knepley     PetscScalar vertexCoords[6]     = {-1.0, -1.0, 1.0, -1.0, -1.0, 1.0};
38889318fe57SMatthew G. Knepley 
38899566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
38909566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
38919371c9d4SSatish Balay   } break;
38929371c9d4SSatish Balay   case DM_POLYTOPE_QUADRILATERAL: {
38939318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
38949318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
38959318fe57SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
38969318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
38979318fe57SMatthew G. Knepley     PetscScalar vertexCoords[8]     = {-1.0, -1.0, 1.0, -1.0, 1.0, 1.0, -1.0, 1.0};
38989318fe57SMatthew G. Knepley 
38999566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
39009566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
39019371c9d4SSatish Balay   } break;
39029371c9d4SSatish Balay   case DM_POLYTOPE_SEG_PRISM_TENSOR: {
39039318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
39049318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
39059318fe57SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
39069318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
39079318fe57SMatthew G. Knepley     PetscScalar vertexCoords[8]     = {-1.0, -1.0, 1.0, -1.0, -1.0, 1.0, 1.0, 1.0};
39089318fe57SMatthew G. Knepley 
39099566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 2));
39109566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
39119371c9d4SSatish Balay   } break;
39129371c9d4SSatish Balay   case DM_POLYTOPE_TETRAHEDRON: {
39139318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {4, 1};
39149318fe57SMatthew G. Knepley     PetscInt    coneSize[5]         = {4, 0, 0, 0, 0};
3915f0edb160SMatthew G. Knepley     PetscInt    cones[4]            = {1, 2, 3, 4};
39169318fe57SMatthew G. Knepley     PetscInt    coneOrientations[4] = {0, 0, 0, 0};
3917f0edb160SMatthew 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};
39189318fe57SMatthew G. Knepley 
39199566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
39209566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
39219371c9d4SSatish Balay   } break;
39229371c9d4SSatish Balay   case DM_POLYTOPE_HEXAHEDRON: {
39239318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {8, 1};
39249318fe57SMatthew G. Knepley     PetscInt    coneSize[9]         = {8, 0, 0, 0, 0, 0, 0, 0, 0};
3925f0edb160SMatthew G. Knepley     PetscInt    cones[8]            = {1, 2, 3, 4, 5, 6, 7, 8};
39269318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
39279371c9d4SSatish 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};
39289318fe57SMatthew G. Knepley 
39299566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
39309566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
39319371c9d4SSatish Balay   } break;
39329371c9d4SSatish Balay   case DM_POLYTOPE_TRI_PRISM: {
39339318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {6, 1};
39349318fe57SMatthew G. Knepley     PetscInt    coneSize[7]         = {6, 0, 0, 0, 0, 0, 0};
3935f0edb160SMatthew G. Knepley     PetscInt    cones[6]            = {1, 2, 3, 4, 5, 6};
39369318fe57SMatthew G. Knepley     PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
39379371c9d4SSatish 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};
39389318fe57SMatthew G. Knepley 
39399566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
39409566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
39419371c9d4SSatish Balay   } break;
39429371c9d4SSatish Balay   case DM_POLYTOPE_TRI_PRISM_TENSOR: {
39439318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {6, 1};
39449318fe57SMatthew G. Knepley     PetscInt    coneSize[7]         = {6, 0, 0, 0, 0, 0, 0};
39459318fe57SMatthew G. Knepley     PetscInt    cones[6]            = {1, 2, 3, 4, 5, 6};
39469318fe57SMatthew G. Knepley     PetscInt    coneOrientations[6] = {0, 0, 0, 0, 0, 0};
39479371c9d4SSatish 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};
39489318fe57SMatthew G. Knepley 
39499566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
39509566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
39519371c9d4SSatish Balay   } break;
39529371c9d4SSatish Balay   case DM_POLYTOPE_QUAD_PRISM_TENSOR: {
39539318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {8, 1};
39549318fe57SMatthew G. Knepley     PetscInt    coneSize[9]         = {8, 0, 0, 0, 0, 0, 0, 0, 0};
39559318fe57SMatthew G. Knepley     PetscInt    cones[8]            = {1, 2, 3, 4, 5, 6, 7, 8};
39569318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
39579371c9d4SSatish 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};
39589318fe57SMatthew G. Knepley 
39599566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
39609566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
39619371c9d4SSatish Balay   } break;
39629371c9d4SSatish Balay   case DM_POLYTOPE_PYRAMID: {
39639318fe57SMatthew G. Knepley     PetscInt    numPoints[2]        = {5, 1};
39649318fe57SMatthew G. Knepley     PetscInt    coneSize[6]         = {5, 0, 0, 0, 0, 0};
3965f0edb160SMatthew G. Knepley     PetscInt    cones[5]            = {1, 2, 3, 4, 5};
39669318fe57SMatthew G. Knepley     PetscInt    coneOrientations[8] = {0, 0, 0, 0, 0, 0, 0, 0};
39679371c9d4SSatish 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};
39689318fe57SMatthew G. Knepley 
39699566063dSJacob Faibussowitsch     PetscCall(DMSetDimension(rdm, 3));
39709566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFromDAG(rdm, 1, numPoints, coneSize, cones, coneOrientations, vertexCoords));
39719371c9d4SSatish Balay   } break;
3972d71ae5a4SJacob Faibussowitsch   default:
3973d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)rdm), PETSC_ERR_ARG_WRONG, "Cannot create reference cell for cell type %s", DMPolytopeTypes[ct]);
39749318fe57SMatthew G. Knepley   }
39759318fe57SMatthew G. Knepley   {
39769318fe57SMatthew G. Knepley     PetscInt Nv, v;
39779318fe57SMatthew G. Knepley 
39789318fe57SMatthew G. Knepley     /* Must create the celltype label here so that we do not automatically try to compute the types */
39799566063dSJacob Faibussowitsch     PetscCall(DMCreateLabel(rdm, "celltype"));
39809566063dSJacob Faibussowitsch     PetscCall(DMPlexSetCellType(rdm, 0, ct));
39819566063dSJacob Faibussowitsch     PetscCall(DMPlexGetChart(rdm, NULL, &Nv));
39829566063dSJacob Faibussowitsch     for (v = 1; v < Nv; ++v) PetscCall(DMPlexSetCellType(rdm, v, DM_POLYTOPE_POINT));
39839318fe57SMatthew G. Knepley   }
39849566063dSJacob Faibussowitsch   PetscCall(DMPlexInterpolateInPlace_Internal(rdm));
39859566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)rdm, DMPolytopeTypes[ct]));
39863ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
39870a6ba040SMatthew G. Knepley }
39880a6ba040SMatthew G. Knepley 
39899318fe57SMatthew G. Knepley /*@
3990a1cb98faSBarry Smith   DMPlexCreateReferenceCell - Create a `DMPLEX` with the appropriate FEM reference cell
39919318fe57SMatthew G. Knepley 
39929318fe57SMatthew G. Knepley   Collective
39939318fe57SMatthew G. Knepley 
39949318fe57SMatthew G. Knepley   Input Parameters:
39959318fe57SMatthew G. Knepley + comm - The communicator
39969318fe57SMatthew G. Knepley - ct   - The cell type of the reference cell
39979318fe57SMatthew G. Knepley 
39989318fe57SMatthew G. Knepley   Output Parameter:
39999318fe57SMatthew G. Knepley . refdm - The reference cell
40009318fe57SMatthew G. Knepley 
40019318fe57SMatthew G. Knepley   Level: intermediate
40029318fe57SMatthew G. Knepley 
400342747ad1SJacob Faibussowitsch .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateBoxMesh()`
40049318fe57SMatthew G. Knepley @*/
4005d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateReferenceCell(MPI_Comm comm, DMPolytopeType ct, DM *refdm)
4006d71ae5a4SJacob Faibussowitsch {
40070a6ba040SMatthew G. Knepley   PetscFunctionBegin;
40089566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, refdm));
40099566063dSJacob Faibussowitsch   PetscCall(DMSetType(*refdm, DMPLEX));
40109566063dSJacob Faibussowitsch   PetscCall(DMPlexCreateReferenceCell_Internal(*refdm, ct));
40113ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
40129318fe57SMatthew G. Knepley }
401379a015ccSMatthew G. Knepley 
4014d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateBoundaryLabel_Private(DM dm, const char name[])
4015d71ae5a4SJacob Faibussowitsch {
40169318fe57SMatthew G. Knepley   DM        plex;
40179318fe57SMatthew G. Knepley   DMLabel   label;
40189318fe57SMatthew G. Knepley   PetscBool hasLabel;
40190a6ba040SMatthew G. Knepley 
4020c22d3578SMatthew G. Knepley   PetscFunctionBegin;
40219566063dSJacob Faibussowitsch   PetscCall(DMHasLabel(dm, name, &hasLabel));
40223ba16761SJacob Faibussowitsch   if (hasLabel) PetscFunctionReturn(PETSC_SUCCESS);
40239566063dSJacob Faibussowitsch   PetscCall(DMCreateLabel(dm, name));
40249566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, name, &label));
40259566063dSJacob Faibussowitsch   PetscCall(DMConvert(dm, DMPLEX, &plex));
40269566063dSJacob Faibussowitsch   PetscCall(DMPlexMarkBoundaryFaces(plex, 1, label));
40271c8afea9SMatthew G. Knepley   PetscCall(DMPlexLabelComplete(plex, label));
40289566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&plex));
40293ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
40309318fe57SMatthew G. Knepley }
4031acdc6f61SToby Isaac 
4032669647acSMatthew G. Knepley /*
4033669647acSMatthew 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.
4034669647acSMatthew G. Knepley 
4035669647acSMatthew G. Knepley     (x, y) -> (r, theta) = (x[1], (x[0] - lower[0]) * 2\pi/(upper[0] - lower[0]))
4036669647acSMatthew G. Knepley */
4037d71ae5a4SJacob 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[])
4038d71ae5a4SJacob Faibussowitsch {
4039669647acSMatthew G. Knepley   const PetscReal low = PetscRealPart(constants[0]);
4040669647acSMatthew G. Knepley   const PetscReal upp = PetscRealPart(constants[1]);
4041669647acSMatthew G. Knepley   const PetscReal r   = PetscRealPart(u[1]);
4042669647acSMatthew G. Knepley   const PetscReal th  = 2. * PETSC_PI * (PetscRealPart(u[0]) - low) / (upp - low);
4043669647acSMatthew G. Knepley 
4044669647acSMatthew G. Knepley   f0[0] = r * PetscCosReal(th);
4045669647acSMatthew G. Knepley   f0[1] = r * PetscSinReal(th);
4046669647acSMatthew G. Knepley }
4047669647acSMatthew G. Knepley 
40485390be7dSMatthew G. Knepley // Insert vertices and their joins, marked by depth
40495390be7dSMatthew G. Knepley static PetscErrorCode ProcessCohesiveLabel_Vertices(DM dm, DMLabel label, DMLabel vlabel, PetscInt val, PetscInt n, const PetscInt vertices[])
40505390be7dSMatthew G. Knepley {
40515390be7dSMatthew G. Knepley   PetscFunctionBegin;
40525390be7dSMatthew G. Knepley   PetscCall(DMPlexMarkSubmesh_Interpolated(dm, vlabel, val, PETSC_FALSE, PETSC_FALSE, label, NULL));
40535390be7dSMatthew G. Knepley   PetscFunctionReturn(PETSC_SUCCESS);
40545390be7dSMatthew G. Knepley }
40555390be7dSMatthew G. Knepley 
40565390be7dSMatthew G. Knepley // Insert faces and their closures, marked by depth
40575390be7dSMatthew G. Knepley static PetscErrorCode ProcessCohesiveLabel_Faces(DM dm, DMLabel label, PetscInt n, const PetscInt faces[])
40585390be7dSMatthew G. Knepley {
40595390be7dSMatthew G. Knepley   PetscFunctionBegin;
40605390be7dSMatthew G. Knepley   for (PetscInt p = 0; p < n; ++p) {
40615390be7dSMatthew G. Knepley     const PetscInt point   = faces[p];
40625390be7dSMatthew G. Knepley     PetscInt      *closure = NULL;
40635390be7dSMatthew G. Knepley     PetscInt       clSize, pdepth;
40645390be7dSMatthew G. Knepley 
40655390be7dSMatthew G. Knepley     PetscCall(DMPlexGetPointDepth(dm, point, &pdepth));
40665390be7dSMatthew G. Knepley     PetscCall(DMLabelSetValue(label, point, pdepth));
40675390be7dSMatthew G. Knepley     PetscCall(DMPlexGetTransitiveClosure(dm, point, PETSC_TRUE, &clSize, &closure));
40685390be7dSMatthew G. Knepley     for (PetscInt cl = 0; cl < clSize * 2; cl += 2) {
40695390be7dSMatthew G. Knepley       PetscCall(DMPlexGetPointDepth(dm, closure[cl], &pdepth));
40705390be7dSMatthew G. Knepley       PetscCall(DMLabelSetValue(label, closure[cl], pdepth));
40715390be7dSMatthew G. Knepley     }
40725390be7dSMatthew G. Knepley     PetscCall(DMPlexRestoreTransitiveClosure(dm, point, PETSC_TRUE, &clSize, &closure));
40735390be7dSMatthew G. Knepley   }
40745390be7dSMatthew G. Knepley   PetscFunctionReturn(PETSC_SUCCESS);
40755390be7dSMatthew G. Knepley }
40765390be7dSMatthew G. Knepley 
40774e22dd4cSMatthew G. Knepley PETSC_EXTERN PetscErrorCode PetscOptionsFindPairPrefix_Private(PetscOptions, const char pre[], const char name[], const char *option[], const char *value[], PetscBool *flg);
40784e22dd4cSMatthew G. Knepley 
40795dca41c3SJed Brown const char *const DMPlexShapes[] = {"box", "box_surface", "ball", "sphere", "cylinder", "schwarz_p", "gyroid", "doublet", "annulus", "hypercubic", "zbox", "unknown", "DMPlexShape", "DM_SHAPE_", NULL};
40809318fe57SMatthew G. Knepley 
4081d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCreateFromOptions_Internal(PetscOptionItems *PetscOptionsObject, PetscBool *useCoordSpace, DM dm)
4082d71ae5a4SJacob Faibussowitsch {
40839318fe57SMatthew G. Knepley   DMPlexShape    shape   = DM_SHAPE_BOX;
40849318fe57SMatthew G. Knepley   DMPolytopeType cell    = DM_POLYTOPE_TRIANGLE;
40859318fe57SMatthew G. Knepley   PetscInt       dim     = 2;
40869318fe57SMatthew G. Knepley   PetscBool      simplex = PETSC_TRUE, interpolate = PETSC_TRUE, adjCone = PETSC_FALSE, adjClosure = PETSC_TRUE, refDomain = PETSC_FALSE;
4087d0812dedSMatthew G. Knepley   PetscBool      flg, flg2, fflg, strflg, bdfflg, nameflg;
40889318fe57SMatthew G. Knepley   MPI_Comm       comm;
4089ed5e4e85SVaclav Hapla   char           filename[PETSC_MAX_PATH_LEN]   = "<unspecified>";
4090ed5e4e85SVaclav Hapla   char           bdFilename[PETSC_MAX_PATH_LEN] = "<unspecified>";
4091ed5e4e85SVaclav Hapla   char           plexname[PETSC_MAX_PATH_LEN]   = "";
40924e22dd4cSMatthew G. Knepley   const char    *option;
40939318fe57SMatthew G. Knepley 
40949318fe57SMatthew G. Knepley   PetscFunctionBegin;
4095708be2fdSJed Brown   PetscCall(PetscLogEventBegin(DMPLEX_CreateFromOptions, dm, 0, 0, 0));
40969566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)dm, &comm));
40979318fe57SMatthew G. Knepley   /* TODO Turn this into a registration interface */
40989566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_filename", "File containing a mesh", "DMPlexCreateFromFile", filename, filename, sizeof(filename), &fflg));
4099d0812dedSMatthew G. Knepley   PetscCall(PetscOptionsString("-dm_plex_file_contents", "Contents of a file format in a string", "DMPlexCreateFromFile", filename, filename, sizeof(filename), &strflg));
41009566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_boundary_filename", "File containing a mesh boundary", "DMPlexCreateFromFile", bdFilename, bdFilename, sizeof(bdFilename), &bdfflg));
41019566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_name", "Name of the mesh in the file", "DMPlexCreateFromFile", plexname, plexname, sizeof(plexname), &nameflg));
41029566063dSJacob Faibussowitsch   PetscCall(PetscOptionsEnum("-dm_plex_cell", "Cell shape", "", DMPolytopeTypes, (PetscEnum)cell, (PetscEnum *)&cell, NULL));
41039566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_reference_cell_domain", "Use a reference cell domain", "", refDomain, &refDomain, NULL));
41049566063dSJacob Faibussowitsch   PetscCall(PetscOptionsEnum("-dm_plex_shape", "Shape for built-in mesh", "", DMPlexShapes, (PetscEnum)shape, (PetscEnum *)&shape, &flg));
41059566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_plex_dim", "Topological dimension of the mesh", "DMGetDimension", dim, &dim, &flg, 0));
41069566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_simplex", "Mesh cell shape", "", simplex, &simplex, &flg));
41079566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_interpolate", "Flag to create edges and faces automatically", "", interpolate, &interpolate, &flg));
41089566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_adj_cone", "Set adjacency direction", "DMSetBasicAdjacency", adjCone, &adjCone, &flg));
41099566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_adj_closure", "Set adjacency size", "DMSetBasicAdjacency", adjClosure, &adjClosure, &flg2));
41109566063dSJacob Faibussowitsch   if (flg || flg2) PetscCall(DMSetBasicAdjacency(dm, adjCone, adjClosure));
41119318fe57SMatthew G. Knepley 
411261a622f3SMatthew G. Knepley   switch (cell) {
411361a622f3SMatthew G. Knepley   case DM_POLYTOPE_POINT:
411461a622f3SMatthew G. Knepley   case DM_POLYTOPE_SEGMENT:
411561a622f3SMatthew G. Knepley   case DM_POLYTOPE_POINT_PRISM_TENSOR:
411661a622f3SMatthew G. Knepley   case DM_POLYTOPE_TRIANGLE:
411761a622f3SMatthew G. Knepley   case DM_POLYTOPE_QUADRILATERAL:
411861a622f3SMatthew G. Knepley   case DM_POLYTOPE_TETRAHEDRON:
4119d71ae5a4SJacob Faibussowitsch   case DM_POLYTOPE_HEXAHEDRON:
4120d71ae5a4SJacob Faibussowitsch     *useCoordSpace = PETSC_TRUE;
4121d71ae5a4SJacob Faibussowitsch     break;
4122d71ae5a4SJacob Faibussowitsch   default:
4123d71ae5a4SJacob Faibussowitsch     *useCoordSpace = PETSC_FALSE;
4124d71ae5a4SJacob Faibussowitsch     break;
412561a622f3SMatthew G. Knepley   }
412661a622f3SMatthew G. Knepley 
41279318fe57SMatthew G. Knepley   if (fflg) {
41289318fe57SMatthew G. Knepley     DM          dmnew;
41291e4a82c4SMatthew G. Knepley     const char *name;
41309318fe57SMatthew G. Knepley 
41311e4a82c4SMatthew G. Knepley     PetscCall(PetscObjectGetName((PetscObject)dm, &name));
41321e4a82c4SMatthew G. Knepley     PetscCall(DMPlexCreateFromFile(PetscObjectComm((PetscObject)dm), filename, nameflg ? plexname : name, interpolate, &dmnew));
41335de52c6dSVaclav Hapla     PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
413469d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmnew));
41359318fe57SMatthew G. Knepley   } else if (refDomain) {
41369566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateReferenceCell_Internal(dm, cell));
41379318fe57SMatthew G. Knepley   } else if (bdfflg) {
41389318fe57SMatthew G. Knepley     DM          bdm, dmnew;
41391e4a82c4SMatthew G. Knepley     const char *name;
41409318fe57SMatthew G. Knepley 
41411e4a82c4SMatthew G. Knepley     PetscCall(PetscObjectGetName((PetscObject)dm, &name));
41421e4a82c4SMatthew G. Knepley     PetscCall(DMPlexCreateFromFile(PetscObjectComm((PetscObject)dm), bdFilename, nameflg ? plexname : name, interpolate, &bdm));
41439566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)bdm, "bd_"));
41449566063dSJacob Faibussowitsch     PetscCall(DMSetFromOptions(bdm));
41459566063dSJacob Faibussowitsch     PetscCall(DMPlexGenerate(bdm, NULL, interpolate, &dmnew));
41469566063dSJacob Faibussowitsch     PetscCall(DMDestroy(&bdm));
41475de52c6dSVaclav Hapla     PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
414869d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &dmnew));
4149d0812dedSMatthew G. Knepley   } else if (strflg) {
4150d0812dedSMatthew G. Knepley     DM          dmnew;
4151d0812dedSMatthew G. Knepley     PetscViewer viewer;
4152d0812dedSMatthew G. Knepley     const char *contents;
4153d0812dedSMatthew G. Knepley     char       *strname;
4154d0812dedSMatthew G. Knepley     char        tmpdir[PETSC_MAX_PATH_LEN];
4155d0812dedSMatthew G. Knepley     char        tmpfilename[PETSC_MAX_PATH_LEN];
4156d0812dedSMatthew G. Knepley     char        name[PETSC_MAX_PATH_LEN];
4157d0812dedSMatthew G. Knepley     MPI_Comm    comm;
4158d0812dedSMatthew G. Knepley     PetscMPIInt rank;
4159d0812dedSMatthew G. Knepley 
4160d0812dedSMatthew G. Knepley     PetscCall(PetscObjectGetComm((PetscObject)dm, &comm));
4161d0812dedSMatthew G. Knepley     PetscCallMPI(MPI_Comm_rank(comm, &rank));
4162d0812dedSMatthew G. Knepley     PetscCall(PetscStrchr(filename, ':', &strname));
4163d0812dedSMatthew G. Knepley     PetscCheck(strname, comm, PETSC_ERR_ARG_WRONG, "File contents must have the form \"ext:string_name\", not %s", filename);
4164d0812dedSMatthew G. Knepley     strname[0] = '\0';
4165d0812dedSMatthew G. Knepley     ++strname;
4166d0812dedSMatthew G. Knepley     PetscCall(PetscDLSym(NULL, strname, (void **)&contents));
4167d0812dedSMatthew G. Knepley     PetscCheck(contents, comm, PETSC_ERR_ARG_WRONG, "Could not locate mesh string %s", strname);
4168d0812dedSMatthew G. Knepley     PetscCall(PetscGetTmp(comm, tmpdir, PETSC_MAX_PATH_LEN));
4169ed32af8cSMatthew G. Knepley     PetscCall(PetscStrlcat(tmpdir, "/meshXXXXXX", PETSC_MAX_PATH_LEN));
4170ed32af8cSMatthew G. Knepley     PetscCall(PetscMkdtemp(tmpdir));
4171ed32af8cSMatthew G. Knepley     PetscCall(PetscSNPrintf(tmpfilename, PETSC_MAX_PATH_LEN, "%s/mesh.%s", tmpdir, filename));
4172d0812dedSMatthew G. Knepley     PetscCall(PetscViewerASCIIOpen(comm, tmpfilename, &viewer));
4173d0812dedSMatthew G. Knepley     PetscCall(PetscViewerASCIIPrintf(viewer, "%s\n", contents));
4174d0812dedSMatthew G. Knepley     PetscCall(PetscViewerDestroy(&viewer));
4175d0812dedSMatthew G. Knepley     PetscCall(DMPlexCreateFromFile(PetscObjectComm((PetscObject)dm), tmpfilename, plexname, interpolate, &dmnew));
4176ed32af8cSMatthew G. Knepley     PetscCall(PetscRMTree(tmpdir));
4177d0812dedSMatthew G. Knepley     PetscCall(PetscSNPrintf(name, PETSC_MAX_PATH_LEN, "%s Mesh", strname));
4178d0812dedSMatthew G. Knepley     PetscCall(PetscObjectSetName((PetscObject)dm, name));
4179d0812dedSMatthew G. Knepley     PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
4180d0812dedSMatthew G. Knepley     PetscCall(DMPlexReplace_Internal(dm, &dmnew));
41819318fe57SMatthew G. Knepley   } else {
41829566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)dm, DMPlexShapes[shape]));
41839318fe57SMatthew G. Knepley     switch (shape) {
4184669647acSMatthew G. Knepley     case DM_SHAPE_BOX:
41855dca41c3SJed Brown     case DM_SHAPE_ZBOX:
4186669647acSMatthew G. Knepley     case DM_SHAPE_ANNULUS: {
41879318fe57SMatthew G. Knepley       PetscInt       faces[3]  = {0, 0, 0};
41889318fe57SMatthew G. Knepley       PetscReal      lower[3]  = {0, 0, 0};
41899318fe57SMatthew G. Knepley       PetscReal      upper[3]  = {1, 1, 1};
41909318fe57SMatthew G. Knepley       DMBoundaryType bdt[3]    = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
4191669647acSMatthew G. Knepley       PetscBool      isAnnular = shape == DM_SHAPE_ANNULUS ? PETSC_TRUE : PETSC_FALSE;
41929318fe57SMatthew G. Knepley       PetscInt       i, n;
41939318fe57SMatthew G. Knepley 
41949318fe57SMatthew G. Knepley       n = dim;
41959318fe57SMatthew G. Knepley       for (i = 0; i < dim; ++i) faces[i] = (dim == 1 ? 1 : 4 - dim);
41969566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", faces, &n, &flg));
41979318fe57SMatthew G. Knepley       n = 3;
41989566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
419963a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Lower box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
42009318fe57SMatthew G. Knepley       n = 3;
42019566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
420263a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Upper box point had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
42039318fe57SMatthew G. Knepley       n = 3;
42049566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnumArray("-dm_plex_box_bd", "Boundary type for each dimension", "", DMBoundaryTypes, (PetscEnum *)bdt, &n, &flg));
420563a3b9bcSJacob Faibussowitsch       PetscCheck(!flg || !(n != dim), comm, PETSC_ERR_ARG_SIZ, "Box boundary types had %" PetscInt_FMT " values, should have been %" PetscInt_FMT, n, dim);
4206669647acSMatthew G. Knepley 
4207669647acSMatthew G. Knepley       PetscCheck(!isAnnular || dim == 2, comm, PETSC_ERR_ARG_OUTOFRANGE, "Only two dimensional annuli have been implemented");
4208669647acSMatthew G. Knepley       if (isAnnular)
4209669647acSMatthew G. Knepley         for (i = 0; i < dim - 1; ++i) bdt[i] = DM_BOUNDARY_PERIODIC;
4210669647acSMatthew G. Knepley 
42119318fe57SMatthew G. Knepley       switch (cell) {
421261a622f3SMatthew G. Knepley       case DM_POLYTOPE_TRI_PRISM_TENSOR:
42139566063dSJacob Faibussowitsch         PetscCall(DMPlexCreateWedgeBoxMesh_Internal(dm, faces, lower, upper, bdt));
4214d410b0cfSMatthew G. Knepley         if (!interpolate) {
4215d410b0cfSMatthew G. Knepley           DM udm;
4216d410b0cfSMatthew G. Knepley 
42179566063dSJacob Faibussowitsch           PetscCall(DMPlexUninterpolate(dm, &udm));
421869d8a87bSksagiyam           PetscCall(DMPlexReplace_Internal(dm, &udm));
4219d410b0cfSMatthew G. Knepley         }
42209318fe57SMatthew G. Knepley         break;
4221d71ae5a4SJacob Faibussowitsch       default:
42225dca41c3SJed Brown         PetscCall(DMPlexCreateBoxMesh_Internal(dm, shape, dim, simplex, faces, lower, upper, bdt, interpolate));
4223d71ae5a4SJacob Faibussowitsch         break;
42249318fe57SMatthew G. Knepley       }
4225669647acSMatthew G. Knepley       if (isAnnular) {
4226669647acSMatthew G. Knepley         DM          cdm;
4227669647acSMatthew G. Knepley         PetscDS     cds;
4228669647acSMatthew G. Knepley         PetscScalar bounds[2] = {lower[0], upper[0]};
4229669647acSMatthew G. Knepley 
4230669647acSMatthew G. Knepley         // Fix coordinates for annular region
4231669647acSMatthew G. Knepley         PetscCall(DMSetPeriodicity(dm, NULL, NULL, NULL));
4232669647acSMatthew G. Knepley         PetscCall(DMSetCellCoordinatesLocal(dm, NULL));
4233669647acSMatthew G. Knepley         PetscCall(DMSetCellCoordinates(dm, NULL));
4234e44f6aebSMatthew G. Knepley         PetscCall(DMPlexCreateCoordinateSpace(dm, 1, PETSC_TRUE, NULL));
4235669647acSMatthew G. Knepley         PetscCall(DMGetCoordinateDM(dm, &cdm));
4236669647acSMatthew G. Knepley         PetscCall(DMGetDS(cdm, &cds));
4237669647acSMatthew G. Knepley         PetscCall(PetscDSSetConstants(cds, 2, bounds));
4238669647acSMatthew G. Knepley         PetscCall(DMPlexRemapGeometry(dm, 0.0, boxToAnnulus));
4239669647acSMatthew G. Knepley       }
42409371c9d4SSatish Balay     } break;
42419371c9d4SSatish Balay     case DM_SHAPE_BOX_SURFACE: {
42429318fe57SMatthew G. Knepley       PetscInt  faces[3] = {0, 0, 0};
42439318fe57SMatthew G. Knepley       PetscReal lower[3] = {0, 0, 0};
42449318fe57SMatthew G. Knepley       PetscReal upper[3] = {1, 1, 1};
42459318fe57SMatthew G. Knepley       PetscInt  i, n;
42469318fe57SMatthew G. Knepley 
42479318fe57SMatthew G. Knepley       n = dim + 1;
42489318fe57SMatthew G. Knepley       for (i = 0; i < dim + 1; ++i) faces[i] = (dim + 1 == 1 ? 1 : 4 - (dim + 1));
42499566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", faces, &n, &flg));
42509318fe57SMatthew G. Knepley       n = 3;
42519566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
425263a3b9bcSJacob 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);
42539318fe57SMatthew G. Knepley       n = 3;
42549566063dSJacob Faibussowitsch       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
425563a3b9bcSJacob 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);
42569566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateBoxSurfaceMesh_Internal(dm, dim + 1, faces, lower, upper, interpolate));
42579371c9d4SSatish Balay     } break;
42589371c9d4SSatish Balay     case DM_SHAPE_SPHERE: {
42599318fe57SMatthew G. Knepley       PetscReal R = 1.0;
42609318fe57SMatthew G. Knepley 
42619566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_sphere_radius", "Radius of the sphere", "", R, &R, &flg));
42629566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateSphereMesh_Internal(dm, dim, simplex, R));
42639371c9d4SSatish Balay     } break;
42649371c9d4SSatish Balay     case DM_SHAPE_BALL: {
42659318fe57SMatthew G. Knepley       PetscReal R = 1.0;
42669318fe57SMatthew G. Knepley 
42679566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_ball_radius", "Radius of the ball", "", R, &R, &flg));
42689566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateBallMesh_Internal(dm, dim, R));
42699371c9d4SSatish Balay     } break;
42709371c9d4SSatish Balay     case DM_SHAPE_CYLINDER: {
42719318fe57SMatthew G. Knepley       DMBoundaryType bdt = DM_BOUNDARY_NONE;
42729318fe57SMatthew G. Knepley       PetscInt       Nw  = 6;
427349704ca5SMatthew G. Knepley       PetscInt       Nr  = 0;
42749318fe57SMatthew G. Knepley 
42759566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnum("-dm_plex_cylinder_bd", "Boundary type in the z direction", "", DMBoundaryTypes, (PetscEnum)bdt, (PetscEnum *)&bdt, NULL));
42769566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_cylinder_num_wedges", "Number of wedges around the cylinder", "", Nw, &Nw, NULL));
427749704ca5SMatthew G. Knepley       PetscCall(PetscOptionsInt("-dm_plex_cylinder_num_refine", "Number of refinements before projection", "", Nr, &Nr, NULL));
42789318fe57SMatthew G. Knepley       switch (cell) {
4279d71ae5a4SJacob Faibussowitsch       case DM_POLYTOPE_TRI_PRISM_TENSOR:
4280d71ae5a4SJacob Faibussowitsch         PetscCall(DMPlexCreateWedgeCylinderMesh_Internal(dm, Nw, interpolate));
4281d71ae5a4SJacob Faibussowitsch         break;
4282d71ae5a4SJacob Faibussowitsch       default:
428349704ca5SMatthew G. Knepley         PetscCall(DMPlexCreateHexCylinderMesh_Internal(dm, bdt, Nr));
4284d71ae5a4SJacob Faibussowitsch         break;
42859318fe57SMatthew G. Knepley       }
42869371c9d4SSatish Balay     } break;
4287b7f5c055SJed Brown     case DM_SHAPE_SCHWARZ_P: // fallthrough
42889371c9d4SSatish Balay     case DM_SHAPE_GYROID: {
4289b7f5c055SJed Brown       PetscInt       extent[3] = {1, 1, 1}, refine = 0, layers = 0, three;
4290b7f5c055SJed Brown       PetscReal      thickness   = 0.;
4291b7f5c055SJed Brown       DMBoundaryType periodic[3] = {DM_BOUNDARY_NONE, DM_BOUNDARY_NONE, DM_BOUNDARY_NONE};
4292b7f5c055SJed Brown       DMPlexTPSType  tps_type    = shape == DM_SHAPE_SCHWARZ_P ? DMPLEX_TPS_SCHWARZ_P : DMPLEX_TPS_GYROID;
42931436d7faSJed Brown       PetscBool      tps_distribute;
42949566063dSJacob Faibussowitsch       PetscCall(PetscOptionsIntArray("-dm_plex_tps_extent", "Number of replicas for each of three dimensions", NULL, extent, (three = 3, &three), NULL));
42959566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_tps_refine", "Number of refinements", NULL, refine, &refine, NULL));
42969566063dSJacob Faibussowitsch       PetscCall(PetscOptionsEnumArray("-dm_plex_tps_periodic", "Periodicity in each of three dimensions", NULL, DMBoundaryTypes, (PetscEnum *)periodic, (three = 3, &three), NULL));
42979566063dSJacob Faibussowitsch       PetscCall(PetscOptionsInt("-dm_plex_tps_layers", "Number of layers in volumetric extrusion (or zero to not extrude)", NULL, layers, &layers, NULL));
42989566063dSJacob Faibussowitsch       PetscCall(PetscOptionsReal("-dm_plex_tps_thickness", "Thickness of volumetric extrusion", NULL, thickness, &thickness, NULL));
42999566063dSJacob Faibussowitsch       PetscCall(DMPlexDistributeGetDefault(dm, &tps_distribute));
43009566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_tps_distribute", "Distribute the 2D mesh prior to refinement and extrusion", NULL, tps_distribute, &tps_distribute, NULL));
43019566063dSJacob Faibussowitsch       PetscCall(DMPlexCreateTPSMesh_Internal(dm, tps_type, extent, periodic, tps_distribute, refine, layers, thickness));
43029371c9d4SSatish Balay     } break;
43039371c9d4SSatish Balay     case DM_SHAPE_DOUBLET: {
430405bd46c0SStefano Zampini       DM        dmnew;
430505bd46c0SStefano Zampini       PetscReal rl = 0.0;
430605bd46c0SStefano Zampini 
430705bd46c0SStefano Zampini       PetscCall(PetscOptionsReal("-dm_plex_doublet_refinementlimit", "Refinement limit", NULL, rl, &rl, NULL));
430805bd46c0SStefano Zampini       PetscCall(DMPlexCreateDoublet(PetscObjectComm((PetscObject)dm), dim, simplex, interpolate, rl, &dmnew));
43095de52c6dSVaclav Hapla       PetscCall(DMPlexCopy_Internal(dm, PETSC_FALSE, PETSC_FALSE, dmnew));
431069d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &dmnew));
43119371c9d4SSatish Balay     } break;
4312cfb853baSMatthew G. Knepley     case DM_SHAPE_HYPERCUBIC: {
4313cfb853baSMatthew G. Knepley       PetscInt       *edges;
4314cfb853baSMatthew G. Knepley       PetscReal      *lower, *upper;
4315cfb853baSMatthew G. Knepley       DMBoundaryType *bdt;
4316cfb853baSMatthew G. Knepley       PetscInt        n, d;
4317cfb853baSMatthew G. Knepley 
4318cfb853baSMatthew G. Knepley       *useCoordSpace = PETSC_FALSE;
4319cfb853baSMatthew G. Knepley       PetscCall(PetscMalloc4(dim, &edges, dim, &lower, dim, &upper, dim, &bdt));
4320cfb853baSMatthew G. Knepley       for (d = 0; d < dim; ++d) {
4321cfb853baSMatthew G. Knepley         edges[d] = 1;
4322cfb853baSMatthew G. Knepley         lower[d] = 0.;
4323cfb853baSMatthew G. Knepley         upper[d] = 1.;
4324cfb853baSMatthew G. Knepley         bdt[d]   = DM_BOUNDARY_PERIODIC;
4325cfb853baSMatthew G. Knepley       }
4326cfb853baSMatthew G. Knepley       n = dim;
4327cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsIntArray("-dm_plex_box_faces", "Number of faces along each dimension", "", edges, &n, &flg));
4328cfb853baSMatthew G. Knepley       n = dim;
4329cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsRealArray("-dm_plex_box_lower", "Lower left corner of box", "", lower, &n, &flg));
4330cfb853baSMatthew 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);
4331cfb853baSMatthew G. Knepley       n = dim;
4332cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsRealArray("-dm_plex_box_upper", "Upper right corner of box", "", upper, &n, &flg));
4333cfb853baSMatthew 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);
4334cfb853baSMatthew G. Knepley       n = dim;
4335cfb853baSMatthew G. Knepley       PetscCall(PetscOptionsEnumArray("-dm_plex_box_bd", "Boundary type for each dimension", "", DMBoundaryTypes, (PetscEnum *)bdt, &n, &flg));
4336cfb853baSMatthew 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);
4337cfb853baSMatthew G. Knepley       PetscCall(DMPlexCreateHypercubicMesh_Internal(dm, dim, lower, upper, edges, bdt));
4338cfb853baSMatthew G. Knepley       PetscCall(PetscFree4(edges, lower, upper, bdt));
4339cfb853baSMatthew G. Knepley     } break;
4340d71ae5a4SJacob Faibussowitsch     default:
4341d71ae5a4SJacob Faibussowitsch       SETERRQ(comm, PETSC_ERR_SUP, "Domain shape %s is unsupported", DMPlexShapes[shape]);
43429318fe57SMatthew G. Knepley     }
43439318fe57SMatthew G. Knepley   }
43449566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
434548a46eb9SPierre Jolivet   if (!((PetscObject)dm)->name && nameflg) PetscCall(PetscObjectSetName((PetscObject)dm, plexname));
43464e22dd4cSMatthew G. Knepley   // Allow label creation
43474e22dd4cSMatthew G. Knepley   PetscCall(PetscOptionsFindPairPrefix_Private(NULL, ((PetscObject)dm)->prefix, "-dm_plex_label_", &option, NULL, &flg));
43484e22dd4cSMatthew G. Knepley   if (flg) {
43494e22dd4cSMatthew G. Knepley     DMLabel     label;
43504e22dd4cSMatthew G. Knepley     PetscInt    points[1024], n = 1024;
43514e22dd4cSMatthew G. Knepley     char        fulloption[PETSC_MAX_PATH_LEN];
43524e22dd4cSMatthew G. Knepley     const char *name = &option[14];
43534e22dd4cSMatthew G. Knepley 
43544e22dd4cSMatthew G. Knepley     PetscCall(DMCreateLabel(dm, name));
43554e22dd4cSMatthew G. Knepley     PetscCall(DMGetLabel(dm, name, &label));
43564e22dd4cSMatthew G. Knepley     fulloption[0] = '-';
43574e22dd4cSMatthew G. Knepley     fulloption[1] = 0;
43584e22dd4cSMatthew G. Knepley     PetscCall(PetscStrlcat(fulloption, option, PETSC_MAX_PATH_LEN));
43594e22dd4cSMatthew G. Knepley     PetscCall(PetscOptionsGetIntArray(NULL, ((PetscObject)dm)->prefix, fulloption, points, &n, NULL));
43604e22dd4cSMatthew G. Knepley     for (PetscInt p = 0; p < n; ++p) PetscCall(DMLabelSetValue(label, points[p], 1));
43614e22dd4cSMatthew G. Knepley   }
4362dd0eeac9SMatthew G. Knepley   // Allow cohesive label creation
4363dd0eeac9SMatthew G. Knepley   //   Faces are input, completed, and all points are marked with their depth
4364dd0eeac9SMatthew G. Knepley   PetscCall(PetscOptionsFindPairPrefix_Private(NULL, ((PetscObject)dm)->prefix, "-dm_plex_cohesive_label_", &option, NULL, &flg));
4365dd0eeac9SMatthew G. Knepley   if (flg) {
4366dd0eeac9SMatthew G. Knepley     DMLabel   label;
4367dd0eeac9SMatthew G. Knepley     PetscInt  points[1024], n, pStart, pEnd, Nl = 1;
43685390be7dSMatthew G. Knepley     PetscBool noCreate = PETSC_FALSE;
4369dd0eeac9SMatthew G. Knepley     char      fulloption[PETSC_MAX_PATH_LEN];
4370dd0eeac9SMatthew G. Knepley     char      name[PETSC_MAX_PATH_LEN];
4371dd0eeac9SMatthew G. Knepley     size_t    len;
4372dd0eeac9SMatthew G. Knepley 
4373dd0eeac9SMatthew G. Knepley     PetscCall(DMPlexGetChart(dm, &pStart, &pEnd));
4374dd0eeac9SMatthew G. Knepley     PetscCall(PetscStrncpy(name, &option[23], PETSC_MAX_PATH_LEN));
4375dd0eeac9SMatthew G. Knepley     PetscCall(PetscStrlen(name, &len));
4376dd0eeac9SMatthew G. Knepley     if (name[len - 1] == '0') Nl = 10;
4377dd0eeac9SMatthew G. Knepley     for (PetscInt l = 0; l < Nl; ++l) {
4378dd0eeac9SMatthew G. Knepley       if (l > 0) name[len - 1] = '0' + l;
4379dd0eeac9SMatthew G. Knepley       fulloption[0] = 0;
4380dd0eeac9SMatthew G. Knepley       PetscCall(PetscStrlcat(fulloption, "-dm_plex_cohesive_label_", 32));
4381dd0eeac9SMatthew G. Knepley       PetscCall(PetscStrlcat(fulloption, name, PETSC_MAX_PATH_LEN - 32));
4382dd0eeac9SMatthew G. Knepley       n = 1024;
4383dd0eeac9SMatthew G. Knepley       PetscCall(PetscOptionsGetIntArray(NULL, ((PetscObject)dm)->prefix, fulloption, points, &n, &flg));
4384dd0eeac9SMatthew G. Knepley       if (!flg) break;
43855390be7dSMatthew G. Knepley       PetscCall(DMHasLabel(dm, name, &noCreate));
43865390be7dSMatthew G. Knepley       if (noCreate) {
43875390be7dSMatthew G. Knepley         DMLabel         inlabel;
43885390be7dSMatthew G. Knepley         IS              pointIS;
43895390be7dSMatthew G. Knepley         const PetscInt *lpoints;
43905390be7dSMatthew G. Knepley         PetscInt        pdep, ln, inval = points[0];
43915390be7dSMatthew G. Knepley         char            newname[PETSC_MAX_PATH_LEN];
43925390be7dSMatthew G. Knepley 
43935390be7dSMatthew G. Knepley         PetscCheck(n == 1, comm, PETSC_ERR_ARG_WRONG, "Must specify a label value with this option");
43945390be7dSMatthew G. Knepley         PetscCall(DMGetLabel(dm, name, &inlabel));
43955390be7dSMatthew G. Knepley         PetscCall(DMLabelGetStratumIS(inlabel, inval, &pointIS));
43965390be7dSMatthew G. Knepley         PetscCall(ISGetLocalSize(pointIS, &ln));
43975390be7dSMatthew G. Knepley         PetscCall(ISGetIndices(pointIS, &lpoints));
43985390be7dSMatthew G. Knepley         PetscCall(DMPlexGetPointDepth(dm, lpoints[0], &pdep));
43995390be7dSMatthew G. Knepley         PetscCall(PetscSNPrintf(newname, PETSC_MAX_PATH_LEN, "%s%" PetscInt_FMT, name, points[0]));
44005390be7dSMatthew G. Knepley         PetscCall(DMCreateLabel(dm, newname));
44015390be7dSMatthew G. Knepley         PetscCall(DMGetLabel(dm, newname, &label));
44025390be7dSMatthew G. Knepley         if (!pdep) PetscCall(ProcessCohesiveLabel_Vertices(dm, label, inlabel, inval, ln, lpoints));
44035390be7dSMatthew G. Knepley         else PetscCall(ProcessCohesiveLabel_Faces(dm, label, ln, lpoints));
44045390be7dSMatthew G. Knepley         PetscCall(ISRestoreIndices(pointIS, &lpoints));
44055390be7dSMatthew G. Knepley         PetscCall(ISDestroy(&pointIS));
44065390be7dSMatthew G. Knepley       } else {
4407dd0eeac9SMatthew G. Knepley         PetscCall(DMCreateLabel(dm, name));
4408dd0eeac9SMatthew G. Knepley         PetscCall(DMGetLabel(dm, name, &label));
4409dd0eeac9SMatthew G. Knepley         if (pStart >= pEnd) n = 0;
44105390be7dSMatthew G. Knepley         PetscCall(ProcessCohesiveLabel_Faces(dm, label, n, points));
4411dd0eeac9SMatthew G. Knepley       }
4412dd0eeac9SMatthew G. Knepley       PetscCall(DMPlexOrientLabel(dm, label));
44130542aa8cSMatthew G. Knepley       PetscCall(DMPlexLabelCohesiveComplete(dm, label, NULL, 1, PETSC_FALSE, PETSC_FALSE, NULL));
4414dd0eeac9SMatthew G. Knepley     }
4415dd0eeac9SMatthew G. Knepley   }
44165390be7dSMatthew G. Knepley   PetscCall(DMViewFromOptions(dm, NULL, "-created_dm_view"));
4417708be2fdSJed Brown   PetscCall(PetscLogEventEnd(DMPLEX_CreateFromOptions, dm, 0, 0, 0));
44183ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
44190a6ba040SMatthew G. Knepley }
44200a6ba040SMatthew G. Knepley 
4421d71ae5a4SJacob Faibussowitsch PetscErrorCode DMSetFromOptions_NonRefinement_Plex(DM dm, PetscOptionItems *PetscOptionsObject)
4422d71ae5a4SJacob Faibussowitsch {
44230a6ba040SMatthew G. Knepley   DM_Plex  *mesh = (DM_Plex *)dm->data;
44247f9d8d6cSVaclav Hapla   PetscBool flg, flg2;
44259318fe57SMatthew G. Knepley   char      bdLabel[PETSC_MAX_PATH_LEN];
4426adc21957SMatthew G. Knepley   char      method[PETSC_MAX_PATH_LEN];
44270a6ba040SMatthew G. Knepley 
44280a6ba040SMatthew G. Knepley   PetscFunctionBegin;
44290a6ba040SMatthew G. Knepley   /* Handle viewing */
44309566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_print_set_values", "Output all set values info", "DMPlexMatSetClosure", PETSC_FALSE, &mesh->printSetValues, NULL));
44315962854dSMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_fem", "Debug output level for all fem computations", "DMPlexSNESComputeResidualFEM", 0, &mesh->printFEM, NULL, 0));
44325962854dSMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_fvm", "Debug output level for all fvm computations", "DMPlexSNESComputeResidualFVM", 0, &mesh->printFVM, NULL, 0));
44339566063dSJacob Faibussowitsch   PetscCall(PetscOptionsReal("-dm_plex_print_tol", "Tolerance for FEM output", "DMPlexSNESComputeResidualFEM", mesh->printTol, &mesh->printTol, NULL));
44349566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_l2", "Debug output level all L2 diff computations", "DMComputeL2Diff", 0, &mesh->printL2, NULL, 0));
4435f5867de0SMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_plex_print_locate", "Debug output level all point location computations", "DMLocatePoints", 0, &mesh->printLocate, NULL, 0));
44369566063dSJacob Faibussowitsch   PetscCall(DMMonitorSetFromOptions(dm, "-dm_plex_monitor_throughput", "Monitor the simulation throughput", "DMPlexMonitorThroughput", DMPlexMonitorThroughput, NULL, &flg));
44379566063dSJacob Faibussowitsch   if (flg) PetscCall(PetscLogDefaultBegin());
44389318fe57SMatthew G. Knepley   /* Labeling */
44399566063dSJacob Faibussowitsch   PetscCall(PetscOptionsString("-dm_plex_boundary_label", "Label to mark the mesh boundary", "", bdLabel, bdLabel, sizeof(bdLabel), &flg));
44409566063dSJacob Faibussowitsch   if (flg) PetscCall(DMPlexCreateBoundaryLabel_Private(dm, bdLabel));
4441953fc75cSMatthew G. Knepley   /* Point Location */
44429566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_hash_location", "Use grid hashing for point location", "DMInterpolate", PETSC_FALSE, &mesh->useHashLocation, NULL));
44430848f4b5SMatthew G. Knepley   /* Partitioning and distribution */
44449566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_partition_balance", "Attempt to evenly divide points on partition boundary between processes", "DMPlexSetPartitionBalance", PETSC_FALSE, &mesh->partitionBalance, NULL));
4445d02c7345SMatthew G. Knepley   /* Reordering */
4446adc21957SMatthew G. Knepley   PetscCall(PetscOptionsBool("-dm_reorder_section", "Compute point permutation for local section", "DMReorderSectionSetDefault", PETSC_FALSE, &flg2, &flg));
4447adc21957SMatthew G. Knepley   if (flg) PetscCall(DMReorderSectionSetDefault(dm, flg2 ? DM_REORDER_DEFAULT_TRUE : DM_REORDER_DEFAULT_FALSE));
4448adc21957SMatthew G. Knepley   PetscCall(PetscOptionsString("-dm_reorder_section_type", "Reordering method for local section", "DMReorderSectionSetType", method, method, PETSC_MAX_PATH_LEN, &flg));
4449adc21957SMatthew G. Knepley   if (flg) PetscCall(DMReorderSectionSetType(dm, method));
44502e62ab5aSMatthew G. Knepley   /* Generation and remeshing */
44519566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_remesh_bd", "Allow changes to the boundary on remeshing", "DMAdapt", PETSC_FALSE, &mesh->remeshBd, NULL));
4452b29cfa1cSToby Isaac   /* Projection behavior */
4453d5b43468SJose E. Roman   PetscCall(PetscOptionsBoundedInt("-dm_plex_max_projection_height", "Maximum mesh point height used to project locally", "DMPlexSetMaxProjectionHeight", 0, &mesh->maxProjectionHeight, NULL, 0));
44549566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_regular_refinement", "Use special nested projection algorithm for regular refinement", "DMPlexSetRegularRefinement", mesh->regularRefinement, &mesh->regularRefinement, NULL));
4455f12cf164SMatthew G. Knepley   /* Checking structure */
4456f12cf164SMatthew G. Knepley   {
44577f9d8d6cSVaclav Hapla     PetscBool all = PETSC_FALSE;
4458f12cf164SMatthew G. Knepley 
44597f9d8d6cSVaclav Hapla     PetscCall(PetscOptionsBool("-dm_plex_check_all", "Perform all basic checks", "DMPlexCheck", PETSC_FALSE, &all, NULL));
44607f9d8d6cSVaclav Hapla     if (all) {
44617f9d8d6cSVaclav Hapla       PetscCall(DMPlexCheck(dm));
44627f9d8d6cSVaclav Hapla     } else {
44639566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_symmetry", "Check that the adjacency information in the mesh is symmetric", "DMPlexCheckSymmetry", PETSC_FALSE, &flg, &flg2));
44647f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckSymmetry(dm));
44659566063dSJacob 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));
44667f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckSkeleton(dm, 0));
44679566063dSJacob 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));
44687f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckFaces(dm, 0));
44699566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_geometry", "Check that cells have positive volume", "DMPlexCheckGeometry", PETSC_FALSE, &flg, &flg2));
44707f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckGeometry(dm));
44719566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-dm_plex_check_pointsf", "Check some necessary conditions for PointSF", "DMPlexCheckPointSF", PETSC_FALSE, &flg, &flg2));
4472d7d32a9aSMatthew G. Knepley       if (flg && flg2) PetscCall(DMPlexCheckPointSF(dm, NULL, PETSC_FALSE));
44739566063dSJacob 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));
44747f9d8d6cSVaclav Hapla       if (flg && flg2) PetscCall(DMPlexCheckInterfaceCones(dm));
44757f9d8d6cSVaclav Hapla     }
44769566063dSJacob Faibussowitsch     PetscCall(PetscOptionsBool("-dm_plex_check_cell_shape", "Check cell shape", "DMPlexCheckCellShape", PETSC_FALSE, &flg, &flg2));
44779566063dSJacob Faibussowitsch     if (flg && flg2) PetscCall(DMPlexCheckCellShape(dm, PETSC_TRUE, PETSC_DETERMINE));
4478f12cf164SMatthew G. Knepley   }
44799318fe57SMatthew G. Knepley   {
44809318fe57SMatthew G. Knepley     PetscReal scale = 1.0;
44814f3833eaSMatthew G. Knepley 
44829566063dSJacob Faibussowitsch     PetscCall(PetscOptionsReal("-dm_plex_scale", "Scale factor for mesh coordinates", "DMPlexScale", scale, &scale, &flg));
44839318fe57SMatthew G. Knepley     if (flg) {
44849318fe57SMatthew G. Knepley       Vec coordinates, coordinatesLocal;
44859318fe57SMatthew G. Knepley 
44869566063dSJacob Faibussowitsch       PetscCall(DMGetCoordinates(dm, &coordinates));
44879566063dSJacob Faibussowitsch       PetscCall(DMGetCoordinatesLocal(dm, &coordinatesLocal));
44889566063dSJacob Faibussowitsch       PetscCall(VecScale(coordinates, scale));
44899566063dSJacob Faibussowitsch       PetscCall(VecScale(coordinatesLocal, scale));
44909318fe57SMatthew G. Knepley     }
44919318fe57SMatthew G. Knepley   }
44929566063dSJacob Faibussowitsch   PetscCall(PetscPartitionerSetFromOptions(mesh->partitioner));
44933ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
449468d4fef7SMatthew G. Knepley }
449568d4fef7SMatthew G. Knepley 
4496d71ae5a4SJacob Faibussowitsch PetscErrorCode DMSetFromOptions_Overlap_Plex(DM dm, PetscOptionItems *PetscOptionsObject, PetscInt *overlap)
4497d71ae5a4SJacob Faibussowitsch {
4498c506a872SMatthew G. Knepley   PetscInt  numOvLabels = 16, numOvExLabels = 16;
4499c506a872SMatthew G. Knepley   char     *ovLabelNames[16], *ovExLabelNames[16];
4500c506a872SMatthew G. Knepley   PetscInt  numOvValues = 16, numOvExValues = 16, l;
4501c506a872SMatthew G. Knepley   PetscBool flg;
4502c506a872SMatthew G. Knepley 
4503c506a872SMatthew G. Knepley   PetscFunctionBegin;
4504c506a872SMatthew G. Knepley   PetscCall(PetscOptionsBoundedInt("-dm_distribute_overlap", "The size of the overlap halo", "DMPlexDistribute", *overlap, overlap, NULL, 0));
4505c506a872SMatthew G. Knepley   PetscCall(PetscOptionsStringArray("-dm_distribute_overlap_labels", "List of overlap label names", "DMPlexDistribute", ovLabelNames, &numOvLabels, &flg));
4506c506a872SMatthew G. Knepley   if (!flg) numOvLabels = 0;
4507c506a872SMatthew G. Knepley   if (numOvLabels) {
4508c506a872SMatthew G. Knepley     ((DM_Plex *)dm->data)->numOvLabels = numOvLabels;
4509c506a872SMatthew G. Knepley     for (l = 0; l < numOvLabels; ++l) {
4510c506a872SMatthew G. Knepley       PetscCall(DMGetLabel(dm, ovLabelNames[l], &((DM_Plex *)dm->data)->ovLabels[l]));
4511c506a872SMatthew G. Knepley       PetscCheck(((DM_Plex *)dm->data)->ovLabels[l], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid label name %s", ovLabelNames[l]);
4512c506a872SMatthew G. Knepley       PetscCall(PetscFree(ovLabelNames[l]));
4513c506a872SMatthew G. Knepley     }
4514c506a872SMatthew G. Knepley     PetscCall(PetscOptionsIntArray("-dm_distribute_overlap_values", "List of overlap label values", "DMPlexDistribute", ((DM_Plex *)dm->data)->ovValues, &numOvValues, &flg));
4515c506a872SMatthew G. Knepley     if (!flg) numOvValues = 0;
4516c506a872SMatthew 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);
4517c506a872SMatthew G. Knepley 
4518c506a872SMatthew G. Knepley     PetscCall(PetscOptionsStringArray("-dm_distribute_overlap_exclude_labels", "List of overlap exclude label names", "DMPlexDistribute", ovExLabelNames, &numOvExLabels, &flg));
4519c506a872SMatthew G. Knepley     if (!flg) numOvExLabels = 0;
4520c506a872SMatthew G. Knepley     ((DM_Plex *)dm->data)->numOvExLabels = numOvExLabels;
4521c506a872SMatthew G. Knepley     for (l = 0; l < numOvExLabels; ++l) {
4522c506a872SMatthew G. Knepley       PetscCall(DMGetLabel(dm, ovExLabelNames[l], &((DM_Plex *)dm->data)->ovExLabels[l]));
4523c506a872SMatthew G. Knepley       PetscCheck(((DM_Plex *)dm->data)->ovExLabels[l], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid label name %s", ovExLabelNames[l]);
4524c506a872SMatthew G. Knepley       PetscCall(PetscFree(ovExLabelNames[l]));
4525c506a872SMatthew G. Knepley     }
4526c506a872SMatthew G. Knepley     PetscCall(PetscOptionsIntArray("-dm_distribute_overlap_exclude_values", "List of overlap exclude label values", "DMPlexDistribute", ((DM_Plex *)dm->data)->ovExValues, &numOvExValues, &flg));
4527c506a872SMatthew G. Knepley     if (!flg) numOvExValues = 0;
4528c506a872SMatthew 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);
4529c506a872SMatthew G. Knepley   }
45303ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4531c506a872SMatthew G. Knepley }
4532c506a872SMatthew G. Knepley 
4533d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMSetFromOptions_Plex(DM dm, PetscOptionItems *PetscOptionsObject)
4534d71ae5a4SJacob Faibussowitsch {
4535bdf63967SMatthew G. Knepley   PetscFunctionList    ordlist;
4536bdf63967SMatthew G. Knepley   char                 oname[256];
45374e22dd4cSMatthew G. Knepley   char                 sublabelname[PETSC_MAX_PATH_LEN] = "";
4538adc21957SMatthew G. Knepley   DMReorderDefaultFlag reorder;
4539d410b0cfSMatthew G. Knepley   PetscReal            volume    = -1.0;
45409318fe57SMatthew G. Knepley   PetscInt             prerefine = 0, refine = 0, r, coarsen = 0, overlap = 0, extLayers = 0, dim;
45411b742f01SMatthew 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;
454268d4fef7SMatthew G. Knepley 
454368d4fef7SMatthew G. Knepley   PetscFunctionBegin;
4544d0609cedSBarry Smith   PetscOptionsHeadBegin(PetscOptionsObject, "DMPlex Options");
4545dd4c3f67SMatthew G. Knepley   if (dm->cloneOpts) goto non_refine;
45469318fe57SMatthew G. Knepley   /* Handle automatic creation */
45479566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
45486bc1bd01Sksagiyam   if (dim < 0) {
45496bc1bd01Sksagiyam     PetscCall(DMPlexCreateFromOptions_Internal(PetscOptionsObject, &coordSpace, dm));
45506bc1bd01Sksagiyam     created = PETSC_TRUE;
45516bc1bd01Sksagiyam   }
45526bc1bd01Sksagiyam   PetscCall(DMGetDimension(dm, &dim));
4553d89e6e46SMatthew G. Knepley   /* Handle interpolation before distribution */
45549566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_interpolate_pre", "Flag to interpolate mesh before distribution", "", interpolate, &interpolate, &flg));
4555d89e6e46SMatthew G. Knepley   if (flg) {
4556d89e6e46SMatthew G. Knepley     DMPlexInterpolatedFlag interpolated;
4557d89e6e46SMatthew G. Knepley 
45589566063dSJacob Faibussowitsch     PetscCall(DMPlexIsInterpolated(dm, &interpolated));
4559d89e6e46SMatthew G. Knepley     if (interpolated == DMPLEX_INTERPOLATED_FULL && !interpolate) {
4560d89e6e46SMatthew G. Knepley       DM udm;
4561d89e6e46SMatthew G. Knepley 
45629566063dSJacob Faibussowitsch       PetscCall(DMPlexUninterpolate(dm, &udm));
456369d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &udm));
4564d89e6e46SMatthew G. Knepley     } else if (interpolated != DMPLEX_INTERPOLATED_FULL && interpolate) {
4565d89e6e46SMatthew G. Knepley       DM idm;
4566d89e6e46SMatthew G. Knepley 
45679566063dSJacob Faibussowitsch       PetscCall(DMPlexInterpolate(dm, &idm));
456869d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &idm));
4569d89e6e46SMatthew G. Knepley     }
4570d89e6e46SMatthew G. Knepley   }
45714e22dd4cSMatthew G. Knepley   // Handle submesh selection before distribution
45724e22dd4cSMatthew G. Knepley   PetscCall(PetscOptionsString("-dm_plex_submesh", "Label to use for submesh selection", "", sublabelname, sublabelname, PETSC_MAX_PATH_LEN, &flg));
45734e22dd4cSMatthew G. Knepley   if (flg) {
45744e22dd4cSMatthew G. Knepley     DM              subdm;
45754e22dd4cSMatthew G. Knepley     DMLabel         label;
45764e22dd4cSMatthew G. Knepley     IS              valueIS, pointIS;
45774e22dd4cSMatthew G. Knepley     const PetscInt *values, *points;
45784e22dd4cSMatthew G. Knepley     PetscBool       markedFaces = PETSC_FALSE;
45794e22dd4cSMatthew G. Knepley     PetscInt        Nv, value, Np;
45804e22dd4cSMatthew G. Knepley 
45814e22dd4cSMatthew G. Knepley     PetscCall(DMGetLabel(dm, sublabelname, &label));
45824e22dd4cSMatthew G. Knepley     PetscCall(DMLabelGetNumValues(label, &Nv));
45834e22dd4cSMatthew 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);
45844e22dd4cSMatthew G. Knepley     PetscCall(DMLabelGetValueIS(label, &valueIS));
45854e22dd4cSMatthew G. Knepley     PetscCall(ISGetIndices(valueIS, &values));
45864e22dd4cSMatthew G. Knepley     value = values[0];
45874e22dd4cSMatthew G. Knepley     PetscCall(ISRestoreIndices(valueIS, &values));
45884e22dd4cSMatthew G. Knepley     PetscCall(ISDestroy(&valueIS));
45894e22dd4cSMatthew G. Knepley     PetscCall(DMLabelGetStratumSize(label, value, &Np));
45904e22dd4cSMatthew G. Knepley     PetscCall(DMLabelGetStratumIS(label, value, &pointIS));
45914e22dd4cSMatthew G. Knepley     PetscCall(ISGetIndices(pointIS, &points));
45924e22dd4cSMatthew G. Knepley     for (PetscInt p = 0; p < Np; ++p) {
45934e22dd4cSMatthew G. Knepley       PetscInt pdepth;
45944e22dd4cSMatthew G. Knepley 
45954e22dd4cSMatthew G. Knepley       PetscCall(DMPlexGetPointDepth(dm, points[p], &pdepth));
45964e22dd4cSMatthew G. Knepley       if (pdepth) {
45974e22dd4cSMatthew G. Knepley         markedFaces = PETSC_TRUE;
45984e22dd4cSMatthew G. Knepley         break;
45994e22dd4cSMatthew G. Knepley       }
46004e22dd4cSMatthew G. Knepley     }
46014e22dd4cSMatthew G. Knepley     PetscCall(ISRestoreIndices(pointIS, &points));
46024e22dd4cSMatthew G. Knepley     PetscCall(ISDestroy(&pointIS));
46034e22dd4cSMatthew G. Knepley     PetscCall(DMPlexCreateSubmesh(dm, label, value, markedFaces, &subdm));
46044e22dd4cSMatthew G. Knepley     PetscCall(DMPlexReplace_Internal(dm, &subdm));
46054e22dd4cSMatthew G. Knepley     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
46064e22dd4cSMatthew G. Knepley   }
46079b44eab4SMatthew G. Knepley   /* Handle DMPlex refinement before distribution */
46089566063dSJacob Faibussowitsch   PetscCall(DMPlexGetRefinementUniform(dm, &uniformOrig));
46099566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine_pre", "The number of refinements before distribution", "DMCreate", prerefine, &prerefine, NULL, 0));
46109566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_remap_pre", "Flag to control coordinate remapping", "DMCreate", remap, &remap, NULL));
46119566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_uniform_pre", "Flag for uniform refinement before distribution", "DMCreate", uniform, &uniform, &flg));
46129566063dSJacob Faibussowitsch   if (flg) PetscCall(DMPlexSetRefinementUniform(dm, uniform));
46139566063dSJacob Faibussowitsch   PetscCall(PetscOptionsReal("-dm_refine_volume_limit_pre", "The maximum cell volume after refinement before distribution", "DMCreate", volume, &volume, &flg));
46149318fe57SMatthew G. Knepley   if (flg) {
46159566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementUniform(dm, PETSC_FALSE));
46169566063dSJacob Faibussowitsch     PetscCall(DMPlexSetRefinementLimit(dm, volume));
46179318fe57SMatthew G. Knepley     prerefine = PetscMax(prerefine, 1);
46189318fe57SMatthew G. Knepley   }
4619b23db253SStefano Zampini   if (prerefine) PetscCall(DMLocalizeCoordinates(dm));
46209b44eab4SMatthew G. Knepley   for (r = 0; r < prerefine; ++r) {
46219b44eab4SMatthew G. Knepley     DM             rdm;
46229b44eab4SMatthew G. Knepley     PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
46239b44eab4SMatthew G. Knepley 
4624dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
46259566063dSJacob Faibussowitsch     PetscCall(DMRefine(dm, PetscObjectComm((PetscObject)dm), &rdm));
462669d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &rdm));
4627dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
462861a622f3SMatthew G. Knepley     if (coordFunc && remap) {
46299566063dSJacob Faibussowitsch       PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
46309b44eab4SMatthew G. Knepley       ((DM_Plex *)dm->data)->coordFunc = coordFunc;
46319b44eab4SMatthew G. Knepley     }
46329b44eab4SMatthew G. Knepley   }
46339566063dSJacob Faibussowitsch   PetscCall(DMPlexSetRefinementUniform(dm, uniformOrig));
46349318fe57SMatthew G. Knepley   /* Handle DMPlex extrusion before distribution */
46359566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_extrude", "The number of layers to extrude", "", extLayers, &extLayers, NULL, 0));
46369318fe57SMatthew G. Knepley   if (extLayers) {
46379318fe57SMatthew G. Knepley     DM edm;
46389318fe57SMatthew G. Knepley 
46399566063dSJacob Faibussowitsch     PetscCall(DMExtrude(dm, extLayers, &edm));
464069d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &edm));
464148d16a33SMatthew G. Knepley     ((DM_Plex *)dm->data)->coordFunc = NULL;
4642dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4643d410b0cfSMatthew G. Knepley     extLayers = 0;
46445e17fc22SAidan Hamilton     PetscCall(DMGetDimension(dm, &dim));
46459318fe57SMatthew G. Knepley   }
4646bdf63967SMatthew G. Knepley   /* Handle DMPlex reordering before distribution */
46476bc1bd01Sksagiyam   PetscCall(DMPlexReorderGetDefault(dm, &reorder));
46489566063dSJacob Faibussowitsch   PetscCall(MatGetOrderingList(&ordlist));
46496bc1bd01Sksagiyam   PetscCall(PetscStrncpy(oname, MATORDERINGNATURAL, sizeof(oname)));
46509566063dSJacob Faibussowitsch   PetscCall(PetscOptionsFList("-dm_plex_reorder", "Set mesh reordering type", "DMPlexGetOrdering", ordlist, MATORDERINGNATURAL, oname, sizeof(oname), &flg));
4651adc21957SMatthew G. Knepley   if (reorder == DM_REORDER_DEFAULT_TRUE || flg) {
4652bdf63967SMatthew G. Knepley     DM pdm;
4653bdf63967SMatthew G. Knepley     IS perm;
4654bdf63967SMatthew G. Knepley 
46559566063dSJacob Faibussowitsch     PetscCall(DMPlexGetOrdering(dm, oname, NULL, &perm));
46569566063dSJacob Faibussowitsch     PetscCall(DMPlexPermute(dm, perm, &pdm));
46579566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&perm));
465869d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &pdm));
4659dbbe0bcdSBarry Smith     PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4660bdf63967SMatthew G. Knepley   }
46619b44eab4SMatthew G. Knepley   /* Handle DMPlex distribution */
46629566063dSJacob Faibussowitsch   PetscCall(DMPlexDistributeGetDefault(dm, &distribute));
4663c506a872SMatthew G. Knepley   PetscCall(PetscOptionsBool("-dm_distribute", "Flag to redistribute a mesh among processes", "DMPlexDistribute", distribute, &distribute, NULL));
4664a286e215SMatthew G. Knepley   PetscCall(PetscOptionsBool("-dm_distribute_save_sf", "Flag to save the migration SF", "DMPlexSetMigrationSF", saveSF, &saveSF, NULL));
4665dbbe0bcdSBarry Smith   PetscCall(DMSetFromOptions_Overlap_Plex(dm, PetscOptionsObject, &overlap));
46669b44eab4SMatthew G. Knepley   if (distribute) {
46679b44eab4SMatthew G. Knepley     DM               pdm = NULL;
46689b44eab4SMatthew G. Knepley     PetscPartitioner part;
4669a286e215SMatthew G. Knepley     PetscSF          sfMigration;
46709b44eab4SMatthew G. Knepley 
46719566063dSJacob Faibussowitsch     PetscCall(DMPlexGetPartitioner(dm, &part));
46729566063dSJacob Faibussowitsch     PetscCall(PetscPartitionerSetFromOptions(part));
4673a286e215SMatthew G. Knepley     PetscCall(DMPlexDistribute(dm, overlap, &sfMigration, &pdm));
467448a46eb9SPierre Jolivet     if (pdm) PetscCall(DMPlexReplace_Internal(dm, &pdm));
4675a286e215SMatthew G. Knepley     if (saveSF) PetscCall(DMPlexSetMigrationSF(dm, sfMigration));
4676a286e215SMatthew G. Knepley     PetscCall(PetscSFDestroy(&sfMigration));
46779b44eab4SMatthew G. Knepley   }
46784054ae39SJames Wright 
46794054ae39SJames Wright   {
46804054ae39SJames Wright     PetscBool useBoxLabel = PETSC_FALSE;
46814054ae39SJames Wright     PetscCall(PetscOptionsBool("-dm_plex_box_label", "Create 'Face Sets' assuming boundary faces align with cartesian directions", "DMCreate", useBoxLabel, &useBoxLabel, NULL));
46824054ae39SJames Wright     if (useBoxLabel) PetscCall(DMPlexSetBoxLabel_Internal(dm));
46834054ae39SJames Wright   }
4684d2b2dc1eSMatthew G. Knepley   /* Must check CEED options before creating function space for coordinates */
4685d2b2dc1eSMatthew G. Knepley   {
4686d2b2dc1eSMatthew G. Knepley     PetscBool useCeed = PETSC_FALSE, flg;
4687d2b2dc1eSMatthew G. Knepley 
4688d2b2dc1eSMatthew G. Knepley     PetscCall(PetscOptionsBool("-dm_plex_use_ceed", "Use LibCEED as the FEM backend", "DMPlexSetUseCeed", useCeed, &useCeed, &flg));
4689d2b2dc1eSMatthew G. Knepley     if (flg) PetscCall(DMPlexSetUseCeed(dm, useCeed));
4690d2b2dc1eSMatthew G. Knepley   }
46919318fe57SMatthew G. Knepley   /* Create coordinate space */
46929318fe57SMatthew G. Knepley   if (created) {
469361a622f3SMatthew G. Knepley     DM_Plex  *mesh   = (DM_Plex *)dm->data;
4694e44f6aebSMatthew G. Knepley     PetscInt  degree = 1, deg;
46955515ebd3SMatthew G. Knepley     PetscInt  height = 0;
46965515ebd3SMatthew G. Knepley     DM        cdm;
4697c3db174cSMatthew G. Knepley     PetscBool flg, localize = PETSC_TRUE, sparseLocalize = PETSC_TRUE;
46989318fe57SMatthew G. Knepley 
46999566063dSJacob Faibussowitsch     PetscCall(PetscOptionsBool("-dm_coord_space", "Use an FEM space for coordinates", "", coordSpace, &coordSpace, &flg));
47009566063dSJacob Faibussowitsch     PetscCall(PetscOptionsInt("-dm_coord_petscspace_degree", "FEM degree for coordinate space", "", degree, &degree, NULL));
4701e44f6aebSMatthew G. Knepley     PetscCall(DMGetCoordinateDegree_Internal(dm, &deg));
4702e44f6aebSMatthew G. Knepley     if (coordSpace && deg <= 1) PetscCall(DMPlexCreateCoordinateSpace(dm, degree, PETSC_TRUE, mesh->coordFunc));
47035515ebd3SMatthew G. Knepley     PetscCall(DMGetCoordinateDM(dm, &cdm));
470461a622f3SMatthew G. Knepley     if (flg && !coordSpace) {
470561a622f3SMatthew G. Knepley       PetscDS      cds;
470661a622f3SMatthew G. Knepley       PetscObject  obj;
470761a622f3SMatthew G. Knepley       PetscClassId id;
470861a622f3SMatthew G. Knepley 
47099566063dSJacob Faibussowitsch       PetscCall(DMGetDS(cdm, &cds));
47109566063dSJacob Faibussowitsch       PetscCall(PetscDSGetDiscretization(cds, 0, &obj));
47119566063dSJacob Faibussowitsch       PetscCall(PetscObjectGetClassId(obj, &id));
471261a622f3SMatthew G. Knepley       if (id == PETSCFE_CLASSID) {
471361a622f3SMatthew G. Knepley         PetscContainer dummy;
471461a622f3SMatthew G. Knepley 
47159566063dSJacob Faibussowitsch         PetscCall(PetscContainerCreate(PETSC_COMM_SELF, &dummy));
47169566063dSJacob Faibussowitsch         PetscCall(PetscObjectSetName((PetscObject)dummy, "coordinates"));
47179566063dSJacob Faibussowitsch         PetscCall(DMSetField(cdm, 0, NULL, (PetscObject)dummy));
47189566063dSJacob Faibussowitsch         PetscCall(PetscContainerDestroy(&dummy));
47199566063dSJacob Faibussowitsch         PetscCall(DMClearDS(cdm));
472061a622f3SMatthew G. Knepley       }
472161a622f3SMatthew G. Knepley       mesh->coordFunc = NULL;
472261a622f3SMatthew G. Knepley     }
4723c3db174cSMatthew G. Knepley     PetscCall(PetscOptionsBool("-dm_localize", "Localize mesh coordinates", "", localize, &localize, NULL));
4724c3db174cSMatthew G. Knepley     PetscCall(PetscOptionsBool("-dm_sparse_localize", "Localize only necessary cells", "DMSetSparseLocalize", sparseLocalize, &sparseLocalize, &flg));
4725c3db174cSMatthew G. Knepley     if (flg) PetscCall(DMSetSparseLocalize(dm, sparseLocalize));
47265515ebd3SMatthew G. Knepley     PetscCall(PetscOptionsInt("-dm_localize_height", "Localize edges and faces in addition to cells", "", height, &height, &flg));
47275515ebd3SMatthew G. Knepley     if (flg) PetscCall(DMPlexSetMaxProjectionHeight(cdm, height));
4728c3db174cSMatthew G. Knepley     if (localize) PetscCall(DMLocalizeCoordinates(dm));
47299318fe57SMatthew G. Knepley   }
473068d4fef7SMatthew G. Knepley   /* Handle DMPlex refinement */
473161a622f3SMatthew G. Knepley   remap = PETSC_TRUE;
47329566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine", "The number of uniform refinements", "DMCreate", refine, &refine, NULL, 0));
47339566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_refine_remap", "Flag to control coordinate remapping", "DMCreate", remap, &remap, NULL));
47349566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_refine_hierarchy", "The number of uniform refinements", "DMCreate", refine, &refine, &isHierarchy, 0));
47359566063dSJacob Faibussowitsch   if (refine) PetscCall(DMPlexSetRefinementUniform(dm, PETSC_TRUE));
473668d4fef7SMatthew G. Knepley   if (refine && isHierarchy) {
4737acdc6f61SToby Isaac     DM *dms, coarseDM;
473868d4fef7SMatthew G. Knepley 
47399566063dSJacob Faibussowitsch     PetscCall(DMGetCoarseDM(dm, &coarseDM));
47409566063dSJacob Faibussowitsch     PetscCall(PetscObjectReference((PetscObject)coarseDM));
47419566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(refine, &dms));
47429566063dSJacob Faibussowitsch     PetscCall(DMRefineHierarchy(dm, refine, dms));
474368d4fef7SMatthew G. Knepley     /* Total hack since we do not pass in a pointer */
47449566063dSJacob Faibussowitsch     PetscCall(DMPlexSwap_Static(dm, dms[refine - 1]));
474568d4fef7SMatthew G. Knepley     if (refine == 1) {
47469566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dm, dms[0]));
47479566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dm, PETSC_TRUE));
474868d4fef7SMatthew G. Knepley     } else {
47499566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dm, dms[refine - 2]));
47509566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dm, PETSC_TRUE));
47519566063dSJacob Faibussowitsch       PetscCall(DMSetCoarseDM(dms[0], dms[refine - 1]));
47529566063dSJacob Faibussowitsch       PetscCall(DMPlexSetRegularRefinement(dms[0], PETSC_TRUE));
475368d4fef7SMatthew G. Knepley     }
47549566063dSJacob Faibussowitsch     PetscCall(DMSetCoarseDM(dms[refine - 1], coarseDM));
47559566063dSJacob Faibussowitsch     PetscCall(PetscObjectDereference((PetscObject)coarseDM));
475668d4fef7SMatthew G. Knepley     /* Free DMs */
475768d4fef7SMatthew G. Knepley     for (r = 0; r < refine; ++r) {
4758dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dms[r], PetscOptionsObject));
47599566063dSJacob Faibussowitsch       PetscCall(DMDestroy(&dms[r]));
476068d4fef7SMatthew G. Knepley     }
47619566063dSJacob Faibussowitsch     PetscCall(PetscFree(dms));
476268d4fef7SMatthew G. Knepley   } else {
476368d4fef7SMatthew G. Knepley     for (r = 0; r < refine; ++r) {
47649318fe57SMatthew G. Knepley       DM             rdm;
476551a74b61SMatthew G. Knepley       PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
476668d4fef7SMatthew G. Knepley 
4767dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
47689566063dSJacob Faibussowitsch       PetscCall(DMRefine(dm, PetscObjectComm((PetscObject)dm), &rdm));
476968d4fef7SMatthew G. Knepley       /* Total hack since we do not pass in a pointer */
477069d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &rdm));
4771dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
477261a622f3SMatthew G. Knepley       if (coordFunc && remap) {
47739566063dSJacob Faibussowitsch         PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
477451a74b61SMatthew G. Knepley         ((DM_Plex *)dm->data)->coordFunc = coordFunc;
477551a74b61SMatthew G. Knepley       }
477668d4fef7SMatthew G. Knepley     }
477768d4fef7SMatthew G. Knepley   }
47783cf6fe12SMatthew G. Knepley   /* Handle DMPlex coarsening */
47799566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_coarsen", "Coarsen the mesh", "DMCreate", coarsen, &coarsen, NULL, 0));
47809566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBoundedInt("-dm_coarsen_hierarchy", "The number of coarsenings", "DMCreate", coarsen, &coarsen, &isHierarchy, 0));
4781b653a561SMatthew G. Knepley   if (coarsen && isHierarchy) {
4782b653a561SMatthew G. Knepley     DM *dms;
4783b653a561SMatthew G. Knepley 
47849566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(coarsen, &dms));
47859566063dSJacob Faibussowitsch     PetscCall(DMCoarsenHierarchy(dm, coarsen, dms));
4786b653a561SMatthew G. Knepley     /* Free DMs */
4787b653a561SMatthew G. Knepley     for (r = 0; r < coarsen; ++r) {
4788dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dms[r], PetscOptionsObject));
47899566063dSJacob Faibussowitsch       PetscCall(DMDestroy(&dms[r]));
4790b653a561SMatthew G. Knepley     }
47919566063dSJacob Faibussowitsch     PetscCall(PetscFree(dms));
4792b653a561SMatthew G. Knepley   } else {
4793b653a561SMatthew G. Knepley     for (r = 0; r < coarsen; ++r) {
47949318fe57SMatthew G. Knepley       DM             cdm;
47959318fe57SMatthew G. Knepley       PetscPointFunc coordFunc = ((DM_Plex *)dm->data)->coordFunc;
47963cf6fe12SMatthew G. Knepley 
4797dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
47989566063dSJacob Faibussowitsch       PetscCall(DMCoarsen(dm, PetscObjectComm((PetscObject)dm), &cdm));
47993cf6fe12SMatthew G. Knepley       /* Total hack since we do not pass in a pointer */
480069d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &cdm));
4801dbbe0bcdSBarry Smith       PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
48029318fe57SMatthew G. Knepley       if (coordFunc) {
48039566063dSJacob Faibussowitsch         PetscCall(DMPlexRemapGeometry(dm, 0.0, coordFunc));
48049318fe57SMatthew G. Knepley         ((DM_Plex *)dm->data)->coordFunc = coordFunc;
48059318fe57SMatthew G. Knepley       }
48063cf6fe12SMatthew G. Knepley     }
4807b653a561SMatthew G. Knepley   }
4808be664eb1SMatthew G. Knepley   // Handle coordinate remapping
4809be664eb1SMatthew G. Knepley   remap = PETSC_FALSE;
4810be664eb1SMatthew G. Knepley   PetscCall(PetscOptionsBool("-dm_coord_remap", "Flag to control coordinate remapping", "", remap, &remap, NULL));
4811be664eb1SMatthew G. Knepley   if (remap) {
4812be664eb1SMatthew G. Knepley     DMPlexCoordMap map     = DM_COORD_MAP_NONE;
4813be664eb1SMatthew G. Knepley     PetscPointFunc mapFunc = NULL;
4814be664eb1SMatthew G. Knepley     PetscScalar    params[16];
4815f45b553cSPierre Jolivet     PetscInt       Np = PETSC_STATIC_ARRAY_LENGTH(params), cdim;
4816be664eb1SMatthew G. Knepley     MPI_Comm       comm;
4817be664eb1SMatthew G. Knepley 
4818be664eb1SMatthew G. Knepley     PetscCall(PetscObjectGetComm((PetscObject)dm, &comm));
4819be664eb1SMatthew G. Knepley     PetscCall(DMGetCoordinateDim(dm, &cdim));
4820be664eb1SMatthew G. Knepley     PetscCall(PetscOptionsScalarArray("-dm_coord_map_params", "Parameters for the coordinate remapping", "", params, &Np, &flg));
4821be664eb1SMatthew G. Knepley     if (!flg) Np = 0;
4822be664eb1SMatthew G. Knepley     // TODO Allow user to pass a map function by name
4823be664eb1SMatthew G. Knepley     PetscCall(PetscOptionsEnum("-dm_coord_map", "Coordinate mapping for built-in mesh", "", DMPlexCoordMaps, (PetscEnum)map, (PetscEnum *)&map, &flg));
4824be664eb1SMatthew G. Knepley     if (flg) {
4825be664eb1SMatthew G. Knepley       switch (map) {
4826be664eb1SMatthew G. Knepley       case DM_COORD_MAP_NONE:
4827be664eb1SMatthew G. Knepley         mapFunc = coordMap_identity;
4828be664eb1SMatthew G. Knepley         break;
4829be664eb1SMatthew G. Knepley       case DM_COORD_MAP_SHEAR:
4830be664eb1SMatthew G. Knepley         mapFunc = coordMap_shear;
4831be664eb1SMatthew G. Knepley         if (!Np) {
4832be664eb1SMatthew G. Knepley           Np        = cdim + 1;
4833be664eb1SMatthew G. Knepley           params[0] = 0;
4834be664eb1SMatthew G. Knepley           for (PetscInt d = 1; d <= cdim; ++d) params[d] = 1.0;
4835be664eb1SMatthew G. Knepley         }
4836be664eb1SMatthew 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);
4837be664eb1SMatthew G. Knepley         break;
4838be664eb1SMatthew G. Knepley       case DM_COORD_MAP_FLARE:
4839be664eb1SMatthew G. Knepley         mapFunc = coordMap_flare;
4840be664eb1SMatthew G. Knepley         if (!Np) {
4841be664eb1SMatthew G. Knepley           Np        = cdim + 1;
4842be664eb1SMatthew G. Knepley           params[0] = 0;
4843be664eb1SMatthew G. Knepley           for (PetscInt d = 1; d <= cdim; ++d) params[d] = 1.0;
4844be664eb1SMatthew G. Knepley         }
4845be664eb1SMatthew 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);
4846be664eb1SMatthew G. Knepley         break;
4847be664eb1SMatthew G. Knepley       case DM_COORD_MAP_ANNULUS:
4848be664eb1SMatthew G. Knepley         mapFunc = coordMap_annulus;
4849be664eb1SMatthew G. Knepley         if (!Np) {
4850be664eb1SMatthew G. Knepley           Np        = 2;
4851be664eb1SMatthew G. Knepley           params[0] = 1.;
4852be664eb1SMatthew G. Knepley           params[1] = 2.;
4853be664eb1SMatthew G. Knepley         }
4854be664eb1SMatthew G. Knepley         PetscCheck(Np == 2, comm, PETSC_ERR_ARG_WRONG, "The annulus coordinate map must have 2 parameters, not %" PetscInt_FMT, Np);
4855be664eb1SMatthew G. Knepley         break;
4856be664eb1SMatthew G. Knepley       case DM_COORD_MAP_SHELL:
4857be664eb1SMatthew G. Knepley         mapFunc = coordMap_shell;
4858be664eb1SMatthew G. Knepley         if (!Np) {
4859be664eb1SMatthew G. Knepley           Np        = 2;
4860be664eb1SMatthew G. Knepley           params[0] = 1.;
4861be664eb1SMatthew G. Knepley           params[1] = 2.;
4862be664eb1SMatthew G. Knepley         }
4863be664eb1SMatthew G. Knepley         PetscCheck(Np == 2, comm, PETSC_ERR_ARG_WRONG, "The spherical shell coordinate map must have 2 parameters, not %" PetscInt_FMT, Np);
4864be664eb1SMatthew G. Knepley         break;
4865be664eb1SMatthew G. Knepley       default:
4866be664eb1SMatthew G. Knepley         mapFunc = coordMap_identity;
4867be664eb1SMatthew G. Knepley       }
4868be664eb1SMatthew G. Knepley     }
4869be664eb1SMatthew G. Knepley     if (Np) {
4870be664eb1SMatthew G. Knepley       DM      cdm;
4871be664eb1SMatthew G. Knepley       PetscDS cds;
4872be664eb1SMatthew G. Knepley 
4873be664eb1SMatthew G. Knepley       PetscCall(DMGetCoordinateDM(dm, &cdm));
4874be664eb1SMatthew G. Knepley       PetscCall(DMGetDS(cdm, &cds));
4875be664eb1SMatthew G. Knepley       PetscCall(PetscDSSetConstants(cds, Np, params));
4876be664eb1SMatthew G. Knepley     }
4877be664eb1SMatthew G. Knepley     PetscCall(DMPlexRemapGeometry(dm, 0.0, mapFunc));
4878be664eb1SMatthew G. Knepley   }
4879909dfd52SMatthew G. Knepley   /* Handle ghost cells */
48809566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-dm_plex_create_fv_ghost_cells", "Flag to create finite volume ghost cells on the boundary", "DMCreate", ghostCells, &ghostCells, NULL));
4881909dfd52SMatthew G. Knepley   if (ghostCells) {
4882909dfd52SMatthew G. Knepley     DM   gdm;
4883909dfd52SMatthew G. Knepley     char lname[PETSC_MAX_PATH_LEN];
4884909dfd52SMatthew G. Knepley 
4885909dfd52SMatthew G. Knepley     lname[0] = '\0';
48869566063dSJacob Faibussowitsch     PetscCall(PetscOptionsString("-dm_plex_fv_ghost_cells_label", "Label name for ghost cells boundary", "DMCreate", lname, lname, sizeof(lname), &flg));
48879566063dSJacob Faibussowitsch     PetscCall(DMPlexConstructGhostCells(dm, flg ? lname : NULL, NULL, &gdm));
488869d8a87bSksagiyam     PetscCall(DMPlexReplace_Internal(dm, &gdm));
4889909dfd52SMatthew G. Knepley   }
48906913077dSMatthew G. Knepley   /* Handle 1D order */
4891adc21957SMatthew G. Knepley   if (reorder != DM_REORDER_DEFAULT_FALSE && dim == 1) {
48926913077dSMatthew G. Knepley     DM           cdm, rdm;
48936913077dSMatthew G. Knepley     PetscDS      cds;
48946913077dSMatthew G. Knepley     PetscObject  obj;
48956913077dSMatthew G. Knepley     PetscClassId id = PETSC_OBJECT_CLASSID;
48966913077dSMatthew G. Knepley     IS           perm;
48976bc1bd01Sksagiyam     PetscInt     Nf;
48986913077dSMatthew G. Knepley     PetscBool    distributed;
48996913077dSMatthew G. Knepley 
49009566063dSJacob Faibussowitsch     PetscCall(DMPlexIsDistributed(dm, &distributed));
49019566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateDM(dm, &cdm));
49029566063dSJacob Faibussowitsch     PetscCall(DMGetDS(cdm, &cds));
49039566063dSJacob Faibussowitsch     PetscCall(PetscDSGetNumFields(cds, &Nf));
49046913077dSMatthew G. Knepley     if (Nf) {
49059566063dSJacob Faibussowitsch       PetscCall(PetscDSGetDiscretization(cds, 0, &obj));
49069566063dSJacob Faibussowitsch       PetscCall(PetscObjectGetClassId(obj, &id));
49076913077dSMatthew G. Knepley     }
49086bc1bd01Sksagiyam     if (!distributed && id != PETSCFE_CLASSID) {
49099566063dSJacob Faibussowitsch       PetscCall(DMPlexGetOrdering1D(dm, &perm));
49109566063dSJacob Faibussowitsch       PetscCall(DMPlexPermute(dm, perm, &rdm));
491169d8a87bSksagiyam       PetscCall(DMPlexReplace_Internal(dm, &rdm));
49129566063dSJacob Faibussowitsch       PetscCall(ISDestroy(&perm));
49136913077dSMatthew G. Knepley     }
49146913077dSMatthew G. Knepley   }
49153cf6fe12SMatthew G. Knepley /* Handle */
4916dd4c3f67SMatthew G. Knepley non_refine:
4917dbbe0bcdSBarry Smith   PetscCall(DMSetFromOptions_NonRefinement_Plex(dm, PetscOptionsObject));
4918d0609cedSBarry Smith   PetscOptionsHeadEnd();
49193ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
49200a6ba040SMatthew G. Knepley }
49210a6ba040SMatthew G. Knepley 
4922d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMCreateGlobalVector_Plex(DM dm, Vec *vec)
4923d71ae5a4SJacob Faibussowitsch {
4924552f7358SJed Brown   PetscFunctionBegin;
49259566063dSJacob Faibussowitsch   PetscCall(DMCreateGlobalVector_Section_Private(dm, vec));
49269566063dSJacob Faibussowitsch   /* PetscCall(VecSetOperation(*vec, VECOP_DUPLICATE, (void(*)(void)) VecDuplicate_MPI_DM)); */
49279566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEW, (void (*)(void))VecView_Plex));
49289566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEWNATIVE, (void (*)(void))VecView_Plex_Native));
49299566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOAD, (void (*)(void))VecLoad_Plex));
49309566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOADNATIVE, (void (*)(void))VecLoad_Plex_Native));
49313ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4932552f7358SJed Brown }
4933552f7358SJed Brown 
4934d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMCreateLocalVector_Plex(DM dm, Vec *vec)
4935d71ae5a4SJacob Faibussowitsch {
4936552f7358SJed Brown   PetscFunctionBegin;
49379566063dSJacob Faibussowitsch   PetscCall(DMCreateLocalVector_Section_Private(dm, vec));
49389566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_VIEW, (void (*)(void))VecView_Plex_Local));
49399566063dSJacob Faibussowitsch   PetscCall(VecSetOperation(*vec, VECOP_LOAD, (void (*)(void))VecLoad_Plex_Local));
49403ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4941552f7358SJed Brown }
4942552f7358SJed Brown 
4943d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMGetDimPoints_Plex(DM dm, PetscInt dim, PetscInt *pStart, PetscInt *pEnd)
4944d71ae5a4SJacob Faibussowitsch {
4945793f3fe5SMatthew G. Knepley   PetscInt depth, d;
4946793f3fe5SMatthew G. Knepley 
4947793f3fe5SMatthew G. Knepley   PetscFunctionBegin;
49489566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepth(dm, &depth));
4949793f3fe5SMatthew G. Knepley   if (depth == 1) {
49509566063dSJacob Faibussowitsch     PetscCall(DMGetDimension(dm, &d));
49519566063dSJacob Faibussowitsch     if (dim == 0) PetscCall(DMPlexGetDepthStratum(dm, dim, pStart, pEnd));
49529566063dSJacob Faibussowitsch     else if (dim == d) PetscCall(DMPlexGetDepthStratum(dm, 1, pStart, pEnd));
49539371c9d4SSatish Balay     else {
49549371c9d4SSatish Balay       *pStart = 0;
49559371c9d4SSatish Balay       *pEnd   = 0;
49569371c9d4SSatish Balay     }
4957793f3fe5SMatthew G. Knepley   } else {
49589566063dSJacob Faibussowitsch     PetscCall(DMPlexGetDepthStratum(dm, dim, pStart, pEnd));
4959793f3fe5SMatthew G. Knepley   }
49603ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4961793f3fe5SMatthew G. Knepley }
4962793f3fe5SMatthew G. Knepley 
4963d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMGetNeighbors_Plex(DM dm, PetscInt *nranks, const PetscMPIInt *ranks[])
4964d71ae5a4SJacob Faibussowitsch {
4965502a2867SDave May   PetscSF            sf;
49660a19bb7dSprj-   PetscInt           niranks, njranks, n;
49670a19bb7dSprj-   const PetscMPIInt *iranks, *jranks;
49680a19bb7dSprj-   DM_Plex           *data = (DM_Plex *)dm->data;
4969502a2867SDave May 
49702f356facSMatthew G. Knepley   PetscFunctionBegin;
49719566063dSJacob Faibussowitsch   PetscCall(DMGetPointSF(dm, &sf));
49720a19bb7dSprj-   if (!data->neighbors) {
49739566063dSJacob Faibussowitsch     PetscCall(PetscSFSetUp(sf));
49749566063dSJacob Faibussowitsch     PetscCall(PetscSFGetRootRanks(sf, &njranks, &jranks, NULL, NULL, NULL));
49759566063dSJacob Faibussowitsch     PetscCall(PetscSFGetLeafRanks(sf, &niranks, &iranks, NULL, NULL));
49769566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(njranks + niranks + 1, &data->neighbors));
49779566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(data->neighbors + 1, jranks, njranks));
49789566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(data->neighbors + njranks + 1, iranks, niranks));
49790a19bb7dSprj-     n = njranks + niranks;
49809566063dSJacob Faibussowitsch     PetscCall(PetscSortRemoveDupsMPIInt(&n, data->neighbors + 1));
49810a19bb7dSprj-     /* The following cast should never fail: can't have more neighbors than PETSC_MPI_INT_MAX */
49829566063dSJacob Faibussowitsch     PetscCall(PetscMPIIntCast(n, data->neighbors));
49830a19bb7dSprj-   }
49840a19bb7dSprj-   if (nranks) *nranks = data->neighbors[0];
49850a19bb7dSprj-   if (ranks) {
49860a19bb7dSprj-     if (data->neighbors[0]) *ranks = data->neighbors + 1;
49870a19bb7dSprj-     else *ranks = NULL;
49880a19bb7dSprj-   }
49893ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4990502a2867SDave May }
4991502a2867SDave May 
49921eb70e55SToby Isaac PETSC_INTERN PetscErrorCode DMInterpolateSolution_Plex(DM, DM, Mat, Vec, Vec);
49931eb70e55SToby Isaac 
4994d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMInitialize_Plex(DM dm)
4995d71ae5a4SJacob Faibussowitsch {
4996552f7358SJed Brown   PetscFunctionBegin;
4997552f7358SJed Brown   dm->ops->view                      = DMView_Plex;
49982c40f234SMatthew G. Knepley   dm->ops->load                      = DMLoad_Plex;
4999552f7358SJed Brown   dm->ops->setfromoptions            = DMSetFromOptions_Plex;
500038221697SMatthew G. Knepley   dm->ops->clone                     = DMClone_Plex;
5001552f7358SJed Brown   dm->ops->setup                     = DMSetUp_Plex;
50021bb6d2a8SBarry Smith   dm->ops->createlocalsection        = DMCreateLocalSection_Plex;
5003adc21957SMatthew G. Knepley   dm->ops->createsectionpermutation  = DMCreateSectionPermutation_Plex;
500466ad2231SToby Isaac   dm->ops->createdefaultconstraints  = DMCreateDefaultConstraints_Plex;
5005552f7358SJed Brown   dm->ops->createglobalvector        = DMCreateGlobalVector_Plex;
5006552f7358SJed Brown   dm->ops->createlocalvector         = DMCreateLocalVector_Plex;
5007184d77edSJed Brown   dm->ops->getlocaltoglobalmapping   = NULL;
50080298fd71SBarry Smith   dm->ops->createfieldis             = NULL;
5009552f7358SJed Brown   dm->ops->createcoordinatedm        = DMCreateCoordinateDM_Plex;
5010f19dbd58SToby Isaac   dm->ops->createcoordinatefield     = DMCreateCoordinateField_Plex;
50110a6ba040SMatthew G. Knepley   dm->ops->getcoloring               = NULL;
5012552f7358SJed Brown   dm->ops->creatematrix              = DMCreateMatrix_Plex;
5013bceba477SMatthew G. Knepley   dm->ops->createinterpolation       = DMCreateInterpolation_Plex;
5014bd041c0cSMatthew G. Knepley   dm->ops->createmassmatrix          = DMCreateMassMatrix_Plex;
5015b4937a87SMatthew G. Knepley   dm->ops->createmassmatrixlumped    = DMCreateMassMatrixLumped_Plex;
50165a84ad33SLisandro Dalcin   dm->ops->createinjection           = DMCreateInjection_Plex;
5017552f7358SJed Brown   dm->ops->refine                    = DMRefine_Plex;
50180a6ba040SMatthew G. Knepley   dm->ops->coarsen                   = DMCoarsen_Plex;
50190a6ba040SMatthew G. Knepley   dm->ops->refinehierarchy           = DMRefineHierarchy_Plex;
5020b653a561SMatthew G. Knepley   dm->ops->coarsenhierarchy          = DMCoarsenHierarchy_Plex;
5021d410b0cfSMatthew G. Knepley   dm->ops->extrude                   = DMExtrude_Plex;
50220298fd71SBarry Smith   dm->ops->globaltolocalbegin        = NULL;
50230298fd71SBarry Smith   dm->ops->globaltolocalend          = NULL;
50240298fd71SBarry Smith   dm->ops->localtoglobalbegin        = NULL;
50250298fd71SBarry Smith   dm->ops->localtoglobalend          = NULL;
5026552f7358SJed Brown   dm->ops->destroy                   = DMDestroy_Plex;
5027552f7358SJed Brown   dm->ops->createsubdm               = DMCreateSubDM_Plex;
50282adcc780SMatthew G. Knepley   dm->ops->createsuperdm             = DMCreateSuperDM_Plex;
5029793f3fe5SMatthew G. Knepley   dm->ops->getdimpoints              = DMGetDimPoints_Plex;
5030552f7358SJed Brown   dm->ops->locatepoints              = DMLocatePoints_Plex;
50310709b2feSToby Isaac   dm->ops->projectfunctionlocal      = DMProjectFunctionLocal_Plex;
50320709b2feSToby Isaac   dm->ops->projectfunctionlabellocal = DMProjectFunctionLabelLocal_Plex;
5033bfc4295aSToby Isaac   dm->ops->projectfieldlocal         = DMProjectFieldLocal_Plex;
50348c6c5593SMatthew G. Knepley   dm->ops->projectfieldlabellocal    = DMProjectFieldLabelLocal_Plex;
5035ece3a9fcSMatthew G. Knepley   dm->ops->projectbdfieldlabellocal  = DMProjectBdFieldLabelLocal_Plex;
50360709b2feSToby Isaac   dm->ops->computel2diff             = DMComputeL2Diff_Plex;
5037b698f381SToby Isaac   dm->ops->computel2gradientdiff     = DMComputeL2GradientDiff_Plex;
50382a16baeaSToby Isaac   dm->ops->computel2fielddiff        = DMComputeL2FieldDiff_Plex;
503928d58a37SPierre Jolivet   dm->ops->getneighbors              = DMGetNeighbors_Plex;
50406c6a6b79SMatthew G. Knepley   dm->ops->getlocalboundingbox       = DMGetLocalBoundingBox_Coordinates;
5041907a3e9cSStefano Zampini   dm->ops->createdomaindecomposition = DMCreateDomainDecomposition_Plex;
5042907a3e9cSStefano Zampini   dm->ops->createddscatters          = DMCreateDomainDecompositionScatters_Plex;
50439566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexInsertBoundaryValues_C", DMPlexInsertBoundaryValues_Plex));
50446c51210dSStefano Zampini   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexInsertTimeDerivativeBoundaryValues_C", DMPlexInsertTimeDerivativeBoundaryValues_Plex));
50459566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMSetUpGLVisViewer_C", DMSetUpGLVisViewer_Plex));
50469566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMCreateNeumannOverlap_C", DMCreateNeumannOverlap_Plex));
50479566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexDistributeGetDefault_C", DMPlexDistributeGetDefault_Plex));
50489566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexDistributeSetDefault_C", DMPlexDistributeSetDefault_Plex));
50496bc1bd01Sksagiyam   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexReorderGetDefault_C", DMPlexReorderGetDefault_Plex));
50506bc1bd01Sksagiyam   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexReorderSetDefault_C", DMPlexReorderSetDefault_Plex));
5051adc21957SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMReorderSectionGetDefault_C", DMReorderSectionGetDefault_Plex));
5052adc21957SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMReorderSectionSetDefault_C", DMReorderSectionSetDefault_Plex));
5053adc21957SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMReorderSectionGetType_C", DMReorderSectionGetType_Plex));
5054adc21957SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMReorderSectionSetType_C", DMReorderSectionSetType_Plex));
50559566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMInterpolateSolution_C", DMInterpolateSolution_Plex));
5056c506a872SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetOverlap_C", DMPlexGetOverlap_Plex));
5057c506a872SMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexSetOverlap_C", DMPlexSetOverlap_Plex));
5058d2b2dc1eSMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexGetUseCeed_C", DMPlexGetUseCeed_Plex));
5059d2b2dc1eSMatthew G. Knepley   PetscCall(PetscObjectComposeFunction((PetscObject)dm, "DMPlexSetUseCeed_C", DMPlexSetUseCeed_Plex));
50603ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5061552f7358SJed Brown }
5062552f7358SJed Brown 
5063d71ae5a4SJacob Faibussowitsch PETSC_INTERN PetscErrorCode DMClone_Plex(DM dm, DM *newdm)
5064d71ae5a4SJacob Faibussowitsch {
506563a16f15SMatthew G. Knepley   DM_Plex       *mesh = (DM_Plex *)dm->data;
50661fca310dSJames Wright   const PetscSF *face_sfs;
50671fca310dSJames Wright   PetscInt       num_face_sfs;
506863a16f15SMatthew G. Knepley 
506963a16f15SMatthew G. Knepley   PetscFunctionBegin;
507063a16f15SMatthew G. Knepley   mesh->refct++;
507163a16f15SMatthew G. Knepley   (*newdm)->data = mesh;
50721fca310dSJames Wright   PetscCall(DMPlexGetIsoperiodicFaceSF(dm, &num_face_sfs, &face_sfs));
50731fca310dSJames Wright   PetscCall(DMPlexSetIsoperiodicFaceSF(*newdm, num_face_sfs, (PetscSF *)face_sfs));
50749566063dSJacob Faibussowitsch   PetscCall(PetscObjectChangeTypeName((PetscObject)*newdm, DMPLEX));
50759566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(*newdm));
50763ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
507763a16f15SMatthew G. Knepley }
507863a16f15SMatthew G. Knepley 
50798818961aSMatthew G Knepley /*MC
5080a1cb98faSBarry Smith   DMPLEX = "plex" - A `DM` object that encapsulates an unstructured mesh, or CW Complex, which can be expressed using a Hasse Diagram.
508120f4b53cSBarry Smith                     In the local representation, `Vec`s contain all unknowns in the interior and shared boundary. This is
50828818961aSMatthew G Knepley                     specified by a PetscSection object. Ownership in the global representation is determined by
5083a1cb98faSBarry Smith                     ownership of the underlying `DMPLEX` points. This is specified by another `PetscSection` object.
50848818961aSMatthew G Knepley 
5085e5893cccSMatthew G. Knepley   Options Database Keys:
5086250712c9SMatthew G. Knepley + -dm_refine_pre                     - Refine mesh before distribution
5087250712c9SMatthew G. Knepley + -dm_refine_uniform_pre             - Choose uniform or generator-based refinement
5088250712c9SMatthew G. Knepley + -dm_refine_volume_limit_pre        - Cell volume limit after pre-refinement using generator
5089250712c9SMatthew G. Knepley . -dm_distribute                     - Distribute mesh across processes
5090250712c9SMatthew G. Knepley . -dm_distribute_overlap             - Number of cells to overlap for distribution
5091250712c9SMatthew G. Knepley . -dm_refine                         - Refine mesh after distribution
5092c3db174cSMatthew G. Knepley . -dm_localize <bool>                - Whether to localize coordinates for periodic meshes
5093c3db174cSMatthew G. Knepley . -dm_sparse_localize <bool>         - Whether to only localize cells on the periodic boundary
5094250712c9SMatthew G. Knepley . -dm_plex_hash_location             - Use grid hashing for point location
5095ddce0771SMatthew G. Knepley . -dm_plex_hash_box_faces <n,m,p>    - The number of divisions in each direction of the grid hash
5096f12cf164SMatthew G. Knepley . -dm_plex_partition_balance         - Attempt to evenly divide points on partition boundary between processes
5097f12cf164SMatthew G. Knepley . -dm_plex_remesh_bd                 - Allow changes to the boundary on remeshing
5098d5b43468SJose E. Roman . -dm_plex_max_projection_height     - Maximum mesh point height used to project locally
5099f12cf164SMatthew G. Knepley . -dm_plex_regular_refinement        - Use special nested projection algorithm for regular refinement
5100d02c7345SMatthew G. Knepley . -dm_plex_reorder_section           - Use specialized blocking if available
5101aaa8cc7dSPierre Jolivet . -dm_plex_check_all                 - Perform all checks below
5102f12cf164SMatthew G. Knepley . -dm_plex_check_symmetry            - Check that the adjacency information in the mesh is symmetric
5103f12cf164SMatthew G. Knepley . -dm_plex_check_skeleton <celltype> - Check that each cell has the correct number of vertices
5104f12cf164SMatthew 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
5105f12cf164SMatthew G. Knepley . -dm_plex_check_geometry            - Check that cells have positive volume
5106f12cf164SMatthew G. Knepley . -dm_view :mesh.tex:ascii_latex     - View the mesh in LaTeX/TikZ
5107e5893cccSMatthew G. Knepley . -dm_plex_view_scale <num>          - Scale the TikZ
51085962854dSMatthew G. Knepley . -dm_plex_print_fem <num>           - View FEM assembly information, such as element vectors and matrices
51095962854dSMatthew G. Knepley - -dm_plex_print_fvm <num>           - View FVM assembly information, such as flux updates
5110e5893cccSMatthew G. Knepley 
51118818961aSMatthew G Knepley   Level: intermediate
51128818961aSMatthew G Knepley 
51131cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMType`, `DMPlexCreate()`, `DMCreate()`, `DMSetType()`, `PetscSection`
51148818961aSMatthew G Knepley M*/
51158818961aSMatthew G Knepley 
5116d71ae5a4SJacob Faibussowitsch PETSC_EXTERN PetscErrorCode DMCreate_Plex(DM dm)
5117d71ae5a4SJacob Faibussowitsch {
5118552f7358SJed Brown   DM_Plex *mesh;
5119412e9a14SMatthew G. Knepley   PetscInt unit;
5120552f7358SJed Brown 
5121552f7358SJed Brown   PetscFunctionBegin;
5122f39ec787SMatthew G. Knepley   PetscCall(PetscCitationsRegister(PlexCitation, &Plexcite));
5123552f7358SJed Brown   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
51244dfa11a4SJacob Faibussowitsch   PetscCall(PetscNew(&mesh));
5125adc21957SMatthew G. Knepley   dm->reorderSection = DM_REORDER_DEFAULT_NOTSET;
5126552f7358SJed Brown   dm->data           = mesh;
5127552f7358SJed Brown 
5128552f7358SJed Brown   mesh->refct = 1;
51299566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &mesh->coneSection));
51309566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &mesh->supportSection));
5131552f7358SJed Brown   mesh->refinementUniform      = PETSC_TRUE;
5132552f7358SJed Brown   mesh->refinementLimit        = -1.0;
5133e600fa54SMatthew G. Knepley   mesh->distDefault            = PETSC_TRUE;
5134adc21957SMatthew G. Knepley   mesh->reorderDefault         = DM_REORDER_DEFAULT_NOTSET;
51351d1f2f2aSksagiyam   mesh->distributionName       = NULL;
51367d0f5628SVaclav Hapla   mesh->interpolated           = DMPLEX_INTERPOLATED_INVALID;
51377d0f5628SVaclav Hapla   mesh->interpolatedCollective = DMPLEX_INTERPOLATED_INVALID;
5138552f7358SJed Brown 
51399566063dSJacob Faibussowitsch   PetscCall(PetscPartitionerCreate(PetscObjectComm((PetscObject)dm), &mesh->partitioner));
51402e62ab5aSMatthew G. Knepley   mesh->remeshBd = PETSC_FALSE;
5141d9deefdfSMatthew G. Knepley 
51428865f1eaSKarl Rupp   for (unit = 0; unit < NUM_PETSC_UNITS; ++unit) mesh->scale[unit] = 1.0;
5143552f7358SJed Brown 
5144df0420ecSMatthew G. Knepley   mesh->depthState    = -1;
5145ba2698f1SMatthew G. Knepley   mesh->celltypeState = -1;
51466113b454SMatthew G. Knepley   mesh->printTol      = 1.0e-10;
5147*c29ce622SStefano Zampini   mesh->nonempty_comm = MPI_COMM_SELF;
5148552f7358SJed Brown 
51499566063dSJacob Faibussowitsch   PetscCall(DMInitialize_Plex(dm));
51503ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5151552f7358SJed Brown }
5152552f7358SJed Brown 
5153552f7358SJed Brown /*@
5154a1cb98faSBarry Smith   DMPlexCreate - Creates a `DMPLEX` object, which encapsulates an unstructured mesh, or CW complex, which can be expressed using a Hasse Diagram.
5155552f7358SJed Brown 
5156d083f849SBarry Smith   Collective
5157552f7358SJed Brown 
5158552f7358SJed Brown   Input Parameter:
5159a1cb98faSBarry Smith . comm - The communicator for the `DMPLEX` object
5160552f7358SJed Brown 
5161552f7358SJed Brown   Output Parameter:
5162a1cb98faSBarry Smith . mesh - The `DMPLEX` object
5163552f7358SJed Brown 
5164552f7358SJed Brown   Level: beginner
5165552f7358SJed Brown 
516642747ad1SJacob Faibussowitsch .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMType`, `DMCreate()`, `DMSetType()`
5167552f7358SJed Brown @*/
5168d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreate(MPI_Comm comm, DM *mesh)
5169d71ae5a4SJacob Faibussowitsch {
5170552f7358SJed Brown   PetscFunctionBegin;
51714f572ea9SToby Isaac   PetscAssertPointer(mesh, 2);
51729566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, mesh));
51739566063dSJacob Faibussowitsch   PetscCall(DMSetType(*mesh, DMPLEX));
51743ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5175552f7358SJed Brown }
5176552f7358SJed Brown 
5177b09969d6SVaclav Hapla /*@C
5178a1cb98faSBarry Smith   DMPlexBuildFromCellListParallel - Build distributed `DMPLEX` topology from a list of vertices for each cell (common mesh generator output)
5179a1cb98faSBarry Smith 
518020f4b53cSBarry Smith   Collective; No Fortran Support
5181b09969d6SVaclav Hapla 
5182b09969d6SVaclav Hapla   Input Parameters:
5183a1cb98faSBarry Smith + dm          - The `DM`
5184b09969d6SVaclav Hapla . numCells    - The number of cells owned by this process
5185a1cb98faSBarry Smith . numVertices - The number of vertices to be owned by this process, or `PETSC_DECIDE`
5186a1cb98faSBarry Smith . NVertices   - The global number of vertices, or `PETSC_DETERMINE`
5187b09969d6SVaclav Hapla . numCorners  - The number of vertices for each cell
51885e488331SVaclav Hapla - cells       - An array of numCells*numCorners numbers, the global vertex numbers for each cell
5189b09969d6SVaclav Hapla 
5190be8c289dSNicolas Barral   Output Parameters:
5191a1cb98faSBarry Smith + vertexSF         - (Optional) `PetscSF` describing complete vertex ownership
5192be8c289dSNicolas Barral - verticesAdjSaved - (Optional) vertex adjacency array
5193b09969d6SVaclav Hapla 
5194b09969d6SVaclav Hapla   Level: advanced
5195b09969d6SVaclav Hapla 
5196a1cb98faSBarry Smith   Notes:
5197a1cb98faSBarry Smith   Two triangles sharing a face
5198a1cb98faSBarry Smith .vb
5199a1cb98faSBarry Smith 
5200a1cb98faSBarry Smith         2
5201a1cb98faSBarry Smith       / | \
5202a1cb98faSBarry Smith      /  |  \
5203a1cb98faSBarry Smith     /   |   \
5204a1cb98faSBarry Smith    0  0 | 1  3
5205a1cb98faSBarry Smith     \   |   /
5206a1cb98faSBarry Smith      \  |  /
5207a1cb98faSBarry Smith       \ | /
5208a1cb98faSBarry Smith         1
5209a1cb98faSBarry Smith .ve
5210a1cb98faSBarry Smith   would have input
5211a1cb98faSBarry Smith .vb
5212a1cb98faSBarry Smith   numCells = 2, numVertices = 4
5213a1cb98faSBarry Smith   cells = [0 1 2  1 3 2]
5214a1cb98faSBarry Smith .ve
5215a1cb98faSBarry Smith   which would result in the `DMPLEX`
5216a1cb98faSBarry Smith .vb
5217a1cb98faSBarry Smith 
5218a1cb98faSBarry Smith         4
5219a1cb98faSBarry Smith       / | \
5220a1cb98faSBarry Smith      /  |  \
5221a1cb98faSBarry Smith     /   |   \
5222a1cb98faSBarry Smith    2  0 | 1  5
5223a1cb98faSBarry Smith     \   |   /
5224a1cb98faSBarry Smith      \  |  /
5225a1cb98faSBarry Smith       \ | /
5226a1cb98faSBarry Smith         3
5227a1cb98faSBarry Smith .ve
5228a1cb98faSBarry Smith 
5229a1cb98faSBarry Smith   Vertices are implicitly numbered consecutively 0,...,NVertices.
5230a1cb98faSBarry Smith   Each rank owns a chunk of numVertices consecutive vertices.
5231a1cb98faSBarry Smith   If numVertices is `PETSC_DECIDE`, PETSc will distribute them as evenly as possible using PetscLayout.
5232a1cb98faSBarry Smith   If NVertices is `PETSC_DETERMINE` and numVertices is PETSC_DECIDE, NVertices is computed by PETSc as the maximum vertex index in cells + 1.
5233a1cb98faSBarry Smith   If only NVertices is `PETSC_DETERMINE`, it is computed as the sum of numVertices over all ranks.
5234a1cb98faSBarry Smith 
5235a1cb98faSBarry Smith   The cell distribution is arbitrary non-overlapping, independent of the vertex distribution.
5236a1cb98faSBarry Smith 
52371cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildFromCellList()`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildCoordinatesFromCellListParallel()`,
5238a1cb98faSBarry Smith           `PetscSF`
5239b09969d6SVaclav Hapla @*/
5240d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildFromCellListParallel(DM dm, PetscInt numCells, PetscInt numVertices, PetscInt NVertices, PetscInt numCorners, const PetscInt cells[], PetscSF *vertexSF, PetscInt **verticesAdjSaved)
5241d71ae5a4SJacob Faibussowitsch {
52422464107aSksagiyam   PetscSF     sfPoint;
52432464107aSksagiyam   PetscLayout layout;
524482fb893eSVaclav Hapla   PetscInt    numVerticesAdj, *verticesAdj, *cones, c, p;
5245a47d0d45SMatthew G. Knepley 
5246a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
524725b6865aSVaclav Hapla   PetscValidLogicalCollectiveInt(dm, NVertices, 4);
52489566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
524925b6865aSVaclav Hapla   /* Get/check global number of vertices */
525025b6865aSVaclav Hapla   {
525125b6865aSVaclav Hapla     PetscInt       NVerticesInCells, i;
525225b6865aSVaclav Hapla     const PetscInt len = numCells * numCorners;
525325b6865aSVaclav Hapla 
525425b6865aSVaclav Hapla     /* NVerticesInCells = max(cells) + 1 */
525525b6865aSVaclav Hapla     NVerticesInCells = PETSC_MIN_INT;
52569371c9d4SSatish Balay     for (i = 0; i < len; i++)
52579371c9d4SSatish Balay       if (cells[i] > NVerticesInCells) NVerticesInCells = cells[i];
525825b6865aSVaclav Hapla     ++NVerticesInCells;
5259712fec58SPierre Jolivet     PetscCall(MPIU_Allreduce(MPI_IN_PLACE, &NVerticesInCells, 1, MPIU_INT, MPI_MAX, PetscObjectComm((PetscObject)dm)));
526025b6865aSVaclav Hapla 
526125b6865aSVaclav Hapla     if (numVertices == PETSC_DECIDE && NVertices == PETSC_DECIDE) NVertices = NVerticesInCells;
52629371c9d4SSatish Balay     else
52639371c9d4SSatish 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);
526425b6865aSVaclav Hapla   }
52659079aca8SVaclav Hapla   /* Count locally unique vertices */
52669079aca8SVaclav Hapla   {
52679079aca8SVaclav Hapla     PetscHSetI vhash;
52689079aca8SVaclav Hapla     PetscInt   off = 0;
52699079aca8SVaclav Hapla 
52709566063dSJacob Faibussowitsch     PetscCall(PetscHSetICreate(&vhash));
5271a47d0d45SMatthew G. Knepley     for (c = 0; c < numCells; ++c) {
527248a46eb9SPierre Jolivet       for (p = 0; p < numCorners; ++p) PetscCall(PetscHSetIAdd(vhash, cells[c * numCorners + p]));
5273a47d0d45SMatthew G. Knepley     }
52749566063dSJacob Faibussowitsch     PetscCall(PetscHSetIGetSize(vhash, &numVerticesAdj));
52759566063dSJacob Faibussowitsch     if (!verticesAdjSaved) PetscCall(PetscMalloc1(numVerticesAdj, &verticesAdj));
5276ad540459SPierre Jolivet     else verticesAdj = *verticesAdjSaved;
52779566063dSJacob Faibussowitsch     PetscCall(PetscHSetIGetElems(vhash, &off, verticesAdj));
52789566063dSJacob Faibussowitsch     PetscCall(PetscHSetIDestroy(&vhash));
527963a3b9bcSJacob Faibussowitsch     PetscCheck(off == numVerticesAdj, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid number of local vertices %" PetscInt_FMT " should be %" PetscInt_FMT, off, numVerticesAdj);
5280a47d0d45SMatthew G. Knepley   }
52819566063dSJacob Faibussowitsch   PetscCall(PetscSortInt(numVerticesAdj, verticesAdj));
5282a47d0d45SMatthew G. Knepley   /* Create cones */
52839566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, 0, numCells + numVerticesAdj));
52849566063dSJacob Faibussowitsch   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, numCorners));
52859566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm));
52869566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCones(dm, &cones));
5287a47d0d45SMatthew G. Knepley   for (c = 0; c < numCells; ++c) {
5288a47d0d45SMatthew G. Knepley     for (p = 0; p < numCorners; ++p) {
5289a47d0d45SMatthew G. Knepley       const PetscInt gv = cells[c * numCorners + p];
5290a47d0d45SMatthew G. Knepley       PetscInt       lv;
5291a47d0d45SMatthew G. Knepley 
52929079aca8SVaclav Hapla       /* Positions within verticesAdj form 0-based local vertex numbering;
52939079aca8SVaclav Hapla          we need to shift it by numCells to get correct DAG points (cells go first) */
52949566063dSJacob Faibussowitsch       PetscCall(PetscFindInt(gv, numVerticesAdj, verticesAdj, &lv));
529563a3b9bcSJacob Faibussowitsch       PetscCheck(lv >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Could not find global vertex %" PetscInt_FMT " in local connectivity", gv);
5296961cfab0SVaclav Hapla       cones[c * numCorners + p] = lv + numCells;
5297a47d0d45SMatthew G. Knepley     }
5298a47d0d45SMatthew G. Knepley   }
52992464107aSksagiyam   /* Build point sf */
53009566063dSJacob Faibussowitsch   PetscCall(PetscLayoutCreate(PetscObjectComm((PetscObject)dm), &layout));
53019566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetSize(layout, NVertices));
53029566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetLocalSize(layout, numVertices));
53039566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetBlockSize(layout, 1));
53049566063dSJacob Faibussowitsch   PetscCall(PetscSFCreateByMatchingIndices(layout, numVerticesAdj, verticesAdj, NULL, numCells, numVerticesAdj, verticesAdj, NULL, numCells, vertexSF, &sfPoint));
53059566063dSJacob Faibussowitsch   PetscCall(PetscLayoutDestroy(&layout));
53069566063dSJacob Faibussowitsch   if (!verticesAdjSaved) PetscCall(PetscFree(verticesAdj));
53079566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)sfPoint, "point SF"));
53082464107aSksagiyam   if (dm->sf) {
53092464107aSksagiyam     const char *prefix;
53102464107aSksagiyam 
53119566063dSJacob Faibussowitsch     PetscCall(PetscObjectGetOptionsPrefix((PetscObject)dm->sf, &prefix));
53129566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetOptionsPrefix((PetscObject)sfPoint, prefix));
53132464107aSksagiyam   }
53149566063dSJacob Faibussowitsch   PetscCall(DMSetPointSF(dm, sfPoint));
53159566063dSJacob Faibussowitsch   PetscCall(PetscSFDestroy(&sfPoint));
5316f4f49eeaSPierre Jolivet   if (vertexSF) PetscCall(PetscObjectSetName((PetscObject)*vertexSF, "Vertex Ownership SF"));
5317a47d0d45SMatthew G. Knepley   /* Fill in the rest of the topology structure */
53189566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
53199566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
53209566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
53213ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5322a47d0d45SMatthew G. Knepley }
5323a47d0d45SMatthew G. Knepley 
5324cc4c1da9SBarry Smith /*@
5325a1cb98faSBarry Smith   DMPlexBuildCoordinatesFromCellListParallel - Build `DM` coordinates from a list of coordinates for each owned vertex (common mesh generator output)
5326a1cb98faSBarry Smith 
532720f4b53cSBarry Smith   Collective; No Fortran Support
5328b09969d6SVaclav Hapla 
5329b09969d6SVaclav Hapla   Input Parameters:
5330a1cb98faSBarry Smith + dm           - The `DM`
5331b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
5332a1cb98faSBarry Smith . sfVert       - `PetscSF` describing complete vertex ownership
5333b09969d6SVaclav Hapla - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
5334b09969d6SVaclav Hapla 
5335b09969d6SVaclav Hapla   Level: advanced
5336b09969d6SVaclav Hapla 
53371cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildFromCellListParallel()`
5338b09969d6SVaclav Hapla @*/
5339d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildCoordinatesFromCellListParallel(DM dm, PetscInt spaceDim, PetscSF sfVert, const PetscReal vertexCoords[])
5340d71ae5a4SJacob Faibussowitsch {
5341a47d0d45SMatthew G. Knepley   PetscSection coordSection;
5342a47d0d45SMatthew G. Knepley   Vec          coordinates;
5343a47d0d45SMatthew G. Knepley   PetscScalar *coords;
53441edcf0b2SVaclav Hapla   PetscInt     numVertices, numVerticesAdj, coordSize, v, vStart, vEnd;
5345a47d0d45SMatthew G. Knepley 
5346a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
53479566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
53489566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
53491dca8a05SBarry Smith   PetscCheck(vStart >= 0 && vEnd >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "DM is not set up properly. DMPlexBuildFromCellList() should be called first.");
53509566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, spaceDim));
53519566063dSJacob Faibussowitsch   PetscCall(PetscSFGetGraph(sfVert, &numVertices, &numVerticesAdj, NULL, NULL));
53521dca8a05SBarry 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);
53539566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
53549566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
53559566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, spaceDim));
53569566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, vStart, vEnd));
53571edcf0b2SVaclav Hapla   for (v = vStart; v < vEnd; ++v) {
53589566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, spaceDim));
53599566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, spaceDim));
5360a47d0d45SMatthew G. Knepley   }
53619566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
53629566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
53639566063dSJacob Faibussowitsch   PetscCall(VecCreate(PetscObjectComm((PetscObject)dm), &coordinates));
53649566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, spaceDim));
53659566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
53669566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
53679566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
53689566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
5369a47d0d45SMatthew G. Knepley   {
5370a47d0d45SMatthew G. Knepley     MPI_Datatype coordtype;
5371a47d0d45SMatthew G. Knepley 
5372a47d0d45SMatthew G. Knepley     /* Need a temp buffer for coords if we have complex/single */
53739566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_contiguous(spaceDim, MPIU_SCALAR, &coordtype));
53749566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_commit(&coordtype));
537521016a8bSBarry Smith #if defined(PETSC_USE_COMPLEX)
537621016a8bSBarry Smith     {
537721016a8bSBarry Smith       PetscScalar *svertexCoords;
537821016a8bSBarry Smith       PetscInt     i;
53799566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numVertices * spaceDim, &svertexCoords));
53803612f820SVaclav Hapla       for (i = 0; i < numVertices * spaceDim; i++) svertexCoords[i] = vertexCoords[i];
53819566063dSJacob Faibussowitsch       PetscCall(PetscSFBcastBegin(sfVert, coordtype, svertexCoords, coords, MPI_REPLACE));
53829566063dSJacob Faibussowitsch       PetscCall(PetscSFBcastEnd(sfVert, coordtype, svertexCoords, coords, MPI_REPLACE));
53839566063dSJacob Faibussowitsch       PetscCall(PetscFree(svertexCoords));
538421016a8bSBarry Smith     }
538521016a8bSBarry Smith #else
53869566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastBegin(sfVert, coordtype, vertexCoords, coords, MPI_REPLACE));
53879566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastEnd(sfVert, coordtype, vertexCoords, coords, MPI_REPLACE));
538821016a8bSBarry Smith #endif
53899566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Type_free(&coordtype));
5390a47d0d45SMatthew G. Knepley   }
53919566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
53929566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
53939566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
53949566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
53953ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5396a47d0d45SMatthew G. Knepley }
5397a47d0d45SMatthew G. Knepley 
5398c3edce3dSSatish Balay /*@
5399a1cb98faSBarry Smith   DMPlexCreateFromCellListParallelPetsc - Create distributed `DMPLEX` from a list of vertices for each cell (common mesh generator output)
5400a1cb98faSBarry Smith 
5401a1cb98faSBarry Smith   Collective
5402a47d0d45SMatthew G. Knepley 
5403a47d0d45SMatthew G. Knepley   Input Parameters:
5404a47d0d45SMatthew G. Knepley + comm         - The communicator
5405a47d0d45SMatthew G. Knepley . dim          - The topological dimension of the mesh
5406a47d0d45SMatthew G. Knepley . numCells     - The number of cells owned by this process
5407a1cb98faSBarry Smith . numVertices  - The number of vertices owned by this process, or `PETSC_DECIDE`
5408a1cb98faSBarry Smith . NVertices    - The global number of vertices, or `PETSC_DECIDE`
5409a47d0d45SMatthew G. Knepley . numCorners   - The number of vertices for each cell
5410a47d0d45SMatthew G. Knepley . interpolate  - Flag indicating that intermediate mesh entities (faces, edges) should be created automatically
5411a47d0d45SMatthew G. Knepley . cells        - An array of numCells*numCorners numbers, the global vertex numbers for each cell
5412a47d0d45SMatthew G. Knepley . spaceDim     - The spatial dimension used for coordinates
5413a47d0d45SMatthew G. Knepley - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
5414a47d0d45SMatthew G. Knepley 
5415d8d19677SJose E. Roman   Output Parameters:
5416a1cb98faSBarry Smith + dm          - The `DM`
5417a1cb98faSBarry Smith . vertexSF    - (Optional) `PetscSF` describing complete vertex ownership
541860225df5SJacob Faibussowitsch - verticesAdj - (Optional) vertex adjacency array
5419a47d0d45SMatthew G. Knepley 
5420b09969d6SVaclav Hapla   Level: intermediate
5421a47d0d45SMatthew G. Knepley 
5422a1cb98faSBarry Smith   Notes:
5423a1cb98faSBarry Smith   This function is just a convenient sequence of `DMCreate()`, `DMSetType()`, `DMSetDimension()`,
5424a1cb98faSBarry Smith   `DMPlexBuildFromCellListParallel()`, `DMPlexInterpolate()`, `DMPlexBuildCoordinatesFromCellListParallel()`
5425a1cb98faSBarry Smith 
5426a1cb98faSBarry Smith   See `DMPlexBuildFromCellListParallel()` for an example and details about the topology-related parameters.
5427a1cb98faSBarry Smith 
5428a1cb98faSBarry Smith   See `DMPlexBuildCoordinatesFromCellListParallel()` for details about the geometry-related parameters.
5429a1cb98faSBarry Smith 
54301cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListPetsc()`, `DMPlexBuildFromCellListParallel()`, `DMPlexBuildCoordinatesFromCellListParallel()`, `DMPlexCreateFromDAG()`, `DMPlexCreate()`
5431a47d0d45SMatthew G. Knepley @*/
5432d71ae5a4SJacob 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)
5433d71ae5a4SJacob Faibussowitsch {
5434a47d0d45SMatthew G. Knepley   PetscSF sfVert;
5435a47d0d45SMatthew G. Knepley 
5436a47d0d45SMatthew G. Knepley   PetscFunctionBegin;
54379566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
54389566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
5439a47d0d45SMatthew G. Knepley   PetscValidLogicalCollectiveInt(*dm, dim, 2);
5440064a246eSJacob Faibussowitsch   PetscValidLogicalCollectiveInt(*dm, spaceDim, 9);
54419566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
54429566063dSJacob Faibussowitsch   PetscCall(DMPlexBuildFromCellListParallel(*dm, numCells, numVertices, NVertices, numCorners, cells, &sfVert, verticesAdj));
5443a47d0d45SMatthew G. Knepley   if (interpolate) {
54445fd9971aSMatthew G. Knepley     DM idm;
5445a47d0d45SMatthew G. Knepley 
54469566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
54479566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
5448a47d0d45SMatthew G. Knepley     *dm = idm;
5449a47d0d45SMatthew G. Knepley   }
54509566063dSJacob Faibussowitsch   PetscCall(DMPlexBuildCoordinatesFromCellListParallel(*dm, spaceDim, sfVert, vertexCoords));
545118d54ad4SMichael Lange   if (vertexSF) *vertexSF = sfVert;
54529566063dSJacob Faibussowitsch   else PetscCall(PetscSFDestroy(&sfVert));
54533ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5454a47d0d45SMatthew G. Knepley }
5455a47d0d45SMatthew G. Knepley 
5456cc4c1da9SBarry Smith /*@
5457a1cb98faSBarry Smith   DMPlexBuildFromCellList - Build `DMPLEX` topology from a list of vertices for each cell (common mesh generator output)
5458a1cb98faSBarry Smith 
545920f4b53cSBarry Smith   Collective; No Fortran Support
54609298eaa6SMatthew G Knepley 
54619298eaa6SMatthew G Knepley   Input Parameters:
5462a1cb98faSBarry Smith + dm          - The `DM`
5463b09969d6SVaclav Hapla . numCells    - The number of cells owned by this process
5464a1cb98faSBarry Smith . numVertices - The number of vertices owned by this process, or `PETSC_DETERMINE`
54659298eaa6SMatthew G Knepley . numCorners  - The number of vertices for each cell
5466a3b724e8SBarry Smith - cells       - An array of `numCells` x `numCorners` numbers, the global vertex numbers for each cell
54679298eaa6SMatthew G Knepley 
5468b09969d6SVaclav Hapla   Level: advanced
54699298eaa6SMatthew G Knepley 
5470b09969d6SVaclav Hapla   Notes:
5471b09969d6SVaclav Hapla   Two triangles sharing a face
5472a1cb98faSBarry Smith .vb
54739298eaa6SMatthew G Knepley 
5474a1cb98faSBarry Smith         2
5475a1cb98faSBarry Smith       / | \
5476a1cb98faSBarry Smith      /  |  \
5477a1cb98faSBarry Smith     /   |   \
5478a1cb98faSBarry Smith    0  0 | 1  3
5479a1cb98faSBarry Smith     \   |   /
5480a1cb98faSBarry Smith      \  |  /
5481a1cb98faSBarry Smith       \ | /
5482a1cb98faSBarry Smith         1
5483a1cb98faSBarry Smith .ve
5484a1cb98faSBarry Smith   would have input
5485a1cb98faSBarry Smith .vb
5486a1cb98faSBarry Smith   numCells = 2, numVertices = 4
5487a1cb98faSBarry Smith   cells = [0 1 2  1 3 2]
5488a1cb98faSBarry Smith .ve
5489a1cb98faSBarry Smith   which would result in the `DMPLEX`
5490a1cb98faSBarry Smith .vb
5491a1cb98faSBarry Smith 
5492a1cb98faSBarry Smith         4
5493a1cb98faSBarry Smith       / | \
5494a1cb98faSBarry Smith      /  |  \
5495a1cb98faSBarry Smith     /   |   \
5496a1cb98faSBarry Smith    2  0 | 1  5
5497a1cb98faSBarry Smith     \   |   /
5498a1cb98faSBarry Smith      \  |  /
5499a1cb98faSBarry Smith       \ | /
5500a1cb98faSBarry Smith         3
5501a1cb98faSBarry Smith .ve
5502a1cb98faSBarry Smith 
5503a1cb98faSBarry Smith   If numVertices is `PETSC_DETERMINE`, it is computed by PETSc as the maximum vertex index in cells + 1.
550425b6865aSVaclav Hapla 
55051cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildFromCellListParallel()`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromCellListPetsc()`
5506b09969d6SVaclav Hapla @*/
5507d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildFromCellList(DM dm, PetscInt numCells, PetscInt numVertices, PetscInt numCorners, const PetscInt cells[])
5508d71ae5a4SJacob Faibussowitsch {
5509961cfab0SVaclav Hapla   PetscInt *cones, c, p, dim;
5510b09969d6SVaclav Hapla 
5511b09969d6SVaclav Hapla   PetscFunctionBegin;
55129566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
55139566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
551425b6865aSVaclav Hapla   /* Get/check global number of vertices */
551525b6865aSVaclav Hapla   {
551625b6865aSVaclav Hapla     PetscInt       NVerticesInCells, i;
551725b6865aSVaclav Hapla     const PetscInt len = numCells * numCorners;
551825b6865aSVaclav Hapla 
551925b6865aSVaclav Hapla     /* NVerticesInCells = max(cells) + 1 */
552025b6865aSVaclav Hapla     NVerticesInCells = PETSC_MIN_INT;
55219371c9d4SSatish Balay     for (i = 0; i < len; i++)
55229371c9d4SSatish Balay       if (cells[i] > NVerticesInCells) NVerticesInCells = cells[i];
552325b6865aSVaclav Hapla     ++NVerticesInCells;
552425b6865aSVaclav Hapla 
552525b6865aSVaclav Hapla     if (numVertices == PETSC_DECIDE) numVertices = NVerticesInCells;
55269371c9d4SSatish Balay     else
55279371c9d4SSatish 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);
552825b6865aSVaclav Hapla   }
55299566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, 0, numCells + numVertices));
553048a46eb9SPierre Jolivet   for (c = 0; c < numCells; ++c) PetscCall(DMPlexSetConeSize(dm, c, numCorners));
55319566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm));
55329566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCones(dm, &cones));
5533b09969d6SVaclav Hapla   for (c = 0; c < numCells; ++c) {
5534ad540459SPierre Jolivet     for (p = 0; p < numCorners; ++p) cones[c * numCorners + p] = cells[c * numCorners + p] + numCells;
5535b09969d6SVaclav Hapla   }
55369566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
55379566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
55389566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildFromCellList, dm, 0, 0, 0));
55393ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5540b09969d6SVaclav Hapla }
5541b09969d6SVaclav Hapla 
5542cc4c1da9SBarry Smith /*@
5543a1cb98faSBarry Smith   DMPlexBuildCoordinatesFromCellList - Build `DM` coordinates from a list of coordinates for each owned vertex (common mesh generator output)
5544a1cb98faSBarry Smith 
5545cc4c1da9SBarry Smith   Collective
5546b09969d6SVaclav Hapla 
5547b09969d6SVaclav Hapla   Input Parameters:
5548a1cb98faSBarry Smith + dm           - The `DM`
5549b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
5550b09969d6SVaclav Hapla - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex
5551b09969d6SVaclav Hapla 
5552b09969d6SVaclav Hapla   Level: advanced
5553b09969d6SVaclav Hapla 
55541cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexBuildCoordinatesFromCellListParallel()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexBuildFromCellList()`
5555b09969d6SVaclav Hapla @*/
5556d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexBuildCoordinatesFromCellList(DM dm, PetscInt spaceDim, const PetscReal vertexCoords[])
5557d71ae5a4SJacob Faibussowitsch {
5558b09969d6SVaclav Hapla   PetscSection coordSection;
5559b09969d6SVaclav Hapla   Vec          coordinates;
5560b09969d6SVaclav Hapla   DM           cdm;
5561b09969d6SVaclav Hapla   PetscScalar *coords;
55621edcf0b2SVaclav Hapla   PetscInt     v, vStart, vEnd, d;
5563b09969d6SVaclav Hapla 
5564b09969d6SVaclav Hapla   PetscFunctionBegin;
55659566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
55669566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
55671dca8a05SBarry Smith   PetscCheck(vStart >= 0 && vEnd >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "DM is not set up properly. DMPlexBuildFromCellList() should be called first.");
55689566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(dm, spaceDim));
55699566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
55709566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
55719566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, spaceDim));
55729566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, vStart, vEnd));
55731edcf0b2SVaclav Hapla   for (v = vStart; v < vEnd; ++v) {
55749566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, spaceDim));
55759566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, spaceDim));
5576b09969d6SVaclav Hapla   }
55779566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
5578b09969d6SVaclav Hapla 
55799566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dm, &cdm));
55809566063dSJacob Faibussowitsch   PetscCall(DMCreateLocalVector(cdm, &coordinates));
55819566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, spaceDim));
55829566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
55839566063dSJacob Faibussowitsch   PetscCall(VecGetArrayWrite(coordinates, &coords));
55841edcf0b2SVaclav Hapla   for (v = 0; v < vEnd - vStart; ++v) {
5585ad540459SPierre Jolivet     for (d = 0; d < spaceDim; ++d) coords[v * spaceDim + d] = vertexCoords[v * spaceDim + d];
5586b09969d6SVaclav Hapla   }
55879566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayWrite(coordinates, &coords));
55889566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
55899566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
55909566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_BuildCoordinatesFromCellList, dm, 0, 0, 0));
55913ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5592b09969d6SVaclav Hapla }
5593b09969d6SVaclav Hapla 
5594b09969d6SVaclav Hapla /*@
5595a1cb98faSBarry Smith   DMPlexCreateFromCellListPetsc - Create `DMPLEX` from a list of vertices for each cell (common mesh generator output), but only process 0 takes in the input
55963df08285SMatthew G. Knepley 
5597a1cb98faSBarry Smith   Collective
5598b09969d6SVaclav Hapla 
5599b09969d6SVaclav Hapla   Input Parameters:
5600b09969d6SVaclav Hapla + comm         - The communicator
5601b09969d6SVaclav Hapla . dim          - The topological dimension of the mesh
56023df08285SMatthew G. Knepley . numCells     - The number of cells, only on process 0
5603a1cb98faSBarry Smith . numVertices  - The number of vertices owned by this process, or `PETSC_DECIDE`, only on process 0
56043df08285SMatthew G. Knepley . numCorners   - The number of vertices for each cell, only on process 0
5605b09969d6SVaclav Hapla . interpolate  - Flag indicating that intermediate mesh entities (faces, edges) should be created automatically
56063df08285SMatthew G. Knepley . cells        - An array of numCells*numCorners numbers, the vertices for each cell, only on process 0
5607b09969d6SVaclav Hapla . spaceDim     - The spatial dimension used for coordinates
56083df08285SMatthew G. Knepley - vertexCoords - An array of numVertices*spaceDim numbers, the coordinates of each vertex, only on process 0
5609b09969d6SVaclav Hapla 
5610b09969d6SVaclav Hapla   Output Parameter:
5611a1cb98faSBarry Smith . dm - The `DM`, which only has points on process 0
561225b6865aSVaclav Hapla 
5613b09969d6SVaclav Hapla   Level: intermediate
5614b09969d6SVaclav Hapla 
5615a1cb98faSBarry Smith   Notes:
5616a1cb98faSBarry Smith   This function is just a convenient sequence of `DMCreate()`, `DMSetType()`, `DMSetDimension()`, `DMPlexBuildFromCellList()`,
5617a1cb98faSBarry Smith   `DMPlexInterpolate()`, `DMPlexBuildCoordinatesFromCellList()`
5618a1cb98faSBarry Smith 
5619a1cb98faSBarry Smith   See `DMPlexBuildFromCellList()` for an example and details about the topology-related parameters.
5620a1cb98faSBarry Smith   See `DMPlexBuildCoordinatesFromCellList()` for details about the geometry-related parameters.
5621a1cb98faSBarry Smith   See `DMPlexCreateFromCellListParallelPetsc()` for parallel input
5622a1cb98faSBarry Smith 
56231cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListParallelPetsc()`, `DMPlexBuildFromCellList()`, `DMPlexBuildCoordinatesFromCellList()`, `DMPlexCreateFromDAG()`, `DMPlexCreate()`
56249298eaa6SMatthew G Knepley @*/
5625d71ae5a4SJacob 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)
5626d71ae5a4SJacob Faibussowitsch {
56273df08285SMatthew G. Knepley   PetscMPIInt rank;
56289298eaa6SMatthew G Knepley 
56299298eaa6SMatthew G Knepley   PetscFunctionBegin;
563028b400f6SJacob 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.");
56319566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
56329566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
56339566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
56349566063dSJacob Faibussowitsch   PetscCall(DMSetDimension(*dm, dim));
5635c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildFromCellList(*dm, numCells, numVertices, numCorners, cells));
56369566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildFromCellList(*dm, 0, 0, 0, NULL));
56379298eaa6SMatthew G Knepley   if (interpolate) {
56385fd9971aSMatthew G. Knepley     DM idm;
56399298eaa6SMatthew G Knepley 
56409566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
56419566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
56429298eaa6SMatthew G Knepley     *dm = idm;
56439298eaa6SMatthew G Knepley   }
5644c5853193SPierre Jolivet   if (rank == 0) PetscCall(DMPlexBuildCoordinatesFromCellList(*dm, spaceDim, vertexCoords));
56459566063dSJacob Faibussowitsch   else PetscCall(DMPlexBuildCoordinatesFromCellList(*dm, spaceDim, NULL));
56463ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
56479298eaa6SMatthew G Knepley }
56489298eaa6SMatthew G Knepley 
5649939f6067SMatthew G. Knepley /*@
565020f4b53cSBarry Smith   DMPlexCreateFromDAG - This takes as input the adjacency-list representation of the Directed Acyclic Graph (Hasse Diagram) encoding a mesh, and produces a `DM`
5651939f6067SMatthew G. Knepley 
5652939f6067SMatthew G. Knepley   Input Parameters:
565320f4b53cSBarry Smith + dm               - The empty `DM` object, usually from `DMCreate()` and `DMSetDimension()`
5654939f6067SMatthew G. Knepley . depth            - The depth of the DAG
565520f4b53cSBarry Smith . numPoints        - Array of size depth + 1 containing the number of points at each `depth`
5656939f6067SMatthew G. Knepley . coneSize         - The cone size of each point
5657939f6067SMatthew G. Knepley . cones            - The concatenation of the cone points for each point, the cone list must be oriented correctly for each point
5658939f6067SMatthew G. Knepley . coneOrientations - The orientation of each cone point
565920f4b53cSBarry Smith - vertexCoords     - An array of `numPoints`[0]*spacedim numbers representing the coordinates of each vertex, with spacedim the value set via `DMSetCoordinateDim()`
5660939f6067SMatthew G. Knepley 
5661939f6067SMatthew G. Knepley   Output Parameter:
566220f4b53cSBarry Smith . dm - The `DM`
566320f4b53cSBarry Smith 
566420f4b53cSBarry Smith   Level: advanced
5665939f6067SMatthew G. Knepley 
5666a1cb98faSBarry Smith   Note:
5667a1cb98faSBarry Smith   Two triangles sharing a face would have input
5668a1cb98faSBarry Smith .vb
5669a1cb98faSBarry Smith   depth = 1, numPoints = [4 2], coneSize = [3 3 0 0 0 0]
5670a1cb98faSBarry Smith   cones = [2 3 4  3 5 4], coneOrientations = [0 0 0  0 0 0]
5671a1cb98faSBarry Smith  vertexCoords = [-1.0 0.0  0.0 -1.0  0.0 1.0  1.0 0.0]
5672a1cb98faSBarry Smith .ve
5673939f6067SMatthew G. Knepley   which would result in the DMPlex
5674a1cb98faSBarry Smith .vb
5675a1cb98faSBarry Smith         4
5676a1cb98faSBarry Smith       / | \
5677a1cb98faSBarry Smith      /  |  \
5678a1cb98faSBarry Smith     /   |   \
5679a1cb98faSBarry Smith    2  0 | 1  5
5680a1cb98faSBarry Smith     \   |   /
5681a1cb98faSBarry Smith      \  |  /
5682a1cb98faSBarry Smith       \ | /
5683a1cb98faSBarry Smith         3
5684a1cb98faSBarry Smith .ve
5685a1cb98faSBarry Smith   Notice that all points are numbered consecutively, unlike `DMPlexCreateFromCellListPetsc()`
5686939f6067SMatthew G. Knepley 
56871cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`
5688939f6067SMatthew G. Knepley @*/
5689d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateFromDAG(DM dm, PetscInt depth, const PetscInt numPoints[], const PetscInt coneSize[], const PetscInt cones[], const PetscInt coneOrientations[], const PetscScalar vertexCoords[])
5690d71ae5a4SJacob Faibussowitsch {
56919298eaa6SMatthew G Knepley   Vec          coordinates;
56929298eaa6SMatthew G Knepley   PetscSection coordSection;
56939298eaa6SMatthew G Knepley   PetscScalar *coords;
5694811e8653SToby Isaac   PetscInt     coordSize, firstVertex = -1, pStart = 0, pEnd = 0, p, v, dim, dimEmbed, d, off;
56959298eaa6SMatthew G Knepley 
56969298eaa6SMatthew G Knepley   PetscFunctionBegin;
56979566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
56989566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &dimEmbed));
569963a3b9bcSJacob Faibussowitsch   PetscCheck(dimEmbed >= dim, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Embedding dimension %" PetscInt_FMT " cannot be less than intrinsic dimension %" PetscInt_FMT, dimEmbed, dim);
57009298eaa6SMatthew G Knepley   for (d = 0; d <= depth; ++d) pEnd += numPoints[d];
57019566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(dm, pStart, pEnd));
57029298eaa6SMatthew G Knepley   for (p = pStart; p < pEnd; ++p) {
57039566063dSJacob Faibussowitsch     PetscCall(DMPlexSetConeSize(dm, p, coneSize[p - pStart]));
5704ad540459SPierre Jolivet     if (firstVertex < 0 && !coneSize[p - pStart]) firstVertex = p - pStart;
570597e052ccSToby Isaac   }
57061dca8a05SBarry Smith   PetscCheck(firstVertex >= 0 || !numPoints[0], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Expected %" PetscInt_FMT " vertices but could not find any", numPoints[0]);
57079566063dSJacob Faibussowitsch   PetscCall(DMSetUp(dm)); /* Allocate space for cones */
57089298eaa6SMatthew G Knepley   for (p = pStart, off = 0; p < pEnd; off += coneSize[p - pStart], ++p) {
57099566063dSJacob Faibussowitsch     PetscCall(DMPlexSetCone(dm, p, &cones[off]));
57109566063dSJacob Faibussowitsch     PetscCall(DMPlexSetConeOrientation(dm, p, &coneOrientations[off]));
57119298eaa6SMatthew G Knepley   }
57129566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(dm));
57139566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(dm));
57149298eaa6SMatthew G Knepley   /* Build coordinates */
57159566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
57169566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
57179566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, dimEmbed));
57189566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, firstVertex, firstVertex + numPoints[0]));
57199298eaa6SMatthew G Knepley   for (v = firstVertex; v < firstVertex + numPoints[0]; ++v) {
57209566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, dimEmbed));
57219566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, dimEmbed));
57229298eaa6SMatthew G Knepley   }
57239566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
57249566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
57259566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
57269566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
57279566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
57289566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, dimEmbed));
57299566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
57309318fe57SMatthew G. Knepley   if (vertexCoords) {
57319566063dSJacob Faibussowitsch     PetscCall(VecGetArray(coordinates, &coords));
57329298eaa6SMatthew G Knepley     for (v = 0; v < numPoints[0]; ++v) {
57339298eaa6SMatthew G Knepley       PetscInt off;
57349298eaa6SMatthew G Knepley 
57359566063dSJacob Faibussowitsch       PetscCall(PetscSectionGetOffset(coordSection, v + firstVertex, &off));
5736ad540459SPierre Jolivet       for (d = 0; d < dimEmbed; ++d) coords[off + d] = vertexCoords[v * dimEmbed + d];
57379298eaa6SMatthew G Knepley     }
57389318fe57SMatthew G. Knepley   }
57399566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
57409566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, coordinates));
57419566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
57423ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
57439298eaa6SMatthew G Knepley }
57448415267dSToby Isaac 
5745a4e35b19SJacob Faibussowitsch /*
5746a1cb98faSBarry Smith   DMPlexCreateCellVertexFromFile - Create a `DMPLEX` mesh from a simple cell-vertex file.
5747a1cb98faSBarry Smith 
5748a1cb98faSBarry Smith   Collective
57498ca92349SMatthew G. Knepley 
57508ca92349SMatthew G. Knepley + comm        - The MPI communicator
57518ca92349SMatthew G. Knepley . filename    - Name of the .dat file
57528ca92349SMatthew G. Knepley - interpolate - Create faces and edges in the mesh
57538ca92349SMatthew G. Knepley 
57548ca92349SMatthew G. Knepley   Output Parameter:
5755a1cb98faSBarry Smith . dm  - The `DM` object representing the mesh
57568ca92349SMatthew G. Knepley 
57578ca92349SMatthew G. Knepley   Level: beginner
57588ca92349SMatthew G. Knepley 
5759a1cb98faSBarry Smith   Note:
5760a1cb98faSBarry Smith   The format is the simplest possible:
5761a1cb98faSBarry Smith .vb
5762d0812dedSMatthew G. Knepley   dim Ne Nv Nc Nl
5763d0812dedSMatthew G. Knepley   v_1 v_2 ... v_Nc
5764d0812dedSMatthew G. Knepley   ...
5765d0812dedSMatthew G. Knepley   x y z marker_1 ... marker_Nl
5766a1cb98faSBarry Smith .ve
5767a1cb98faSBarry Smith 
5768a1cb98faSBarry Smith   Developer Note:
5769a1cb98faSBarry Smith   Should use a `PetscViewer` not a filename
5770a1cb98faSBarry Smith 
57716afe31f6SMartin Diehl .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromFile()`, `DMPlexCreateGmsh()`, `DMPlexCreate()`
5772a4e35b19SJacob Faibussowitsch */
5773ff6a9541SJacob Faibussowitsch static PetscErrorCode DMPlexCreateCellVertexFromFile(MPI_Comm comm, const char filename[], PetscBool interpolate, DM *dm)
5774d71ae5a4SJacob Faibussowitsch {
57758ca92349SMatthew G. Knepley   DMLabel      marker;
57768ca92349SMatthew G. Knepley   PetscViewer  viewer;
57778ca92349SMatthew G. Knepley   Vec          coordinates;
57788ca92349SMatthew G. Knepley   PetscSection coordSection;
57798ca92349SMatthew G. Knepley   PetscScalar *coords;
57808ca92349SMatthew G. Knepley   char         line[PETSC_MAX_PATH_LEN];
5781d0812dedSMatthew G. Knepley   PetscInt     cdim, coordSize, v, c, d;
57828ca92349SMatthew G. Knepley   PetscMPIInt  rank;
5783d0812dedSMatthew G. Knepley   int          snum, dim, Nv, Nc, Ncn, Nl;
57848ca92349SMatthew G. Knepley 
57858ca92349SMatthew G. Knepley   PetscFunctionBegin;
57869566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
57879566063dSJacob Faibussowitsch   PetscCall(PetscViewerCreate(comm, &viewer));
57889566063dSJacob Faibussowitsch   PetscCall(PetscViewerSetType(viewer, PETSCVIEWERASCII));
57899566063dSJacob Faibussowitsch   PetscCall(PetscViewerFileSetMode(viewer, FILE_MODE_READ));
57909566063dSJacob Faibussowitsch   PetscCall(PetscViewerFileSetName(viewer, filename));
5791dd400576SPatrick Sanan   if (rank == 0) {
5792d0812dedSMatthew G. Knepley     PetscCall(PetscViewerRead(viewer, line, 5, NULL, PETSC_STRING));
5793d0812dedSMatthew G. Knepley     snum = sscanf(line, "%d %d %d %d %d", &dim, &Nc, &Nv, &Ncn, &Nl);
5794d0812dedSMatthew G. Knepley     PetscCheck(snum == 5, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
579525ce1634SJed Brown   } else {
5796f8d5e320SMatthew G. Knepley     Nc = Nv = Ncn = Nl = 0;
57978ca92349SMatthew G. Knepley   }
5798d0812dedSMatthew G. Knepley   PetscCallMPI(MPI_Bcast(&dim, 1, MPI_INT, 0, comm));
5799d0812dedSMatthew G. Knepley   cdim = (PetscInt)dim;
58009566063dSJacob Faibussowitsch   PetscCall(DMCreate(comm, dm));
58019566063dSJacob Faibussowitsch   PetscCall(DMSetType(*dm, DMPLEX));
58029566063dSJacob Faibussowitsch   PetscCall(DMPlexSetChart(*dm, 0, Nc + Nv));
5803d0812dedSMatthew G. Knepley   PetscCall(DMSetDimension(*dm, (PetscInt)dim));
58049566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateDim(*dm, cdim));
58058ca92349SMatthew G. Knepley   /* Read topology */
5806dd400576SPatrick Sanan   if (rank == 0) {
5807f8d5e320SMatthew G. Knepley     char     format[PETSC_MAX_PATH_LEN];
5808f8d5e320SMatthew G. Knepley     PetscInt cone[8];
58098ca92349SMatthew G. Knepley     int      vbuf[8], v;
58108ca92349SMatthew G. Knepley 
58119371c9d4SSatish Balay     for (c = 0; c < Ncn; ++c) {
58129371c9d4SSatish Balay       format[c * 3 + 0] = '%';
58139371c9d4SSatish Balay       format[c * 3 + 1] = 'd';
58149371c9d4SSatish Balay       format[c * 3 + 2] = ' ';
58159371c9d4SSatish Balay     }
5816f8d5e320SMatthew G. Knepley     format[Ncn * 3 - 1] = '\0';
58179566063dSJacob Faibussowitsch     for (c = 0; c < Nc; ++c) PetscCall(DMPlexSetConeSize(*dm, c, Ncn));
58189566063dSJacob Faibussowitsch     PetscCall(DMSetUp(*dm));
58198ca92349SMatthew G. Knepley     for (c = 0; c < Nc; ++c) {
58209566063dSJacob Faibussowitsch       PetscCall(PetscViewerRead(viewer, line, Ncn, NULL, PETSC_STRING));
5821f8d5e320SMatthew G. Knepley       switch (Ncn) {
5822d71ae5a4SJacob Faibussowitsch       case 2:
5823d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1]);
5824d71ae5a4SJacob Faibussowitsch         break;
5825d71ae5a4SJacob Faibussowitsch       case 3:
5826d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2]);
5827d71ae5a4SJacob Faibussowitsch         break;
5828d71ae5a4SJacob Faibussowitsch       case 4:
5829d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3]);
5830d71ae5a4SJacob Faibussowitsch         break;
5831d71ae5a4SJacob Faibussowitsch       case 6:
5832d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3], &vbuf[4], &vbuf[5]);
5833d71ae5a4SJacob Faibussowitsch         break;
5834d71ae5a4SJacob Faibussowitsch       case 8:
5835d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &vbuf[0], &vbuf[1], &vbuf[2], &vbuf[3], &vbuf[4], &vbuf[5], &vbuf[6], &vbuf[7]);
5836d71ae5a4SJacob Faibussowitsch         break;
5837d71ae5a4SJacob Faibussowitsch       default:
5838d71ae5a4SJacob Faibussowitsch         SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "No cell shape with %d vertices", Ncn);
5839f8d5e320SMatthew G. Knepley       }
584008401ef6SPierre Jolivet       PetscCheck(snum == Ncn, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
5841f8d5e320SMatthew G. Knepley       for (v = 0; v < Ncn; ++v) cone[v] = vbuf[v] + Nc;
58428ca92349SMatthew G. Knepley       /* Hexahedra are inverted */
5843f8d5e320SMatthew G. Knepley       if (Ncn == 8) {
58448ca92349SMatthew G. Knepley         PetscInt tmp = cone[1];
58458ca92349SMatthew G. Knepley         cone[1]      = cone[3];
58468ca92349SMatthew G. Knepley         cone[3]      = tmp;
58478ca92349SMatthew G. Knepley       }
58489566063dSJacob Faibussowitsch       PetscCall(DMPlexSetCone(*dm, c, cone));
58498ca92349SMatthew G. Knepley     }
58508ca92349SMatthew G. Knepley   }
58519566063dSJacob Faibussowitsch   PetscCall(DMPlexSymmetrize(*dm));
58529566063dSJacob Faibussowitsch   PetscCall(DMPlexStratify(*dm));
58538ca92349SMatthew G. Knepley   /* Read coordinates */
58549566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(*dm, &coordSection));
58559566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetNumFields(coordSection, 1));
58569566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetFieldComponents(coordSection, 0, cdim));
58579566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(coordSection, Nc, Nc + Nv));
58588ca92349SMatthew G. Knepley   for (v = Nc; v < Nc + Nv; ++v) {
58599566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetDof(coordSection, v, cdim));
58609566063dSJacob Faibussowitsch     PetscCall(PetscSectionSetFieldDof(coordSection, v, 0, cdim));
58618ca92349SMatthew G. Knepley   }
58629566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(coordSection));
58639566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(coordSection, &coordSize));
58649566063dSJacob Faibussowitsch   PetscCall(VecCreate(PETSC_COMM_SELF, &coordinates));
58659566063dSJacob Faibussowitsch   PetscCall(PetscObjectSetName((PetscObject)coordinates, "coordinates"));
58669566063dSJacob Faibussowitsch   PetscCall(VecSetSizes(coordinates, coordSize, PETSC_DETERMINE));
58679566063dSJacob Faibussowitsch   PetscCall(VecSetBlockSize(coordinates, cdim));
58689566063dSJacob Faibussowitsch   PetscCall(VecSetType(coordinates, VECSTANDARD));
58699566063dSJacob Faibussowitsch   PetscCall(VecGetArray(coordinates, &coords));
5870dd400576SPatrick Sanan   if (rank == 0) {
5871f8d5e320SMatthew G. Knepley     char   format[PETSC_MAX_PATH_LEN];
58728ca92349SMatthew G. Knepley     double x[3];
5873f8d5e320SMatthew G. Knepley     int    l, val[3];
58748ca92349SMatthew G. Knepley 
5875f8d5e320SMatthew G. Knepley     if (Nl) {
58769371c9d4SSatish Balay       for (l = 0; l < Nl; ++l) {
58779371c9d4SSatish Balay         format[l * 3 + 0] = '%';
58789371c9d4SSatish Balay         format[l * 3 + 1] = 'd';
58799371c9d4SSatish Balay         format[l * 3 + 2] = ' ';
58809371c9d4SSatish Balay       }
5881f8d5e320SMatthew G. Knepley       format[Nl * 3 - 1] = '\0';
58829566063dSJacob Faibussowitsch       PetscCall(DMCreateLabel(*dm, "marker"));
58839566063dSJacob Faibussowitsch       PetscCall(DMGetLabel(*dm, "marker", &marker));
5884f8d5e320SMatthew G. Knepley     }
58858ca92349SMatthew G. Knepley     for (v = 0; v < Nv; ++v) {
58869566063dSJacob Faibussowitsch       PetscCall(PetscViewerRead(viewer, line, 3 + Nl, NULL, PETSC_STRING));
5887f8d5e320SMatthew G. Knepley       snum = sscanf(line, "%lg %lg %lg", &x[0], &x[1], &x[2]);
588808401ef6SPierre Jolivet       PetscCheck(snum == 3, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
5889f8d5e320SMatthew G. Knepley       switch (Nl) {
5890d71ae5a4SJacob Faibussowitsch       case 0:
5891d71ae5a4SJacob Faibussowitsch         snum = 0;
5892d71ae5a4SJacob Faibussowitsch         break;
5893d71ae5a4SJacob Faibussowitsch       case 1:
5894d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0]);
5895d71ae5a4SJacob Faibussowitsch         break;
5896d71ae5a4SJacob Faibussowitsch       case 2:
5897d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0], &val[1]);
5898d71ae5a4SJacob Faibussowitsch         break;
5899d71ae5a4SJacob Faibussowitsch       case 3:
5900d71ae5a4SJacob Faibussowitsch         snum = sscanf(line, format, &val[0], &val[1], &val[2]);
5901d71ae5a4SJacob Faibussowitsch         break;
5902d71ae5a4SJacob Faibussowitsch       default:
5903d71ae5a4SJacob Faibussowitsch         SETERRQ(PETSC_COMM_SELF, PETSC_ERR_SUP, "Request support for %d labels", Nl);
5904f8d5e320SMatthew G. Knepley       }
590508401ef6SPierre Jolivet       PetscCheck(snum == Nl, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Unable to parse cell-vertex file: %s", line);
59068ca92349SMatthew G. Knepley       for (d = 0; d < cdim; ++d) coords[v * cdim + d] = x[d];
59079566063dSJacob Faibussowitsch       for (l = 0; l < Nl; ++l) PetscCall(DMLabelSetValue(marker, v + Nc, val[l]));
59088ca92349SMatthew G. Knepley     }
59098ca92349SMatthew G. Knepley   }
59109566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(coordinates, &coords));
59119566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(*dm, coordinates));
59129566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&coordinates));
59139566063dSJacob Faibussowitsch   PetscCall(PetscViewerDestroy(&viewer));
59148ca92349SMatthew G. Knepley   if (interpolate) {
59158ca92349SMatthew G. Knepley     DM      idm;
59168ca92349SMatthew G. Knepley     DMLabel bdlabel;
59178ca92349SMatthew G. Knepley 
59189566063dSJacob Faibussowitsch     PetscCall(DMPlexInterpolate(*dm, &idm));
59199566063dSJacob Faibussowitsch     PetscCall(DMDestroy(dm));
59208ca92349SMatthew G. Knepley     *dm = idm;
59218ca92349SMatthew G. Knepley 
5922f8d5e320SMatthew G. Knepley     if (!Nl) {
59239566063dSJacob Faibussowitsch       PetscCall(DMCreateLabel(*dm, "marker"));
59249566063dSJacob Faibussowitsch       PetscCall(DMGetLabel(*dm, "marker", &bdlabel));
59259566063dSJacob Faibussowitsch       PetscCall(DMPlexMarkBoundaryFaces(*dm, PETSC_DETERMINE, bdlabel));
59269566063dSJacob Faibussowitsch       PetscCall(DMPlexLabelComplete(*dm, bdlabel));
59278ca92349SMatthew G. Knepley     }
5928f8d5e320SMatthew G. Knepley   }
59293ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
59308ca92349SMatthew G. Knepley }
59318ca92349SMatthew G. Knepley 
5932cc4c1da9SBarry Smith /*@
5933a1cb98faSBarry Smith   DMPlexCreateFromFile - This takes a filename and produces a `DM`
5934a1cb98faSBarry Smith 
5935a1cb98faSBarry Smith   Collective
5936ca522641SMatthew G. Knepley 
5937ca522641SMatthew G. Knepley   Input Parameters:
5938ca522641SMatthew G. Knepley + comm        - The communicator
5939ca522641SMatthew G. Knepley . filename    - A file name
5940a1cb98faSBarry Smith . plexname    - The object name of the resulting `DM`, also used for intra-datafile lookup by some formats
5941ca522641SMatthew G. Knepley - interpolate - Flag to create intermediate mesh pieces (edges, faces)
5942ca522641SMatthew G. Knepley 
5943ca522641SMatthew G. Knepley   Output Parameter:
5944a1cb98faSBarry Smith . dm - The `DM`
5945ca522641SMatthew G. Knepley 
5946a1cb98faSBarry Smith   Options Database Key:
5947a1cb98faSBarry Smith . -dm_plex_create_from_hdf5_xdmf - use the `PETSC_VIEWER_HDF5_XDMF` format for reading HDF5
594802ef0d99SVaclav Hapla 
594937fdd005SBarry Smith   Use `-dm_plex_create_ prefix` to pass options to the internal `PetscViewer`, e.g.
5950bca97951SVaclav Hapla $ -dm_plex_create_viewer_hdf5_collective
5951bca97951SVaclav Hapla 
5952ca522641SMatthew G. Knepley   Level: beginner
5953ca522641SMatthew G. Knepley 
5954a1cb98faSBarry Smith   Notes:
5955a1cb98faSBarry Smith   Using `PETSCVIEWERHDF5` type with `PETSC_VIEWER_HDF5_PETSC` format, one can save multiple `DMPLEX`
5956a1cb98faSBarry Smith   meshes in a single HDF5 file. This in turn requires one to name the `DMPLEX` object with `PetscObjectSetName()`
5957a1cb98faSBarry Smith   before saving it with `DMView()` and before loading it with `DMLoad()` for identification of the mesh object.
5958a1cb98faSBarry Smith   The input parameter name is thus used to name the `DMPLEX` object when `DMPlexCreateFromFile()` internally
5959a1cb98faSBarry Smith   calls `DMLoad()`. Currently, name is ignored for other viewer types and/or formats.
5960a1cb98faSBarry Smith 
59611cc06b55SBarry Smith .seealso: [](ch_unstructured), `DM`, `DMPLEX`, `DMPlexCreateFromDAG()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`, `PetscObjectSetName()`, `DMView()`, `DMLoad()`
5962ca522641SMatthew G. Knepley @*/
5963d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCreateFromFile(MPI_Comm comm, const char filename[], const char plexname[], PetscBool interpolate, DM *dm)
5964d71ae5a4SJacob Faibussowitsch {
5965ef3a5affSJacob Faibussowitsch   const char  extGmsh[]      = ".msh";
5966ef3a5affSJacob Faibussowitsch   const char  extGmsh2[]     = ".msh2";
5967ef3a5affSJacob Faibussowitsch   const char  extGmsh4[]     = ".msh4";
5968ef3a5affSJacob Faibussowitsch   const char  extCGNS[]      = ".cgns";
5969ef3a5affSJacob Faibussowitsch   const char  extExodus[]    = ".exo";
5970ef3a5affSJacob Faibussowitsch   const char  extExodus_e[]  = ".e";
5971ef3a5affSJacob Faibussowitsch   const char  extGenesis[]   = ".gen";
5972ef3a5affSJacob Faibussowitsch   const char  extFluent[]    = ".cas";
5973ef3a5affSJacob Faibussowitsch   const char  extHDF5[]      = ".h5";
59746f2c871aSStefano Zampini   const char  extXDMFHDF5[]  = ".xdmf.h5";
5975ef3a5affSJacob Faibussowitsch   const char  extPLY[]       = ".ply";
5976ef3a5affSJacob Faibussowitsch   const char  extEGADSLite[] = ".egadslite";
5977ef3a5affSJacob Faibussowitsch   const char  extEGADS[]     = ".egads";
5978ef3a5affSJacob Faibussowitsch   const char  extIGES[]      = ".igs";
5979ef3a5affSJacob Faibussowitsch   const char  extSTEP[]      = ".stp";
5980ef3a5affSJacob Faibussowitsch   const char  extCV[]        = ".dat";
5981ca522641SMatthew G. Knepley   size_t      len;
59826afe31f6SMartin Diehl   PetscBool   isGmsh, isGmsh2, isGmsh4, isCGNS, isExodus, isGenesis, isFluent, isHDF5, isPLY, isEGADSLite, isEGADS, isIGES, isSTEP, isCV, isXDMFHDF5;
5983ca522641SMatthew G. Knepley   PetscMPIInt rank;
5984ca522641SMatthew G. Knepley 
5985ca522641SMatthew G. Knepley   PetscFunctionBegin;
59864f572ea9SToby Isaac   PetscAssertPointer(filename, 2);
59874f572ea9SToby Isaac   if (plexname) PetscAssertPointer(plexname, 3);
59884f572ea9SToby Isaac   PetscAssertPointer(dm, 5);
59899566063dSJacob Faibussowitsch   PetscCall(DMInitializePackage());
59909566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_CreateFromFile, 0, 0, 0, 0));
59919566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
59929566063dSJacob Faibussowitsch   PetscCall(PetscStrlen(filename, &len));
599328b400f6SJacob Faibussowitsch   PetscCheck(len, comm, PETSC_ERR_ARG_WRONG, "Filename must be a valid path");
5994ef3a5affSJacob Faibussowitsch 
59959371c9d4SSatish Balay #define CheckExtension(extension__, is_extension__) \
59969371c9d4SSatish Balay   do { \
5997274aaeaaSJacob Faibussowitsch     PetscAssert(sizeof(extension__), comm, PETSC_ERR_PLIB, "Zero-size extension: %s", extension__); \
5998274aaeaaSJacob Faibussowitsch     /* don't count the null-terminator at the end */ \
5999274aaeaaSJacob Faibussowitsch     const size_t ext_len = sizeof(extension__) - 1; \
6000274aaeaaSJacob Faibussowitsch     if (len < ext_len) { \
6001ef3a5affSJacob Faibussowitsch       is_extension__ = PETSC_FALSE; \
6002ef3a5affSJacob Faibussowitsch     } else { \
6003274aaeaaSJacob Faibussowitsch       PetscCall(PetscStrncmp(filename + len - ext_len, extension__, ext_len, &is_extension__)); \
6004ef3a5affSJacob Faibussowitsch     } \
6005ef3a5affSJacob Faibussowitsch   } while (0)
6006ef3a5affSJacob Faibussowitsch 
6007ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh, isGmsh);
6008ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh2, isGmsh2);
6009ef3a5affSJacob Faibussowitsch   CheckExtension(extGmsh4, isGmsh4);
6010ef3a5affSJacob Faibussowitsch   CheckExtension(extCGNS, isCGNS);
6011ef3a5affSJacob Faibussowitsch   CheckExtension(extExodus, isExodus);
6012ef3a5affSJacob Faibussowitsch   if (!isExodus) CheckExtension(extExodus_e, isExodus);
6013ef3a5affSJacob Faibussowitsch   CheckExtension(extGenesis, isGenesis);
6014ef3a5affSJacob Faibussowitsch   CheckExtension(extFluent, isFluent);
6015ef3a5affSJacob Faibussowitsch   CheckExtension(extHDF5, isHDF5);
6016ef3a5affSJacob Faibussowitsch   CheckExtension(extPLY, isPLY);
6017ef3a5affSJacob Faibussowitsch   CheckExtension(extEGADSLite, isEGADSLite);
6018ef3a5affSJacob Faibussowitsch   CheckExtension(extEGADS, isEGADS);
6019ef3a5affSJacob Faibussowitsch   CheckExtension(extIGES, isIGES);
6020ef3a5affSJacob Faibussowitsch   CheckExtension(extSTEP, isSTEP);
6021ef3a5affSJacob Faibussowitsch   CheckExtension(extCV, isCV);
60226f2c871aSStefano Zampini   CheckExtension(extXDMFHDF5, isXDMFHDF5);
6023ef3a5affSJacob Faibussowitsch 
6024ef3a5affSJacob Faibussowitsch #undef CheckExtension
6025ef3a5affSJacob Faibussowitsch 
6026de78e4feSLisandro Dalcin   if (isGmsh || isGmsh2 || isGmsh4) {
60279566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateGmshFromFile(comm, filename, interpolate, dm));
6028ca522641SMatthew G. Knepley   } else if (isCGNS) {
60299566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateCGNSFromFile(comm, filename, interpolate, dm));
603090c68965SMatthew G. Knepley   } else if (isExodus || isGenesis) {
60319566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateExodusFromFile(comm, filename, interpolate, dm));
60322f0bd6dcSMichael Lange   } else if (isFluent) {
60339566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateFluentFromFile(comm, filename, interpolate, dm));
6034cc2f8f65SMatthew G. Knepley   } else if (isHDF5) {
6035cc2f8f65SMatthew G. Knepley     PetscViewer viewer;
6036cc2f8f65SMatthew G. Knepley 
603743b242b4SVaclav 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 */
60386f2c871aSStefano Zampini     PetscCall(PetscOptionsGetBool(NULL, NULL, "-dm_plex_create_from_hdf5_xdmf", &isXDMFHDF5, NULL));
60399566063dSJacob Faibussowitsch     PetscCall(PetscViewerCreate(comm, &viewer));
60409566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetType(viewer, PETSCVIEWERHDF5));
60419566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetOptionsPrefix(viewer, "dm_plex_create_"));
60429566063dSJacob Faibussowitsch     PetscCall(PetscViewerSetFromOptions(viewer));
60439566063dSJacob Faibussowitsch     PetscCall(PetscViewerFileSetMode(viewer, FILE_MODE_READ));
60449566063dSJacob Faibussowitsch     PetscCall(PetscViewerFileSetName(viewer, filename));
6045cd7e8a5eSksagiyam 
60469566063dSJacob Faibussowitsch     PetscCall(DMCreate(comm, dm));
6047f4f49eeaSPierre Jolivet     PetscCall(PetscObjectSetName((PetscObject)*dm, plexname));
60489566063dSJacob Faibussowitsch     PetscCall(DMSetType(*dm, DMPLEX));
60496f2c871aSStefano Zampini     if (isXDMFHDF5) PetscCall(PetscViewerPushFormat(viewer, PETSC_VIEWER_HDF5_XDMF));
60509566063dSJacob Faibussowitsch     PetscCall(DMLoad(*dm, viewer));
60516f2c871aSStefano Zampini     if (isXDMFHDF5) PetscCall(PetscViewerPopFormat(viewer));
60529566063dSJacob Faibussowitsch     PetscCall(PetscViewerDestroy(&viewer));
60535fd9971aSMatthew G. Knepley 
60545fd9971aSMatthew G. Knepley     if (interpolate) {
60555fd9971aSMatthew G. Knepley       DM idm;
60565fd9971aSMatthew G. Knepley 
60579566063dSJacob Faibussowitsch       PetscCall(DMPlexInterpolate(*dm, &idm));
60589566063dSJacob Faibussowitsch       PetscCall(DMDestroy(dm));
60595fd9971aSMatthew G. Knepley       *dm = idm;
60605fd9971aSMatthew G. Knepley     }
6061f2801cd6SMatthew G. Knepley   } else if (isPLY) {
60629566063dSJacob Faibussowitsch     PetscCall(DMPlexCreatePLYFromFile(comm, filename, interpolate, dm));
6063c1cad2e7SMatthew G. Knepley   } else if (isEGADSLite || isEGADS || isIGES || isSTEP) {
60649566063dSJacob Faibussowitsch     if (isEGADSLite) PetscCall(DMPlexCreateEGADSLiteFromFile(comm, filename, dm));
60659566063dSJacob Faibussowitsch     else PetscCall(DMPlexCreateEGADSFromFile(comm, filename, dm));
60667bee2925SMatthew Knepley     if (!interpolate) {
60677bee2925SMatthew Knepley       DM udm;
60687bee2925SMatthew Knepley 
60699566063dSJacob Faibussowitsch       PetscCall(DMPlexUninterpolate(*dm, &udm));
60709566063dSJacob Faibussowitsch       PetscCall(DMDestroy(dm));
60717bee2925SMatthew Knepley       *dm = udm;
60727bee2925SMatthew Knepley     }
60738ca92349SMatthew G. Knepley   } else if (isCV) {
60749566063dSJacob Faibussowitsch     PetscCall(DMPlexCreateCellVertexFromFile(comm, filename, interpolate, dm));
607598921bdaSJacob Faibussowitsch   } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Cannot load file %s: unrecognized extension", filename);
60769566063dSJacob Faibussowitsch   PetscCall(PetscStrlen(plexname, &len));
6077f4f49eeaSPierre Jolivet   if (len) PetscCall(PetscObjectSetName((PetscObject)*dm, plexname));
60789566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_CreateFromFile, 0, 0, 0, 0));
60793ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
6080ca522641SMatthew G. Knepley }
608112b8a6daSStefano Zampini 
6082cc4c1da9SBarry Smith /*@
60839f6c5813SMatthew 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.
60849f6c5813SMatthew G. Knepley 
60850528010dSStefano Zampini   Input Parameters:
60860528010dSStefano Zampini + tr     - The `DMPlexTransform`
60870528010dSStefano Zampini - prefix - An options prefix, or NULL
60889f6c5813SMatthew G. Knepley 
60899f6c5813SMatthew G. Knepley   Output Parameter:
60909f6c5813SMatthew G. Knepley . dm - The `DM`
60919f6c5813SMatthew G. Knepley 
60929f6c5813SMatthew G. Knepley   Level: beginner
60939f6c5813SMatthew G. Knepley 
609420f4b53cSBarry Smith   Notes:
609520f4b53cSBarry 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.
609620f4b53cSBarry Smith 
60979f6c5813SMatthew G. Knepley .seealso: `DMPlexCreateFromFile`, `DMPlexCreateFromDAG()`, `DMPlexCreateFromCellListPetsc()`, `DMPlexCreate()`
60989f6c5813SMatthew G. Knepley @*/
60990528010dSStefano Zampini PetscErrorCode DMPlexCreateEphemeral(DMPlexTransform tr, const char prefix[], DM *dm)
61009f6c5813SMatthew G. Knepley {
61010528010dSStefano Zampini   DM           bdm, bcdm, cdm;
61020528010dSStefano Zampini   Vec          coordinates, coordinatesNew;
61030528010dSStefano Zampini   PetscSection cs;
6104817b2c36SMatthew G. Knepley   PetscInt     cdim, Nl;
61059f6c5813SMatthew G. Knepley 
61069f6c5813SMatthew G. Knepley   PetscFunctionBegin;
61079f6c5813SMatthew G. Knepley   PetscCall(DMCreate(PetscObjectComm((PetscObject)tr), dm));
61089f6c5813SMatthew G. Knepley   PetscCall(DMSetType(*dm, DMPLEX));
61090528010dSStefano Zampini   ((DM_Plex *)(*dm)->data)->interpolated = DMPLEX_INTERPOLATED_FULL;
61100528010dSStefano Zampini   // Handle coordinates
61110528010dSStefano Zampini   PetscCall(DMPlexTransformGetDM(tr, &bdm));
6112817b2c36SMatthew G. Knepley   PetscCall(DMPlexTransformSetDimensions(tr, bdm, *dm));
6113817b2c36SMatthew G. Knepley   PetscCall(DMGetCoordinateDim(*dm, &cdim));
61140528010dSStefano Zampini   PetscCall(DMGetCoordinateDM(bdm, &bcdm));
61150528010dSStefano Zampini   PetscCall(DMGetCoordinateDM(*dm, &cdm));
61160528010dSStefano Zampini   PetscCall(DMCopyDisc(bcdm, cdm));
61170528010dSStefano Zampini   PetscCall(DMGetLocalSection(cdm, &cs));
61180528010dSStefano Zampini   PetscCall(PetscSectionSetNumFields(cs, 1));
61190528010dSStefano Zampini   PetscCall(PetscSectionSetFieldComponents(cs, 0, cdim));
61200528010dSStefano Zampini   PetscCall(DMGetCoordinatesLocal(bdm, &coordinates));
61210528010dSStefano Zampini   PetscCall(VecDuplicate(coordinates, &coordinatesNew));
61220528010dSStefano Zampini   PetscCall(VecCopy(coordinates, coordinatesNew));
61230528010dSStefano Zampini   PetscCall(DMSetCoordinatesLocal(*dm, coordinatesNew));
61240528010dSStefano Zampini   PetscCall(VecDestroy(&coordinatesNew));
61259f6c5813SMatthew G. Knepley 
61269f6c5813SMatthew G. Knepley   PetscCall(PetscObjectReference((PetscObject)tr));
61279f6c5813SMatthew G. Knepley   PetscCall(DMPlexTransformDestroy(&((DM_Plex *)(*dm)->data)->tr));
61289f6c5813SMatthew G. Knepley   ((DM_Plex *)(*dm)->data)->tr = tr;
61290528010dSStefano Zampini   PetscCall(DMPlexDistributeSetDefault(*dm, PETSC_FALSE));
61300528010dSStefano Zampini   PetscCall(PetscObjectSetOptionsPrefix((PetscObject)*dm, prefix));
61310528010dSStefano Zampini   PetscCall(DMSetFromOptions(*dm));
61329f6c5813SMatthew G. Knepley 
61339f6c5813SMatthew G. Knepley   PetscCall(DMGetNumLabels(bdm, &Nl));
61349f6c5813SMatthew G. Knepley   for (PetscInt l = 0; l < Nl; ++l) {
61359f6c5813SMatthew G. Knepley     DMLabel     label, labelNew;
61369f6c5813SMatthew G. Knepley     const char *lname;
61379f6c5813SMatthew G. Knepley     PetscBool   isDepth, isCellType;
61389f6c5813SMatthew G. Knepley 
61399f6c5813SMatthew G. Knepley     PetscCall(DMGetLabelName(bdm, l, &lname));
61409f6c5813SMatthew G. Knepley     PetscCall(PetscStrcmp(lname, "depth", &isDepth));
61419f6c5813SMatthew G. Knepley     if (isDepth) continue;
61429f6c5813SMatthew G. Knepley     PetscCall(PetscStrcmp(lname, "celltype", &isCellType));
61439f6c5813SMatthew G. Knepley     if (isCellType) continue;
61449f6c5813SMatthew G. Knepley     PetscCall(DMCreateLabel(*dm, lname));
61459f6c5813SMatthew G. Knepley     PetscCall(DMGetLabel(bdm, lname, &label));
61469f6c5813SMatthew G. Knepley     PetscCall(DMGetLabel(*dm, lname, &labelNew));
61479f6c5813SMatthew G. Knepley     PetscCall(DMLabelSetType(labelNew, DMLABELEPHEMERAL));
61489f6c5813SMatthew G. Knepley     PetscCall(DMLabelEphemeralSetLabel(labelNew, label));
61499f6c5813SMatthew G. Knepley     PetscCall(DMLabelEphemeralSetTransform(labelNew, tr));
61509f6c5813SMatthew G. Knepley     PetscCall(DMLabelSetUp(labelNew));
61519f6c5813SMatthew G. Knepley   }
61523ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
61539f6c5813SMatthew G. Knepley }
6154