DMPlexCreateOverlapLabelFromLabels#
Compute a label indicating what overlap points should be sent to new processes
Synopsis#
#include "petscdmplex.h"   
#include "petscdmlabel.h"  
PetscErrorCode DMPlexCreateOverlapLabelFromLabels(DM dm, PetscInt numLabels, const DMLabel label[], const PetscInt value[], PetscInt numExLabels, const DMLabel exLabel[], const PetscInt exValue[], PetscSection rootSection, IS rootrank, PetscSection leafSection, IS leafrank, DMLabel *ovLabel)
Collective
Input Parameters#
- dm - The - DM
- numLabels - The number of labels to draw candidate points from 
- label - An array of labels containing candidate points 
- value - An array of label values marking the candidate points 
- numExLabels - The number of labels to use for exclusion 
- exLabel - An array of labels indicating points to be excluded, or - NULL
- exValue - An array of label values to be excluded, or - NULL
- rootSection - The number of leaves for a given root point 
- rootrank - The rank of each edge into the root point 
- leafSection - The number of processes sharing a given leaf point 
- leafrank - The rank of each process sharing a leaf point 
Output Parameter#
- ovLabel - - DMLabelcontaining remote overlap contributions as point/rank pairings
Note#
The candidate points are only added to the overlap if they are adjacent to a shared point
See Also#
DMPLEX, DMPlexCreateOverlapLabel(), DMPlexGetAdjacency(), DMPlexDistributeOwnership(), DMPlexDistribute()
Level#
developer
Location#
src/dm/impls/plex/plexdistribute.c
Index of all DMPlex routines
Table of Contents for all manual pages
Index of all manual pages