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/tao/tutorials/ex3.c
src/tao/unconstrained/tutorials/eptorsion2.c
src/tao/unconstrained/tutorials/minsurf2.c
src/tao/tutorials/ex1.c
src/tao/unconstrained/tutorials/burgers_spectral.c
src/tao/unconstrained/tutorials/spectraladjointassimilation.c
src/tao/bound/tutorials/plate2.c
src/tao/complementarity/tutorials/blackscholes.c
src/tao/bound/tutorials/jbearing2.c
src/tao/tutorials/ex2.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