bokeh.models.renderers

Models (mostly base classes) for the various kinds of renderer types that Bokeh supports.

class DataRenderer(**kwargs)[source]

Bases: bokeh.models.renderers.Renderer

An abstract base class for data renderer types (e.g. GlyphRenderer, TileRenderer, GraphRenderer).

Note

This is an abstract base class used to help organize the hierarchy of Bokeh model types. It is not useful to instantiate on its own.

JSON Prototype
{
  "id": "4b0564eb-fef9-4eb7-9999-e52fd1e6e918",
  "js_event_callbacks": {},
  "js_property_callbacks": {},
  "level": "image",
  "name": null,
  "subscribed_events": [],
  "tags": [],
  "visible": true
}
class DynamicImageRenderer(*args, **kw)[source]

Bases: bokeh.models.renderers.DataRenderer

alpha

property type: Float

tile opacity 0.0 - 1.0

image_source

property type: Instance ( ImageSource )

Image source to use when rendering on the plot.

render_parents

property type: Bool

Flag enable/disable drawing of parent tiles while waiting for new tiles to arrive. Default value is True.

JSON Prototype
{
  "alpha": 1.0,
  "id": "807590cc-eb6b-4d8c-949f-f5b7ff0b7294",
  "image_source": null,
  "js_event_callbacks": {},
  "js_property_callbacks": {},
  "level": "underlay",
  "name": null,
  "render_parents": true,
  "subscribed_events": [],
  "tags": [],
  "visible": true
}
class GlyphRenderer(**kw)[source]

Bases: bokeh.models.renderers.DataRenderer

data_source

property type: Instance ( DataSource )

Local data source to use when rendering glyphs on the plot.

glyph

property type: Instance ( Glyph )

The glyph to render, in conjunction with the supplied data source and ranges.

hover_glyph

property type: Instance ( Glyph )

An optional glyph used for inspected points, e.g., those that are being hovered over by a HoverTool.

muted

property type: Bool

muted_glyph

property type: Instance ( Glyph )

nonselection_glyph

property type: Either ( Auto , Instance ( Glyph ) )

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.

selection_glyph

property type: Either ( Auto , Instance ( Glyph ) )

An optional glyph used for selected points.

If set to “auto” then the standard glyph will be used for selected points.

view

property type: Instance ( CDSView )

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.

x_range_name

property type: String

A particular (named) x-range to use for computing screen locations when rendering glyphs on the plot. If unset, use the default x-range.

y_range_name

property type: String

A particular (named) y-range to use for computing screen locations when rendering glyphs on the plot. If unset, use the default -range.

JSON Prototype
{
  "data_source": null,
  "glyph": null,
  "hover_glyph": null,
  "id": "8e7aeac2-2421-4baf-8375-19e77082a9c6",
  "js_event_callbacks": {},
  "js_property_callbacks": {},
  "level": "glyph",
  "muted": false,
  "muted_glyph": null,
  "name": null,
  "nonselection_glyph": "auto",
  "selection_glyph": "auto",
  "subscribed_events": [],
  "tags": [],
  "view": {
    "id": "69ad481c-841a-4755-8f36-8be0f989fb3a",
    "type": "CDSView"
  },
  "visible": true,
  "x_range_name": "default",
  "y_range_name": "default"
}
class GraphRenderer(**kwargs)[source]

Bases: bokeh.models.renderers.DataRenderer

edge_renderer

property type: Instance ( GlyphRenderer )

Instance of a GlyphRenderer containing an MultiLine Glyph that will be rendered as the graph edges.

inspection_policy

property type: Instance ( GraphHitTestPolicy )

An instance of a GraphHitTestPolicy that provides the logic for inspection of graph components.

layout_provider

property type: Instance ( LayoutProvider )

An instance of a LayoutProvider that supplies the layout of the network graph in cartesian space.

node_renderer

property type: Instance ( GlyphRenderer )

Instance of a GlyphRenderer containing an XYGlyph that will be rendered as the graph nodes.

