X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fselection_filter_library.doc;h=ed93878cbdb5e648653476f184b666f617d38ea7;hb=1dd2f82c6d43d470c088288248edea674d583eec;hp=66c72a0e848286f681124fc3d8775ff22da41d83;hpb=0635c9fc80f67d1e5dc0e94ec85f487286a92070;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 66c72a0e8..ed93878cb 100644 --- a/doc/salome/gui/SMESH/input/selection_filter_library.doc +++ b/doc/salome/gui/SMESH/input/selection_filter_library.doc @@ -9,40 +9,50 @@ via Tools / Selection filter library. \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. +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. -\n Each filter can be applicable to \b Nodes, \b Edges, \b Faces or \b -Volumes. You can combine many criteria in one filter, but they all -must be of the same Entity type. -\n The \b Add button creates a new criterion at the end of the list of + +\anchor filtering_elements + +When we use filters during a group creation or another operation (by +clicking Set Filter button in the corresponding dialog), the +menu for setting filters looks as shown below. + +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 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 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 -Set Filters button in the Create Group menu), the menu -for setting filters looks a bit differently. Toggling Insert filter -in viewer checkbox enables to preview the group selected with your -current filter in the viewer. -\n In the \b Source field you choose if the filter will be applied to -the whole \b Mesh, the Initial Selection or the Current Group. -\n Copy from... button gives you a possibility to load an +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. -\n Note: If the button Apply and Close is disabled, there +
+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. @@ -50,36 +60,49 @@ 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 all Entity types: except for -Nodes +Some criteria are applicable to all Entity types of dimension +more than zero, i.e. to \b Edges, \b Faces and \b Volumes: @@ -97,12 +120,25 @@ specified arbitrary surface within a given Tolerance. -Additional criteria to select mesh Edges are the following: +The following criteria allow selecting mesh Nodes: + + +The following criteria allow selecting mesh Edges: -Additional criteria to select mesh Faces are the following: +The following criteria allow selecting mesh Faces: -Additional criteria to select mesh Volumes are the following: +The following criteria allow selecting mesh Volumes: