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

VecGetArray1d

Returns a pointer to a 1d contiguous array that contains this processor's portion of the vector data. You MUST call VecRestoreArray1d() when you no longer need access to the array.

Synopsis

#include "petscvec.h"   
PetscErrorCode  VecGetArray1d(Vec x,PetscInt m,PetscInt mstart,PetscScalar *a[])
Logically Collective Many br

Input Parameter

x - the vector Many br
m - first dimension of two dimensional array Many br
mstart - first index you will use in first coordinate direction (often 0) Many br

Output Parameter

a -location to put pointer to the array Many br

Many br

Notes

For a vector obtained from DMCreateLocalVector() mstart are likely Many brobtained from the corner indices obtained from DMDAGetGhostCorners() while for Many brDMCreateGlobalVector() they are the corner indices from DMDAGetCorners(). Many br

For standard PETSc vectors this is an inexpensive call; it does not copy the vector values. Many br

See Also

VecGetArray(), VecRestoreArray(), VecGetArrays(), VecGetArrayF90(), VecPlaceArray(),
VecRestoreArray2d(), DMDAVecGetArray(), DMDAVecRestoreArray(), VecGetArray3d(), VecRestoreArray3d(), Many brVecGetArray2d(), VecRestoreArray1d(), VecGetArray4d(), VecRestoreArray4d() Many br

Level:developer
Location:
src/vec/vec/interface/rvector.c
Index of all Vec routines
Table of Contents for all manual pages
Index of all manual pages