bokeh.charts¶

Area¶

Area(data=None, x=None, y=None, **kws)[source]¶

Create an area chart using AreaBuilder to render the geometry from values.

Parameters:	data (Accepted Charts Data Formats) – table-like data x (str or list(str), optional) – the column label to use for the x dimension y (str or list(str), optional) – the column label to use for the y dimension

In addition the the parameters specific to this chart, Chart Defaults are also accepted as keyword parameters.

Returns:	includes glyph renderers that generate the area glyphs
Return type:	Chart

Examples:

from bokeh.charts import Area, show, output_file

# create some example data
data = dict(
    python=[2, 3, 7, 5, 26, 221, 44, 233, 254, 265, 266, 267, 120, 111],
    pypy=[12, 33, 47, 15, 126, 121, 144, 233, 254, 225, 226, 267, 110, 130],
    jython=[22, 43, 10, 25, 26, 101, 114, 203, 194, 215, 201, 227, 139, 160],
)

area = Area(data, title="Area Chart", legend="top_left",
            xlabel='time', ylabel='memory')

output_file('area.html')
show(area)

Bar¶

Bar(data, label=None, values=None, color=None, stack=None, group=None, agg='sum', xscale='categorical', yscale='linear', xgrid=False, ygrid=True, continuous_range=None, **kw)[source]¶

Create a Bar chart using BarBuilder render the geometry from values, cat and stacked.

Parameters:

data (Accepted Charts Data Formats) – the data source for the chart. label (list(str) or str, optional) – list of string representing the categories. (Defaults to None) values (str, optional) – iterable 2d representing the data series values matrix. color (str or list(str) or ~bokeh.charts._attributes.ColorAttr) – string color, string column name, list of string columns or a custom ColorAttr, which replaces the default ColorAttr for the builder. stack (list(str) or str, optional) – columns to use for stacking. (Defaults to False, so grouping is assumed) group (list(str) or str, optional) – columns to use for grouping. agg (str) – how to aggregate the values. (Defaults to ‘sum’, or only label is provided, then performs a count) continuous_range (Range1d, optional) – Custom continuous_range to be used. (Defaults to None)

In addition to the parameters specific to this chart, Chart Defaults are also accepted as keyword parameters.

Returns:	includes glyph renderers that generate bars
Return type:	Chart

Examples

from bokeh.charts import Bar, output_file, show
from bokeh.layouts import row

# best support is with data in a format that is table-like
data = {
    'sample': ['1st', '2nd', '1st', '2nd', '1st', '2nd'],
    'interpreter': ['python', 'python', 'pypy', 'pypy', 'jython', 'jython'],
    'timing': [-2, 5, 12, 40, 22, 30]
}

# x-axis labels pulled from the interpreter column, stacking labels from sample column
bar = Bar(data, values='timing', label='interpreter', stack='sample', agg='mean',
          title="Python Interpreter Sampling", legend='top_right', plot_width=400)

# table-like data results in reconfiguration of the chart with no data manipulation
bar2 = Bar(data, values='timing', label=['interpreter', 'sample'],
           agg='mean', title="Python Interpreters", plot_width=400)

output_file("stacked_bar.html")
show(row(bar, bar2))

BoxPlot¶

BoxPlot(data, label=None, values=None, color=None, group=None, xscale='categorical', yscale='linear', xgrid=False, ygrid=True, continuous_range=None, **kw)[source]¶

Create a BoxPlot chart containing one or more boxes from table-like data.

Create a boxplot chart using BoxPlotBuilder to render the glyphs from input data and specification. This primary use case for the boxplot is to depict the distribution of a variable by providing summary statistics for it. This boxplot is particularly useful at comparing distributions between categorical variables.

This chart implements functionality for segmenting and comparing the values of a variable by an associated categorical variable.

Reference: BoxPlot on Wikipedia

Parameters:

data (Accepted Charts Data Formats) – the data source for the chart values (str, optional) – the values to use for producing the boxplot using table-like input data label (str or list(str), optional) – the categorical variable to use for creating separate boxes color (str or list(str) or bokeh.charts._attributes.ColorAttr, optional) – the categorical variable or color attribute specification to use for coloring the boxes. whisker_color (str or list(str) or bokeh.charts._attributes.ColorAttr, optional) – the color of the “whiskers” that show the spread of values outside the .25 and .75 quartiles. marker (str or list(str) or bokeh.charts._attributes.MarkerAttr, optional) – the marker glyph to use for the outliers outliers (bool, optional) – whether to show outliers. Defaults to True. **kw –

In addition to the parameters specific to this chart, Chart Defaults are also accepted as keyword parameters.

Returns:	includes glyph renderers that generate Boxes and Whiskers
Return type:	Chart

Examples:

from bokeh.charts import BoxPlot, output_file, show
from bokeh.layouts import row
from bokeh.sampledata.autompg import autompg as df

box = BoxPlot(df, values='mpg', label='cyl', title="Auto MPG Box Plot", plot_width=400)
box2 = BoxPlot(df, values='mpg', label='cyl', color='cyl',
               title="MPG Box Plot by Cylinder Count", plot_width=400)

output_file('box.html')
show(row(box, box2))

Chord¶

Chord(data, source=None, target=None, value=None, square_matrix=False, label=None, xgrid=False, ygrid=False, **kw)[source]¶

Create a chord chart using ChordBuilder to render a chord graph from a variety of value forms. This chart displays the inter-relationships between data in a matrix.

The data can be generated by the chart interface. Given a DataFrame, select two columns to be used as arcs with source and target attributes, passing by the name of those columns. The Chord chart will then deduce the relationship between the arcs.

The value of the connections can be inferred automatically by counting source and target. If you prefer you can assign a fixed value for all the connections with value simply passing by a number. A third option is to pass a reference to a third column in the DataFrame with the values for the connections.

If you want to plot the relationships in a squared matrix, simply pass the matrix and set square_matrix attribute to True.

Reference: Chord diagram on Wikipedia

Parameters:	data (Accepted Charts Data Formats) – the data source for the chart. source (list(str) or str, optional) – Data source to use as origin of the connection to a destination. target (list(str) or str, optional) – Data source to use as destination of a connection. value (list(num) or num, optional) – The value the connection should have. square_matrix (bool, optional) – If square matrix, avoid any calculations during the setup. label (list(str), optional) – The labels to be put in the areas.
Returns:	includes glyph renderers that generate the chord
Return type:	Chart

Examples:

import pandas as pd
from bokeh.charts import Chord
from bokeh.io import show, output_file
from bokeh.sampledata.les_mis import data

nodes = data['nodes']
links = data['links']

nodes_df = pd.DataFrame(nodes)
links_df = pd.DataFrame(links)

source_data = links_df.merge(nodes_df, how='left', left_on='source', right_index=True)
source_data = source_data.merge(nodes_df, how='left', left_on='target', right_index=True)
source_data = source_data[source_data["value"] > 5]  # Select those with 5 or more connections

chord_from_df = Chord(source_data, source="name_x", target="name_y", value="value")
output_file('chord_from_df.html')
show(chord_from_df)

Donut¶

Donut(data, label='index', values=None, color=None, agg=None, hover_tool=True, hover_text=None, plot_height=400, plot_width=400, xgrid=False, ygrid=False, **kw)[source]¶

Create a Donut chart containing one or more layers from table-like data.

Create a donut chart using DonutBuilder to render the glyphs from input data and specification. The primary use case for the donut chart is to show relative amount each category, within a categorical array or multiple categorical arrays, makes up of the whole for some array of values.

Parameters:

data (Accepted Charts Data Formats) – the data source for the chart label (str or list(str), optional): the categorical variable to use for creating separate boxes values (str, optional) – the values to use for producing the boxplot using table-like input data color (str or list(str) or bokeh.charts._attributes.ColorAttr, optional) – the categorical variable or color attribute specification to use for coloring the wedges agg (str, optional) – how the values associated with a wedge should be aggregated hover_tool (bool, optional) – whether to show the value of the wedge when hovering hover_text (str, optional) – provide an alternative string to use to label the value shown with the hover tool **kw –

In addition to the parameters specific to this chart, Chart Defaults are also accepted as keyword parameters.

Returns:	includes glyph renderers that generate the wedges the make up the donut(s)
Return type:	Chart

Examples:

from bokeh.charts import Donut, show, output_file
from bokeh.charts.utils import df_from_json
from bokeh.sampledata.olympics2014 import data

import pandas as pd

# utilize utility to make it easy to get json/dict data converted to a dataframe
df = df_from_json(data)

# filter by countries with at least one medal and sort by total medals
df = df[df['total'] > 8]
df = df.sort_values(by="total", ascending=False)
df = pd.melt(df, id_vars=['abbr'],
             value_vars=['bronze', 'silver', 'gold'],
             value_name='medal_count', var_name='medal')

# original example
d = Donut(df, label=['abbr', 'medal'], values='medal_count',
          text_font_size='8pt', hover_text='medal_count')

output_file("donut.html")

show(d)

HeatMap¶

HeatMap(data, x=None, y=None, values=None, stat='count', xgrid=False, ygrid=False, hover_tool=True, hover_text=None, **kw)[source]¶

Represent 3 dimensions in a HeatMap chart using x, y, and values.

Uses the HeatMapBuilder to render the geometry from values.

A HeatMap is a 3 Dimensional chart that crosses two dimensions, then aggregates values that correspond to the intersection of the horizontal and vertical dimensions. The value that falls at the intersection is then mapped to a color in a palette by default. All values that map to the positions on the chart are binned by the number of discrete colors in the palette.

Parameters:

data (Accepted Charts Data Formats) – the data source for the chart x (str or list(str), optional) – specifies variable(s) to use for x axis y (str or list(str), optional) – specifies variable(s) to use for y axis values (str, optional) – the values to use for producing the histogram using table-like input data stat (str, optional) – the aggregation to use. Defaults to count. If provided None, then no aggregation will be attempted. This is useful for cases when the values have already been aggregated. hover_tool (bool, optional) – whether to show the hover tool. Defaults to True hover_text (str, optional) – a string to place beside the value in the hover tooltip. Defaults to None. When None, a hover_text will be derived from the aggregation and the values column.

In addition to the parameters specific to this chart, Chart Defaults are also accepted as keyword parameters.

Returns:	a new Chart

Examples:

from bokeh.charts import HeatMap, output_file, show

# (dict, OrderedDict, lists, arrays and DataFrames are valid inputs)
data = {'fruit': ['apples']*3 + ['bananas']*3 + ['pears']*3,
        'fruit_count': [4, 5, 8, 1, 2, 4, 6, 5, 4],
        'sample': [1, 2, 3]*3}

hm = HeatMap(data, x='fruit', y='sample', values='fruit_count',
             title='Fruits', stat=None)

output_file('heatmap.html')
show(hm)

Histogram¶

Histogram(data, values=None, label=None, color=None, agg='count', bins=None, yscale='linear', xgrid=False, ygrid=True, continuous_range=None, **kw)[source]¶

Create a histogram chart with one or more histograms.

Create a histogram chart using HistogramBuilder to render the glyphs from input data and specification. This primary use case for the histogram is to depict the distribution of a variable by binning and aggregating the values in each bin.

This chart implements functionality to provide convenience in optimal selection of bin count, but also for segmenting and comparing segments of the variable by a categorical variable.

Parameters:

data (Accepted Charts Data Formats) – the data source for the chart. Must consist of at least 2 values. If all values are equal, the result is a single bin with arbitrary width. values (str, optional) – the values to use for producing the histogram using table-like input data label (str or list(str), optional) – the categorical variable to use for creating separate histograms color (str or list(str) or ~bokeh.charts._attributes.ColorAttr, optional) – the categorical variable or color attribute specification to use for coloring the histogram, or explicit color as a string. agg (str, optional) – how to aggregate the bins. Defaults to “count”. bins (int or list(float), optional) – the number of bins to use, or an explicit list of bin edges. Defaults to None to auto select. density (bool, optional) – whether to normalize the histogram. Defaults to False. **kw –

In addition to the parameters specific to this chart, Chart Defaults are also accepted as keyword parameters.

Returns:	includes glyph renderers that generate the histograms
Return type:	Chart

Examples:

from bokeh.charts import Histogram, output_file, show
from bokeh.layouts import row
from bokeh.sampledata.autompg import autompg as df

hist = Histogram(df, values='mpg', title="Auto MPG Histogram", plot_width=400)
hist2 = Histogram(df, values='mpg', label='cyl', color='cyl', legend='top_right',
                  title="MPG Histogram by Cylinder Count", plot_width=400)

output_file('hist.html')
show(row(hist, hist2))

Horizon¶

Horizon(data=None, x=None, y=None, series=None, **kws)[source]¶

Create a horizon chart using HorizonBuilder to render the geometry from values.

Parameters:	data (Accepted Charts Data Formats) – table-like data x (str or list(str), optional) – the column label to use for the x dimension y (str or list(str), optional) – the column label to use for the y dimension

In addition to the parameters specific to this chart, Chart Defaults are also accepted as keyword parameters.

