Salome HOME
Allow creating smeshBuilder before geomBuilder
[modules/smesh.git] / doc / salome / gui / SMESH / input / about_filters.rst
1 .. _filters_page: 
2
3 *************
4 About filters
5 *************
6
7 **Filters** allow picking only the mesh elements satisfying to a specific condition or a set of conditions. Filters can be used to create or edit mesh groups, remove elements from the mesh, control mesh quality by different parameters, etc.
8
9 Several criteria can be combined together by using logical operators *AND* and *OR*. In addition, a filter criterion can be reverted using logical operator *NOT*.
10
11 Some filtering criteria use the functionality of :ref:`mesh quality controls <quality_page>` to filter mesh nodes / elements by specific characteristic (Area, Length, etc).
12
13 The functinality of mesh filters is available in both GUI and TUI modes:
14
15 * In GUI, filters are available in some dialog boxes via "Set Filters" button, clicking on which opens the :ref:`dialog box <filtering_elements>` allowing to specify the list of filter criteria to be applied to the current selection. See :ref:`selection_filter_library_page` page to learn more about selection filters and their usage in GUI.
16
17 * In Python scripts, filters can be used to choose only some mesh nodes or elements for the operations, which require the list of entities as input parameter (create/modify group, remove nodes/elements, etc) and for the operations, which accept objects (groups, sub-meshes) as input parameter. The page :ref:`tui_filters_page` provides examples of the filters usage in Python scripts.
18
19 .. toctree::
20    :maxdepth: 2
21    :hidden:
22
23    selection_filter_library.rst