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=8222f1764affd920a3728ef928d401e2350c8bd3;hp=25982899502906cfecce822f2a70c9dccd99e83b;hb=7084b4f9799cf4a0145ba86ab8b653de8f2d2bdb;hpb=79b1ac2b6df9117f16f11d444b1f165d477a1813 diff --git a/doc/salome/gui/SMESH/input/mesh_infos.doc b/doc/salome/gui/SMESH/input/mesh_infos.doc index 259828995..8222f1764 100644 --- a/doc/salome/gui/SMESH/input/mesh_infos.doc +++ b/doc/salome/gui/SMESH/input/mesh_infos.doc @@ -1,63 +1,166 @@ /*! -\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 click "Mesh Information" button in the toolbar. -\image html image49.gif -
"Standard Mesh Infos" button
- -The following information will be displayed: +
\image html image49.png +"Mesh Information" button
-\image html a-standmeshinfo.png +The Mesh Information dialog box provides three tab pages: +- \ref advanced_mesh_infos_anchor "Base Info" - to show base +information about the selected mesh object. +- \ref mesh_element_info_anchor "Element Info" - to show +detailed information about the selected mesh node or element. +- \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 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); + - 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); + - Quality controls (area, aspect ration, 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 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, 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 the user +preferences, see \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 +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 "Automatic nodes compute limit" set via the "Mesh information" +preferences (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; + - 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 set "Double nodes tolerance" in the dialog for a local change + or via the "Quality controls" in Mesh preferences. + +\note 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 "Automatic controls compute limit" set +via the "Mesh information" preferences (zero value means that there is no limit). + +\note The plot functionality is available only if GUI module is builded with Plot 2D Viewer (set option SALOME_USE_PLOT2DVIEWER to ON when building GUI module). + +The button \b "Dump" allows printing the information displayed in the +dialog box to a .txt file. + +In case you get Mesh Information via a TUI script, the information is +displayed in the Python Console. + +See the \ref tui_viewing_mesh_infos "TUI Example". + +*/ +