bokeh.models.mappers

Models for mapping values from one range or space to another.

class CategoricalColorMapper(**kwargs)

Bases: bokeh.models.mappers.ColorMapper

Map categories to colors. Values that are passed to this mapper that aren’t in factors will be assigned the nan_color.

factors

property type: factors:Either(Seq(String), Seq(Int), Seq(Float), Seq(Datetime), Seq(Date))

A sequence of factors / categories that map to the color palette.

JSON Prototype
{
  "factors": null,
  "id": "604a2411-f34a-47e6-8017-bfdc4003cd04",
  "name": null,
  "nan_color": "gray",
  "palette": null,
  "tags": []
}
class ColorMapper(palette=None, **kwargs)

Bases: bokeh.model.Model

Base class for color mapper types. ColorMapper is not generally useful to instantiate on its own.

nan_color

property type: nan_color:Color

Color to be used if data is NaN. Default: ‘gray’

palette

property type: palette:Seq(Color)

A sequence of colors to use as the target palette for mapping.

This property can also be set as a String, to the name of any of the palettes shown in bokeh.palettes.

JSON Prototype
{
  "id": "2360d308-fd3e-4b04-bbbb-07bd6dacb7c7",
  "name": null,
  "nan_color": "gray",
  "palette": null,
  "tags": []
}
class ContinuousColorMapper(palette=None, **kwargs)

Bases: bokeh.models.mappers.ColorMapper

Base class for cotinuous color mapper types. ContinuousColorMapper is not generally useful to instantiate on its own.

high

property type: high:Float

The maximum value of the range to map into the palette. Values above this are clamped to high.

high_color

property type: high_color:Color

Color to be used if data is lower than high value. If None, values lower than high are mapped to the last color in the palette.

low

property type: low:Float

The minimum value of the range to map into the palette. Values below this are clamped to low.

low_color

property type: low_color:Color

Color to be used if data is lower than low value. If None, values lower than low are mapped to the first color in the palette.

JSON Prototype
{
  "high": null,
  "high_color": null,
  "id": "a9772205-71a0-41cc-a0ff-ac7d48425a27",
  "low": null,
  "low_color": null,
  "name": null,
  "nan_color": "gray",
  "palette": null,
  "tags": []
}
class LinearColorMapper(palette=None, **kwargs)

Bases: bokeh.models.mappers.ContinuousColorMapper

Map numbers in a range [low, high] linearly into a sequence of colors (a palette).

For example, if the range is [0, 99] and the palette is ['red', 'green', 'blue'], the values would be mapped as follows:

      x < 0  : 'red'     # values < low are clamped
 0 >= x < 33 : 'red'
33 >= x < 66 : 'green'
66 >= x < 99 : 'blue'
99 >= x      : 'blue'    # values > high are clamped
JSON Prototype
{
  "high": null,
  "high_color": null,
  "id": "000ebf85-1d8f-4a89-b96a-cfbd4b27c78f",
  "low": null,
  "low_color": null,
  "name": null,
  "nan_color": "gray",
  "palette": null,
  "tags": []
}
class LogColorMapper(palette=None, **kwargs)

Bases: bokeh.models.mappers.ContinuousColorMapper

Map numbers in a range [low, high] into a sequence of colors (a palette) on a natural logarithm scale.

For example, if the range is [0, 25] and the palette is ['red', 'green', 'blue'], the values would be mapped as follows:

         x < 0     : 'red'     # values < low are clamped
0     >= x < 2.72  : 'red'     # math.e ** 1
2.72  >= x < 7.39  : 'green'   # math.e ** 2
7.39  >= x < 20.09 : 'blue'    # math.e ** 3
20.09 >= x         : 'blue'    # values > high are clamped

Warning

The LogColorMapper only works for images with scalar values that are non-negative.

JSON Prototype
{
  "high": null,
  "high_color": null,
  "id": "b560198f-4288-4c2d-8134-959fd0ef8065",
  "low": null,
  "low_color": null,
  "name": null,
  "nan_color": "gray",
  "palette": null,
  "tags": []
}