3 \page mesh_infos_page Mesh Information
5 The user can obtain information about the selected mesh object
6 (mesh, sub-mesh or group) using <b>Mesh Information</b> dialog box.
8 To view the <b>Mesh Information</b>, select your mesh, sub-mesh or
9 group in the <b>Object Browser</b> and invoke <b>Mesh Information</b>
10 item from the \b Mesh menu or from the context menu, or click <em>"Mesh Information"</em> button
13 <center>\image html image49.png
14 <em>"Mesh Information" button</em></center>
16 The <b>Mesh Information</b> dialog box provides three tab pages:
17 - <b>\ref advanced_mesh_infos_anchor "Base Info"</b> - to show
18 base and quantitative information about the selected mesh object.
19 - <b>\ref mesh_element_info_anchor "Element Info"</b> - to show
20 detailed information about the selected mesh nodes or elements.
21 - <b>\ref mesh_addition_info_anchor "Additional Info"</b> - to show
22 additional information available for the selected mesh, sub-mesh or
24 - <b>\ref mesh_quality_info_anchor "Quality Info"</b> - to show
25 overall quality information about the selected mesh, sub-mesh or group
28 \anchor dump_mesh_infos
29 The button \b Dump allows printing the information displayed in the
30 dialog box to a .txt file. The dialog for choosing a file also allows
31 to select which tab pages to dump via four check-boxes. The default state
32 of the check-boxes can be changed via \ref mesh_information_pref "Mesh information"
35 \anchor advanced_mesh_infos_anchor
36 <h2>Base Information</h2>
38 The <b>Base Info</b> tab page of the dialog box provides general
39 information on the selected object - mesh, sub-mesh or mesh group:
40 name, type, total number of nodes and elements separately for each
41 type: 0D elements, edges, faces, volumes, balls.
43 <center>\image html advanced_mesh_infos.png
44 <em>"Base Info" page</em></center>
46 \anchor mesh_element_info_anchor
47 <h2>Mesh Element Information</h2>
49 The <b>Element Info</b> tab page of the dialog box gives detailed
50 information about the selected mesh node(s) or element(s), namely:
54 - Coordinates (X, Y, Z);
55 - Connectivity information (connected elements); double click in
56 this line reveals information about these elements;
57 - Position on a shape (for meshes built on a geometry);
58 - Groups information (names of groups the node belongs to).
60 <center>\image html eleminfo1.png
61 <em>"Element Info" page, node information</em></center>
66 - Type (triangle, quadrangle, etc.);
67 - Gravity center (X, Y, Z coordinates);
68 - Connectivity information (connected nodes); double click in
69 a line of a node reveals the information about this node;
70 - Quality controls (area, aspect ratio, volume, etc.);
71 - Position on a shape (for meshes built on a geometry);
72 - Groups information (names of groups the element belongs to).
74 <center>\image html eleminfo2.png
75 <em>"Element Info" page, element information</em></center>
77 The user can either input the ID of a node or element he wants to
78 analyze directly in the dialog box or select the node(s) or element(s) in
81 \note The information about the groups, to which the node or element belongs,
82 can be shown in a short or in a detailed form. By default, for performance
83 reasons, this information is shown in a short form (group names
84 only). The detailed information on groups can be switched on via
85 \ref group_detail_info_pref "Show details on groups in element information tab"
86 option of \ref mesh_preferences_page.
88 \anchor mesh_addition_info_anchor
89 <h2>Additional Information</h2>
91 The <b>Additional Info</b> tab page of the dialog box provides an
92 additional information on the selected object: mesh, sub-mesh or
95 For a mesh object, the following information is shown:
97 - Type: based on geomerty, imported, standalone
98 - Shape (if mesh is based on geometry)
99 - File (if mesh is imported from the file)
103 <center>\image html addinfo_mesh.png
104 <em>"Additional Info" page, mesh information</em></center>
107 For a sub-mesh object, the following information is shown:
112 <center>\image html addinfo_submesh.png
113 <em>"Additional Info" page, sub-mesh information</em></center>
116 \anchor mesh_addition_info_group_anchor
117 For a group object, the following information is shown:
120 - Type: standalone, group on geometry, group on filter
121 - Entity type: node, edge, face, volume
124 - Number of underlying nodes (for non-nodal groups)
126 <center>\image html addinfo_group.png
127 <em>"Additional Info" page, group information</em></center>
130 \note For the performance reasons, the number of underlying nodes is
131 computed only by demand. For this, the user should press the "Compute"
132 button (see picture). Also, the number of underlying nodes is
133 automatically calculated if the size of the group does not exceed
134 the \ref nb_nodes_limit_pref "Automatic nodes compute limit"
135 preference value (zero value means no limit).
137 \anchor mesh_quality_info_anchor
138 <h2>Quality Information</h2>
140 The <b>Quality Info</b> tab provides overall information about mesh quality controls on the selected object - mesh, sub-mesh or mesh group:
143 - Number of free nodes;
144 - Maximal number of elements connected to a node;
145 - Number of double nodes;
147 - Number of double edges;
149 - Number of double faces;
150 - Number of over-constrained faces;
151 - Aspect Ratio histogram;
152 - Volume information:
153 - Number of double volumes;
154 - Number of over-constrained volumes;
155 - Aspect Ratio 3D histogram.
157 <center>\image html ctrlinfo.png
158 <em>"Quality Info" page</em></center>
160 \note It is possible to change <b>Double nodes tolerance</b>, which
161 will be used upon consequent pressing \a Compute button. The default value
162 of the tolerance can be set via the
163 \ref dbl_nodes_tol_pref "Quality controls" preferences.
165 \note For performance reasons, all quality control values for big
166 meshes are computed only by demand. For this, press the \a Compute
167 button. Also, values are automatically computed if the number of nodes
168 / elements does not exceed the
169 \ref auto_control_limit_pref "Automatic controls compute limit" set
170 via the \ref mesh_information_pref "Mesh information" preferences
171 (zero value means that there is no limit).
173 \note The plot functionality is available only if the GUI module is
174 built with Plot 2D Viewer (option SALOME_USE_PLOT2DVIEWER is ON when
175 building GUI module).
177 See the \ref tui_viewing_mesh_infos "TUI Example".