`bokeh.models.annotations`¶

Renderers for various kinds of annotations that can be added to Bokeh plots

class Annotation(**kwargs)¶

Bases: bokeh.models.renderers.Renderer

Base class for annotation models.

plot¶

property type: plot:Instance(Plot)

The plot to which this annotation is attached.

{
  "id": "fe63cb09-9c84-46b2-a51f-1f343c746d87",
  "level": "annotation",
  "name": null,
  "plot": null,
  "tags": [],
  "visible": true
}

class Arrow(**kwargs)¶

Bases: bokeh.models.annotations.Annotation

Render an arrow as an annotation.

end¶

property type: end:Instance(ArrowHead)

Instance of ArrowHead.

end_units¶

property type: end_units:Enum(‘screen’, ‘data’)

The unit type for the end_x and end_y attributes. Interpreted as “data space” units by default.

line_alpha¶

property type: line_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line alpha values for the arrow body.

line_cap¶

property type: line_cap:Enum(‘butt’, ‘round’, ‘square’)

The line cap values for the arrow body.

line_color¶

property type: line_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The line color values for the arrow body.

line_dash¶

property type: line_dash:DashPattern

The line dash values for the arrow body.

line_dash_offset¶

property type: line_dash_offset:Int

The line dash offset values for the arrow body.

line_join¶

property type: line_join:Enum(‘miter’, ‘round’, ‘bevel’)

The line join values for the arrow body.

line_width¶

property type: line_width:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line width values for the arrow body.

source¶

property type: source:Instance(DataSource)

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

start¶

property type: start:Instance(ArrowHead)

Instance of ArrowHead.

start_units¶

property type: start_units:Enum(‘screen’, ‘data’)

The unit type for the start_x and start_y attributes. Interpreted as “data space” units by default.

x_end¶

property type: x_end:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The x-coordinates to locate the end of the arrows.

x_range_name¶

property type: x_range_name:String

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

x_start¶

property type: x_start:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The x-coordinates to locate the start of the arrows.

y_end¶

property type: y_end:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The y-coordinates to locate the end of the arrows.

y_range_name¶

property type: y_range_name:String

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

y_start¶

property type: y_start:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The y-coordinates to locate the start of the arrows.

JSON Prototype

{
  "end": {
    "id": "3bafb0dd-490a-4eac-8477-8a0958fd450b",
    "type": "OpenHead"
  },
  "end_units": "data",
  "id": "677628e8-340d-4594-b6ac-363342a61f45",
  "level": "annotation",
  "line_alpha": {
    "value": 1.0
  },
  "line_cap": "butt",
  "line_color": {
    "value": "black"
  },
  "line_dash": [],
  "line_dash_offset": 0,
  "line_join": "miter",
  "line_width": {
    "value": 1
  },
  "name": null,
  "plot": null,
  "source": null,
  "start": null,
  "start_units": "data",
  "tags": [],
  "visible": true,
  "x_end": null,
  "x_range_name": "default",
  "x_start": null,
  "y_end": null,
  "y_range_name": "default",
  "y_start": null
}

class BoxAnnotation(**kwargs)¶

Bases: bokeh.models.annotations.Annotation

Render a shaded rectangular region as an annotation.

bottom¶

property type: bottom:Either(Auto, NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float))

The y-coordinates of the bottom edge of the box annotation.

bottom_units¶

property type: bottom_units:Enum(‘screen’, ‘data’)

The unit type for the bottom attribute. Interpreted as “data space” units by default.

fill_alpha¶

property type: fill_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The fill alpha values for the box.

fill_color¶

property type: fill_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The fill color values for the box.

left¶

property type: left:Either(Auto, NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float))

The x-coordinates of the left edge of the box annotation.

left_units¶

property type: left_units:Enum(‘screen’, ‘data’)

The unit type for the left attribute. Interpreted as “data space” units by default.

line_alpha¶

property type: line_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line alpha values for the box.

line_cap¶

property type: line_cap:Enum(‘butt’, ‘round’, ‘square’)

The line cap values for the box.

line_color¶

property type: line_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The line color values for the box.

line_dash¶

property type: line_dash:DashPattern

The line dash values for the box.

line_dash_offset¶

property type: line_dash_offset:Int

The line dash offset values for the box.

line_join¶

property type: line_join:Enum(‘miter’, ‘round’, ‘bevel’)

The line join values for the box.

line_width¶

property type: line_width:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line width values for the box.

render_mode¶

property type: render_mode:Enum(‘canvas’, ‘css’)

Specifies whether the box is rendered as a canvas element or as an css element overlaid on the canvas. The default mode is “canvas”.

Warning

The line_dash and line_dash_offset attributes aren’t supported if the render_mode is set to “css”

right¶

property type: right:Either(Auto, NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float))

The x-coordinates of the right edge of the box annotation.

right_units¶

property type: right_units:Enum(‘screen’, ‘data’)

The unit type for the right attribute. Interpreted as “data space” units by default.

top¶

property type: top:Either(Auto, NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float))

The y-coordinates of the top edge of the box annotation.

top_units¶

property type: top_units:Enum(‘screen’, ‘data’)

The unit type for the top attribute. Interpreted as “data space” units by default.

x_range_name¶

property type: x_range_name:String

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

y_range_name¶

property type: y_range_name:String

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

JSON Prototype

{
  "bottom": null,
  "bottom_units": "data",
  "fill_alpha": {
    "value": 0.4
  },
  "fill_color": {
    "value": "#fff9ba"
  },
  "id": "364c4bb4-fc7e-4efd-b723-bb755b0c25a5",
  "left": null,
  "left_units": "data",
  "level": "annotation",
  "line_alpha": {
    "value": 0.3
  },
  "line_cap": "butt",
  "line_color": {
    "value": "#cccccc"
  },
  "line_dash": [],
  "line_dash_offset": 0,
  "line_join": "miter",
  "line_width": {
    "value": 1
  },
  "name": null,
  "plot": null,
  "render_mode": "canvas",
  "right": null,
  "right_units": "data",
  "tags": [],
  "top": null,
  "top_units": "data",
  "visible": true,
  "x_range_name": "default",
  "y_range_name": "default"
}

class ColorBar(**kwargs)¶

Bases: bokeh.models.annotations.Annotation

Render a color bar based on a color mapper for a plot.

background_fill_alpha¶

property type: background_fill_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The fill alpha for the color bar background style.

background_fill_color¶

property type: background_fill_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The fill color for the color bar background style.

bar_line_alpha¶

property type: bar_line_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line alpha for the color scale bar outline.

bar_line_cap¶

property type: bar_line_cap:Enum(‘butt’, ‘round’, ‘square’)

The line cap for the color scale bar outline.

bar_line_color¶

property type: bar_line_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The line color for the color scale bar outline.

bar_line_dash¶

property type: bar_line_dash:DashPattern

The line dash for the color scale bar outline.

bar_line_dash_offset¶

property type: bar_line_dash_offset:Int

The line dash offset for the color scale bar outline.

bar_line_join¶

property type: bar_line_join:Enum(‘miter’, ‘round’, ‘bevel’)

The line join for the color scale bar outline.

bar_line_width¶

property type: bar_line_width:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line width for the color scale bar outline.

border_line_alpha¶

property type: border_line_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line alpha for the color bar border outline.

border_line_cap¶

property type: border_line_cap:Enum(‘butt’, ‘round’, ‘square’)

The line cap for the color bar border outline.

border_line_color¶

property type: border_line_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The line color for the color bar border outline.

border_line_dash¶

property type: border_line_dash:DashPattern

The line dash for the color bar border outline.

border_line_dash_offset¶

property type: border_line_dash_offset:Int

The line dash offset for the color bar border outline.

border_line_join¶

property type: border_line_join:Enum(‘miter’, ‘round’, ‘bevel’)

The line join for the color bar border outline.

border_line_width¶

property type: border_line_width:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line width for the color bar border outline.

color_mapper¶

property type: color_mapper:Instance(ColorMapper)

A color mapper containing a color palette to render.

Warning

If the low and high attributes of the ColorMapper aren’t set, ticks and tick labels won’t be rendered.

formatter¶

property type: formatter:Instance(TickFormatter)

A TickFormatter to use for formatting the visual appearance of ticks.

height¶

property type: height:Either(Auto, Int)

The height (in pixels) that the color scale should occupy.

label_standoff¶

property type: label_standoff:Int

The distance (in pixels) to separate the tick labels from the color bar.

location¶

property type: location:Either(Enum(‘top_left’, ‘top_center’, ‘top_right’, ‘right_center’, ‘bottom_right’, ‘bottom_center’, ‘bottom_left’, ‘left_center’, ‘center’), Tuple(Float, Float))

The location where the color bar should draw itself. It’s either one of bokeh.core.enums.LegendLocation‘s enumerated values, or a (x, y) tuple indicating an absolute location absolute location in screen coordinates (pixels from the bottom-left corner).

Warning

If the color bar is placed in a side panel, the location will likely have to be set to (0,0).

major_label_text_align¶

property type: major_label_text_align:Enum(‘left’, ‘right’, ‘center’)

The text align of the major tick labels.

major_label_text_alpha¶

property type: major_label_text_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The text alpha of the major tick labels.

major_label_text_baseline¶

property type: major_label_text_baseline:Enum(‘top’, ‘middle’, ‘bottom’, ‘alphabetic’, ‘hanging’, ‘ideographic’)

The text baseline of the major tick labels.

major_label_text_color¶

property type: major_label_text_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The text color of the major tick labels.

major_label_text_font¶

property type: major_label_text_font:String

The text font of the major tick labels.

major_label_text_font_size¶

property type: major_label_text_font_size:FontSizeSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), List(String))), List(String))

The text font size of the major tick labels.

major_label_text_font_style¶

property type: major_label_text_font_style:Enum(‘normal’, ‘italic’, ‘bold’)

The text font style of the major tick labels.

major_tick_in¶

property type: major_tick_in:Int

