petsc-3.12.5 2020-03-29
Report Typos and Errors

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 Plex and Forest.

See Also

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

Level

intermediate

Location

src/dm/interface/dmi.c
Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages