bokeh.palettes#

提供用于颜色映射的调色板集合。

在 Bokeh 的上下文中，palette 是 (hex) RGB 颜色字符串的简单纯 Python 列表。例如，Blues8 调色板如下所示定义为

('#084594', '#2171b5', '#4292c6', '#6baed6', '#9ecae1', '#c6dbef', '#deebf7', '#f7fbff')

此模块包含以下调色板集

所有 ColorBrewer 调色板
类别 D3 调色板
Matplotlib 调色板 Magma、Inferno、Plasma 和 Viridis
由 Bokeh 快门标志颜色组成的 Bokeh 调色板
为色弱用户设计的调色板

此外，如果安装了外部 colorcet 包，您还可以使用其中任何 256 色的感知均匀 Bokeh 调色板。

每个预构建的调色板都作为模块属性提供，例如 bokeh.palettes.YlGn3 或 bokeh.palettes.Viridis256。每个预构建调色板的名称可以在 __palettes__ 模块属性中找到。

还有诸如 magma() 和 viridis() 之类的函数，可以从特殊的较大调色板生成任意大小的颜色列表。

Brewer 调色板也收集起来，并按名称分组在一个 brewer 字典中，例如：brewer['Spectral'][6]。类似地，还有属性 d3, mpl, 和 tol，它们具有与这些调色板组对应的字典。

最后，所有调色板都收集在 all_palettes 调色板模块属性中，“small”调色板（即排除 256 色的调色板）收集在 small_palettes 属性中。

内置调色板#

Matplotlib 调色板#

Bokeh 包括 Matplotlib 调色板 Magma、Inferno、Plasma、Viridis 和 Cividis。本节展示了此组中预定义的小调色板。这些调色板还有大型 256 色版本，如下面的大型调色板部分所示。

Cividis
3
4
5
6
7
8
9
10
11

Inferno
3
4
5
6
7
8
9
10
11

Magma
3
4
5
6
7
8
9
10
11

Plasma
3
4
5
6
7
8
9
10
11

Viridis
3
4
5
6
7
8
9
10
11

D3 调色板#

Bokeh 包括来自 D3 的类别调色板，如下所示

Category10
3
4
5
6
7
8
9
10

Category20
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

Category20b
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

Category20c
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

Brewer 调色板#

Bokeh 包括所有 ColorBrewer 调色板，如下所示

Accent
3
4
5
6
7
8

Blues
3
4
5
6
7
8
9

BrBG
3
4
5
6
7
8
9
10
11

BuGn
3
4
5
6
7
8
9

BuPu
3
4
5
6
7
8
9

Dark2
3
4
5
6
7
8

GnBu
3
4
5
6
7
8
9

Greens
3
4
5
6
7
8
9

Greys
3
4
5
6
7
8
9

OrRd
3
4
5
6
7
8
9

Oranges
3
4
5
6
7
8
9

PRGn
3
4
5
6
7
8
9
10
11

Paired
3
4
5
6
7
8
9
10
11
12

Pastel1
3
4
5
6
7
8
9

Pastel2
3
4
5
6
7
8

PiYG
3
4
5
6
7
8
9
10
11

PuBu
3
4
5
6
7
8
9

PuBuGn
3
4
5
6
7
8
9

PuOr
3
4
5
6
7
8
9
10
11

PuRd
3
4
5
6
7
8
9

Purples
3
4
5
6
7
8
9

RdBu
3
4
5
6
7
8
9
10
11

RdGy
3
4
5
6
7
8
9
10
11

RdPu
3
4
5
6
7
8
9

RdYlBu
3
4
5
6
7
8
9
10
11

RdYlGn
3
4
5
6
7
8
9
10
11

Reds
3
4
5
6
7
8
9

Set1
3
4
5
6
7
8
9

Set2
3
4
5
6
7
8

Set3
3
4
5
6
7
8
9
10
11
12

Spectral
3
4
5
6
7
8
9
10
11

YlGn
3
4
5
6
7
8
9

