# DMLabelPermute
Create a new label with permuted points 
## Synopsis
```
#include "petscdmlabel.h"   
#include "petscsection.h"   
PetscErrorCode DMLabelPermute(DMLabel label, IS permutation, DMLabel *labelNew)
```
Not collective


## Input Parameters

- ***label -*** the DMLabel
- ***permutation -*** the point permutation



## Output Parameter

- ***labelnew -*** the new label containing the permuted points





## See Also
 `DMLabelCreate()`, `DMLabelGetValue()`, `DMLabelSetValue()`, `DMLabelClearValue()`

## Level
intermediate

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/label/dmlabel.c.html#DMLabelPermute">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)  
