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
DMobject
Output Parameters#
numFields - The number of fields (or
NULLif not requested)fieldNames - The number of each field (or
NULLif not requested)fields - The global indices for each field (or
NULLif 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 Note#
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#
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