DMDANaturalToGlobalEnd — PETSc 3.21.4 documentation

Skip to main content
`Ctrl`+`K`

# DMDANaturalToGlobalEnd

Maps values from the natural ordering global vector to a global vector in the PETSc `DMDA` ordering. Must be preceded by `DMDANaturalToGlobalBegin()`.

## Synopsis

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

Neighbor-wise Collective

## Input Parameters

- da - the `DMDA` context

- g - the global vector in a natural ordering

- mode - one of `INSERT_VALUES` or `ADD_VALUES`

## Output Parameter

- n - the global values in the PETSc `DMDA` ordering

## Note

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

DMDA - Creating vectors for structured grids, `DM`, `DMDA`, `DMDAGlobalToNaturalBegin()`, `DMDAGlobalToNaturalEnd()`, `DMLocalToGlobalBegin()`, `DMDACreate2d()`, `DMGlobalToLocalBegin()`, `DMGlobalToLocalEnd()`, `DMDACreateNaturalVector()`

## Level

advanced

## Location

src/dm/impls/da/dagtol.c

## Examples

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

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