petsc-3.11.4 2019-09-28
DMGetCoordinatesLocalTuple
Gets a local vector with the coordinates of specified points and section describing its layout.
Synopsis
#include "petscdm.h"
#include "petscdmlabel.h"
#include "petscds.h"
PetscErrorCode DMGetCoordinatesLocalTuple(DM dm, IS p, PetscSection *pCoordSection, Vec *pCoord)
Not collective
Input Parameter
| dm | - the DM
|
| p | - the IS of points whose coordinates will be returned
|
Output Parameter
| pCoordSection | - the PetscSection describing the layout of pCoord, i.e. each point corresponds to one point in p, and DOFs correspond to coordinates
|
| pCoord | - the Vec with coordinates of points in p
|
Note
DMGetCoordinatesLocalSetUp() must be called first. This function employs DMGetCoordinatesLocalNoncollective() so it is not collective.
This creates a new vector, so the user SHOULD destroy this vector
Each process has the local and ghost coordinates
For DMDA, in two and three dimensions coordinates are interlaced (x_0,y_0,x_1,y_1,...)
and (x_0,y_0,z_0,x_1,y_1,z_1...)
Keywords
distributed array, get, corners, nodes, local indices, coordinates
See Also
DMSetCoordinatesLocal(), DMGetCoordinatesLocal(), DMGetCoordinatesLocalNoncollective(), DMGetCoordinatesLocalSetUp(), DMGetCoordinates(), DMSetCoordinates(), DMGetCoordinateDM()
Level
advanced
Location
src/dm/interface/dm.c
Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages