doc/salome/gui/SMESH/input/tui_filters.rst

   1 .. _tui_filters_page:
   2
   3 *************
   4 Filters usage
   5 *************
   6
   7 .. contents:: `Table of contents`
   8
   9
  10 Filters allow picking only the mesh elements satisfying to a
  11 specific condition or a set of conditions. Filters can be used to create
  12 or edit mesh groups, remove elements from the mesh, control
  13 mesh quality by different parameters, etc.
  14
  15 Several filtering criteria can be combined together by using logical
  16 operators *AND* and *OR*. In addition, a filtering criterion can
  17 be reverted using logical operator *NOT*.
  18
  19 Mesh filters can use the functionality of mesh quality controls to filter
  20 mesh nodes / elements by a specific characteristic (Area, Length, etc).
  21
  22 This page provides a short description of the existing mesh filters,
  23 describes required parameters and gives simple examples of usage in
  24 Python scripts.
  25
  26 **See also:** :ref:`tui_quality_controls_page`
  27
  28 .. _filter_aspect_ratio:
  29
  30 Aspect ratio
  31 ============
  32
  33 filters 2D mesh elements (faces) according to the aspect ratio value:
  34
  35 * element type should be *SMESH.FACE*
  36 * functor type should be *SMESH.FT_AspectRatio*
  37 * threshold is floating point value (aspect ratio)
  38
  39 .. _filters_ex01.py:
  40
  41 ``filters_ex01.py``
  42
  43 .. literalinclude:: ../../../examples/filters_ex01.py
  44     :linenos:
  45     :language: python
  46
  47 :download:`../../../examples/filters_ex01.py`
  48
  49 **See also:** :ref:`tui_aspect_ratio`
  50
  51 .. _filter_aspect_ratio_3d:
  52
  53 Aspect ratio 3D
  54 ===============
  55
  56 filters 3D mesh elements (volumes) according to the aspect ratio value:
  57
  58 * element type is *SMESH.VOLUME*
  59 * functor type is *SMESH.FT_AspectRatio3D*
  60 * threshold is floating point value (aspect ratio)
  61
  62 .. _filters_ex02.py:
  63
  64 ``filters_ex02.py``
  65
  66 .. literalinclude:: ../../../examples/filters_ex02.py
  67     :linenos:
  68     :language: python
  69
  70 :download:`../../../examples/filters_ex02.py`
  71
  72 **See also:** :ref:`tui_aspect_ratio_3d`
  73
  74 .. _filter_warping_angle:
  75
  76 Warping angle
  77 =============
  78
  79 filters 2D mesh elements (faces) according to the warping angle value:
  80
  81 * element type is *SMESH.FACE*
  82 * functor type is *SMESH.FT_Warping*
  83 * threshold is floating point value (warping angle)
  84
  85 .. _filters_ex03.py:
  86
  87 ``filters_ex03.py``
  88
  89 .. literalinclude:: ../../../examples/filters_ex03.py
  90     :linenos:
  91     :language: python
  92
  93 :download:`../../../examples/filters_ex03.py`
  94
  95 **See also:** :ref:`tui_warping`
  96
  97 .. _filter_minimum_angle:
  98
  99 Minimum angle
 100 =============
 101
 102 filters 2D mesh elements (faces) according to the minimum angle value:
 103
 104 * element type is *SMESH.FACE*
 105 * functor type is *SMESH.FT_MinimumAngle*
 106 * threshold is floating point value (minimum angle)
 107
 108 .. _filters_ex04.py:
 109
 110 ``filters_ex04.py``
 111
 112 .. literalinclude:: ../../../examples/filters_ex04.py
 113     :linenos:
 114     :language: python
 115
 116 :download:`../../../examples/filters_ex04.py`
 117
 118 **See also:** :ref:`tui_minimum_angle`
 119
 120 .. _filter_taper:
 121
 122 Taper
 123 =====
 124
 125 filters 2D mesh elements (faces) according to the taper value:
 126
 127 * element type is *SMESH.FACE*
 128 * functor type is *SMESH.FT_Taper*
 129 * threshold is floating point value (taper)
 130
 131 .. _filters_ex05.py:
 132
 133 ``filters_ex05.py``
 134
 135 .. literalinclude:: ../../../examples/filters_ex05.py
 136     :linenos:
 137     :language: python
 138
 139 :download:`../../../examples/filters_ex05.py`
 140
 141 **See also:** :ref:`tui_taper`
 142
 143 .. _filter_skew:
 144
 145 Skew
 146 ====
 147
 148 filters 2D mesh elements (faces) according to the skew value:
 149
 150 * element type is *SMESH.FACE*
 151 * functor type is *SMESH.FT_Skew*
 152 * threshold is floating point value (skew)
 153
 154 .. _filters_ex06.py:
 155
 156 ``filters_ex06.py``
 157
 158 .. literalinclude:: ../../../examples/filters_ex06.py
 159     :linenos:
 160     :language: python
 161
 162 :download:`../../../examples/filters_ex06.py`
 163
 164 **See also:** :ref:`tui_skew`
 165
 166 .. _filter_area:
 167
 168 Area
 169 ====
 170
 171 filters 2D mesh elements (faces) according to the area value:
 172
 173 * element type is *SMESH.FACE*
 174 * functor type is *SMESH.FT_Area*
 175 * threshold is floating point value (area)
 176
 177 .. _filters_ex07.py:
 178
 179 ``filters_ex07.py``
 180
 181 .. literalinclude:: ../../../examples/filters_ex07.py
 182     :linenos:
 183     :language: python
 184
 185 :download:`../../../examples/filters_ex07.py`
 186
 187 **See also:** :ref:`tui_area`
 188
 189 .. _filter_volume:
 190
 191 Volume
 192 ======
 193
 194 filters 3D mesh elements (volumes) according to the volume value:
 195
 196 * element type is *SMESH.VOLUME*
 197 * functor type is *SMESH.FT_Volume3D*
 198 * threshold is floating point value (volume)
 199
 200 .. _filters_ex08.py:
 201
 202 ``filters_ex08.py``
 203
 204 .. literalinclude:: ../../../examples/filters_ex08.py
 205     :linenos:
 206     :language: python
 207
 208 :download:`../../../examples/filters_ex08.py`
 209
 210 **See also:** :ref:`tui_volume`
 211
 212 .. _filter_free_borders:
 213
 214 Free borders
 215 ============
 216
 217 filters 1D mesh elements (edges) which represent free borders of a mesh:
 218
 219 * element type is *SMESH.EDGE*
 220 * functor type is *SMESH.FT_FreeBorders*
 221 * threshold value is not required
 222
 223 \tui_script{filters_ex09.py}
 224 .. _filters_ex09.py:
 225
 226 ``filters_ex09.py``
 227
 228 .. literalinclude:: ../../../examples/filters_ex09.py
 229     :linenos:
 230     :language: python
 231
 232 :download:`../../../examples/filters_ex09.py`
 233
 234 **See also:** :ref:`tui_free_borders`
 235
 236 .. _filter_free_edges:
 237
 238 Free edges
 239 ==========
 240
 241 filters 2D mesh elements (faces) having edges (i.e. links between
 242 nodes, not mesh segments) belonging to one face of mesh only:
 243
 244 * element type is *SMESH.FACE*
 245 * functor type is *SMESH.FT_FreeEdges*
 246 * threshold value is not required
 247
 248 .. _filters_ex10.py:
 249
 250 ``filters_ex10.py``
 251
 252 .. literalinclude:: ../../../examples/filters_ex10.py
 253     :linenos:
 254     :language: python
 255
 256 :download:`../../../examples/filters_ex10.py`
 257
 258 **See also:** :ref:`tui_free_edges`
 259
 260 .. _filter_free_nodes:
 261
 262 Free nodes
 263 ==========
 264
 265 filters free nodes:
 266
 267 * element type is *SMESH.NODE*
 268 * functor type is *SMESH.FT_FreeNodes*
 269 * threshold value is not required
 270
 271 .. _filters_ex11.py:
 272
 273 ``filters_ex11.py``
 274
 275 .. literalinclude:: ../../../examples/filters_ex11.py
 276     :linenos:
 277     :language: python
 278
 279 :download:`../../../examples/filters_ex11.py`
 280
 281 **See also:** :ref:`tui_free_nodes`
 282
 283 .. _filter_free_faces:
 284
 285 Free faces
 286 ==========
 287
 288 filters free faces:
 289
 290 * element type is *SMESH.FACE*
 291 * functor type is *SMESH.FT_FreeFaces*
 292 * threshold value is not required
 293
 294 .. _filters_ex12.py:
 295
 296 ``filters_ex12.py``
 297
 298 .. literalinclude:: ../../../examples/filters_ex12.py
 299     :linenos:
 300     :language: python
 301
 302 :download:`../../../examples/filters_ex12.py`
 303
 304 **See also:** :ref:`tui_free_faces`
 305
 306 .. _filter_bare_border_faces:
 307
 308 Bare border faces
 309 =================
 310
 311 filters faces with bare borders:
 312
 313 * element type is *SMESH.FACE*
 314 * functor type is *SMESH.FT_BareBorderFace*
 315 * threshold value is not required
 316
 317 .. _filters_ex13.py:
 318
 319 ``filters_ex13.py``
 320
 321 .. literalinclude:: ../../../examples/filters_ex13.py
 322     :linenos:
 323     :language: python
 324
 325 :download:`../../../examples/filters_ex13.py`
 326
 327 **See also:** :ref:`tui_bare_border_faces`
 328
 329 .. _filter_coplanar_faces:
 330
 331 Coplanar faces
 332 ==============
 333
 334 filters coplanar faces:
 335
 336 * element type is *SMESH.FACE*
 337 * functor type is *SMESH.FT_CoplanarFaces*
 338 * threshold value is the face ID
 339 * tolerance is in degrees
 340
 341 .. _filters_ex14.py:
 342
 343 ``filters_ex14.py``
 344
 345 .. literalinclude:: ../../../examples/filters_ex14.py
 346     :linenos:
 347     :language: python
 348
 349 :download:`../../../examples/filters_ex14.py`
 350
 351 .. _filter_over_constrained_faces:
 352
 353 Over-constrained faces
 354 ======================
 355
 356 filters over-constrained faces:
 357
 358 * element type is *SMESH.FACE*
 359 * functor type is *SMESH.FT_OverConstrainedFace*
 360 * threshold value is not required
 361
 362 .. _filters_ex15.py:
 363
 364 ``filters_ex15.py``
 365
 366 .. literalinclude:: ../../../examples/filters_ex15.py
 367     :linenos:
 368     :language: python
 369
 370 :download:`../../../examples/filters_ex15.py`
 371
 372 **See also:** :ref:`tui_over_constrained_faces`
 373
 374 .. _filter_double_elements:
 375
 376 Double edges, Double faces, Double volumes
 377 ##########################################
 378
 379 filters mesh elements basing on the same set of nodes:
 380
 381 * element type is either *SMESH.EGDE*, *SMESH.FACE* or *SMESH.VOLUME*
 382 * functor type is either *SMESH.FT_EqualEdges*, *SMESH.FT_EqualFaces* or *SMESH.FT_EqualVolumes*,
 383 * threshold value is not required
 384
 385 .. _filters_ex16.py:
 386
 387 ``filters_ex16.py``
 388
 389 .. literalinclude:: ../../../examples/filters_ex16.py
 390     :linenos:
 391     :language: python
 392
 393 :download:`../../../examples/filters_ex16.py`
 394
 395 .. _tui_double_nodes_control:
 396
 397 Double nodes
 398 ============
 399
 400 filters mesh nodes which are coincident with other nodes (within a given tolerance):
 401
 402 * element type is *SMESH.NODE*
 403 * functor type is *SMESH.FT_EqualNodes*
 404 * threshold value is not required
 405 * default tolerance is 1.0e-7
 406
 407 .. _filters_ex17.py:
 408
 409 ``filters_ex17.py``
 410
 411 .. literalinclude:: ../../../examples/filters_ex17.py
 412     :linenos:
 413     :language: python
 414
 415 :download:`../../../examples/filters_ex17.py`
 416
 417 .. _filter_node_nb_conn:
 418
 419 Node connectivity number
 420 ========================
 421
 422 filters nodes according to a number of elements of highest dimension connected to a node:
 423
 424 * element type should be *SMESH.NODE*
 425 * functor type should be *SMESH.FT_NodeConnectivityNumber*
 426 * threshold is an integer value (number of elements)
 427
 428 .. _filters_node_nb_conn.py:
 429
 430 ``filters_node_nb_conn.py``
 431
 432 .. literalinclude:: ../../../examples/filters_node_nb_conn.py
 433     :linenos:
 434     :language: python
 435
 436 :download:`../../../examples/filters_node_nb_conn.py`
 437
 438 .. _filter_borders_multiconnection:
 439
 440 Borders at multi-connection
 441 ===========================
 442
 443 filters 1D mesh elements (segments) according to the specified number of
 444 connections (faces and volumes on whose border the segment lies):
 445
 446 * element type is *SMESH.EDGE*
 447 * functor type is *SMESH.FT_MultiConnection*
 448 * threshold is integer value (number of connections)
 449
 450 .. _filters_ex18.py:
 451
 452 ``filters_ex18.py``
 453
 454 .. literalinclude:: ../../../examples/filters_ex18.py
 455     :linenos:
 456     :language: python
 457
 458 :download:`../../../examples/filters_ex18.py`
 459
 460 **See also:** :ref:`tui_borders_at_multiconnection`
 461
 462 .. _filter_borders_multiconnection_2d:
 463
 464 Borders at multi-connection 2D
 465 ==============================
 466
 467 filters 2D mesh elements (faces) with the specified maximal number of
 468 faces connected to a border (link between nodes, not mesh segment):
 469
 470 * element type is *SMESH.FACE*
 471 * functor type is *SMESH.FT_MultiConnection2D*
 472 * threshold is integer value (number of connections)
 473
 474 .. _filters_ex19.py:
 475
 476 ``filters_ex19.py``
 477
 478 .. literalinclude:: ../../../examples/filters_ex19.py
 479     :linenos:
 480     :language: python
 481
 482 :download:`../../../examples/filters_ex19.py`
 483
 484 **See also:** :ref:`tui_borders_at_multiconnection_2d`
 485
 486 .. _filter_length:
 487
 488 Length
 489 ======
 490
 491 filters 1D mesh elements (edges) according to the edge length value:
 492
 493 * element type should be *SMESH.EDGE*
 494 * functor type should be *SMESH.FT_Length*
 495 * threshold is floating point value (length)
 496
 497 .. _filters_ex20.py:
 498
 499 ``filters_ex20.py``
 500
 501 .. literalinclude:: ../../../examples/filters_ex20.py
 502     :linenos:
 503     :language: python
 504
 505 :download:`../../../examples/filters_ex20.py`
 506
 507 **See also:** :ref:`tui_length_1d`
 508
 509 .. _filter_length_2d:
 510
 511 Length 2D
 512 =========
 513
 514 filters 2D mesh elements (faces) according to the maximum length of its
 515 edges (links between nodes):
 516
 517 * element type should be *SMESH.FACE*
 518 * functor type should be *SMESH.FT_Length2D*
 519 * threshold is floating point value (edge length)
 520
 521 .. _filters_ex21.py:
 522
 523 ``filters_ex21.py``
 524
 525 .. literalinclude:: ../../../examples/filters_ex21.py
 526     :linenos:
 527     :language: python
 528
 529 :download:`../../../examples/filters_ex21.py`
 530
 531 **See also:** :ref:`tui_length_2d`
 532
 533 .. _filter_max_element_length_2d:
 534
 535 Element Diameter 2D
 536 ===================
 537
 538 filters 2D mesh elements (faces) according to the maximum length
 539 of its edges and diagonals:
 540
 541 * element type should be *SMESH.FACE*
 542 * functor type should be *SMESH.FT_MaxElementLength2D*
 543 * threshold is floating point value (length)
 544
 545 .. _filters_ex22.py:
 546
 547 ``filters_ex22.py``
 548
 549 .. literalinclude:: ../../../examples/filters_ex22.py
 550     :linenos:
 551     :language: python
 552
 553 :download:`../../../examples/filters_ex22.py`
 554
 555 **See also:** :ref:`tui_max_element_length_2d`
 556
 557 .. _filter_max_element_length_3d:
 558
 559 Element Diameter 3D
 560 ===================
 561
 562 filters 3D mesh elements (volumes) according to the maximum length
 563 of its edges and diagonals:
 564
 565 * element type should be *SMESH.VOLUME*
 566 * functor type should be *SMESH.FT_MaxElementLength3D*
 567 * threshold is floating point value (edge/diagonal length)
 568
 569 .. _filters_ex23.py:
 570
 571 ``filters_ex23.py``
 572
 573 .. literalinclude:: ../../../examples/filters_ex23.py
 574     :linenos:
 575     :language: python
 576
 577 :download:`../../../examples/filters_ex23.py`
 578
 579 **See also:** :ref:`tui_max_element_length_3d`
 580
 581 .. _filter_bare_border_volumes:
 582
 583 Bare border volumes
 584 ===================
 585
 586 filters 3D mesh elements with bare borders, i.e. having a facet not
 587 shared with other volumes and without a face on it:
 588
 589 * element type is *SMESH.VOLUME*
 590 * functor type is *SMESH.FT_BareBorderVolume*
 591 * threshold value is not required
 592
 593 .. _filters_ex24.py:
 594
 595 ``filters_ex24.py``
 596
 597 .. literalinclude:: ../../../examples/filters_ex24.py
 598     :linenos:
 599     :language: python
 600
 601 :download:`../../../examples/filters_ex24.py`
 602
 603 **See also:** :ref:`tui_bare_border_volumes`
 604
 605 .. _filter_over_constrained_volumes:
 606
 607 Over-constrained volumes
 608 ========================
 609
 610 filters over-constrained volumes, whose all nodes are on the mesh boundary:
 611
 612 * element type is *SMESH.VOLUME*
 613 * functor type is *SMESH.FT_OverConstrainedVolume*
 614 * threshold value is not required
 615
 616 .. _filters_ex25.py:
 617
 618 ``filters_ex25.py``
 619
 620 .. literalinclude:: ../../../examples/filters_ex25.py
 621     :linenos:
 622     :language: python
 623
 624 :download:`../../../examples/filters_ex25.py`
 625
 626 **See also:** :ref:`tui_over_constrained_faces`
 627
 628 .. _filter_belong_to_group:
 629
 630 Belong to Mesh Group
 631 ====================
 632
 633 filters mesh entities (nodes or elements) included in a mesh group
 634 defined by threshold value:
 635
 636 * element type can be any, from *SMESH.NODE* to *SMESH.BALL*
 637 * functor type should be *SMESH.FT_BelongToMeshGroup*
 638 * threshold is mesh group object
 639
 640 .. _filters_belong2group.py:
 641
 642 ``filters_belong2group.py``
 643
 644 .. literalinclude:: ../../../examples/filters_belong2group.py
 645     :linenos:
 646     :language: python
 647
 648 :download:`../../../examples/filters_belong2group.py`
 649
 650 .. _filter_belong_to_geom:
 651
 652 Belong to Geom
 653 ==============
 654
 655 filters mesh entities (nodes or elements) which all nodes lie on the
 656 shape defined by threshold value:
 657
 658 * element type can be any, from *SMESH.NODE* to *SMESH.BALL*
 659 * functor type should be *SMESH.FT_BelongToGeom*
 660 * threshold is geometrical object
 661 * tolerance is a distance between a node and the geometrical object; it is used if an node is not associated to any geometry.
 662
 663 .. _filters_ex26.py:
 664
 665 ``filters_ex26.py``
 666
 667 .. literalinclude:: ../../../examples/filters_ex26.py
 668     :linenos:
 669     :language: python
 670
 671 :download:`../../../examples/filters_ex26.py`
 672
 673 .. _filter_lying_on_geom:
 674
 675 Lying on Geom
 676 =============
 677
 678 filters mesh entities (nodes or elements) at least one node of which lies on the
 679 shape defined by threshold value:
 680
 681 * element type can be any, from *SMESH.NODE* to *SMESH.BALL*
 682 * functor type should be *SMESH.FT_LyingOnGeom*
 683 * threshold is geometrical object
 684 * tolerance is a distance between a node and the geometrical object;
 685
 686 it is used if an node is not associated to any geometry.
 687
 688 .. _filters_ex27.py:
 689
 690 ``filters_ex27.py``
 691
 692 .. literalinclude:: ../../../examples/filters_ex27.py
 693     :linenos:
 694     :language: python
 695
 696 :download:`../../../examples/filters_ex27.py`
 697
 698 .. _filter_belong_to_plane:
 699
 700 Belong to Plane
 701 ===============
 702
 703 filters mesh entities (nodes or elements) which all nodes belong to the
 704 plane defined by threshold value with the given tolerance:
 705
 706 * element type can be any except *SMESH.VOLUME*
 707 * functor type should be *SMESH.FT_BelongToPlane*
 708 * threshold is geometrical object (plane)
 709 * default tolerance is 1.0e-7
 710
 711 .. _filters_ex28.py:
 712
 713 ``filters_ex28.py``
 714
 715 .. literalinclude:: ../../../examples/filters_ex28.py
 716     :linenos:
 717     :language: python
 718
 719 :download:`../../../examples/filters_ex28.py`
 720
 721 .. _filter_belong_to_cylinder:
 722
 723 Belong to Cylinder
 724 ==================
 725
 726 filters mesh entities (nodes or elements) which all nodes belong to the
 727 cylindrical face defined by threshold value with the given tolerance:
 728
 729 * element type can be any except *SMESH.VOLUME*
 730 * functor type should be *SMESH.FT_BelongToCylinder*
 731 * threshold is geometrical object (cylindrical face)
 732 * default tolerance is 1.0e-7
 733
 734 .. _filters_ex29.py:
 735
 736 ``filters_ex29.py``
 737
 738 .. literalinclude:: ../../../examples/filters_ex29.py
 739     :linenos:
 740     :language: python
 741
 742 :download:`../../../examples/filters_ex29.py`
 743
 744 .. _filter_belong_to_surface:
 745
 746 Belong to Surface
 747 =================
 748
 749 filters mesh entities (nodes or elements) which all nodes belong to the
 750 arbitrary surface defined by threshold value with the given tolerance:
 751
 752 * element type can be any except *SMESH.VOLUME*
 753 * functor type should be *SMESH.FT_BelongToGenSurface*
 754 * threshold is geometrical object (arbitrary surface)
 755 * default tolerance is 1.0e-7
 756
 757 .. _filters_ex30.py:
 758
 759 ``filters_ex30.py``
 760
 761 .. literalinclude:: ../../../examples/filters_ex30.py
 762     :linenos:
 763     :language: python
 764
 765 :download:`../../../examples/filters_ex30.py`
 766
 767 .. _filter_range_of_ids:
 768
 769 Range of IDs
 770 ============
 771
 772 filters mesh entities elements (nodes or elements) according to the
 773 specified identifiers range:
 774
 775 * element type can be any, from *SMESH.NODE* to *SMESH.BALL*
 776 * functor type is *SMESH.FT_RangeOfIds*
 777 * threshold is string listing required IDs and/or ranges of IDs, e.g."1,2,3,50-60,63,67,70-78"
 778
 779 .. _filters_ex31.py:
 780
 781 ``filters_ex31.py``
 782
 783 .. literalinclude:: ../../../examples/filters_ex31.py
 784     :linenos:
 785     :language: python
 786
 787 :download:`../../../examples/filters_ex31.py`
 788
 789 .. _filter_bad_oriented_volume:
 790
 791 Badly oriented volume
 792 =====================
 793
 794 filters 3D mesh elements (volumes), which are incorrectly oriented from
 795 the point of view of MED convention.
 796
 797 * element type should be *SMESH.VOLUME*
 798 * functor type is *SMESH.FT_BadOrientedVolume*
 799 * threshold is not required
 800
 801 .. _filters_ex32.py:
 802
 803 ``filters_ex32.py``
 804
 805 .. literalinclude:: ../../../examples/filters_ex32.py
 806     :linenos:
 807     :language: python
 808
 809 :download:`../../../examples/filters_ex32.py`
 810
 811 .. _filter_linear_or_quadratic:
 812
 813 Linear / quadratic
 814 ==================
 815
 816 filters linear / quadratic mesh elements:
 817
 818 * element type should be either *SMESH.EDGE*, *SMESH.FACE* or *SMESH.VOLUME*
 819 * functor type is *SMESH.FT_LinearOrQuadratic*
 820 * threshold is not required
 821 * if unary operator is set to SMESH.FT_LogicalNOT, the quadratic elements are selected, otherwise (by default) linear elements are selected
 822
 823 .. _filters_ex33.py:
 824
 825 ``filters_ex33.py``
 826
 827 .. literalinclude:: ../../../examples/filters_ex33.py
 828     :linenos:
 829     :language: python
 830
 831 :download:`../../../examples/filters_ex33.py`
 832
 833 .. _filter_group_color:
 834
 835 Group color
 836 ===========
 837
 838 filters mesh entities, belonging to the group with the color defined by the threshold value.
 839
 840 * element type can be any, from *SMESH.NODE* to *SMESH.BALL*
 841 * functor type is *SMESH.FT_GroupColor*
 842 * threshold should be of SALOMEDS.Color type
 843
 844 .. _filters_ex34.py:
 845
 846 ``filters_ex34.py``
 847
 848 .. literalinclude:: ../../../examples/filters_ex34.py
 849     :linenos:
 850     :language: python
 851
 852 :download:`../../../examples/filters_ex34.py`
 853
 854 .. _filter_geom_type:
 855
 856 Geometry type
 857 =============
 858
 859 filters mesh elements by the geometric type defined with the threshold
 860 value. The list of available geometric types depends on the element
 861 entity type.
 862
 863 * element type can be any, e.g.: *SMESH.EDGE*, *SMESH.FACE*, *SMESH.VOLUME*, etc.
 864 * functor type should be *SMESH.FT_ElemGeomType*
 865 * threshold is either of smesh.GeometryType values. Type *SMESH.GeometryType._items* in the Python Console to see all geometric types.
 866
 867 .. _filters_ex35.py:
 868
 869 ``filters_ex35.py``
 870
 871 .. literalinclude:: ../../../examples/filters_ex35.py
 872     :linenos:
 873     :language: python
 874
 875 :download:`../../../examples/filters_ex35.py`
 876
 877 .. _filter_entity_type:
 878
 879 Entity type
 880 ===========
 881
 882 filters mesh elements by the geometric type and number of nodes.
 883
 884 * element type can be any, e.g.: *SMESH.EDGE*, *SMESH.FACE*, *SMESH.VOLUME*, etc.
 885 * functor type should be *SMESH.FT_EntityType*
 886 * threshold is either of SMESH.EntityType values. Type *SMESH.EntityType._items* in the Python Console to see all entity types.
 887
 888 .. _filters_ex37.py:
 889
 890 ``filters_ex37.py``
 891
 892 .. literalinclude:: ../../../examples/filters_ex37.py
 893     :linenos:
 894     :language: python
 895
 896 :download:`../../../examples/filters_ex37.py`
 897
 898 .. _filter_ball_diam:
 899
 900 Ball diameter
 901 =============
 902
 903 filters ball elements by diameter.
 904
 905 * element type should be *SMESH.BALL*
 906 * functor type should be *SMESH.FT_BallDiameter*
 907 * threshold is floating point value (ball diameter)
 908
 909 .. _filters_ex38.py:
 910
 911 ``filters_ex38.py``
 912
 913 .. literalinclude:: ../../../examples/filters_ex38.py
 914     :linenos:
 915     :language: python
 916
 917 :download:`../../../examples/filters_ex38.py`
 918
 919 .. _filter_domain:
 920
 921 Elements of a domain
 922 ====================
 923
 924 filters elements of a specified domain.
 925
 926 * element type can be any, e.g.: *SMESH.EDGE*, *SMESH.FACE*, *SMESH.VOLUME*, etc.
 927 * functor type should be *SMESH.FT_ConnectedElements*
 928 * threshold is either (1) node ID or (2)  geometrical vertex or (3) 3 coordinates of a point.
 929
 930 .. _filters_ex39.py:
 931
 932 ``filters_ex39.py``
 933
 934 .. literalinclude:: ../../../examples/filters_ex39.py
 935     :linenos:
 936     :language: python
 937
 938 :download:`../../../examples/filters_ex39.py`
 939
 940 .. _combining_filters:
 941
 942 How to combine several criteria into a filter?
 943 ==============================================
 944
 945 Several criteria can be combined into a filter.
 946
 947 Example :
 948
 949 .. _filters_ex36.py:
 950
 951 ``filters_ex36.py``
 952
 953 .. literalinclude:: ../../../examples/filters_ex36.py
 954     :linenos:
 955     :language: python
 956
 957 :download:`../../../examples/filters_ex36.py`
 958
 959