Source code for bokeh.models.selections

#-----------------------------------------------------------------------------
# Copyright (c) 2012 - 2022, Anaconda, Inc., and Bokeh Contributors.
# All rights reserved.
#
# The full license is in the file LICENSE.txt, distributed with this software.
#-----------------------------------------------------------------------------

#-----------------------------------------------------------------------------
# Boilerplate
#-----------------------------------------------------------------------------
from __future__ import annotations

import logging # isort:skip
log = logging.getLogger(__name__)

#-----------------------------------------------------------------------------
# Imports
#-----------------------------------------------------------------------------

# Bokeh imports
from ..core.has_props import abstract
from ..core.properties import (
    Dict,
    Int,
    Seq,
    String,
)
from ..model import Model

#-----------------------------------------------------------------------------
# Globals and constants
#-----------------------------------------------------------------------------

__all__ = (
    'IntersectRenderers',
    'Selection',
    'SelectionPolicy',
    'UnionRenderers',
)

#-----------------------------------------------------------------------------
# General API
#-----------------------------------------------------------------------------

[docs]class Selection(Model): ''' A Selection represents a portion of the data in a ``DataSource``, which can be visually manipulated in a plot. Selections are typically created by selecting points in a plot with a ``SelectTool``, but can also be programmatically specified. For most glyphs, the ``indices`` property is the relevant value to use. ''' indices = Seq(Int, default=[], help=""" The "scatter" level indices included in a selection. For example, for a selection on a ``Circle`` glyph, this list records the indices of which individual circles are selected. For "multi" glyphs such as ``Patches``, ``MultiLine``, ``MultiPolygons``, etc, this list records the indices of which entire sub-items are selected. For example, which indidual polygons of a ``MultiPolygon`` are selected. """) line_indices = Seq(Int, default=[], help=""" The point indices included in a selection on a ``Line`` glyph. This value records the indices of the individual points on a ``Line`` that were selected by a selection tool. """) multiline_indices = Dict(String, Seq(Int), default={}, help=""" The detailed point indices included in a selection on a ``MultiLine``. This value records which points, on which lines, are part of a seletion on a ``MulitLine``. The keys are the top level indices (i.e., which line) which map to lists of indices (i.e. which points on that line). If you only need to know which lines are selected, without knowing what individual points on those lines are selected, then you can look at the keys of this dictionary (converted to ints). """)
# TODO (bev) image_indicies
[docs]@abstract class SelectionPolicy(Model): ''' ''' pass
[docs]class IntersectRenderers(SelectionPolicy): ''' When a data source is shared between multiple renderers, a row in the data source will only be selected if that point for each renderer is selected. The selection is made from the intersection of hit test results from all renderers. ''' pass
[docs]class UnionRenderers(SelectionPolicy): ''' When a data source is shared between multiple renderers, selecting a point on from any renderer will cause that row in the data source to be selected. The selection is made from the union of hit test results from all renderers. ''' pass
#----------------------------------------------------------------------------- # Dev API #----------------------------------------------------------------------------- #----------------------------------------------------------------------------- # Private API #----------------------------------------------------------------------------- #----------------------------------------------------------------------------- # Code #-----------------------------------------------------------------------------