Returns:	includes glyph renderers that generate the scatter points
Return type:	Chart

Examples:

import pandas as pd
from bokeh.charts import Horizon, output_file, show

# read in some stock data from the Yahoo Finance API
AAPL = pd.read_csv(
    "http://ichart.yahoo.com/table.csv?s=AAPL&a=0&b=1&c=2000&d=0&e=1&f=2010",
    parse_dates=['Date'])

MSFT = pd.read_csv(
    "http://ichart.yahoo.com/table.csv?s=MSFT&a=0&b=1&c=2000&d=0&e=1&f=2010",
    parse_dates=['Date'])

IBM = pd.read_csv(
    "http://ichart.yahoo.com/table.csv?s=IBM&a=0&b=1&c=2000&d=0&e=1&f=2010",
    parse_dates=['Date'])

data = dict([
    ('AAPL', AAPL['Adj Close']),
    ('Date', AAPL['Date']),
    ('MSFT', MSFT['Adj Close']),
    ('IBM', IBM['Adj Close'])]
)

hp = Horizon(data, x='Date', plot_width=800, plot_height=300,
             title="horizon plot using stock inputs")

output_file("horizon.html")

show(hp)

Line¶

Line(data=None, x=None, y=None, **kws)[source]¶

Create a line chart using LineBuilder to render the glyphs.

The line chart is typically is used with column oriented data, where each column contains comparable measurements and the column names are treated as a categorical variable for differentiating the measurement values. One of the columns can be used as an index for either the x or y axis.

Note

Only the x or y axis can display multiple variables, while the other is used as an index.

Parameters:	data (list(list), numpy.ndarray, pandas.DataFrame, list(pd.Series)) – a 2d data source with columns of data for each line. x (str or list(str), optional) – specifies variable(s) to use for x axis y (str or list(str), optional) – specifies variable(s) to use for y axis

In addition to the parameters specific to this chart, Chart Defaults are also accepted as keyword parameters.

Note

This chart type differs on input types as compared to other charts, due to the way that line charts typically are plotting labeled series. For example, a column for AAPL stock prices over time. Another way this could be plotted is to have a DataFrame with a column of stock_label and columns of price, which is the stacked format. Both should be supported, but the former is the expected one. Internally, the latter format is being derived.

Returns:	includes glyph renderers that generate the lines
Return type:	Chart

Examples:

import numpy as np
from bokeh.charts import Line, output_file, show

# (dict, OrderedDict, lists, arrays and DataFrames are valid inputs)
xyvalues = np.array([[2, 3, 7, 5, 26], [12, 33, 47, 15, 126], [22, 43, 10, 25, 26]])

line = Line(xyvalues, title="line", legend="top_left", ylabel='Languages')

output_file('line.html')
show(line)

Scatter¶

Scatter(data=None, x=None, y=None, **kws)[source]¶

Create a scatter chart using ScatterBuilder to render the geometry from values.

Parameters:	data (Accepted Charts Data Formats) – table-like data x (str or list(str), optional) – the column label to use for the x dimension y (str or list(str), optional) – the column label to use for the y dimension

In addition to the parameters specific to this chart, Chart Defaults are also accepted as keyword parameters.

Returns:	includes glyph renderers that generate the scatter points
Return type:	Chart

Examples:

from bokeh.sampledata.autompg import autompg as df
from bokeh.charts import Scatter, output_file, show

scatter = Scatter(df, x='mpg', y='hp', color='cyl', marker='origin',
                  title="Auto MPG", xlabel="Miles Per Gallon",
                  ylabel="Horsepower")

output_file('scatter.html')
show(scatter)

Step¶

Step(data=None, x=None, y=None, **kws)[source]¶

Create a step chart using StepBuilder to render the geometry from the inputs.

Note

Only the x or y axis can display multiple variables, while the other is used as an index.

Parameters:	data (list(list), numpy.ndarray, pandas.DataFrame, list(pd.Series)) – a 2d data source with columns of data for each stepped line. x (str or list(str), optional) – specifies variable(s) to use for x axis y (str or list(str), optional) – specifies variable(s) to use for y axis

In addition to the parameters specific to this chart, Chart Defaults are also accepted as keyword parameters.

Note

This chart type differs on input types as compared to other charts, due to the way that series-type charts typically are plotting labeled series. For example, a column for AAPL stock prices over time. Another way this could be plotted is to have a DataFrame with a column of stock_label and columns of price, which is the stacked format. Both should be supported, but the former is the expected one. Internally, the latter format is being derived.

Returns:	includes glyph renderers that generate the stepped lines
Return type:	Chart

Examples:

from bokeh.charts import Step, show, output_file

# build a dataset where multiple columns measure the same thing
data = dict(
           stamp=[.33, .33, .34, .37, .37, .37, .37, .39, .41, .42,
                  .44, .44, .44, .45, .46, .49, .49],
           postcard=[.20, .20, .21, .23, .23, .23, .23, .24, .26, .27,
                     .28, .28, .29, .32, .33, .34, .35]
       )

# create a step chart where each column of measures receives a unique color and dash style
step = Step(data, y=['stamp', 'postcard'],
            dash=['stamp', 'postcard'],
            color=['stamp', 'postcard'],
            title="U.S. Postage Rates (1999-2015)",
            ylabel='Rate per ounce', legend=True)

output_file("steps.html")

show(step)

TimeSeries¶

TimeSeries(data=None, x=None, y=None, builder_type=<class 'bokeh.charts.builders.line_builder.LineBuilder'>, **kws)[source]¶

Create a timeseries chart using LineBuilder to produce the renderers from the inputs. The timeseries chart acts as a switchboard to produce charts for timeseries data with different glyph representations.

Parameters:

data (list(list), numpy.ndarray, pandas.DataFrame, list(pd.Series)) – a 2d data source with columns of data for each stepped line. x (str or list(str), optional) – specifies variable(s) to use for x axis y (str or list(str), optional) – specifies variable(s) to use for y axis builder_type (str or Builder, optional) – the type of builder to use to produce the renderers. Supported options are ‘line’, ‘step’, or ‘point’.

In addition to the parameters specific to this chart, Chart Defaults are also accepted as keyword parameters.

Returns:	a new Chart

Examples:

import pandas as pd

from bokeh.charts import TimeSeries, show, output_file
from bokeh.layouts import column

# read in some stock data from the Yahoo Finance API
AAPL = pd.read_csv(
    "http://ichart.yahoo.com/table.csv?s=AAPL&a=0&b=1&c=2000&d=0&e=1&f=2010",
    parse_dates=['Date'])
