DMDAVecGetArrayDOFRead#

Returns a multiple dimension array that shares data with the underlying vector and is indexed using the global dimensions.

Synopsis#

#include "petscdmda.h"   
PetscErrorCode DMDAVecGetArrayDOFRead(DM da, Vec vec, void *array)

Not Collective

Input Parameters#

Output Parameter#

  • array - the array

Notes#

Call DMDAVecRestoreArrayDOFRead() once you have finished accessing the vector entries.

In C, the indexing is “backwards” from what expects: array[k][j][i][DOF] NOT array[i][j][k][DOF]!

Fortran Note#

In Fortran you do not need a version of DMDAVecRestoreArrayDOF() just use DMDAVecRestoreArrayReadF90() and declare your array with one higher dimension, see src/dm/tutorials/ex11f90.F

See Also#

DM, DMDA, DMDAGetGhostCorners(), DMDAGetCorners(), VecGetArray(), VecRestoreArray(), DMDAVecRestoreArray(), DMDAVecGetArray(), DMDAVecGetArrayDOF(), DMDAVecGetArrayWrite(), DMDAVecRestoreArrayWrite(), DMDAVecGetArrayRead(), DMDAVecRestoreArrayRead()

Level#

intermediate

Location#

src/dm/impls/da/dagetarray.c

Examples#

src/ts/tutorials/extchemfield.c.html


Edit on GitLab

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