DMPlexSetAnchors#
Set the layout of the local anchor (point-to-point) constraints.
Synopsis#
#include "petscdmplex.h"
PetscErrorCode DMPlexSetAnchors(DM dm, PetscSection anchorSection, IS anchorIS)
Collective
Input Parameters#
dm - The
DMPLEXobjectanchorSection - The section that describes the mapping from constrained points to the anchor points listed in anchorIS. Must have a local communicator (
PETSC_COMM_SELFor derivative).anchorIS - The list of all anchor points. Must have a local communicator (
PETSC_COMM_SELFor derivative).
Notes#
Unlike boundary conditions, when a point’s degrees of freedom in a section are constrained to an outside value, the anchor constraints set a point’s degrees of freedom to be a linear combination of other points’ degrees of freedom.
After specifying the layout of constraints with DMPlexSetAnchors(), one specifies the constraints by calling
DMGetDefaultConstraints() and filling in the entries in the constraint matrix.
The reference counts of anchorSection and anchorIS are incremented.
See Also#
DMPlex: Unstructured Grids, DM, DMPLEX, DMPlexGetAnchors(), DMGetDefaultConstraints(), DMSetDefaultConstraints()
Level#
intermediate
Location#
Index of all DMPlex routines
Table of Contents for all manual pages
Index of all manual pages