Salome HOME
bos #29171 Refactor testing procedure
[modules/smesh.git] / doc / gui / input / cutting_quadrangles.rst
1 .. _cutting_quadrangles_page:
2
3 *******************
4 Cutting quadrangles
5 *******************
6
7 This operation allows cutting one or several quadrangle elements into two or four triangles.
8
9 *To cut quadrangles:*
10
11 .. |img| image:: ../images/image82.png
12
13 #. Select a mesh (and display it in the 3D Viewer if you are going to pick elements by mouse).
14 #. In the **Modification** menu select the **Cutting of quadrangles** item or click *"Cutting of quadrangles"* button |img| in the toolbar.
15
16    The following dialog box will appear:
17
18    .. image:: ../images/a-cuttingofquadrangles.png
19       :align: center
20
21
22    * The main list contains the list of quadrangles selected for cutting. You can click on a quadrangle in the 3D viewer and it will be highlighted (lock Shift keyboard button to select several quadrangles): 
23         * Click **Add** button and the ID of this quadrangle will be added to the list. 
24         * To remove a selected element or elements from the list click **Remove** button. 
25         * **Sort list** button allows sorting the list of IDs. 
26         * **Filter** button allows applying a definite :ref:`filter <filtering_elements>` to the selection of quadrangles.
27    * **Apply to all** check box allows cutting all quadrangles of the selected mesh.
28    * **Preview** provides a preview of cutting in the viewer. It is disabled for **Cut into 4 triangles** as this cutting way implies no ambiguity.
29    * **Criterion** defines the way of cutting:
30         * **Cut into 4 triangles** allows cutting a quadrangle into four triangles by inserting a new node at the center of the quadrangle. The other options allow cutting a quadrangle into two triangles by connecting the nodes of a diagonal.
31         * **Use diagonal 1-3** and **Use diagonal 2-4** allow specifying the opposite corners, which will be connected to form two new triangles.
32         * **Use numeric functor** allows selecting in the field below a quality metric, which will be optimized when choosing a diagonal for cutting a quadrangle: 
33                 * **Minimum diagonal** cuts by the shortest diagonal.
34                 * **Aspect Ratio** cuts by the diagonal splitting the quadrangle into triangles with :ref:`Aspect Ratio <aspect_ratio_page>` closer to 1
35                 * **Minimum Angle** cuts by the diagonal splitting the quadrangle into triangles with :ref:`Minimum Angle <minimum_angle_page>` closer to 60 degrees.
36                 * **Skew** cuts by the diagonal splitting the quadrangle into triangles with :ref:`Skew <skew_page>` closer to 0.0 degrees.
37    * **Select from** allows choosing a sub-mesh or an existing group, whose quadrangle elements then can be added to the main list.
38
39 #. Click the **Apply** or **Apply and Close** button to confirm the operation.
40
41 .. image:: ../images/image52.jpg 
42         :align: center
43
44 .. centered::
45         The chosen quadrangular element
46
47 |
48
49 .. image:: ../images/image51.jpg 
50         :align: center
51
52 .. centered::
53         Two resulting triangular elements
54
55 **See Also** a sample TUI Script of a :ref:`tui_cutting_quadrangles` operation.  
56
57