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

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