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