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