Salome HOME
update documentation about new filters
[modules/smesh.git] / doc / salome / gui / SMESH / input / selection_filter_library.doc
index 070f79b6a1430f3e58e4946763e91842543fe87f..66c72a0e848286f681124fc3d8775ff22da41d83 100644 (file)
@@ -25,7 +25,7 @@ criterion. The \b Clear button deletes all criteria.
 \n Each <b>Entity type</b> has its specific list of criteria, however all
 filters have common syntax. For each criterion you should specify the
 <b>Threshold Value</b> and whether we search for the elements that should be
-\b More, \b Less or \b Equal to this \b Value. You can also nagate the
+\b More, \b Less or \b Equal to this \b Value. You can also reverse the
 sense of a criterion using \b Unary operator Not and you should
 specify logical relations between criteria using \b Binary operators
 Or and And.
@@ -42,32 +42,49 @@ the whole \b Mesh, the <b>Initial Selection</b> or the <b>Current Group</b>.
 existing filter from <b>Selection filter library</b> and <b>Add
 to...</b> button gives you a possibility to save your current filter
 in the Library.
-\n <b>Note:</b> If button <b>Apply and Close</b> is disabled, there
-is no selected mesh in Object Browser and the filter can not be
+\n <b>Note:</b> If the button <b>Apply and Close</b> is disabled, there
+is no selected mesh in the Object Browser and the filter can not be
 created. You have to select the mesh and the button will be enabled.
 
-\image html a-filteronedges.png
+\image html a-filteronfaces.png
 
 Some criteria are applicable to all <b>Entity types</b>:
 <ul><li>
 <b>Belong to Geom</b> selects entities whose all nodes
-lays on the shape defined by <b>Threshold Value</b>.
-The threshold shape can be sub-shape of the main shape of mesh, in
-this case the algorithm works fast, and it also can be any other
-shape, but in this case the algorithm works slower.
+lie on the shape defined by <b>Threshold Value</b>.
+If the threshold shape is a sub-shape of the main shape of the mesh
+the algorithm works faster, if this is any other
+shape the algorithm works slower.
 </li><li>
 <b>Lying on Geom</b> selects entities whose at least one node
-lays on the shape defined by <b>Threshold Value</b>.
-The threshold shape can be sub-shape of the main shape of mesh, in
-this case the algorithm works fast, and it also can be any other
-shape, but in this case the algorithm works slower.
+lies on the shape defined by the <b>Threshold Value</b>.
+If the hreshold shape is a sub-shape of the main shape of the mesh the
+algorithm works faster, if this is any other
+shape, the algorithm works slower.
 </li><li>
-<b>Range of IDs</b> allows selection of entities having certain
-IDs. <b>Threshold Value</b> can be like this: "1,2,3,50-60,63,67,70-78"
+<b>Range of IDs</b> allows selection of entities with the specified
+IDs. 
+<b>Threshold Value</b> can be, for example: "1,2,3,50-60,63,67,70-78"
+</li><li>
+<b>Color of Group</b> allows selection of entities belonging to Group with
+specified color defined by the <b>Threshold Value</b>.
 </li>
 </ul>
 
-The following criteria are applicable to all <b>Entity types</b> except <b>Volumes</b>:
+Some criteria are applicable to all <b>Entity types</b>: except for
+<b>Nodes</b>
+<ul><li>
+<b>Linear</b> allows selection of Linear or Quadratic (in case of
+Unary set to "Not" state)
+</li><li>
+<b>Geometry type</b> allows selection of elements by their geometric type
+defined by the <b>Threshold Value</b>. The list of available geometric
+types depends on element entity type defined by the <b>Threshold Value</b>.
+</li>
+</ul>
+
+The following criteria are applicable to all <b>Entity types</b>
+except for <b>Volumes</b>:
 <ul><li>
 <b>Belong to Plane</b> selects entities whose all nodes belong to a
 specified plane within a given <b>Tolerance</b>.
@@ -128,6 +145,9 @@ Additional criteria to select mesh <b>Faces</b> are the following:
 one element of mesh only. See also a
 \ref free_edges_page "Free Edges quality control".
 </li><li>
+<b>Free faces</b> selects 3D mesh elements wich belong less than to
+two volumes.
+</li><li>
 <b>Borders at Multi-Connections 2D</b> selects cells consisting of edges belonging to
 several elements of mesh. The number of mesh elements should be more, less or equal
 (within a given <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.