The distance (in pixels) that major ticks should extend into the main plot area.

major_tick_line_alpha¶

property type: major_tick_line_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line alpha of the major ticks.

major_tick_line_cap¶

property type: major_tick_line_cap:Enum(‘butt’, ‘round’, ‘square’)

The line cap of the major ticks.

major_tick_line_color¶

property type: major_tick_line_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The line color of the major ticks.

major_tick_line_dash¶

property type: major_tick_line_dash:DashPattern

The line dash of the major ticks.

major_tick_line_dash_offset¶

property type: major_tick_line_dash_offset:Int

The line dash offset of the major ticks.

major_tick_line_join¶

property type: major_tick_line_join:Enum(‘miter’, ‘round’, ‘bevel’)

The line join of the major ticks.

major_tick_line_width¶

property type: major_tick_line_width:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line width of the major ticks.

major_tick_out¶

property type: major_tick_out:Int

The distance (in pixels) that major ticks should extend out of the main plot area.

margin¶

property type: margin:Int

Amount of margin (in pixels) around the outside of the color bar.

minor_tick_in¶

property type: minor_tick_in:Int

The distance (in pixels) that minor ticks should extend into the main plot area.

minor_tick_line_alpha¶

property type: minor_tick_line_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line alpha of the minor ticks.

minor_tick_line_cap¶

property type: minor_tick_line_cap:Enum(‘butt’, ‘round’, ‘square’)

The line cap of the minor ticks.

minor_tick_line_color¶

property type: minor_tick_line_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The line color of the minor ticks.

minor_tick_line_dash¶

property type: minor_tick_line_dash:DashPattern

The line dash of the minor ticks.

minor_tick_line_dash_offset¶

property type: minor_tick_line_dash_offset:Int

The line dash offset of the minor ticks.

minor_tick_line_join¶

property type: minor_tick_line_join:Enum(‘miter’, ‘round’, ‘bevel’)

The line join of the minor ticks.

minor_tick_line_width¶

property type: minor_tick_line_width:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line width of the minor ticks.

minor_tick_out¶

property type: minor_tick_out:Int

The distance (in pixels) that major ticks should extend out of the main plot area.

orientation¶

property type: orientation:Enum(‘horizontal’, ‘vertical’)

Whether the color bar should be oriented vertically or horizontally.

padding¶

property type: padding:Int

Amount of padding (in pixels) between the color scale and color bar border.

scale_alpha¶

property type: scale_alpha:Float

The alpha with which to render the color scale.

ticker¶

property type: ticker:Instance(Ticker)

A Ticker to use for computing locations of axis components.

title¶

property type: title:String

The title text to render.

title_standoff¶

property type: title_standoff:Int

The distance (in pixels) to separate the title from the color bar.

title_text_align¶

property type: title_text_align:Enum(‘left’, ‘right’, ‘center’)

The text align values for the title text.

title_text_alpha¶

property type: title_text_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The text alpha values for the title text.

title_text_baseline¶

property type: title_text_baseline:Enum(‘top’, ‘middle’, ‘bottom’, ‘alphabetic’, ‘hanging’, ‘ideographic’)

The text baseline values for the title text.

title_text_color¶

property type: title_text_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The text color values for the title text.

title_text_font¶

property type: title_text_font:String

The text font values for the title text.

title_text_font_size¶

property type: title_text_font_size:FontSizeSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), List(String))), List(String))

The text font size values for the title text.

title_text_font_style¶

property type: title_text_font_style:Enum(‘normal’, ‘italic’, ‘bold’)

The text font style values for the title text.

width¶

property type: width:Either(Auto, Int)

The width (in pixels) that the color scale should occupy.

JSON Prototype

{
  "background_fill_alpha": {
    "value": 0.95
  },
  "background_fill_color": {
    "value": "#ffffff"
  },
  "bar_line_alpha": {
    "value": 1.0
  },
  "bar_line_cap": "butt",
  "bar_line_color": {
    "value": null
  },
  "bar_line_dash": [],
  "bar_line_dash_offset": 0,
  "bar_line_join": "miter",
  "bar_line_width": {
    "value": 1
  },
  "border_line_alpha": {
    "value": 1.0
  },
  "border_line_cap": "butt",
  "border_line_color": {
    "value": null
  },
  "border_line_dash": [],
  "border_line_dash_offset": 0,
  "border_line_join": "miter",
  "border_line_width": {
    "value": 1
  },
  "color_mapper": null,
  "formatter": {
    "id": "88d4540d-3ab0-421a-a794-b79aba25d546",
    "type": "BasicTickFormatter"
  },
  "height": "auto",
  "id": "ca3c9365-156c-4023-92a8-82da8727c2b1",
  "label_standoff": 5,
  "level": "annotation",
  "location": "top_right",
  "major_label_text_align": "center",
  "major_label_text_alpha": {
    "value": 1.0
  },
  "major_label_text_baseline": "middle",
  "major_label_text_color": {
    "value": "#444444"
  },
  "major_label_text_font": "helvetica",
  "major_label_text_font_size": {
    "value": "8pt"
  },
  "major_label_text_font_style": "normal",
  "major_tick_in": 5,
  "major_tick_line_alpha": {
    "value": 1.0
  },
  "major_tick_line_cap": "butt",
  "major_tick_line_color": {
    "value": "#ffffff"
  },
  "major_tick_line_dash": [],
  "major_tick_line_dash_offset": 0,
  "major_tick_line_join": "miter",
  "major_tick_line_width": {
    "value": 1
  },
  "major_tick_out": 0,
  "margin": 30,
  "minor_tick_in": 0,
  "minor_tick_line_alpha": {
    "value": 1.0
  },
  "minor_tick_line_cap": "butt",
  "minor_tick_line_color": {
    "value": null
  },
  "minor_tick_line_dash": [],
  "minor_tick_line_dash_offset": 0,
  "minor_tick_line_join": "miter",
  "minor_tick_line_width": {
    "value": 1
  },
  "minor_tick_out": 0,
  "name": null,
  "orientation": "vertical",
  "padding": 10,
  "plot": null,
  "scale_alpha": 1.0,
  "tags": [],
  "ticker": {
    "id": "8b81e7b1-ed05-44d6-b41c-6010233546db",
    "type": "BasicTicker"
  },
  "title": null,
  "title_standoff": 2,
  "title_text_align": "left",
  "title_text_alpha": {
    "value": 1.0
  },
  "title_text_baseline": "bottom",
  "title_text_color": {
    "value": "#444444"
  },
  "title_text_font": "helvetica",
  "title_text_font_size": {
    "value": "10pt"
  },
  "title_text_font_style": "italic",
  "visible": true,
  "width": "auto"
}

class Label(**kwargs)¶

Bases: bokeh.models.annotations.TextAnnotation

Render a single text box as an annotation.

angle¶

property type: angle:Angle

The angle to rotate the text, as measured from the horizontal.

Warning

The center of rotation for canvas and css render_modes is different. For render_mode=”canvas” the label is rotated from the top-left corner of the annotation, while for render_mode=”css” the annotation is rotated around it’s center.

angle_units¶

property type: angle_units:Enum(‘deg’, ‘rad’)

Acceptable values for units are "rad" and "deg"

background_fill_alpha¶

property type: background_fill_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The fill alpha values for the text bounding box.

background_fill_color¶

property type: background_fill_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The fill color values for the text bounding box.

border_line_alpha¶

property type: border_line_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line alpha values for the text bounding box.

border_line_cap¶

property type: border_line_cap:Enum(‘butt’, ‘round’, ‘square’)

The line cap values for the text bounding box.

border_line_color¶

property type: border_line_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The line color values for the text bounding box.

border_line_dash¶

property type: border_line_dash:DashPattern

The line dash values for the text bounding box.

border_line_dash_offset¶

property type: border_line_dash_offset:Int

The line dash offset values for the text bounding box.

border_line_join¶

property type: border_line_join:Enum(‘miter’, ‘round’, ‘bevel’)

The line join values for the text bounding box.

border_line_width¶

property type: border_line_width:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line width values for the text bounding box.

render_mode¶

property type: render_mode:Enum(‘canvas’, ‘css’)

Specifies whether the text is rendered as a canvas element or as an css element overlaid on the canvas. The default mode is “canvas”.

Note

The CSS labels won’t be present in the output using the “save” tool.

Warning

Not all visual styling properties are supported if the render_mode is set to “css”. The border_line_dash property isn’t fully supported and border_line_dash_offset isn’t supported at all. Setting text_alpha will modify the opacity of the entire background box and border in addition to the text. Finally, clipping Label annotations inside of the plot area isn’t supported in “css” mode.

text¶

property type: text:String

The text value to render.

text_align¶

property type: text_align:Enum(‘left’, ‘right’, ‘center’)

The text align values for the text.

text_alpha¶

property type: text_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The text alpha values for the text.

text_baseline¶

property type: text_baseline:Enum(‘top’, ‘middle’, ‘bottom’, ‘alphabetic’, ‘hanging’, ‘ideographic’)

The text baseline values for the text.

text_color¶

property type: text_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The text color values for the text.

text_font¶

property type: text_font:String

The text font values for the text.

text_font_size¶

property type: text_font_size:FontSizeSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), List(String))), List(String))

The text font size values for the text.

text_font_style¶

property type: text_font_style:Enum(‘normal’, ‘italic’, ‘bold’)

The text font style values for the text.

x¶

property type: x:Float

The x-coordinate in screen coordinates to locate the text anchors.

x_offset¶

property type: x_offset:Float

Offset value to apply to the x-coordinate.

This is useful, for instance, if it is desired to “float” text a fixed distance in screen units from a given data position.

x_range_name¶

property type: x_range_name:String

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

x_units¶

property type: x_units:Enum(‘screen’, ‘data’)

The unit type for the x attribute. Interpreted as “data space” units by default.

y¶

property type: y:Float

The y-coordinate in screen coordinates to locate the text anchors.

y_offset¶

property type: y_offset:Float

Offset value to apply to the y-coordinate.

This is useful, for instance, if it is desired to “float” text a fixed distance in screen units from a given data position.

y_range_name¶

property type: y_range_name:String

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

y_units¶

property type: y_units:Enum(‘screen’, ‘data’)

The unit type for the y attribute. Interpreted as “data space” units by default.

JSON Prototype

{
  "angle": 0,
  "angle_units": "rad",
  "background_fill_alpha": {
    "value": 1.0
  },
  "background_fill_color": {
    "value": null
  },
  "border_line_alpha": {
    "value": 1.0
  },
  "border_line_cap": "butt",
  "border_line_color": {
    "value": null
  },
  "border_line_dash": [],
  "border_line_dash_offset": 0,
  "border_line_join": "miter",
  "border_line_width": {
    "value": 1
  },
  "id": "561dfd42-0c1f-40f3-8b95-7371a9e19704",
  "level": "annotation",
  "name": null,
  "plot": null,
  "render_mode": "canvas",
  "tags": [],
  "text": null,
  "text_align": "left",
  "text_alpha": {
    "value": 1.0
  },
  "text_baseline": "bottom",
  "text_color": {
    "value": "#444444"
  },
  "text_font": "helvetica",
  "text_font_size": {
    "value": "12pt"
  },
  "text_font_style": "normal",
  "visible": true,
  "x": null,
  "x_offset": 0,
  "x_range_name": "default",
  "x_units": "data",
  "y": null,
  "y_offset": 0,
  "y_range_name": "default",
  "y_units": "data"
}

class LabelSet(**kwargs)¶

Bases: bokeh.models.annotations.TextAnnotation

Render a group of text boxes as annotations.

angle¶

property type: angle:AngleSpec(units_default=’rad’)

The angles to rotate the text, as measured from the horizontal.

Warning

angle_units¶: property type: angle_units:Enum(‘deg’, ‘rad’)

background_fill_alpha¶

property type: background_fill_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The fill alpha values for the text bounding box.

background_fill_color¶

property type: background_fill_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The fill color values for the text bounding box.

border_line_alpha¶

property type: border_line_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line alpha values for the text bounding box.

border_line_cap¶

property type: border_line_cap:Enum(‘butt’, ‘round’, ‘square’)

The line cap values for the text bounding box.

border_line_color¶

property type: border_line_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The line color values for the text bounding box.

border_line_dash¶

property type: border_line_dash:DashPattern

The line dash values for the text bounding box.

border_line_dash_offset¶

property type: border_line_dash_offset:Int

The line dash offset values for the text bounding box.

border_line_join¶

property type: border_line_join:Enum(‘miter’, ‘round’, ‘bevel’)

The line join values for the text bounding box.

border_line_width¶

property type: border_line_width:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line width values for the text bounding box.

render_mode¶

property type: render_mode:Enum(‘canvas’, ‘css’)

Specifies whether the text is rendered as a canvas element or as an css element overlaid on the canvas. The default mode is “canvas”.

Note

The CSS labels won’t be present in the output using the “save” tool.

Warning

source¶

property type: source:Instance(DataSource)

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

text¶

property type: text:StringSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), List(String))), List(String))

The text values to render.

text_align¶

property type: text_align:Enum(‘left’, ‘right’, ‘center’)

The text align values for the text.

text_alpha¶

property type: text_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The text alpha values for the text.

text_baseline¶

property type: text_baseline:Enum(‘top’, ‘middle’, ‘bottom’, ‘alphabetic’, ‘hanging’, ‘ideographic’)

The text baseline values for the text.

text_color¶

property type: text_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The text color values for the text.

text_font¶

property type: text_font:String

The text font values for the text.

text_font_size¶

property type: text_font_size:FontSizeSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), List(String))), List(String))

The text font size values for the text.

text_font_style¶

property type: text_font_style:Enum(‘normal’, ‘italic’, ‘bold’)

The text font style values for the text.

x¶

property type: x:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The x-coordinates to locate the text anchors.

x_offset¶

property type: x_offset:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

Offset values to apply to the x-coordinates.

This is useful, for instance, if it is desired to “float” text a fixed distance in screen units from a given data position.

x_range_name¶

property type: x_range_name:String

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

x_units¶

property type: x_units:Enum(‘screen’, ‘data’)

The unit type for the xs attribute. Interpreted as “data space” units by default.

y¶

property type: y:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The y-coordinates to locate the text anchors.

y_offset¶

property type: y_offset:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

Offset values to apply to the y-coordinates.

This is useful, for instance, if it is desired to “float” text a fixed distance in screen units from a given data position.

y_range_name¶

property type: y_range_name:String

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

y_units¶

property type: y_units:Enum(‘screen’, ‘data’)

The unit type for the ys attribute. Interpreted as “data space” units by default.

JSON Prototype

