bokeh.models.mappers¶

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

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.

high¶

property type: high:Float

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

low¶

property type: low:Float

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

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.

{
  "high": null,
  "id": "07d1464d-0875-44d8-a98a-4396ba1aafea",
  "low": null,
  "name": null,
  "nan_color": "gray",
  "palette": null,
  "tags": []
}

class LinearColorMapper(palette=None, **kwargs)¶

Bases: bokeh.models.mappers.ColorMapper

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

{
  "high": null,
  "id": "d087b2b9-91f3-4abf-89dd-cd7a888f9fc2",
  "low": null,
  "name": null,
  "nan_color": "gray",
  "palette": null,
  "tags": []
}

class LogColorMapper(palette=None, **kwargs)¶

Bases: bokeh.models.mappers.ColorMapper

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.

{
  "high": null,
  "id": "f04c836a-e3cc-4367-948b-0a957b001eca",
  "low": null,
  "name": null,
  "nan_color": "gray",
  "palette": null,
  "tags": []
}