DMPlexTransformCellTransform#
Describes the transform of a given source cell into a set of other target cells. These produced cells become the new mesh.
Synopsis#
#include "petscdmplextransform.h"
PetscErrorCode DMPlexTransformCellTransform(DMPlexTransform tr, DMPolytopeType source, PetscInt p, PetscInt *rt, PetscInt *Nt, DMPolytopeType *target[], PetscInt *size[], PetscInt *cone[], PetscInt *ornt[])
Input Parameters#
tr - The
DMPlexTransform
objectsource - The source cell type
p - The source point, which can also determine the refine type
Output Parameters#
rt - The refine type for this point
Nt - The number of types produced by this point
target - An array of length Nt giving the types produced
size - An array of length Nt giving the number of cells of each type produced
cone - An array of length Nt*size[t]*coneSize[t] giving the cell type for each point in the cone of each produced point
ornt - An array of length Nt*size[t]*coneSize[t] giving the orientation for each point in the cone of each produced point
Notes#
The cone array gives the cone of each subcell listed by the first three outputs. For each cone point, we need the cell type, point identifier, and orientation within the subcell. The orientation is with respect to the canonical division (described in these outputs) of the cell in the original mesh. The point identifier is given by
the number of cones to be taken, or 0 for the current cell
the cell cone point number at each level from which it is subdivided
the replica number r of the subdivision.
The orientation is with respect to the canonical cone orientation. For example, the prescription for edge division is
Nt = 2
target = {DM_POLYTOPE_POINT, DM_POLYTOPE_SEGMENT}
size = {1, 2}
cone = {DM_POLYTOPE_POINT, 1, 0, 0, DM_POLYTOPE_POINT, 0, 0, DM_POLYTOPE_POINT, 0, 0, DM_POLYTOPE_POINT, 1, 1, 0}
ornt = { 0, 0, 0, 0}
See Also#
DMPlex: Unstructured Grids in PETSc, DM
, DMPLEX
, DMPlexTransform
, DMPolytopeType
, DMPlexTransformApply()
, DMPlexTransformCreate()
Level#
advanced
Location#
Examples#
Implementations#
DMPlexTransformCellTransform_Extrude in src/dm/impls/plex/transform/impls/extrude/plextrextrude.c
DMPlexTransformCellTransform_Filter in src/dm/impls/plex/transform/impls/filter/plextrfilter.c
DMPlexTransformCellTransform_1D in src/dm/impls/plex/transform/impls/refine/1d/plexref1d.c
DMPlexTransformCellTransform_BL in src/dm/impls/plex/transform/impls/refine/bl/plexrefbl.c
DMPlexTransformCellTransform_SBR in src/dm/impls/plex/transform/impls/refine/sbr/plexrefsbr.c
Index of all DMPlex routines
Table of Contents for all manual pages
Index of all manual pages