Salome HOME
Merge branch 'V8_4_BR'
[modules/smesh.git] / doc / salome / gui / SMESH / input / uniting_set_of_triangles.rst
1 .. _uniting_set_of_triangles_page: 
2
3 **************************
4 Uniting a set of triangles
5 **************************
6
7 It is possible to unite many neighboring triangles into
8 quadrangles by deletion of the common edge.
9
10 **To union several triangles:**
11
12 #. Select a mesh (and display it in the 3D Viewer if you are going to pick elements by mouse).
13 #. In the **Modification** menu select the **Union of triangles** item or click **"Union of triangles"** button in the tool-bar.
14
15         .. image:: ../images/image80.png
16                 :align: center
17
18         .. centered::
19                 **"Union of triangles" button**
20
21 The following dialog box will appear:
22
23         .. image:: ../images/a-unionoftriangles.png
24                 :align: center
25
26
27         * **The main list** shall contain the triangles which will be united. You can click on a triangle in the 3D viewer and it will be highlighted. After that click the **Add** button and the ID of this triangle will be added to the list. To remove a selected element or elements from the list click the **Remove** button. The **Sort** button allows to sort the list of IDs. The **Filter** button allows to apply a definite :ref:`filtering_elements` to selection of triangles.
28         * **Apply to all** radio button allows to apply the operation to all triangles of the selected mesh.
29         * **Preview** provides a preview in the viewer.
30         * **Criterion** menu allows to choose a quality criterion, which will be optimized to select triangles to unite.
31         * **Select from** set of fields allows to choose a sub-mesh or an existing group whose triangle elements then can be added to the list.
32
33 #. Click the **Apply** or **Apply and Close** button to confirm the operation.
34
35 If some selected triangle elements have no adjacent edges with one of
36 the others, the operation on these elements shall take no effect.
37
38 .. image:: ../images/uniting_a_set_of_triangles1.png 
39         :align: center
40
41 .. centered::
42         "The chosen triangles"
43
44 .. image:: ../images/uniting_a_set_of_triangles2.png 
45         :align: center
46
47 .. centered::
48         "The union of several triangles - several quadrangular cells are created"
49
50 **See Also** a sample TUI Script of a 
51 :ref:`tui_uniting_set_of_triangles` operation.  
52
53