Source code for bokeh.models.renderers.glyph_renderer

# Copyright (c) 2012 - 2024, 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

# Standard library imports
from difflib import get_close_matches
from typing import TYPE_CHECKING, Any, Literal

# Bokeh imports
from import Field

# Bokeh imports
from import (
from ...core.validation import error
from ...core.validation.errors import BAD_COLUMN_NAME, CDSVIEW_FILTERS_WITH_CONNECTED
from ..filters import AllIndices
from ..glyphs import ConnectedXYGlyph, Glyph
from import Decoration, Marking
from ..sources import (
from .renderer import DataRenderer

    from ..annotations import ColorBar

# Globals and constants

__all__ = (

# General API

[docs] class GlyphRenderer(DataRenderer): ''' ''' # explicit __init__ to support Init signatures def __init__(self, *args, **kwargs) -> None: super().__init__(*args, **kwargs) @error(CDSVIEW_FILTERS_WITH_CONNECTED) def _check_cdsview_filters_with_connected(self): if isinstance(self.glyph, ConnectedXYGlyph) and not isinstance(self.view.filter, AllIndices): return str(self) @error(BAD_COLUMN_NAME) def _check_bad_column_name(self): source = self.data_source if not isinstance(source, ColumnDataSource) or isinstance(source, WebDataSource): return colnames = source.column_names props = self.glyph.properties_with_values(include_defaults=False) specs = self.glyph.dataspecs().keys() & props.keys() missing = [] for spec in sorted(specs): if isinstance(props[spec], Field) and (field := props[spec].field) not in colnames: if close := get_close_matches(field, colnames, n=1): missing.append(f"{spec}={field!r} [closest match: {close[0]!r}]") else: missing.append(f"{spec}={field!r} [no close matches]") if missing: return f"{', '.join(missing)} {{renderer: {self}}}" data_source = Required(Instance(DataSource), help=""" Local data source to use when rendering glyphs on the plot. """) view = Instance(CDSView, default=InstanceDefault(CDSView), help=""" A view into the data source to use when rendering glyphs. A default view of the entire data source is created when a view is not passed in during initialization. .. note: Only the default (filterless) CDSView is compatible with glyphs that have connected topology, such as Line and Patch. Setting filters on views for these glyphs will result in a warning and undefined behavior. """) glyph = Required(Instance(Glyph), help=""" The glyph to render, in conjunction with the supplied data source and ranges. """) selection_glyph = Nullable(Either(Auto, Instance(Glyph)), default="auto", help=""" An optional glyph used for selected points. If set to "auto" then the standard glyph will be used for selected points. """) nonselection_glyph = Nullable(Either(Auto, Instance(Glyph)), default="auto", help=""" An optional glyph used for explicitly non-selected points (i.e., non-selected when there are other points that are selected, but not when no points at all are selected.) If set to "auto" then a glyph with a low alpha value (0.1) will be used for non-selected points. """) hover_glyph = Nullable(Instance(Glyph), help=""" An optional glyph used for inspected points, e.g., those that are being hovered over by a ``HoverTool``. """) muted_glyph = Nullable(Either(Auto, Instance(Glyph)), default="auto", help=""" An optional glyph that replaces the primary glyph when ``muted`` is set. If set to ``"auto"``, it will create a new glyph based off the primary glyph with predefined visual properties. """) muted = Bool(default=False, help=""" Defines whether this glyph renderer is muted or not. Muted renderer will use the muted glyph instead of the primary glyph for rendering. Usually renderers are muted by the user through an UI action, e.g. by clicking a legend item, if a legend was configured with ``click_policy = "mute"``. """) def add_decoration(self, marking: Marking, node: Literal["start", "middle", "end"]) -> Decoration: glyphs = [self.glyph, self.selection_glyph, self.nonselection_glyph, self.hover_glyph, self.muted_glyph] decoration = Decoration(marking=marking, node=node) for glyph in glyphs: if isinstance(glyph, Glyph): glyph.decorations.append(decoration) return decoration
[docs] def construct_color_bar(self, **kwargs: Any) -> ColorBar: ''' Construct and return a new ``ColorBar`` for this ``GlyphRenderer``. The function will check for a color mapper on an appropriate property of the GlyphRenderer's main glyph, in this order: * ``fill_color.transform`` for FillGlyph * ``line_color.transform`` for LineGlyph * ``text_color.transform`` for TextGlyph * ``color_mapper`` for Image In general, the function will "do the right thing" based on glyph type. If different behavior is needed, ColorBars can be constructed by hand. Extra keyword arguments may be passed in to control ``ColorBar`` properties such as `title`. Returns: ColorBar ''' from import Field from ..annotations import ColorBar from ..glyphs import ( FillGlyph, Image, ImageStack, LineGlyph, TextGlyph, ) from ..mappers import ColorMapper if isinstance(self.glyph, FillGlyph): fill_color = self.glyph.fill_color if not (isinstance(fill_color, Field) and isinstance(fill_color.transform, ColorMapper)): raise ValueError("expected fill_color to be a field with a ColorMapper transform") return ColorBar(color_mapper=fill_color.transform, **kwargs) elif isinstance(self.glyph, LineGlyph): line_color = self.glyph.line_color if not (isinstance(line_color, Field) and isinstance(line_color.transform, ColorMapper)): raise ValueError("expected line_color to be a field with a ColorMapper transform") return ColorBar(color_mapper=line_color.transform, **kwargs) elif isinstance(self.glyph, TextGlyph): text_color = self.glyph.text_color if not (isinstance(text_color, Field) and isinstance(text_color.transform, ColorMapper)): raise ValueError("expected text_color to be a field with a ColorMapper transform") return ColorBar(color_mapper=text_color.transform, **kwargs) elif isinstance(self.glyph, (Image, ImageStack)): return ColorBar(color_mapper=self.glyph.color_mapper, **kwargs) else: raise ValueError(f"construct_color_bar does not handle glyph type {type(self.glyph).__name__}")
#----------------------------------------------------------------------------- # Dev API #----------------------------------------------------------------------------- #----------------------------------------------------------------------------- # Private API #----------------------------------------------------------------------------- #----------------------------------------------------------------------------- # Code #-----------------------------------------------------------------------------