Salome HOME
PR: merged from V5_1_4rc1
[modules/smesh.git] / 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 selectable in the dialog box.
7
8 \image html mergeelems_ico.png "Merge elements button"
9
10 <ol>
11 <li>From the \b Modification choose \b Transformation and  from its
12 sub-menu select the <b>Merge elements</b> item. The following dialog box
13 shall appear:</li>
14
15 \image html mergeelems_auto.png
16 <br>
17 <ul>
18 <li>\b Name is the name of the mesh whose elements will be merged.</li>
19 <li>\b Automatic Mode or \b Manual Mode is to switch the dialog
20 controls type.
21 </ul>
22
23 <li><b>Automatic mode:</b>
24 <ul>
25 <li>In \b Automatic Mode the elements that were created on the same nodes will be merged.</li>
26 </ul>
27 </li>
28
29 <li>If the \b Manual Mode is selected there are additional controls to 
30 manage the elements to be merged in more detail:
31
32 \image html mergeelems.png
33 <br>
34 <ul>
35 <li>\b Detect button generates the list of coincident elements for the given \b Tolerance.</li>
36 <li><b>Coincident elements</b> is a list of groupes of elements for
37 merging. All elements of each group will form one after the operation.
38 <ul>
39 <li>\b Remove button deletes the selected group from the list.</li>
40 <li>\b Add button adds to the list a group of elements selected in the
41 viewer with pressed "Shift" key.</li>
42 <li><b>Select all</b> checkbox selects all groups.</li>
43 </ul></li>
44 <li><b>Edit selected group</b> list allows editing the selected group:
45 <br><br>
46 \image html add.png
47 <center>adds to the group the element selected in the viewer.</center>
48 <br>
49 \image html remove.png
50 <center>removes from the group the selected element.</center>
51 <br>
52 \image html sort.png
53 <center>moves the selected element to the first position in the
54 group. This means that all other elements will be merged into this
55 one.</center>
56 <br>
57 </li>
58 <li>To confirm your choice click \b Apply or <b>Apply and Close</b> button.</li>
59 </ul>
60 </ol>
61
62 In this picture you see a triangle which coincides with one of the
63 elements of the mesh. After we apply <b>Merge Elements</b> functionality, the
64 triangle will be completely merged with the mesh.
65
66 \image html meshtrianglemergeelem1.png
67
68 <br><b>See Also</b> a sample TUI Script of a
69 \ref tui_merging_elements "Merge Elements" operation.
70
71 */