IMP 23078: [CEA 1498] Sewing of meshes without having to set the nodes ids

[modules/smesh.git] / doc / salome / gui / SMESH / input / sewing_meshes.doc

diff --git a/doc/salome/gui/SMESH/input/sewing_meshes.doc b/doc/salome/gui/SMESH/input/sewing_meshes.doc
index c3afbf1e07fe43515666cba75520fda59eac46a9..8b7bb76c4848d79807fc7b993fe88b10fd4cfadb 100644 (file)
--- a/doc/salome/gui/SMESH/input/sewing_meshes.doc
+++ b/doc/salome/gui/SMESH/input/sewing_meshes.doc
@@ -2,7 +2,7 @@
 
 \page sewing_meshes_page Sewing meshes
 
 
 \page sewing_meshes_page Sewing meshes
 

-\n In SMESH you can sew elements of  different meshes. The current
+\n In SMESH you can sew elements of a mesh. The current

 functionality allows you to sew:
 <ul>
 <li>\ref free_borders_anchor "Free borders"</li>
 functionality allows you to sew:
 <ul>
 <li>\ref free_borders_anchor "Free borders"</li>


@@ -13,7 +13,7 @@ functionality allows you to sew:
 
 \image html sewing.png "Sewing button"
 
 
 \image html sewing.png "Sewing button"
 

-<em>To sew elements of different meshes:</em>
+<em>To sew elements of a mesh:</em>

 <ol>
 <li>From the \b Modification menu choose the \b Transformation item
 and from its sub-menu select the \b Sewing item.</li>
 <ol>
 <li>From the \b Modification menu choose the \b Transformation item
 and from its sub-menu select the \b Sewing item.</li>


@@ -27,7 +27,13 @@ the type of sewing operation you would like to perform.</li>
 \anchor free_borders_anchor
 <h2>Sew free borders</h2>
 
 \anchor free_borders_anchor
 <h2>Sew free borders</h2>
 

-This functionality allows you to unite two free borders of a 2D mesh.
+This functionality allows you to unite free borders of a 2D mesh.
+
+There are two working modes: \a Automatic and \a Manual. In the \b
+Automatic mode, the program finds free borders coincident within a
+certain tolerance and sew them. Optionally it is possible to adjust
+the found free borders before sewing. In the \b Manual mode you are to
+define borders to sew by picking three nodes of each border.

 
 \image html sewing1.png
 
 
 \image html sewing1.png
 


@@ -50,6 +56,16 @@ corresponding end nodes of two borders will be merged. Intermediate
 nodes of two borders will be either merged or inserted into faces of
 the opposite border.
 
 nodes of two borders will be either merged or inserted into faces of
 the opposite border.
 

+In practice the borders to sew often coincide and in this case it is
+difficult to specify the first and the last nodes of a border since
+they coincide with the first and the last nodes of the other
+border. To cope with this,
+\ref merging_nodes_page "merge" coincident nodes into one
+beforehand. Two figures below illustrate this approach.
+\image html sew_using_merge.png "Merge coincident nodes which are difficult to distinguish"
+<br>
+\image html sew_after_merge.png "After merging nodes it is easy to specify border nodes"
+

 The sewing algorithm is as follows:
 <ol>
 <li>The parameter (U) of each node within a border is computed. So
 The sewing algorithm is as follows:
 <ol>
 <li>The parameter (U) of each node within a border is computed. So


@@ -158,4 +174,4 @@ nodes in 3D viewer or define them by its id.
 <b>See Also</b> a sample TUI Script of a 
 \ref tui_sew_side_elements "Sew Side Elements" operation.  
 
 <b>See Also</b> a sample TUI Script of a 
 \ref tui_sew_side_elements "Sew Side Elements" operation.  
 

-*/
\ No newline at end of file
+*/