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 adaptive_1d_anchor "Adaptive"</li>
   8 <li>\ref arithmetic_1d_anchor "Arithmetic 1D"</li>
   9 <li>\ref geometric_1d_anchor "Geometric Progression"</li>
  10 <li>\ref average_length_anchor "Local Length"</li>
  11 <li>\ref max_length_anchor "Max Size"</li>
  12 <li>\ref deflection_1d_anchor "Deflection 1D"</li>
  13 <li>\ref number_of_segments_anchor "Number of segments"</li>
  14 <li>\ref start_and_end_length_anchor "Start and end length"</li>
  15 <li>\ref automatic_length_anchor "Automatic Length"</li>
  16 <li>\ref fixed_points_1d_anchor "Fixed points 1D"</li>
  17 </ul>
  18
  19 <br>
  20 \anchor adaptive_1d_anchor
  21 <h2>Adaptive hypothesis</h2>
  22
  23 <b>Adaptive</b> hypothesis allows to split edges into segments with a
  24 length that depends on the curvature of edges and faces and is limited by <b>Min. Size</b>
  25 and <b>Max Size</b>. The length of a segment also depends on the lengths
  26 of adjacent segments (that can't differ more than twice) and on the
  27 distance to close geometrical entities (edges and faces) to avoid
  28 creation of narrow 2D elements.
  29
  30 \image html adaptive1d.png
  31
  32 - <b>Min size</b> parameter limits the minimal segment size.
  33 - <b>Max size</b> parameter defines the length of segments on straight edges.
  34 - \b Deflection parameter gives maximal distance of a segment from a curved edge.
  35
  36 \image html adaptive1d_sample_mesh.png "Adaptive hypothesis and Netgen 2D algorithm - the size of mesh segments reflects the size of geometrical features"
  37
  38 <b>See Also</b> a \ref tui_1d_adaptive "sample TUI Script" that uses Adaptive hypothesis.
  39
  40 <br>
  41 \anchor arithmetic_1d_anchor
  42 <h2>Arithmetic 1D hypothesis</h2>
  43
  44 <b>Arithmetic 1D</b> hypothesis allows to split edges into segments with a
  45 length that changes in arithmetic progression (Lk = Lk-1 + d)
  46 beginning from a given starting length and up to a given end length.
  47
  48 The direction of the splitting is defined by the orientation of the underlying geometrical edge.
  49 <b>"Reverse Edges"</b> list box allows to specify the edges for which the splitting should be made
  50 in the direction opposing to their orientation. This list box is enabled only if the geometry object
  51 is selected for the meshing. In this case the user can select edges to be reversed either by directly
  52 picking them in the 3D viewer or by selecting the edges or groups of edges in the Object Browser.
  53
  54 \image html a-arithmetic1d.png
  55
  56 \image html b-ithmetic1d.png "Arithmetic 1D hypothesis - the size of mesh elements gradually increases"
  57
  58 <b>See Also</b> a sample TUI Script of a
  59 \ref tui_1d_arithmetic "Defining Arithmetic 1D and Geometric Progression hypothesis" operation.
  60
  61 <br>
  62 \anchor geometric_1d_anchor
  63 <h2>Geometric Progression hypothesis</h2>
  64
  65 <b>Geometric Progression</b> hypothesis allows splitting edges into
  66 segments with a length that changes in geometric progression (Lk =
  67 Lk-1 * d) starting from a given <b>Start Length</b> and  <b>Common Ratio</b>.
  68
  69 The splitting direction is defined by the orientation of the
  70 underlying geometrical edge.
  71 <b>Reverse Edges</b> list box allows specifying the edges, for which
  72 the splitting should be made in the direction opposite to their
  73 orientation. This list box is usable only if a geometry object is
  74 selected for meshing. In this case it is possible to select edges to
  75 be reversed either directly picking them in the 3D viewer or by
  76 selecting the edges or groups of edges in the Object Browser.
  77
  78 \image html a-geometric1d.png
  79
  80 <b>See Also</b> a sample TUI Script of a
  81 \ref tui_1d_arithmetic "Defining Arithmetic 1D and Geometric Progression hypothesis" operation.
  82
  83 <br>
  84 \anchor deflection_1d_anchor
  85 <h2>Deflection 1D hypothesis</h2>
  86
  87 <b>Deflection 1D</b> hypothesis can be applied for meshing curvilinear edges
  88 composing your geometrical object. It uses only one parameter: the
  89 value of deflection.
  90 \n A geometrical edge is divided into equal segments. The maximum
  91 distance between a point on the edge within a segment and the line
  92 connecting the ends of the segment should not exceed the specified
  93 value of deflection . Then mesh nodes are constructed at end segment
  94 locations and 1D mesh elements are constructed on segments.
  95
  96 \image html a-deflection1d.png
  97
  98 \image html b-flection1d.png "Deflection 1D hypothesis - useful for meshing curvilinear edges"
  99
 100 <b>See Also</b> a sample TUI Script of a
 101 \ref tui_deflection_1d "Defining Deflection 1D hypothesis" operation.
 102
 103 <br>
 104 \anchor average_length_anchor
 105 <h2>Local Length hypothesis</h2>
 106
 107 <b>Local Length</b> hypothesis can be applied for meshing of edges
 108 composing your geometrical object. Definition of this hypothesis
 109 consists of setting the \b length of segments, which will split these
 110 edges, and the \b precision of rounding. The points on the edges
 111 generated by these segments will represent nodes of your mesh.
 112 Later these nodes will be used for meshing of the faces abutting to
 113 these edges.
 114
 115 The \b precision parameter is used to allow rounding a number of
 116 segments, calculated from the edge length and average length of
 117 segment, to the lower integer, if this value outstands from it in
 118 bounds of the precision. Otherwise, the number of segments is rounded
 119 to the higher integer. Use value 0.5 to provide rounding to the
 120 nearest integer, 1.0 for the lower integer, 0.0 for the higher
 121 integer. Default value is 1e-07.
 122
 123 \image html image41.gif
 124
 125 \image html a-averagelength.png
 126
 127 \image html b-erage_length.png "Local Length hypothesis - all 1D mesh elements are roughly equal"
 128
 129 <b>See Also</b> a sample TUI Script of a
 130 \ref tui_average_length "Defining Local Length" hypothesis
 131 operation.
 132
 133 <br>\anchor max_length_anchor
 134 <h2>Max Size</h2>
 135 <b>Max Size</b> hypothesis allows splitting geometrical edges into
 136 segments not longer than the given length. Definition of this hypothesis
 137 consists of setting the maximal allowed \b length of segments.
 138 <b>Use preestimated length</b> check box lets you specify \b length
 139 automatically calculated basing on size of your geometrical object,
 140 namely as diagonal of bounding box divided by ten. The divider can be
 141 changed via "Ratio Bounding Box Diagonal / Max Size"
 142 preference parameter.
 143 <b>Use preestimated length</b> check box is enabled only if the
 144 geometrical object has been selected before hypothesis definition.
 145
 146 \image html a-maxsize1d.png
 147
 148 <br>
 149 \anchor number_of_segments_anchor
 150 <h2>Number of segments hypothesis</h2>
 151
 152 <b>Number of segments</b> hypothesis can be applied for meshing of edges
 153 composing your geometrical object. Definition of this hypothesis
 154 consists of setting the number of segments, which will split these
 155 edges. In other words your edges will be split into a definite number
 156 of segments with approximately the same length. The points on the
 157 edges generated by these segments will represent nodes of your
 158 mesh. Later these nodes will be used for meshing of the faces abutting
 159 to these edges.
 160
 161 The direction of the splitting is defined by the orientation of the underlying geometrical edge.
 162 <b>"Reverse Edges"</b> list box allows to specify the edges for which the splitting should be made
 163 in the direction opposing to their orientation. This list box is enabled only if the geometry object
 164 is selected for the meshing. In this case the user can select edges to be reversed either directly
 165 picking them in the 3D viewer or by selecting the edges or groups of edges in the Object Browser.
 166
 167 \image html image46.gif
 168
 169 You can set the type of distribution for this hypothesis in the
 170 <b>Hypothesis Construction</b> dialog bog :
 171
 172 \image html a-nbsegments1.png
 173
 174 <br><b>Equidistant Distribution</b> - all segments will have the same
 175 length, you define only the <b>Number of Segments</b>.
 176
 177 <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.
 178
 179 \image html a-nbsegments2.png
 180
 181 <br><b>Distribution with Table Density</b> - you input a number of
 182 pairs <b>t - F(t)</b>, where \b t ranges from 0 to 1,  and the module computes the
 183 formula, which will rule the change of length of segments and shows
 184 the curve in the plot. You can select the <b>Conversion mode</b> from
 185 \b Exponent and <b>Cut negative</b>.
 186
 187 \image html distributionwithtabledensity.png
 188
 189 <br><b>Distribution with Analytic Density</b> - you input the formula,
 190 which will rule the change of length of segments and the module shows
 191 the curve in the plot.
 192
 193 \image html distributionwithanalyticdensity.png
 194
 195 <b>See Also</b> a sample TUI Script of a
 196 \ref tui_deflection_1d "Defining Number of Segments" hypothesis
 197 operation.
 198
 199 <br>
 200 \anchor start_and_end_length_anchor
 201 <h2>Start and End Length hypothesis</h2>
 202
 203 <b>Start and End Length</b> hypothesis allows to divide a geometrical edge
 204 into segments so that the first and the last segments have a specified
 205 length. The length of medium segments changes with automatically chosen
 206 geometric progression. Then mesh nodes are
 207 constructed at segment ends location and 1D mesh elements are
 208 constructed on them.
 209
 210 The direction of the splitting is defined by the orientation of the underlying geometrical edge.
 211 <b>"Reverse Edges"</b> list box allows to specify the edges for which the splitting should be made
 212 in the direction opposing to their orientation. This list box is enabled only if the geometry object
 213 is selected for the meshing. In this case the user can select edges to be reversed either directly
 214 picking them in the 3D viewer or by selecting the edges or groups of edges in the Object Browser.
 215
 216 \image html a-startendlength.png
 217
 218 \image html b-art_end_length.png "The lengths of the first and the last segment are strictly defined"
 219
 220 <b>See Also</b> a sample TUI Script of a
 221 \ref tui_start_and_end_length "Defining Start and End Length"
 222 hypothesis operation.
 223
 224 <br>
 225 \anchor automatic_length_anchor
 226 <h2>Automatic Length</h2>
 227
 228 This hypothesis is automatically applied when you select <b>Assign a
 229 set of hypotheses</b> option in Create Mesh menu.
 230
 231 \image html automaticlength.png
 232
 233 The dialog box prompts you to define the quality of the future mesh by
 234 only one parameter, which is \b Fineness, ranging from 0 (coarse mesh,
 235 low number of elements) to 1 (extremely fine mesh, great number of
 236 elements). Compare one and the same object (sphere) meshed with
 237 minimum and maximum value of this parameter.
 238
 239 \image html image147.gif "Example of a very rough mesh. Automatic Length works for 0."
 240
 241 \image html image148.gif "Example of a very fine mesh. Automatic Length works for 1."
 242
 243 <br>
 244 \anchor fixed_points_1d_anchor
 245 <h2>Fixed points 1D hypothesis</h2>
 246
 247 <b>Fixed points 1D</b> hypothesis allows splitting edges through a
 248 set of points parameterized on the edge (from 1 to 0) and a number of segments for each
 249 interval limited by the points.
 250
 251 \image html hypo_fixedpnt_dlg.png
 252
 253 It is possible to check in <b>Same Nb. Segments for all intervals</b>
 254 option and to define one value for all intervals.
 255
 256 The splitting direction is defined by the orientation of the
 257 underlying geometrical edge. <b>"Reverse Edges"</b> list box allows to
 258 specify the edges for which the splitting should be made in the
 259 direction opposite to their orientation. This list box is enabled only
 260 if the geometrical object is selected for meshing. In this case it is
 261 possible to select the edges to be reversed either directly picking them in
 262 the 3D viewer or selecting the edges or groups of edges in the
 263 Object Browser.
 264
 265 \image html mesh_fixedpnt.png "Example of a submesh on the edge built using Fixed points 1D hypothesis"
 266
 267 <b>See Also</b> a sample TUI Script of a
 268 \ref tui_fixed_points "Defining Fixed Points" hypothesis operation.
 269
 270 */