matplotlib.colors

注意

颜色教程和示例演示了如何设置颜色和颜色映射。您可能更愿意阅读这些内容。

用于将数字或颜色参数转换为 RGB 或 RGBA 的模块。

RGB 和 RGBA 分别是 3 或 4 个 0-1 范围内的浮点数序列。

此模块包含用于颜色规范转换的函数和类，以及将数字映射到称为颜色映射的一维颜色数组中的颜色的函数和类。

使用颜色映射将数据映射到颜色通常涉及两个步骤：首先使用 Normalize 的子类将数据数组映射到 0-1 范围，然后使用 Colormap 的子类将此数字映射到颜色。此处提供了 Colormap 的两个子类：LinearSegmentedColormap，它使用分段线性插值定义颜色映射，以及 ListedColormap，它从颜色列表中创建颜色映射。

另请参阅

有关如何创建颜色映射的示例，请参阅在 Matplotlib 中创建颜色映射，以及

有关内置颜色映射列表，请参阅在 Matplotlib 中选择颜色映射。

有关数据归一化的更多详细信息，请参阅颜色映射归一化

更多颜色映射可在 palettable 获取。

该模块还提供了用于检查对象是否可以解释为颜色（is_color_like）、将此类对象转换为 RGBA 元组（to_rgba）或类似 HTML 的十六进制字符串（"#rrggbb" 格式）（to_hex），以及将颜色序列转换为 (n, 4) RGBA 数组（to_rgba_array）的函数。为提高效率使用了缓存。

Matplotlib 可识别的颜色列于指定颜色。

颜色范数

Normalize([vmin, vmax, clip])	一个类，当被调用时，它将 [vmin, vmax] 区间内的值线性映射到 [0.0, 1.0] 区间。
NoNorm([vmin, vmax, clip])	用于 Normalize 的虚拟替换，适用于我们希望直接在 ScalarMappable 中使用索引的情况。
AsinhNorm([linear_width, vmin, vmax, clip])	反双曲正弦刻度在原点附近近似线性，但对于较大的正值或负值则变为对数。
BoundaryNorm(boundaries, ncolors[, clip, extend])	根据离散区间生成颜色映射索引。
CenteredNorm([vcenter, halfrange, clip])	围绕中心（默认为 0）归一化对称数据。
FuncNorm(functions[, vmin, vmax, clip])	使用前向和逆向函数进行任意归一化。
LogNorm([vmin, vmax, clip])	在对数刻度上将给定值归一化到 0-1 范围。
PowerNorm(gamma[, vmin, vmax, clip])	将给定值线性映射到 0-1 范围，然后在此范围内应用幂律归一化。
SymLogNorm(linthresh[, linscale, vmin, ...])	对称对数刻度在原点的正负方向上都是对数的。
TwoSlopeNorm(vcenter[, vmin, vmax])	归一化具有设定中心的数据。

单变量颜色映射

Colormap(name[, N])	所有标量到 RGBA 映射的基类。
LinearSegmentedColormap(name, segmentdata[, ...])	基于使用线性段的查找表的颜色映射对象。
ListedColormap(colors[, name, N])	从颜色列表生成的颜色映射对象。

多变量颜色映射

BivarColormap([N, M, shape, origin, name])	所有二元到 RGBA 映射的基类。
SegmentedBivarColormap(patch[, N, shape, ...])	通过对规则网格进行过采样生成的 BivarColormap 对象。
BivarColormapFromImage(lut[, shape, origin, ...])	通过对规则网格进行过采样生成的 BivarColormap 对象。

其他类

ColorSequenceRegistry()	已知 Matplotlib 命名的颜色序列容器。
LightSource([azdeg, altdeg, hsv_min_val, ...])	创建来自指定方位角和仰角的光源。

函数

from_levels_and_colors(levels, colors[, extend])	一个辅助例程，用于生成行为类似于 contourf 的级别和颜色参数的 cmap 和 norm 实例。
hsv_to_rgb(hsv)	将 HSV 值转换为 RGB。
rgb_to_hsv(arr)	将浮点 RGB 值数组（范围 [0, 1] 内）转换为 HSV 值。
to_hex(c[, keep_alpha])	将 c 转换为十六进制颜色。
to_rgb(c)	将 c 转换为 RGB 颜色，并静默丢弃 alpha 通道。
to_rgba(c[, alpha])	将 c 转换为 RGBA 颜色。
to_rgba_array(c[, alpha])	将 c 转换为 (n, 4) RGBA 颜色数组。
is_color_like(c)	返回 c 是否可以解释为 RGB(A) 颜色。
same_color(c1, c2)	返回颜色 c1 和 c2 是否相同。
get_named_colors_mapping()	返回名称到命名颜色的全局映射。
make_norm_from_scale(scale_cls[, ...])	用于从 ScaleBase 子类构建 Normalize 子类的装饰器。

导出的颜色

用于填充命名颜色列表的数据以字典形式公开，将颜色名称映射到十六进制字符串。

matplotlib.colors.BASE_COLORS

matplotlib.colors.TABLEAU_COLORS

matplotlib.colors.CSS4_COLORS

matplotlib.colors.XKCD_COLORS