Salome HOME
PAL 14158 Add the Octree and OctreeNode classes to accelerate detection of close...
[modules/smesh.git] / doc / salome / gui / SMESH / files / creating_groups.htm
1 <!doctype HTML public "-//W3C//DTD HTML 4.0 Frameset//EN">\r
2 \r
3 <html>\r
4 \r
5 <head>\r
6 <title>Creating groups</title>\r
7 <meta http-equiv="content-type" content="text/html; charset=windows-1252">\r
8 <meta name="generator" content="RoboHelp by eHelp Corporation www.ehelp.com">\r
9 <link rel="stylesheet" href="../default_ns.css"><script type="text/javascript" language="JavaScript" title="WebHelpSplitCss">\r
10 <!--\r
11 if (navigator.appName !="Netscape")\r
12 {   document.write("<link rel='stylesheet' href='../default.css'>");}\r
13 //-->\r
14 </script>\r
15 <style type="text/css">\r
16 <!--\r
17 p.whs1 { font-weight:bold; }\r
18 img_whs2 { border:none; width:30px; height:30px; float:none; border-style:none; }\r
19 p.whs3 { margin-left:40px; font-weight:normal; }\r
20 ul.whs4 { list-style:disc; }\r
21 p.whs5 { font-weight:bold; margin-left:40px; }\r
22 p.whs6 { margin-left:40px; font-weight:bold; }\r
23 p.whs7 { margin-left:40px; }\r
24 p.whs8 { margin-left:36px; }\r
25 table.whs9 { x-cell-content-align:top; width:100%; border-spacing:0px; }\r
26 col.whs10 { width:33.382%; }\r
27 col.whs11 { width:66.618%; }\r
28 tr.whs12 { x-cell-content-align:top; height:587px; }\r
29 td.whs13 { width:33.382%; padding-right:10px; padding-left:10px; border-bottom-style:none; border-right-style:none; border-left-style:none; border-top-style:none; }\r
30 img_whs14 { border:none; width:312px; height:621px; float:none; border-style:none; }\r
31 td.whs15 { width:66.618%; padding-right:10px; padding-left:10px; border-bottom-style:none; border-top-style:none; border-right-style:none; }\r
32 p.whs16 { margin-left:0px; }\r
33 img_whs17 { border:none; width:145px; height:150px; border-style:none; float:left; }\r
34 img_whs18 { border:none; width:149px; height:158px; border-style:none; }\r
35 col.whs19 { width:33.48%; }\r
36 col.whs20 { width:66.52%; }\r
37 tr.whs21 { x-cell-content-align:top; }\r
38 td.whs22 { width:33.48%; padding-right:10px; padding-left:10px; border-right-style:none; border-left-style:none; border-top-style:none; border-bottom-style:none; }\r
39 img_whs23 { border:none; width:312px; height:312px; float:none; border-style:none; }\r
40 td.whs24 { width:66.52%; padding-right:10px; padding-left:10px; border-top-style:none; border-bottom-style:none; border-right-style:none; }\r
41 img_whs25 { border:none; width:135px; height:150px; border-style:none; }\r
42 p.whs26 { margin-left:80px; }\r
43 -->\r
44 </style><script type="text/javascript" language="JavaScript">\r
45 <!--\r
46 if ((navigator.appName == "Netscape") && (parseInt(navigator.appVersion) == 4))\r
47 {\r
48   var strNSS = "<style type='text/css'>";\r
49   strNSS += "p.whs16 {margin-left:1pt; }";\r
50   strNSS +="</style>";\r
51   document.write(strNSS);\r
52 }\r
53 //-->\r
54 </script>\r
55 <script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">\r
56 <!--\r
57 function reDo() {\r
58   if (innerWidth != origWidth || innerHeight != origHeight)\r
59      location.reload();\r
60 }\r
61 if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {\r
62         origWidth = innerWidth;\r
63         origHeight = innerHeight;\r
64         onresize = reDo;\r
65 }\r
66 onerror = null; \r
67 //-->\r
68 </script>\r
69 <style type="text/css">\r
70 <!--\r
71 div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }\r
72 p.WebHelpNavBar { text-align:right; }\r
73 -->\r
74 </style><script type="text/javascript" language="javascript1.2" src="../whmsg.js"></script>\r
75 <script type="text/javascript" language="javascript" src="../whver.js"></script>\r
76 <script type="text/javascript" language="javascript1.2" src="../whproxy.js"></script>\r
77 <script type="text/javascript" language="javascript1.2" src="../whutils.js"></script>\r
78 <script type="text/javascript" language="javascript1.2" src="../whtopic.js"></script>\r
79 <script type="text/javascript" language="javascript1.2">\r
80 <!--\r
81 if (window.gbWhTopic)\r
82 {\r
83         if (window.setRelStartPage)\r
84         {\r
85         addTocInfo("MESH module\nGrouping elements\nCreating groups");\r
86 addButton("show",BTN_IMG,"Show","","","","",0,0,"../whd_show0.gif","../whd_show2.gif","../whd_show1.gif");\r
87 addButton("hide",BTN_IMG,"Hide","","","","",0,0,"../whd_hide0.gif","../whd_hide2.gif","../whd_hide1.gif");\r
88 \r
89         }\r
90 \r
91 \r
92         if (window.setRelStartPage)\r
93         {\r
94         setRelStartPage("../index.htm");\r
95 \r
96                 autoSync(1);\r
97                 sendSyncInfo();\r
98                 sendAveInfoOut();\r
99         }\r
100 \r
101 }\r
102 else\r
103         if (window.gbIE4)\r
104                 document.location.reload();\r
105 //-->\r
106 </script>\r
107 </head>\r
108 <body><script type="text/javascript" language="javascript1.2">\r
109 <!--\r
110 if (window.writeIntopicBar)\r
111         writeIntopicBar(4);\r
112 //-->\r
113 </script>\r
114 <h1>Creating groups</h1>\r
115 \r
116 <p class="whs1"><img src="../i_blue.jpg" x-maintain-ratio="TRUE" width="30px" height="30px" border="0" class="img_whs2"> &nbsp;&nbsp;<span \r
117  style="font-weight: normal;">In MESH you \r
118  can create groups of elements of different types. To create a group of \r
119  elements</span><span style="font-weight: normal; margin-left: 40px;"> \r
120  in the </span><span style="margin-left: 40px;">Mesh</span><span style="font-weight: normal; margin-left: 40px;"> \r
121  menu select </span><span style="margin-left: 40px;">Create Group</span><span \r
122  style="font-weight: normal; margin-left: 40px;">.</span><span style="margin-left: 40px;"> \r
123  </span></p>\r
124 \r
125 <p class="whs3">To create any group \r
126  you should define the following: &nbsp;&nbsp;</p>\r
127 \r
128 <ul type="disc" class="whs4">\r
129         \r
130         <li class=kadov-p><p class="whs5">Mesh: \r
131  <span style="font-weight: normal;">the name of the mesh whose elements \r
132  will form your group. You can select your mesh in the Objet Browser or \r
133  in the 3D viewer.</span></p></li>\r
134         \r
135         <li class=kadov-p><p class="whs3"><span \r
136  style="font-weight: bold;"><B>Elements</B></span> <span style="font-weight: bold;"><B>Type</B></span> \r
137  set of radio buttons allows to select the type of elements which will \r
138  form your group:</p></li>\r
139         \r
140         <ul type="disc" class="whs4">\r
141                 \r
142                 <li class=kadov-p><p class="whs6">Nodes</p></li>\r
143                 \r
144                 <li class=kadov-p><p class="whs6">Edges \r
145  </p></li>\r
146                 \r
147                 <li class=kadov-p><p class="whs6">Faces</p></li>\r
148                 \r
149                 <li class=kadov-p><p class="whs6">Volumes</p></li>\r
150         </ul>\r
151         \r
152         <li class=kadov-p><p class="whs3"><span \r
153  style="font-weight: bold;"><B>Name </B></span>field allows to enter the name \r
154  of your new group.</p></li>\r
155 </ul>\r
156 \r
157 <p class="whs3">SALOME Platform distinguishes \r
158  between the two Group types: <span style="font-weight: bold;"><B>Standalone \r
159  Group</B></span> and <span style="font-weight: bold;"><B>Group on Geometry</B></span>. \r
160  &nbsp;</p>\r
161 \r
162 <h3>Standalone Group </h3>\r
163 \r
164 <p class="whs7"><span style="font-weight: bold;"><B>Standalone \r
165  Group</B></span> consists of mesh elements, which you can define in two possible \r
166  ways.</p>\r
167 \r
168 <ul type="disc" class="whs4">\r
169         \r
170         <li class=kadov-p><p class="whs8">Choosing them manually \r
171  with the mouse in the 3D Viewer. You can click on an element in the 3D \r
172  viewer and it will be highlighted. After that click the <span style="font-weight: bold;"><B>Add \r
173  </B></span>button and the ID of this element will be added to the list. </p></li>\r
174         \r
175         <li class=kadov-p><p class="whs7">Applying Filters. The \r
176  <span style="font-weight: bold;"><B>Set filter </B></span>button allows to apply \r
177  a definite filter to selection of the elements of your group. See more \r
178  about filters on the <a href="../selection_filter_library.htm">Selection \r
179  filter library</a> page. &nbsp;&nbsp;</p></li>\r
180 </ul>\r
181 \r
182 <p class="whs7">To remove a selected element or elements \r
183  from the list click the <span style="font-weight: bold;"><B>Remove </B></span>button. \r
184  The <span style="font-weight: bold;"><B>Sort List </B></span>button allows to \r
185  sort the list of IDs of mesh elements. </p>\r
186 \r
187 <p class="whs7"><span style="font-weight: bold;"><B>Select from \r
188  </B></span>set of fields allows to choose a submesh or an existing group whose \r
189  elements of the previously defined type will be added to the list of elements \r
190  which will form your group. </p>\r
191 \r
192 <p class="whs7"><span style="font-weight: bold;"><B>Color Number</B></span> \r
193  (integer only, ranging from 0 to 9999) - allows to assign to the group \r
194  a certain index, for example, defining boundary conditions. This feature \r
195  introduces a useful element of preprocessing in Mesh module. Note that \r
196  <span style="font-weight: bold;"><B>Color number</B></span> attribute has nothing \r
197  to do with the colors used for the display of the elements of the group.</p>\r
198 \r
199 <p class="whs7">&nbsp;</p>\r
200 \r
201 <table x-use-null-cells cellspacing="0" width="100%" class="whs9">\r
202 <col class="whs10">\r
203 <col class="whs11">\r
204 \r
205 <tr valign="top" class="whs12">\r
206 <td width="33.382%" class="whs13">\r
207 <p class="whs1"><img src="../pics/creategroup.png" x-maintain-ratio="TRUE" width="312px" height="621px" border="0" class="img_whs14"></td>\r
208 <td width="66.618%" class="whs15">\r
209 <p class="whs16"><img src="../image130.gif" width="145px" height="150px" align="left" border="0" class="img_whs17"> &nbsp;&nbsp;</p>\r
210 <p class="whs16">&nbsp;</p>\r
211 <p class="whs16">&nbsp;</p>\r
212 <p class="whs16">&nbsp;</p>\r
213 <p class="whs16">&nbsp;</p>\r
214 <p class="whs16">&nbsp;</p>\r
215 <p class="whs16">In this picture the brown cells belong to \r
216  a group defined manually.</p>\r
217 <p class="whs16">&nbsp;</p>\r
218 <p class="whs16">&nbsp;<img src="../image131.gif" width="149px" height="158px" border="0" class="img_whs18"> In this picture the brown cells belong to the group defined \r
219  by the criterion <br>\r
220 Taper &gt; 0. </p>\r
221 <p class="whs16">&nbsp;</p>\r
222 <p class="whs16">&nbsp;</td></tr>\r
223 </table>\r
224 \r
225 <p class="whs7">&nbsp;</p>\r
226 \r
227 <p class="whs5">&nbsp;&nbsp;&nbsp;See \r
228  Also a sample TUI Script of a <a href="../grouping_elements.htm#bookmark">Create \r
229  a Standalone Group</a> operation. &nbsp;</p>\r
230 \r
231 <h3>Group on Geometry </h3>\r
232 \r
233 <p class="whs3">To create a group on \r
234  geometry check <span style="font-weight: bold;"><B>Group on geometry</B></span> \r
235  in the <span style="font-weight: bold;"><B>Group type</B></span> field. <span \r
236  style="font-weight: bold;"><B>Group on geometry </B></span>contains the elements \r
237  of a certain type belonging to the selected<span style="font-weight: bold;"> \r
238  <B></B></span>geometrical object. To define a group select in the Objet Browser \r
239  or in the 3D viewer a geometrical object from which the elements will \r
240  be taken. After confirmation of the operation a new group of mesh elements \r
241  will be created.</p>\r
242 \r
243 <p class="whs3">&nbsp;</p>\r
244 \r
245 <table x-use-null-cells cellspacing="0" width="100%" class="whs9">\r
246 <col class="whs19">\r
247 <col class="whs20">\r
248 \r
249 <tr valign="top" class="whs21">\r
250 <td width="33.48%" class="whs22">\r
251 <p><img src="../pics/a-creategroup.png" x-maintain-ratio="TRUE" width="312px" height="312px" border="0" class="img_whs23"></td>\r
252 <td width="66.52%" class="whs24">\r
253 <p><img src="../image132.gif" width="135px" height="150px" border="0" class="img_whs25"> In this picture the cells which belong to a certain face \r
254  are selected in green. </td></tr>\r
255 </table>\r
256 \r
257 <p class="whs3">&nbsp;</p>\r
258 \r
259 <p class="whs6">&nbsp;&nbsp;&nbsp;See \r
260  Also a sample TUI Script of a <a href="../grouping_elements.htm#bookmark5">Create \r
261  a Group on Geometry</a><a href="../grouping_elements.htm#bookmark"> </a>operation. \r
262  &nbsp;</p>\r
263 \r
264 <p>&nbsp;</p>\r
265 \r
266 <p>&nbsp;</p>\r
267 \r
268 <p class="whs16">&nbsp;</p>\r
269 \r
270 <p class="whs26">&nbsp;</p>\r
271 \r
272 <p>&nbsp;</p>\r
273 \r
274 <script type="text/javascript" language="javascript1.2">\r
275 <!--\r
276 if (window.writeIntopicBar)\r
277         writeIntopicBar(0);\r
278 //-->\r
279 </script>\r
280 </body>\r
281 </html>\r