X-Git-Url: http://git.salome-platform.org/gitweb/?p=modules%2Fsmesh.git;a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fsmoothing.doc;h=dc15270a8e460109cfb6310c3f97df9fc8ad15b5;hp=f1991d62b08aa4c2fb016f637645b007baf7339c;hb=e7c421ee2a70216b7f739e3bb4d484fc60517682;hpb=79b1ac2b6df9117f16f11d444b1f165d477a1813;ds=sidebyside

diff --git a/doc/salome/gui/SMESH/input/smoothing.doc b/doc/salome/gui/SMESH/input/smoothing.doc
index f1991d62b..dc15270a8 100644
--- a/doc/salome/gui/SMESH/input/smoothing.doc
+++ b/doc/salome/gui/SMESH/input/smoothing.doc
@@ -7,30 +7,40 @@
 
 <em>To apply smoothing to the elements of your mesh:</em>
 <ol>
-<li>Display a mesh or a submesh in the 3D viewer.</li>
+
 <li>In the \b Modification menu select the \b Smoothing item or click
 <em>"Smoothing"</em> button in the toolbar.
 
-\image html image84.gif
+\image html image84.png
 <center><em>"Smoothing" button</em></center>
 
-The dialog box contains the following fields which should be
-specified:
+The following dialog will appear:
 
 \image html smoothing.png
+</li>
+<li>In this dialog:
 
 <ul>
-<li><b>Id Elements</b> field allows to specify the elements which
-should be smoothed by selecting them in the 3D viewer (lock \b Shift
-button to select several elements).</li>
-<li><b>Select whole mesh, submesh or group</b> - smoothing is applied
-to the whole mesh or its part.</li>
-<li><b>Fixed nodes ids:</b> some nodes keep their location during
-smoothing. If a mesh is built on a geometry shape, the nodes built on
-geometrical edges are always fixed. If smoothing is applied to a part
-of a mesh then the boundary nodes of an elements set are also
-fixed. Any other nodes may be additionally fixed.</li>
-<li><b>Smoothing Method:</b>
+<li>specify the IDs of the elements which will be smoothed:
+<ul>
+<li><b>Select the whole mesh, submesh or group</b> activating this
+checkbox; or</li>
+<li>choose mesh elements with the mouse in the 3D Viewer. It is
+possible to select a whole area with a mouse frame; or</li> 
+<li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
+viewer; or</li>
+<li>apply Filters. <b>Set filter</b> button allows to apply a filter to the selection of elements. See more
+about filters in the \ref selection_filter_library_page "Selection filter library" page.</li>
+</ul>
+</li>
+
+<li>define the <b>Fixed nodes ids</b> that should remain at their location during
+smoothing. If a mesh is built on a shape, the nodes built on its
+geometric edges are always fixed. If the smoothing is applied to a part
+of the mesh, the nodes of boundary elements are also
+fixed. It is possible to additionally fix any other nodes. The fixed nodes can be
+selected manually or by filters, just as the smoothed elements.</li>
+<li>choose the <b>Smoothing Method:</b>
 <ul>
 <li>\b Laplacian smoothing pulls a node toward the center of
 surrounding nodes directly connected to that node along an element
@@ -39,37 +49,34 @@ edge.
 element-area-weighted centroid of the surrounding elements. </li>
 
 Typically, the  Laplacian method will produce the mesh with the least element
-distortion. It is also the faster method.Centroidal smoothing usually
-produces  a mesh that has more uniform element sizes. Both methods
+distortion. It is also the fastest method. Centroidal smoothing usually
+produces  a mesh with more uniform element sizes. Both methods
 produce good results with "free" meshes.</li>
 </ul>
 
 \image html image83.gif
 
 </li>
-<li><b>Iteration limit:</b> both of the smoothing methods use an
-iterative procedure to converge toward a smoothed mesh. All nodes are
-smoothed according to one of the techniques shown above. Then the
-smoothing is reevaluated with the updated nodal locations. This
-process continues until the maximum number of iterations has been
-exceeded, or all elements has aspect ratio less or equal than the
+<li>specify the <b>Iteration limit</b>. Both smoothing methods
+iterate through a number of steps to produce the resulting smoothed
+mesh. At each new step the smoothing is reevaluated with the updated nodal locations. This
+process continues till the limit of iterations has been
+exceeded, or till the aspect ratio of all element is less than or equal to the
 specified one.</li>
-<li><b>Max. aspect ratio</b> allows to define the quality at which the
-smoothing algorithm should stop the iterations as the target of the
-operation has been reached.</li>
-<li>When <b>in parametric space</b> radio button is checked, the
-algorithm tries to improve the shape of faces in the parametric space
+<li>specify the  <b>Max. aspect ratio</b> - the target mesh quality at which the
+smoothing algorithm should stop the iterations.</li>
+<li>activate <b>in parametric space</b> checkbox if it is necessary to
+to improve the shape of faces in the parametric space
 of geometrical surfaces on which they are generated, else the shape of
 faces in the 3D space is improved. </li>   
 </ul>
-
 </li>
-<li>Click the \b Apply or \b OK button to confirm the operation.</li>
+<li>Click \b Apply or <b> Apply and Close</b> button to confirm the operation.</li>
 </ol>
 
-\image html smoothing1.png
+\image html smoothing1.png "The initial mesh"
 
-\image html smoothing2.png
+\image html smoothing2.png "The smoothed mesh"
 
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_smoothing "Smoothing" operation.