Salome HOME
bos #29171 Refactor testing procedure
[modules/smesh.git] / doc / gui / 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 .. |img| image:: ../images/image80.png
13
14 #. Select a mesh (and display it in the 3D Viewer if you are going to pick elements by mouse).
15 #. In the **Modification** menu select the **Union of triangles** item or click *"Union of triangles"* button |img| in the tool-bar.
16
17    The following dialog box will appear:
18
19         .. image:: ../images/a-unionoftriangles.png
20                 :align: center
21
22
23         * **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:`filter <filtering_elements>` to selection of triangles.
24         * **Apply to all** radio button allows to apply the operation to all triangles of the selected mesh.
25         * **Preview** provides a preview in the viewer.
26         * **Criterion** menu allows to choose a quality criterion, which will be optimized to select triangles to unite.
27         * **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.
28
29 #. Click the **Apply** or **Apply and Close** button to confirm the operation.
30
31 If some selected triangle elements have no adjacent edges with one of
32 the others, the operation on these elements shall take no effect.
33
34 .. image:: ../images/uniting_a_set_of_triangles1.png 
35         :align: center
36
37 .. centered::
38         The chosen triangles
39
40 .. image:: ../images/uniting_a_set_of_triangles2.png 
41         :align: center
42
43 .. centered::
44         The union of several triangles - several quadrangular cells are created
45
46 **See Also** a sample TUI Script of a 
47 :ref:`tui_uniting_set_of_triangles` operation.  
48
49