Salome HOME
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
index e40f8fdc885fc08b2ebba73129946bbf66e7c7e0..8b7bb76c4848d79807fc7b993fe88b10fd4cfadb 100644 (file)
@@ -2,7 +2,7 @@
 
 \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>
@@ -11,21 +11,29 @@ functionality allows you to sew:
 <li>\ref side_elements_anchor "Side elements"</li>
 </ul>
 
-<em>To sew elements of different meshes:</em>
+\image html sewing.png "Sewing button"
+
+<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>
 <li>Check in the dialog box one of the radio buttons corresponding to
 the type of sewing operation you would like to perform.</li>
 <li>Fill the other fields available in the dialog box.</li>
-<li>Click the \b OK or \b Apply button to perform the operation of sewing.</li>
+<li>Click the \b Apply or <b>Apply and Close</b> button to perform the operation of sewing.</li>
 </ol>
 
 <br>
 \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
 
@@ -48,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.
 
+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
@@ -63,7 +81,7 @@ enough to merge, if difference of their parameters is less than one
 fifth of minimum length of adjacent face edges on the borders.</li>
 </ol>
 
-\image html image22.jpg
+\image html image22.jpg "Sewing free borders"
 
 <b>See Also</b> a sample TUI Script of a 
 \ref tui_sew_free_borders "Sew Free Borders" operation.
@@ -90,7 +108,7 @@ second border.
 the first border and two points on the second one. User can select
 these nodes in 3D viewer or define node by its id.
 
-\image html image22.jpg
+\image html image23.jpg "Sewing conform free borders"
 
 <b>See Also</b> a sample TUI Script of a 
 \ref tui_sew_conform_free_borders "Sew Conform Free Borders"
@@ -120,7 +138,7 @@ border and two points on the side. User can select these nodes in 3D
 viewer or define node by its id.</li>
 </ol>
 
-\image html image30.jpg
+\image html image30.jpg "Sewing border to side"
 
 <b>See Also</b> a sample TUI Script of a 
 \ref tui_sew_meshes_border_to_side "Sew Border to Side" operation.  
@@ -145,9 +163,9 @@ belong to one element and must be located on an element set boundary.
 Sewing algorithm finds and merges the corresponding nodes starting
 from the specified ones.
 
-\image html image31.jpg
+\image html image31.jpg "Step-by-step sewing process"
 
-\image html image32.jpg
+\image html image32.jpg "The result of side elements sewing"
 
 For sewing side elements you should define elements for sewing and two
 nodes for merging on the each side. User can select these elements and
@@ -156,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.  
 
-*/
\ No newline at end of file
+*/