{
  "angle": {
    "units": "rad",
    "value": 0
  },
  "background_fill_alpha": {
    "value": 1.0
  },
  "background_fill_color": {
    "value": null
  },
  "border_line_alpha": {
    "value": 1.0
  },
  "border_line_cap": "butt",
  "border_line_color": {
    "value": null
  },
  "border_line_dash": [],
  "border_line_dash_offset": 0,
  "border_line_join": "miter",
  "border_line_width": {
    "value": 1
  },
  "id": "66d98d2e-65f8-4755-82d5-fe8c28763729",
  "level": "annotation",
  "name": null,
  "plot": null,
  "render_mode": "canvas",
  "source": {
    "id": "f87f95a7-4671-4c2e-9617-a2fafee7a699",
    "type": "ColumnDataSource"
  },
  "tags": [],
  "text": {
    "field": "text"
  },
  "text_align": "left",
  "text_alpha": {
    "value": 1.0
  },
  "text_baseline": "bottom",
  "text_color": {
    "value": "#444444"
  },
  "text_font": "helvetica",
  "text_font_size": {
    "value": "12pt"
  },
  "text_font_style": "normal",
  "visible": true,
  "x": null,
  "x_offset": {
    "value": 0
  },
  "x_range_name": "default",
  "x_units": "data",
  "y": null,
  "y_offset": {
    "value": 0
  },
  "y_range_name": "default",
  "y_units": "data"
}

class Legend(**kwargs)¶

Bases: bokeh.models.annotations.Annotation

Render informational legends for a plot.

background_fill_alpha¶

property type: background_fill_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The fill alpha for the legend background style.

background_fill_color¶

property type: background_fill_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The fill color for the legend background style.

border_line_alpha¶

property type: border_line_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line alpha for the legend border outline.

border_line_cap¶

property type: border_line_cap:Enum(‘butt’, ‘round’, ‘square’)

The line cap for the legend border outline.

border_line_color¶

property type: border_line_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The line color for the legend border outline.

border_line_dash¶

property type: border_line_dash:DashPattern

The line dash for the legend border outline.

border_line_dash_offset¶

property type: border_line_dash_offset:Int

The line dash offset for the legend border outline.

border_line_join¶

property type: border_line_join:Enum(‘miter’, ‘round’, ‘bevel’)

The line join for the legend border outline.

border_line_width¶

property type: border_line_width:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line width for the legend border outline.

glyph_height¶

property type: glyph_height:Int

The height (in pixels) that the rendered legend glyph should occupy.

glyph_width¶

property type: glyph_width:Int

The width (in pixels) that the rendered legend glyph should occupy.

label_height¶

property type: label_height:Int

The minimum height (in pixels) of the area that legend labels should occupy.

label_standoff¶

property type: label_standoff:Int

The distance (in pixels) to separate the label from its associated glyph.

label_text_align¶

property type: label_text_align:Enum(‘left’, ‘right’, ‘center’)

The text align for the legend labels.

label_text_alpha¶

property type: label_text_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The text alpha for the legend labels.

label_text_baseline¶

property type: label_text_baseline:Enum(‘top’, ‘middle’, ‘bottom’, ‘alphabetic’, ‘hanging’, ‘ideographic’)

The text baseline for the legend labels.

label_text_color¶

property type: label_text_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The text color for the legend labels.

label_text_font¶

property type: label_text_font:String

The text font for the legend labels.

label_text_font_size¶

property type: label_text_font_size:FontSizeSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), List(String))), List(String))

The text font size for the legend labels.

label_text_font_style¶

property type: label_text_font_style:Enum(‘normal’, ‘italic’, ‘bold’)

The text font style for the legend labels.

label_width¶

property type: label_width:Int

The minimum width (in pixels) of the area that legend labels should occupy.

legend_margin¶

property type: legend_margin:Int

Amount of margin around the legend.

legend_padding¶

property type: legend_padding:Int

Amount of padding around the contents of the legend.

legend_spacing¶

property type: legend_spacing:Int

Amount of spacing between legend entries.

legends¶

property type: legends:List(Tuple(String, List(Instance(GlyphRenderer))))

A list of tuples that maps text labels to the legend to corresponding renderers that should draw sample representations for those labels.

Note

The legends attribute may also be set from a dict or OrderedDict. If a dict is used, the order of the legend entries is unspecified.

location¶

The location where the legend should draw itself. It’s either one of bokeh.core.enums.LegendLocation‘s enumerated values, or a (x, y) tuple indicating an absolute location absolute location in screen coordinates (pixels from the bottom-left corner).

orientation¶

property type: orientation:Enum(‘horizontal’, ‘vertical’)

Whether the legend entries should be placed vertically or horizontally when they are layed out.

JSON Prototype

