petsc-3.7.1 2016-05-15
Report Typos and Errors

DMGetGlobalVector

Gets a MPI PETSc vector that may be used with the DMXXX routines.

Synopsis

#include "petscdm.h" 
PetscErrorCode  DMGetGlobalVector(DM dm,Vec *g)
Collective on DM Many br

Input Parameter

dm -the distributed array Many br

Output Parameter

g -the global vector Many br

Many br

Note

The vector values are NOT initialized and may have garbage in them, so you may need Many brto zero them. Many br

The output parameter, g, is a regular PETSc vector that should be returned with Many brDMRestoreGlobalVector() DO NOT call VecDestroy() on it. Many br

This is intended to be used for vectors you need for a short time, like within a single function call. Many brFor vectors that you intend to keep around (for example in a C struct) or pass around large parts of your Many brcode you should use DMCreateGlobalVector(). Many br

VecStride*() operations can be useful when using DM with dof > 1 Many br

Keywords

distributed array, create, Global, vector

See Also

DMCreateGlobalVector(), VecDuplicate(), VecDuplicateVecs(),
DMDACreate1d(), DMDACreate2d(), DMDACreate3d(), DMGlobalToLocalBegin(), Many brDMGlobalToLocalEnd(), DMLocalToGlobalBegin(), DMCreateLocalVector(), DMRestoreLocalVector() Many brVecStrideMax(), VecStrideMin(), VecStrideNorm() Many br

Level:beginner
Location:
src/dm/interface/dmget.c
Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages

Examples

src/dm/impls/plex/examples/tutorials/ex1.c.html
src/dm/impls/plex/examples/tutorials/ex1f90.F.html
src/dm/examples/tutorials/ex12.c.html
src/dm/examples/tutorials/ex51.c.html
src/dm/examples/tutorials/ex11f90.F.html
src/ksp/ksp/examples/tutorials/ex31.c.html
src/snes/examples/tutorials/ex12.c.html
src/snes/examples/tutorials/ex22.c.html
src/snes/examples/tutorials/ex33.c.html
src/snes/examples/tutorials/ex62.c.html