DMCreateSubDM#
Returns an IS and DM encapsulating a subproblem defined by the fields passed in. The fields are defined by DMCreateFieldIS().
Synopsis#
#include "petscdm.h"
#include "petscdmlabel.h"
#include "petscds.h"
PetscErrorCode DMCreateSubDM(DM dm, PetscInt numFields, const PetscInt fields[], IS *is, DM *subdm)
Not collective
Input Parameters#
dm - The
DMobjectnumFields - The number of fields to select
fields - The field numbers of the selected fields
Output Parameters#
Note#
You need to call DMPlexSetMigrationSF() on the original DM if you want the Global-To-Natural map to be automatically constructed
See Also#
DM Basics, DM, DMCreateFieldIS(), DMCreateFieldDecomposition(), DMAddField(), DMCreateSuperDM(), DM, IS, DMPlexSetMigrationSF(), DMDestroy(), DMView(), DMCreateInterpolation(), DMCreateColoring(), DMCreateMatrix(), DMCreateMassMatrix(), DMCreateFieldIS()
Level#
intermediate
Location#
Examples#
src/snes/tutorials/ex56.c
src/snes/tutorials/ex63.c
src/snes/tutorials/ex77.c
src/ts/tutorials/ex77.c
Implementations#
DMCreateSubDM_DA in src/dm/impls/da/dacreate.c
DMCreateSubDM_Forest in src/dm/impls/forest/forest.c
DMCreateSubDM_Patch in src/dm/impls/patch/patch.c
DMCreateSubDM_Plex in src/dm/impls/plex/plex.c
DMCreateSubDM_Shell in src/dm/impls/shell/dmshell.c
Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages