Filters usage
*************
-.. contents:: `Table of contents`
-
-
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
**See also:** :ref:`tui_quality_controls_page`
+.. contents:: `Table of contents`
+
+
.. _filter_aspect_ratio:
Aspect ratio
* functor type should be *SMESH.FT_AspectRatio*
* threshold is floating point value (aspect ratio)
-.. _filters_ex01.py:
-
-``filters_ex01.py``
-
.. literalinclude:: ../../../examples/filters_ex01.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex01.py`
+:download:`Download this script <../../../examples/filters_ex01.py>`
**See also:** :ref:`tui_aspect_ratio`
* functor type is *SMESH.FT_AspectRatio3D*
* threshold is floating point value (aspect ratio)
-.. _filters_ex02.py:
-
-``filters_ex02.py``
-
.. literalinclude:: ../../../examples/filters_ex02.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex02.py`
+:download:`Download this script <../../../examples/filters_ex02.py>`
**See also:** :ref:`tui_aspect_ratio_3d`
* functor type is *SMESH.FT_Warping*
* threshold is floating point value (warping angle)
-.. _filters_ex03.py:
-
-``filters_ex03.py``
-
.. literalinclude:: ../../../examples/filters_ex03.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex03.py`
+:download:`Download this script <../../../examples/filters_ex03.py>`
**See also:** :ref:`tui_warping`
* functor type is *SMESH.FT_MinimumAngle*
* threshold is floating point value (minimum angle)
-.. _filters_ex04.py:
-
-``filters_ex04.py``
-
.. literalinclude:: ../../../examples/filters_ex04.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex04.py`
+:download:`Download this script <../../../examples/filters_ex04.py>`
**See also:** :ref:`tui_minimum_angle`
* functor type is *SMESH.FT_Taper*
* threshold is floating point value (taper)
-.. _filters_ex05.py:
-
-``filters_ex05.py``
-
.. literalinclude:: ../../../examples/filters_ex05.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex05.py`
+:download:`Download this script <../../../examples/filters_ex05.py>`
**See also:** :ref:`tui_taper`
* functor type is *SMESH.FT_Skew*
* threshold is floating point value (skew)
-.. _filters_ex06.py:
-
-``filters_ex06.py``
-
.. literalinclude:: ../../../examples/filters_ex06.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex06.py`
+:download:`Download this script <../../../examples/filters_ex06.py>`
**See also:** :ref:`tui_skew`
* functor type is *SMESH.FT_Area*
* threshold is floating point value (area)
-.. _filters_ex07.py:
-
-``filters_ex07.py``
-
.. literalinclude:: ../../../examples/filters_ex07.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex07.py`
+:download:`Download this script <../../../examples/filters_ex07.py>`
**See also:** :ref:`tui_area`
* functor type is *SMESH.FT_Volume3D*
* threshold is floating point value (volume)
-.. _filters_ex08.py:
-
-``filters_ex08.py``
-
.. literalinclude:: ../../../examples/filters_ex08.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex08.py`
+:download:`Download this script <../../../examples/filters_ex08.py>`
**See also:** :ref:`tui_volume`
* functor type is *SMESH.FT_FreeBorders*
* threshold value is not required
-\tui_script{filters_ex09.py}
-.. _filters_ex09.py:
-
-``filters_ex09.py``
-
.. literalinclude:: ../../../examples/filters_ex09.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex09.py`
+:download:`Download this script <../../../examples/filters_ex09.py>`
**See also:** :ref:`tui_free_borders`
* functor type is *SMESH.FT_FreeEdges*
* threshold value is not required
-.. _filters_ex10.py:
-
-``filters_ex10.py``
-
.. literalinclude:: ../../../examples/filters_ex10.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex10.py`
+:download:`Download this script <../../../examples/filters_ex10.py>`
**See also:** :ref:`tui_free_edges`
* functor type is *SMESH.FT_FreeNodes*
* threshold value is not required
-.. _filters_ex11.py:
-
-``filters_ex11.py``
-
.. literalinclude:: ../../../examples/filters_ex11.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex11.py`
+:download:`Download this script <../../../examples/filters_ex11.py>`
**See also:** :ref:`tui_free_nodes`
* functor type is *SMESH.FT_FreeFaces*
* threshold value is not required
-.. _filters_ex12.py:
-
-``filters_ex12.py``
-
.. literalinclude:: ../../../examples/filters_ex12.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex12.py`
+:download:`Download this script <../../../examples/filters_ex12.py>`
**See also:** :ref:`tui_free_faces`
* functor type is *SMESH.FT_BareBorderFace*
* threshold value is not required
-.. _filters_ex13.py:
-
-``filters_ex13.py``
-
.. literalinclude:: ../../../examples/filters_ex13.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex13.py`
+:download:`Download this script <../../../examples/filters_ex13.py>`
**See also:** :ref:`tui_bare_border_faces`
* threshold value is the face ID
* tolerance is in degrees
-.. _filters_ex14.py:
-
-``filters_ex14.py``
-
.. literalinclude:: ../../../examples/filters_ex14.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex14.py`
+:download:`Download this script <../../../examples/filters_ex14.py>`
.. _filter_over_constrained_faces:
* functor type is *SMESH.FT_OverConstrainedFace*
* threshold value is not required
-.. _filters_ex15.py:
-
-``filters_ex15.py``
-
.. literalinclude:: ../../../examples/filters_ex15.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex15.py`
+:download:`Download this script <../../../examples/filters_ex15.py>`
**See also:** :ref:`tui_over_constrained_faces`
filters mesh elements basing on the same set of nodes:
-* element type is either *SMESH.EGDE*, *SMESH.FACE* or *SMESH.VOLUME*
+* element type is either *SMESH.EDGE*, *SMESH.FACE* or *SMESH.VOLUME*
* functor type is either *SMESH.FT_EqualEdges*, *SMESH.FT_EqualFaces* or *SMESH.FT_EqualVolumes*,
* threshold value is not required
-.. _filters_ex16.py:
-
-``filters_ex16.py``
-
.. literalinclude:: ../../../examples/filters_ex16.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex16.py`
+:download:`Download this script <../../../examples/filters_ex16.py>`
.. _tui_double_nodes_control:
* threshold value is not required
* default tolerance is 1.0e-7
-.. _filters_ex17.py:
-
-``filters_ex17.py``
-
.. literalinclude:: ../../../examples/filters_ex17.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex17.py`
+:download:`Download this script <../../../examples/filters_ex17.py>`
.. _filter_node_nb_conn:
* functor type should be *SMESH.FT_NodeConnectivityNumber*
* threshold is an integer value (number of elements)
-.. _filters_node_nb_conn.py:
-
-``filters_node_nb_conn.py``
-
.. literalinclude:: ../../../examples/filters_node_nb_conn.py
- :linenos:
:language: python
-:download:`../../../examples/filters_node_nb_conn.py`
+:download:`Download this script <../../../examples/filters_node_nb_conn.py>`
.. _filter_borders_multiconnection:
* functor type is *SMESH.FT_MultiConnection*
* threshold is integer value (number of connections)
-.. _filters_ex18.py:
-
-``filters_ex18.py``
-
.. literalinclude:: ../../../examples/filters_ex18.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex18.py`
+:download:`Download this script <../../../examples/filters_ex18.py>`
**See also:** :ref:`tui_borders_at_multiconnection`
* functor type is *SMESH.FT_MultiConnection2D*
* threshold is integer value (number of connections)
-.. _filters_ex19.py:
-
-``filters_ex19.py``
-
.. literalinclude:: ../../../examples/filters_ex19.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex19.py`
+:download:`Download this script <../../../examples/filters_ex19.py>`
**See also:** :ref:`tui_borders_at_multiconnection_2d`
* functor type should be *SMESH.FT_Length*
* threshold is floating point value (length)
-.. _filters_ex20.py:
-
-``filters_ex20.py``
-
.. literalinclude:: ../../../examples/filters_ex20.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex20.py`
+:download:`Download this script <../../../examples/filters_ex20.py>`
**See also:** :ref:`tui_length_1d`
* functor type should be *SMESH.FT_Length2D*
* threshold is floating point value (edge length)
-.. _filters_ex21.py:
-
-``filters_ex21.py``
-
.. literalinclude:: ../../../examples/filters_ex21.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex21.py`
+:download:`Download this script <../../../examples/filters_ex21.py>`
**See also:** :ref:`tui_length_2d`
* functor type should be *SMESH.FT_MaxElementLength2D*
* threshold is floating point value (length)
-.. _filters_ex22.py:
-
-``filters_ex22.py``
-
.. literalinclude:: ../../../examples/filters_ex22.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex22.py`
+:download:`Download this script <../../../examples/filters_ex22.py>`
**See also:** :ref:`tui_max_element_length_2d`
* functor type should be *SMESH.FT_MaxElementLength3D*
* threshold is floating point value (edge/diagonal length)
-.. _filters_ex23.py:
-
-``filters_ex23.py``
-
.. literalinclude:: ../../../examples/filters_ex23.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex23.py`
+:download:`Download this script <../../../examples/filters_ex23.py>`
**See also:** :ref:`tui_max_element_length_3d`
* functor type is *SMESH.FT_BareBorderVolume*
* threshold value is not required
-.. _filters_ex24.py:
-
-``filters_ex24.py``
-
.. literalinclude:: ../../../examples/filters_ex24.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex24.py`
+:download:`Download this script <../../../examples/filters_ex24.py>`
**See also:** :ref:`tui_bare_border_volumes`
* functor type is *SMESH.FT_OverConstrainedVolume*
* threshold value is not required
-.. _filters_ex25.py:
-
-``filters_ex25.py``
-
.. literalinclude:: ../../../examples/filters_ex25.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex25.py`
+:download:`Download this script <../../../examples/filters_ex25.py>`
**See also:** :ref:`tui_over_constrained_faces`
* functor type should be *SMESH.FT_BelongToMeshGroup*
* threshold is mesh group object
-.. _filters_belong2group.py:
-
-``filters_belong2group.py``
-
.. literalinclude:: ../../../examples/filters_belong2group.py
- :linenos:
:language: python
-:download:`../../../examples/filters_belong2group.py`
+:download:`Download this script <../../../examples/filters_belong2group.py>`
.. _filter_belong_to_geom:
* threshold is geometrical object
* tolerance is a distance between a node and the geometrical object; it is used if an node is not associated to any geometry.
-.. _filters_ex26.py:
-
-``filters_ex26.py``
-
.. literalinclude:: ../../../examples/filters_ex26.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex26.py`
+:download:`Download this script <../../../examples/filters_ex26.py>`
.. _filter_lying_on_geom:
it is used if an node is not associated to any geometry.
-.. _filters_ex27.py:
-
-``filters_ex27.py``
-
.. literalinclude:: ../../../examples/filters_ex27.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex27.py`
+:download:`Download this script <../../../examples/filters_ex27.py>`
.. _filter_belong_to_plane:
* threshold is geometrical object (plane)
* default tolerance is 1.0e-7
-.. _filters_ex28.py:
-
-``filters_ex28.py``
-
.. literalinclude:: ../../../examples/filters_ex28.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex28.py`
+:download:`Download this script <../../../examples/filters_ex28.py>`
.. _filter_belong_to_cylinder:
* threshold is geometrical object (cylindrical face)
* default tolerance is 1.0e-7
-.. _filters_ex29.py:
-
-``filters_ex29.py``
-
.. literalinclude:: ../../../examples/filters_ex29.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex29.py`
+:download:`Download this script <../../../examples/filters_ex29.py>`
.. _filter_belong_to_surface:
* threshold is geometrical object (arbitrary surface)
* default tolerance is 1.0e-7
-.. _filters_ex30.py:
-
-``filters_ex30.py``
-
.. literalinclude:: ../../../examples/filters_ex30.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex30.py`
+:download:`Download this script <../../../examples/filters_ex30.py>`
.. _filter_range_of_ids:
* element type can be any, from *SMESH.NODE* to *SMESH.BALL*
* functor type is *SMESH.FT_RangeOfIds*
-* threshold is string listing required IDs and/or ranges of IDs, e.g."1,2,3,50-60,63,67,70-78"
-
-.. _filters_ex31.py:
-
-``filters_ex31.py``
+* threshold is string listing required IDs and/or ranges of IDs, e.g."1,2,3,50-60,63,67,70-78"
.. literalinclude:: ../../../examples/filters_ex31.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex31.py`
+:download:`Download this script <../../../examples/filters_ex31.py>`
.. _filter_bad_oriented_volume:
* functor type is *SMESH.FT_BadOrientedVolume*
* threshold is not required
-.. _filters_ex32.py:
-
-``filters_ex32.py``
-
.. literalinclude:: ../../../examples/filters_ex32.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex32.py`
+:download:`Download this script <../../../examples/filters_ex32.py>`
.. _filter_linear_or_quadratic:
* threshold is not required
* if unary operator is set to SMESH.FT_LogicalNOT, the quadratic elements are selected, otherwise (by default) linear elements are selected
-.. _filters_ex33.py:
-
-``filters_ex33.py``
-
.. literalinclude:: ../../../examples/filters_ex33.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex33.py`
+:download:`Download this script <../../../examples/filters_ex33.py>`
.. _filter_group_color:
* functor type is *SMESH.FT_GroupColor*
* threshold should be of SALOMEDS.Color type
-.. _filters_ex34.py:
-
-``filters_ex34.py``
-
.. literalinclude:: ../../../examples/filters_ex34.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex34.py`
+:download:`Download this script <../../../examples/filters_ex34.py>`
.. _filter_geom_type:
* functor type should be *SMESH.FT_ElemGeomType*
* threshold is either of smesh.GeometryType values. Type *SMESH.GeometryType._items* in the Python Console to see all geometric types.
-.. _filters_ex35.py:
-
-``filters_ex35.py``
-
.. literalinclude:: ../../../examples/filters_ex35.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex35.py`
+:download:`Download this script <../../../examples/filters_ex35.py>`
.. _filter_entity_type:
* functor type should be *SMESH.FT_EntityType*
* threshold is either of SMESH.EntityType values. Type *SMESH.EntityType._items* in the Python Console to see all entity types.
-.. _filters_ex37.py:
-
-``filters_ex37.py``
-
.. literalinclude:: ../../../examples/filters_ex37.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex37.py`
+:download:`Download this script <../../../examples/filters_ex37.py>`
.. _filter_ball_diam:
* functor type should be *SMESH.FT_BallDiameter*
* threshold is floating point value (ball diameter)
-.. _filters_ex38.py:
-
-``filters_ex38.py``
-
.. literalinclude:: ../../../examples/filters_ex38.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex38.py`
+:download:`Download this script <../../../examples/filters_ex38.py>`
.. _filter_domain:
* functor type should be *SMESH.FT_ConnectedElements*
* threshold is either (1) node ID or (2) geometrical vertex or (3) 3 coordinates of a point.
-.. _filters_ex39.py:
-
-``filters_ex39.py``
-
.. literalinclude:: ../../../examples/filters_ex39.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex39.py`
+:download:`Download this script <../../../examples/filters_ex39.py>`
.. _combining_filters:
Several criteria can be combined into a filter.
-Example :
-
-.. _filters_ex36.py:
-
-``filters_ex36.py``
-
.. literalinclude:: ../../../examples/filters_ex36.py
- :linenos:
:language: python
-:download:`../../../examples/filters_ex36.py`
-
-
+:download:`Download this script <../../../examples/filters_ex36.py>`