PetscSpaceGetHeightSubspace#

Get the subset of the primal space basis that is supported on a mesh point of a given height.

Synopsis#

#include "petscfe.h"  
PetscErrorCode PetscSpaceGetHeightSubspace(PetscSpace sp, PetscInt height, PetscSpace *subsp)

Not Collective

Input Parameters#

sp - the PetscSpace object
height - the height of the mesh point for which the subspace is desired

Output Parameter#

subsp - the subspace

Notes#

If the space is not defined on mesh points of the given height (e.g. if the space is discontinuous and pointwise values are not defined on the element boundaries), or if the implementation of PetscSpace does not support extracting subspaces, then NULL is returned.

This does not increment the reference count on the returned space, and the user should not destroy it.