:orphan:
# DMSwarmMigrate
Relocates points defined in the `DMSWARM` to other MPI-ranks 
## Synopsis
```
#include "petscdmswarm.h"   
PetscErrorCode DMSwarmMigrate(DM dm, PetscBool remove_sent_points)
```
Collective


## Input parameters

- ***dm -*** the `DMSWARM`
- ***remove_sent_points -*** flag indicating if sent points should be removed from the current MPI-rank





## Notes
The `DM` will be modified to accommodate received points.
If `remove_sent_points` is `PETSC_TRUE`, any points that were sent will be removed from the `DM`.
Different styles of migration are supported. See `DMSwarmSetMigrateType()`.


## See Also
 `DM`, `DMSWARM`, `DMSwarmSetMigrateType()`

## Level
advanced

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/impls/swarm/swarm.c.html#DMSwarmMigrate">src/dm/impls/swarm/swarm.c</A>

## Examples
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/impls/swarm/tutorials/ex1.c.html">src/dm/impls/swarm/tutorials/ex1.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/impls/swarm/tutorials/ex1f90.F90.html">src/dm/impls/swarm/tutorials/ex1f90.F90</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/tutorials/ex20.c.html">src/dm/tutorials/ex20.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/tutorials/ex21.c.html">src/dm/tutorials/ex21.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/tutorials/swarm_ex1.c.html">src/dm/tutorials/swarm_ex1.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/tutorials/swarm_ex3.c.html">src/dm/tutorials/swarm_ex3.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/ksp/ksp/tutorials/ex70.c.html">src/ksp/ksp/tutorials/ex70.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/snes/tutorials/ex63.c.html">src/snes/tutorials/ex63.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/ts/tutorials/ex77.c.html">src/ts/tutorials/ex77.c</A><BR>

## Implementations

<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/impls/swarm/swarm.c.html#DMSwarmMigrate_Basic">DMSwarmMigrate_Basic in src/dm/impls/swarm/swarm.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/impls/swarm/swarm_migrate.c.html#DMSwarmMigrate_DMNeighborScatter">DMSwarmMigrate_DMNeighborScatter in src/dm/impls/swarm/swarm_migrate.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/impls/swarm/swarm_migrate.c.html#DMSwarmMigrate_CellDMScatter">DMSwarmMigrate_CellDMScatter in src/dm/impls/swarm/swarm_migrate.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/impls/swarm/swarm_migrate.c.html#DMSwarmMigrate_CellDMExact">DMSwarmMigrate_CellDMExact in src/dm/impls/swarm/swarm_migrate.c</A><BR>


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


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