DMDACreateNaturalVector#

Creates a parallel PETSc vector that will hold vector values in the natural numbering, rather than in the PETSc parallel numbering associated with the DMDA.

Synopsis#

#include "petscdmda.h"   
PetscErrorCode DMDACreateNaturalVector(DM da, Vec *g)

Collective

Input Parameter#

  • da - the distributed array

Output Parameter#

  • g - the distributed global vector

Notes#

The output parameter, g, is a regular PETSc vector that should be destroyed with a call to VecDestroy() when usage is finished.

The number of local entries in the vector on each process is the same as in a vector created with DMCreateGlobalVector().

See Also#

DM, DMDA, DMCreateLocalVector(), VecDuplicate(), VecDuplicateVecs(), DMDACreate1d(), DMDACreate2d(), DMDACreate3d(), DMGlobalToLocalBegin(), DMGlobalToLocalEnd(), DMLocalToGlobalBegin()

Level#

developer

Location#

src/dm/impls/da/dadist.c

Examples#

src/dm/tutorials/ex6.c
src/ksp/ksp/tutorials/ex71.c


Edit on GitLab

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