Salome HOME
Merge from V6_main_20120808 08Aug12
[modules/smesh.git] / doc / salome / gui / SMESH / input / mesh_infos.doc
index 37a3deaf48a66d997bcfaa4391e35a207da8fcaf..06a02d2cc1d90d5d356fe5badf49f6016df7b5a7 100644 (file)
 /*!
 
-\page mesh_infos_page Mesh infos
+\page mesh_infos_page Mesh Information
 
-\n There are three information boxes: <b>Standard Mesh
-Infos</b>, <b>Advanced Mesh Infos</b> and <b> Mesh Element Info</b>.
+The user can obtain information about the selected mesh object
+(mesh, sub-mesh or group) using <b>Mesh Information</b> dialog box.
 
-<br>
-\anchor standard_mesh_infos_anchor
-<h2>Standard Mesh Infos</h2>
-
-The <b>Standard Mesh Infos</b> 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 <b>Standard Mesh Infos</b>, select your mesh or submesh
-in the <b>Object Browser</b> and select <b>Standard Mesh Infos</b>
-from the \b Mesh menu or click <em>"Standard Mesh Infos"</em> button
+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. 
 
 \image html image49.png
-<center><em>"Standard Mesh Infos" button</em></center>
+<center><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.
 
-The following information will be displayed:
+\anchor advanced_mesh_infos_anchor
+<h2>Base Information</h2>
 
-\image html a-standmeshinfo.png
+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 and volumes.
+
+\image html advanced_mesh_infos.png
+<center><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 basic
+information about the type, coordinates and connectivity of the
+selected mesh node or element.
+
+\image html eleminfo1.png
+<center><em>"Element Info" page, node information</em></center>
 <br>
-\anchor advanced_mesh_infos_anchor
-<h2>Advanced Mesh Infos</h2>
+\image html eleminfo2.png 
+<center><em>"Element Info" page, element information</em></center>
 
-The <b>Advanced Mesh Infos</b> box gives more information about the mesh,
-including the total number of faces and volumes and their geometrical
-types.
-\n To view the <b>Advanced Mesh Infos</b>, select your mesh or submesh
-in the <b>Object Browser</b> and select <b>Advanced Mesh Infos</b>
-from the \b Mesh menu or click <em>"Advanced Mesh Infos"</em> button
-in the toolbar.
+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 or element in
+the 3D viewer.
 
-\image html image50.gif
-<center><em>"Advanced Mesh Infos" button</em></center>
+\anchor mesh_addition_info_anchor
+<h2>Additional Information</h2> 
 
-The following information will be displayed:
+The <b>Additional Info</b> tab page of the dialog box provides an
+additional information on the selected object: mesh, sub-mesh or
+group.
 
-\image html advanced_mesh_infos.png
+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
 
-In case you get Mesh Infos via a \ref tui_viewing_mesh_infos "TUI script", 
-the information is displayed in Python Console.
+\image html addinfo_mesh.png
+<center><em>"Additional Info" page, mesh information</em></center>
+<br>
 
-\image html b-mesh_infos.png
+For a sub-mesh object, the following information is shown:
+- Name
+- Parent mesh
+- Shape
 
+\image html addinfo_submesh.png
+<center><em>"Additional Info" page, sub-mesh information</em></center>
 <br>
-\anchor mesh_element_info_anchor
-<h2>Mesh Element Info</h2> 
 
-The <b>Mesh Element Info</b> box gives basic information about the
-type and the coordinates of the selected mesh element.
-\n It is possible to input the Element ID or to select the Element in
-the Viewer.
+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
+<center><em>"Additional Info" page, group information</em></center>
+<br>
 
-\image html eleminfo1.png
+\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).
 
-\image html eleminfo2.png 
+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".
 
-*/
\ No newline at end of file
+*/
+