/*! \page selection_filter_library_page Selection filter library \n Selection filter library allows creating and storing in files the filters that can be later reused for operations on meshes. You can access it from the Main Menu via Tools / Selection filter library. It is also possible to save/load a filter by invoking the filter library from \ref filtering_elements "Filter dialog" launched from any mesh operation. \image html selectionfilterlibrary.png Library file name shows the path and the file name where your filters will be stored. By clicking the Browse button you can load an existing filter library. \n Names of filters lists the filters created or uploaded for the current study. You can \b Add or \b Delete filters. \n In Filter name box you can specify the name for your filter. By default it is prefixed with the corresponding entity type. \anchor filtering_elements

Filter Dialog

When we use filters during group creation or another operation (by clicking Set Filter button in the corresponding dialog), the dialog for setting filters looks as shown below. \image html a-filteronfaces.png The \b Add button creates a new criterion at the end of the list of criteria. The \b Insert button creates a new criterion before the selected criterion. The \b Remove button deletes the selected criterion. The \b Clear button deletes all criteria.\n If there is a choice of Entity type in the dialog, only criteria of currently selected type are used to create or change a filter, and criteria of hidden types (if were specified) are ignored. \n Each Entity type has its specific list of criteria, however all filters have common syntax. The Threshold Value should be specified for most criteria. For numerical criteria it is necessary to indicate if the found elements should be \b More, \b Less or \b Equal to this \b Value. You can also reverse the sense of a criterion using \b Unary operator \a Not and you should specify logical relations between criteria using \b Binary operators \a Or and \a And. \n Some criteria have the additional parameter of \b Tolerance.
Switching on Insert filter in viewer check-box limits selection of elements in the Viewer to the current filter.
In the \b Source field you choose if the filter will be applied to the whole \b Mesh, the Initial Selection or the Current Dialog. If \b Mesh is chosen, the elements satisfying the filter will be selected in the 3D Viewer. If Initial Selection is chosen, the filter will be applied to the selected elements and the elements rejected by the filter will be deselected. If Current Dialog is chosen, the filter will be applied to the list of elements in the current dialog and the elements rejected by the filter will be removed from the list.
Copy from... button gives you a possibility to load an existing filter from Selection filter library and Add to... button gives you a possibility to save your current filter in the Library.
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. Some criteria are applicable to all Entity types: Some criteria are applicable to entities of dimension more than zero, i.e. to \b Edges, \b Faces and \b Volumes: The following criteria are applicable to Entities of \b all types except for \a Volumes: The following criteria allow selecting mesh Nodes: The following criteria allow selecting mesh Edges: The following criteria allow selecting mesh Faces: The following criteria allow selecting mesh Volumes: */