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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD> <link rel="canonical" href="http://www.mcs.anl.gov/petsc/petsc-current/docs/manualpages/DMPLEX/DMPlexCellRefinerRefine.html" />
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>DMPlexCellRefinerRefine</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<div id="version" align=right><b>petsc-3.14.5 2021-03-03</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.14.5 v3.14.5 docs/manualpages/DMPLEX/DMPlexCellRefinerRefine.html "><small>Report Typos and Errors</small></a></div>
<A NAME="DMPlexCellRefinerRefine"><H1>DMPlexCellRefinerRefine</H1></A>
Return a description of the refinement for a given cell type
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscdmplex.h"
<A HREF="../Sys/PetscErrorCode.html#PetscErrorCode">PetscErrorCode</A> <A HREF="../DMPLEX/DMPlexCellRefinerRefine.html#DMPlexCellRefinerRefine">DMPlexCellRefinerRefine</A>(DMPlexCellRefiner cr, <A HREF="../DM/DMPolytopeType.html#DMPolytopeType">DMPolytopeType</A> source, <A HREF="../Sys/PetscInt.html#PetscInt">PetscInt</A> *Nt, <A HREF="../DM/DMPolytopeType.html#DMPolytopeType">DMPolytopeType</A> *target[], <A HREF="../Sys/PetscInt.html#PetscInt">PetscInt</A> *size[], <A HREF="../Sys/PetscInt.html#PetscInt">PetscInt</A> *cone[], <A HREF="../Sys/PetscInt.html#PetscInt">PetscInt</A> *ornt[])
</PRE>
<H3><FONT COLOR="#CC3333">Input Parameter</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>source </B></TD><TD>- The cell type for a source point
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#CC3333">Output Parameter</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>Nt </B></TD><TD>- The number of cell types generated by refinement
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>target </B></TD><TD>- The cell types generated
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>size </B></TD><TD>- The number of subcells of each type, ordered by dimension
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>cone </B></TD><TD>- A list of the faces for each subcell of the same type as source
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>ornt </B></TD><TD>- A list of the face orientations for each subcell of the same type as source
</TD></TR></TABLE>
<P>
Note: 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
<pre>
the number of cones to be taken, or 0 for the current cell
</pre>
<pre>
the cell cone point number at each level from which it is subdivided
</pre>
<pre>
the replica number r of the subdivision.
</pre>
The orientation is with respect to the canonical cone orientation. For example, the prescription for edge division is
<pre>
Nt = 2
</pre>
<pre>
target = {<A HREF="../DM/DMPolytopeType.html#DMPolytopeType">DM_POLYTOPE_POINT</A>, <A HREF="../DM/DMPolytopeType.html#DMPolytopeType">DM_POLYTOPE_SEGMENT</A>}
</pre>
<pre>
size = {1, 2}
</pre>
<pre>
cone = {<A HREF="../DM/DMPolytopeType.html#DMPolytopeType">DM_POLYTOPE_POINT</A>, 1, 0, 0, <A HREF="../DM/DMPolytopeType.html#DMPolytopeType">DM_POLYTOPE_POINT</A>, 0, 0, <A HREF="../DM/DMPolytopeType.html#DMPolytopeType">DM_POLYTOPE_POINT</A>, 0, 0, <A HREF="../DM/DMPolytopeType.html#DMPolytopeType">DM_POLYTOPE_POINT</A>, 1, 1, 0}
</pre>
<pre>
ornt = { 0, 0, 0, 0}
</pre>
<P>
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
DMPlexCellRefinerCreate(), DMPlexRefineUniform()
<BR><P><B></B><H3><FONT COLOR="#CC3333">Level</FONT></H3>developer<BR>
<H3><FONT COLOR="#CC3333">Location</FONT></H3>
</B><A HREF="../../../src/dm/impls/plex/plexrefine.c.html#DMPlexCellRefinerRefine">src/dm/impls/plex/plexrefine.c</A>
<P><H3><FONT COLOR="CC3333">Implementations</FONT></H3><A HREF="../../../src/dm/impls/plex/plexrefine.c.html#DMPlexCellRefinerRefine_None">DMPlexCellRefinerRefine_None in src/dm/impls/plex/plexrefine.c</A><BR>
<A HREF="../../../src/dm/impls/plex/plexrefine.c.html#DMPlexCellRefinerRefine_Regular">DMPlexCellRefinerRefine_Regular in src/dm/impls/plex/plexrefine.c</A><BR>
<A HREF="../../../src/dm/impls/plex/plexrefine.c.html#DMPlexCellRefinerRefine_ToBox">DMPlexCellRefinerRefine_ToBox in src/dm/impls/plex/plexrefine.c</A><BR>
<A HREF="../../../src/dm/impls/plex/plexrefine.c.html#DMPlexCellRefinerRefine_ToSimplex">DMPlexCellRefinerRefine_ToSimplex in src/dm/impls/plex/plexrefine.c</A><BR>
<A HREF="../../../src/dm/impls/plex/plexrefine.c.html#DMPlexCellRefinerRefine_Alfeld2D">DMPlexCellRefinerRefine_Alfeld2D in src/dm/impls/plex/plexrefine.c</A><BR>
<A HREF="../../../src/dm/impls/plex/plexrefine.c.html#DMPlexCellRefinerRefine_Alfeld3D">DMPlexCellRefinerRefine_Alfeld3D in src/dm/impls/plex/plexrefine.c</A><BR>
<A HREF="../../../src/dm/impls/plex/plexrefine.c.html#DMPlexCellRefinerRefine_BL">DMPlexCellRefinerRefine_BL in src/dm/impls/plex/plexrefine.c</A><BR>
<BR><A HREF="./index.html">Index of all DMPLEX 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>
</BODY></HTML>
|