YlGnBu
3
4
5
6
7
8
9

YlOrBr
3
4
5
6
7
8
9

YlOrRd
3
4
5
6
7
8
9

Bokeh 调色板#

Bokeh 自己的调色板，由快门标志颜色组成

Bokeh
3
4
5
6
7
8

易访问调色板#

Bokeh 包含一些有助于解决色弱问题的调色板，其中包括 Paul Tol 的配色方案，以及来自 https://jfly.uni-koeln.de/color/#pallet 的 Colorblind。

Bright
3
4
5
6
7

BuRd
3
4
5
6
7
8
9

HighContrast
3

Iridescent
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

Light
3
4
5
6
7
8
9

MediumContrast
3
4
5
6

Muted
3
4
5
6
7
8
9

Sunset
3
4
5
6
7
8
9
10
11

TolPRGn
3
4
5
6
7
8
9

TolRainbow
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

TolYlOrBr
3
4
5
6
7
8
9

Vibrant
3
4
5
6
7

Colorblind
3
4
5
6
7
8

以下调色板也在 Paul Tol 的配色方案中介绍，但用法不同。PaleTextBackground 应该用于黑色文本的背景。DarkText 旨在用于白色背景上的文本本身。这个想法是使用一种深色来支持，而不是全部组合，也不是仅仅用于一个词。

PaleTextBackground:
DarkText:

大型调色板#

除了上面显示的所有在 small_palettes 属性中可用的调色板外，bokeh.palettes 模块还有一些更大的调色板，包含 256 种颜色。这些调色板如下所示

Greys256:: (brewer)
Inferno256:: (mpl)
Magma256:: (mpl)
Plasma256:: (mpl)
Viridis256:: (mpl)
Cividis256:: (mpl)
Turbo256:: (mpl)

许多其他 256 色的感知均匀调色板在外部 colorcet 包中可用。

其他属性#

除了上面章节中描述的所有调色板外，bokeh.palettes 模块中还有以下值得注意的属性

__palettes__#

此模块中所有单个调色板名称的字母列表。

例如，前八个调色板名称是

>>> bp.__palettes__[:8]
('Accent3', 'Accent4', 'Accent5', 'Accent6', 'Accent7', 'Accent8', 'Blues3', 'Blues4')

注意

所有调色板的完整列表也可以从 bokeh.core.enums 的枚举中获得

Palette = Enumeration(Accent3, Accent4, Accent5, A .... Rd5, YlOrRd6, YlOrRd7, YlOrRd8, YlOrRd9)

查看所有值

