petsc-3.9.4 2018-09-11
DMPlexDistribute
Distributes the mesh and any associated sections.
Synopsis
#include "petscdmplex.h"
#include "petscdmlabel.h"
PetscErrorCode DMPlexDistribute(DM dm, PetscInt overlap, PetscSF *sf, DM *dmParallel)
Not Collective
Input Parameter
| dm | - The original DMPlex object
|
| overlap | - The overlap of partitions, 0 is the default
|
Output Parameter
| sf | - The PetscSF used for point distribution
|
| parallelMesh | - The distributed DMPlex object, or NULL
|
Note: If the mesh was not distributed, the return value is NULL.
The user can control the definition of adjacency for the mesh using DMPlexSetAdjacencyUseCone() and
DMPlexSetAdjacencyUseClosure(). They should choose the combination appropriate for the function
representation on the mesh.
Keywords
mesh, elements
See Also
DMPlexCreate(), DMPlexDistributeByFace(), DMPlexSetAdjacencyUseCone(), DMPlexSetAdjacencyUseClosure()
Level
intermediate
Location
src/dm/impls/plex/plexdistribute.c
Examples
src/dm/impls/plex/examples/tutorials/ex1.c.html
src/dm/impls/plex/examples/tutorials/ex5.c.html
src/dm/examples/tutorials/ex20.c.html
src/snes/examples/tutorials/ex12.c.html
src/snes/examples/tutorials/ex56.c.html
src/snes/examples/tutorials/ex62.c.html
src/snes/examples/tutorials/ex77.c.html
src/ts/examples/tutorials/ex11.c.html
src/ts/examples/tutorials/ex48.c.html
Index of all DMPLEX routines
Table of Contents for all manual pages
Index of all manual pages