bokeh.models.sources

class AjaxDataSource(*args, **kw)

Bases: bokeh.models.sources.RemoteSource

if_modified

property type: if_modified:Bool

Whether to include an If-Modified-Since header in AJAX requests to the server. If this header is supported by the server, then only new data since the last request will be returned.

max_size

property type: max_size:Int

Maximum size of the data array being kept after each pull requests. Larger than that size, the data will be right shifted.

method

property type: method:Enum(‘POST’, ‘GET’)

http method - GET or POST

mode

property type: mode:Enum(‘replace’, ‘append’)

Whether to append new data to existing data (up to max_size), or to replace existing data entirely.

JSON Prototype
{
  "callback": null,
  "column_names": [],
  "data": {},
  "data_url": null,
  "id": "78051816-6751-4e0d-a642-f91f407a2c8a",
  "if_modified": false,
  "max_size": null,
  "method": "POST",
  "mode": "replace",
  "name": null,
  "polling_interval": null,
  "selected": {
    "0d": {
      "glyph": null,
      "indices": []
    },
    "1d": {
      "indices": []
    },
    "2d": {
      "indices": []
    }
  },
  "tags": []
}
class BlazeDataSource(*args, **kw)

Bases: bokeh.models.sources.RemoteSource

from_blaze(remote_blaze_obj, local=True)
to_blaze()
expr

property type: expr:Dict(String, Any)

blaze expression graph in json form

local

property type: local:Bool

Whether this data source is hosted by the bokeh server or not.

namespace

property type: namespace:Dict(String, Any)

namespace in json form for evaluating blaze expression graph

JSON Prototype
{
  "callback": null,
  "column_names": [],
  "data": {},
  "data_url": null,
  "expr": {},
  "id": "780e50c6-5645-4073-aa67-9ee816ee1c8c",
  "local": null,
  "name": null,
  "namespace": {},
  "polling_interval": null,
  "selected": {
    "0d": {
      "glyph": null,
      "indices": []
    },
    "1d": {
      "indices": []
    },
    "2d": {
      "indices": []
    }
  },
  "tags": []
}
class ColumnDataSource(*args, **kw)

Bases: bokeh.models.sources.DataSource

Maps names of columns to sequences or arrays.

If the ColumnDataSource initializer is called with a single argument that is a dict or pandas.DataFrame, that argument is used as the value for the “data” attribute. For example:

ColumnDataSource(mydict) # same as ColumnDataSource(data=mydict)
ColumnDataSource(df) # same as ColumnDataSource(data=df)

Note

There is an implicit assumption that all the columns in a a given ColumnDataSource have the same length.

add(data, name=None)

Appends a new column of data to the data source.

Parameters:
  • data (seq) – new data to add
  • name (str, optional) – column name to use. If not supplied, generate a name go the form “Series ####”
Returns:

the column name used

Return type:

str

classmethod from_df(*args, **kwargs)

Create a dict of columns from a Pandas DataFrame, suitable for creating a ColumnDataSource.

Parameters:data (DataFrame) – data to convert
Returns:dict(str, list)

Deprecated in Bokeh 0.9.3; please use ColumnDataSource initializer instead.

push_notebook(*args, **kwargs)

Update a data source for a plot in a Jupyter notebook.

This function can be be used to update data in plot data sources in the Jupyter notebook, without having to use the Bokeh server.

Warning

This function has been deprecated. Please use bokeh.io.push_notebook() which will push all changes (not just data sources) to the last shown plot in a Jupyter notebook.

Returns:None

Deprecated in Bokeh 0.11.0; please use bokeh.io.push_notebook instead.

remove(name)

Remove a column of data.

Parameters:name (str) – name of the column to remove
Returns:None

Note

If the column name does not exist, a warning is issued.

to_df()

Convert this data source to pandas dataframe.

If column_names is set, use those. Otherwise let Pandas infer the column names. The column_names property can be used both to order and filter the columns.

Returns:DataFrame
column_names

property type: column_names:List(String)

An list of names for all the columns in this DataSource.

data

property type: data:Dict(String, Any)

Mapping of column names to sequences of data. The data can be, e.g, Python lists or tuples, NumPy arrays, etc.

JSON Prototype
{
  "callback": null,
  "column_names": [],
  "data": {},
  "id": "a94c51cc-170e-4ac7-8c7a-e64db728f104",
  "name": null,
  "selected": {
    "0d": {
      "glyph": null,
      "indices": []
    },
    "1d": {
      "indices": []
    },
    "2d": {
      "indices": []
    }
  },
  "tags": []
}
class DataSource(**kwargs)

Bases: bokeh.model.Model

A base class for data source types. DataSource is not generally useful to instantiate on its own.

callback

property type: callback:Instance(Callback)

A callback to run in the browser whenever the selection is changed.

selected

property type: selected:Dict(String, Dict(String, Any))

A dict to indicate selected indices on different dimensions on this DataSource. Keys are:

  • 0d: indicates whether a Line or Patch glyphs have been hit. Value is a

    dict with the following keys:

    • flag (boolean): true if glyph was with false otherwise
    • indices (list): indices hit (if applicable)
  • 1d: indicates whether any of all other glyph (except [multi]line or

    patches) was hit:

    • indices (list): indices that were hit/selected
  • 2d: indicates whether a [multi]line or patches) were hit:

    • indices (list(list)): indices of the lines/patches that were

      hit/selected

JSON Prototype
{
  "callback": null,
  "id": "868c76fe-1250-43d0-a2d1-b6c8e048b59c",
  "name": null,
  "selected": {
    "0d": {
      "glyph": null,
      "indices": []
    },
    "1d": {
      "indices": []
    },
    "2d": {
      "indices": []
    }
  },
  "tags": []
}
class GeoJSONDataSource(*args, **kw)

Bases: bokeh.models.sources.ColumnDataSource

geojson

property type: geojson:JSON

GeoJSON that contains features for plotting. Currently GeoJSONDataSource can only process a FeatureCollection or GeometryCollection.

JSON Prototype
{
  "callback": null,
  "column_names": [],
  "data": {},
  "geojson": null,
  "id": "7f97f79a-8a7c-432b-b437-9f04fdfc66b6",
  "name": null,
  "selected": {
    "0d": {
      "glyph": null,
      "indices": []
    },
    "1d": {
      "indices": []
    },
    "2d": {
      "indices": []
    }
  },
  "tags": []
}
class RemoteSource(*args, **kw)

Bases: bokeh.models.sources.ColumnDataSource

data_url

property type: data_url:String

The URL to the endpoint for the data.

polling_interval

property type: polling_interval:Int

polling interval for updating data source in milliseconds

JSON Prototype
{
  "callback": null,
  "column_names": [],
  "data": {},
  "data_url": null,
  "id": "7d17b1b6-d391-435c-9348-67b1afc39de5",
  "name": null,
  "polling_interval": null,
  "selected": {
    "0d": {
      "glyph": null,
      "indices": []
    },
    "1d": {
      "indices": []
    },
    "2d": {
      "indices": []
    }
  },
  "tags": []
}