matplotlib.contour#

支持 Axes 类的等高线绘图和标签的类。

类 matplotlib.contour。ClabelText ( x = 0 , y = 0 , text = '' , * , color = None , verticalalignment = 'baseline' , Horizo ​​ntalalignment = 'left' , multialignment = None , fontproperties = None , rotation = None , linespacing = None , rotation_mode =无, usetex = None , wrap = False , transform_rotates_text = False , parse_math = None , ** kwargs ) [来源] #

基地：Text

与普通文本不同，get_rotation 返回像素坐标中的更新角度，假设输入旋转是数据坐标中的角度（或任何变换集）。

在x , y处创建一个带有字符串textText的实例。

文本根据（默认：'left'）和 （默认：'bottom'）相对于锚点（x，y ）对齐。另请参见 文本对齐。horizontalalignmentverticalalignment

虽然 Text 接受 'label' 关键字参数，但默认情况下它不会添加到图例的句柄中。

有效的关键字参数是：

财产

描述

agg_filter

一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量

alpha

标量或无

animated

布尔

backgroundcolor

颜色

bbox

具有属性的字典patches.FancyBboxPatch

clip_box

未知

clip_on

未知

clip_path

未知

color或 c

颜色

figure

Figure

fontfamily或家人

{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}

fontproperties或字体或字体属性

font_manager.FontProperties或str或pathlib.Path

fontsize或尺寸

浮动或{'xx-small'、'x-small'、'small'、'medium'、'large'、'x-large'、'xx-large'}

fontstretch或拉伸

{0-1000 范围内的数值，'超压缩'，'超压缩'，'压缩'，'半压缩'，'普通'，'半扩展'，'扩展'，'超扩展', '超膨胀'}

fontstyle或风格

{'正常'，'斜体'，'斜体'}

fontvariant或变体

{'正常', '小型大写字母'}

fontweight或重量