Enumeration(Accent3, Accent4, Accent5, Accent6, Accent7, Accent8,

    Blues3, Blues4, Blues5, Blues6, Blues7, Blues8, Blues9, Blues256,

    Bokeh3, Bokeh4, Bokeh5, Bokeh6, Bokeh7, Bokeh8, BrBG3, BrBG4,

    BrBG5, BrBG6, BrBG7, BrBG8, BrBG9, BrBG10, BrBG11, Bright3,

    Bright4, Bright5, Bright6, Bright7, BuGn3, BuGn4, BuGn5, BuGn6,

    BuGn7, BuGn8, BuGn9, BuPu3, BuPu4, BuPu5, BuPu6, BuPu7, BuPu8,

    BuPu9, BuRd3, BuRd4, BuRd5, BuRd6, BuRd7, BuRd8, BuRd9,

    Category10_3, Category10_4, Category10_5, Category10_6,

    Category10_7, Category10_8, Category10_9, Category10_10,

    Category20_3, Category20_4, Category20_5, Category20_6,

    Category20_7, Category20_8, Category20_9, Category20_10,

    Category20_11, Category20_12, Category20_13, Category20_14,

    Category20_15, Category20_16, Category20_17, Category20_18,

    Category20_19, Category20_20, Category20b3, Category20b4,

    Category20b5, Category20b6, Category20b7, Category20b8,

    Category20b9, Category20b10, Category20b11, Category20b12,

    Category20b13, Category20b14, Category20b15, Category20b16,

    Category20b17, Category20b18, Category20b19, Category20b20,

    Category20c3, Category20c4, Category20c5, Category20c6,

    Category20c7, Category20c8, Category20c9, Category20c10,

    Category20c11, Category20c12, Category20c13, Category20c14,

    Category20c15, Category20c16, Category20c17, Category20c18,

    Category20c19, Category20c20, Cividis3, Cividis4, Cividis5,

    Cividis6, Cividis7, Cividis8, Cividis9, Cividis10, Cividis11,

    Cividis256, Colorblind3, Colorblind4, Colorblind5, Colorblind6,

    Colorblind7, Colorblind8, Dark2_3, Dark2_4, Dark2_5, Dark2_6,

    Dark2_7, Dark2_8, GnBu3, GnBu4, GnBu5, GnBu6, GnBu7, GnBu8, GnBu9,

    Greens3, Greens4, Greens5, Greens6, Greens7, Greens8, Greens9,

    Greens256, Greys3, Greys4, Greys5, Greys6, Greys7, Greys8, Greys9,

    Greys256, HighContrast3, Inferno3, Inferno4, Inferno5, Inferno6,

    Inferno7, Inferno8, Inferno9, Inferno10, Inferno11, Inferno256,

    Iridescent3, Iridescent4, Iridescent5, Iridescent6, Iridescent7,

    Iridescent8, Iridescent9, Iridescent10, Iridescent11,

    Iridescent12, Iridescent13, Iridescent14, Iridescent15,

    Iridescent16, Iridescent17, Iridescent18, Iridescent19,

    Iridescent20, Iridescent21, Iridescent22, Iridescent23, Light3,

    Light4, Light5, Light6, Light7, Light8, Light9, Magma3, Magma4,

    Magma5, Magma6, Magma7, Magma8, Magma9, Magma10, Magma11,

    Magma256, MediumContrast3, MediumContrast4, MediumContrast5,

    MediumContrast6, Muted3, Muted4, Muted5, Muted6, Muted7, Muted8,

    Muted9, OrRd3, OrRd4, OrRd5, OrRd6, OrRd7, OrRd8, OrRd9, Oranges3,

    Oranges4, Oranges5, Oranges6, Oranges7, Oranges8, Oranges9,

    Oranges256, PRGn3, PRGn4, PRGn5, PRGn6, PRGn7, PRGn8, PRGn9,

    PRGn10, PRGn11, Paired3, Paired4, Paired5, Paired6, Paired7,

    Paired8, Paired9, Paired10, Paired11, Paired12, Pastel1_3,

    Pastel1_4, Pastel1_5, Pastel1_6, Pastel1_7, Pastel1_8, Pastel1_9,

    Pastel2_3, Pastel2_4, Pastel2_5, Pastel2_6, Pastel2_7, Pastel2_8,

    PiYG3, PiYG4, PiYG5, PiYG6, PiYG7, PiYG8, PiYG9, PiYG10, PiYG11,

    Plasma3, Plasma4, Plasma5, Plasma6, Plasma7, Plasma8, Plasma9,

    Plasma10, Plasma11, Plasma256, PuBu3, PuBu4, PuBu5, PuBu6, PuBu7,

    PuBu8, PuBu9, PuBuGn3, PuBuGn4, PuBuGn5, PuBuGn6, PuBuGn7,

    PuBuGn8, PuBuGn9, PuOr3, PuOr4, PuOr5, PuOr6, PuOr7, PuOr8, PuOr9,

    PuOr10, PuOr11, PuRd3, PuRd4, PuRd5, PuRd6, PuRd7, PuRd8, PuRd9,

    Purples3, Purples4, Purples5, Purples6, Purples7, Purples8,

    Purples9, Purples256, RdBu3, RdBu4, RdBu5, RdBu6, RdBu7, RdBu8,

    RdBu9, RdBu10, RdBu11, RdGy3, RdGy4, RdGy5, RdGy6, RdGy7, RdGy8,

    RdGy9, RdGy10, RdGy11, RdPu3, RdPu4, RdPu5, RdPu6, RdPu7, RdPu8,

    RdPu9, RdYlBu3, RdYlBu4, RdYlBu5, RdYlBu6, RdYlBu7, RdYlBu8,

    RdYlBu9, RdYlBu10, RdYlBu11, RdYlGn3, RdYlGn4, RdYlGn5, RdYlGn6,

    RdYlGn7, RdYlGn8, RdYlGn9, RdYlGn10, RdYlGn11, Reds3, Reds4,

    Reds5, Reds6, Reds7, Reds8, Reds9, Reds256, Set1_3, Set1_4,

    Set1_5, Set1_6, Set1_7, Set1_8, Set1_9, Set2_3, Set2_4, Set2_5,

    Set2_6, Set2_7, Set2_8, Set3_3, Set3_4, Set3_5, Set3_6, Set3_7,

    Set3_8, Set3_9, Set3_10, Set3_11, Set3_12, Spectral3, Spectral4,

    Spectral5, Spectral6, Spectral7, Spectral8, Spectral9, Spectral10,

    Spectral11, Sunset3, Sunset4, Sunset5, Sunset6, Sunset7, Sunset8,

    Sunset9, Sunset10, Sunset11, TolPRGn3, TolPRGn4, TolPRGn5,

    TolPRGn6, TolPRGn7, TolPRGn8, TolPRGn9, TolRainbow3, TolRainbow4,

    TolRainbow5, TolRainbow6, TolRainbow7, TolRainbow8, TolRainbow9,

    TolRainbow10, TolRainbow11, TolRainbow12, TolRainbow13,

    TolRainbow14, TolRainbow15, TolRainbow16, TolRainbow17,

    TolRainbow18, TolRainbow19, TolRainbow20, TolRainbow21,

    TolRainbow22, TolRainbow23, TolYlOrBr3, TolYlOrBr4, TolYlOrBr5,

    TolYlOrBr6, TolYlOrBr7, TolYlOrBr8, TolYlOrBr9, Turbo3, Turbo4,

    Turbo5, Turbo6, Turbo7, Turbo8, Turbo9, Turbo10, Turbo11,

    Turbo256, Vibrant3, Vibrant4, Vibrant5, Vibrant6, Vibrant7,

    Viridis3, Viridis4, Viridis5, Viridis6, Viridis7, Viridis8,

    Viridis9, Viridis10, Viridis11, Viridis256, YlGn3, YlGn4, YlGn5,

    YlGn6, YlGn7, YlGn8, YlGn9, YlGnBu3, YlGnBu4, YlGnBu5, YlGnBu6,

    YlGnBu7, YlGnBu8, YlGnBu9, YlOrBr3, YlOrBr4, YlOrBr5, YlOrBr6,

    YlOrBr7, YlOrBr8, YlOrBr9, YlOrRd3, YlOrRd4, YlOrRd5, YlOrRd6,

    YlOrRd7, YlOrRd8, YlOrRd9)

all_palettes#

所有内置调色板组。此字典使用调色板名称索引以获得完整的调色板组，例如 Viridis，然后进一步使用整数索引以从组中选择特定大小的调色板

>> all_palettes['Viridis'][4]
('#440154', '#30678D', '#35B778', '#FDE724')

生成的调色板如下所示：

brewer#

从 ColorBrewer 包含的调色板组。此字典使用调色板名称索引以获得完整的调色板组，例如 YlGnBu，然后进一步使用整数索引以从组中选择特定大小的调色板

>> brewer['YlGnBu'][4]
('#225ea8', '#41b6c4', '#a1dab4', '#ffffcc')

生成的调色板如下所示：

d3#

此字典使用调色板名称作为索引，以获取完整的调色板组，例如 Category20b，然后可以使用整数进一步索引，以从该组中选择特定大小的调色板。

>> d3['Category20b'][4]
('#393b79', '#5254a3', '#6b6ecf', '#9c9ede')

生成的调色板如下所示：

D3 调色板组的名称是： Category10, Category20, Category20b, Category20c

mpl#

此字典使用调色板名称作为索引，以获取完整的调色板组，例如 Plasma，然后可以使用整数进一步索引，以从该组中选择特定大小的调色板。

>> mpl['Plasma'][4]
('#440154', '#30678D', '#35B778', '#FDE724')

