Salome HOME
22874: [CEA 1425] Performance SMESH Module
[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
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 following dialog will appear:
18
19 \image html smoothing.png
20 </li>
21 <li>In this dialog:
22
23 <ul>
24 <li>specify the IDs of the elements which will be smoothed:
25 <ul>
26 <li><b>Select the whole mesh, submesh or group</b> activating this
27 checkbox; or</li>
28 <li>choose mesh elements with the mouse in the 3D Viewer. It is
29 possible to select a whole area with a mouse frame; or</li> 
30 <li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
31 viewer; or</li>
32 <li>apply Filters. <b>Set filter</b> button allows to apply a filter to the selection of elements. See more
33 about filters in the \ref selection_filter_library_page "Selection filter library" page.</li>
34 </ul>
35 </li>
36
37 <li>define the <b>Fixed nodes ids</b> that should remain at their location during
38 smoothing. If a mesh is built on a shape, the nodes built on its
39 geometric edges are always fixed. If the smoothing is applied to a part
40 of the mesh, the nodes of boundary elements are also
41 fixed. It is possible to additionally fix any other nodes. The fixed nodes can be
42 selected manually or by filters, just as the smoothed elements.</li>
43 <li>choose the <b>Smoothing Method:</b>
44 <ul>
45 <li>\b Laplacian smoothing pulls a node toward the center of
46 surrounding nodes directly connected to that node along an element
47 edge. 
48 <li>\b Centroidal smoothing pulls a node toward the
49 element-area-weighted centroid of the surrounding elements. </li>
50
51 Typically, the  Laplacian method will produce the mesh with the least element
52 distortion. It is also the fastest method. Centroidal smoothing usually
53 produces  a mesh with more uniform element sizes. Both methods
54 produce good results with "free" meshes.</li>
55 </ul>
56
57 \image html image83.gif
58
59 </li>
60 <li>specify the <b>Iteration limit</b>. Both smoothing methods
61 iterate through a number of steps to produce the resulting smoothed
62 mesh. At each new step the smoothing is reevaluated with the updated nodal locations. This
63 process continues till the limit of iterations has been
64 exceeded, or till the aspect ratio of all element is less than or equal to the
65 specified one.</li>
66 <li>specify the  <b>Max. aspect ratio</b> - the target mesh quality at which the
67 smoothing algorithm should stop the iterations.</li>
68 <li>activate <b>in parametric space</b> checkbox if it is necessary to
69 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 </li>
74 <li>Click \b Apply or <b> Apply and Close</b> button to confirm the operation.</li>
75 </ol>
76
77 \image html smoothing1.png "The initial mesh"
78
79 \image html smoothing2.png "The smoothed mesh"
80
81 <br><b>See Also</b> a sample TUI Script of a 
82 \ref tui_smoothing "Smoothing" operation.  
83
84 */