Salome HOME
333b5b0d2f0266ae4faead589adf53fa6be219ef
[modules/smesh.git] / doc / salome / gui / SMESH / selection_filter_library.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>Selection filter library</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:624px; height:776px; float:none; border-style:none; }\r
19 img_whs3 { border:none; width:31px; height:30px; border-style:none; }\r
20 img_whs4 { border:none; width:624px; height:525px; float:none; border-style:none; }\r
21 -->\r
22 </style><script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">\r
23 <!--\r
24 function reDo() {\r
25   if (innerWidth != origWidth || innerHeight != origHeight)\r
26      location.reload();\r
27 }\r
28 if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {\r
29         origWidth = innerWidth;\r
30         origHeight = innerHeight;\r
31         onresize = reDo;\r
32 }\r
33 onerror = null; \r
34 //-->\r
35 </script>\r
36 <style type="text/css">\r
37 <!--\r
38 div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }\r
39 -->\r
40 </style><script type="text/javascript" language="javascript1.2" src="whmsg.js"></script>\r
41 <script type="text/javascript" language="javascript" src="whver.js"></script>\r
42 <script type="text/javascript" language="javascript1.2" src="whproxy.js"></script>\r
43 <script type="text/javascript" language="javascript1.2" src="whutils.js"></script>\r
44 <script type="text/javascript" language="javascript1.2" src="whtopic.js"></script>\r
45 </head>\r
46 <body><script type="text/javascript" language="javascript1.2">\r
47 <!--\r
48 if (window.gbWhTopic)\r
49 {\r
50         if (window.addTocInfo)\r
51         {\r
52         addTocInfo("MESH module\nGrouping elements\nSelection filter library");\r
53 addButton("show",BTN_TEXT,"Show","","","","",0,0,"","","");\r
54 \r
55         }\r
56         if (window.writeBtnStyle)\r
57                 writeBtnStyle();\r
58 \r
59         if (window.writeIntopicBar)\r
60                 writeIntopicBar(1);\r
61 \r
62         if (window.setRelStartPage)\r
63         {\r
64         setRelStartPage("smesh.htm");\r
65 \r
66                 autoSync(1);\r
67                 sendSyncInfo();\r
68                 sendAveInfoOut();\r
69         }\r
70 }\r
71 else\r
72         if (window.gbIE4)\r
73                 document.location.reload();\r
74 //-->\r
75 </script>\r
76 <h1>Selection filter library</h1>\r
77 \r
78 <p>Selection filter library is a powerful tool enabling to create filters \r
79  to be used on meshes. You can access to it from the Main Menu via <span \r
80  style="font-weight: bold;"><B>Tools / Selection filter library.</B></span></p>\r
81 \r
82 <p>&nbsp;</p>\r
83 \r
84 <p class="whs1"><img src="pics/selectionfilterlibrary.png" x-maintain-ratio="TRUE" width="624px" height="776px" border="0" class="img_whs2"></p>\r
85 \r
86 <p>&nbsp;</p>\r
87 \r
88 <p class="whs1">Library file name s<span style="font-weight: normal;">hows \r
89  the path and the file name where your filters will be stored. By clicking \r
90  the</span> <img src="image103.gif" width="31px" height="30px" border="0" class="img_whs3"> <span style="font-weight: normal;">browse button \r
91  you can load an existing filter library.</span></p>\r
92 \r
93 <p><span style="font-weight: bold;"><B>Names of filters</B></span> lists the filters \r
94  created or uploaded for the current study. You can <span style="font-weight: bold;"><B>Add</B></span> \r
95  or <span style="font-weight: bold;"><B>Delete</B></span> filters. &nbsp;</p>\r
96 \r
97 <p>In <span style="font-weight: bold;"><B>Filter name</B></span> box you can specify \r
98  the name for your filter. By default it is prefixed with the corresponding \r
99  entity type.</p>\r
100 \r
101 <p>Each filter can be applicable to <span style="font-weight: bold;"><B>Nodes, \r
102  Edges, Faces</B></span> or <span style="font-weight: bold;"><B>Volumes</B></span>. \r
103  You can combine many criteria in one filter, but they all must be of the \r
104  same <span style="font-weight: bold;"><B>Entity type</B></span>. </p>\r
105 \r
106 <p>The <span style="font-weight: bold;"><B>Add</B></span> button creates a new \r
107  criterion at the end of the list of criteria. The <span style="font-weight: bold;"><B>Insert</B></span> \r
108  button creates a new criterion before the selected criterion. The <span \r
109  style="font-weight: bold;"><B>Remove</B></span> button deletes the selected criterion. \r
110  The <span style="font-weight: bold;"><B>Clear</B></span> button deletes all criteria. \r
111  &nbsp;</p>\r
112 \r
113 <p>Each <span style="font-weight: bold;"><B>Entity type</B></span> has its specific \r
114  list of criteria, however all filters have common syntax. For each criterion \r
115  you should specify the <span style="font-weight: bold;"><B>Threshold Value</B></span> \r
116  and whether we search for the elements that should be <span style="font-weight: bold;"><B>More, \r
117  Less or Equal</B></span> to this <span style="font-weight: bold;"><B>Value</B></span>. \r
118  You should also specify if the criterion is <span style="font-weight: bold;"><B>Unary</B></span> \r
119  or <span style="font-weight: bold;"><B>Binary.</B></span> &nbsp;&nbsp;</p>\r
120 \r
121 <p>Some criteria should have the additional parameter of <span style="font-weight: bold;"><B>Tolerance</B></span>.</p>\r
122 \r
123 <p>&nbsp;</p>\r
124 \r
125 <p>When we create a <span style="font-weight: bold;"><B>Standalone Group</B></span> \r
126  using filters (for this click <span style="font-weight: bold;"><B>Set Filters</B></span> \r
127  button in the <span style="font-weight: bold;"><B>Create Group</B></span> menu), \r
128  the menu for setting filters looks a bit differently. Toggling <span style="font-weight: bold;"><B>Insert \r
129  filter in viewer</B></span> checkbox enables to preview the group selected \r
130  with your current filter in the viewer. </p>\r
131 \r
132 <p>In the <span style="font-weight: bold;"><B>Source</B></span> field you choose \r
133  if the filter will be applied to the whole <span style="font-weight: bold;"><B>Mesh</B></span>, \r
134  the<span style="font-weight: bold;"><B> Initial Selection </B></span>or the<span \r
135  style="font-weight: bold;"><B> Current Group. </B></span></p>\r
136 \r
137 <p><span style="font-weight: bold;"><B>Copy from...</B></span> button gives you \r
138  a possibility to load an existing filter from <span style="font-weight: bold;"><B>Selection \r
139  filter library</B></span> and <span style="font-weight: bold;"><B>Add to...</B></span> \r
140  button gives you a possibility to save your current filter in the Library. \r
141  &nbsp;</p>\r
142 \r
143 <p>&nbsp;</p>\r
144 \r
145 <p><img src="pics/a-filteronedges.png" x-maintain-ratio="TRUE" width="624px" height="525px" border="0" class="img_whs4"></p>\r
146 \r
147 <script type="text/javascript" language="javascript1.2">\r
148 <!--\r
149 if (window.writeIntopicBar)\r
150         writeIntopicBar(0);\r
151 //-->\r
152 </script>\r
153 </body>\r
154 </html>\r