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 中索引的 RGBA 值，索引为 X。

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' 时才相关。

参数:
badNone 或 color

如果是 Matplotlib 颜色，则在副本中相应地设置 bad 值

outsideNone 或 color

如果为 Matplotlib 颜色且 shape 为 'ignore' 或 'circleignore'，则色图外的 outside 值在副本中相应着色

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

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

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

  • 如果为 'ignore'，则变量不裁剪，而是分配 outside 颜色

  • 如果为 'circleignore'，则应用圆形掩码，但数据不裁剪，而是分配 outside 颜色

origin(浮点数, 浮点数)

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

返回:
BivarColormap

设置了属性的自身副本

在此页