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 DMPLEX object

  • anchorSection - The section that describes the mapping from constrained points to the anchor points listed in anchorIS. Must have a local communicator (PETSC_COMM_SELF or derivative).

  • anchorIS - The list of all anchor points. Must have a local communicator (PETSC_COMM_SELF or 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#

src/dm/impls/plex/plex.c


Index of all DMPlex routines
Table of Contents for all manual pages
Index of all manual pages