petsc-3.12.5 2020-03-29

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.

Level

intermediate

Location