bokeh.palettes

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

在Bokeh的上下文中，调色板是一个简单的纯Python列表，包含（十六进制）RGB颜色字符串。例如，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调色板模块属性中，而“小型”调色板（即不包括256色的调色板）被收集在small_palettes属性中。

内置调色板

Matplotlib 调色板

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

Cividis
3
4
5
6
7
8
9
10
11

地狱
3
4
5
6
7
8
9
10
11

岩浆
3
4
5
6
7
8
9
10
11

等离子体
3
4
5
6
7
8
9
10
11

Viridis
3
4
5
6
7
8
9
10
11

D3 调色板

Bokeh 包含了来自 D3 的分类调色板，如下所示：

类别10
3
4
5
6
7
8
9
10

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

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

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

Brewer 调色板

Bokeh 包含了所有 ColorBrewer 调色板，如下所示：

重音
3
4
5
6
7
8

布鲁斯
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

深色2
3
4
5
6
7
8

GnBu
3
4
5
6
7
8
9

绿色
3
4
5
6
7
8
9

Greys
3
4
5
6
7
8
9

橙红色
3
4
5
6
7
8
9

橙子
3
4
5
6
7
8
9

PRGn
3
4
5
6
7
8
9
10
11

配对
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

紫色
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

红色
3
4
5
6
7
8
9

集合1
3
4
5
6
7
8
9

集合2
3
4
5
6
7
8

集合3
3
4
5
6
7
8
9
10
11
12

光谱
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。

明亮
3
4
5
6
7

BuRd
3
4
5
6
7
8
9

高对比度
3

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

光
3
4
5
6
7
8
9

中等对比度
3
4
5
6

静音
3
4
5
6
7
8
9

日落
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

充满活力
3
4
5
6
7

色盲
3
4
5
6
7
8

以下调色板也在Paul Tol的颜色方案中介绍，但用途不同。PaleTextBackground应用于黑色文本的背景。DarkText用于白色背景上的文本本身。其理念是使用一种深色作为支持，而不是全部组合使用，也不仅仅用于一个单词。

PaleTextBackground:

DarkText:

大型调色板

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

Greys256:

<span style="width: 1px; height: 20px; background-color: #858585; display

Inferno256:

<span style="width: 1px; height:

Magma256:

</

Plasma256:

<span style="

Viridis256:

</span

Cividis256:

<span style="width: 1px; height

Turbo256:

<span style="width: 1px; height:

许多其他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)

See all values

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

分类调色板组包含自D3。此字典通过调色板名称索引以获取完整的调色板组，例如 Category20b，然后进一步通过整数索引以从组中选择特定大小的调色板：

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

生成的调色板如下所示：

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

mpl

调色板组包含自Matplotlib。此字典通过调色板名称索引以获取完整的调色板组，例如Plasma，然后进一步通过整数索引以从组中选择特定大小的调色板：

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

生成的调色板如下所示：

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

tol

一组来自Paul Tol的色彩方案的可访问调色板。这个字典通过调色板名称进行索引以获取一组完整的调色板，例如Bright，然后进一步通过整数索引从该组中选择特定大小的调色板：

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

生成的调色板看起来像：

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

small_palettes

所有调色板组，不包括256长度的调色板。此字典通过调色板名称索引以获取完整的调色板组，例如 Viridis，然后进一步通过整数索引以从组中选择特定大小的调色板：

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

生成的调色板看起来像：

函数

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

cividis(n)

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

作为输入用于派生新调色板的完整Cividis调色板有256种颜色，看起来像：

<span style="width: 1px; height

Parameters:

n (int) – 要生成的调色板的大小

Returns:

一串十六进制RGB颜色字符串

Return type:

序列[str]

Raises:

如果n大于基础调色板长度256，则抛出ValueError –

示例：

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

生成的调色板看起来像：

diverging_palette(palette1, palette2, n, midpoint)

通过精确组合两个输入调色板生成一个新的调色板。

给定输入 palette1 和 palette2，取组合的 n 种颜色， 并在相对的 midpoint 处组合输入调色板。 palette1 和 palette2 是顺序调色板，从左到右从感知上的深色到浅色进行。 在这种情况下，返回的调色板由在感知上的浅色端连接的输入调色板组成。 调色板通过分段线性插值进行组合。

Parameters:

