Salome HOME
23303: [EDF 12024] Filter for nodes connectivity
[modules/smesh.git] / doc / salome / gui / SMESH / input / mesh_infos.doc
index 5c526af674870b08de16873ed71f0021c68af351..fd09d0d8d2e15846789b30ca4f2129de5fdd6dca 100644 (file)
@@ -7,19 +7,23 @@ The user can obtain information about the selected mesh object
 
 To view the <b>Mesh Information</b>, select your mesh, sub-mesh or
 group in the <b>Object Browser</b> and invoke <b>Mesh Information</b>
-item from the \b Mesh menu or click <em>"Mesh Information"</em> button
+item from the \b Mesh menu or from the context menu, or click <em>"Mesh Information"</em> button
 in the toolbar. 
 
 <center>\image html image49.png
 <em>"Mesh Information" button</em></center>
 
 The <b>Mesh Information</b> dialog box provides three tab pages:
-- <b>\ref advanced_mesh_infos_anchor "Base Info"</b> - to show base
-information about the selected mesh object
+- <b>\ref advanced_mesh_infos_anchor "Base Info"</b> - to show
+  base and quantitative information about the selected mesh object.
 - <b>\ref mesh_element_info_anchor "Element Info"</b> - to show
-detailed information about the selected mesh node or element.
-- <b>\ref mesh_addition_info_anchor "Additional Info"</b> - to show additional information available
-for the selected mesh, sub-mesh or group object.
+  detailed information about the selected mesh nodes or elements.
+- <b>\ref mesh_addition_info_anchor "Additional Info"</b> - to show
+  additional information available for the selected mesh, sub-mesh or
+  group object. 
+- <b>\ref mesh_quality_info_anchor "Quality Info"</b> - to show
+  overall quality information about the selected mesh, sub-mesh or group
+  object. 
 
 \anchor advanced_mesh_infos_anchor
 <h2>Base Information</h2>
@@ -35,40 +39,42 @@ type: 0D elements, edges, faces, volumes, balls.
 \anchor mesh_element_info_anchor
 <h2>Mesh Element Information</h2> 
 
-The <b>Element Info</b> tab page of the dialog box gives detail
-information about selected mesh node(s) or element(s), namely:
+The <b>Element Info</b> tab page of the dialog box gives detailed
+information about the selected mesh node(s) or element(s), namely:
 
-- For node:
-  - Node ID
-  - Coordinates (X, Y, Z)
-  - Connectivity information (connected elements)
-  - Position on a shape (for meshes built on geometry)
-  - Groups information (names of groups the node belongs to)
+- For a node:
+  - Node ID;
+  - Coordinates (X, Y, Z);
+  - Connectivity information (connected elements); double click in
+    this line reveals information about these elements;
+  - Position on a shape (for meshes built on a geometry);
+  - Groups information (names of groups the node belongs to).
 
 <center>\image html eleminfo1.png
 <em>"Element Info" page, node information</em></center>
 <br>
 
-- For element:
-  - Element ID
-  - Type (triangle, quadrangle, etc...)
-  - Gravity center (X, Y, Z coordinates)
-  - Connectivity information (connected nodes)
-  - Quality controls (area, aspect ration, volume, etc)
-  - Position on a shape (for meshes built on geometry)
-  - Groups information (names of groups the element belongs to)
+- For an element:
+  - Element ID;
+  - Type (triangle, quadrangle, etc.);
+  - Gravity center (X, Y, Z coordinates);
+  - Connectivity information (connected nodes); double click in
+    a line of a node reveals the information about this node;
+  - Quality controls (area, aspect ratio, volume, etc.);
+  - Position on a shape (for meshes built on a geometry);
+  - Groups information (names of groups the element belongs to).
 
 <center>\image html eleminfo2.png 
 <em>"Element Info" page, element information</em></center>
 
-The use can either input the ID of a node or element he wants to
+The user can either input the ID of a node or element he wants to
 analyze directly in the dialog box or select the node(s) or element(s) in
 the 3D viewer.
 
-\note The information about the groups, the node or element belongs
-to, can be shown in short or detail form. By default, for performance
-reasons, this information is show in short form (group names
-only). Detail information on groups can be switched on via the user
+\note The information about the groups, to which the node or element belongs,
+ can be shown in a short or in a detailed form. By default, for performance
+reasons, this information is shown in a short form (group names
+only). The detailed information on groups can be switched on via the user
 preferences, see \ref mesh_preferences_page.
 
 \anchor mesh_addition_info_anchor
@@ -119,12 +125,44 @@ automatically calculated if the size of the group does not exceed
 the "Automatic nodes compute limit" set via the  "Mesh information"
 preferences (zero value means no limit).
 
+\anchor mesh_quality_info_anchor
+<h2>Quality Information</h2>
+
+The <b>Quality Info</b> tab provides overall information about mesh quality controls  on the selected object - mesh, sub-mesh or mesh group:
+- Name;
+- Nodes information:
+  - Number of free nodes;
+  - Maximal number of elements connected to a node;
+  - Number of double nodes;
+- Edges information:
+  - Number of double edges;
+- Faces information:
+  - Number of double faces;
+  - Number of over-constrained faces;
+  - Aspect Ratio histogram;
+- Volume information:
+  - Number of double volumes;
+  - Number of over-constrained volumes;
+  - Aspect Ratio 3D histogram.
+
+<center>\image html ctrlinfo.png
+<em>"Quality Info" page</em></center>
+
+\note It is possible to set "Double nodes tolerance" in the dialog for a local change 
+      or via the "Quality controls" in Mesh preferences.
+
+\note For performance reasons, all quality control values for big meshes are
+computed only by demand. For this, press the "compute"
+button. Also, values are automatically computed if the number of 
+nodes / elements does not exceed the "Automatic controls compute limit" set 
+via the "Mesh information" preferences (zero value means that there is no limit).
+
+\note The plot functionality is available only if the GUI module is built with Plot 2D Viewer (option SALOME_USE_PLOT2DVIEWER is ON when building GUI module).
+
 The button \b "Dump" allows printing the information displayed in the
-dialog box to the txt file.
+dialog box to a .txt file.
 
-In case you get <b>Mesh Information</b> via a TUI script, the information is
-displayed in the Python Console. 
-<b>See the</b> \ref tui_viewing_mesh_infos "TUI Example".
+See the \ref tui_viewing_mesh_infos "TUI Example".
 
 */