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

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 Many br

Input Parameter

da - the distributed array Many br
vec - the vector, either a vector the same size as one obtained with Many brDMCreateGlobalVector() or DMCreateLocalVector() Many br

Output Parameter

array -the array Many br

Notes

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

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

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

Many br

Keywords

distributed array, get, corners, nodes, local indices, coordinates

See Also

DMDAGetGhostCorners(), DMDAGetCorners(), VecGetArray(), VecRestoreArray(), DMDAVecRestoreArray(), DMDAVecGetArray(), DMDAVecRestoreArrayDOF()

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