生成的调色板如下所示：

MPL 调色板组的名称是： Inferno, Magma Plasma, Viridis

tol#

此字典使用调色板名称作为索引，以获取完整的调色板组，例如 Bright，然后可以使用整数进一步索引，以从该组中选择特定大小的调色板。

>> tol['Bright'][4]
('#4477AA', '#EE6677', '#228833', '#CCBB44')

生成的调色板如下所示：

Tol 调色板组的名称是： Bright, HighContrast, Vibrant, Muted, MediumContrast, Light, Sunset, BuRd, TolPRGn, TolYlOrBr, Iridescent, TolRainbow

small_palettes#

此字典使用调色板名称作为索引，以获取完整的调色板组，例如 Viridis，然后可以使用整数进一步索引，以从该组中选择特定大小的调色板。

>> small_palettes['Viridis'][4]
('#440154', '#30678D', '#35B778', '#FDE724')

生成的调色板如下所示：

函数#

bokeh.palettes 模块还包含几个可以用来生成任意大小调色板的函数。

cividis(n)[source]#

从 Cividis 调色板生成调色板。

用作派生新调色板输入的完整 Cividis 调色板有 256 种颜色，如下所示

参数:: n (int) – 要生成的调色板的大小
返回:: 十六进制 RGB 颜色字符串序列
返回类型:: seq[str]
引发:: ValueError 如果 n 大于基础调色板长度 256 –

示例

>>> cividis(6)
('#00204C', '#31446B', '#666870', '#958F78', '#CAB969', '#FFE945')

生成的调色板如下所示：

diverging_palette(palette1, palette2, n, midpoint)[source]#

通过组合正好两个输入调色板来生成新调色板。

给定输入 palette1 和 palette2，取总共 n 种颜色，并在相对 midpoint 位置组合输入调色板。 palette1 和 palette2 应该是从视觉上由深到浅、从左到右排列的顺序调色板。在这种情况下，返回的调色板由在视觉上较浅端连接的输入调色板组成。调色板通过分段线性插值组合。

参数:

palette1 (seq[str]) – 第一个调色板的十六进制 RGB 颜色字符串序列
palette2 (seq[str]) – 第二个调色板的十六进制 RGB 颜色字符串序列
n (int) – 要生成的输出调色板的大小
midpoint (float, optional) – 返回的调色板中输入调色板连接的相对位置（默认值：0.5）

返回:

十六进制 RGB 颜色字符串序列

返回类型:

seq[str]

引发:

ValueError 如果 n 大于输入调色板可能组合的长度 –

gray(n)[source]#

从 Greys 调色板生成调色板。

用作派生新调色板输入的完整 Greys 调色板有 256 种颜色，如下所示

参数:: n (int) – 要生成的调色板的大小
返回:: 十六进制 RGB 颜色字符串序列
返回类型:: seq[str]
引发:: ValueError 如果 n 大于基础调色板长度 256 –

示例

>>> gray(6)
('#000000', '#333333', '#666666', '#999999', '#cccccc', '#ffffff')

生成的调色板如下所示：

注意

此函数也有备用拼写形式 grey

grey(n)[source]#

从 Greys 调色板生成调色板。

用作派生新调色板输入的完整 Greys 调色板有 256 种颜色，如下所示

参数:: n (int) – 要生成的调色板的大小
返回:: 十六进制 RGB 颜色字符串序列
返回类型:: seq[str]
引发:: ValueError 如果 n 大于基础调色板长度 256 –

示例

>>> grey(6)
('#000000', '#333333', '#666666', '#999999', '#cccccc', '#ffffff')

生成的调色板如下所示：

注意

此函数也有备用拼写形式 gray

