Salome HOME
Merge from V7_3_BR branch 18/12/2013
[modules/smesh.git] / doc / salome / gui / SMESH / input / 2d_meshing_hypo.doc
1 /*!
2
3 \page a2d_meshing_hypo_page 2D Meshing Hypotheses
4
5 - \ref max_element_area_anchor "Max Element Area"
6 - \ref length_from_edges_anchor "Length from Edges"
7 - \ref hypo_quad_params_anchor "Quadrangle parameters"
8
9 \anchor max_element_area_anchor
10 <h2>Max Element Area</h2>
11
12 <b>Max Element Area</b> hypothesis is applied for meshing of faces
13 composing your geometrical object. Definition of this hypothesis
14 consists of setting the <b>maximum area</b> of mesh elements,
15 which will compose the mesh of these faces.
16
17 \image html a-maxelarea.png
18
19 \n
20
21 \image html max_el_area.png "In this example, Max. element area is very small compared to the 1D hypothesis"
22
23 <b>See Also</b> a sample TUI Script of a 
24 \ref tui_max_element_area "Maximum Element Area" hypothesis operation. 
25
26 \anchor length_from_edges_anchor
27 <h2>Length from Edges</h2>
28
29 <b>Length from edges</b> hypothesis builds 2D mesh elements having a
30 maximum linear size calculated as an average segment length for a wire
31 of a given face.
32
33 <b>See Also</b> a sample TUI Script of a 
34 \ref tui_length_from_edges "Length from Edges" hypothesis operation.
35
36 \anchor hypo_quad_params_anchor
37 <h2>Quadrangle parameters</h2>
38
39 \image html hypo_quad_params_dialog.png "Quadrangle parameters creation/edition dialog"
40
41 <b>Quadrangle parameters</b> is a hypothesis for Quadrangle (Mapping).
42
43 <b>Base vertex</b> parameter allows using Quadrangle (Mapping)
44 algorithm for meshing of trilateral faces. In this case it is
45 necessary to select the vertex, which will be used as the fourth edge
46 (degenerated).
47
48 \image html hypo_quad_params_1.png "A face built from 3 edges"
49
50 \image html hypo_quad_params_res.png "The resulting mesh"
51
52 This parameter can be also used to mesh a segment of a circular face.
53 Please, consider that there is a limitation on the selection of the
54 vertex for the faces built with the angle > 180 degrees (see the picture).
55
56 \image html hypo_quad_params_2.png "3/4 of a circular face"
57
58 In this case, selection of a wrong vertex for the <b>Base vertex</b>
59 parameter will generate a wrong mesh. The picture below
60 shows the good (left) and the bad (right) results of meshing.
61
62 \image html hypo_quad_params_res_2.png "The resulting meshes"
63
64 <b>Type</b> parameter is used on faces with a different number of
65 segments on opposite sides to define the algorithm of transition
66 between them. The following types are available:
67
68 - <b>Standard</b> is the default case, when both triangles and quadrangles
69   are possible in the transition area along the finer meshed sides.
70 - <b>Triangle preference</b> forces building only triangles in the
71   transition area along the finer meshed sides.
72   \note This type corresponds to <b>Triangle Preference</b> additional hypothesis,
73   which is obsolete now.
74 - <b>Quadrangle preference</b> forces building only quadrangles in the
75   transition area along the finer meshed sides. This hypothesis has a
76   restriction: the total quantity of segments on all
77   four sides of the face must be even (divisible by 2).
78   \note This type corresponds to <b>Quadrangle Preference</b> additional hypothesis,
79   which is obsolete now.
80 - <b>Quadrangle preference (reversed)</b> works in the same way and
81   with the same restriction as <b>Quadrangle preference</b>, but
82   the transition area is located along the coarser meshed sides.
83 - <b>Reduced</b> type forces building only quadrangles and the transition
84   between the sides is made gradually, layer by layer. This type has
85   a limitation on the number of segments: one pair of opposite sides must have
86   the same number of segments, the other pair must have an even difference
87   between the numbers of segments on the sides. In addition, the number
88   of rows between sides with different discretization
89   should be enough for the transition. Following the fastest transition
90   pattern, three segments become one (see the image below), hence
91   the least number of face rows needed to reduce from Nmax segments
92   to Nmin segments is log<sub>3</sub>( Nmax / Nmin ). The number of
93   face rows is equal to the number of segments on each of equally
94   discretized sides.
95   \image html reduce_three_to_one.png "The fastest transition pattern: 3 to 1"
96
97 <b>See Also</b> a sample TUI Script of a 
98 \ref tui_quadrangle_parameters "Quadrangle Parameters" hypothesis.
99
100 <br>
101 */