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