matplotlib.colors.BivarColormap#

class matplotlib.colors.BivarColormap(N=256, M=256, shape='square', origin=(0, 0), name='bivariate colormap')[source]#

基类： object

所有双变量到 RGBA 映射的基类。

设计用于在使用二维查找表时作为 Colormap 的直接替代品。可与 ScalarMappable 一起使用。

参数:
Nint, 默认值: 256

沿第一个轴的 RGB 量化级别数。

Mint, 默认值: 256

沿第二个轴的 RGB 量化级别数。

shape{'square', 'circle', 'ignore', 'circleignore'}

  • 'square'：每个变量独立地裁剪到 [0,1] 范围内

  • 'circle'：变量径向裁剪到色图中心，并在显示色图时应用圆形掩码

  • 'ignore'：变量不裁剪，而是被赋予“外部”颜色

  • 'circleignore'：应用圆形掩码，但数据不裁剪，而是被赋予“外部”颜色

origin(float, float), 默认值: (0,0)

色图的相对原点。对于在两个轴上都呈线性的色图，通常为 (0, 0)；对于圆形色图，则为 (.5, .5)。在从二维色图获取一维色图时使用。

namestr, 可选

色图的名称。

__call__(X, alpha=None, bytes=False)[source]#
参数:
X元组 (X0, X1), X0 和 X1：浮点数、整数或类数组对象

要转换为 RGBA 的数据值。

  • 对于浮点数，X 应处于区间 [0.0, 1.0] 以返回沿 Colormap 百分比为 X*100 的 RGBA 值。

  • 对于整数，X 应处于区间 [0, Colormap.N) 以返回从 Colormap 中索引为 X 的 RGBA 值。

alpha浮点数、类数组对象或 None，默认值：None

Alpha 必须是介于 0 和 1 之间的标量、与 X0 形状匹配的此类浮点序列，或为 None。

bytes布尔值，默认值：False

如果为 False（默认值），返回的 RGBA 值将是区间 [0, 1] 内的浮点数，否则它们将是区间 [0, 255] 内的 numpy.uint8。

返回:
如果 X 是标量，则返回 RGBA 值的元组，否则返回形状为 X.shape + (4, ) 的
RGBA 值数组。
copy()[source]#

返回色彩映射表的副本。

get_bad()[source]#

获取用于掩码值的颜色。

get_outside()[source]#

获取用于超出范围值的颜色。

property lut#

用于外部访问查找表（lut），例如用于显示 cmap。对于圆形色彩映射表，此属性返回带有圆形掩码的 lut。

内部函数（如 to_rgb()）应使用 _lut，它存储不带圆形掩码的 lut。to_rgb() 中需要不带圆形掩码的 lut，因为从浮点数到整数的转换会导致一些像素请求落在圆形掩码之外。

property origin#
resampled(lutshape, transposed=False)[source]#

返回具有 lutshape 条目的新色彩映射表。

请注意，此函数不会移动原点。

参数:
lutshape整数元组或 None

元组长度必须为 2，每个条目要么是整数，要么是 None。

  • 如果是整数，则对应轴被重采样。

  • 如果为负数，则对应轴被反向重采样。

  • 如果为 -1，则轴被翻转。

  • 如果是 1 或 None，则对应轴不被重采样。

transposed布尔值，默认值：False

如果为 True，则在重采样后交换轴。

返回:
BivarColormap
reversed(axis_0=True, axis_1=True)[source]#

反转两个轴中的一个或全部。

property shape#
transposed()[source]#

通过交换轴的顺序来转置色彩映射表。

with_extremes(*, bad=None, outside=None, shape=None, origin=None)[source]#

返回一个具有修改属性的 BivarColormap 副本。

请注意，outside 颜色仅在 shape = 'ignore' 或 'circleignore' 时才有意义。

参数:
badcolor，可选

如果提供，bad 值将在副本中相应设置。

outsidecolor，可选

如果提供且形状为 'ignore' 或 'circleignore'，则在副本中 outside 色彩映射表的值将相应着色。

shape{'square', 'circle', 'ignore', 'circleignore'}

  • 如果为 'square'，则每个变量将独立地裁剪到 [0,1] 范围内。

  • 如果为 'circle'，则变量将径向裁剪到色图中心，并在显示色图时应用圆形掩码。

  • 如果为 'ignore'，则变量不会被裁剪，而是被赋予 outside 颜色。

  • 如果为 'circleignore'，则应用圆形掩码，但数据不会被裁剪，而是被赋予 outside 颜色。

origin(浮点数, 浮点数)

色图的相对原点。对于在两个轴上都呈线性的色图，通常为 (0, 0)；对于圆形色图，则为 (.5, .5)。在从二维色图获取一维色图时使用。

返回:
BivarColormap

设置了属性的自身副本。