# DMLabelGather
Gather all label values from leafs into roots 
## Synopsis
```
#include "petscdmlabel.h"   
#include "petscsection.h"   
PetscErrorCode DMLabelGather(DMLabel label, PetscSF sf, DMLabel *labelNew)
```
Collective on sf


## Input Parameters

- ***label -*** the DMLabel
- ***sf -*** the Star Forest point communication map



## Output Parameters

- ***labelNew -*** the new DMLabel with localised leaf values




Note: This is the inverse operation to DMLabelDistribute.


## See Also
 `DMLabelDistribute()`

## Level
developer

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/label/dmlabel.c.html#DMLabelGather">src/dm/label/dmlabel.c</A>


---
[Edit on GitLab](https://gitlab.com/petsc/petsc/-/edit/release/src/dm/label/dmlabel.c)


[Index of all DMLabel routines](index.md)  
[Table of Contents for all manual pages](/docs/manualpages/index.md)  
[Index of all manual pages](/docs/manualpages/singleindex.md)  
