smesh/doc/salome/gui/SMESH/input/mesh_infos.doc
eap 913aaa14de Fix crash of SALOME_TESTS/Grids/smesh/bugs_13/N9
(SMDS_VolumeTool.cxx)

Add "Show IDs" check box to Mesh Information dlg

Avoid warning in Choose Entity dialog when no entities are selected,
disable [OK] button instead
2017-02-10 21:20:38 +03:00

184 lines
6.5 KiB
Plaintext

/*!
\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 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 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 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.
\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>
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 detailed
information about the selected mesh node(s) or element(s), namely:
- 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).
<center>\image html eleminfo1.png
<em>"Element Info" page, node information</em></center>
<br>
- 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 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 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
reasons, 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 "Show details on groups in element information tab"
option of \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>
\anchor mesh_addition_info_group_anchor
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 \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 provides overall information about mesh quality controls on the selected object - mesh, sub-mesh or mesh group:
- Name;
- Nodes information:
- Number of free nodes;
- Maximal number of elements connected to a node;
- 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.
<center>\image html ctrlinfo.png
<em>"Quality Info" page</em></center>
\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 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).
\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).
See the \ref tui_viewing_mesh_infos "TUI Example".
*/