:orphan:
# DMCompositeGather
Gathers into a global packed vector from its individual local vectors
## Synopsis
```
#include "petscdmcomposite.h"
PetscErrorCode DMCompositeGather(DM dm, InsertMode imode, Vec gvec, ...)
```
Collective
## Input Parameters
- ***dm -*** the `DMCOMPOSITE` object
- ***gvec -*** the global vector
- ***imode -*** `INSERT_VALUES` or `ADD_VALUES`
- ***Vec ... -*** the individual sequential vectors, NULL for any that are not needed
## Fortran Note
Fortran users should use `DMCompositeGatherArray()`
## See Also
`DMCOMPOSITE`, `DM`, `DMDestroy()`, `DMCompositeAddDM()`, `DMCreateGlobalVector()`,
`DMCompositeScatter()`, `DMCompositeCreate()`, `DMCompositeGetISLocalToGlobalMappings()`, `DMCompositeGetAccess()`,
`DMCompositeGetLocalVectors()`, `DMCompositeRestoreLocalVectors()`, `DMCompositeGetEntries()`
## Level
advanced
## Location
src/dm/impls/composite/pack.c
## Examples
src/snes/tutorials/ex21.c
---
[Edit on GitLab](https://gitlab.com/petsc/petsc/-/edit/release/src/dm/impls/composite/pack.c)
[Index of all DM routines](index.md)
[Table of Contents for all manual pages](/manualpages/index.md)
[Index of all manual pages](/manualpages/singleindex.md)