DMGetLabel#
Return the label of a given name, or NULL
, from a DM
Synopsis#
#include "petscdm.h"
#include "petscdmlabel.h"
#include "petscds.h"
PetscErrorCode DMGetLabel(DM dm, const char name[], DMLabel *label)
Not Collective
Input Parameters#
dm - The
DM
objectname - The label name
Output Parameter#
label - The
DMLabel
, orNULL
if the label is absent
Default labels in a DMPLEX
#
“depth” - Holds the depth (co-dimension) of each mesh point
“celltype” - Holds the topological type of each cell
“ghost” - If the DM is distributed with overlap, this marks the cells and faces in the overlap
“Cell Sets” - Mirrors the cell sets defined by GMsh and ExodusII
“Face Sets” - Mirrors the face sets defined by GMsh and ExodusII
“Vertex Sets” - Mirrors the vertex sets defined by GMsh
See Also#
DM Basics, DM
, DMLabel
, DMHasLabel()
, DMGetLabelByNum()
, DMAddLabel()
, DMCreateLabel()
, DMPlexGetDepthLabel()
, DMPlexGetCellType()
Level#
intermediate
Location#
Examples#
src/snes/tutorials/ex12.c
src/snes/tutorials/ex20.c
src/snes/tutorials/ex26.c
src/snes/tutorials/ex13.c
src/snes/tutorials/ex23.c
src/dm/impls/plex/tutorials/ex6.c
src/dm/label/tutorials/ex1.c
src/snes/tutorials/ex17.c
src/snes/tutorials/ex24.c
src/dm/impls/plex/tutorials/ex10.c
Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages