X-Git-Url: http://git.salome-platform.org/gitweb/?p=modules%2Fsmesh.git;a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fmesh_infos.doc;h=e20375251f09ea41831b53b21eaf3d70f918a857;hp=25982899502906cfecce822f2a70c9dccd99e83b;hb=204a3246f4d94d4375bdac7391bec2b3ab49e0d9;hpb=79b1ac2b6df9117f16f11d444b1f165d477a1813 diff --git a/doc/salome/gui/SMESH/input/mesh_infos.doc b/doc/salome/gui/SMESH/input/mesh_infos.doc index 259828995..e20375251 100644 --- a/doc/salome/gui/SMESH/input/mesh_infos.doc +++ b/doc/salome/gui/SMESH/input/mesh_infos.doc @@ -1,63 +1,183 @@ /*! -\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 from the context 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 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 -

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 ratio, 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. + +If Show IDs 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 +

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 +\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) + +
\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 \ref nb_nodes_limit_pref "Automatic nodes compute limit" +preference value (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; + - 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. + +
\image html ctrlinfo.png +"Quality Info" page
+ +\note It is possible to change Double nodes tolerance, 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". + +*/ +