X-Git-Url: http://git.salome-platform.org/gitweb/?p=modules%2Fsmesh.git;a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fgrouping_elements.doc;h=7d738c8ee1710622da4519766013dc3febd87f41;hp=9615ad4c39b858009442b9ac7afc3716e174520b;hb=1a88a8f6658e4663f7bacfd6be57b7a3cbaa7248;hpb=bd4e115a78b52e3fbc016e5e30bb0e19b2a9e7d6 diff --git a/doc/salome/gui/SMESH/input/grouping_elements.doc b/doc/salome/gui/SMESH/input/grouping_elements.doc index 9615ad4c3..7d738c8ee 100644 --- a/doc/salome/gui/SMESH/input/grouping_elements.doc +++ b/doc/salome/gui/SMESH/input/grouping_elements.doc @@ -2,37 +2,82 @@ \page grouping_elements_page Grouping elements -In Mesh module it is possible to create groups of mesh elements: -nodes, edges, faces or volumes. One group contains elements of only -one type. The following ways of creation are possible: - -- by selecting the elements using filters and/or directly on the - presentation in the VTK viewer, and/or by using elements of other - mesh objects - \ref standalone_group "Standalone group" - tab of \ref creating_groups_page "Create group" dialog. -- by creating a group of elements generated on the chosen geometrical - object - \ref group_on_geom "Group on geometry" tab of - \subpage creating_groups_page "Create group" dialog and - \subpage create_groups_from_geometry_page "Create Groups from Geometry" - dialog. -- by creating a group of elements satisfying to certain criteria - - \ref group_on_filter "Group on filter" tab of - \subpage creating_groups_page "Create group" dialog. -- by creating groups of nodes and elements from the chosen submesh - (type of elements depends on dimension of submesh geometry) - - using Mesh -> Construct Group menu item (available in context - menu as well). -- by creating groups of entities from existing groups of superior - dimensions - using \subpage group_of_underlying_elements_page - "Create Group of Underlying Elements" dialog. +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:
    +
  1. 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, e.g. due to modification of + meshing parameter, 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.
    2. + +
  2. 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.
    3. +
  3. Group on filter encapsulates a \ref filters_page "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.
    4. +
+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" -- \subpage deleting_groups_page "Deleted" +- \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. + +\image html smesh_sort_groups.png "Sorting groups" -An important tool, providing filters for creation of \b Standalone -groups is \ref selection_filter_library_page. +An important tool, providing filters for creation of standalone +groups and groups on filter is \ref selection_filter_library_page. */