{
  "background_fill_alpha": {
    "value": 0.95
  },
  "background_fill_color": {
    "value": "#ffffff"
  },
  "border_line_alpha": {
    "value": 0.5
  },
  "border_line_cap": "butt",
  "border_line_color": {
    "value": "#e5e5e5"
  },
  "border_line_dash": [],
  "border_line_dash_offset": 0,
  "border_line_join": "miter",
  "border_line_width": {
    "value": 1
  },
  "glyph_height": 20,
  "glyph_width": 20,
  "id": "719c80bd-34bb-494e-abb4-d10fd84c1e02",
  "label_height": 20,
  "label_standoff": 5,
  "label_text_align": "left",
  "label_text_alpha": {
    "value": 1.0
  },
  "label_text_baseline": "middle",
  "label_text_color": {
    "value": "#444444"
  },
  "label_text_font": "helvetica",
  "label_text_font_size": {
    "value": "10pt"
  },
  "label_text_font_style": "normal",
  "label_width": 20,
  "legend_margin": 10,
  "legend_padding": 10,
  "legend_spacing": 3,
  "legends": [],
  "level": "annotation",
  "location": "top_right",
  "name": null,
  "orientation": "vertical",
  "plot": null,
  "tags": [],
  "visible": true
}

class PolyAnnotation(**kwargs)¶

Bases: bokeh.models.annotations.Annotation

Render a shaded polygonal region as an annotation.

fill_alpha¶

property type: fill_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The fill alpha values for the polygon.

fill_color¶

property type: fill_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The fill color values for the polygon.

line_alpha¶

property type: line_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line alpha values for the polygon.

line_cap¶

property type: line_cap:Enum(‘butt’, ‘round’, ‘square’)

The line cap values for the polygon.

line_color¶

property type: line_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The line color values for the polygon.

line_dash¶

property type: line_dash:DashPattern

The line dash values for the polygon.

line_dash_offset¶

property type: line_dash_offset:Int

The line dash offset values for the polygon.

line_join¶

property type: line_join:Enum(‘miter’, ‘round’, ‘bevel’)

The line join values for the polygon.

line_width¶

property type: line_width:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line width values for the polygon.

x_range_name¶

property type: x_range_name:String

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

xs¶

property type: xs:Seq(Float)

The x-coordinates of the region to draw.

xs_units¶

property type: xs_units:Enum(‘screen’, ‘data’)

The unit type for the xs attribute. Interpreted as “data space” units by default.

y_range_name¶

property type: y_range_name:String

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

ys¶

property type: ys:Seq(Float)

The y-coordinates of the region to draw.

ys_units¶

property type: ys_units:Enum(‘screen’, ‘data’)

The unit type for the ys attribute. Interpreted as “data space” units by default.

JSON Prototype

{
  "fill_alpha": {
    "value": 0.4
  },
  "fill_color": {
    "value": "#fff9ba"
  },
  "id": "6a5b7135-3b88-4cc6-95ab-a75b79a3dfea",
  "level": "annotation",
  "line_alpha": {
    "value": 0.3
  },
  "line_cap": "butt",
  "line_color": {
    "value": "#cccccc"
  },
  "line_dash": [],
  "line_dash_offset": 0,
  "line_join": "miter",
  "line_width": {
    "value": 1
  },
  "name": null,
  "plot": null,
  "tags": [],
  "visible": true,
  "x_range_name": "default",
  "xs": [],
  "xs_units": "data",
  "y_range_name": "default",
  "ys": [],
  "ys_units": "data"
}

class Span(**kwargs)¶

Bases: bokeh.models.annotations.Annotation

Render a horizontal or vertical line span.

dimension¶

property type: dimension:Enum(‘width’, ‘height’, ‘x’, ‘y’)

The direction of the span.

line_alpha¶

property type: line_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line alpha values for the span.

line_cap¶

property type: line_cap:Enum(‘butt’, ‘round’, ‘square’)

The line cap values for the span.

line_color¶

property type: line_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The line color values for the span.

line_dash¶

property type: line_dash:DashPattern

The line dash values for the span.

line_dash_offset¶

property type: line_dash_offset:Int

The line dash offset values for the span.

line_join¶

property type: line_join:Enum(‘miter’, ‘round’, ‘bevel’)

The line join values for the span.

line_width¶

property type: line_width:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line width values for the span.

location¶

property type: location:Float

The location of the span, along dimension.

location_units¶

property type: location_units:Enum(‘screen’, ‘data’)

The unit type for the location attribute. Interpreted as “data space” units by default.

render_mode¶

property type: render_mode:Enum(‘canvas’, ‘css’)

Specifies whether the span is rendered as a canvas element or as an css element overlaid on the canvas. The default mode is “canvas”.

Warning

The line_dash and line_dash_offset attributes aren’t supported if the render_mode is set to “css”

x_range_name¶

property type: x_range_name:String

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

y_range_name¶

property type: y_range_name:String

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

JSON Prototype

{
  "dimension": "width",
  "id": "b46c409c-32bf-417c-8adf-e5f07ecd7946",
  "level": "annotation",
  "line_alpha": {
    "value": 1.0
  },
  "line_cap": "butt",
  "line_color": {
    "value": "black"
  },
  "line_dash": [],
  "line_dash_offset": 0,
  "line_join": "miter",
  "line_width": {
    "value": 1
  },
  "location": null,
  "location_units": "data",
  "name": null,
  "plot": null,
  "render_mode": "canvas",
  "tags": [],
  "visible": true,
  "x_range_name": "default",
  "y_range_name": "default"
}

