DMCreateFieldIS#

Creates a set of IS objects with the global indices of dofs for each field defined with DMAddField()

Synopsis#

#include "petscdm.h"          
#include "petscdmlabel.h"     
#include "petscds.h"     
PetscErrorCode DMCreateFieldIS(DM dm, PetscInt *numFields, char ***fieldNames, IS **fields)

Not Collective; No Fortran Support

Input Parameter#

  • dm - the DM object

Output Parameters#

  • numFields - The number of fields (or NULL if not requested)

  • fieldNames - The number of each field (or NULL if not requested)

  • fields - The global indices for each field (or NULL if not requested)

Note#

The user is responsible for freeing all requested arrays. In particular, every entry of names should be freed with PetscFree(), every entry of fields should be destroyed with ISDestroy(), and both arrays should be freed with PetscFree().

Developer Notes#

It is not clear why both this function and DMCreateFieldDecomposition() exist. Having two seems redundant and confusing. This function should likely be removed.

See Also#

DM Basics, DM, DMAddField(), DMGetField(), DMDestroy(), DMView(), DMCreateInterpolation(), DMCreateColoring(), DMCreateMatrix(), DMCreateFieldDecomposition()

Level#

intermediate

Location#

src/dm/interface/dm.c

Implementations#

DMCreateFieldIS_Composite() in src/dm/impls/composite/pack.c

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