MSFT = pd.read_csv(
    "http://ichart.yahoo.com/table.csv?s=MSFT&a=0&b=1&c=2000&d=0&e=1&f=2010",
    parse_dates=['Date'])
IBM = pd.read_csv(
    "http://ichart.yahoo.com/table.csv?s=IBM&a=0&b=1&c=2000&d=0&e=1&f=2010",
    parse_dates=['Date'])

data = dict(
    AAPL=AAPL['Adj Close'],
    Date=AAPL['Date'],
    MSFT=MSFT['Adj Close'],
    IBM=IBM['Adj Close'],
)

tsline = TimeSeries(data,
    x='Date', y=['IBM', 'MSFT', 'AAPL'],
    color=['IBM', 'MSFT', 'AAPL'], dash=['IBM', 'MSFT', 'AAPL'],
    title="Timeseries", ylabel='Stock Prices', legend=True)

tspoint = TimeSeries(data,
    x='Date', y=['IBM', 'MSFT', 'AAPL'],
    color=['IBM', 'MSFT', 'AAPL'], dash=['IBM', 'MSFT', 'AAPL'],
    builder_type='point', title="Timeseries Points",
    ylabel='Stock Prices', legend=True)

output_file("timeseries.html")

show(column(tsline, tspoint))

Data Operations¶

blend(*cols, **kwargs)[source]¶

Provides a simple function for specifying a Blend data operation.

Parameters:	cols (str) – each column to use for blending by name **kwargs – the keyword args supported by Blend name (str): name of the column to contain the blended values labels_name (str): name of the column to contain the name of the columns used for blending

See Blend

bins(data, values=None, column=None, bins=None, labels=None, **kwargs)[source]¶

Specify binning or bins to be used for column or values.

Attribute Generators¶

color(columns=None, palette=None, bin=False, **kwargs)[source]¶

Produces a ColorAttr specification for coloring groups of data based on columns.

Parameters:	columns (str or list(str), optional) – a column or list of columns for coloring palette (list(str), optional) – a list of colors to use for assigning to unique values in columns. **kwargs – any keyword, arg supported by AttrSpec
Returns:	a ColorAttr object

marker(columns=None, markers=None, **kwargs)[source]¶

Specifies detailed configuration for a marker attribute.

Parameters:	columns (list or str) – markers (list(str) or str) – a custom list of markers. Must exist within marker_types. **kwargs – any keyword, arg supported by AttrSpec
Returns:	a MarkerAttr object

cat(columns=None, cats=None, sort=True, ascending=True, **kwargs)[source]¶

Specifies detailed configuration for a chart attribute that uses categoricals.

Parameters:	columns (list or str) – the columns used to generate the categorical variable cats (list, optional) – overrides the values derived from columns sort (bool, optional) – whether to sort the categorical values (default=True) ascending (bool, optional) – whether to sort the categorical values (default=True) **kwargs – any keyword, arg supported by AttrSpec
Returns:	a CatAttr object

Core Classes¶

class Chart(*args, **kwargs)[source]¶

The main Chart class, the core of the Bokeh.charts interface.

__init__(*args, **kwargs)[source]¶

xlabel¶

property type: String

A label for the x-axis. (default: None)

xscale¶

property type: Either ( Auto , Enum ( Enumeration(linear, categorical, datetime) ) )

What kind of scale to use for the x-axis.

ylabel¶

property type: String

A label for the y-axis. (default: None)

yscale¶

property type: Either ( Auto , Enum ( Enumeration(linear, categorical, datetime) ) )

What kind of scale to use for the y-axis.

add_builder(builder)[source]¶

add_labels(dim, label)[source]¶

add_legend(chart_legends)[source]¶

Add the legend to your plot, and the plot to a new Document.

It also add the Document to a new Session in the case of server output.

