Salome HOME
Fix Redesign of SMESH documentation
[modules/smesh.git] / doc / salome / gui / SMESH / input / sewing_meshes.rst
index 70450462713e1e788bb54a65f11ab34dcf7df5c9..26e7a1408dbce38c8ddb26b56eb36d96aea16a2c 100644 (file)
@@ -4,8 +4,7 @@
 Sewing meshes
 *************
 
-In SMESH you can sew elements of a mesh. The current
-functionality allows you to sew:
+In SMESH you can sew elements of a mesh. The current functionality allows you to sew:
 
 * :ref:`free_borders_anchor`
 * :ref:`conform_free_borders_anchor`
@@ -17,9 +16,9 @@ functionality allows you to sew:
        :align: center
 
 .. centered::
-       "Sewing button"
+       *"Sewing"* button
 
-**To sew elements of a mesh:**
+*To sew elements of a mesh:*
 
 #. From the **Modification** menu choose the **Transformation** item and from its sub-menu select the **Sewing** item.
 #. Check in the dialog box one of the radio buttons corresponding to the type of sewing operation you would like to perform.
@@ -35,13 +34,14 @@ Sew free borders
 
 This functionality allows you to unite free borders of a 2D mesh.
 
-There are two working modes: *Automatic* and *Manual*. In the 
-**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 **Manual** mode you are to define borders to sew by picking
-three nodes of each of two borders.
+There are two working modes: *Automatic* and *Manual*.
+
+* In the **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 **Manual** mode you are to define borders to sew by picking
+  three nodes of each of two borders.
 
 .. image:: ../images/sewing1.png
        :align: center
@@ -70,26 +70,25 @@ To use **Automatic** sewing:
        .. image:: ../images/sort.png
                :align: center
 
-       .. centered::
-               **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.
+  * **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:: ../images/remove.png
                :align: center
 
-       .. centered::
-               **Remove Border** button removes the selected borders from the group. It is active if there are more than two borders in the group.
+  * **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. *Arrow* buttons near each field move the corresponding end node by the number of nodes defined by **Step** field.
+* Selection of a border in the list allows changing its first and last nodes whose IDs appear in two fields below the list.
+
+  * *Arrow* buttons near each field move the corresponding end node by the number of nodes defined by **Step** field.
  
        .. image:: ../images/swap.png
                :align: center
 
-       .. centered::
-               **Swap** button swaps the first and last nodes of a selected border.
+  * **Swap** button swaps the first and last nodes of a selected border.
 
 
-For sewing free borders manually you should switch the **Mode** to **Manual** and define three points on each border: the first, the second and the last node:
+For sewing free borders manually you should switch the **Mode** to **Manual** and define three points on each border: the first, the second and the last node:
 
        .. image:: ../images/sewing_manual.png
                :align: center
@@ -112,20 +111,20 @@ 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` coincident nodes into one
+:ref:`merge <merging_nodes_page>` coincident nodes into one
 beforehand. Two figures below illustrate this approach.
 
 .. image:: ../images/sew_using_merge.png               
        :align: center
 
 .. centered::
-       "Merge coincident nodes, which are difficult to distinguish"
+       Merge coincident nodes, which are difficult to distinguish
 
 .. image:: ../images/sew_after_merge.png
                :align: center
 
 .. centered::
-       "After merging nodes it is easy to specify border nodes"
+       After merging nodes it is easy to specify border nodes
 
 The sewing algorithm is as follows:
 
@@ -137,7 +136,7 @@ The sewing algorithm is as follows:
                :align: center
 
        .. centered::
-               "Sewing free borders"
+               Sewing free borders
 
 **See Also** a sample TUI Script of a 
 :ref:`tui_sew_free_borders` operation.
@@ -153,7 +152,7 @@ This functionality can be used to unite two free borders of a 2D mesh.
 .. image:: ../images/sewing2.png
        :align: center
 
-The borders of meshes for sewing are defined as for "Sew free borders"
+The borders of meshes for sewing are defined as for :ref:`free_borders_anchor`
 except that the second free border is not limited and can be defined
 by the first and the second nodes only. The first nodes of two borders
 can be the same.
@@ -171,7 +170,7 @@ second border.
        :align: center
 
 .. centered::
-       "Sewing conform free borders"
+       Sewing conform free borders
 
 **See Also** a sample TUI Script of a 
 :ref:`tui_sew_conform_free_borders` operation.
@@ -182,11 +181,9 @@ second border.
 Sew border to side
 ##################
 
-"Sew border to side" is intended to sew a free border to a mesh
-surface.
+*Sew border to side* is intended to sew a free border to a mesh surface.
 
-.. note:: 
-       The free border is defined as for "Sewing of free borders". The place where to sew the border is defined by two nodes, between which the border faces are placed, so that the first border node is merged with the first node on the side and the last node of the border is merged with the second specified node on the side.
+The free border is defined as for :ref:`free_borders_anchor`. The place where to sew the border is defined by two nodes, between which the border faces are placed, so that the first border node is merged with the first node on the side and the last node of the border is merged with the second specified node on the side.
 
 .. image:: ../images/sewing3.png
        :align: center
@@ -194,7 +191,7 @@ surface.
 The algorithm is following.
 
 #. Find a sequence of linked nodes on the side such that the found links to be most co-directed with the links of the free border.
-#. Sew two sequences of nodes using algorithm of "Sewing of free berders".
+#. Sew two sequences of nodes using algorithm of :ref:`free_borders_anchor`.
 
 .. note:: 
        For sewing border to side you should define three points on the border and two points on the side. User can select these nodes in 3D viewer or define node by its id.
@@ -203,7 +200,7 @@ The algorithm is following.
        :align: center
 
 .. centered::
-       "Sewing border to side"
+       Sewing border to side
 
 **See Also** a sample TUI Script of a 
 :ref:`tui_sew_meshes_border_to_side` operation.  
@@ -226,7 +223,7 @@ set must have a corresponding node in the other element set and
 corresponding nodes must be equally linked. If there are 3d elements
 in a set, only their free faces must obey to that rule.
 
-.. note:: Two corresponding nodes on each side must be specified. They must belong to one element and must be located on an element set boundary.
+Two corresponding nodes on each side must be specified. They must 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.
@@ -235,13 +232,13 @@ from the specified ones.
        :align: center
 
 .. centered::
-       "Step-by-step sewing process"
+       Step-by-step sewing process
 
 .. image:: ../images/image32.jpg 
        :align: center
 
 .. centered::
-       "The result of side elements sewing"
+       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