petsc-3.7.7 2017-09-25
Report Typos and Errors

DMCompositeGetGlobalISs

Gets the index sets for each composed object

Synopsis

#include "petscdmcomposite.h"  
PetscErrorCode  DMCompositeGetGlobalISs(DM dm,IS *is[])
Collective on DMComposite

Input Parameter

dm -the packer object

Output Parameters

is -the array of index sets

Notes

The is entries should be destroyed with ISDestroy(), the is array should be freed with PetscFree()

These could be used to extract a subset of vector entries for a "multi-physics" preconditioner

Use DMCompositeGetLocalISs() for index sets in the packed local numbering, and DMCompositeGetISLocalToGlobalMappings() for to map local sub-DM (including ghost) indices to packed global indices.

Fortran Notes

The output argument 'is' must be an allocated array of sufficient length, which can be learned using DMCompositeGetNumberDM().

See Also

DMDestroy(), DMCompositeAddDM(), DMCreateGlobalVector(),
DMCompositeGather(), DMCompositeCreate(), DMCompositeGetAccess(), DMCompositeScatter(), DMCompositeGetLocalVectors(), DMCompositeRestoreLocalVectors(),DMCompositeGetEntries()

Level:advanced
Location:
src/dm/impls/composite/pack.c
Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages

Examples

src/snes/examples/tutorials/ex28.c.html