DMCreateSuperDM

Returns an arrays of IS and DM encapsulating a superproblem defined by multiple DMs passed in.

Synopsis

#include "petscdm.h"          
#include "petscdmlabel.h"     
#include "petscds.h"     
PetscErrorCode DMCreateSuperDM(DM dms[], PetscInt n, IS **is, DM *superdm)

Not collective

Input Parameters

• dms - The DM objects

• n - The number of DMs

Output Parameters

• is - The global indices for each of subproblem within the super DM, or NULL

• superdm - The DM for the superproblem

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, DMCreateSubDM(), DMPlexSetMigrationSF(), DMDestroy(), DMView(), DMCreateInterpolation(), DMCreateColoring(), DMCreateMatrix(), DMCreateMassMatrix(), DMCreateFieldIS(), DMCreateDomainDecomposition()

Level

intermediate

Location

src/dm/interface/dm.c

Examples

src/snes/tutorials/ex13.c

Implementations

DMCreateSuperDM_Plex() in src/dm/impls/plex/plex.c

---

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