Skip to main content
`Ctrl`+`K`

# DMCreateGlobalVector

Creates a global vector from a `DM` object. A global vector is a parallel vector that has no duplicate values shared between MPI ranks, that is it has no ghost locations.

## Synopsis

    #include "petscdm.h"
    #include "petscdmlabel.h"
    #include "petscds.h"
    PetscErrorCode DMCreateGlobalVector(DM dm, Vec *vec)

Collective

## Input Parameter

- dm - the `DM` object

## Output Parameter

- vec - the global vector

## See Also

DM Basics, `DM`, `Vec`, `DMCreateLocalVector()`, `DMGetGlobalVector()`, `DMDestroy()`, `DMView()`, `DMCreateInterpolation()`, `DMCreateColoring()`, `DMCreateMatrix()`, `DMGlobalToLocalBegin()`, `DMGlobalToLocalEnd()`

## Level

beginner

## Location

src/dm/interface/dm.c

## Examples

src/dm/dt/dualspace/impls/lagrange/tutorials/ex2.c
src/dm/impls/stag/tutorials/ex2.c
src/dm/impls/stag/tutorials/ex3.c
src/dm/impls/swarm/tutorials/ex1f90.F90
src/dm/impls/swarm/tutorials/ex1.c
src/dm/impls/stag/tutorials/ex6.c
src/dm/impls/stag/tutorials/ex8.c
src/dm/impls/stag/tutorials/ex1.c
src/dm/impls/stag/tutorials/ex4.c
src/dm/tutorials/ex21.c

## Implementations

DMCreateGlobalVector_Composite() in src/dm/impls/composite/pack.c
DMCreateGlobalVector_DA() in src/dm/impls/da/dadist.c
DMCreateGlobalVector_pforest() in src/dm/impls/forest/p4est/pforest.h
DMCreateGlobalVector_Moab() in src/dm/impls/moab/dmmbvec.cxx
DMCreateGlobalVector_Network() in src/dm/impls/network/networkcreate.c
DMCreateGlobalVector_Patch() in src/dm/impls/patch/patch.c
DMCreateGlobalVector_Plex() in src/dm/impls/plex/plexcreate.c
DMCreateGlobalVector_Redundant() in src/dm/impls/redundant/dmredundant.c
DMCreateGlobalVector_Shell() in src/dm/impls/shell/dmshell.c
DMCreateGlobalVector_Sliced() in src/dm/impls/sliced/sliced.c
DMCreateGlobalVector_Stag() in src/dm/impls/stag/stag.c
DMCreateGlobalVector_Swarm() in src/dm/impls/swarm/swarm.c
DMCreateGlobalVector_SNESVI() in src/snes/impls/vi/rs/virs.c

Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages