DMCreateSectionSubDM

Returns an IS and subDM containing a PetscSection that encapsulates a subproblem defined by a subset of the fields in a PetscSection in the DM.

Synopsis

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

Not Collective

Input Parameters

• dm - The DM object

• numFields - The number of fields to incorporate into subdm

• fields - The field numbers of the selected fields

• numComps - The number of components from each field to incorporate into subdm, or PETSC_DECIDE for all components

• comps - The component numbers of the selected fields (omitted for PTESC_DECIDE fields)

Output Parameters

• is - The global indices for the subproblem or NULL

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

Notes

If is and subdm are both NULL this does nothing

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