petsc-3.14.6 2021-03-30
Report Typos and Errors

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

Note

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

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

Level

developer

Location

src/dm/impls/da/dadist.c

Examples

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

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