Salome HOME
Merge remote-tracking branch 'origin/master' into V9_dev
[modules/smesh.git] / doc / salome / gui / SMESH / input / mesh_infos.doc
index d446d2e9d9ed1350f4f11707f4ae58b1353d29bd..e20375251f09ea41831b53b21eaf3d70f918a857 100644 (file)
@@ -7,21 +7,30 @@ 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.
+  overall quality information about the selected mesh, sub-mesh or group
+  object. 
+
+\anchor dump_mesh_infos
+The button \b Dump allows printing the information displayed in the
+dialog box to a .txt file. The dialog for choosing a file also allows
+to select which tab pages to dump via four check-boxes. The default state
+of the check-boxes can be changed via \ref mesh_information_pref "Mesh information"
+preferences.
 
 \anchor advanced_mesh_infos_anchor
 <h2>Base Information</h2>
@@ -43,7 +52,8 @@ information about the selected mesh node(s) or element(s), namely:
 - For a node:
   - Node ID;
   - Coordinates (X, Y, Z);
-  - Connectivity information (connected elements);
+  - 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).
 
@@ -55,23 +65,28 @@ information about the selected mesh node(s) or element(s), namely:
   - Element ID;
   - Type (triangle, quadrangle, etc.);
   - Gravity center (X, Y, Z coordinates);
-  - Connectivity information (connected nodes);
-  - Quality controls (area, aspect ration, volume, etc.);
+  - 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.
 
+If <b>Show IDs</b> is activated, IDs of selected nodes or elements are
+displayed in the 3D viewer.
+
 \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
+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.
+only). The detailed information on groups can be switched on via
+\ref group_detail_info_pref "Show details on groups in element information tab"
+option of \ref mesh_preferences_page.
 
 \anchor mesh_addition_info_anchor
 <h2>Additional Information</h2> 
@@ -101,6 +116,7 @@ For a sub-mesh object, the following information is shown:
 <em>"Additional Info" page, sub-mesh information</em></center>
 <br>
 
+\anchor mesh_addition_info_group_anchor
 For a group object, the following information is shown:
 - Name
 - Parent mesh
@@ -118,18 +134,17 @@ For a group object, the following information is shown:
 computed only by demand. For this, the user should press the "Compute"
 button (see picture). Also, the number of underlying nodes is
 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).
+the \ref nb_nodes_limit_pref "Automatic nodes compute limit"
+preference value (zero value means no limit).
 
 \anchor mesh_quality_info_anchor
 <h2>Quality Information</h2>
 
-The <b>Quality Info</b> tab page of the dialog box provides overal
-mesh quality controls information on the selected object - mesh, 
-sub-mesh or mesh group:
+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 the free nodes;
+  - Number of free nodes;
+  - Maximal number of elements connected to a node;
   - Number of double nodes;
 - Edges information:
   - Number of double edges;
@@ -145,21 +160,24 @@ sub-mesh or mesh group:
 <center>\image html ctrlinfo.png
 <em>"Quality Info" page</em></center>
 
-\note User can set "Double nodes tolerance" in the dialog for local change 
-      or via the "Quality controls" in Mesh preferences.
+\note It is possible to change <b>Double nodes tolerance</b>, which
+will be used upon consequent pressing \a Compute button. The default value
+of the tolerance can be set via the
+\ref dbl_nodes_tol_pref "Quality controls" preferences.
 
-\note For the perfomance reason, all quality control values for the big meshes are
-computed only by demand. For this, the user should press the "compute"
-button (see picture). Also, values are automatically computed if the number of the 
-nodes / elements does not exceed the "Automatic controls compute limit" set 
-via the "Mesh information" preferences (zero value means no limit).
+\note For performance reasons, all quality control values for big
+meshes are computed only by demand. For this, press the \a Compute
+button. Also, values are automatically computed if the number of nodes
+/ elements does not exceed the
+\ref auto_control_limit_pref "Automatic controls compute limit" set
+via the \ref mesh_information_pref "Mesh information" preferences
+(zero value means that there is no limit).
 
-The button \b "Dump" allows printing the information displayed in the
-dialog box to a .txt file.
+\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).
 
-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".
 
 */