matplotlib.colors.Normalize#

class matplotlib.colors.Normalize(vmin=None, vmax=None, clip=False)[源代码][源代码]#

基类:object

一个类,当被调用时,将区间 [vmin, vmax] 内的值线性映射到区间 [0.0, 1.0]。区间 [vmin, vmax] 外的值的映射取决于 clip

示例

x = [-2, -1, 0, 1, 2]

norm = mpl.colors.Normalize(vmin=-1, vmax=1, clip=False)
norm(x)  # [-0.5, 0., 0.5, 1., 1.5]
norm = mpl.colors.Normalize(vmin=-1, vmax=1, clip=True)
norm(x)  # [0., 0., 0.5, 1., 1.]
参数:
vmin, vmax浮点数或无

输入数据中在范围 [vmin, vmax] 内的值将被线性映射到 [0, 1]。如果 vminvmax 未提供,它们分别默认为输入的最小值和最大值。

剪辑bool, 默认: False

确定映射范围 [vmin, vmax] 之外的值的行为。

如果剪裁关闭,范围 [vmin, vmax] 之外的值也会被转换,导致结果超出 [0, 1] 范围。这种行为通常是可取的,因为色图可以用特定颜色标记这些 低于高于 的值。

如果裁剪开启,低于 vmin 的值会被映射到 0,高于 vmax 的值会被映射到 1。这些值变得与常规边界值无法区分,可能会导致对数据的误解。

注释

如果 vmin == vmax,输入数据将被映射到 0。

__call__(value, clip=None)[源代码][源代码]#

规范化数据并返回规范化后的数据。

参数:

要规范化的数据。

剪辑bool, 可选

参见 Normalize 中参数 clip 的描述。

如果 None,则默认为 self.clip``(默认为 ``False)。

注释

如果尚未初始化,self.vminself.vmax 将使用 self.autoscale_None(value) 进行初始化。

autoscale(A)[源代码][源代码]#

vmin, vmax 设置为 A 的最小值和最大值。

autoscale_None(A)[源代码][源代码]#

如果未设置 vminvmax ,则使用 A 的最小值/最大值来设置它们。

property clip#

!! 由 numpydoc 处理 !!

inverse(value)[源代码][源代码]#

将归一化值(即颜色映射中的索引)映射回图像数据值。

参数:

归一化值。

static process_value(value)[源代码][源代码]#

对输入的 value 进行均质化处理,以便于轻松高效地进行归一化。

value 可以是一个标量或序列。

参数:

要规范化的数据。

返回:
结果掩码数组

value 形状相同的掩码数组。

is_scalar布尔值

是否 value 是一个标量。

注释

浮点数类型保持不变;两字节或更小的整数类型转换为 np.float32,更大的类型转换为 np.float64。尽可能保留 float32,并使用就地操作,可以大大提高大型数组的速度。

scaled()[源代码][源代码]#

返回 vminvmax 是否都已设置。

property vmax#

!! 由 numpydoc 处理 !!

property vmin#

!! 由 numpydoc 处理 !!

使用 matplotlib.colors.Normalize 的示例#

将标记属性映射到多变量数据

Mapping marker properties to multivariate data

颜色映射归一化

Colormap normalizations

颜色映射归一化 SymLogNorm

Colormap normalizations SymLogNorm

等高线图像

Contour image

带注释的热图

Annotated heatmap

带有掩码值的图像

Image with masked values

在2D图像中混合透明度和颜色

Blend transparency with color in 2D images

带有单个颜色条的多个图像

Multiple images with one colorbar

pcolor 图像

pcolor images

pcolormesh

pcolormesh

直方图

Histograms

阴影与功率归一化渲染

Shaded & power normalized rendering

3D 中的 2D 图像

2D images in 3D

探索归一化

Exploring normalizations

山体阴影

Hillshading

左心室靶心图

Left ventricle bullseye

快速入门指南

Quick start guide

约束布局指南

Constrained layout guide

自定义颜色条教程

Customized Colorbars Tutorial

颜色映射归一化

Colormap normalization