Salome HOME
Fix for bug PAL9227 : SMESH : documentation on group is wrong.
[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; }\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:565px; 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 td.whs21 { 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
38 img_whs22 { border:none; width:312px; height:312px; float:none; border-style:none; }\r
39 td.whs23 { width:66.52%; padding-right:10px; padding-left:10px; border-top-style:none; border-bottom-style:none; border-right-style:none; }\r
40 img_whs24 { border:none; width:135px; height:150px; border-style:none; }\r
41 p.whs25 { margin-left:80px; }\r
42 -->\r
43 </style><script type="text/javascript" language="JavaScript">\r
44 <!--\r
45 if ((navigator.appName == "Netscape") && (parseInt(navigator.appVersion) == 4))\r
46 {\r
47   var strNSS = "<style type='text/css'>";\r
48   strNSS += "p.whs16 {margin-left:1pt; }";\r
49   strNSS +="</style>";\r
50   document.write(strNSS);\r
51 }\r
52 //-->\r
53 </script>\r
54 <script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">\r
55 <!--\r
56 function reDo() {\r
57   if (innerWidth != origWidth || innerHeight != origHeight)\r
58      location.reload();\r
59 }\r
60 if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {\r
61         origWidth = innerWidth;\r
62         origHeight = innerHeight;\r
63         onresize = reDo;\r
64 }\r
65 onerror = null; \r
66 //-->\r
67 </script>\r
68 <style type="text/css">\r
69 <!--\r
70 div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }\r
71 -->\r
72 </style><script type="text/javascript" language="javascript1.2" src="../whmsg.js"></script>\r
73 <script type="text/javascript" language="javascript" src="../whver.js"></script>\r
74 <script type="text/javascript" language="javascript1.2" src="../whproxy.js"></script>\r
75 <script type="text/javascript" language="javascript1.2" src="../whutils.js"></script>\r
76 <script type="text/javascript" language="javascript1.2" src="../whtopic.js"></script>\r
77 </head>\r
78 <body><script type="text/javascript" language="javascript1.2">\r
79 <!--\r
80 if (window.gbWhTopic)\r
81 {\r
82         if (window.addTocInfo)\r
83         {\r
84         addTocInfo("MESH module\nGrouping elements\nCreating groups");\r
85 addButton("show",BTN_TEXT,"Show","","","","",0,0,"","","");\r
86 \r
87         }\r
88         if (window.writeBtnStyle)\r
89                 writeBtnStyle();\r
90 \r
91         if (window.writeIntopicBar)\r
92                 writeIntopicBar(1);\r
93 \r
94         if (window.setRelStartPage)\r
95         {\r
96         setRelStartPage("../smesh.htm");\r
97 \r
98                 autoSync(1);\r
99                 sendSyncInfo();\r
100                 sendAveInfoOut();\r
101         }\r
102 }\r
103 else\r
104         if (window.gbIE4)\r
105                 document.location.reload();\r
106 //-->\r
107 </script>\r
108 <h1>Creating groups</h1>\r
109 \r
110 <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
111  style="font-weight: normal;">In MESH you \r
112  can create groups of elements of different types. To create a group of \r
113  elements</span><span style="font-weight: normal; margin-left: 40px;"> \r
114  in the </span><span style="margin-left: 40px;">Mesh</span><span style="font-weight: normal; margin-left: 40px;"> \r
115  menu select </span><span style="margin-left: 40px;">Create Group</span><span \r
116  style="font-weight: normal; margin-left: 40px;">.</span><span style="margin-left: 40px;"> \r
117  </span></p>\r
118 \r
119 <p class="whs3">To create any group \r
120  you should define the following: &nbsp;&nbsp;</p>\r
121 \r
122 <ul type="disc" class="whs4">\r
123         \r
124         <li class=kadov-p><p class="whs5">Mesh: \r
125  <span style="font-weight: normal;">the name of the mesh whose elements \r
126  will form your group. You can select your mesh in the Objet Browser or \r
127  in the 3D viewer.</span></p></li>\r
128         \r
129         <li class=kadov-p><p class="whs3"><span \r
130  style="font-weight: bold;"><B>Elements</B></span> <span style="font-weight: bold;"><B>Type</B></span> \r
131  set of radio buttons allows to select the type of elements which will \r
132  form your group:</p></li>\r
133         \r
134         <ul type="disc" class="whs4">\r
135                 \r
136                 <li class=kadov-p><p class="whs6">Nodes</p></li>\r
137                 \r
138                 <li class=kadov-p><p class="whs6">Edges \r
139  </p></li>\r
140                 \r
141                 <li class=kadov-p><p class="whs6">Faces</p></li>\r
142                 \r
143                 <li class=kadov-p><p class="whs6">Volumes</p></li>\r
144         </ul>\r
145         \r
146         <li class=kadov-p><p class="whs3"><span \r
147  style="font-weight: bold;"><B>Name </B></span>field allows to enter the name \r
148  of your new group.</p></li>\r
149 </ul>\r
150 \r
151 <p class="whs3">SALOME Platform distinguishes \r
152  between the two Group types: <span style="font-weight: bold;"><B>Standalone \r
153  Group</B></span> and <span style="font-weight: bold;"><B>Group on Geometry</B></span>. \r
154  &nbsp;</p>\r
155 \r
156 <h3>Standalone Group </h3>\r
157 \r
158 <p class="whs7">The box for creation of a <span style="font-weight: bold;"><B>Standalone \r
159  Group</B></span> appears by default. <span style="font-weight: bold;"><B>Standalone \r
160  Group</B></span> consists of mesh elements, which you can define in two possible \r
161  ways.</p>\r
162 \r
163 <ul type="disc" class="whs4">\r
164         \r
165         <li class=kadov-p><p class="whs8">Choosing them manually \r
166  with the mouse in the 3D Viewer. You can click on an element in the 3D \r
167  viewer and it will be highlighted. After that click the <span style="font-weight: bold;"><B>Add \r
168  </B></span>button and the ID of this element will be added to the list. </p></li>\r
169         \r
170         <li class=kadov-p><p class="whs7">Applying Filters. The \r
171  <span style="font-weight: bold;"><B>Set filter </B></span>button allows to apply \r
172  a definite filter to selection of the elements of your group. See more \r
173  about filters on the <a href="../selection_filter_library.htm">Selection \r
174  filter library</a> page. &nbsp;&nbsp;</p></li>\r
175 </ul>\r
176 \r
177 <p class="whs7">To remove a selected element or elements \r
178  from the list click the <span style="font-weight: bold;"><B>Remove </B></span>button. \r
179  The <span style="font-weight: bold;"><B>Sort List </B></span>button allows to \r
180  sort the list of IDs of mesh elements. </p>\r
181 \r
182 <p class="whs7"><span style="font-weight: bold;"><B>Select from \r
183  </B></span>set of fields allows to choose a submesh or an existing group whose \r
184  elements of the previously defined type will be added to the list of elements \r
185  which will form your group.</p>\r
186 \r
187 <p class="whs7">&nbsp;</p>\r
188 \r
189 <table x-use-null-cells cellspacing="0" width="100%" class="whs9">\r
190 <col class="whs10">\r
191 <col class="whs11">\r
192 \r
193 <tr valign="top" class="whs12">\r
194 <td width="33.382%" class="whs13">\r
195 <p class="whs1"><img src="../pics/creategroup.png" x-maintain-ratio="TRUE" width="312px" height="565px" border="0" class="img_whs14"></td>\r
196 <td width="66.618%" class="whs15">\r
197 <p class="whs16"><img src="../image130.gif" width="145px" height="150px" align="left" border="0" class="img_whs17"> &nbsp;&nbsp;</p>\r
198 <p class="whs16">&nbsp;</p>\r
199 <p class="whs16">&nbsp;</p>\r
200 <p class="whs16">&nbsp;</p>\r
201 <p class="whs16">&nbsp;</p>\r
202 <p class="whs16">&nbsp;</p>\r
203 <p class="whs16">In this picture the brown cells belong to \r
204  a group defined manually.</p>\r
205 <p class="whs16">&nbsp;</p>\r
206 <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
207  by the criterion <br>\r
208 Taper &gt; 0. </p>\r
209 <p class="whs16">&nbsp;</p>\r
210 <p class="whs16">&nbsp;</td></tr>\r
211 </table>\r
212 \r
213 <p class="whs7">&nbsp;</p>\r
214 \r
215 <p class="whs5">&nbsp;&nbsp;&nbsp;See \r
216  Also a sample TUI Script of a <a href="../grouping_elements.htm#bookmark">Create \r
217  a Standalone Group</a> operation. &nbsp;</p>\r
218 \r
219 <h3>Group on Geometry </h3>\r
220 \r
221 <p class="whs3">To create a group on \r
222  geometry check <span style="font-weight: bold;"><B>Group on geometry</B></span> \r
223  in the <span style="font-weight: bold;"><B>Group type</B></span> field. <span \r
224  style="font-weight: bold;"><B>Group on geometry </B></span>contains the elements \r
225  of a certain type belonging to the selected<span style="font-weight: bold;"> \r
226  <B></B></span>geometrical object. To define a group select in the Objet Browser \r
227  or in the 3D viewer a geometrical object from which the elements will \r
228  be taken. After confirmation of the operation MESH will create a new group \r
229  of mesh elements.</p>\r
230 \r
231 <p class="whs3">&nbsp;</p>\r
232 \r
233 <table x-use-null-cells cellspacing="0" width="100%" class="whs9">\r
234 <col class="whs19">\r
235 <col class="whs20">\r
236 \r
237 <tr valign="top" class="whs12">\r
238 <td width="33.48%" class="whs21">\r
239 <p><img src="../pics/a-creategroup.png" x-maintain-ratio="TRUE" width="312px" height="312px" border="0" class="img_whs22"></td>\r
240 <td width="66.52%" class="whs23">\r
241 <p><img src="../image132.gif" width="135px" height="150px" border="0" class="img_whs24"> In this picture the cells which belong to a certain face \r
242  are selected in green. </td></tr>\r
243 </table>\r
244 \r
245 <p class="whs3">&nbsp;</p>\r
246 \r
247 <p class="whs6">&nbsp;&nbsp;&nbsp;See \r
248  Also a sample TUI Script of a <a href="../grouping_elements.htm#bookmark5">Create \r
249  a Group on Geometry</a><a href="../grouping_elements.htm#bookmark"> </a>operation. \r
250  &nbsp;</p>\r
251 \r
252 <p>&nbsp;</p>\r
253 \r
254 <p>&nbsp;</p>\r
255 \r
256 <p class="whs16">&nbsp;</p>\r
257 \r
258 <p class="whs25">&nbsp;</p>\r
259 \r
260 <p>&nbsp;</p>\r
261 \r
262 <script type="text/javascript" language="javascript1.2">\r
263 <!--\r
264 if (window.writeIntopicBar)\r
265         writeIntopicBar(0);\r
266 //-->\r
267 </script>\r
268 </body>\r
269 </html>\r