PETSc version 3.17.0
Fix/Edit manual page

DMCopyLabels

Copy labels from one mesh to another with a superset of the points

Synopsis

#include "petscdm.h"          
#include "petscdmlabel.h"     
#include "petscds.h"     
PetscErrorCode DMCopyLabels(DM dmA, DM dmB, PetscCopyMode mode, PetscBool all, DMCopyLabelsMode emode)
Collective on dmA

Input Parameters

dmA - The DM object with initial labels
dmB - The DM object to which labels are copied
mode - Copy labels by pointers (PETSC_OWN_POINTER) or duplicate them (PETSC_COPY_VALUES)
all - Copy all labels including "depth", "dim", and "celltype" (PETSC_TRUE) which are otherwise ignored (PETSC_FALSE)
emode - How to behave when a DMLabel in the source and destination DMs with the same name is encountered (see DMCopyLabelsMode)

Notes

This is typically used when interpolating or otherwise adding to a mesh, or testing.

See Also

DMAddLabel(), DMCopyLabelsMode

Level

intermediate

Location

src/dm/interface/dm.c

Examples

src/dm/label/tutorials/ex1.c.html

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