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

DMDAGlobalToNaturalEnd

 Maps values from the global vector to a global vector in the natural ordering. Must be preceeded by DMDAGlobalToNaturalBegin().

Synopsis

#include "petscdmda.h"   
PetscErrorCode  DMDAGlobalToNaturalEnd(DM da,Vec g,InsertMode mode,Vec n)
Neighbor-wise Collective on da

Input Parameters

da - the distributed array context
g - the global vector
mode - one of INSERT_VALUES or ADD_VALUES

Output Parameter

l - the global values in the natural ordering

Notes

The global and local 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.

See Also

DMDAGlobalToNaturalBegin(), DMLocalToGlobalBegin(), DMDACreate2d(),
DMGlobalToLocalBegin(), DMGlobalToLocalEnd(), DMDACreateNaturalVector()

Level

advanced

Location

src/dm/impls/da/dagtol.c
Index of all DMDA routines
Table of Contents for all manual pages
Index of all manual pages