• palette1 (seq[str]) – 第一个调色板的十六进制RGB颜色字符串序列

• palette2 (seq[str]) – 第二个调色板的十六进制RGB颜色字符串序列

• n (int) – 要生成的输出调色板的大小

• midpoint (float, optional) – 返回的调色板中连接输入调色板的相对位置（默认值：0.5）

Returns:

一串十六进制RGB颜色字符串

Return type:

序列[str]

Raises:

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

gray(n)

生成一个颜色调色板或从灰色调色板中生成。

作为输入用于派生新调色板的完整Greys调色板有256种颜色，看起来像：

<span style="width: 1px; height: 20px; background-color: #858585; display

Parameters:

n (int) – 要生成的调色板的大小

Returns:

一串十六进制RGB颜色字符串

Return type:

序列[str]

Raises:

如果n大于基础调色板长度256，则抛出ValueError –

示例：

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

生成的调色板如下所示：

注意

此函数也有另一种拼写 grey

grey(n)

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

作为输入用于派生新调色板的完整Greys调色板有256种颜色，看起来像：

<span style="width: 1px; height: 20px; background-color: #858585; display

Parameters:

n (int) – 要生成的调色板的大小

Returns:

一串十六进制RGB颜色字符串

Return type:

序列[str]

Raises:

如果n大于基础调色板长度256，则抛出ValueError –

示例：

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

生成的调色板如下所示：

注意

此函数也有另一种拼写 gray

inferno(n)

从Inferno调色板生成一组颜色。

作为输入用于派生新调色板的完整Inferno调色板有256种颜色，看起来像：

<span style="width: 1px; height:

Parameters:

n (int) – 要生成的调色板的大小

Returns:

一串十六进制RGB颜色字符串

Return type:

序列[str]

Raises:

如果n大于基础调色板长度256，则抛出ValueError –

示例：

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

生成的调色板如下所示：

interp_palette(palette, n)

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

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

Parameters:

• 调色板 (序列[str]) – 从一系列十六进制RGB(A)颜色字符串创建新调色板

• n (int) – 要生成的调色板的大小

Returns:

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

Return type:

tuple[str]

Raises:

如果n为负数或提供的调色板为空，则抛出ValueError –

linear_palette(palette, n)

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

给定一个输入 palette，通过将其长度分成 n 个（大约）均匀分布的索引，从中取出 n 种颜色。

Parameters:

• 调色板 (序列[str]) – 一个由十六进制RGB颜色字符串组成的序列

• n (int) – 要生成的输出调色板的大小

Returns:

一串十六进制RGB颜色字符串

Return type:

序列[str]

Raises:

如果n大于len(palette)则抛出ValueError –

magma(n)

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

完整的Magma调色板作为输入用于派生新的调色板，包含256种颜色，看起来像：

</

Parameters:

n (int) – 要生成的调色板的大小

Returns:

一串十六进制RGB颜色字符串

Return type:

序列[str]

Raises:

如果n大于基础调色板长度256，则抛出ValueError –

示例：

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

生成的调色板如下所示：

varying_alpha_palette(palette, n, start_alpha, end_alpha)

生成一个单一颜色的调色板，其透明度线性变化。

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

Parameters:

• color (str) – 命名的颜色或RGB(A)十六进制颜色字符串。任何alpha分量都会与start_alpha到end_alpha范围通过相乘结合在一起，因此它是可以获得的最大可能alpha值。

• n (int, optional) – 要生成的调色板的大小。如果未指定，则使用最大颜色数，使得相邻颜色的alpha值相差1。

• start_alpha (int, optional) – 调色板起始的alpha分量是这个值（在0到255范围内）乘以color参数的alpha分量。

• end_alpha (int, optional) – 调色板结束时的alpha分量是这个值（在0到255范围内）乘以color参数的alpha分量。

Returns:

一串十六进制的RGBA颜色字符串

Return type:

序列[str]

Raises:

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

viridis(n)

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

作为输入用于派生新调色板的完整Viridis调色板包含256种颜色，看起来像：

</span

Parameters:

n (int) – 要生成的调色板的大小

Returns:

一串十六进制RGB颜色字符串

Return type:

序列[str]

Raises:

如果n大于基础调色板长度256，则抛出ValueError –

示例：

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

生成的调色板如下所示：

许可证

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