doc/salome/gui/SMESH/input/selection_filter_library.doc

   1 /*!
   2
   3 \page selection_filter_library_page Selection filter library
   4
   5 \n Selection filter library is a powerful tool enabling to create
   6 filters to be used on meshes. You can access to it from the Main Menu
   7 via <b>Tools / Selection filter library</b>.
   8
   9 \image html selectionfilterlibrary.png
  10
  11 <b>Library file name</b> shows the path and the file name where your
  12 filters will be stored. By clicking the <em>Browse</em> button you can load an
  13 existing filter library.
  14 \n <b>Names of filters</b> lists the filters created or uploaded for
  15 the current study. You can \b Add or \b Delete filters.
  16 \n In <b>Filter name</b> box you can specify the name for your
  17 filter. By default it is prefixed with the corresponding entity type.
  18 \n Each filter can be applicable to \b Nodes, \b Edges, \b Faces or \b
  19 Volumes. You can combine many criteria in one filter, but they all
  20 must be of the same <b>Entity type</b>.
  21 \n The \b Add button creates a new criterion at the end of the list of
  22 criteria. The \b Insert button creates a new criterion before the
  23 selected criterion. The \b Remove button deletes the selected
  24 criterion. The \b Clear button deletes all criteria.
  25 \n Each <b>Entity type</b> has its specific list of criteria, however all
  26 filters have common syntax. For each criterion you should specify the
  27 <b>Threshold Value</b> and whether we search for the elements that should be
  28 \b More, \b Less or \b Equal to this \b Value. You can also reverse the
  29 sense of a criterion using \b Unary operator Not and you should
  30 specify logical relations between criteria using \b Binary operators
  31 Or and And.
  32 \n Some criteria should have the additional parameter of \b Tolerance.
  33
  34 When we create a <b>Standalone Group</b> using filters (for this click
  35 <b>Set Filters</b> button in the <b>Create Group</b> menu), the menu
  36 for setting filters looks a bit differently. Toggling <b>Insert filter
  37 in viewer</b> checkbox enables to preview the group selected with your
  38 current filter in the viewer.
  39 \n In the \b Source field you choose if the filter will be applied to
  40 the whole \b Mesh, the <b>Initial Selection</b> or the <b>Current Group</b>.
  41 \n <b>Copy from...</b> button gives you a possibility to load an
  42 existing filter from <b>Selection filter library</b> and <b>Add
  43 to...</b> button gives you a possibility to save your current filter
  44 in the Library.
  45 \n <b>Note:</b> If the button <b>Apply and Close</b> is disabled, there
  46 is no selected mesh in the Object Browser and the filter can not be
  47 created. You have to select the mesh and the button will be enabled.
  48
  49 \image html a-filteronedges.png
  50
  51 Some criteria are applicable to all <b>Entity types</b>:
  52 <ul><li>
  53 <b>Belong to Geom</b> selects entities whose all nodes belong to a
  54 submesh on the shape defined by <b>Threshold Value</b>. The threshold shape
  55 must be sub-shape of the main shape of mesh.
  56 </li><li>
  57 <b>Lying on Geom</b> selects entities whose at least one node belongs to a
  58 submesh on the shape defined by <b>Threshold Value</b>. The threshold shape
  59 must be sub-shape of the main shape of mesh.
  60 </li><li>
  61 <b>Range of IDs</b> allows selection of entities with the specified
  62 IDs.
  63 <b>Threshold Value</b> can be, for example: "1,2,3,50-60,63,67,70-78"
  64 </li>
  65 </ul>
  66
  67 The following criteria are applicable to all <b>Entity types</b>
  68 except for <b>Volumes</b>:
  69 <ul><li>
  70 <b>Belong to Plane</b> selects entities whose all nodes belong to a
  71 specified plane within a given <b>Tolerance</b>.
  72 </li><li>
  73 <b>Belong to Cylinder</b> selects entities whose all nodes belong to a
  74 specified cylinder within a given <b>Tolerance</b>.
  75 </li><li>
  76 <b>Belong to Surface</b> selects entities whose all nodes belong to a
  77 specified arbitrary surface within a given <b>Tolerance</b>.
  78 </li>
  79 </ul>
  80
  81 Additional criteria to select mesh <b>Edges</b> are the following:
  82 <ul><li>
  83 <b>Free Borders</b> selects free 1D mesh elements, i.e. edges belonging to
  84 one face only. See also a
  85 \ref free_borders_page "Free Borders quality control".
  86 </li><li>
  87 <b>Borders at Multi-Connections</b> selects edges belonging to several faces.
  88 The number of faces should be more, less or equal (within a given <b>Tolerance</b>)
  89 to the predefined <b>Threshold Value</b>. See also a
  90 \ref borders_at_multi_connection_page "Borders at Multi-Connection quality control".
  91 </li><li>
  92 <b>Length</b> selects edges with a value of length, which is more, less or equal
  93 (within a given <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
  94 See also a
  95 \ref length_page "Length quality control".
  96 </li>
  97 </ul>
  98
  99 Additional criteria to select mesh <b>Faces</b> are the following:
 100 <ul><li>
 101 <b>Aspect ratio</b> selects 2D mesh elements with an aspect ratio (see also an
 102 \ref aspect_ratio_page "Aspect Ratio quality control"), which is more, less or equal
 103 (within a given <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
 104 </li><li>
 105 <b>Warping</b> selects quadrangles with warping angle (see also a
 106 \ref warping_page "Warping quality control"), which is more, less or equal
 107 (within a given <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
 108 </li><li>
 109 <b>Minimum angle</b> selects triangles and quadrangles with minimum angle (see also a
 110 \ref minimum_angle_page "Minimum angle quality control"), which is more, less or equal
 111 (within a given <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
 112 </li><li>
 113 <b>Taper</b> selects quadrangles cells with taper value (see also a
 114 \ref taper_page "Taper quality control"), which is more, less or equal (within a given
 115 <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
 116 </li><li>
 117 <b>Skew</b> selects triangles and quadrangles with skew value (see also a
 118 \ref skew_page "Skew quality control"), which is more, less or equal (within a given
 119 <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
 120 </li><li>
 121 <b>Area</b> selects triangles and quadrangles with a value of area (see also an
 122 \ref area_page "Area quality control"), which is more, less or equal (within a given
 123 <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
 124 </li><li>
 125 <b>Free edges</b> selects 2D mesh elements consisting of edges belonging to
 126 one element of mesh only. See also a
 127 \ref free_edges_page "Free Edges quality control".
 128 </li><li>
 129 <b>Borders at Multi-Connections 2D</b> selects cells consisting of edges belonging to
 130 several elements of mesh. The number of mesh elements should be more, less or equal
 131 (within a given <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
 132 See also a
 133 \ref borders_at_multi_connection_2d_page "Borders at Multi-Connection 2D quality control".
 134 </li><li>
 135 <b>Length 2D</b> selects triangles and quadrangles combining of the edges with a value of
 136 length, which is more, less or equal (within a given <b>Tolerance</b>) to the predefined
 137 <b>Threshold Value</b>. See also a
 138 \ref length_2d_page "Length 2D quality control".
 139 </li>
 140 </ul>
 141
 142 Additional criteria to select mesh <b>Volumes</b> are the following:
 143 <ul><li>
 144 <b>Aspect ratio 3D</b> selects 3D mesh elements with an aspect ratio (see also an
 145 \ref aspect_ratio_3d_page "Aspect Ratio 3D quality control"), which is more, less or equal
 146 (within a given <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
 147 </li><li>
 148 <b>Volume</b> selects 3D mesh elements with a value of volume (see also a
 149 \ref volume_page "Volume quality control"), which is more, less or equal (within a given
 150 <b>Tolerance</b>) to the predefined <b>Threshold Value</b>.
 151 </li><li>
 152 <b>Bad oriented volume</b> selects mesh volumes, which are incorrectly oriented from
 153 the point of view of MED convention.
 154 </li>
 155 </ul>
 156
 157
 158 */