X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fselection_filter_library.doc;h=1f612994f18438ce6a05af2a9a0e21b50083a7e5;hb=d8f644ca3d4ce62f2ef41d4aacb52f5bb1221df3;hp=613febb9cc16fd27932985540756f76c4262a2ba;hpb=79b1ac2b6df9117f16f11d444b1f165d477a1813;p=modules%2Fsmesh.git
diff --git a/doc/salome/gui/SMESH/input/selection_filter_library.doc b/doc/salome/gui/SMESH/input/selection_filter_library.doc
index 613febb9c..1f612994f 100644
--- a/doc/salome/gui/SMESH/input/selection_filter_library.doc
+++ b/doc/salome/gui/SMESH/input/selection_filter_library.doc
@@ -25,8 +25,10 @@ criterion. The \b Clear button deletes all criteria.
\n Each Entity type has its specific list of criteria, however all
filters have common syntax. For each criterion you should specify the
Threshold Value and whether we search for the elements that should be
-\b More, \b Less or \b Equal to this \b Value. You should also specify if the
-criterion is \b Unary or \b Binary.
+\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.
\n Some criteria should have the additional parameter of \b Tolerance.
When we create a Standalone Group using filters (for this click
@@ -40,7 +42,153 @@ the whole \b Mesh, the Initial Selection or the Current Group.
existing filter from Selection filter library and Add
to... button gives you a possibility to save your current filter
in the Library.
+\n Note: If the button Apply and Close 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
-*/
\ No newline at end of file
+Some criteria are applicable to all Entity types:
+-
+Belong to Geom selects entities whose all nodes
+lie on the shape defined by Threshold Value.
+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.
+
-
+Lying on Geom selects entities whose at least one node
+lies on the shape defined by the Threshold Value.
+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.
+
-
+Range of IDs allows selection of entities with the specified
+IDs.
+Threshold Value can be, for example: "1,2,3,50-60,63,67,70-78"
+
-
+Color of Group allows selection of entities belonging to the Group with
+the color defined by the Threshold Value.
+
+
+
+Some criteria are applicable to all Entity types, except for
+Nodes
+-
+Linear allows selection of Linear or Quadratic elements (if Unary is set to "Not")
+
-
+Geometry type allows selection of elements by their geometric type
+defined by the Threshold Value. The list of available geometric
+types depends on the element entity type defined by the Threshold Value.
+
+
+
+The following criteria are applicable to all Entity types
+except for Volumes:
+-
+Belong to Plane selects entities whose all nodes belong to a
+specified plane within a given Tolerance.
+
-
+Belong to Cylinder selects entities whose all nodes belong to a
+specified cylinder within a given Tolerance.
+
-
+Belong to Surface selects entities whose all nodes belong to a
+specified arbitrary surface within a given Tolerance.
+
+
+
+Additional criteria to select mesh Edges are the following:
+-
+Free Borders selects free 1D mesh elements, i.e. edges belonging to
+one face only. See also a
+\ref free_borders_page "Free Borders quality control".
+
-
+Borders at Multi-Connections selects edges belonging to several faces.
+The number of faces should be more, less or equal (within a given Tolerance)
+to the predefined Threshold Value. See also a
+\ref borders_at_multi_connection_page "Borders at Multi-Connection quality control".
+
-
+Length selects edges with a value of length, which is more, less or equal
+(within a given Tolerance) to the predefined Threshold Value.
+See also a
+\ref length_page "Length quality control".
+
+
+
+Additional criteria to select mesh Faces are the following:
+-
+Aspect ratio selects 2D mesh elements with an aspect ratio (see also an
+\ref aspect_ratio_page "Aspect Ratio quality control"), which is more, less or equal
+(within a given Tolerance) to the predefined Threshold Value.
+
-
+Warping selects quadrangles with warping angle (see also a
+\ref warping_page "Warping quality control"), which is more, less or equal
+(within a given Tolerance) to the predefined Threshold Value.
+
-
+Minimum angle selects triangles and quadrangles with minimum angle (see also a
+\ref minimum_angle_page "Minimum angle quality control"), which is more, less or equal
+(within a given Tolerance) to the predefined Threshold Value.
+
-
+Taper selects quadrangles cells with taper value (see also a
+\ref taper_page "Taper quality control"), which is more, less or equal (within a given
+Tolerance) to the predefined Threshold Value.
+
-
+Skew selects triangles and quadrangles with skew value (see also a
+\ref skew_page "Skew quality control"), which is more, less or equal (within a given
+Tolerance) to the predefined Threshold Value.
+
-
+Area selects triangles and quadrangles with a value of area (see also an
+\ref area_page "Area quality control"), which is more, less or equal (within a given
+Tolerance) to the predefined Threshold Value.
+
-
+Free edges selects 2D mesh elements consisting of edges belonging to
+one element of mesh only. See also a
+\ref free_edges_page "Free Edges quality control".
+
-
+Free faces selects 3D mesh elements wich belong to less than two volumes.
+
-
+Borders at Multi-Connections 2D 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 Tolerance) to the predefined Threshold Value.
+See also a
+\ref borders_at_multi_connection_2d_page "Borders at Multi-Connection 2D quality control".
+
-
+Length 2D selects triangles and quadrangles combining of the edges with a value of
+length, which is more, less or equal (within a given Tolerance) to the predefined
+Threshold Value. See also a
+\ref length_2d_page "Length 2D quality control".
+
-
+Coplanar faces selects mesh faces neighboring the one selected
+by ID in Threshold Value field, if the angle between the
+normal to the neighboring face and the normal to the selected face is less then the
+angular tolerance (defined in degrees). Selection continues among all neighbor faces of already
+selected ones.
+ -
+Element Diameter 2D selects triangles and quadrangles combining of the edges and
+diagonals with a value of length, which is more, less or equal
+(within a given Tolerance) to the predefined Threshold Value. See also a
+\ref max_element_length_2d_page "Element Diameter 2D quality control".
+
+
+
+Additional criteria to select mesh Volumes are the following:
+-
+Aspect ratio 3D selects 3D mesh elements with an aspect ratio (see also an
+\ref aspect_ratio_3d_page "Aspect Ratio 3D quality control"), which is more, less or equal
+(within a given Tolerance) to the predefined Threshold Value.
+
-
+Volume selects 3D mesh elements with a value of volume (see also a
+\ref volume_page "Volume quality control"), which is more, less or equal (within a given
+Tolerance) to the predefined Threshold Value.
+
-
+Element Diameter 3D selects 3D mesh elements combining of the edges and
+diagonals with a value of length, which is more, less or equal
+(within a given Tolerance) to the predefined Threshold Value. See also a
+\ref max_element_length_3d_page "Element Diameter 3D quality control".
+
-
+Bad oriented volume selects mesh volumes, which are incorrectly oriented from
+the point of view of MED convention.
+
+
+
+
+*/