{0-1000 范围内的数值, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', '粗体'，'重'，'超粗体'，'黑色'}

gid

字符串

horizontalalignment或哈

{'左'，'中心'，'右'}

in_layout

布尔

label

目的

linespacing

浮动（字体大小的倍数）

math_fontfamily

字符串

mouseover

布尔

multialignment或马

{'左'，'右'，'中心'}

parse_math

布尔

path_effects

AbstractPathEffect

picker

None 或 bool 或 float 或可调用

position

（浮动，浮动）

rasterized

布尔

rotation

浮动或{'垂直'，'水平'}

rotation_mode

{无，'默认'，'锚点'}

sketch_params

（比例：浮动，长度：浮动，随机性：浮动）

snap

布尔或无

text

目的

transform

Transform

transform_rotates_text

布尔

url

字符串

usetex

布尔或无

verticalalignment或 va

{'bottom', 'baseline', 'center', 'center_baseline', 'top'}

visible

布尔

wrap

布尔

x

漂浮

y

漂浮

zorder

漂浮
get_rotation ( ) [来源] #

返回 0 到 360 度之间的文本角度。

设置( * , agg_filter=<UNSET> , alpha=<UNSET> , animated=<UNSET> , backgroundcolor=<UNSET> , bbox=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , color=<UNSET> , fontfamily=<UNSET> , fontproperties=<UNSET> , fontsize=<UNSET> , fontstretch=<UNSET> , fontstyle=<UNSET> , fontvariant=<UNSET> , fontweight=<UNSET> , gid=<未设置>,水平对齐=<未设置>, in_layout=<UNSET> , label=<UNSET> , linespacing=<UNSET> , math_fontfamily=<UNSET> , mouseover=<UNSET > , multialignment=<UNSET> , parse_math =<UNSET> , path_effects=<UNSET> ,选择器=<UNSET> , position=<UNSET> , rasterized=<UNSET> , rotation=<UNSET> , rotation_mode=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , text=<UNSET> , transform=<未设置> ,transform_rotates_text=<UNSET> ,url=<UNSET> , usetex=<UNSET> , verticalalignment=<UNSET> , visible=<UNSET> , wrap=<UNSET> , x=<UNSET> , y=<UNSET> , zorder=<UNSET> ) [来源] #

一次设置多个属性。

支持的属性是

财产

描述

agg_filter

一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量

alpha

标量或无

animated

布尔

backgroundcolor

颜色

bbox

具有属性的字典patches.FancyBboxPatch

clip_box

Bbox

clip_on

布尔

clip_path

补丁或（路径，变换）或无

color或 c

颜色

figure

Figure

fontfamily或家人

{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}

fontproperties或字体或字体属性

font_manager.FontProperties或str或pathlib.Path

fontsize或尺寸

浮动或{'xx-small'、'x-small'、'small'、'medium'、'large'、'x-large'、'xx-large'}

fontstretch或拉伸

{0-1000 范围内的数值，'超压缩'，'超压缩'，'压缩'，'半压缩'，'普通'，'半扩展'，'扩展'，'超扩展', '超膨胀'}

fontstyle或风格

{'正常'，'斜体'，'斜体'}

fontvariant或变体

{'正常', '小型大写字母'}

fontweight或重量

{0-1000 范围内的数值, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', '粗体'，'重'，'超粗体'，'黑色'}

gid

字符串

horizontalalignment或哈

{'左'，'中心'，'右'}

in_layout

布尔

label

目的

linespacing

浮动（字体大小的倍数）

math_fontfamily

字符串

mouseover

布尔

multialignment或马

{'左'，'右'，'中心'}

parse_math

布尔

path_effects

AbstractPathEffect

picker

None 或 bool 或 float 或可调用

position

（浮动，浮动）

rasterized

布尔

rotation

浮动或{'垂直'，'水平'}

rotation_mode

{无，'默认'，'锚点'}

sketch_params

（比例：浮动，长度：浮动，随机性：浮动）

snap

布尔或无

text

目的

transform

Transform

transform_rotates_text

布尔

url

字符串

usetex

布尔或无

verticalalignment或 va

{'bottom', 'baseline', 'center', 'center_baseline', 'top'}

visible

布尔

wrap

布尔

x

漂浮

y

漂浮

zorder

漂浮
类 matplotlib.contour。ContourLabeler [来源] #

基地：object

Mixin 为ContourSet.

add_label ( x , y , rotation , lev , cvalue ) [source] #

Text使用类添加轮廓标签。

add_label_clabeltext ( x , y , rotation , lev , cvalue ) [source] #

ClabelText使用类添加轮廓标签。

add_label_near ( x , y , inline = True , inline_spacing = 5 , transform = None ) [来源] #

在该点附近添加标签。(x, y)

参数：
x, y浮动

标签的大致位置。

内联布尔值，默认值：True

如果为True，则删除标签下方的轮廓段。

inline_spacing int，默认值：5

放置内联时要在标签的每一侧留下的空间（以像素为单位）。对于轮廓笔直位置的标签，此间距将是准确的，而对于弯曲轮廓上的标签则更少。

转换Transform或False，默认值：self.axes.transData

在标记之前应用的变换。默认导致被解释为数据坐标。 是;的同义词 ie应该被解释为显示坐标。(x, y)(x, y)FalseIdentityTransform(x, y)

calc_label_rot_and_inline ( slc , ind , lw , lc = None , spacing = 5 ) [来源] #

给定以屏幕为单位的线轮廓坐标、标签位置的索引和标签宽度，计算适当的标签旋转。

如果lc不是 None 或空，也打破轮廓并计算内联。

间距是标签周围留下的空白空间，以像素为单位。

这两项任务一起完成，以避免多次计算路径长度，这相对昂贵。

此处使用的方法包括以像素坐标计算沿轮廓的路径长度，然后从中心点近似（标签宽度/ 2）看以确定旋转，然后在需要时打破轮廓。

clabel ( levels = None , * , fontsize = None , inline = True , inline_spacing = 5 , fmt = None , colors = None , use_clabeltext = False , manual = False , rightside_up = True , zorder = None ) [来源] #

标记等高线图。

向 this 中的线条轮廓添加标签ContourSet（继承自这个 mixin 类）。

参数：
级别数组，可选

应标记的级别值列表。该列表必须是 的子集cs.levels。如果没有给出，所有级别都会被标记。

fontsize str 或 float，默认值：（rcParams["font.size"]默认值10.0：）

以点为单位的大小或相对大小，例如“较小”、“x-large”。查看Text.set_size接受的字符串值。

颜色颜色或颜色或无，默认值：无

标签颜色：

  • 如果None，每个标签的颜色与相应轮廓的颜色相匹配。

  • 如果一个字符串颜色，例如，colors = 'r' 或colors = 'red'，则所有标签都将以这种颜色绘制。

  • 如果是颜色元组（字符串、浮点数、rgb 等），不同的标签将按照指定的顺序以不同的颜色绘制。

内联布尔值，默认值：True

如果True在放置标签的位置删除了基础轮廓。

inline_spacing浮点数，默认值：5

放置内联时要在标签的每一侧留下的空间（以像素为单位）。

对于轮廓笔直位置的标签，此间距将是准确的，而对于弯曲轮廓上的标签则更少。

fmtFormatter或 str 或 callable 或 dict，可选

级别是如何格式化的：

  • 如果 a Formatter，它用于一次格式化所有级别，使用它的Formatter.format_ticks方法。

  • 如果是 str，则将其解释为 % 样式的格式字符串。

  • 如果是可调用对象，则一次调用一个级别，并应返回相应的标签。

  • 如果是 dict，它应该直接将级别映射到标签。

默认是使用标准的ScalarFormatter.

手动bool 或可迭代，默认值：False

如果True，将使用鼠标单击手动放置等高线标签。单击轮廓附近的第一个按钮以添加标签，单击第二个按钮（或可能同时单击两个鼠标按钮）以完成添加标签。第三个按钮可用于删除最后添加的标签，但前提是标签不是内联的。或者，键盘可用于选择标签位置（输入结束标签放置，删除或退格就像第三个鼠标按钮一样，任何其他键都将选择标签位置）。

manual也可以是 (x, y) 元组的可迭代对象。将创建轮廓标签，就像在每个 (x, y) 位置单击鼠标一样。

rightside_up布尔值，默认值：True

如果True，标签旋转将始终与水平面成正负 90 度。

use_clabeltext bool，默认值：False

如果True，则使用ClabelText类（而不是Text）来创建标签。ClabelText在绘图期间重新计算文本的旋转角度，因此如果轴的方面发生变化，可以使用它。

zorder浮点数或无，默认值：(2 + contour.get_zorder())

轮廓标签的 zorder。

返回：
标签

Text标签的实例列表。

get_label_width ( lev , fmt , fsize ) [来源] #

[已弃用]以点为单位返回标签的宽度。

笔记

自 3.5 版起已弃用。

get_text ( lev , fmt ) [来源] #

获取标签的文本。

标签( inline , inline_spacing ) [来源] #
locate_label ( linecontour , labelwidth ) [来源] #

找一个画标签的好地方（轮廓的相对平坦的部分）。

pop_label ( index = -1 ) [来源] #

默认删除最后一个标签，但可以提供任何索引

print_label ( linecontour , labelwidth ) [来源] #

返回轮廓是否足够长以容纳标签。

set_label_props ( label , text , color ) [source] #

设置标签属性 - 颜色、字体大小、文本。

too_close ( x , y , lw ) [来源] #

返回标签是否已经在此位置附近。

类 matplotlib.contour。ContourSet ( ax , * args , levels = None , Filled = False , linewidths = None , linestyles = None , hashes = (None,) , alpha = None , origin = None , extent = None , cmap = None , colors = None ,规范=None , vmin = None , vmax = None , extend = 'neither' , antialiased = None , nchunk = 0 , locator = None , transform = None , negative_linestyles = None , ** kwargs ) [来源] #

基地：ScalarMappable，ContourLabeler

存储一组等高线或填充区域。

用户可调用方法：clabel

参数：
斧头Axes
级别[level0, level1, ..., leveln]

指示轮廓级别的浮点数列表。

allsegs [level0segs, level1segs, ...]

所有级别的所有多边形段的列表。对于等高线和填充等高线区域。列表应该看起来像len(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]
allkindsNone或 [level0kinds, level1kinds, ...]

所有多边形顶点类型（代码类型）的可选列表，如路径中所述和使用。这用于允许多重连接的路径，例如填充多边形内的孔。如果没有None，. 列表应该看起来像len(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

如果allkinds不是None，则通常将特定轮廓级别的所有多边形组合在一起，以便 和。level0segs = [polygon0]level0kinds = [polygon0kinds]

**kwargs

关键字参数如 contour.

属性：
斧头Axes

绘制轮廓的 Axes 对象。

s的集合silent_listPathCollection

Artists 代表轮廓。这是 PathCollection线条和填充轮廓的 s 列表。

级别数组

等高线水平的值。

层数组

与线轮廓的水平相同；填充轮廓的水平之间的一半。见ContourSet._process_colors。

绘制轮廓线或填充区域，取决于关键字 arg填充是False（默认）还是True.

来电签名：

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)
参数：
斧头Axes

Axes要绘制的对象。

级别[level0, level1, ..., leveln]

指示轮廓级别的浮点数列表。

allsegs [level0segs, level1segs, ...]

所有级别的所有多边形段的列表。对于等高线和填充等高线区域。列表应该看起来像len(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]
allkinds [level0kinds, level1kinds, ...], 可选

所有多边形顶点类型（代码类型）的可选列表，如路径中所述和使用。这用于允许多重连接的路径，例如填充多边形内的孔。如果没有None，. 列表应该看起来像len(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

如果allkinds不是None，则通常将特定轮廓级别的所有多边形组合在一起，以便 和。level0segs = [polygon0]level0kinds = [polygon0kinds]

**kwargs

关键字参数如 contour.

已更改( ) [来源] #

每当可映射对象更改时调用此函数，以通知所有 callbackSM 侦听器“已更改”信号。

find_nearest_contour ( x , y , indices = None , pixel = True ) [source] #

在等高线图中找到最接近 的点。(x, y)

此方法不支持填充轮廓。

参数：
x, y浮动

参考点。

int 或 None 的索引列表，默认值：None

要考虑的等高线水平指数。如果无（默认值），则考虑所有级别。

像素布尔值，默认值：True

如果为True，则测量像素（屏幕）空间中的距离，这对于手动轮廓标注很有用；否则，测量轴空间中的距离。

返回：
轮廓Collection

最接近的轮廓。(x, y)

分段整数

最接近 的Pathin等高线的索引。(x, y)

索引整数

段中最接近 的路径段的索引。(x, y)

xmin, ymin浮点数

等高线图中最接近 的点。(x, y)

d2浮动

从到的平方距离。(xmin, ymin)(x, y)

get_alpha ( ) [来源] #

返回要应用于所有 ContourSet 艺术家的 alpha。

get_transform ( ) [来源] #

返回Transform此 ContourSet 使用的实例。

legend_elements ( variable_name='x' , str_format=<class 'str'> ) [source] #

legend返回代表此 ContourSet的适合传递的艺术家和标签列表。

标签的格式为“0 < x <= 1”，说明艺术家所代表的数据范围。

参数：
变量名 str

标签上使用的不等式内使用的字符串。

str_format函数：float -> str

用于格式化标签中数字的函数。

返回：
艺术家名单[ Artist]

艺术家名单。

标签列表[str]

标签列表。

set_alpha ( alpha ) [来源] #

为所有 ContourSet 艺术家设置 alpha 混合值。 alpha必须介于 0（透明）和 1（不透明）之间。

类 matplotlib.contour。QuadContourSet ( ax , * args , levels = None , filled = False , linewidths = None , linestyles = None , hashes = (None,) , alpha = None , origin = None , extent = None , cmap = None , colors = None ,规范=None , vmin = None , vmax = None , extend = 'neither' , antialiased = None , nchunk = 0 , locator = None , transform = None , negative_linestyles = None , ** kwargs ) [来源] #

基地：ContourSet

创建并存储一组轮廓线或填充区域。

此类通常不是由用户直接实例化，而是由 contourand实例化contourf。

属性：
斧头Axes

绘制轮廓的 Axes 对象。

s的集合silent_listPathCollection

Artists 代表轮廓。这是 PathCollection线条和填充轮廓的 s 列表。

级别数组

等高线水平的值。

层数组

与线轮廓的水平相同；填充轮廓的水平之间的一半。见ContourSet._process_colors。

绘制轮廓线或填充区域，取决于关键字 arg填充是False（默认）还是True.

来电签名：

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)
参数：
斧头Axes

Axes要绘制的对象。

级别[level0, level1, ..., leveln]

指示轮廓级别的浮点数列表。

allsegs [level0segs, level1segs, ...]

所有级别的所有多边形段的列表。对于等高线和填充等高线区域。列表应该看起来像len(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]
allkinds [level0kinds, level1kinds, ...], 可选

所有多边形顶点类型（代码类型）的可选列表，如路径中所述和使用。这用于允许多重连接的路径，例如填充多边形内的孔。如果没有None，. 列表应该看起来像len(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

如果allkinds不是None，则通常将特定轮廓级别的所有多边形组合在一起，以便 和。level0segs = [polygon0]level0kinds = [polygon0kinds]

**kwargs

关键字参数如 contour.