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