X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fmesh_infos.doc;h=929deb8f3f34e98d1b8eb885ba7c8235fefecfb8;hb=3da8fefe9c957f4538e9eacf013ce678df4d6c91;hp=25982899502906cfecce822f2a70c9dccd99e83b;hpb=79b1ac2b6df9117f16f11d444b1f165d477a1813;p=modules%2Fsmesh.git
diff --git a/doc/salome/gui/SMESH/input/mesh_infos.doc b/doc/salome/gui/SMESH/input/mesh_infos.doc
index 259828995..929deb8f3 100644
--- a/doc/salome/gui/SMESH/input/mesh_infos.doc
+++ b/doc/salome/gui/SMESH/input/mesh_infos.doc
@@ -1,63 +1,170 @@
/*!
-\page mesh_infos_page Mesh infos
+\page mesh_infos_page Mesh Information
-\n There are three information boxes: Standard Mesh
-Infos, Advanced Mesh Infos and Mesh Element Info.
+The user can obtain information about the selected mesh object
+(mesh, sub-mesh or group) using Mesh Information dialog box.
-
-\anchor standard_mesh_infos_anchor
-
Standard Mesh Infos
-
-The Standard Mesh Infos box gives only the information on the
-number of elements of maximum dimension and the number of nodes in the
-mesh. However, from this Info you can learn about groups selected on
-this mesh.
-\n To view the Standard Mesh Infos, select your mesh or submesh
-in the Object Browser and select Standard Mesh Infos
-from the \b Mesh menu or click "Standard Mesh Infos" button
+To view the Mesh Information, select your mesh, sub-mesh or
+group in the Object Browser and invoke Mesh Information
+item from the \b Mesh menu or click "Mesh Information" button
in the toolbar.
-\image html image49.gif
-"Standard Mesh Infos" button
-
-The following information will be displayed:
-
-\image html a-standmeshinfo.png
+\image html image49.png
+"Mesh Information" button
+
+The Mesh Information dialog box provides three tab pages:
+- \ref advanced_mesh_infos_anchor "Base Info" - to show
+ base and quantitative information about the selected mesh object.
+- \ref mesh_element_info_anchor "Element Info" - to show
+ detailed information about the selected mesh nodes or elements.
+- \ref mesh_addition_info_anchor "Additional Info" - to show
+ additional information available for the selected mesh, sub-mesh or
+ group object.
+- \ref mesh_quality_info_anchor "Quality Info" - to show
+ overall quality information about the selected mesh, sub-mesh or group
+ object.
-
\anchor advanced_mesh_infos_anchor
-Advanced Mesh Infos
+Base Information
-The Advanced Mesh Infos box gives more information about the mesh,
-including the total number of faces and volumes and their geometrical
-types.
-\n To view the Advanced Mesh Infos, select your mesh or submesh
-in the Object Browser and select Advanced Mesh Infos
-from the \b Mesh menu or click "Advanced Mesh Infos" button
-in the toolbar.
+The Base Info tab page of the dialog box provides general
+information on the selected object - mesh, sub-mesh or mesh group:
+name, type, total number of nodes and elements separately for each
+type: 0D elements, edges, faces, volumes, balls.
-\image html image50.gif
-"Advanced Mesh Infos" button
+\image html advanced_mesh_infos.png
+"Base Info" page
-The following information will be displayed:
+\anchor mesh_element_info_anchor
+Mesh Element Information
-\image html advanced_mesh_infos.png
+The Element Info tab page of the dialog box gives detailed
+information about the selected mesh node(s) or element(s), namely:
-In case you get Mesh Infos via a \ref tui_viewing_mesh_infos "TUI script",
-the information is displayed in Python Console.
+- 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).
-\image html b-mesh_infos.png
+\image html eleminfo1.png
+"Element Info" page, node information
+
+- 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 ration, volume, etc.);
+ - Position on a shape (for meshes built on a geometry);
+ - Groups information (names of groups the element belongs to).
+
+\image html eleminfo2.png
+"Element Info" page, element information
+
+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, 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
+Additional Information
+
+The Additional Info tab page of the dialog box provides an
+additional information on the selected object: mesh, sub-mesh or
+group.
+
+For a mesh object, the following information is shown:
+- Name
+- Type: based on geomerty, imported, standalone
+- Shape (if mesh is based on geometry)
+- File (if mesh is imported from the file)
+- Groups
+- Sub-meshes
+
+\image html addinfo_mesh.png
+"Additional Info" page, mesh information
-\anchor mesh_element_info_anchor
-Mesh Element Info
-The Mesh Element Info box gives basic information about the
-type and the coordinates of the selected mesh element.
+For a sub-mesh object, the following information is shown:
+- Name
+- Parent mesh
+- Shape
-\image html eleminfo1.png
+\image html addinfo_submesh.png
+"Additional Info" page, sub-mesh information
+
-\image html eleminfo2.png
+For a group object, the following information is shown:
+- Name
+- Parent mesh
+- Type: standalone, group on geometry, group on filter
+- Entity type: node, edge, face, volume
+- Size
+- Color
+- Number of underlying nodes (for non-nodal groups)
+
+\image html addinfo_group.png
+"Additional Info" page, group information
+
-*/
\ No newline at end of file
+\note For the performance reasons, the number of underlying nodes is
+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).
+
+\anchor mesh_quality_info_anchor
+Quality Information
+
+The Quality Info 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;
+ - 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.
+
+\image html ctrlinfo.png
+"Quality Info" page
+
+\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 a .txt file.
+
+In case you get Mesh Information via a TUI script, the information is
+displayed in the Python Console.
+
+See the \ref tui_viewing_mesh_infos "TUI Example".
+
+*/
+