Parameters:	legends (List(Tuple(String, List(GlyphRenderer)) – A list of tuples that maps text labels to the legend to corresponding renderers that should draw sample representations for those labels.

add_ranges(dim, range)[source]¶

add_renderers(builder, renderers)[source]¶

add_scales(dim, scale)[source]¶

add_tooltips(tooltips)[source]¶

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 (DataSpecPropertyDescriptor) – The x-coordinates of the center of the annular wedges. (default None) y (DataSpecPropertyDescriptor) – The y-coordinates of the center of the annular wedges. (default None) inner_radius (UnitsSpecPropertyDescriptor) – The inner radii of the annular wedges. (default None) outer_radius (UnitsSpecPropertyDescriptor) – The outer radii of the annular wedges. (default None) start_angle (UnitsSpecPropertyDescriptor) – The angles to start the annular wedges, as measured from the horizontal. (default None) end_angle (UnitsSpecPropertyDescriptor) – The angles to end the annular wedges, as measured from the horizontal. (default None) direction (BasicPropertyDescriptor) – Which direction to stroke between the start and end angles. (default ‘anticlock’)
Keyword Arguments:
	end_angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the annular wedges. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the annular wedges. (default ‘gray’) inner_radius_units (Enum('screen', 'data')) – (default ‘data’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the annular wedges. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the annular wedges. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the annular wedges. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the annular wedges. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the annular wedges. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the annular wedges. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the annular wedges. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) outer_radius_units (Enum('screen', 'data')) – (default ‘data’) start_angle_units (Enum('deg', 'rad')) – (default ‘rad’) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

annulus(x, y, inner_radius, outer_radius, **kwargs)¶

Configure and add annulus glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-coordinates of the center of the annuli. (default None) y (DataSpecPropertyDescriptor) – The y-coordinates of the center of the annuli. (default None) inner_radius (UnitsSpecPropertyDescriptor) – The inner radii of the annuli. (default None) outer_radius (UnitsSpecPropertyDescriptor) – The outer radii of the annuli. (default None)
Keyword Arguments:
	fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the annuli. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the annuli. (default ‘gray’) inner_radius_units (Enum('screen', 'data')) – (default ‘data’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the annuli. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the annuli. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the annuli. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the annuli. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the annuli. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the annuli. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the annuli. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) outer_radius_units (Enum('screen', 'data')) – (default ‘data’) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

arc(x, y, radius, start_angle, end_angle, direction='anticlock', **kwargs)¶

Configure and add arc glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-coordinates of the center of the arcs. (default None) y (DataSpecPropertyDescriptor) – The y-coordinates of the center of the arcs. (default None) radius (UnitsSpecPropertyDescriptor) – Radius of the arc. (default None) start_angle (UnitsSpecPropertyDescriptor) – The angles to start the arcs, as measured from the horizontal. (default None) end_angle (UnitsSpecPropertyDescriptor) – The angles to end the arcs, as measured from the horizontal. (default None) direction (BasicPropertyDescriptor) – Which direction to stroke between the start and end angles. (default ‘anticlock’)
Keyword Arguments:
	end_angle_units (Enum('deg', 'rad')) – (default ‘rad’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the arcs. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the arcs. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the arcs. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the arcs. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the arcs. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the arcs. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the arcs. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) radius_units (Enum('screen', 'data')) – (default ‘data’) start_angle_units (Enum('deg', 'rad')) – (default ‘rad’) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

asterisk(x, y, size=4, angle=0.0, **kwargs)¶

Configure and add asterisk glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-axis coordinates for the center of the markers. (default None) y (DataSpecPropertyDescriptor) – The y-axis coordinates for the center of the markers. (default None) size (DataSpecPropertyDescriptor) – The size (diameter) values for the markers in screen space units. (default 4) angle (UnitsSpecPropertyDescriptor) – The angles to rotate the markers. (default 0.0)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the markers. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the markers. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the markers. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the markers. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the markers. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the markers. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the markers. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the markers. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the markers. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

bezier(x0, y0, x1, y1, cx0, cy0, cx1, cy1, **kwargs)¶

Configure and add bezier glyphs to this Figure.

Parameters:	x0 (DataSpecPropertyDescriptor) – The x-coordinates of the starting points. (default None) y0 (DataSpecPropertyDescriptor) – The y-coordinates of the starting points. (default None) x1 (DataSpecPropertyDescriptor) – The x-coordinates of the ending points. (default None) y1 (DataSpecPropertyDescriptor) – The y-coordinates of the ending points. (default None) cx0 (DataSpecPropertyDescriptor) – The x-coordinates of first control points. (default None) cy0 (DataSpecPropertyDescriptor) – The y-coordinates of first control points. (default None) cx1 (DataSpecPropertyDescriptor) – The x-coordinates of second control points. (default None) cy1 (DataSpecPropertyDescriptor) – The y-coordinates of second control points. (default None)
Keyword Arguments:
	js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the Bézier curves. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the Bézier curves. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the Bézier curves. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the Bézier curves. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the Bézier curves. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the Bézier curves. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the Bézier curves. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

circle(x, y, **kwargs)¶

Configure and add circle glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-axis coordinates for the center of the markers. (default None) y (DataSpecPropertyDescriptor) – The y-axis coordinates for the center of the markers. (default None)
Keyword Arguments:
	angle (UnitsSpecPropertyDescriptor) – The angles to rotate the markers. (default 0.0) angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the markers. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the markers. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the markers. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the markers. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the markers. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the markers. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the markers. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the markers. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the markers. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) radius (UnitsSpecPropertyDescriptor) – The radius values for circle markers (in “data space” units, by default). (default None) radius_dimension (BasicPropertyDescriptor) – What dimension to measure circle radii along. (default ‘x’) radius_units (Enum('screen', 'data')) – (default ‘data’) size (DataSpecPropertyDescriptor) – The size (diameter) values for the markers in screen space units. (default 4) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

circle_cross(x, y, size=4, angle=0.0, **kwargs)¶

Configure and add circlecross glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-axis coordinates for the center of the markers. (default None) y (DataSpecPropertyDescriptor) – The y-axis coordinates for the center of the markers. (default None) size (DataSpecPropertyDescriptor) – The size (diameter) values for the markers in screen space units. (default 4) angle (UnitsSpecPropertyDescriptor) – The angles to rotate the markers. (default 0.0)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the markers. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the markers. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the markers. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the markers. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the markers. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the markers. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the markers. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the markers. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the markers. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

circle_x(x, y, size=4, angle=0.0, **kwargs)¶

Configure and add circlex glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-axis coordinates for the center of the markers. (default None) y (DataSpecPropertyDescriptor) – The y-axis coordinates for the center of the markers. (default None) size (DataSpecPropertyDescriptor) – The size (diameter) values for the markers in screen space units. (default 4) angle (UnitsSpecPropertyDescriptor) – The angles to rotate the markers. (default 0.0)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the markers. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the markers. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the markers. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the markers. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the markers. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the markers. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the markers. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the markers. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the markers. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

create_axes()[source]¶

create_grids(xgrid=True, ygrid=True)[source]¶

create_tools(tools, active_drag, active_scroll, active_tap)[source]¶

Create tools if given tools=True input.

Only adds tools if given boolean and does not already have tools added to self.

cross(x, y, size=4, angle=0.0, **kwargs)¶

Configure and add cross glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-axis coordinates for the center of the markers. (default None) y (DataSpecPropertyDescriptor) – The y-axis coordinates for the center of the markers. (default None) size (DataSpecPropertyDescriptor) – The size (diameter) values for the markers in screen space units. (default 4) angle (UnitsSpecPropertyDescriptor) – The angles to rotate the markers. (default 0.0)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the markers. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the markers. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the markers. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the markers. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the markers. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the markers. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the markers. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the markers. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the markers. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

diamond(x, y, size=4, angle=0.0, **kwargs)¶

Configure and add diamond glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-axis coordinates for the center of the markers. (default None) y (DataSpecPropertyDescriptor) – The y-axis coordinates for the center of the markers. (default None) size (DataSpecPropertyDescriptor) – The size (diameter) values for the markers in screen space units. (default 4) angle (UnitsSpecPropertyDescriptor) – The angles to rotate the markers. (default 0.0)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the markers. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the markers. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the markers. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the markers. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the markers. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the markers. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the markers. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the markers. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the markers. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

diamond_cross(x, y, size=4, angle=0.0, **kwargs)¶

Configure and add diamondcross glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-axis coordinates for the center of the markers. (default None) y (DataSpecPropertyDescriptor) – The y-axis coordinates for the center of the markers. (default None) size (DataSpecPropertyDescriptor) – The size (diameter) values for the markers in screen space units. (default 4) angle (UnitsSpecPropertyDescriptor) – The angles to rotate the markers. (default 0.0)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the markers. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the markers. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the markers. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the markers. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the markers. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the markers. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the markers. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the markers. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the markers. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

ellipse(x, y, width, height, angle=0.0, **kwargs)¶

Configure and add ellipse glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-coordinates of the centers of the ellipses. (default None) y (DataSpecPropertyDescriptor) – The y-coordinates of the centers of the ellipses. (default None) width (UnitsSpecPropertyDescriptor) – The widths of each ellipse. (default None) height (UnitsSpecPropertyDescriptor) – The heights of each ellipse. (default None) angle (UnitsSpecPropertyDescriptor) – The angle the ellipses are rotated from horizontal. [rad] (default 0.0)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the ovals. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the ovals. (default ‘gray’) height_units (Enum('screen', 'data')) – (default ‘data’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the ovals. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the ovals. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the ovals. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the ovals. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the ovals. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the ovals. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the ovals. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (default []) width_units (Enum('screen', 'data')) – (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

hbar(y, height, right, left=0, **kwargs)¶

Configure and add hbar glyphs to this Figure.

Parameters:	y (DataSpecPropertyDescriptor) – The y-coordinates of the centers of the horizontal bars. (default None) height (DataSpecPropertyDescriptor) – The heights of the vertical bars. (default None) right (DataSpecPropertyDescriptor) – The x-coordinates of the right edges. (default None) left (DataSpecPropertyDescriptor) – The x-coordinates of the left edges. (default 0)
Keyword Arguments:
	fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the horizontal bars. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the horizontal bars. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the horizontal bars. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the horizontal bars. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the horizontal bars. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the horizontal bars. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the horizontal bars. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the horizontal bars. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the horizontal bars. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

image(image, x, y, dw, dh, dilate=False, **kwargs)¶

Configure and add image glyphs to this Figure.

Parameters:	image (DataSpecPropertyDescriptor) – The arrays of scalar data for the images to be colormapped. (default None) x (DataSpecPropertyDescriptor) – The x-coordinates to locate the image anchors. (default None) y (DataSpecPropertyDescriptor) – The y-coordinates to locate the image anchors. (default None) dw (UnitsSpecPropertyDescriptor) – The widths of the plot regions that the images will occupy. (default None) dh (UnitsSpecPropertyDescriptor) – The height of the plot region that the image will occupy. (default None) dilate (BasicPropertyDescriptor) – Whether to always round fractional pixel locations in such a way as to make the images bigger. (default False)
Keyword Arguments:
	color_mapper (BasicPropertyDescriptor) – A ColorMapper to use to map the scalar data from image into RGBA values for display. (default None) dh_units (Enum('screen', 'data')) – (default ‘data’) dw_units (Enum('screen', 'data')) – (default ‘data’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) palette (str or list[color value]) – a palette to construct a value for the color mapper property from subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

image_rgba(image, x, y, dw, dh, dilate=False, **kwargs)¶

Configure and add imagergba glyphs to this Figure.

Parameters:	image (DataSpecPropertyDescriptor) – The arrays of RGBA data for the images. (default None) x (DataSpecPropertyDescriptor) – The x-coordinates to locate the image anchors. (default None) y (DataSpecPropertyDescriptor) – The y-coordinates to locate the image anchors. (default None) dw (UnitsSpecPropertyDescriptor) – The widths of the plot regions that the images will occupy. (default None) dh (UnitsSpecPropertyDescriptor) – The height of the plot region that the image will occupy. (default None) dilate (BasicPropertyDescriptor) – Whether to always round fractional pixel locations in such a way as to make the images bigger. (default False)
Keyword Arguments:
	cols (DataSpecPropertyDescriptor) – The numbers of columns in the images (default None) dh_units (Enum('screen', 'data')) – (default ‘data’) dw_units (Enum('screen', 'data')) – (default ‘data’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) rows (DataSpecPropertyDescriptor) – The numbers of rows in the images (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

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 (DataSpecPropertyDescriptor) – The URLs to retrieve images from. (default None) x (DataSpecPropertyDescriptor) – The x-coordinates to locate the image anchors. (default None) y (DataSpecPropertyDescriptor) – The y-coordinates to locate the image anchors. (default None) w (UnitsSpecPropertyDescriptor) – The widths of the plot regions that the images will occupy. (default None) h (UnitsSpecPropertyDescriptor) – The height of the plot region that the image will occupy. (default None) angle (UnitsSpecPropertyDescriptor) – The angles to rotate the images, as measured from the horizontal. (default 0) global_alpha (BasicPropertyDescriptor) – An overall opacity that each image is rendered with (in addition to any inherent alpha values in the image itself). (default 1.0) dilate (BasicPropertyDescriptor) – Whether to always round fractional pixel locations in such a way as to make the images bigger. (default False)
Keyword Arguments:
	anchor (BasicPropertyDescriptor) – What position of the image should be anchored at the x, y coordinates. (default ‘top_left’) angle_units (Enum('deg', 'rad')) – (default ‘rad’) h_units (Enum('screen', 'data')) – (default ‘data’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) retry_attempts (BasicPropertyDescriptor) – Number of attempts to retry loading the images from the specified URL. Default is zero. (default 0) retry_timeout (BasicPropertyDescriptor) – Timeout (in ms) between retry attempts to load the image from the specified URL. Default is zero ms. (default 0) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (default []) w_units (Enum('screen', 'data')) – (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

inverted_triangle(x, y, size=4, angle=0.0, **kwargs)¶

Configure and add invertedtriangle glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-axis coordinates for the center of the markers. (default None) y (DataSpecPropertyDescriptor) – The y-axis coordinates for the center of the markers. (default None) size (DataSpecPropertyDescriptor) – The size (diameter) values for the markers in screen space units. (default 4) angle (UnitsSpecPropertyDescriptor) – The angles to rotate the markers. (default 0.0)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the markers. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the markers. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the markers. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the markers. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the markers. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the markers. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the markers. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the markers. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the markers. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

line(x, y, **kwargs)¶

Configure and add line glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-coordinates for the points of the line. (default None) y (DataSpecPropertyDescriptor) – The y-coordinates for the points of the line. (default None)
Keyword Arguments:
	js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the line. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the line. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the line. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the line. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the line. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the line. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the line. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

make_axis(dim, location, scale, label)[source]¶

Create linear, date or categorical axis depending on the location, scale and with the proper labels.

Parameters:	location (str) – the space localization of the axis. It can be left, right, above or below. scale (str) – the scale on the axis. It can be linear, datetime or categorical. label (str) – the label on the axis.
Returns:	Axis instance
Return type:	Axis

make_grid(dimension, ticker)[source]¶

Create the grid just passing the axis and dimension.

Parameters:	dimension (int) – the dimension of the axis, ie. xaxis=0, yaxis=1. ticker (obj) – the axis.ticker object
Returns:	A Grid instance
Return type:	Grid

multi_line(xs, ys, **kwargs)¶

Configure and add multiline glyphs to this Figure.

Parameters:	xs (DataSpecPropertyDescriptor) – The x-coordinates for all the lines, given as a “list of lists”. (default None) ys (DataSpecPropertyDescriptor) – The y-coordinates for all the lines, given as a “list of lists”. (default None)
Keyword Arguments:
	js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the lines. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the lines. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the lines. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the lines. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the lines. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the lines. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the lines. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

oval(x, y, width, height, angle=0.0, **kwargs)¶

Configure and add oval glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-coordinates of the centers of the ovals. (default None) y (DataSpecPropertyDescriptor) – The y-coordinates of the centers of the ovals. (default None) width (UnitsSpecPropertyDescriptor) – The overall widths of each oval. (default None) height (UnitsSpecPropertyDescriptor) – The overall height of each oval. (default None) angle (UnitsSpecPropertyDescriptor) – The angle the ovals are rotated from horizontal. [rad] (default 0.0)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the ovals. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the ovals. (default ‘gray’) height_units (Enum('screen', 'data')) – (default ‘data’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the ovals. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the ovals. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the ovals. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the ovals. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the ovals. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the ovals. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the ovals. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (default []) width_units (Enum('screen', 'data')) – (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

patch(x, y, **kwargs)¶

Configure and add patch glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-coordinates for the points of the patch. (default None) y (DataSpecPropertyDescriptor) – The y-coordinates for the points of the patch. (default None)
Keyword Arguments:
	fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the patch. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the patch. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the patch. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the patch. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the patch. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the patch. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the patch. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the patch. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the patch. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

patches(xs, ys, **kwargs)¶

Configure and add patches glyphs to this Figure.

Parameters:	xs (DataSpecPropertyDescriptor) – The x-coordinates for all the patches, given as a “list of lists”. (default None) ys (DataSpecPropertyDescriptor) – The y-coordinates for all the patches, given as a “list of lists”. (default None)
Keyword Arguments:
	fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the patches. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the patches. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the patches. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the patches. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the patches. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the patches. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the patches. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the patches. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the patches. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

quad(left, right, top, bottom, **kwargs)¶

Configure and add quad glyphs to this Figure.

Parameters:	left (DataSpecPropertyDescriptor) – The x-coordinates of the left edges. (default None) right (DataSpecPropertyDescriptor) – The x-coordinates of the right edges. (default None) top (DataSpecPropertyDescriptor) – The y-coordinates of the top edges. (default None) bottom (DataSpecPropertyDescriptor) – The y-coordinates of the bottom edges. (default None)
Keyword Arguments:
	fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the quads. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the quads. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the quads. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the quads. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the quads. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the quads. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the quads. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the quads. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the quads. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

quadratic(x0, y0, x1, y1, cx, cy, **kwargs)¶

Configure and add quadratic glyphs to this Figure.

Parameters:	x0 (DataSpecPropertyDescriptor) – The x-coordinates of the starting points. (default None) y0 (DataSpecPropertyDescriptor) – The y-coordinates of the starting points. (default None) x1 (DataSpecPropertyDescriptor) – The x-coordinates of the ending points. (default None) y1 (DataSpecPropertyDescriptor) – The y-coordinates of the ending points. (default None) cx (DataSpecPropertyDescriptor) – The x-coordinates of the control points. (default None) cy (DataSpecPropertyDescriptor) – The y-coordinates of the control points. (default None)
Keyword Arguments:
	js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the parabolas. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the parabolas. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the parabolas. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the parabolas. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the parabolas. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the parabolas. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the parabolas. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

ray(x, y, length, angle, **kwargs)¶

Configure and add ray glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-coordinates to start the rays. (default None) y (DataSpecPropertyDescriptor) – The y-coordinates to start the rays. (default None) length (UnitsSpecPropertyDescriptor) – The length to extend the ray. Note that this length defaults to screen units. (default None) angle (UnitsSpecPropertyDescriptor) – The angles in radians to extend the rays, as measured from the horizontal. (default None)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) length_units (Enum('screen', 'data')) – (default ‘data’) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the rays. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the rays. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the rays. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the rays. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the rays. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the rays. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the rays. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

rect(x, y, width, height, angle=0.0, dilate=False, **kwargs)¶

Configure and add rect glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-coordinates of the centers of the rectangles. (default None) y (DataSpecPropertyDescriptor) – The y-coordinates of the centers of the rectangles. (default None) width (UnitsSpecPropertyDescriptor) – The overall widths of the rectangles. (default None) height (UnitsSpecPropertyDescriptor) – The overall heights of the rectangles. (default None) angle (UnitsSpecPropertyDescriptor) – The angles to rotate the rectangles, as measured from the horizontal. (default 0.0) dilate (BasicPropertyDescriptor) – Whether to always round fractional pixel locations in such a way as to make the rectangles bigger. (default False)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the rectangles. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the rectangles. (default ‘gray’) height_units (Enum('screen', 'data')) – (default ‘data’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the rectangles. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the rectangles. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the rectangles. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the rectangles. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the rectangles. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the rectangles. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the rectangles. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (default []) width_units (Enum('screen', 'data')) – (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

segment(x0, y0, x1, y1, **kwargs)¶

Configure and add segment glyphs to this Figure.

Parameters:	x0 (DataSpecPropertyDescriptor) – The x-coordinates of the starting points. (default None) y0 (DataSpecPropertyDescriptor) – The y-coordinates of the starting points. (default None) x1 (DataSpecPropertyDescriptor) – The x-coordinates of the ending points. (default None) y1 (DataSpecPropertyDescriptor) – The y-coordinates of the ending points. (default None)
Keyword Arguments:
	js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the segments. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the segments. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the segments. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the segments. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the segments. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the segments. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the segments. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

square(x, y, size=4, angle=0.0, **kwargs)¶

Configure and add square glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-axis coordinates for the center of the markers. (default None) y (DataSpecPropertyDescriptor) – The y-axis coordinates for the center of the markers. (default None) size (DataSpecPropertyDescriptor) – The size (diameter) values for the markers in screen space units. (default 4) angle (UnitsSpecPropertyDescriptor) – The angles to rotate the markers. (default 0.0)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the markers. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the markers. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the markers. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the markers. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the markers. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the markers. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the markers. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the markers. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the markers. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

square_cross(x, y, size=4, angle=0.0, **kwargs)¶

Configure and add squarecross glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-axis coordinates for the center of the markers. (default None) y (DataSpecPropertyDescriptor) – The y-axis coordinates for the center of the markers. (default None) size (DataSpecPropertyDescriptor) – The size (diameter) values for the markers in screen space units. (default 4) angle (UnitsSpecPropertyDescriptor) – The angles to rotate the markers. (default 0.0)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the markers. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the markers. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the markers. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the markers. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the markers. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the markers. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the markers. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the markers. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the markers. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

square_x(x, y, size=4, angle=0.0, **kwargs)¶

Configure and add squarex glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-axis coordinates for the center of the markers. (default None) y (DataSpecPropertyDescriptor) – The y-axis coordinates for the center of the markers. (default None) size (DataSpecPropertyDescriptor) – The size (diameter) values for the markers in screen space units. (default 4) angle (UnitsSpecPropertyDescriptor) – The angles to rotate the markers. (default 0.0)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the markers. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the markers. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the markers. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the markers. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the markers. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the markers. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the markers. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the markers. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the markers. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

start_plot()[source]¶

Add the axis, grids and tools

text(x, y, text='text', angle=0, x_offset=0, y_offset=0, **kwargs)¶

Configure and add text glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-coordinates to locate the text anchors. (default None) y (DataSpecPropertyDescriptor) – The y-coordinates to locate the text anchors. (default None) text (DataSpecPropertyDescriptor) – The text values to render. (default ‘text’) angle (UnitsSpecPropertyDescriptor) – The angles to rotate the text, as measured from the horizontal. (default 0) x_offset (DataSpecPropertyDescriptor) – Offset values to apply to the x-coordinates. (default 0) y_offset (DataSpecPropertyDescriptor) – Offset values to apply to the y-coordinates. (default 0)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (default []) text_align (BasicPropertyDescriptor) – The text align values for the text. (default ‘left’) text_alpha (DataSpecPropertyDescriptor) – The text alpha values for the text. (default 1.0) text_baseline (BasicPropertyDescriptor) – The text baseline values for the text. (default ‘bottom’) text_color (DataSpecPropertyDescriptor) – The text color values for the text. (default ‘#444444’) text_font (BasicPropertyDescriptor) – The text font values for the text. (default ‘helvetica’) text_font_size (DataSpecPropertyDescriptor) – The text font size values for the text. (default {‘value’: ‘12pt’}) text_font_style (BasicPropertyDescriptor) – The text font style values for the text. (default ‘normal’)
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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

triangle(x, y, size=4, angle=0.0, **kwargs)¶

Configure and add triangle glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-axis coordinates for the center of the markers. (default None) y (DataSpecPropertyDescriptor) – The y-axis coordinates for the center of the markers. (default None) size (DataSpecPropertyDescriptor) – The size (diameter) values for the markers in screen space units. (default 4) angle (UnitsSpecPropertyDescriptor) – The angles to rotate the markers. (default 0.0)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the markers. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the markers. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the markers. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the markers. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the markers. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the markers. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the markers. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the markers. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the markers. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

vbar(x, width, top, bottom=0, **kwargs)¶

Configure and add vbar glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-coordinates of the centers of the vertical bars. (default None) width (DataSpecPropertyDescriptor) – The widths of the vertical bars. (default None) top (DataSpecPropertyDescriptor) – The y-coordinates of the top edges. (default None) bottom (DataSpecPropertyDescriptor) – The y-coordinates of the bottom edges. (default 0)
Keyword Arguments:
	fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the vertical bars. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the vertical bars. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the vertical bars. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the vertical bars. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the vertical bars. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the vertical bars. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the vertical bars. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the vertical bars. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the vertical bars. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

wedge(x, y, radius, start_angle, end_angle, direction='anticlock', **kwargs)¶

Configure and add wedge glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-coordinates of the points of the wedges. (default None) y (DataSpecPropertyDescriptor) – The y-coordinates of the points of the wedges. (default None) radius (UnitsSpecPropertyDescriptor) – Radii of the wedges. (default None) start_angle (UnitsSpecPropertyDescriptor) – The angles to start the wedges, as measured from the horizontal. (default None) end_angle (UnitsSpecPropertyDescriptor) – The angles to end the wedges, as measured from the horizontal. (default None) direction (BasicPropertyDescriptor) – Which direction to stroke between the start and end angles. (default ‘anticlock’)
Keyword Arguments:
	end_angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the wedges. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the wedges. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the wedges. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the wedges. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the wedges. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the wedges. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the wedges. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the wedges. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the wedges. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) radius_units (Enum('screen', 'data')) – (default ‘data’) start_angle_units (Enum('deg', 'rad')) – (default ‘rad’) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

x(x, y, size=4, angle=0.0, **kwargs)¶

Configure and add x glyphs to this Figure.

Parameters:	x (DataSpecPropertyDescriptor) – The x-axis coordinates for the center of the markers. (default None) y (DataSpecPropertyDescriptor) – The y-axis coordinates for the center of the markers. (default None) size (DataSpecPropertyDescriptor) – The size (diameter) values for the markers in screen space units. (default 4) angle (UnitsSpecPropertyDescriptor) – The angles to rotate the markers. (default 0.0)
Keyword Arguments:
	angle_units (Enum('deg', 'rad')) – (default ‘rad’) fill_alpha (DataSpecPropertyDescriptor) – The fill alpha values for the markers. (default 1.0) fill_color (DataSpecPropertyDescriptor) – The fill color values for the markers. (default ‘gray’) js_event_callbacks (BasicPropertyDescriptor) – A mapping of event names to lists of CustomJS callbacks. (default {}) js_property_callbacks (BasicPropertyDescriptor) – A mapping of attribute names to lists of CustomJS callbacks, to be set up on BokehJS side when the document is created. (default {}) line_alpha (DataSpecPropertyDescriptor) – The line alpha values for the markers. (default 1.0) line_cap (BasicPropertyDescriptor) – The line cap values for the markers. (default ‘butt’) line_color (DataSpecPropertyDescriptor) – The line color values for the markers. (default ‘black’) line_dash (BasicPropertyDescriptor) – The line dash values for the markers. (default []) line_dash_offset (BasicPropertyDescriptor) – The line dash offset values for the markers. (default 0) line_join (BasicPropertyDescriptor) – The line join values for the markers. (default ‘miter’) line_width (DataSpecPropertyDescriptor) – The line width values for the markers. (default 1) name (BasicPropertyDescriptor) – An arbitrary, user-supplied name for this model. (default None) subscribed_events (BasicPropertyDescriptor) – List of events that are subscribed to by Python callbacks. This is the set of events that will be communicated from BokehJS back to Python for this model. (default []) tags (BasicPropertyDescriptor) – An optional list of arbitrary, user-supplied values to attach to this model. (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, pass nonselection_alpha or nonselection_fill_alpha.

Returns:	GlyphRenderer

legend¶

Splattable list of Legend objects.

xgrid¶

Splattable list of Grid objects for the x dimension.

ygrid¶

Splattable list of Grid objects for the y dimension.