selection Module¶
selection is a module for defining and using selections via Python. It provides a convenience layer to provide functionality provided by the underlying C++ classes.
A simple example:
from paraview.selection import *
# Create a new sphere proxy on the active connection and register it
# in the sources group.
sphere = Sphere(ThetaResolution=16, PhiResolution=32)
# Show the sphere
Show(sphere)
# Select cells falling inside a rectangle defined by two points on a diagonal,
# (300, 400) and (600, 800).
SelectSurfaceCells(Rectangle=[300, 400, 600, 800])
# Add cells on processor 0 with ids 1 and 2 to the current selection.
SelectIDs(IDs=[0, 1, 0, 2], FieldType='CELL', Source=sphere, Modifier='ADD')
# Remove cells on processor 0 with ids 4 and 5 from the current selection.
SelectIDS(IDs=[0, 4, 0, 5], FieldType='CELL', Source=sphere, Modifier='SUBTRACT')
# Extract the currently extracted cells
es = ExtractSelection()
Show(es)
- paraview.selection.ClearSelection(Source=None)[source]¶
Clears the selection on the source passed in to the source parameter or the active source if no source is provided.
- paraview.selection.CreateSelection(proxyname, registrationname, **args)[source]¶
Make a new selection source proxy. Can be either vtkSelection or vtkAppendSelection. Use this so that selection don’t show up in the pipeline.
- paraview.selection.QuerySelect(QueryString='', FieldType='POINT', Source=None, InsideOut=False)[source]¶
Selection by query expression.
- Parameters
QueryString (str) – string with NumPy-like boolean expression defining which attributes are selected
FieldType (str) – attribute to select, e.g., ‘POINT’ or ‘CELL’
Source (paraview.servermanager.source.Proxy) – if not set, then the selection will be on the active source
InsideOut (bool) – Invert the selection so that attributes that do not satisfy the expression are selected instead of elements that do.
- Returns
None
- paraview.selection.SelectCellsThrough(Rectangle=[], View=None, Modifier=None)[source]¶
Select all cells within a rectangular region regardless of their visibility.
Rectangle - list containing bottom left (x1, y1) and top right (x2, y2) corner of a rectangle defining the selection region in the format [x1, y1, x2, y2]. Defined in pixels.
View - the view in which to perform the selection. If None, uses the current active view.
- paraview.selection.SelectCompositeDataIDs(IDs=[], FieldType='POINT', ContainingCells=False, Source=None, Modifier=None)[source]¶
Select attributes by composite attribute IDs.
IDs - list of IDs of attribute types to select. Defined as 3-tuples of (flat block index, process number, attribute ID) interleaved in a single list.
FieldType - type of attribute to select, e.g., ‘POINT’, ‘CELL’
- ContainingCells - if True and FieldType is ‘POINT’, select the cells containing the
points corresponding to the given IDs.
Source - If not None, specifies the sources whose elements should be selected by ID.
- Modifier - ‘ADD’, ‘SUBTRACT’, ‘TOGGLE’, or None to define whether and how the selection
should modify the existing selection.
- paraview.selection.SelectGlobalIDs(IDs=[], FieldType='POINT', ContainingCells=False, Source=None, Modifier=None)[source]¶
Select attributes by global IDs.
IDs - list of IDs of attribute types to select. Defined as a list of global IDs.
FieldType - type of attribute to select, e.g., ‘POINT’, ‘CELL’
- ContainingCells - if True and FieldType is ‘POINT’, select the cells containing the
points corresponding to the given IDs.
Source - If not None, specifies the sources whose elements should be selected by ID.
- Modifier - ‘ADD’, ‘SUBTRACT’, ‘TOGGLE’, or None to define whether and how the selection
should modify the existing selection.
- paraview.selection.SelectHierarchicalDataIDs(IDs=[], FieldType='POINT', ContainingCells=False, Source=None, Modifier=None)[source]¶
Select attributes by hierarchical data IDs.
IDs - list of IDs of attribute types to select. Defined as 3-tuples of (level, index, attribute ID) interleaved in a single list.
FieldType - type of attribute to select, e.g., ‘POINT’, ‘CELL’
- ContainingCells - if True and FieldType is ‘POINT’, select the cells containing the
points corresponding to the given IDs.
Source - If not None, specifies the sources whose elements should be selected by ID.
- Modifier - ‘ADD’, ‘SUBTRACT’, ‘TOGGLE’, or None to define whether and how the selection
should modify the existing selection.
- paraview.selection.SelectIDs(IDs=[], FieldType='POINT', ContainingCells=False, Source=None, Modifier=None)[source]¶
Select attributes by attribute IDs.
IDs - list of IDs of attribute types to select. Defined as (process number, attribute ID) pairs interleaved in a single list. For multiblock datasets, this will select attributes on all blocks of the provided (processor number, attribute ID) pairs
FieldType - type of attribute to select, e.g., ‘POINT’, ‘CELL’
- ContainingCells - if True and FieldType is ‘POINT’, select the cells containing the
points corresponding to the given IDs.
Source - If not None, specifies the sources whose elements should be selected by ID.
- Modifier - ‘ADD’, ‘SUBTRACT’, ‘TOGGLE’, or None to define whether and how the selection
should modify the existing selection.
- paraview.selection.SelectLocation(Locations=[], Source=None, Modifier=None)[source]¶
Select points by location.
Locations - list of x, y, z points to select.
Source - if not set, then the selection will be on the active source
- paraview.selection.SelectPedigreeIDs(IDs=[], FieldType='POINT', ContainingCells=False, Source=None, Modifier=None)[source]¶
Select attributes by Pedigree IDs.
IDs - list of IDs of attribute types to select. Defined as (domain, ID) pairs interleaved in a single list.
FieldType - type of attribute to select, e.g., ‘POINT’, ‘CELL’
- ContainingCells - if True and FieldType is ‘POINT’, select the cells containing the
points corresponding to the given IDs.
Source - If not None, specifies the sources whose elements should be selected by ID.
- Modifier - ‘ADD’, ‘SUBTRACT’, ‘TOGGLE’, or None to define whether and how the selection
should modify the existing selection.
- paraview.selection.SelectPointsThrough(Rectangle=[], View=None, Modifier=None)[source]¶
Select all points within a rectangular region regardless of their visibility.
Rectangle - list containing bottom left (x1, y1) and top right (x2, y2) corner of a rectangle defining the selection region in the format [x1, y1, x2, y2]. Defined in pixels.
View - the view in which to perform the selection. If None, uses the current active view.
- paraview.selection.SelectSurfaceBlocks(Rectangle=[], View=None, Modifier=None)[source]¶
Select visible blocks within a rectangular region.
Rectangle - list containing bottom left (x1, y1) and top right (x2, y2) corner of a rectangle defining the selection region in the format [x1, y1, x2, y2]. Defined in pixels.
View - the view in which to perform the selection. If None, uses the current active view.
Modifier - ‘ADD’, ‘SUBTRACT’, ‘TOGGLE’, or None to define whether and how the selection should modify the existing selection.
- paraview.selection.SelectSurfaceCells(Rectangle=[], Polygon=[], View=None, Modifier=None)[source]¶
Select visible cells within a rectangular or polygon region.
Rectangle - list containing bottom left (x1, y1) and top right (x2, y2) corner of a rectangle defining the selection region in the format [x1, y1, x2, y2]. Defined in pixels. If not empty, the Polygon parameter must be empty or None.
- Polygon - list of 2D points defining a polygon in which visible points should be selected,
e.g., [x1, y1, x2, y2, …, xn, yn]. Defined in pixels. If not empty, the Rectangle parameter must be empty or None.
View - the view in which to perform the selection. If None, uses the current active view.
Modifier - ‘ADD’, ‘SUBTRACT’, ‘TOGGLE’, or None to define whether and how the selection should modify the existing selection.
- paraview.selection.SelectSurfacePoints(Rectangle=[], Polygon=[], View=None, Modifier=None)[source]¶
Select visible points within a rectangular or polygon region.
Rectangle - list containing bottom left (x1, y1) and top right (x2, y2) corner of a rectangle defining the selection region in the format [x1, y1, x2, y2]. Defined in pixels. If not empty, the Polygon parameter must be empty or None.
- Polygon - list of 2D points defining a polygon in which visible points should be selected,
e.g., [x1, y1, x2, y2, …, xn, yn]. Defined in pixels. If not empty, the Rectangle parameter must be empty or None.
View - the view in which to perform the selection. If None, uses the current active view.
Modifier - ‘ADD’, ‘SUBTRACT’, ‘TOGGLE’, or None to define whether and how the selection should modify the existing selection.
- paraview.selection.SelectThresholds(Thresholds=[], ArrayName='', FieldType='POINT', Source=None, Modifier=None)[source]¶
Select attributes in a source by thresholding on values in an associated array.
Thresholds - list of lower and upper threshold bounds. Attributes with associated values in the selected array between any set of bounds will be selected.
ArrayName - name of the array to threshold.
FieldType - atttribute to select, e.g., ‘POINT’ or ‘CELL’
Source - if not set, then the selection will be on the active source
- class paraview.selection.SelectionProxy(**args)[source]¶
Bases:
paraview.servermanager.Proxy
Special proxy wrapper type for Selections.