1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD> <link rel="canonical" href="http://www.mcs.anl.gov/petsc/petsc-current/docs/manualpages/DM/DMPlexStratify.html" />
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>DMPlexStratify</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<div id="version" align=right><b>petsc-3.7.5 2017-01-01</b></div>
<div id="bugreport" align=right><a href="mailto:petsc-maint@mcs.anl.gov?subject=Typo or Error in Documentation &body=Please describe the typo or error in the documentation: petsc-3.7.5 v3.7.5 docs/manualpages/DM/DMPlexStratify.html "><small>Report Typos and Errors</small></a></div>
<A NAME="DMPlexStratify"><H1>DMPlexStratify</H1></A>
The Sieve DAG for most topologies is a graded poset (http://en.wikipedia.org/wiki/Graded_poset), and can be illustrated by Hasse Diagram (a <a href="http://en.wikipedia.org/wiki/Hasse_diagram).">http://en.wikipedia.org/wiki/Hasse_diagram). </a> The strata group all points of the same grade, and this function calculates the strata. This grade can be seen as the height (or depth) of the point in the DAG.
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscdmplex.h"
PetscErrorCode DMPlexStratify(DM dm)
</PRE>
Collective on dm
<P>
<H3><FONT COLOR="#CC3333">Input Parameter</FONT></H3>
<DT><B>mesh </B> -The DMPlex
<br>
<P>
<H3><FONT COLOR="#CC3333">Output Parameter</FONT></H3>
<P>
<H3><FONT COLOR="#CC3333">Notes</FONT></H3>
Concretely, <A HREF="../DM/DMPlexStratify.html#DMPlexStratify">DMPlexStratify</A>() creates a new label named "depth" containing the dimension of each element: 0 for vertices,
1 for edges, and so on. The depth label can be accessed through <A HREF="../DM/DMPlexGetDepthLabel.html#DMPlexGetDepthLabel">DMPlexGetDepthLabel</A>() or <A HREF="../DM/DMPlexGetDepthStratum.html#DMPlexGetDepthStratum">DMPlexGetDepthStratum</A>(), or
manually via <A HREF="../DM/DMGetLabel.html#DMGetLabel">DMGetLabel</A>(). The height is defined implicitly by height = maxDimension - depth, and can be accessed
via <A HREF="../DM/DMPlexGetHeightStratum.html#DMPlexGetHeightStratum">DMPlexGetHeightStratum</A>(). For example, cells have height 0 and faces have height 1.
<P>
<A HREF="../DM/DMPlexStratify.html#DMPlexStratify">DMPlexStratify</A>() should be called after all calls to <A HREF="../DM/DMPlexSymmetrize.html#DMPlexSymmetrize">DMPlexSymmetrize</A>()
<P>
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
<A HREF="../DM/DMPlexCreate.html#DMPlexCreate">DMPlexCreate</A>(), <A HREF="../DM/DMPlexSymmetrize.html#DMPlexSymmetrize">DMPlexSymmetrize</A>()
<BR><P><B><P><B><FONT COLOR="#CC3333">Level:</FONT></B>beginner
<BR><FONT COLOR="#CC3333">Location:</FONT></B><A HREF="../../../src/dm/impls/plex/plex.c.html#DMPlexStratify">src/dm/impls/plex/plex.c</A>
<BR><A HREF="./index.html">Index of all DM routines</A>
<BR><A HREF="../../index.html">Table of Contents for all manual pages</A>
<BR><A HREF="../singleindex.html">Index of all manual pages</A>
<P><H3><FONT COLOR="#CC3333">Examples</FONT></H3>
<A HREF="../../../src/ts/examples/tutorials/ex11.c.html">src/ts/examples/tutorials/ex11.c.html</A><BR>
</BODY></HTML>
|
