X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fsewing_meshes.doc;h=cfb6206dd34d66b6226df0465d9a8bf423ba6f5c;hb=5482b99d07dd144fd5be299e722f39a81de3b5be;hp=c3afbf1e07fe43515666cba75520fda59eac46a9;hpb=0635c9fc80f67d1e5dc0e94ec85f487286a92070;p=modules%2Fsmesh.git
diff --git a/doc/salome/gui/SMESH/input/sewing_meshes.doc b/doc/salome/gui/SMESH/input/sewing_meshes.doc
index c3afbf1e0..cfb6206dd 100644
--- 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
-\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:
- \ref free_borders_anchor "Free borders"
@@ -13,26 +13,89 @@ functionality allows you to sew:
\image html sewing.png "Sewing button"
-To sew elements of different meshes:
+To sew elements of a mesh:
- From the \b Modification menu choose the \b Transformation item
and from its sub-menu select the \b Sewing item.
- Check in the dialog box one of the radio buttons corresponding to
the type of sewing operation you would like to perform.
- Fill the other fields available in the dialog box.
-- Click the \b Apply or Apply and Close button to perform the operation of sewing.
+- Click the \b Apply or Apply and Close button to perform the
+ operation of sewing.
+
\anchor free_borders_anchor
Sew free borders
-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 the
+specified tolerance and sews them. Optionally it is possible to
+visually check and correct if necessary the found free borders before
+sewing.
+In the \b Manual mode you are to define borders to sew by picking
+three nodes of each of two borders.
\image html sewing1.png
+Default mode is \a Automatic
+
+To use \b Automatic sewing:
+
+- Specify the mesh you want to sew by selecting it or any its part
+ (group or sub-mesh) in the Object Browser or in the VTK Viewer.
+- Specify the \b Tolerance, within which free borders are considered
+ coincident. At the default zero \b Tolerance, the tolerance used by
+ the search algorithm is defined as one tenth of an average size of
+ elements adjacent to compared free borders.
+- To visually check the coincident free borders found by the
+ algorithm, switch off Auto Sewing check-box. The controls
+ to adjust groups of coincident free borders will become available in
+ the dialog.
+
+\image html sewing_auto.png
+Controls to adjust groups of coincident free borders
+
+- \b Detect button launches the algorithm of search of coincident
+ free borders.
+- The found groups of Coincident Free Borders are shown in the
+ list, one group per line. Each group has its own color, which is used
+ to display the group borders in the VTK Viewer. A free border
+ within a group is designated by the IDs of its first, second and
+ last nodes within parenthesis. All borders present in the list will
+ be sewn upon \b Apply.
+- \b Remove button removes the selected groups from the list.
+- Select All check-box selects all groups in the list.
+- When a group is selected, its borders appear in Edit Selected
+ Group list that allows you to change this group.
+-
+\image html sort.png
+Set First button moves the selected border to the
+ first position in the group, as a result other borders will be moved
+ to this border during sewing.
+
-
+\image html remove.png
+Remove Border button removes the selected borders from the
+ group. It is active if there are more than two borders in the group.
+
+- Selection of a border in the list allows changing its first and
+ last nodes whose IDs appear in two fields below the list. \a Arrow
+ buttons near each field move the corresponding end node by the
+ number of nodes defined by \b Step field.
+-
+\image html swap.png
+Swap button swaps the first and last nodes of a
+ selected border.
+
+
+
+For sewing free borders manually you should switch the \b Mode to \b
+Manual and define three points on each border: the first, the second and the
+last node:
-For sewing free borders you should define three points on each border:
-first, second and the last node:
+\image html sewing_manual.png
- the first node specifies beginning of the border;
- the second node specifies the part of the border which should be
@@ -50,6 +113,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"
+
+\image html sew_after_merge.png "After merging nodes it is easy to specify border nodes"
+
The sewing algorithm is as follows:
- The parameter (U) of each node within a border is computed. So
@@ -158,4 +231,4 @@ nodes in 3D viewer or define them by its id.
See Also a sample TUI Script of a
\ref tui_sew_side_elements "Sew Side Elements" operation.
-*/
\ No newline at end of file
+*/