DMDAGlobalToNaturalBegin#

Maps values from the global vector to a global vector in the “natural” grid ordering. Must be followed by DMDAGlobalToNaturalEnd() to complete the exchange.

Synopsis#

#include "petscdmda.h"   
PetscErrorCode DMDAGlobalToNaturalBegin(DM da, Vec g, InsertMode mode, Vec n)

Neighbor-wise Collective

Input Parameters#

Output Parameter#

  • l - the natural ordering values

Notes#

The global and natural vectors used here need not be the same as those obtained from DMCreateGlobalVector() and DMDACreateNaturalVector(), BUT they must have the same parallel data layout; they could, for example, be obtained with VecDuplicate() from the DMDA originating vectors.

You must call DMDACreateNaturalVector() before using this routine

See Also#

DM, DMDA, DMDAGlobalToNaturalEnd(), DMLocalToGlobalBegin(), DMDACreate2d(), DMGlobalToLocalBegin(), DMGlobalToLocalEnd(), DMDACreateNaturalVector()

Level#

advanced

Location#

src/dm/impls/da/dagtol.c


Edit on GitLab

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