Salome HOME
Precise doc on sub-mesh priority
[modules/smesh.git] / doc / salome / gui / SMESH / input / using_operations_on_groups.rst
1 .. _using_operations_on_groups_page: 
2
3 ****************************
4 Boolean operations on groups
5 ****************************
6
7 In MESH you can perform some Boolean operations on groups, which belong to one and the same mesh.
8
9 * :ref:`union_anchor`
10 * :ref:`intersection_anchor`
11 * :ref:`cut_anchor` 
12
13
14
15
16 .. _union_anchor:
17
18 Union of groups
19 ###############
20
21 This operation allows to create a new group in such a way that all
22 mesh elements that are present in the initial groups will be added to
23 the new one.
24
25 *To union groups:*
26
27 #. In the **Mesh** menu select the **Union Groups** item. The following dialog box will appear:
28
29         .. image:: ../images/uniongroups.png
30                 :align: center                                                 
31
32    In this dialog box you should specify the name of the resulting group and set of groups which will be united.
33
34    For example, we have two groups Group1 and Group2. 
35    The result of their **Union** will be Group12:
36
37         .. image:: ../images/image133.gif
38                 :align: center
39
40         .. centered::
41                 Group1
42
43         .. image:: ../images/image134.gif
44                 :align: center
45
46         .. centered::
47                 Group2
48
49         .. image:: ../images/image135.gif
50                 :align: center
51
52         .. centered::
53                 Group12
54
55 #. Click the **Apply** or **Apply and Close** button to confirm creation of the group.
56
57
58 **See Also** a sample TUI Script of a :ref:`tui_union_of_groups` operation.
59
60
61 .. _intersection_anchor:
62
63 Intersection of groups
64 ######################
65
66 This operation allows to create a new group in such a way that all
67 mesh elements that are present in all initial groups together are added to the
68 new one.
69
70 *To intersect groups:*
71
72 #. In the **Mesh** menu select the **Intersect Groups** item. The following dialog box will appear:
73
74         .. image:: ../images/intersectgroups.png
75                 :align: center                                                 
76
77    In this dialog box you should specify the name of the resulting group and set of groups which will be intersected.
78
79    For example, we have two groups Group1 and Group2. 
80    The result of their **Intersection** will be Group12a:
81
82         .. image:: ../images/image133.gif
83                 :align: center
84
85         .. centered::
86                 Group1
87
88         .. image:: ../images/image134.gif
89                 :align: center
90
91         .. centered::
92                 Group2
93
94         .. image:: ../images/image136.gif
95                 :align: center
96
97         .. centered::
98                 Group12a
99
100 #. Click the **Apply** or **Apply and Close** button to confirm creation of the group.
101
102
103 **See Also** a sample TUI Script of an :ref:`tui_intersection_of_groups` operation.  
104
105
106 .. _cut_anchor:
107
108 Cut of groups
109 #############
110
111 This operation allows to create a new group in such a way that all
112 mesh elements that are present in the main groups but are absent in the
113 tool groups are added to the new one.
114
115 *To cut groups:*
116
117 #. In the **Mesh** menu select the **Cut Groups** item. The following dialog box will appear:
118
119         .. image:: ../images/cutgroups.png
120                 :align: center                                                 
121
122    In this dialog box you should specify the name of the resulting group and groups which will be cut.
123
124    For example, we have two groups Group1 and Group2. 
125    The result of their **Cut** will be Group12b:
126
127         .. image:: ../images/image133.gif
128                 :align: center
129
130         .. centered::
131                 Group1
132
133         .. image:: ../images/image134.gif
134                 :align: center
135
136         .. centered::
137                 Group2
138
139         .. image:: ../images/image137.gif
140                 :align: center
141
142         .. centered::
143                 Group12b
144
145 #. Click the **Apply** or **Apply and Close** button to confirm creation of the group.
146
147
148 **See Also** a sample TUI Script of a :ref:`tui_cut_of_groups` operation.  
149
150