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. As result of the operation all elements of each group will
  41   be replaced by the firts element of the group.
  42 <ul>
  43 <li>\b Remove button deletes the selected group from the list.</li>
  44 <li>\b Add button adds to the list a group of elements selected in the
  45   viewer with pressed "Shift" key.</li>
  46 <li><b>Select all</b> checkbox selects all groups.</li>
  47 <li><b>Show double elements IDs</b> checkbox shows/hides identifiers of
  48   elements of selected groups in the 3D viewer.</li>
  49 </ul></li>
  50 <li><b>Edit selected group</b> list allows editing the selected group:
  51 <br><br>
  52 \image html add.png
  53 <center>adds to the group the elements selected in the viewer.</center>
  54 <br>
  55 \image html remove.png
  56 <center>removes from the group the selected elements.</center>
  57 <br>
  58 \image html sort.png
  59 <center>moves the selected element to the first position in the
  60   group. This means that all other elements of the group will be
  61   replaced by this one.</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 */