doc/salome/gui/SMESH/input/mesh_infos.rst

   1 .. _mesh_infos_page:
   2
   3 ****************
   4 Mesh Information
   5 ****************
   6
   7 The user can obtain information about the selected mesh object (mesh, sub-mesh or group) using **Mesh Information** dialog box.
   8
   9 .. |img| image:: ../images/image49.png
  10
  11 To view the **Mesh Information**, select your mesh, sub-mesh or group in the **Object Browser** and invoke **Mesh Information** item from the **Mesh** menu or from the context menu, or click *"Mesh Information"* button |img| in the toolbar.
  12
  13
  14 The **Mesh Information** dialog box provides three tab pages:
  15
  16 * :ref:`Base Info <advanced_mesh_infos_anchor>` - to show base and quantitative information about the selected mesh object.
  17 * :ref:`Element Info <mesh_element_info_anchor>` - to show detailed information about the selected mesh nodes or elements.
  18 * :ref:`Additional Info <mesh_addition_info_anchor>` - to show additional information available for the selected mesh, sub-mesh or group object.
  19 * :ref:`Quality Info <mesh_quality_info_anchor>` - to show overall quality information about the selected mesh, sub-mesh or group object.
  20
  21 .. _dump_mesh_infos:
  22
  23 Dump Mesh Infos
  24 ###############
  25
  26 The button **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 <mesh_information_pref>` preferences.
  27
  28 .. _advanced_mesh_infos_anchor:
  29
  30 Base Information
  31 ################
  32
  33 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.
  34
  35 .. image:: ../images/advanced_mesh_infos.png
  36         :align: center
  37
  38 .. centered::
  39         *"Base Info"* page
  40
  41 .. _mesh_element_info_anchor:
  42
  43 Mesh Element Information
  44 ########################
  45
  46 The **Element Info** tab page of the dialog box gives detailed information about the selected mesh node(s) or element(s), namely:
  47
  48 * For a node:
  49         * Node ID;
  50         * Coordinates (X, Y, Z);
  51         * Connectivity information (connected elements); double click in this line reveals information about these elements;
  52         * Position on a shape (for meshes built on a geometry);
  53         * Groups information (names of groups the node belongs to).
  54
  55         .. image:: ../images/eleminfo1.png
  56                 :align: center
  57
  58         .. centered::
  59                 *"Element Info"* page, node information
  60
  61
  62 * For an element:
  63         * Element ID;
  64         * Type (triangle, quadrangle, etc.);
  65         * Gravity center (X, Y, Z coordinates);
  66         * Connectivity information (connected nodes); double click in a line of a node reveals the information about this node;
  67         * Quality controls (area, aspect ratio, volume, etc.);
  68         * Position on a shape (for meshes built on a geometry);
  69         * Groups information (names of groups the element belongs to).
  70
  71         .. image:: ../images/eleminfo2.png
  72                 :align: center
  73
  74         .. centered::
  75                 *"Element Info"* page, element information
  76
  77 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.
  78
  79 If **Show IDs** is activated, IDs of selected nodes or elements are displayed in the 3D viewer.
  80
  81 .. note::
  82         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 rasons, this information is shown in a short form (group names only). The detailed information on groups can be switched on via :ref:`Show details on groups in element information tab <group_detail_info_pref>` option of :ref:`mesh_preferences_page`.
  83
  84 .. _mesh_addition_info_anchor:
  85
  86 Additional Information
  87 ######################
  88
  89 The **Additional Info** tab page of the dialog box provides an additional information on the selected object: mesh, sub-mesh or group.
  90
  91 For a mesh object, the following information is shown:
  92
  93 * Name
  94 * Type: based on geomerty, imported, standalone
  95 * Shape (if mesh is based on geometry)
  96 * File (if mesh is imported from the file)
  97 * Groups
  98 * Sub-meshes
  99
 100 .. image:: ../images/addinfo_mesh.png
 101         :align: center
 102
 103 .. centered::
 104         *"Additional Info"* page, mesh information
 105
 106
 107 For a sub-mesh object, the following information is shown:
 108
 109 * Name
 110 * Parent mesh
 111 * Shape
 112
 113 .. image:: ../images/addinfo_submesh.png
 114         :align: center
 115
 116 .. centered::
 117         *"Additional Info"* page, sub-mesh information
 118
 119
 120 .. _mesh_addition_info_group_anchor:
 121
 122 Additional info for Group
 123 =========================
 124
 125 For a group object, the following information is shown:
 126
 127 * Name
 128 * Parent mesh
 129 * Type: standalone, group on geometry, group on filter
 130 * Entity type: node, edge, face, volume
 131 * Size
 132 * Color
 133 * Number of underlying nodes (for non-nodal groups)
 134
 135 .. image:: ../images/addinfo_group.png
 136         :align: center
 137
 138 .. centered::
 139         *"Additional Info"* page, group information
 140
 141
 142 .. note::
 143         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 :ref:`Automatic nodes compute limit <nb_nodes_limit_pref>` preference value (zero value means no limit).
 144
 145 .. _mesh_quality_info_anchor:
 146
 147 Quality Information
 148 ###################
 149
 150 The **Quality Info** tab provides overall information about mesh quality controls  on the selected object - mesh, sub-mesh or mesh group:
 151
 152 * Name;
 153 * Nodes information:
 154         * Number of free nodes;
 155         * Maximal number of elements connected to a node;
 156         * Number of double nodes;
 157 * Edges information:
 158         * Number of double edges;
 159 * Faces information:
 160         * Number of double faces;
 161         * Number of over-constrained faces;
 162         * Aspect Ratio histogram;
 163 * Volume information:
 164         * Number of double volumes;
 165         * Number of over-constrained volumes;
 166         * Aspect Ratio 3D histogram.
 167
 168 .. image:: ../images/ctrlinfo.png
 169         :align: center
 170
 171 .. centered::
 172         *"Quality Info"* page
 173
 174 .. note::
 175         It is possible to change **Double nodes tolerance**, which will be used upon consequent pressing *Compute* button. The default value of the tolerance can be set via the :ref:`Quality controls <dbl_nodes_tol_pref>` preferences.
 176
 177 .. note::
 178         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 :ref:`Automatic controls compute limit <auto_control_limit_pref>` set via the :ref:`Mesh information <mesh_information_pref>` preferences (zero value means that there is no limit).
 179
 180 .. note::
 181         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).
 182
 183 See the :ref:`TUI Example <tui_viewing_mesh_infos>`.
 184
 185
 186