DMPlexPointGlobalRef

return read/write access to a point in global array

Synopsis

#include "petscdmplex.h"   
PetscErrorCode DMPlexPointGlobalRef(DM dm, PetscInt point, PetscScalar *array, void *ptr)

Not Collective

Input Parameters

• dm - DM defining topological space

• point - topological point

• array - array to index into

Output Parameter

• ptr - address of reference to point data, type generic so user can place in structure; returns NULL if global point is not owned

Note

A common usage when data sizes are known statically:

  struct { PetscScalar foo,bar,baz; } *ptr;
  DMPlexPointGlobalRef(dm,point,array,&ptr);
  ptr->foo = 2; ptr->bar = 3; ptr->baz = 5;

See Also

DMPlex: Unstructured Grids, DM, DMPLEX, DMGetLocalSection(), PetscSectionGetOffset(), PetscSectionGetDof(), DMPlexGetPointGlobal(), DMPlexPointLocalRef(), DMPlexPointGlobalRead()

Level

intermediate

Location

src/dm/impls/plex/plexpoint.c

Examples

src/ts/tutorials/ex11_sa.c

---

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