Salome HOME
0023546: [EDF] AsterStudy: add a method to Python API to show/hide orientation vector...
[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
36         The result of their **Union** will be Group12:
37
38         .. image:: ../images/image133.gif
39                 :align: center
40
41         .. centered::
42                 Group1
43
44         .. image:: ../images/image134.gif
45                 :align: center
46
47         .. centered::
48                 Group2
49
50         .. image:: ../images/image135.gif
51                 :align: center
52
53         .. centered::
54                 Group12
55
56 #. Click the **Apply** or **Apply and Close** button to confirm creation of the group.
57
58
59 **See Also** a sample TUI Script of a 
60 :ref:`tui_union_of_groups` operation.
61
62
63 .. _intersection_anchor:
64
65 Intersection of groups
66 ######################
67
68 This operation allows to create a new group in such a way that all
69 mesh elements that are present in all initial groups together are added to the
70 new one.
71
72 **To intersect groups:**
73
74 #. In the **Mesh** menu select the **Intersect Groups** item. The following dialog box will appear:
75
76         .. image:: ../images/intersectgroups.png
77                 :align: center                                                 
78
79         In this dialog box you should specify the name of the resulting group and set of groups which will be intersected.
80
81         For example, we have two groups Group1 and Group2. 
82
83         The result of their **Intersection** will be Group12a:
84
85         .. image:: ../images/image133.gif
86                 :align: center
87
88         .. centered::
89                 Group1
90
91         .. image:: ../images/image134.gif
92                 :align: center
93
94         .. centered::
95                 Group2
96
97         .. image:: ../images/image136.gif
98                 :align: center
99
100         .. centered::
101                 Group12a
102
103 #. Click the **Apply** or **Apply and Close** button to confirm creation of the group.
104
105
106 **See Also** a sample TUI Script of an  
107 :ref:`tui_intersection_of_groups` operation.  
108
109
110 .. _cut_anchor:
111
112 Cut of groups
113 #############
114
115 This operation allows to create a new group in such a way that all
116 mesh elements that are present in the main groups but are absent in the
117 tool groups are added to the new one.
118
119 **To cut groups:**
120
121 #. In the **Mesh** menu select the **Cut Groups** item. The following dialog box will appear:
122
123         .. image:: ../images/cutgroups.png
124                 :align: center                                                 
125
126         In this dialog box you should specify the name of the resulting group and groups which will be cut.
127
128         For example, we have two groups Group1 and Group2. 
129         The result of their **Cut** will be Group12b:
130
131         .. image:: ../images/image133.gif
132                 :align: center
133
134         .. centered::
135                 Group1
136
137         .. image:: ../images/image134.gif
138                 :align: center
139
140         .. centered::
141                 Group2
142
143         .. image:: ../images/image137.gif
144                 :align: center
145
146         .. centered::
147                 Group12b
148
149 #. Click the **Apply** or **Apply and Close** button to confirm creation of the group.
150
151
152 **See Also** a sample TUI Script of a 
153 :ref:`tui_cut_of_groups` operation.  
154
155