Salome HOME
30838a3325e534937ad66472d58baad0da8d3aa8
[modules/smesh.git] / doc / salome / gui / SMESH / input / 1d_meshing_hypo.doc
1 /*!
2
3 \page a1d_meshing_hypo_page 1D Meshing Hypotheses
4
5 <br>
6 <ul>
7 <li>\ref arithmetic_1d_anchor "Arithmetic 1D"</li>
8 <li>\ref average_length_anchor "Average Length"</li>
9 <li>\ref deflection_1d_anchor "Deflection 1D"</li>
10 <li>\ref number_of_segments_anchor "Number of segments"</li>
11 <li>\ref start_and_end_length_anchor "Start and end length"</li>
12 <li>\ref automatic_length_anchor "Automatic Length"</li>
13 </ul>
14
15 <br>
16 \anchor arithmetic_1d_anchor
17 <h2>Arithmetic 1D hypothesis</h2>
18
19 <b>Arithmetic 1D</b> hypothesis allows to split edges into segments with a
20 length that changes in arithmetic progression (Lk = Lk-1 + d)
21 beginning from a given starting length and up to a given end length.
22
23 \image html a-arithmetic1d.png
24
25 \image html b-ithmetic1d.png "Arithmetic 1D hypothesis - the size of mesh elements gradually increases"
26
27 <b>See Also</b> a sample TUI Script of a 
28 \ref tui_1d_arithmetic "Defining Arithmetic 1D hypothesis" operation.  
29
30 <br>
31 \anchor deflection_1d_anchor
32 <h2>Deflection 1D hypothesis</h2>
33
34 <b>Deflection 1D</b> hypothesis can be applied for meshing curvilinear edges
35 composing your geometrical object. It uses only one parameter: the
36 value of deflection.  
37 \n A geometrical edge is divided into equal segments. The maximum
38 distance between a point on the edge within a segment and the line
39 connecting the ends of the segment should not exceed the specified
40 value of deflection . Then mesh nodes are constructed at end segment
41 locations and 1D mesh elements are constructed on segments.
42
43 \image html a-deflection1d.png
44
45 \image html b-flection1d.png "Deflection 1D hypothesis - useful for meshing curvilinear edges"
46
47 <b>See Also</b> a sample TUI Script of a 
48 \ref tui_deflection_1d "Defining Deflection 1D hypothesis" operation.
49
50 <br>
51 \anchor average_length_anchor
52 <h2>Average Length hypothesis</h2>
53
54 <b>Average Length</b> hypothesis can be applied for meshing of edges
55 composing your geometrical object. Definition of this hypothesis
56 consists of setting the \b length of segments, which will split these
57 edges, and the \b precision of rounding. The points on the edges
58 generated by these segments will represent nodes of your mesh.
59 Later these nodes will be used for meshing of the faces abutting to
60 these edges.
61
62 The \b precision parameter is used to allow rounding a number of
63 segments, calculated from the edge length and average length of
64 segment, to the lower integer, if this value outstands from it in
65 bounds of the precision. Otherwise, the number of segments is rounded
66 to the higher integer. Use value 0.5 to provide rounding to the
67 nearest integer, 1.0 for the lower integer, 0.0 for the higher
68 integer. Default value is 1e-07.
69
70 \image html image41.gif
71
72 \image html a-averagelength.png
73
74 \image html b-erage_length.png "Average length hypothesis - all 1D mesh elements are roughly equal"
75
76 <b>See Also</b> a sample TUI Script of a 
77 \ref tui_average_length "Defining Average Length" hypothesis
78 operation.
79
80 <br>
81 \anchor number_of_segments_anchor
82 <h2>Number of segments hypothesis</h2>
83
84 <b>Number of segments</b> hypothesis can be applied for meshing of edges
85 composing your geometrical object. Definition of this hypothesis
86 consists of setting the number of segments, which will split these
87 edges. In other words your edges will be split into a definite number
88 of segments with approximately the same length. The points on the
89 edges generated by these segments will represent nodes of your
90 mesh. Later these nodes will be used for meshing of the faces abutting
91 to these edges.
92
93 \image html image46.gif
94
95 You can set the type of distribution for this hypothesis in the
96 <b>Hypothesis Construction</b> dialog bog :
97
98 \image html a-nbsegments1.png
99
100 <br><b>Equidistant Distribution</b> - all segments will have the same
101 length, you define only the <b>Number of Segments</b>.
102
103 <br><b>Scale Distribution</b> - length of segments gradually changes depending on the <b>Scale Factor</b>, which is a ratio of the first segment length to the last segment length.
104
105 \image html a-nbsegments2.png
106
107 <br><b>Distribution with Table Density</b> - you input a number of
108 pairs <b>t - F(t)</b>, where \b t ranges from 0 to 1,  and the module computes the
109 formula, which will rule the change of length of segments and shows
110 the curve in the plot. You can select the <b>Conversion mode</b> from
111 \b Exponent and <b>Cut negative</b>.
112
113 \image html distributionwithtabledensity.png
114
115 <br><b>Distribution with Analytic Density</b> - you input the formula,
116 which will rule the change of length of segments and the module shows
117 the curve in the plot.
118
119 \image html distributionwithanalyticdensity.png
120
121 <b>See Also</b> a sample TUI Script of a 
122 \ref tui_deflection_1d "Defining Number of Segments" hypothesis
123 operation.
124
125 <br>
126 \anchor start_and_end_length_anchor
127 <h2>Start and End Length hypothesis</h2>
128
129 <b>Start and End Length</b> hypothesis allows to divide a geometrical edge
130 into segments so that the first and the last segments have a specified
131 length. The length medium segments changes with automatically chosen
132 geometric progression. Then mesh nodes are
133 constructed at segment ends location and 1D mesh elements are
134 constructed on them.
135
136 \image html a-startendlength.png
137
138 \image html b-art_end_length.png "The lengths of the first and the last segment are strictly defined"
139
140 <b>See Also</b> a sample TUI Script of a 
141 \ref tui_start_and_end_length "Defining Start and End Length"
142 hypothesis operation.
143
144 <br>
145 \anchor automatic_length_anchor
146 <h2>Automatic Length</h2>
147
148 This hypothesis is automatically applied when you select <b>Assign a
149 set of hypotheses</b> option in Create Mesh menu.
150
151 \image html automaticlength.png
152
153 The dialog box prompts you to define the quality of the future mesh by
154 only one parameter, which is \b Fineness, ranging from 0 (coarse mesh,
155 low number of elements) to 1 (extremely fine mesh, great number of
156 elements). Compare one and the same object (sphere) meshed with
157 minimum and maximum value of this parameter.
158
159 \image html image147.gif "Example of a very rough mesh. Automatic Length works for 0."
160
161 \image html image148.gif "Example of a very fine mesh. Automatic Length works for 1."
162 */