DMGetRegionDS#

Get the PetscDS for a given mesh region, defined by a DMLabel

Synopsis#

#include "petscdm.h"          
#include "petscdmlabel.h"     
#include "petscds.h"     
PetscErrorCode DMGetRegionDS(DM dm, DMLabel label, IS *fields, PetscDS *ds, PetscDS *dsIn)

Not Collective

Input Parameters#

  • dm - The DM

  • label - The DMLabel defining the mesh region, or NULL for the entire mesh

Output Parameters#

  • fields - The IS containing the DM field numbers for the fields in this PetscDS, or NULL

  • ds - The PetscDS defined on the given region, or NULL

  • dsIn - The PetscDS for input in the given region, or NULL

Note#

If a non-NULL label is given, but there is no PetscDS on that specific label, the PetscDS for the full domain (if present) is returned. Returns with fields = NULL and ds = NULL if there is no PetscDS for the full domain.

See Also#

DM Basics, DM, DMGetRegionNumDS(), DMSetRegionDS(), DMGetDS(), DMGetCellDS()

Level#

advanced

Location#

src/dm/interface/dm.c

Examples#

src/dm/impls/plex/tutorials/ex8.c


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