petsc-3.8.4 2018-03-24

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

Examples