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