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#
da - the distributed array context
g - the global vector
mode - one of
INSERT_VALUES
orADD_VALUES
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#
Index of all DMDA routines
Table of Contents for all manual pages
Index of all manual pages