petsc-3.11.4 2019-09-28
Report Typos and Errors


Create a PetscSection based upon the dof layout specification provided.


#include "petscdmplex.h"   
PetscErrorCode DMPlexCreateSection(DM dm, DMLabel label[], const PetscInt numComp[],const PetscInt numDof[], PetscInt numBC, const PetscInt bcField[], const IS bcComps[], const IS bcPoints[], IS perm, PetscSection *section)
Not Collective

Input Parameters

dm - The DMPlex object
numComp - An array of size numFields that holds the number of components for each field
numDof - An array of size numFields*(dim+1) which holds the number of dof for each field on a mesh piece of dimension d
label - The label indicating the mesh support of each field, or NULL for the whole mesh
numBC - The number of boundary conditions
bcField - An array of size numBC giving the field number for each boundry condition
bcComps - [Optional] An array of size numBC giving an IS holding the field components to which each boundary condition applies
bcPoints - An array of size numBC giving an IS holding the Plex points to which each boundary condition applies
perm - Optional permutation of the chart, or NULL

Output Parameter

section -The PetscSection object


numDof[f*(dim+1)+d] gives the number of dof for field f on points of dimension d. For instance, numDof[1] is the number of dof for field 0 on each edge.

The chart permutation is the same one set using PetscSectionSetPermutation()

Fortran Notes

A Fortran 90 version is available as DMPlexCreateSectionF90()


mesh, elements

See Also

DMPlexCreate(), PetscSectionCreate(), PetscSectionSetPermutation()







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