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

/*!

\page mesh_infos_page Mesh Information

The user can obtain information about the selected mesh object
(mesh, sub-mesh or group) using <b>Mesh Information</b> dialog box.

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
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 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.

\anchor advanced_mesh_infos_anchor
<h2>Base Information</h2>

The <b>Base Info</b> 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.

<center>\image html advanced_mesh_infos.png
<em>"Base Info" page</em></center>

\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:

- 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)

<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)

<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
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
preferences, see \ref mesh_preferences_page.

\anchor mesh_addition_info_anchor
<h2>Additional Information</h2> 

The <b>Additional Info</b> 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

<center>\image html addinfo_mesh.png
<em>"Additional Info" page, mesh information</em></center>
<br>

For a sub-mesh object, the following information is shown:
- Name
- Parent mesh
- Shape

<center>\image html addinfo_submesh.png
<em>"Additional Info" page, sub-mesh information</em></center>
<br>

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)

<center>\image html addinfo_group.png
<em>"Additional Info" page, group information</em></center>
<br>

\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).

The button \b "Dump" allows printing the information displayed in the
dialog box to the 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".

*/