Salome HOME
bos #32738 [CEA] Scaled Jacobian quality mesh measure for volumetric elements.
[modules/smesh.git] / doc / gui / input / about_quality_controls.rst
1 .. _quality_page: 
2
3 **********************
4 About quality controls
5 **********************
6
7 **Mesh quality control** in MESH is destined for visual control of the generated mesh.
8
9 Application of a definite quality control consists of usage of the corresponding algorithm, which calculates a value of a definite geometric characteristic (Area, Length of edges, etc) for all meshing elements, composing your mesh. Then all meshing elements are colored according the calculated values. The reference between the coloring of the meshing elements and these calculated values is shown with the help of a scalar bar, which is displayed near the presentation of your mesh.
10
11 There are four types of quality controls, corresponding to node, edge, face and volume entity type.
12
13 Node quality controls:
14
15 * :ref:`free_nodes_page`
16 * :ref:`double_nodes_control_page`
17
18
19 Edge quality controls:
20
21 * :ref:`free_borders_page`
22 * :ref:`length_page`
23 * :ref:`borders_at_multi_connection_page`
24 * :ref:`double_elements_page`
25
26
27 Face quality controls:
28
29 * :ref:`free_edges_page`
30 * :ref:`free_faces_page`
31 * :ref:`bare_border_faces_page`
32 * :ref:`over_constrained_faces_page`
33 * :ref:`length_2d_page`
34 * :ref:`deflection_2d_page`
35 * :ref:`borders_at_multi_connection_2d_page`
36 * :ref:`area_page`
37 * :ref:`taper_page`
38 * :ref:`aspect_ratio_page`
39 * :ref:`minimum_angle_page`
40 * :ref:`warping_page`
41 * :ref:`skew_page`
42 * :ref:`max_element_length_2d_page`
43 * :ref:`double_elements_page`
44
45
46 Volume quality controls:
47
48 * :ref:`aspect_ratio_3d_page`
49 * :ref:`volume_page`
50 * :ref:`max_element_length_3d_page`
51 * :ref:`scaled_jacobian_page`
52 * :ref:`bare_border_volumes_page`
53 * :ref:`over_constrained_volumes_page`
54 * :ref:`double_elements_page`
55
56
57 To manage the quality controls call pop-up in the VTK viewer and select "Controls" sub-menu
58
59 .. image:: ../images/controls_popup.png
60         :align: center
61
62
63 *  **Reset** switches off quality controls;
64 *  **Node Controls** provides access to the node quality controls;
65 *  **Edge Controls** provides access to the edge quality controls;
66 *  **Face Controls** provides access to the face quality controls;
67 *  **Volume Controls** provides access to the volume quality controls;
68 *  **Scalar Bar Properties** allows setting :ref:`scalar_bar_dlg`;
69 *  **Distribution -> Export ...** allows saving the distribution of quality control values in the text file;
70 *  **Distribution -> Show** Shows/Hides the distribution histogram of the quality control values in the VTK Viewer.
71 *  **Distribution -> Plot** Plots the distribution histogram of the quality control values in the Plot 2D Viewer.
72
73 **Table of Contents**
74
75 .. toctree::
76         :maxdepth: 2
77
78         free_nodes.rst
79         double_nodes_control.rst
80         free_borders.rst
81         length.rst
82         borders_at_multi_connection.rst
83         double_elements_control.rst
84         free_edges.rst
85         free_faces.rst
86         bare_border_face.rst
87         over_constrained_faces.rst
88         length_2d.rst
89         deflection_2d.rst
90         borders_at_multi_connection_2d.rst
91         area.rst
92         taper.rst
93         aspect_ratio.rst
94         minimum_angle.rst
95         warping.rst
96         skew.rst
97         max_element_length_2d.rst
98         aspect_ratio_3d.rst
99         volume.rst
100         max_element_length_3d.rst
101         bare_border_volumes.rst
102         over_constrained_volumes.rst
103         scalar_bar.rst
104         scaled_jacobian.rst