petsc-3.7.1 2016-05-15
Report Typos and Errors

DMDANaturalToGlobalBegin

Maps values from a global vector in the "natural" ordering to a global vector in the PETSc DMDA grid ordering. Must be followed by DMDANaturalToGlobalEnd() to complete the exchange.

Synopsis

#include "petscdmda.h"   
PetscErrorCode  DMDANaturalToGlobalBegin(DM da,Vec g,InsertMode mode,Vec l)
Neighbor-wise Collective on DMDA Many br

Input Parameters

da - the distributed array context Many br
g - the global vector in a natural ordering Many br
mode - one of INSERT_VALUES or ADD_VALUES Many br

Output Parameter

l -the values in the DMDA ordering Many br

Many br

Notes

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

Keywords

distributed array, global to local, begin

See Also

DMDAGlobalToNaturalEnd(), DMDAGlobalToNaturalBegin(), DMLocalToGlobalBegin(), DMDACreate2d(),
DMGlobalToLocalBegin(), DMGlobalToLocalEnd(), DMDACreateNaturalVector() Many br

Level:advanced
Location:
src/dm/impls/da/dagtol.c
Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages