DMPlexSetAnchors — PETSc 3.21.4 documentation

Skip to main content
`Ctrl`+`K`

# 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