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.

{
  "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

{
  "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.

{
  "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

{
  "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.

{
  "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

{
  "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": []
}