]> SALOME platform Git repositories - modules/smesh.git/blob - doc/salome/gui/SMESH/input/grouping_elements.rst
Salome HOME
2846fa94b3d18b37ddeddb15d280aafd084d19fc
[modules/smesh.git] / doc / salome / gui / SMESH / input / grouping_elements.rst
1 .. _grouping_elements_page:
2
3 *****************
4 Grouping elements
5 *****************
6
7 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.
8
9 There are three types of groups different by their internal organization:
10
11 #. **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.
12         .. warning:: Creation and edition of large standalone groups in :ref:`Create group <creating_groups_page>` dialog using manual edition is problematic due to poor performance of the dialog.
13   
14 #. **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.
15
16 #. **Group on filter** encapsulates a :ref:`filter <filters_page>`, 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.
17
18 The group on geometry and group on filter can be converted to a standalone group.
19
20 .. image:: ../images/groups_in_OB.png
21         :align: center
22
23 .. centered::
24         Groups of different types look differently in the Object Browser
25
26 The following ways of group creation are possible:
27
28 * :ref:`Create group <creating_groups_page>` dialog allows creation of a group of any type: :ref:`Standalone group<standalone_group>`, :ref:`Group on geometry <group_on_geom>` and :ref:`Group on filter <group_on_filter>` using dedicated tabs.
29 * :ref:`Create Groups from Geometry <create_groups_from_geometry_page>` dialog allows creation of several groups on geometry at once.
30 * :doc:`face_groups_by_sharp_edges` operation distributes all faces of the mesh among groups using sharp edges and/or existing 1D elements as group boundaries.
31 * 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).
32 * Standalone groups of any element type can be created basing on nodes of other groups - using :ref:`Group based on nodes of other groups <group_of_underlying_elements_page>` dialog.
33 * Standalone groups can be created by applying :ref:`Boolean operations <using_operations_on_groups_page>` to other groups.
34 * Creation of standalone groups is an option of many :ref:`mesh modification <modifying_meshes_page>` operations.
35
36 The created groups can be later:
37
38 * :ref:`Edited <editing_groups_page>`
39 * :ref:`Deleted <deleting_groups_page>`, either as an object or together with contained elements.
40 * The group on geometry and group on filter can be :ref:`converted into the standalone <convert_to_standalone>` group.
41 * :ref:`Exported <importing_exporting_meshes_page>` into a file as a whole mesh.
42
43 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. 
44
45 .. image:: ../images/smesh_sort_groups.png
46         :align: center
47
48 .. centered::
49         Sorting groups
50
51 An important tool, providing filters for creation of standalone groups and groups on filter is :ref:`selection_filter_library_page`.
52
53 **See Also** sample TUI Scripts of :doc:`tui_grouping_elements` operations.
54
55
56 **Table of Contents**
57
58 .. toctree::
59         :maxdepth: 2
60
61         creating_groups.rst
62         create_groups_from_geometry.rst
63         face_groups_by_sharp_edges.rst
64         group_of_underlying_elements.rst
65         using_operations_on_groups.rst
66         editing_groups.rst
67         deleting_groups.rst