selection_policy

property type: Instance ( GraphHitTestPolicy )

An instance of a GraphHitTestPolicy that provides the logic for selection of graph components.

x_range_name

property type: String

A particular (named) x-range to use for computing screen locations when rendering graphs on the plot. If unset, use the default x-range.

y_range_name

property type: String

A particular (named) y-range to use for computing screen locations when rendering graphs on the plot. If unset, use the default -range.

JSON Prototype
{
  "edge_renderer": {
    "id": "7b0ed589-6f6b-4ed6-81ac-1c69964daaa3",
    "type": "GlyphRenderer"
  },
  "id": "95f17c03-c923-42ed-90d3-e97d4541a9cc",
  "inspection_policy": {
    "id": "316be401-6d28-4d41-8456-46c52c4fee85",
    "type": "NodesOnly"
  },
  "js_event_callbacks": {},
  "js_property_callbacks": {},
  "layout_provider": null,
  "level": "glyph",
  "name": null,
  "node_renderer": {
    "id": "348f35dd-5b9e-4535-b1c0-13a239b54679",
    "type": "GlyphRenderer"
  },
  "selection_policy": {
    "id": "56e7a48f-7e63-430f-aaf2-b02917d129c3",
    "type": "NodesOnly"
  },
  "subscribed_events": [],
  "tags": [],
  "visible": true,
  "x_range_name": "default",
  "y_range_name": "default"
}
class GuideRenderer(**kwargs)[source]

Bases: bokeh.models.renderers.Renderer

A base class for all guide renderer types. GuideRenderer is not generally useful to instantiate on its own.

Note

This is an abstract base class used to help organize the hierarchy of Bokeh model types. It is not useful to instantiate on its own.

plot

property type: Instance ( Plot )

The plot to which this guide renderer is attached.

JSON Prototype
{
  "id": "a8a1b474-083c-421d-9ce9-7803a0905918",
  "js_event_callbacks": {},
  "js_property_callbacks": {},
  "level": "overlay",
  "name": null,
  "plot": null,
  "subscribed_events": [],
  "tags": [],
  "visible": true
}
class Renderer(**kwargs)[source]

Bases: bokeh.model.Model

An abstract base class for renderer types.

Note

This is an abstract base class used to help organize the hierarchy of Bokeh model types. It is not useful to instantiate on its own.

level

property type: Enum ( RenderLevel )

Specifies the level in which to paint this renderer.

visible

property type: Bool

Is the renderer visible.

JSON Prototype
{
  "id": "9620e5e7-2aa4-4ce8-a39c-d8c91a835465",
  "js_event_callbacks": {},
  "js_property_callbacks": {},
  "level": "image",
  "name": null,
  "subscribed_events": [],
  "tags": [],
  "visible": true
}
class TileRenderer(**kwargs)[source]

Bases: bokeh.models.renderers.DataRenderer

alpha

property type: Float

tile opacity 0.0 - 1.0

render_parents

property type: Bool

Flag enable/disable drawing of parent tiles while waiting for new tiles to arrive. Default value is True.

tile_source

property type: Instance ( TileSource )

Local data source to use when rendering glyphs on the plot.

x_range_name

property type: String

A particular (named) x-range to use for computing screen locations when rendering glyphs on the plot. If unset, use the default x-range.

y_range_name

property type: String

A particular (named) y-range to use for computing screen locations when rendering glyphs on the plot. If unset, use the default y-range.

JSON Prototype
{
  "alpha": 1.0,
  "id": "e5348224-b364-45bd-b95a-3a0744d84f95",
  "js_event_callbacks": {},
  "js_property_callbacks": {},
  "level": "underlay",
  "name": null,
  "render_parents": true,
  "subscribed_events": [],
  "tags": [],
  "tile_source": {
    "id": "75ab0051-6471-4818-acc9-ed2b1c6c7825",
    "type": "WMTSTileSource"
  },
  "visible": true,
  "x_range_name": "default",
  "y_range_name": "default"
}