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 If <b>Show IDs</b> is activated, IDs of selected nodes or elements are
82 displayed in the 3D viewer.
84 \note The information about the groups, to which the node or element belongs,
85 can be shown in a short or in a detailed form. By default, for performance
86 reasons, this information is shown in a short form (group names
87 only). The detailed information on groups can be switched on via
88 \ref group_detail_info_pref "Show details on groups in element information tab"
89 option of \ref mesh_preferences_page.
91 \anchor mesh_addition_info_anchor
92 <h2>Additional Information</h2>
94 The <b>Additional Info</b> tab page of the dialog box provides an
95 additional information on the selected object: mesh, sub-mesh or
98 For a mesh object, the following information is shown:
100 - Type: based on geomerty, imported, standalone
101 - Shape (if mesh is based on geometry)
102 - File (if mesh is imported from the file)
106 <center>\image html addinfo_mesh.png
107 <em>"Additional Info" page, mesh information</em></center>
110 For a sub-mesh object, the following information is shown:
115 <center>\image html addinfo_submesh.png
116 <em>"Additional Info" page, sub-mesh information</em></center>
119 \anchor mesh_addition_info_group_anchor
120 For a group object, the following information is shown:
123 - Type: standalone, group on geometry, group on filter
124 - Entity type: node, edge, face, volume
127 - Number of underlying nodes (for non-nodal groups)
129 <center>\image html addinfo_group.png
130 <em>"Additional Info" page, group information</em></center>
133 \note For the performance reasons, the number of underlying nodes is
134 computed only by demand. For this, the user should press the "Compute"
135 button (see picture). Also, the number of underlying nodes is
136 automatically calculated if the size of the group does not exceed
137 the \ref nb_nodes_limit_pref "Automatic nodes compute limit"
138 preference value (zero value means no limit).
140 \anchor mesh_quality_info_anchor
141 <h2>Quality Information</h2>
143 The <b>Quality Info</b> tab provides overall information about mesh quality controls on the selected object - mesh, sub-mesh or mesh group:
146 - Number of free nodes;
147 - Maximal number of elements connected to a node;
148 - Number of double nodes;
150 - Number of double edges;
152 - Number of double faces;
153 - Number of over-constrained faces;
154 - Aspect Ratio histogram;
155 - Volume information:
156 - Number of double volumes;
157 - Number of over-constrained volumes;
158 - Aspect Ratio 3D histogram.
160 <center>\image html ctrlinfo.png
161 <em>"Quality Info" page</em></center>
163 \note It is possible to change <b>Double nodes tolerance</b>, which
164 will be used upon consequent pressing \a Compute button. The default value
165 of the tolerance can be set via the
166 \ref dbl_nodes_tol_pref "Quality controls" preferences.
168 \note For performance reasons, all quality control values for big
169 meshes are computed only by demand. For this, press the \a Compute
170 button. Also, values are automatically computed if the number of nodes
171 / elements does not exceed the
172 \ref auto_control_limit_pref "Automatic controls compute limit" set
173 via the \ref mesh_information_pref "Mesh information" preferences
174 (zero value means that there is no limit).
176 \note The plot functionality is available only if the GUI module is
177 built with Plot 2D Viewer (option SALOME_USE_PLOT2DVIEWER is ON when
178 building GUI module).
180 See the \ref tui_viewing_mesh_infos "TUI Example".