doc/salome/gui/SMESH/input/grouping_elements.doc

   1 /*!
   2
   3 \page grouping_elements_page Grouping elements
   4
   5 In Mesh module it is possible to create groups of mesh entities:
   6 nodes, edges, faces, volumes, 0D elements or balls. One group contains
   7 elements of only one type. Groups, unlike sub-meshes, are exported
   8 along with mesh entities into the files of following formats: MED, UNV,
   9 and CGNS. The group has a color attribute which is used for
  10 visualization only and is not exported.
  11
  12 There are three types of groups different by their internal
  13 organization:<ol>
  14 <li><b>Standalone group</b> is a static set of mesh entities. Its
  15   contents can be explicitly controlled by the user. Upon removal of
  16   the entities included into the group, the group becomes empty and
  17   its content can be restored only manually. Hence it is
  18   reasonable to create standalone groups when the mesh generation is
  19   finished and mesh quality is verified.
  20   \warning Creation and edition of large standalone groups in
  21   \ref creating_groups_page "Create group" dialog using manual edition
  22   is problematic due to poor performance of the dialog.</li>
  23
  24 <li><b>Group on geometry</b> is associated to a sub-shape or a group of
  25   sub-shapes of the main shape and includes mesh entities generated on
  26   these geometrical entities. The association to a geometry is
  27   established at group construction and cannot be changed. The group
  28   contents are always updated automatically, hence the
  29   group can be created even before mesh elements generation.</li>
  30 <li><b>Group on filter</b> encapsulates a filter, which is used to
  31   select mesh entities composing the group from the whole
  32   mesh. Criteria of the filter can be changed at any time. The
  33   group contents are always updated automatically, hence
  34   the group can be created even before mesh elements generation.</li>
  35 </ol>
  36 The group on geometry and group on filter can be converted to
  37 a standalone group.
  38
  39 \image html groups_in_OB.png "Groups of different types look differently in the Object Browser"
  40
  41 The following ways of group creation are possible:
  42
  43 - \subpage creating_groups_page "Create group" dialog allows creation of
  44   a group of any type:
  45   \ref standalone_group "Standalone group",
  46   \ref group_on_geom "Group on geometry" and
  47   \ref group_on_filter "Group on filter" using dedicated tabs.
  48 - \subpage create_groups_from_geometry_page "Create Groups from Geometry"
  49   dialog allows creation of several groups on geometry at once.
  50 - Standalone groups of all nodes and elements of the chosen sub-mesh
  51   (type of elements depends on dimension of sub-mesh geometry) can
  52   be created using <b>Mesh -> Construct Group</b> menu item (available
  53   from the context menu as well).
  54 - Standalone groups of any element type can be created basing on nodes
  55   of other groups - using \subpage group_of_underlying_elements_page
  56   "Group based on nodes of other groups" dialog.
  57 - Standalone groups can be created by applying
  58   \subpage using_operations_on_groups_page "Boolean operations" to
  59   other groups.
  60 - Creation of standalone groups is an option of many
  61   \ref modifying_meshes_page "mesh modification" operations.
  62
  63 The created groups can be later:
  64
  65 - \subpage editing_groups_page "Edited"
  66 - \subpage deleting_groups_page "Deleted", either as an object or
  67   together with contained elements.
  68 - The group on geometry and group on filter can be
  69   \ref convert_to_standalone "converted into the standalone" group.
  70 - \ref importing_exporting_meshes_page "Exported" into a file as a
  71   whole mesh.
  72
  73 In the Object Browser, if an item contains more than one child group,
  74 it is possible to sort the groups by name in ascending order
  75 using <b>Sort children</b> context menu item.
  76
  77 \image html smesh_sort_groups.png "Sorting groups"
  78
  79 An important tool, providing filters for creation of standalone
  80 groups and groups on filter is \ref selection_filter_library_page.
  81
  82 */