DMCreateSectionSubDM#

Returns an IS and subDM+subSection encapsulating a subproblem defined by the fields in a PetscSection in the DM.

Synopsis#

#include "petscdm.h"     
PetscErrorCode DMCreateSectionSubDM(DM dm, PetscInt numFields, const PetscInt fields[], IS *is, DM *subdm)

Not Collective

Input Parameters#

  • dm - The DM object

  • numFields - The number of fields in this subproblem

  • fields - The field numbers of the selected fields

Output Parameters#

  • is - The global indices for the subproblem

  • subdm - The DM for the subproblem, which must already have be cloned from dm

Note#

This handles all information in the DM class and the PetscSection. This is used as the basis for creating subDMs in specialized classes, such as DMPLEX and DMFOREST

See Also#

DMCreateSubDM(), DMGetLocalSection(), DMPlexSetMigrationSF(), DMView()

Level#

intermediate

Location#

src/dm/interface/dmi.c

Edit on GitLab

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