doc/salome/gui/SMESH/input/merging_elements.rst

   1 .. _merging_elements_page:
   2
   3 ****************
   4 Merging Elements
   5 ****************
   6
   7 This functionality allows to merge coincident elements of a mesh. Two elements are considered coincident if they are based on the same set of nodes.
   8
   9 .. image:: ../images/mergeelems_ico.png
  10         :align: center
  11
  12 .. centered::
  13         "Merge elements menu button"
  14
  15 To merge elements choose in the main menu **Modification** -> **Transformation** -> **Merge elements** item. The following dialog box shall appear:
  16
  17 .. image:: ../images/mergeelems_auto.png
  18         :align: center
  19
  20 In this dialog:
  21
  22         * Name is the name of the mesh object whose elements will be merged.
  23         * **Automatic** or **Manual** Mode allows choosing how the elements are processed. In the **Automatic** Mode all elements created on the same nodes will be merged. In **Manual** mode you can adjust groups of coincident elements detected by the program.
  24                 If the **Manual** Mode is selected, additional controls are available:
  25
  26                 .. image:: ../images/mergeelems.png
  27                         :align: center
  28
  29
  30                 * **Detect** button generates the list of coincident elements found in the selected object.
  31                 * **Coincident elements** is a list of groups of elements for merging. After the operation all elements of each group will be united into one element. The first element of a group is kept and the others are removed.
  32                 * **Remove** button deletes the selected group from the list.
  33                 * **Add** button adds to the list a group of elements selected in the viewer with pressed "Shift" key.
  34                 * **Select all** check-box selects all groups.
  35                 * **Show double elements IDs** check-box shows/hides identifiers of elements of the selected groups in the 3D viewer.
  36                 * **Edit selected group of coincident elements** list allows editing the selected group:
  37
  38                 .. image:: ../images/add.png
  39                         :align: center
  40
  41                 .. centered::
  42                         adds to the group the elements selected in the viewer.
  43
  44                 .. image:: ../images/remove.png
  45                         :align: center
  46
  47                 .. centered::
  48                         removes the selected elements from the group.
  49
  50                 .. image:: ../images/sort.png
  51                         :align: center
  52
  53                 .. centered::
  54                         moves the selected element to the first position in the group in order to keep it in the mesh.
  55
  56
  57
  58         * To confirm your choice click **Apply** or **Apply and Close** button.
  59
  60
  61 In this picture you see a triangle which coincides with one of the elements of the mesh. After we apply **Merge Elements** functionality, the triangle will be completely merged with the mesh.
  62
  63 .. image:: ../images/meshtrianglemergeelem1.png
  64         :align: center
  65
  66 **See Also** a sample TUI Script of a :ref:`tui_merging_elements` operation.
  67
  68