bokeh.plotting¶
-
figure
(**kwargs)[source]¶ Create a new Figure for plotting.
A subclass of
Plot
that simplifies plot creation with default axes, grids, tools, etc.Figure objects have many glyph methods that can be used to draw vectorized graphical glyphs:
As well as a scatter function that can be parameterized by marker type:
There are also two specialized methods for stacking bars:
And one specialized method for making simple hexbin plots:
In addition to all the
Figure
property attributes, the following options are also accepted:Keyword Args:
- active_drag (
Either
(Auto
,String
,Instance
(Drag
) )) : - Which drag tool should initially be active. (default: ‘auto’)
- active_inspect (
Either
(Auto
,String
,Instance
(Inspection
),Seq
(Instance
(Inspection
) ) )) : - Which drag tool should initially be active. (default: ‘auto’)
- active_scroll (
Either
(Auto
,String
,Instance
(Scroll
) )) : - Which scroll tool should initially be active. (default: ‘auto’)
- active_tap (
Either
(Auto
,String
,Instance
(Tap
) )) : - Which tap tool should initially be active. (default: ‘auto’)
- tools (
Either
(String
,Seq
(Either
(String
,Instance
(Tool
) ) ) )) : - Tools the plot should start with. (default: ‘pan,wheel_zoom,box_zoom,save,reset,help’)
- tooltips (
Either
(String
,List
(Tuple
(String
,String
) ) )) : - An optional argument to configure tooltips for the Figure. This argument
accepts the same values as the
HoverTool.tooltips
property. If a hover tool is specified in thetools
argument, this value will override that hover toolstooltips
value. If no hover tool is specified in thetools
argument, then passing tooltips here will cause one to be created and added. (default: None) - x_axis_label (
String
) : - A label for the x-axis. (default: ‘’)
- x_axis_location (
Enum
(VerticalLocation
)) : - Where the x-axis should be located. (default: ‘below’)
- x_axis_type (
Either
(Auto
,Enum
( Enumeration(linear, log, datetime, mercator) ) )) : - The type of the x-axis. (default: ‘auto’)
- x_minor_ticks (
Either
(Auto
,Int
)) : - Number of minor ticks between adjacent x-axis major ticks. (default: ‘auto’)
- x_range (
Any
) : - Customize the x-range of the plot. (default: None)
- y_axis_label (
String
) : - A label for the y-axis. (default: ‘’)
- y_axis_location (
Enum
(HorizontalLocation
)) : - Where the y-axis should be located. (default: ‘left’)
- y_axis_type (
Either
(Auto
,Enum
( Enumeration(linear, log, datetime, mercator) ) )) : - The type of the y-axis. (default: ‘auto’)
- y_minor_ticks (
Either
(Auto
,Int
)) : - Number of minor ticks between adjacent y-axis major ticks. (default: ‘auto’)
- y_range (
Any
) : - Customize the x-range of the plot. (default: None)
- active_drag (
-
class
Figure
(*arg, **kw)[source]¶ Create a new Figure for plotting.
A subclass of
Plot
that simplifies plot creation with default axes, grids, tools, etc.Figure objects have many glyph methods that can be used to draw vectorized graphical glyphs:
As well as a scatter function that can be parameterized by marker type:
There are also two specialized methods for stacking bars:
And one specialized method for making simple hexbin plots:
In addition to all the
Figure
property attributes, the following options are also accepted:Keyword Args:
- active_drag (
Either
(Auto
,String
,Instance
(Drag
) )) : - Which drag tool should initially be active. (default: ‘auto’)
- active_inspect (
Either
(Auto
,String
,Instance
(Inspection
),Seq
(Instance
(Inspection
) ) )) : - Which drag tool should initially be active. (default: ‘auto’)
- active_scroll (
Either
(Auto
,String
,Instance
(Scroll
) )) : - Which scroll tool should initially be active. (default: ‘auto’)
- active_tap (
Either
(Auto
,String
,Instance
(Tap
) )) : - Which tap tool should initially be active. (default: ‘auto’)
- tools (
Either
(String
,Seq
(Either
(String
,Instance
(Tool
) ) ) )) : - Tools the plot should start with. (default: ‘pan,wheel_zoom,box_zoom,save,reset,help’)
- tooltips (
Either
(String
,List
(Tuple
(String
,String
) ) )) : - An optional argument to configure tooltips for the Figure. This argument
accepts the same values as the
HoverTool.tooltips
property. If a hover tool is specified in thetools
argument, this value will override that hover toolstooltips
value. If no hover tool is specified in thetools
argument, then passing tooltips here will cause one to be created and added. (default: None) - x_axis_label (
String
) : - A label for the x-axis. (default: ‘’)
- x_axis_location (
Enum
(VerticalLocation
)) : - Where the x-axis should be located. (default: ‘below’)
- x_axis_type (
Either
(Auto
,Enum
( Enumeration(linear, log, datetime, mercator) ) )) : - The type of the x-axis. (default: ‘auto’)
- x_minor_ticks (
Either
(Auto
,Int
)) : - Number of minor ticks between adjacent x-axis major ticks. (default: ‘auto’)
- x_range (
Any
) : - Customize the x-range of the plot. (default: None)
- y_axis_label (
String
) : - A label for the y-axis. (default: ‘’)
- y_axis_location (
Enum
(HorizontalLocation
)) : - Where the y-axis should be located. (default: ‘left’)
- y_axis_type (
Either
(Auto
,Enum
( Enumeration(linear, log, datetime, mercator) ) )) : - The type of the y-axis. (default: ‘auto’)
- y_minor_ticks (
Either
(Auto
,Int
)) : - Number of minor ticks between adjacent y-axis major ticks. (default: ‘auto’)
- y_range (
Any
) : - Customize the x-range of the plot. (default: None)
-
annular_wedge
(x, y, inner_radius, outer_radius, start_angle, end_angle, direction='anticlock', **kwargs)¶ Configure and add
AnnularWedge
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-coordinates of the center of the annular wedges.
(default: None)
- y (
NumberSpec
) –The y-coordinates of the center of the annular wedges.
(default: None)
- inner_radius (
DistanceSpec
) –The inner radii of the annular wedges.
(default: None)
- outer_radius (
DistanceSpec
) –The outer radii of the annular wedges.
(default: None)
- start_angle (
AngleSpec
) –The angles to start the annular wedges, as measured from the horizontal.
(default: None)
- end_angle (
AngleSpec
) –The angles to end the annular wedges, as measured from the horizontal.
(default: None)
- direction (
Enum
(Direction
)) –Which direction to stroke between the start and end angles.
(default: ‘anticlock’)
Keyword Arguments: - end_angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the annular wedges.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the annular wedges.
(default: ‘gray’)
- inner_radius_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - line_alpha (
NumberSpec
) –The line alpha values for the annular wedges.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the annular wedges.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the annular wedges.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the annular wedges.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the annular wedges.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the annular wedges.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the annular wedges.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- outer_radius_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - start_angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer - x (
-
annulus
(x, y, inner_radius, outer_radius, **kwargs)¶ Configure and add
Annulus
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-coordinates of the center of the annuli.
(default: None)
- y (
NumberSpec
) –The y-coordinates of the center of the annuli.
(default: None)
- inner_radius (
DistanceSpec
) –The inner radii of the annuli.
(default: None)
- outer_radius (
DistanceSpec
) –The outer radii of the annuli.
(default: None)
Keyword Arguments: - fill_alpha (
NumberSpec
) –The fill alpha values for the annuli.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the annuli.
(default: ‘gray’)
- inner_radius_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - line_alpha (
NumberSpec
) –The line alpha values for the annuli.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the annuli.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the annuli.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the annuli.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the annuli.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the annuli.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the annuli.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- outer_radius_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.annulus(x=[1, 2, 3], y=[1, 2, 3], color="#7FC97F", inner_radius=0.2, outer_radius=0.5) show(plot)
- x (
-
arc
(x, y, radius, start_angle, end_angle, direction='anticlock', **kwargs)¶ Configure and add
Arc
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-coordinates of the center of the arcs.
(default: None)
- y (
NumberSpec
) –The y-coordinates of the center of the arcs.
(default: None)
- radius (
DistanceSpec
) –Radius of the arc.
(default: None)
- start_angle (
AngleSpec
) –The angles to start the arcs, as measured from the horizontal.
(default: None)
- end_angle (
AngleSpec
) –The angles to end the arcs, as measured from the horizontal.
(default: None)
- direction (
Enum
(Direction
)) –Which direction to stroke between the start and end angles.
(default: ‘anticlock’)
Keyword Arguments: - end_angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - line_alpha (
NumberSpec
) –The line alpha values for the arcs.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the arcs.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the arcs.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the arcs.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the arcs.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the arcs.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the arcs.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- radius_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - start_angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer - x (
-
asterisk
(x, y, size=4, angle=0.0, **kwargs)¶ Configure and add
Asterisk
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-axis coordinates for the center of the markers.
(default: None)
- y (
NumberSpec
) –The y-axis coordinates for the center of the markers.
(default: None)
- size (
ScreenDistanceSpec
) –The size (diameter) values for the markers in screen space units.
(default: 4)
- angle (
AngleSpec
) –The angles to rotate the markers.
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the markers.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the markers.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the markers.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the markers.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the markers.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the markers.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the markers.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the markers.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the markers.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.asterisk(x=[1,2,3], y=[1,2,3], size=20, color="#F0027F") show(plot)
- x (
-
bezier
(x0, y0, x1, y1, cx0, cy0, cx1, cy1, **kwargs)¶ Configure and add
Bezier
glyphs to this Figure.Parameters: - x0 (
NumberSpec
) –The x-coordinates of the starting points.
(default: None)
- y0 (
NumberSpec
) –The y-coordinates of the starting points.
(default: None)
- x1 (
NumberSpec
) –The x-coordinates of the ending points.
(default: None)
- y1 (
NumberSpec
) –The y-coordinates of the ending points.
(default: None)
- cx0 (
NumberSpec
) –The x-coordinates of first control points.
(default: None)
- cy0 (
NumberSpec
) –The y-coordinates of first control points.
(default: None)
- cx1 (
NumberSpec
) –The x-coordinates of second control points.
(default: None)
- cy1 (
NumberSpec
) –The y-coordinates of second control points.
(default: None)
Keyword Arguments: - line_alpha (
NumberSpec
) –The line alpha values for the Bézier curves.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the Bézier curves.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the Bézier curves.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the Bézier curves.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the Bézier curves.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the Bézier curves.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the Bézier curves.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer - x0 (
-
circle
(x, y, **kwargs)¶ Configure and add
Circle
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-axis coordinates for the center of the markers.
(default: None)
- y (
NumberSpec
) –The y-axis coordinates for the center of the markers.
(default: None)
Keyword Arguments: - angle (
AngleSpec
) –The angles to rotate the markers.
(default: 0.0)
- angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the markers.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the markers.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the markers.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the markers.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the markers.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the markers.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the markers.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the markers.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the markers.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- radius (
DistanceSpec
) –The radius values for circle markers (in “data space” units, by default).
Note
Circle markers are slightly unusual in that they support specifying a radius in addition to a size. Only one of
radius
orsize
should be given.Warning
Note that
Circle
glyphs are always drawn as circles on the screen, even in cases where the data space aspect ratio is not 1-1. In all cases where radius values are specified, the “distance” for the radius is measured along the dimension specified byradius_dimension
. If the aspect ratio is very large or small, the drawn circles may appear much larger or smaller than expected. See #626 for more information.(default: None)
- radius_dimension (
Enum
( Enumeration(x, y, max, min) )) –What dimension to measure circle radii along.
When the data space aspect ratio is not 1-1, then the size of the drawn circles depends on what direction is used to measure the “distance” of the radius. This property allows that direction to be controlled.
Setting this dimension to ‘max’ will calculate the radius on both the x and y dimensions and use the maximum of the two, ‘min’ selects the minimum.
(default: ‘x’)
- radius_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - size (
ScreenDistanceSpec
) –The size (diameter) values for the markers in screen space units.
(default: 4)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Note
Only one of
size
orradius
should be provided. Note thatradius
defaults to data units.Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.circle(x=[1, 2, 3], y=[1, 2, 3], size=20) show(plot)
- x (
-
circle_cross
(x, y, size=4, angle=0.0, **kwargs)¶ Configure and add
CircleCross
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-axis coordinates for the center of the markers.
(default: None)
- y (
NumberSpec
) –The y-axis coordinates for the center of the markers.
(default: None)
- size (
ScreenDistanceSpec
) –The size (diameter) values for the markers in screen space units.
(default: 4)
- angle (
AngleSpec
) –The angles to rotate the markers.
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the markers.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the markers.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the markers.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the markers.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the markers.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the markers.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the markers.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the markers.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the markers.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.circle_cross(x=[1,2,3], y=[4,5,6], size=20, color="#FB8072", fill_alpha=0.2, line_width=2) show(plot)
- x (
-
circle_x
(x, y, size=4, angle=0.0, **kwargs)¶ Configure and add
CircleX
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-axis coordinates for the center of the markers.
(default: None)
- y (
NumberSpec
) –The y-axis coordinates for the center of the markers.
(default: None)
- size (
ScreenDistanceSpec
) –The size (diameter) values for the markers in screen space units.
(default: 4)
- angle (
AngleSpec
) –The angles to rotate the markers.
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the markers.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the markers.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the markers.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the markers.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the markers.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the markers.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the markers.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the markers.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the markers.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.circle_x(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#DD1C77", fill_alpha=0.2) show(plot)
- x (
-
cross
(x, y, size=4, angle=0.0, **kwargs)¶ Configure and add
Cross
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-axis coordinates for the center of the markers.
(default: None)
- y (
NumberSpec
) –The y-axis coordinates for the center of the markers.
(default: None)
- size (
ScreenDistanceSpec
) –The size (diameter) values for the markers in screen space units.
(default: 4)
- angle (
AngleSpec
) –The angles to rotate the markers.
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the markers.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the markers.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the markers.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the markers.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the markers.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the markers.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the markers.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the markers.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the markers.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.cross(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#E6550D", line_width=2) show(plot)
- x (
-
dash
(x, y, size=4, angle=0.0, **kwargs)¶ Configure and add
Dash
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-axis coordinates for the center of the markers.
(default: None)
- y (
NumberSpec
) –The y-axis coordinates for the center of the markers.
(default: None)
- size (
ScreenDistanceSpec
) –The size (diameter) values for the markers in screen space units.
(default: 4)
- angle (
AngleSpec
) –The angles to rotate the markers.
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the markers.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the markers.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the markers.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the markers.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the markers.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the markers.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the markers.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the markers.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the markers.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.dash(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,25], color="#99D594", line_width=2) show(plot)
- x (
-
diamond
(x, y, size=4, angle=0.0, **kwargs)¶ Configure and add
Diamond
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-axis coordinates for the center of the markers.
(default: None)
- y (
NumberSpec
) –The y-axis coordinates for the center of the markers.
(default: None)
- size (
ScreenDistanceSpec
) –The size (diameter) values for the markers in screen space units.
(default: 4)
- angle (
AngleSpec
) –The angles to rotate the markers.
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the markers.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the markers.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the markers.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the markers.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the markers.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the markers.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the markers.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the markers.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the markers.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.diamond(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#1C9099", line_width=2) show(plot)
- x (
-
diamond_cross
(x, y, size=4, angle=0.0, **kwargs)¶ Configure and add
DiamondCross
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-axis coordinates for the center of the markers.
(default: None)
- y (
NumberSpec
) –The y-axis coordinates for the center of the markers.
(default: None)
- size (
ScreenDistanceSpec
) –The size (diameter) values for the markers in screen space units.
(default: 4)
- angle (
AngleSpec
) –The angles to rotate the markers.
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the markers.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the markers.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the markers.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the markers.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the markers.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the markers.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the markers.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the markers.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the markers.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.diamond_cross(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#386CB0", fill_color=None, line_width=2) show(plot)
- x (
-
ellipse
(x, y, width, height, angle=0.0, **kwargs)¶ Configure and add
Ellipse
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-coordinates of the centers of the ellipses.
(default: None)
- y (
NumberSpec
) –The y-coordinates of the centers of the ellipses.
(default: None)
- width (
DistanceSpec
) –The widths of each ellipse.
(default: None)
- height (
DistanceSpec
) –The heights of each ellipse.
(default: None)
- angle (
AngleSpec
) –The angle the ellipses are rotated from horizontal. [rad]
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the ovals.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the ovals.
(default: ‘gray’)
- height_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - line_alpha (
NumberSpec
) –The line alpha values for the ovals.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the ovals.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the ovals.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the ovals.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the ovals.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the ovals.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the ovals.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
- width_units (
Enum
(SpatialUnits
)) – (default: ‘data’)
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.ellipse(x=[1, 2, 3], y=[1, 2, 3], width=30, height=20, color="#386CB0", fill_color=None, line_width=2) show(plot)
- x (
-
graph
(node_source, edge_source, layout_provider, **kwargs)[source]¶ Creates a network graph using the given node, edge and layout provider.
Parameters: - node_source (
ColumnDataSource
) – a user-supplied data source for the graph nodes. An attempt will be made to convert the object toColumnDataSource
if needed. If none is supplied, one is created for the user automatically. - edge_source (
ColumnDataSource
) – a user-supplied data source for the graph edges. An attempt will be made to convert the object toColumnDataSource
if needed. If none is supplied, one is created for the user automatically. - layout_provider (
LayoutProvider
) – aLayoutProvider
instance to provide the graph coordinates in Cartesian space. - **kwargs – Line Properties and Fill Properties
- node_source (
-
hbar
(y, height, right, left=0, **kwargs)¶ Configure and add
HBar
glyphs to this Figure.Parameters: - y (
NumberSpec
) –The y-coordinates of the centers of the horizontal bars.
(default: None)
- height (
NumberSpec
) –The heights of the vertical bars.
(default: None)
- right (
NumberSpec
) –The x-coordinates of the right edges.
(default: None)
- left (
NumberSpec
) –The x-coordinates of the left edges.
(default: 0)
Keyword Arguments: - fill_alpha (
NumberSpec
) –The fill alpha values for the horizontal bars.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the horizontal bars.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the horizontal bars.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the horizontal bars.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the horizontal bars.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the horizontal bars.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the horizontal bars.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the horizontal bars.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the horizontal bars.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.hbar(y=[1, 2, 3], height=0.5, left=0, right=[1,2,3], color="#CAB2D6") show(plot)
- y (
-
hbar_stack
(stackers, **kw)[source]¶ Generate multiple
HBar
renderers for levels stacked left to right.Parameters: stackers (seq[str]) – a list of data source field names to stack successively for
left
andright
bar coordinates.Additionally, the
name
of the renderer will be set to the value of each successive stacker (this is useful with the special hover variable$name
)Any additional keyword arguments are passed to each call to
hbar
. If a keyword value is a list or tuple, then each call will get one value from the sequence.Returns: list[GlyphRenderer] Examples
Assuming a
ColumnDataSource
namedsource
with columns 2106 and 2017, then the following call tohbar_stack
will will create twoHBar
renderers that stack:p.hbar_stack(['2016', '2017'], x=10, width=0.9, color=['blue', 'red'], source=source)
This is equivalent to the following two separate calls:
p.hbar(bottom=stack(), top=stack('2016'), x=10, width=0.9, color='blue', source=source, name='2016') p.hbar(bottom=stack('2016'), top=stack('2016', '2017'), x=10, width=0.9, color='red', source=source, name='2017')
-
hex
(x, y, size=4, angle=0.0, **kwargs)¶ Configure and add
Hex
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-axis coordinates for the center of the markers.
(default: None)
- y (
NumberSpec
) –The y-axis coordinates for the center of the markers.
(default: None)
- size (
ScreenDistanceSpec
) –The size (diameter) values for the markers in screen space units.
(default: 4)
- angle (
AngleSpec
) –The angles to rotate the markers.
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the markers.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the markers.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the markers.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the markers.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the markers.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the markers.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the markers.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the markers.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the markers.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.hex(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,30], color="#74ADD1") show(plot)
- x (
-
hex_tile
(q, r, **kwargs)¶ Configure and add
HexTile
glyphs to this Figure.Parameters: - q (
NumberSpec
) –The “column” axial coordinates of the tile centers.
(default: None)
- r (
NumberSpec
) –The “row” axial coordinates of the tile centers.
(default: None)
Keyword Arguments: - aspect_scale (
Float
) – (default: 1.0) - fill_alpha (
NumberSpec
) –The fill alpha values for the horizontal bars.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the horizontal bars.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the horizontal bars.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the horizontal bars.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the horizontal bars.
(default: None)
- line_dash (
DashPattern
) –The line dash values for the horizontal bars.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the horizontal bars.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the horizontal bars.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the horizontal bars.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- orientation (
String
) – (default: ‘pointytop’) - scale (
NumberSpec
) –A scale factor for individual tiles.
(default: 1.0)
- size (
Float
) –The radius (in data space units) of the hex tiling.
The radius is always measured along the cartesian y-axis for “pointy_top” orientation, and along the cartesian x-axis for “flat_top” orientation. If the aspect ratio of the underlying cartesian system is not 1-1, then the tiles may be “squished” in one direction. To ensure that the tiles are always regular hexagons, consider setting the
match_aspect
property of the plot to True.(default: 1.0)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300, match_aspect=True) plot.hex_tile(r=[0, 0, 1], q=[1, 2, 2], fill_color="#74ADD1") show(plot)
- q (
-
hexbin
(x, y, size, orientation='pointytop', palette='Viridis256', line_color=None, fill_color=None, aspect_scale=1, **kwargs)[source]¶ Perform a simple equal-weight hexagonal binning.
A
HexTile
glyph will be added to display the binning. TheColumnDataSource
for the glyph will have columnsq
,r
, andcount
, whereq
andr
are axial coordinates for a tile, andcount
is the associated bin count.It is often useful to set
match_aspect=True
on the associated plot, so that hexagonal tiles are all regular (i.e. not “stretched”) in screen space.For more sophisticated use-cases, e.g. weighted binning or individually scaling hex tiles, use
hex_tile()
directly, or consider a higher level library such as HoloViews.Parameters: - x (array[float]) – A NumPy array of x-coordinates to bin into hexagonal tiles.
- y (array[float]) – A NumPy array of y-coordinates to bin into hexagonal tiles
- size (float) –
The size of the hexagonal tiling to use. The size is defined as distance from the center of a hexagon to a corner.
In case the aspect scaling is not 1-1, then specifically size is the distance from the center to the “top” corner with the “pointytop” orientation, and the distance from the center to a “side” corner with the “flattop” orientation.
- orientation ("pointytop" or "flattop", optional) – Whether the hexagonal tiles should be oriented with a pointed corner on top, or a flat side on top. (default: “pointytop”)
- palette (str or seq[color], optional) –
A palette (or palette name) to use to colormap the bins according to count. (default: ‘Viridis256’)
If
fill_color
is supplied, it overrides this value. - line_color (color, optional) – The outline color for hex tiles, or None (default: None)
- fill_color (color, optional) – An optional fill color for hex tiles, or None. If None, then
the
palette
will be used to color map the tiles by count. (default: None) - aspect_scale (float) –
Match a plot’s aspect ratio scaling.
When working with a plot with
aspect_scale != 1
, this parameter can be set to match the plot, in order to draw regular hexagons (instead of “stretched” ones).This is roughly equivalent to binning in “screen space”, and it may be better to use axis-aligned rectangular bins when plot aspect scales are not one.
Any additional keyword arguments are passed to
hex_tile()
.- Returns
- (Glyphrender, DataFrame)
- A tuple with the
HexTile
renderer generated to display the binning, and a PandasDataFrame
with columnsq
,r
, andcount
, whereq
andr
are axial coordinates for a tile, andcount
is the associated bin count.
Example
import numpy as np from bokeh.models import HoverTool from bokeh.plotting import figure, show x = 2 + 2*np.random.standard_normal(500) y = 2 + 2*np.random.standard_normal(500) p = figure(match_aspect=True, tools="wheel_zoom,reset") p.background_fill_color = '#440154' p.grid.visible = False p.hexbin(x, y, size=0.5, hover_color="pink", hover_alpha=0.8) hover = HoverTool(tooltips=[("count", "@c"), ("(q,r)", "(@q, @r)")]) p.add_tools(hover) show(p)
-
image
(image, x, y, dw, dh, global_alpha=1.0, dilate=False, **kwargs)¶ Configure and add
Image
glyphs to this Figure.Parameters: - image (
NumberSpec
) –The arrays of scalar data for the images to be colormapped.
(default: None)
- x (
NumberSpec
) –The x-coordinates to locate the image anchors.
(default: None)
- y (
NumberSpec
) –The y-coordinates to locate the image anchors.
(default: None)
- dw (
DistanceSpec
) –The widths of the plot regions that the images will occupy.
Note
This is not the number of pixels that an image is wide. That number is fixed by the image itself.
(default: None)
- dh (
DistanceSpec
) –The height of the plot region that the image will occupy.
Note
This is not the number of pixels that an image is tall. That number is fixed by the image itself.
(default: None)
- global_alpha (
Float
) –An overall opacity that each image is rendered with (in addition to any alpha values applied explicitly in a color mapper).
(default: 1.0)
- dilate (
Bool
) –Whether to always round fractional pixel locations in such a way as to make the images bigger.
This setting may be useful if pixel rounding errors are causing images to have a gap between them, when they should appear flush.
(default: False)
Keyword Arguments: - color_mapper (
Instance
(ColorMapper
)) –A
ColorMapper
to use to map the scalar data fromimage
into RGBA values for display.Note
The color mapping step happens on the client.
(default: None)
- dh_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - dw_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- palette (str or list[color value]) – a palette to construct a value for the color mapper property from
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Note
If both
palette
andcolor_mapper
are passed, aValueError
exception will be raised. If neither is passed, then theGreys9
palette will be used as a default.- image (
-
image_rgba
(image, x, y, dw, dh, global_alpha=1.0, dilate=False, **kwargs)¶ Configure and add
ImageRGBA
glyphs to this Figure.Parameters: - image (
NumberSpec
) –The arrays of RGBA data for the images.
(default: None)
- x (
NumberSpec
) –The x-coordinates to locate the image anchors.
(default: None)
- y (
NumberSpec
) –The y-coordinates to locate the image anchors.
(default: None)
- dw (
DistanceSpec
) –The widths of the plot regions that the images will occupy.
Note
This is not the number of pixels that an image is wide. That number is fixed by the image itself.
(default: None)
- dh (
DistanceSpec
) –The height of the plot region that the image will occupy.
Note
This is not the number of pixels that an image is tall. That number is fixed by the image itself.
(default: None)
- global_alpha (
Float
) –An overall opacity that each image is rendered with (in addition to any inherent alpha values in the image itself).
(default: 1.0)
- dilate (
Bool
) –Whether to always round fractional pixel locations in such a way as to make the images bigger.
This setting may be useful if pixel rounding errors are causing images to have a gap between them, when they should appear flush.
(default: False)
Keyword Arguments: - dh_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - dw_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Note
The
image_rgba
method accepts images as a two-dimensional array of RGBA values (encoded as 32-bit integers).- image (
-
image_url
(url, x, y, w, h, angle=0, global_alpha=1.0, dilate=False, **kwargs)¶ Configure and add
ImageURL
glyphs to this Figure.Parameters: - url (
StringSpec
) –The URLs to retrieve images from.
Note
The actual retrieving and loading of the images happens on the client.
(default: None)
- x (
NumberSpec
) –The x-coordinates to locate the image anchors.
(default: None)
- y (
NumberSpec
) –The y-coordinates to locate the image anchors.
(default: None)
- w (
DistanceSpec
) –The width of the plot region that the image will occupy in data space.
The default value is
None
, in which case the image will be displayed at its actual image size (regardless of the units specified here).(default: None)
- h (
DistanceSpec
) –The height of the plot region that the image will occupy in data space.
The default value is
None
, in which case the image will be displayed at its actual image size (regardless of the units specified here).(default: None)
- angle (
AngleSpec
) –The angles to rotate the images, as measured from the horizontal.
(default: 0)
- global_alpha (
Float
) –An overall opacity that each image is rendered with (in addition to any inherent alpha values in the image itself).
(default: 1.0)
- dilate (
Bool
) –Whether to always round fractional pixel locations in such a way as to make the images bigger.
This setting may be useful if pixel rounding errors are causing images to have a gap between them, when they should appear flush.
(default: False)
Keyword Arguments: - anchor (
Enum
(LegendLocation
)) –What position of the image should be anchored at the x, y coordinates.
(default: ‘top_left’)
- angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - h_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- retry_attempts (
Int
) –Number of attempts to retry loading the images from the specified URL. Default is zero.
(default: 0)
- retry_timeout (
Int
) –Timeout (in ms) between retry attempts to load the image from the specified URL. Default is zero ms.
(default: 0)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
- w_units (
Enum
(SpatialUnits
)) – (default: ‘data’)
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer - url (
-
inverted_triangle
(x, y, size=4, angle=0.0, **kwargs)¶ Configure and add
InvertedTriangle
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-axis coordinates for the center of the markers.
(default: None)
- y (
NumberSpec
) –The y-axis coordinates for the center of the markers.
(default: None)
- size (
ScreenDistanceSpec
) –The size (diameter) values for the markers in screen space units.
(default: 4)
- angle (
AngleSpec
) –The angles to rotate the markers.
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the markers.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the markers.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the markers.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the markers.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the markers.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the markers.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the markers.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the markers.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the markers.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.inverted_triangle(x=[1, 2, 3], y=[1, 2, 3], size=20, color="#DE2D26") show(plot)
- x (
-
line
(x, y, **kwargs)¶ Configure and add
Line
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-coordinates for the points of the line.
(default: None)
- y (
NumberSpec
) –The y-coordinates for the points of the line.
(default: None)
Keyword Arguments: - line_alpha (
Percent
) –The line alpha values for the line.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the line.
(default: ‘butt’)
- line_color (
Color
) –The line color values for the line.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the line.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the line.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the line.
(default: ‘bevel’)
- line_width (
Float
) –The line width values for the line.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show p = figure(title="line", plot_width=300, plot_height=300) p.line(x=[1, 2, 3, 4, 5], y=[6, 7, 2, 4, 5]) show(p)
- x (
-
multi_line
(xs, ys, **kwargs)¶ Configure and add
MultiLine
glyphs to this Figure.Parameters: - xs (
NumberSpec
) –The x-coordinates for all the lines, given as a “list of lists”.
(default: None)
- ys (
NumberSpec
) –The y-coordinates for all the lines, given as a “list of lists”.
(default: None)
Keyword Arguments: - line_alpha (
NumberSpec
) –The line alpha values for the lines.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the lines.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the lines.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the lines.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the lines.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the lines.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the lines.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Note
For this glyph, the data is not simply an array of scalars, it is an “array of arrays”.
Examples
from bokeh.plotting import figure, output_file, show p = figure(plot_width=300, plot_height=300) p.multi_line(xs=[[1, 2, 3], [2, 3, 4]], ys=[[6, 7, 2], [4, 5, 7]], color=['red','green']) show(p)
- xs (
-
multi_polygons
(xs, ys, **kwargs)¶ Configure and add
MultiPolygons
glyphs to this Figure.Parameters: - xs (
NumberSpec
) –The x-coordinates for all the patches, given as a nested list.
Note
Each item in
MultiPolygons
represents one MultiPolygon and each MultiPolygon is comprised ofn
Polygons. Each Polygon is made of one exterior ring optionally followed bym
interior rings (holes).(default: None)
- ys (
NumberSpec
) –The y-coordinates for all the patches, given as a “list of lists”.
Note
Each item in
MultiPolygons
represents one MultiPolygon and each MultiPolygon is comprised ofn
Polygons. Each Polygon is made of one exterior ring optionally followed bym
interior rings (holes).(default: None)
Keyword Arguments: - fill_alpha (
NumberSpec
) –The fill alpha values for the multipolygons.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the multipolygons.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the multipolygons.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the multipolygons.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the multipolygons.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the multipolygons.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the multipolygons.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the multipolygons.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the multipolygons.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Note
For this glyph, the data is not simply an array of scalars, it is a nested array.
Examples
from bokeh.plotting import figure, output_file, show p = figure(plot_width=300, plot_height=300) p.multi_polygons(xs=[[[[1, 1, 2, 2]]], [[[1, 1, 3], [1.5, 1.5, 2]]]], ys=[[[[4, 3, 3, 4]]], [[[1, 3, 1], [1.5, 2, 1.5]]]], color=['red', 'green']) show(p)
- xs (
-
oval
(x, y, width, height, angle=0.0, **kwargs)¶ Configure and add
Oval
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-coordinates of the centers of the ovals.
(default: None)
- y (
NumberSpec
) –The y-coordinates of the centers of the ovals.
(default: None)
- width (
DistanceSpec
) –The overall widths of each oval.
(default: None)
- height (
DistanceSpec
) –The overall height of each oval.
(default: None)
- angle (
AngleSpec
) –The angle the ovals are rotated from horizontal. [rad]
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the ovals.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the ovals.
(default: ‘gray’)
- height_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - line_alpha (
NumberSpec
) –The line alpha values for the ovals.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the ovals.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the ovals.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the ovals.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the ovals.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the ovals.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the ovals.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
- width_units (
Enum
(SpatialUnits
)) – (default: ‘data’)
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.oval(x=[1, 2, 3], y=[1, 2, 3], width=0.2, height=0.4, angle=-0.7, color="#1D91C0") show(plot)
- x (
-
patch
(x, y, **kwargs)¶ Configure and add
Patch
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-coordinates for the points of the patch.
Note
A patch may comprise multiple polygons. In this case the x-coordinates for each polygon should be separated by NaN values in the sequence.
(default: None)
- y (
NumberSpec
) –The y-coordinates for the points of the patch.
Note
A patch may comprise multiple polygons. In this case the y-coordinates for each polygon should be separated by NaN values in the sequence.
(default: None)
Keyword Arguments: - fill_alpha (
Percent
) –The fill alpha values for the patch.
(default: 1.0)
- fill_color (
Color
) –The fill color values for the patch.
(default: ‘gray’)
- line_alpha (
Percent
) –The line alpha values for the patch.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the patch.
(default: ‘butt’)
- line_color (
Color
) –The line color values for the patch.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the patch.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the patch.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the patch.
(default: ‘bevel’)
- line_width (
Float
) –The line width values for the patch.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show p = figure(plot_width=300, plot_height=300) p.patch(x=[1, 2, 3, 2], y=[6, 7, 2, 2], color="#99d8c9") show(p)
- x (
-
patches
(xs, ys, **kwargs)¶ Configure and add
Patches
glyphs to this Figure.Parameters: - xs (
NumberSpec
) –The x-coordinates for all the patches, given as a “list of lists”.
Note
Individual patches may comprise multiple polygons. In this case the x-coordinates for each polygon should be separated by NaN values in the sublists.
(default: None)
- ys (
NumberSpec
) –The y-coordinates for all the patches, given as a “list of lists”.
Note
Individual patches may comprise multiple polygons. In this case the y-coordinates for each polygon should be separated by NaN values in the sublists.
(default: None)
Keyword Arguments: - fill_alpha (
NumberSpec
) –The fill alpha values for the patches.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the patches.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the patches.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the patches.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the patches.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the patches.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the patches.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the patches.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the patches.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Note
For this glyph, the data is not simply an array of scalars, it is an “array of arrays”.
Examples
from bokeh.plotting import figure, output_file, show p = figure(plot_width=300, plot_height=300) p.patches(xs=[[1,2,3],[4,5,6,5]], ys=[[1,2,1],[4,5,5,4]], color=["#43a2ca", "#a8ddb5"]) show(p)
- xs (
-
quad
(left, right, top, bottom, **kwargs)¶ Configure and add
Quad
glyphs to this Figure.Parameters: - left (
NumberSpec
) –The x-coordinates of the left edges.
(default: None)
- right (
NumberSpec
) –The x-coordinates of the right edges.
(default: None)
- top (
NumberSpec
) –The y-coordinates of the top edges.
(default: None)
- bottom (
NumberSpec
) –The y-coordinates of the bottom edges.
(default: None)
Keyword Arguments: - fill_alpha (
NumberSpec
) –The fill alpha values for the quads.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the quads.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the quads.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the quads.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the quads.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the quads.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the quads.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the quads.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the quads.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.quad(top=[2, 3, 4], bottom=[1, 2, 3], left=[1, 2, 3], right=[1.2, 2.5, 3.7], color="#B3DE69") show(plot)
- left (
-
quadratic
(x0, y0, x1, y1, cx, cy, **kwargs)¶ Configure and add
Quadratic
glyphs to this Figure.Parameters: - x0 (
NumberSpec
) –The x-coordinates of the starting points.
(default: None)
- y0 (
NumberSpec
) –The y-coordinates of the starting points.
(default: None)
- x1 (
NumberSpec
) –The x-coordinates of the ending points.
(default: None)
- y1 (
NumberSpec
) –The y-coordinates of the ending points.
(default: None)
- cx (
NumberSpec
) –The x-coordinates of the control points.
(default: None)
- cy (
NumberSpec
) –The y-coordinates of the control points.
(default: None)
Keyword Arguments: - line_alpha (
NumberSpec
) –The line alpha values for the parabolas.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the parabolas.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the parabolas.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the parabolas.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the parabolas.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the parabolas.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the parabolas.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer - x0 (
-
ray
(x, y, length, angle, **kwargs)¶ Configure and add
Ray
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-coordinates to start the rays.
(default: None)
- y (
NumberSpec
) –The y-coordinates to start the rays.
(default: None)
- length (
DistanceSpec
) –The length to extend the ray. Note that this
length
defaults to data units (measured in the x-direction).(default: None)
- angle (
AngleSpec
) –The angles in radians to extend the rays, as measured from the horizontal.
(default: None)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - length_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - line_alpha (
NumberSpec
) –The line alpha values for the rays.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the rays.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the rays.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the rays.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the rays.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the rays.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the rays.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.ray(x=[1, 2, 3], y=[1, 2, 3], length=45, angle=-0.7, color="#FB8072", line_width=2) show(plot)
- x (
-
rect
(x, y, width, height, angle=0.0, dilate=False, **kwargs)¶ Configure and add
Rect
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-coordinates of the centers of the rectangles.
(default: None)
- y (
NumberSpec
) –The y-coordinates of the centers of the rectangles.
(default: None)
- width (
DistanceSpec
) –The overall widths of the rectangles.
(default: None)
- height (
DistanceSpec
) –The overall heights of the rectangles.
(default: None)
- angle (
AngleSpec
) –The angles to rotate the rectangles, as measured from the horizontal.
(default: 0.0)
- dilate (
Bool
) –Whether to always round fractional pixel locations in such a way as to make the rectangles bigger.
This setting may be useful if pixel rounding errors are causing rectangles to have a gap between them, when they should appear flush.
(default: False)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the rectangles.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the rectangles.
(default: ‘gray’)
- height_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - line_alpha (
NumberSpec
) –The line alpha values for the rectangles.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the rectangles.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the rectangles.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the rectangles.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the rectangles.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the rectangles.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the rectangles.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
- width_units (
Enum
(SpatialUnits
)) – (default: ‘data’)
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.rect(x=[1, 2, 3], y=[1, 2, 3], width=10, height=20, color="#CAB2D6", width_units="screen", height_units="screen") show(plot)
- x (
-
scatter
(*args, **kwargs)[source]¶ Creates a scatter plot of the given x and y items.
Parameters: - x (str or seq[float]) – values or field names of center x coordinates
- y (str or seq[float]) – values or field names of center y coordinates
- size (str or list[float]) – values or field names of sizes in screen units
- marker (str, or list[str]) – values or field names of marker types
- color (color value, optional) – shorthand to set both fill and line color
- source (
ColumnDataSource
) – a user-supplied data source. An attempt will be made to convert the object toColumnDataSource
if needed. If none is supplied, one is created for the user automatically. - **kwargs – Line Properties and Fill Properties
Examples
>>> p.scatter([1,2,3],[4,5,6], marker="square", fill_color="red") >>> p.scatter("data1", "data2", marker="mtype", source=data_source, ...)
Note
When passing
marker="circle"
it is also possible to supply aradius
value in data-space units. When configuring marker type from a data source column, all markers incuding circles may only be configured withsize
in screen units.
-
segment
(x0, y0, x1, y1, **kwargs)¶ Configure and add
Segment
glyphs to this Figure.Parameters: - x0 (
NumberSpec
) –The x-coordinates of the starting points.
(default: None)
- y0 (
NumberSpec
) –The y-coordinates of the starting points.
(default: None)
- x1 (
NumberSpec
) –The x-coordinates of the ending points.
(default: None)
- y1 (
NumberSpec
) –The y-coordinates of the ending points.
(default: None)
Keyword Arguments: - line_alpha (
NumberSpec
) –The line alpha values for the segments.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the segments.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the segments.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the segments.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the segments.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the segments.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the segments.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.segment(x0=[1, 2, 3], y0=[1, 2, 3], x1=[1, 2, 3], y1=[1.2, 2.5, 3.7], color="#F4A582", line_width=3) show(plot)
- x0 (
-
square
(x, y, size=4, angle=0.0, **kwargs)¶ Configure and add
Square
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-axis coordinates for the center of the markers.
(default: None)
- y (
NumberSpec
) –The y-axis coordinates for the center of the markers.
(default: None)
- size (
ScreenDistanceSpec
) –The size (diameter) values for the markers in screen space units.
(default: 4)
- angle (
AngleSpec
) –The angles to rotate the markers.
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the markers.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the markers.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the markers.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the markers.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the markers.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the markers.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the markers.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the markers.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the markers.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.square(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,30], color="#74ADD1") show(plot)
- x (
-
square_cross
(x, y, size=4, angle=0.0, **kwargs)¶ Configure and add
SquareCross
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-axis coordinates for the center of the markers.
(default: None)
- y (
NumberSpec
) –The y-axis coordinates for the center of the markers.
(default: None)
- size (
ScreenDistanceSpec
) –The size (diameter) values for the markers in screen space units.
(default: 4)
- angle (
AngleSpec
) –The angles to rotate the markers.
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the markers.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the markers.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the markers.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the markers.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the markers.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the markers.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the markers.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the markers.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the markers.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.square_cross(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,25], color="#7FC97F",fill_color=None, line_width=2) show(plot)
- x (
-
square_x
(x, y, size=4, angle=0.0, **kwargs)¶ Configure and add
SquareX
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-axis coordinates for the center of the markers.
(default: None)
- y (
NumberSpec
) –The y-axis coordinates for the center of the markers.
(default: None)
- size (
ScreenDistanceSpec
) –The size (diameter) values for the markers in screen space units.
(default: 4)
- angle (
AngleSpec
) –The angles to rotate the markers.
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the markers.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the markers.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the markers.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the markers.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the markers.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the markers.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the markers.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the markers.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the markers.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.square_x(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,25], color="#FDAE6B",fill_color=None, line_width=2) show(plot)
- x (
-
step
(x, y, **kwargs)¶ Configure and add
Step
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-coordinates for the steps.
(default: None)
- y (
NumberSpec
) –The y-coordinates for the steps.
(default: None)
Keyword Arguments: - line_alpha (
NumberSpec
) –The line alpha values for the steps.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the steps.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the steps.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the steps.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the steps.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the steps.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the steps.
(default: 1)
- mode (
Enum
(StepMode
)) –Where the step “level” should be drawn in relation to the x and y coordinates. The parameter can assume one of three values:
before
: (default) Draw step levels before each x-coordinate (no step before the first point)after
: Draw step levels after each x-coordinate (no step after the last point)center
: Draw step levels centered on each x-coordinate
(default: ‘before’)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.step(x=[1, 2, 3, 4, 5], y=[1, 2, 3, 2, 5], color="#FB8072") show(plot)
- x (
-
text
(x, y, text='text', angle=0, x_offset=0, y_offset=0, **kwargs)¶ Configure and add
Text
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-coordinates to locate the text anchors.
(default: None)
- y (
NumberSpec
) –The y-coordinates to locate the text anchors.
(default: None)
- text (
StringSpec
) –The text values to render.
(default: ‘text’)
- angle (
AngleSpec
) –The angles to rotate the text, as measured from the horizontal.
(default: 0)
- x_offset (
NumberSpec
) –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.
(default: 0)
- y_offset (
NumberSpec
) –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.
(default: 0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
- text_align (
Enum
(TextAlign
)) –The text align values for the text.
(default: ‘left’)
- text_alpha (
NumberSpec
) –The text alpha values for the text.
(default: 1.0)
- text_baseline (
Enum
(TextBaseline
)) –The text baseline values for the text.
(default: ‘bottom’)
- text_color (
ColorSpec
) –The text color values for the text.
(default: ‘#444444’)
- text_font (
String
) –The text font values for the text.
(default: ‘helvetica’)
- text_font_size (
FontSizeSpec
) –The text font size values for the text.
(default: {‘value’: ‘12pt’})
- text_font_style (
Enum
(FontStyle
)) –The text font style values for the text.
(default: ‘normal’)
- text_line_height (
Float
) –The text line height values for the text.
(default: 1.2)
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Note
The location and angle of the text relative to the
x
,y
coordinates is indicated by the alignment and baseline text properties.Returns: GlyphRenderer - x (
-
triangle
(x, y, size=4, angle=0.0, **kwargs)¶ Configure and add
Triangle
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-axis coordinates for the center of the markers.
(default: None)
- y (
NumberSpec
) –The y-axis coordinates for the center of the markers.
(default: None)
- size (
ScreenDistanceSpec
) –The size (diameter) values for the markers in screen space units.
(default: 4)
- angle (
AngleSpec
) –The angles to rotate the markers.
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the markers.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the markers.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the markers.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the markers.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the markers.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the markers.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the markers.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the markers.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the markers.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.triangle(x=[1, 2, 3], y=[1, 2, 3], size=[10,20,25], color="#99D594", line_width=2) show(plot)
- x (
-
vbar
(x, width, top, bottom=0, **kwargs)¶ Configure and add
VBar
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-coordinates of the centers of the vertical bars.
(default: None)
- width (
NumberSpec
) –The widths of the vertical bars.
(default: None)
- top (
NumberSpec
) –The y-coordinates of the top edges.
(default: None)
- bottom (
NumberSpec
) –The y-coordinates of the bottom edges.
(default: 0)
Keyword Arguments: - fill_alpha (
NumberSpec
) –The fill alpha values for the vertical bars.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the vertical bars.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the vertical bars.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the vertical bars.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the vertical bars.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the vertical bars.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the vertical bars.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the vertical bars.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the vertical bars.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.vbar(x=[1, 2, 3], width=0.5, bottom=0, top=[1,2,3], color="#CAB2D6") show(plot)
- x (
-
vbar_stack
(stackers, **kw)[source]¶ Generate multiple
VBar
renderers for levels stacked bottom to top.Parameters: stackers (seq[str]) – a list of data source field names to stack successively for
left
andright
bar coordinates.Additionally, the
name
of the renderer will be set to the value of each successive stacker (this is useful with the special hover variable$name
)Any additional keyword arguments are passed to each call to
vbar
. If a keyword value is a list or tuple, then each call will get one value from the sequence.Returns: list[GlyphRenderer] Examples
Assuming a
ColumnDataSource
namedsource
with columns 2016 and 2017, then the following call tovbar_stack
will will create twoVBar
renderers that stack:p.vbar_stack(['2016', '2017'], x=10, width=0.9, color=['blue', 'red'], source=source)
This is equivalent to the following two separate calls:
p.vbar(bottom=stack(), top=stack('2016'), x=10, width=0.9, color='blue', source=source, name='2016') p.vbar(bottom=stack('2016'), top=stack('2016', '2017'), x=10, width=0.9, color='red', source=source, name='2017')
-
wedge
(x, y, radius, start_angle, end_angle, direction='anticlock', **kwargs)¶ Configure and add
Wedge
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-coordinates of the points of the wedges.
(default: None)
- y (
NumberSpec
) –The y-coordinates of the points of the wedges.
(default: None)
- radius (
DistanceSpec
) –Radii of the wedges.
(default: None)
- start_angle (
AngleSpec
) –The angles to start the wedges, as measured from the horizontal.
(default: None)
- end_angle (
AngleSpec
) –The angles to end the wedges, as measured from the horizontal.
(default: None)
- direction (
Enum
(Direction
)) –Which direction to stroke between the start and end angles.
(default: ‘anticlock’)
Keyword Arguments: - end_angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the wedges.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the wedges.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the wedges.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the wedges.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the wedges.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the wedges.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the wedges.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the wedges.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the wedges.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- radius_units (
Enum
(SpatialUnits
)) – (default: ‘data’) - start_angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.wedge(x=[1, 2, 3], y=[1, 2, 3], radius=15, start_angle=0.6, end_angle=4.1, radius_units="screen", color="#2b8cbe") show(plot)
- x (
-
x
(x, y, size=4, angle=0.0, **kwargs)¶ Configure and add
X
glyphs to this Figure.Parameters: - x (
NumberSpec
) –The x-axis coordinates for the center of the markers.
(default: None)
- y (
NumberSpec
) –The y-axis coordinates for the center of the markers.
(default: None)
- size (
ScreenDistanceSpec
) –The size (diameter) values for the markers in screen space units.
(default: 4)
- angle (
AngleSpec
) –The angles to rotate the markers.
(default: 0.0)
Keyword Arguments: - angle_units (
Enum
(AngleUnits
)) – (default: ‘rad’) - fill_alpha (
NumberSpec
) –The fill alpha values for the markers.
(default: 1.0)
- fill_color (
ColorSpec
) –The fill color values for the markers.
(default: ‘gray’)
- line_alpha (
NumberSpec
) –The line alpha values for the markers.
(default: 1.0)
- line_cap (
Enum
(LineCap
)) –The line cap values for the markers.
(default: ‘butt’)
- line_color (
ColorSpec
) –The line color values for the markers.
(default: ‘black’)
- line_dash (
DashPattern
) –The line dash values for the markers.
(default: [])
- line_dash_offset (
Int
) –The line dash offset values for the markers.
(default: 0)
- line_join (
Enum
(LineJoin
)) –The line join values for the markers.
(default: ‘bevel’)
- line_width (
NumberSpec
) –The line width values for the markers.
(default: 1)
- name (
String
) –An arbitrary, user-supplied name for this model.
This name can be useful when querying the document to retrieve specific Bokeh models.
>>> plot.circle([1,2,3], [4,5,6], name=”temp”) >>> plot.select(name=”temp”) [GlyphRenderer(id=‘399d53f5-73e9-44d9-9527-544b761c7705’, …)]
Note
No uniqueness guarantees or other conditions are enforced on any names that are provided, nor is the name used directly by Bokeh for any reason.
(default: None)
- tags (
List
(Any
)) –An optional list of arbitrary, user-supplied values to attach to this model.
This data can be useful when querying the document to retrieve specific Bokeh models:
>>> r = plot.circle([1,2,3], [4,5,6]) >>> r.tags = [“foo”, 10] >>> plot.select(tags=[‘foo’, 10]) [GlyphRenderer(id=‘1de4c3df-a83d-480a-899b-fb263d3d5dd9’, …)]
Or simply a convenient way to attach any necessary metadata to a model that can be accessed by
CustomJS
callbacks, etc.Note
No uniqueness guarantees or other conditions are enforced on any tags that are provided, nor are the tags used directly by Bokeh for any reason.
(default: [])
Other Parameters: - alpha (float) – an alias to set all alpha keyword args at once
- color (Color) – an alias to set all color keyword args at once
- source (ColumnDataSource) – a user supplied data source
- legend (str) – a legend tag for this glyph
- x_range_name (str) – name an extra range to use for mapping x-coordinates
- y_range_name (str) – name an extra range to use for mapping y-coordinates
- level (Enum) – control the render level order for this glyph
It is also possible to set the color and alpha parameters of a “nonselection” glyph. To do so, prefix any visual parameter with
'nonselection_'
. For example, passnonselection_alpha
ornonselection_fill_alpha
.Returns: GlyphRenderer Examples
from bokeh.plotting import figure, output_file, show plot = figure(plot_width=300, plot_height=300) plot.x(x=[1, 2, 3], y=[1, 2, 3], size=[10, 20, 25], color="#fa9fb5") show(plot)
- x (
- active_drag (
-
gmap
(google_api_key, map_options, **kwargs)[source]¶ Create a new
GMap
for plotting.Parameters: - google_api_key (str) –
Google requires an API key be supplied for maps to function. See:
https://developers.google.com/maps/documentation/javascript/get-api-key
- map_options – (GMapOptions) Configuration specific to a Google Map
In addition to the standard
GMap
keyword arguments (e.g.plot_width
orsizing_mode
), the following additional options can be passed as well:Keyword Args:
- active_drag (
Either
(Auto
,String
,Instance
(Drag
) )) : - Which drag tool should initially be active. (default: ‘auto’)
- active_inspect (
Either
(Auto
,String
,Instance
(Inspection
),Seq
(Instance
(Inspection
) ) )) : - Which drag tool should initially be active. (default: ‘auto’)
- active_scroll (
Either
(Auto
,String
,Instance
(Scroll
) )) : - Which scroll tool should initially be active. (default: ‘auto’)
- active_tap (
Either
(Auto
,String
,Instance
(Tap
) )) : - Which tap tool should initially be active. (default: ‘auto’)
- tools (
Either
(String
,Seq
(Either
(String
,Instance
(Tool
) ) ) )) : - Tools the plot should start with. (default: ‘pan,wheel_zoom,reset,help’)
- x_axis_label (
String
) : - A label for the x-axis. (default: ‘’)
- x_axis_location (
Enum
(VerticalLocation
)) : - Where the x-axis should be located. (default: ‘below’)
- x_minor_ticks (
Either
(Auto
,Int
)) : - Number of minor ticks between adjacent x-axis major ticks. (default: ‘auto’)
- y_axis_label (
String
) : - A label for the y-axis. (default: ‘’)
- y_axis_location (
Enum
(HorizontalLocation
)) : - Where the y-axis should be located. (default: ‘left’)
- y_minor_ticks (
Either
(Auto
,Int
)) : - Number of minor ticks between adjacent y-axis major ticks. (default: ‘auto’)
Returns: GMap - google_api_key (str) –
-
class
GMapPlot
(*args, **kw)[source]¶ A Bokeh Plot with a Google Map displayed underneath.
Data placed on this plot should be specified in decimal lat/lon coordinates e.g.
(37.123, -122.404)
. It will be automatically converted into the web mercator projection to display properly over google maps tiles.Please also note that only
Range1d
ranges are supported byGMapPlot
.-
api_key
¶ property type:
String
Google Maps API requires an API key. See https://developers.google.com/maps/documentation/javascript/get-api-key for more information on how to obtain your own.
-
map_options
¶ property type:
Instance
(GMapOptions
)Options for displaying the plot.
-