inferno(n)[source]#

从 Inferno 调色板生成调色板。

用作派生新调色板输入的完整 Inferno 调色板有 256 种颜色，如下所示

参数:: n (int) – 要生成的调色板的大小
返回:: 十六进制 RGB 颜色字符串序列
返回类型:: seq[str]
引发:: ValueError 如果 n 大于基础调色板长度 256 –

示例

>>> inferno(6)
('#000003', '#410967', '#932567', '#DC5039', '#FBA40A', '#FCFEA4')

生成的调色板如下所示：

interp_palette(palette, n)[source]#

通过插值给定的调色板来生成新调色板。

线性插值分别在每个 RGBA 组件上执行。

参数:

palette (seq[str]) – 用于创建新调色板的十六进制 RGB(A) 颜色字符串序列
n (int) – 要生成的调色板的大小

返回:

十六进制 RGB(A) 颜色字符串序列

返回类型:

tuple[str]

引发:

ValueError 如果 n 为负数或提供的调色板为空。 –

linear_palette(palette, n)[source]#

生成一个新的调色板作为给定调色板的子集。

给定输入 palette，通过将其长度划分为 n 个（近似）均匀间隔的索引，从中取出 n 种颜色。

参数:

palette (seq[str]) – 十六进制 RGB 颜色字符串序列
n (int) – 要生成的输出调色板的大小

返回:

十六进制 RGB 颜色字符串序列

返回类型:

seq[str]

引发:

ValueError 如果 n > len(palette) –

magma(n)[source]#

从 Magma 调色板生成调色板。

用作派生新调色板输入的完整 Magma 调色板有 256 种颜色，如下所示

参数:: n (int) – 要生成的调色板的大小
返回:: 十六进制 RGB 颜色字符串序列
返回类型:: seq[str]
引发:: ValueError 如果 n 大于基础调色板长度 256 –

示例

>>> magma(6)
('#000003', '#3B0F6F', '#8C2980', '#DD4968', '#FD9F6C', '#FBFCBF')

生成的调色板如下所示：

varying_alpha_palette(palette, n, start_alpha, end_alpha)[source]#

生成一个调色板，该调色板是具有线性变化的 alpha 值的单一颜色。

Alpha 值可能会从低到高或从高到低变化，具体取决于 start_alpha 和 end_alpha 的值。

参数:

color (str) – 命名的颜色或 RGB(A) 十六进制颜色字符串。任何 alpha 分量都将与 start_alpha 到 end_alpha 范围结合，方法是将它们相乘在一起，因此它是可以获得的最大 alpha 值。
n (int, 可选) – 要生成的调色板的大小。如果未指定，则使用最大颜色数，以便相邻颜色之间的 alpha 值相差 1。
start_alpha (int, 可选) – 调色板开头的 alpha 分量是此值（范围为 0 到 255），乘以 color 参数的 alpha 分量。
end_alpha (int, 可选) – 调色板结尾的 alpha 分量是此值（范围为 0 到 255），乘以 color 参数的 alpha 分量。

返回:

十六进制 RGBA 颜色字符串序列

返回类型:

seq[str]

引发:

ValueError，如果颜色无法识别为字符串名称或十六进制 – RGB(A) 字符串，或者如果 start_alpha 或 end_alpha 超出 0 到 255 的范围（包括 0 和 255）。

viridis(n)[source]#

从 Viridis 调色板生成颜色调色板。

完整的 Viridis 调色板包含 256 种颜色，用作导出新调色板的输入，如下所示：

参数:: n (int) – 要生成的调色板的大小
返回:: 十六进制 RGB 颜色字符串序列
返回类型:: seq[str]
引发:: ValueError 如果 n 大于基础调色板长度 256 –

示例

>>> viridis(6)
('#440154', '#404387', '#29788E', '#22A784', '#79D151', '#FDE724')

生成的调色板如下所示：

许可证#

Bokeh 中包含的所有调色板的各自许可证都可以在 src/bokeh/palettes.py 源文件顶部的注释中查看。