Salome HOME
Merge from BR_V5_DEV 16Feb09
[modules/smesh.git] / doc / salome / gui / SMESH / input / smoothing.doc
1 /*!
2
3 \page smoothing_page Smoothing
4
5 \n Smoothing is used to adjust the locations of element corners
6 (nodes) to reduce distortions in these elements.
7
8 <em>To apply smoothing to the elements of your mesh:</em>
9 <ol>
10 <li>Display a mesh or a submesh in the 3D viewer.</li>
11 <li>In the \b Modification menu select the \b Smoothing item or click
12 <em>"Smoothing"</em> button in the toolbar.
13
14 \image html image84.png
15 <center><em>"Smoothing" button</em></center>
16
17 The dialog box contains the following fields which should be
18 specified:
19
20 \image html smoothing.png
21
22 <ul>
23 <li><b>Id Elements</b> field allows to specify the elements which
24 should be smoothed
25 <ul>
26 <li>Check on <b>Select the whole mesh, submesh or group</b> option
27 <li>Choosing them manually with the mouse in the 3D Viewer. You can
28 click on an element in the 3D viewer and it will be highlighted</li>
29 <li>Applying Filters. The <b>Set filter</b> button allows to apply a
30 definite filter to selection of the elements. See more
31 about filters on the
32 \ref selection_filter_library_page "Selection filter library" page.</li>
33 </ul>
34 </li>
35 <b>Fixed nodes ids:</b> some nodes keep their location during
36 smoothing. If a mesh is built on a geometry shape, the nodes built on
37 geometrical edges are always fixed. If smoothing is applied to a part
38 of a mesh then the boundary nodes of an elements set are also
39 fixed. Any other nodes may be additionally fixed. Fixed nodes can be
40 selected manually or by filters too.</li>
41 <li><b>Smoothing Method:</b>
42 <ul>
43 <li>\b Laplacian smoothing pulls a node toward the center of
44 surrounding nodes directly connected to that node along an element
45 edge. 
46 <li>\b Centroidal smoothing pulls a node toward the
47 element-area-weighted centroid of the surrounding elements. </li>
48
49 Typically, the  Laplacian method will produce the mesh with the least element
50 distortion. It is also the faster method.Centroidal smoothing usually
51 produces  a mesh that has more uniform element sizes. Both methods
52 produce good results with "free" meshes.</li>
53 </ul>
54
55 \image html image83.gif
56
57 </li>
58 <li><b>Iteration limit:</b> both of the smoothing methods use an
59 iterative procedure to converge toward a smoothed mesh. All nodes are
60 smoothed according to one of the techniques shown above. Then the
61 smoothing is reevaluated with the updated nodal locations. This
62 process continues until the maximum number of iterations has been
63 exceeded, or all elements has aspect ratio less or equal than the
64 specified one.</li>
65 <li><b>Max. aspect ratio</b> allows to define the quality at which the
66 smoothing algorithm should stop the iterations as the target of the
67 operation has been reached.</li>
68 <li>When <b>in parametric space</b> radio button is checked, the
69 algorithm tries to improve the shape of faces in the parametric space
70 of geometrical surfaces on which they are generated, else the shape of
71 faces in the 3D space is improved. </li>   
72 </ul>
73
74 </li>
75 <li>Click the \b Apply or \b OK button to confirm the operation.</li>
76 </ol>
77
78 \image html smoothing1.png "The initial mesh"
79
80 \image html smoothing2.png "The smoothed mesh"
81
82 <br><b>See Also</b> a sample TUI Script of a 
83 \ref tui_smoothing "Smoothing" operation.  
84
85 */