X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fgrouping_elements.doc;h=9548913da3b29ca9e8f5cf1a044b0c0bf8b67c6a;hb=ada19000459ece97c85c84af0711d3401b9a3dae;hp=56fe14c0db029ceefc65a64956055a8e2ba24249;hpb=0635c9fc80f67d1e5dc0e94ec85f487286a92070;p=modules%2Fsmesh.git
diff --git a/doc/salome/gui/SMESH/input/grouping_elements.doc b/doc/salome/gui/SMESH/input/grouping_elements.doc
index 56fe14c0d..9548913da 100644
--- a/doc/salome/gui/SMESH/input/grouping_elements.doc
+++ b/doc/salome/gui/SMESH/input/grouping_elements.doc
@@ -2,30 +2,81 @@
\page grouping_elements_page Grouping elements
-In Mesh module it is possible to \subpage creating_groups_page "create groups of mesh elements":
-nodes, edges, faces or volumes:
-
-- by selecting the elements of the specified kind by their IDs or
-directly on the presentation in the VTK viewer - Standalone group tab of Create group
-dialog.
-- by creating a group of elements of the selected type from all
-such elements of the chosen geometrical object - Group on
-geometry tab of Create group dialog.
-- by creating several groups of elements (nodes,
-edges, faces and volumes) from the chosen submesh - using Mesh -> Construct
-Group Menu item. In this case groups of elements are created automatically.
-
+In Mesh module it is possible to create groups of mesh entities:
+nodes, edges, faces, volumes, 0D elements or balls. One group contains
+elements of only one type. Groups, unlike sub-meshes, are exported
+along with mesh entities into the files of following formats: MED, UNV,
+and CGNS. The group has a color attribute which is used for
+visualization only and is not exported.
+
+There are three types of groups different by their internal
+organization:
+- Standalone group is a static set of mesh entities. Its
+ contents can be explicitly controlled by the user. Upon removal of
+ the entities included into the group, the group becomes empty and
+ its content can be restored only manually. Hence it is
+ reasonable to create standalone groups when the mesh generation is
+ finished and mesh quality is verified.
+ \warning Creation and edition of large standalone groups in
+ \ref creating_groups_page "Create group" dialog using manual edition
+ is problematic due to poor performance of the dialog.
+
+- Group on geometry is associated to a sub-shape or a group of
+ sub-shapes of the main shape and includes mesh entities generated on
+ these geometrical entities. The association to a geometry is
+ established at group construction and cannot be changed. The group
+ contents are always updated automatically, hence the
+ group can be created even before mesh elements generation.
+- Group on filter encapsulates a filter, which is used to
+ select mesh entities composing the group from the whole
+ mesh. Criteria of the filter can be changed at any time. The
+ group contents are always updated automatically, hence
+ the group can be created even before mesh elements generation.
+
+The group on geometry and group on filter can be converted to
+a standalone group.
+
+\image html groups_in_OB.png "Groups of different types look differently in the Object Browser"
+
+The following ways of group creation are possible:
+
+- \subpage creating_groups_page "Create group" dialog allows creation of
+ a group of any type:
+ \ref standalone_group "Standalone group",
+ \ref group_on_geom "Group on geometry" and
+ \ref group_on_filter "Group on filter" using dedicated tabs.
+- \subpage create_groups_from_geometry_page "Create Groups from Geometry"
+ dialog allows creation of several groups on geometry at once.
+- Standalone groups of all nodes and elements of the chosen sub-mesh
+ (type of elements depends on dimension of sub-mesh geometry) can
+ be created using Mesh -> Construct Group menu item (available
+ from the context menu as well).
+- Standalone groups of any element type can be created basing on nodes
+ of other groups - using \subpage group_of_underlying_elements_page
+ "Group based on nodes of other groups" dialog.
+- Standalone groups can be created by applying
+ \subpage using_operations_on_groups_page "Boolean operations" to
+ other groups.
+- Creation of standalone groups is an option of many
+ \ref modifying_meshes_page "mesh modification" operations.
The created groups can be later:
-
-- \subpage editing_groups_page "Edited"
-- \subpage using_operations_on_groups_page "Subjected to Boolean operations", or
-- \subpage deleting_groups_page "Deleted"
-
+- \subpage editing_groups_page "Edited"
+- \subpage deleting_groups_page "Deleted", either as an object or
+ together with contained elements.
+- The group on geometry and group on filter can be
+ \ref convert_to_standalone "converted into the standalone" group.
+- \ref importing_exporting_meshes_page "Exported" into a file as a
+ whole mesh.
+
+In the Object Browser, if an item contains more than one child group,
+it is possible to sort the groups by name in ascending order
+using Sort children context menu item.
-An important tool, providing filters for creation of \b Standalone
-groups is \subpage selection_filter_library_page.
+\image html smesh_sort_groups.png "Sorting groups"
+An important tool, providing filters for creation of standalone
+groups and groups on filter is \ref selection_filter_library_page.
*/