class TextAnnotation(**kwargs)¶

Bases: bokeh.models.annotations.Annotation

Base class for annotation models.

JSON Prototype

{
  "id": "3489a4ee-8b8f-4cd8-9a72-2d86df145527",
  "level": "annotation",
  "name": null,
  "plot": null,
  "tags": [],
  "visible": true
}

class Title(**kwargs)¶

Bases: bokeh.models.annotations.TextAnnotation

Render a single title box as an annotation.

align¶

property type: align:Enum(‘left’, ‘right’, ‘center’)

Location to align the title text.

background_fill_alpha¶

property type: background_fill_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The fill alpha values for the text bounding box.

background_fill_color¶

property type: background_fill_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The fill color values for the text bounding box.

border_line_alpha¶

property type: border_line_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line alpha values for the text bounding box.

border_line_cap¶

property type: border_line_cap:Enum(‘butt’, ‘round’, ‘square’)

The line cap values for the text bounding box.

border_line_color¶

property type: border_line_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

The line color values for the text bounding box.

border_line_dash¶

property type: border_line_dash:DashPattern

The line dash values for the text bounding box.

border_line_dash_offset¶

property type: border_line_dash_offset:Int

The line dash offset values for the text bounding box.

border_line_join¶

property type: border_line_join:Enum(‘miter’, ‘round’, ‘bevel’)

The line join values for the text bounding box.

border_line_width¶

property type: border_line_width:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

The line width values for the text bounding box.

offset¶

property type: offset:Float

Offset the text by a number of pixels (can be positive or negative). Shifts the text in different directions based on the location of the title:

above: shifts title right

right: shifts title down

below: shifts title right

left: shifts title up

render_mode¶

property type: render_mode:Enum(‘canvas’, ‘css’)

Specifies whether the text is rendered as a canvas element or as an css element overlaid on the canvas. The default mode is “canvas”.

Note

The CSS labels won’t be present in the output using the “save” tool.

Warning

text¶

property type: text:String

The text value to render.

text_alpha¶

property type: text_alpha:NumberSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Float)), Float)

An alpha value to use to fill text with.

Acceptable values are floating point numbers between 0 (transparent) and 1 (opaque).

text_color¶

property type: text_color:ColorSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), Color)), Color)

A color to use to fill text with.

Acceptable values are:

any of the 147 named CSS colors, e.g 'green', 'indigo'
an RGB(A) hex value, e.g., '#FF0000', '#44444444'
a 3-tuple of integers (r,g,b) between 0 and 255
a 4-tuple of (r,g,b,a) where r,g,b are integers between 0..255 and a is between 0..1

text_font¶

property type: text_font:String

Name of a font to use for rendering text, e.g., 'times', 'helvetica'.

text_font_size¶: property type: text_font_size:FontSizeSpec(String, Dict(String, Either(String, Instance(Transform), Instance(ColorMapper), List(String))), List(String))

text_font_style¶

property type: text_font_style:Enum(‘normal’, ‘italic’, ‘bold’)

A style to use for rendering text.

Acceptable values are:

'normal' normal text
'italic' italic text
'bold' bold text

JSON Prototype

{
  "align": "left",
  "background_fill_alpha": {
    "value": 1.0
  },
  "background_fill_color": {
    "value": null
  },
  "border_line_alpha": {
    "value": 1.0
  },
  "border_line_cap": "butt",
  "border_line_color": {
    "value": null
  },
  "border_line_dash": [],
  "border_line_dash_offset": 0,
  "border_line_join": "miter",
  "border_line_width": {
    "value": 1
  },
  "id": "38f86656-0ca4-424f-a405-be42ad5d2b06",
  "level": "annotation",
  "name": null,
  "offset": 0,
  "plot": null,
  "render_mode": "canvas",
  "tags": [],
  "text": null,
  "text_alpha": {
    "value": 1.0
  },
  "text_color": {
    "value": "#444444"
  },
  "text_font": "helvetica",
  "text_font_size": {
    "value": "10pt"
  },
  "text_font_style": "bold",
  "visible": true
}

class Tooltip(**kwargs)¶

Bases: bokeh.models.annotations.Annotation

Render a tooltip.

Note

This model is currently managed by BokehJS and is not useful directly from python.

attachment¶

property type: attachment:Enum(‘horizontal’, ‘vertical’, ‘left’, ‘right’, ‘above’, ‘below’)

Whether the tooltip should display to the left or right off the cursor position or above or below it, or if it should be automatically placed in the horizontal or vertical dimension.

inner_only¶

property type: inner_only:Bool

Whether to display outside a central plot frame area.

show_arrow¶

property type: show_arrow:Bool

Whether tooltip’s arrow should be showed.

JSON Prototype

{
  "attachment": "horizontal",
  "id": "4a09e7a6-7994-4740-947b-d4604e9358ad",
  "inner_only": true,
  "level": "overlay",
  "name": null,
  "plot": null,
  "show_arrow": true,
  "tags": [],
  "visible": true
}

bokeh.models.annotations¶

`bokeh.models.annotations`¶