Salome HOME
53068: Create Mesh dialog box is frozen
[modules/smesh.git] / doc / salome / gui / SMESH / input / selection_filter_library.doc
1 /*!
3 \page selection_filter_library_page Selection filter library
5 \n Selection filter library allows creating and storing in files
6 the filters that can be later reused for operations on meshes. You can
7 access it from the Main Menu via <b>Tools / Selection filter library</b>.
8 It is also possible to save/load a filter by invoking the filter library
9 from \ref filtering_elements "Filter dialog" launched from any mesh operation.
11 \image html selectionfilterlibrary.png
13 <b>Library file name</b> shows the path and the file name where your
14 filters will be stored. By clicking the <em>Browse</em> button you can
15 load an existing filter library.
16 \n <b>Names of filters</b> lists the filters created or uploaded for
17 the current study. You can \b Add or \b Delete filters.
18 \n In <b>Filter name</b> box you can specify the name for your
19 filter. By default it is prefixed with the corresponding entity type.
21 \anchor filtering_elements
22 <h2>Filter Dialog</h2>
24 When we use filters during group creation or another operation (by 
25 clicking <b>Set Filter</b> button in the corresponding dialog), the
26 dialog for setting filters looks as shown below.
28 \image html a-filteronfaces.png
30 The \b Add button creates a new criterion at the end of the list of
31 criteria. The \b Insert button creates a new criterion before the
32 selected criterion. The \b Remove button deletes the selected
33 criterion. The \b Clear button deletes all criteria.\n
34 If there is a choice of <b>Entity type</b> in the dialog, only
35 criteria of currently selected type are used to create or change a
36 filter, and criteria of hidden types (if were specified) are ignored.
37 \n Each <b>Entity type</b> has its specific list of criteria, however all
38 filters have common syntax. The <b>Threshold Value</b> should be specified 
39 for most criteria. For numerical criteria it is necessary to indicate if 
40 the found elements should be \b More, \b Less or \b Equal to this
41 \b Value. You can also reverse the sense of a criterion using \b Unary
42 operator \a Not and you should specify logical relations between
43 criteria using \b Binary operators \a Or and \a And.
44 \n Some criteria have the additional parameter of \b Tolerance.<br> 
45 Switching on <b>Insert filter in viewer</b> check-box limits
46 selection of elements in the Viewer to the current filter.
47 <br>
48 In the \b Source field you choose if the filter will be applied to
49 the whole \b Mesh, the <b>Initial Selection</b> or the <b>Current
50 Dialog</b>. If \b Mesh is chosen, the elements satisfying the filter
51 will be selected in the 3D Viewer. If <b> Initial Selection</b> is
52 chosen, the filter will be applied to the selected elements and the
53 elements rejected by the filter will be deselected. If <b>Current
54 Dialog</b> is chosen, the filter will be applied to the list of
55 elements in the current dialog and the elements rejected
56 by the filter will be removed from the list.
57 <br>
58 <b>Copy from...</b> button gives you a possibility to load an
59 existing filter from <b>Selection filter library</b> and <b>Add
60 to...</b> button gives you a possibility to save your current filter
61 in the Library.
62 <br>
63 <b>Note:</b> If the button <b>Apply and Close</b> is disabled, there
64 is no selected mesh in the Object Browser and the filter can not be
65 created. You have to select the mesh and the button will be enabled.
67 Some criteria are applicable to all <b>Entity types</b>:
68 <ul><li>
69 <b>Belong to Geom</b> selects entities whose all nodes lie on the
70 shape defined by <b>Threshold Value</b>. 
71 If the threshold shape is a sub-shape of the main shape of the mesh,
72 the filtering algorithm works faster because node-to-shape association
73 is used instead of measuring distance between nodes and the shape, and
74 \b Tolerance is not used. If the threshold shape is any other shape,
75 the algorithm works slower because distance between nodes and the
76 shape is measured and is compared with \b Tolerance.
77 </li><li>
78 <b>Lying on Geom</b> selects entities whose at least one node
79 lies on the shape defined by the <b>Threshold Value</b>.
80 If the threshold shape is a sub-shape of the main shape of the mesh,
81 the filtering algorithm works faster because node-to-shape association
82 is used instead of measuring distance between nodes and the shape, and
83 \b Tolerance is not used. If the threshold shape is any other shape,
84 the algorithm works slower because distance between nodes and the
85 shape is measured and is compared with \b Tolerance.
86 </li><li>
87 <b>Belong to Mesh Group</b> selects entities included into the mesh group
88 defined by the <b>Threshold Value</b>.
89 </li><li>
90 <b>Range of IDs</b> allows selection of entities with the specified
91 IDs. 
92 <b>Threshold Value</b> can be, for example: "1,2,3,50-60,63,67,70-78"
93 </li><li>
94 <b>Color of Group</b> allows selection of entities belonging to the Group with
95 the color defined by the <b>Threshold Value</b>.
96 </li><li>
97 <b>Elements of a domain</b> allows selection of entities belonging to
98 one domain of a mesh. The domain is mesh part not connected to
99 other parts. <b>Threshold Value</b> locating any element of the domain can be either
100 - node ID (that you can pick in the Viewer) or
101 - geometrical vertex (that you can pick either in the Viewer or in the
102   Object Browser) or
103 - 3 coordinates of a point (that you can enter in TUI mode only).
105 </li>
106 </ul>
108 Some criteria are applicable to entities of dimension
109 more than zero, i.e. to \b Edges, \b Faces and \b Volumes:
110 <ul><li>
111 <b>Linear</b> allows selection of Linear or Quadratic elements (if Unary is set to "Not")
112 </li><li>
113 <b>Geometry type</b> allows selection of elements by their geometric type
114 defined by the <b>Threshold Value</b>. The list of available geometric
115 types depends on the current entity type.
116 </li><li>
117 <b>Entity type</b> allows selection of elements by their type defined
118 as a combination of geometry type and the number of nodes.
119 </li>
120 </ul>
122 The following criteria are applicable to Entities of \b all types
123 except for \a Volumes:
124 <ul><li>
125 <b>Belong to Plane</b> selects entities whose all nodes belong to a
126 specified plane within a given <b>Tolerance</b>.
127 </li><li>
128 <b>Belong to Cylinder</b> selects entities whose all nodes belong to a
129 specified cylinder within a given <b>Tolerance</b>.
130 </li><li>
131 <b>Belong to Surface</b> selects entities whose all nodes belong to a
132 specified arbitrary surface within a given <b>Tolerance</b>.
133 </li>
134 </ul>
136 The following criteria allow selecting mesh <b>Nodes</b>:
137 <ul><li>
138 <b>Free nodes</b> selects nodes not belonging to any mesh element.
139 </li><li>
140 <b>Double nodes</b> selects a node coincident with other nodes 
141 (within a given <b>Tolerance</b>). 
142 See also \ref tui_double_nodes_control "Double Nodes quality control".
143 </li>
144 </ul>
146 The following criteria allow selecting mesh <b>Edges</b>:
147 <ul><li>
148 <b>Free Borders</b> selects free 1D mesh elements, i.e. edges belonging to 
149 one element (face or volume) only. See also a
150 \ref free_borders_page "Free Borders quality control".
151 </li><li>
152 <b>Double edges</b> selects 1D mesh elements basing on the same set of nodes.
153 See also \ref filter_double_elements "Double Elements quality control".
154 </li><li>
155 <b>Borders at Multi-Connections</b> selects edges belonging to several faces.
156 The number of faces should be more, less or equal (within a given <b>Tolerance</b>)
157 to the predefined <b>Threshold Value</b>. See also a
158 \ref borders_at_multi_connection_page "Borders at Multi-Connection quality control".
159 </li><li>
160 <b>Length</b> selects edges with a value of length, which is more, less or equal
161 (within a given <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
162 See also a
163 \ref length_page "Length quality control".
164 </li>
165 </ul>
167 The following criteria allow selecting mesh <b>Faces</b>:
168 <ul><li>
169 <b>Aspect ratio</b> selects 2D mesh elements with an aspect ratio (see also an
170 \ref aspect_ratio_page "Aspect Ratio quality control"), which is more, less or equal
171 (within a given <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
172 </li><li>
173 <b>Warping</b> selects quadrangles with warping angle (see also a
174 \ref warping_page "Warping quality control"), which is more, less or equal
175 (within a given <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
176 </li><li>
177 <b>Minimum angle</b> selects triangles and quadrangles with minimum angle (see also a
178 \ref minimum_angle_page "Minimum angle quality control"), which is more, less or equal
179 (within a given <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
180 </li><li>
181 <b>Taper</b> selects quadrangles cells with taper value (see also a
182 \ref taper_page "Taper quality control"), which is more, less or equal (within a given
183 <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
184 </li><li>
185 <b>Skew</b> selects triangles and quadrangles with skew value (see also a
186 \ref skew_page "Skew quality control"), which is more, less or equal (within a given
187 <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
188 </li><li>
189 <b>Area</b> selects triangles and quadrangles with a value of area (see also an
190 \ref area_page "Area quality control"), which is more, less or equal (within a given
191 <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
192 </li><li>
193 <b>Free edges</b> selects 2D mesh elements having at least one 
194 edge, which is not shared with other faces. See also a
195 \ref free_edges_page "Free Edges quality control".
196 </li><li>
197 <b>Free faces</b> selects 2D mesh elements, which belong to less than two volumes.
198 </li><li>
199 <b>Double faces</b> selects 2D mesh elements basing on the same set of nodes.
200 See also \ref filter_double_elements "Double Elements quality control".
201 </li><li>
202 <b>Faces with bare border</b> selects 2D mesh elements having a free border without an edge on it.
203 See also \ref bare_border_faces_page "Bare border faces quality control".
204 </li><li>
205 <b>Over-constrained faces</b> selects 2D mesh elements having only one border shared 
206 with other 2D elements.
207 See also \ref over_constrained_faces_page "Over-constrained faces quality control".
208 </li><li>
209 <b>Borders at Multi-Connections 2D</b> selects cells consisting of edges belonging to
210 several elements of mesh. The number of mesh elements should be more, less or equal
211 (within a given <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
212 See also a
213 \ref borders_at_multi_connection_2d_page "Borders at Multi-Connection 2D quality control".
214 </li><li>
215 <b>Length 2D</b> selects triangles and quadrangles combining of the edges with a value of
216 length, which is more, less or equal (within a given <b>Tolerance</b>) to the predefined
217 <b>Threshold Value</b>. See also a
218 \ref length_2d_page "Length 2D quality control".
219 </li><li>
220 <b>Coplanar faces</b> selects mesh faces neighboring the one selected
221 by ID in <b>Threshold Value</b> field, if the angle between the
222 normal to the neighboring face and the normal to the selected face is less then the
223 angular tolerance (defined in degrees). Selection continues among all neighbor faces of already 
224 selected ones.<br>
225 </li><li>
226 <b>Element Diameter 2D</b> selects triangles and quadrangles composed of the edges and
227 diagonals with a value of length, which is more, less or equal
228 (within a given <b>Tolerance</b>) to the predefined <b>Threshold Value</b>. See also a
229 \ref max_element_length_2d_page "Element Diameter 2D quality control".
230 </li>
231 </ul>
233 The following criteria allow selecting mesh <b>Volumes</b>:
234 <ul><li>
235 <b>Aspect ratio 3D</b> selects 3D mesh elements with an aspect ratio (see also an
236 \ref aspect_ratio_3d_page "Aspect Ratio 3D quality control"), which is more, less or equal
237 (within a given <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
238 </li><li>
239 <b>Volume</b> selects 3D mesh elements with a value of volume (see also a
240 \ref volume_page "Volume quality control"), which is more, less or equal (within a given
241 <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
242 </li><li>
243 <b>Element Diameter 3D</b> selects 3D mesh elements composed of the edges and
244 diagonals with a value of length, which is more, less or equal
245 (within a given <b>Tolerance</b>) to the predefined <b>Threshold Value</b>. See also a
246 \ref max_element_length_3d_page "Element Diameter 3D quality control".
247 </li><li>
248 <b>Double volumes</b> selects 3D mesh elements basing on the same set of nodes.
249 See also \ref filter_double_elements "Double Elements quality control".
250 </li><li>
251 <b>Bad oriented volume</b> selects mesh volumes, which are incorrectly oriented from
252 the point of view of MED convention.
253 </li><li>
254 <b>Over-constrained volumes</b> selects mesh volumes having only one facet shared 
255 with other volumes.
256 See also \ref over_constrained_volumes_page "Over-constrained volumes quality control".
257 </li><li>
258 <b>Volumes with bare border</b> selects 3D mesh elements having a free border without a face on it.
259 See also \ref bare_border_volumes_page "Bare border volumes quality control".
260 </li>
261 </ul>
264 */