Salome HOME
9b732a0454da96e47fa41964aefe74c7269f9e10
[modules/smesh.git] / doc / salome / gui / SMESH / input / additional_hypo.doc
1 /*!
2
3 \page additional_hypo_page Additional Hypotheses
4
5 \n <b>Additional Hypotheses</b> can be applied as a supplement to the
6 main hypotheses, introducing additional concepts to mesh creation.
7
8 To define an <b>Additional Hypothesis</b> simply select it in
9 <b>Create Mesh</b> menu. These hypotheses are actually changes in the
10 rules of mesh creation and as such don't possess adjustable values.
11
12 \anchor non_conform_allowed_anchor
13 <h2>Non Conform mesh allowed hypothesis</h2>
14
15 <b>Non Conform mesh allowed</b> hypothesis allows to generate non-conform
16 meshes (that is, meshes having some edges ending on an edge or face of
17 adjacent elements).
18
19 \anchor quadratic_mesh_anchor
20 <h2>Quadratic Mesh</h2>
21
22 Quadratic Mesh hypothesis allows to build a quadratic mesh (whose
23 edges are not straight but curved lines and can be defined by three
24 points: first, middle and last instead of an ordinary two).
25
26 See \ref adding_quadratic_elements_page
27 for more information about quadratic meshes.
28
29 \anchor propagation_anchor
30 <h2>Propagation of 1D Hypothesis on opposite edges</h2>
31
32 <b>Propagation of 1D Hypothesis on opposite edges</b> allows to propagate a
33 hypothesis onto an opposite edge. If a local hypothesis and
34 propagation are defined on an edge of a quadrangular face, the
35 opposite edge will have the same hypothesis, unless another hypothesis
36 has been locally defined on the opposite edge.
37  
38 <br><b>See Also</b> a sample TUI Script of a 
39 \ref tui_propagation "Propagation hypothesis" operation
40
41 \anchor propagofdistribution_anchor
42 <h2>Propagation of Node Distribution on Opposite Edges</h2>
43
44 <b>Propagation of Node Distribution on Opposite Edges</b> allows to propagate
45 distribution of nodes onto an opposite edge. If a local hypothesis and
46 propagation are defined on an edge of a quadrangular face, the
47 opposite edge will have the same number of nodes and the same
48 relations between segment lengths, unless another hypothesis
49 has been locally defined on the opposite edge.
50  
51 <br><b>See Also</b> a sample TUI Script of a 
52 \ref tui_propagation "Propagation hypothesis" operation
53
54 \anchor quadrangle_preference_anchor
55 <h2>Quadrangle Preference</h2>
56
57 This additional hypothesis can be used together with 2D triangulation algorithms.
58 It allows 2D triangulation algorithms to build quadrangular meshes.
59
60 When used with "Quadrangle (Mapping)" meshing algorithm, that is obsolete
61  since introducing \ref hypo_quad_params_anchor "Quadrangle parameters" 
62 hypothesis, this hypothesis has one restriction on its work: the total quantity of 
63 segments on all four sides of the face must be even (divisible by 2).
64
65 \anchor viscous_layers_anchor
66 <h2>Viscous Layers and Viscous Layers 2D</h2>
67
68 <b>Viscous Layers</b> and <b>Viscous Layers 2D </b> additional
69 hypotheses can be used together with either some 3D algorithms, for example
70 Hexahedron(i,j,k), or 2D algorithms, for example Triangle
71 (MEFISTO), correspondingly. These hypotheses allow creation of layers
72 of highly stretched elements, prisms in 3D and quadrilaterals in 2D,
73 near mesh boundary, which is beneficial for high quality viscous
74 computations.
75
76 \image html viscous_layers_hyp.png
77
78 \image html viscous_layers_2d_hyp.png
79
80 <ul>
81 <li><b>Name</b> - allows to define the name of the hypothesis.</li>
82 <li><b>Total thickness</b> - gives the total thickness of element layers.</li>
83 <li><b>Number of layers</b> - defines the number of element layers.</li>
84 <li><b>Stretch factor</b> - defines the growth factor of element height
85   from the mesh boundary inwards.</li>
86 <li><b>Extrusion method</b> (available in 3D only) - defines how
87   position of nodes are found during prism construction and how
88   creation of distorted and intersecting prisms is prevented.
89 <ul><li><b>Surface offset + smooth</b> method extrudes nodes along normal
90     to underlying geometrical surface. Smoothing of internal surface of
91     element layers is possible to avoid creation of invalid prisms.</li>
92   <li><b>Face offset</b> method extrudes nodes along average normal of
93     surrounding mesh faces till intersection with a neighbor mesh face
94     translated along its own normal by the layers thickness. Thickness
95     of layers can be limited to avoid creation of invalid prisms.</li>
96   <li><b>Node offset</b> method extrudes nodes along average normal of
97     surrounding mesh faces by the layers thickness. Thickness of
98     layers can be limited to avoid creation of invalid prisms.</li> 
99 \image html viscous_layers_extrusion_method.png "Prisms created by the tree extrusion methods at the same other parameters"
100 </ul></li>
101 <li><b>Specified Faces/Edges are</b> - defines how the shapes specified by
102   the next parameter are used.
103 <li><b> Faces/Edges with/without layers</b> - 
104   defines geometrical faces or edges on which element layers
105   either should be or should not be constructed, depending on the
106   value of the previous parameter (<b>Specified Faces/Edges are</b>). 
107   Faces (or edges) can be selected either in the Object Browser or in
108   the VTK Viewer.
109   \note A mesh shown in the 3D Viewer can prevent selection of faces
110   and edges, just hide the mesh to avoid this. Sometimes a face to
111   select is hidden by other faces, in this case consider creating a
112   group of faces you want to select in the Geometry module.<br>
113   To avoid a long wait when a
114   geometry with many faces (or edges) is displayed, the number of faces
115   (edges) shown at a time is limited by the value of "Sub-shapes
116   preview chunk size" preference (in Preferences/Mesh/General tab).
117
118
119   If faces/edges without layers are specified, the element layers are
120   not constructed on geometrical faces shared by several solids in 3D
121   case and edges shared by several faces in 2D case. In other words,
122   in this mode the element layers can be constructed on boundary faces
123   and edges only, and are not constructed on internal faces and
124   edges. There is an exception to this rule: if a hypothesis is
125   assigned to a sub-mesh, the element layers can be constructed on
126   boundary faces/edges of the shape of this sub-mesh, at same time
127   possibly being internal faces/edges within the whole model.
128   \image html viscous_layers_on_submesh.png 2D viscous layers constructed on boundary edges of a sub-mesh on a disk face.
129
130   If you use \b several hypotheses to define viscous layers on faces of
131   one solid, keep in mind the following. Each hypothesis defines a set
132   of faces with viscous layers (even if you specify faces without
133   layers). The sets of faces with viscous layers defined by several
134   hypotheses should not intersect, else the module won't add an
135   hypothesis that is incompatible with another one. <br>
136   Also you can't define different number of layers on adjacent faces
137   of a solid.<br>
138   This logic is also valid for the 2D hypothesis.
139 </li>
140 </ul>
141
142 \image html viscous_layers_mesh.png A group containing viscous layer prisms.
143
144 <br><b>See also</b> a sample TUI script of a \ref tui_viscous_layers
145 "Viscous layers construction".
146
147 */