matplotlib.contour

类以支持轴类的等高线打印和标记。

class matplotlib.contour.ClabelText(x=0, y=0, text='', color=None, verticalalignment='baseline', horizontalalignment='left', multialignment=None, fontproperties=None, rotation=None, linespacing=None, rotation_mode=None, usetex=None, wrap=False, **kwargs)

基类：matplotlib.text.Text

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

创建一个 Text 实例在 x ， y 带弦 text .

有效的关键字参数为：

财产	描述
agg_filter	一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha	浮动或无
animated	布尔
backgroundcolor	颜色
bbox	带有属性的dict patches.FancyBboxPatch
clip_box	Bbox
clip_on	布尔
clip_path	面片或（路径、变换）或无
color 或c	颜色
contains	未知的
figure	Figure
fontfamily 或是家人	fontname，'serif'、'sans-serif'、'cursive'、'fantasy'、'monospace'
fontproperties 或字体或字体属性	font_manager.FontProperties or str or pathlib.Path
fontsize 或大小	浮点或{'xx-small'、'x-small'、'small'、'medium'、'large'、'x-large'、'xx-large'}
fontstretch 或者伸展	范围0-1000内的数值，'ultra condensed'、'extra condensed'、'condensed'、'semi condensed'、'normal'、'semi expanded'、'expanded'、'extra expanded'、'extra expanded'、'extra expanded'、'extra exp
fontstyle 或风格	'正常'、'斜体'、'斜体'
fontvariant 或变体	“普通”、“小大写”
fontweight 或重量	范围为0-1000、'ultralight'、'light'、'normal'、'regular'、'book'、'medium'、'roman'、'semibold'、'demi bold'、'demi'、'bold'、'heavy'、'extra bold'、'black'的数值。
gid	STR
horizontalalignment 或者哈	“居中”、“右”、“左”
in_layout	布尔
label	对象
linespacing	浮动（字体大小的倍数）
multialignment 或者妈妈	'左'、'右'、'中'
path_effects	AbstractPathEffect
picker	无、布尔或可呼叫
position	（浮标，浮标）
rasterized	布尔或无
rotation	浮动或{'vertical'，'horizontal'}
rotation_mode	无，'默认值'，'定位点'
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
text	对象
transform	Transform
url	STR
usetex	布尔或无
verticalalignment 或者弗吉尼亚	‘中心’、‘顶部’、‘底部’、‘基线’、‘中心基线’；
visible	布尔
wrap	布尔
x	浮动
y	浮动
zorder	浮动

get_rotation()

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

class matplotlib.contour.ContourLabeler

基类：object

混合提供标签功能 ContourSet .

add_label(x, y, rotation, lev, cvalue)

使用添加轮廓标签 Text 班级。

add_label_clabeltext(x, y, rotation, lev, cvalue)

使用添加轮廓标签 ClabelText 班级。

add_label_near(x, y, inline=True, inline_spacing=5, transform=None)

在点（x，y）附近添加标签。如果transform为none（默认），（x，y）在数据坐标中；如果transform为false，（x，y）在显示坐标中；否则，将使用指定的转换将（x，y）转换为显示坐标。

参数:

x, y浮动

标签的大致位置。

inlinebool，默认值：True

如果 True 删除标签下的轮廓段。

inline_spacingint，默认值：5

以像素为单位的空间，放置在内嵌时留在标签的每一侧。对于轮廓笔直的位置的标签，此间距精确，而对于曲线轮廓上的标签，此间距较小。

calc_label_rot_and_inline(slc, ind, lw, lc=None, spacing=5)

根据屏幕单位中的线条轮廓坐标、标签位置索引和标签宽度，计算适当的标签旋转。

如果 lc 不是无或空，也可以打断轮廓并计算内联。

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

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

这里使用的方法包括在像素坐标中计算沿轮廓的路径长度，然后从中心点看大约（标签宽度/2）以确定旋转，然后根据需要打断轮廓。

clabel(levels=None, *, fontsize=None, inline=True, inline_spacing=5, fmt='%1.3f', colors=None, use_clabeltext=False, manual=False, rightside_up=True, zorder=None)

标记轮廓图。

此线条中的标签添加到等高线 ContourSet （继承自这个mixin类）。

参数:

levels类似数组，可选

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

字体大小 : str or float, default: rcParams["font.size"] (default: 10.0)浮动或默认值：

以点或相对大小表示的大小，例如“较小”、“x-large”。见 Text.set_size 对于接受的字符串值。

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

标签颜色：

• 如果 None ，每个标签的颜色与对应轮廓的颜色匹配。
• 如果一个字符串颜色，例如， ** =“R”或 ** ='红色'，所有标签将以该颜色打印。
• 如果一组颜色（字符串、浮点、rgb等），不同的标签将按指定的顺序以不同的颜色打印。

inlinebool，默认值：True

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

inline_spacing浮动，默认值：5

以像素为单位的空间，用于在内联放置时保留在标签的每一侧。

对于轮廓笔直的位置的标签，此间距精确，而对于曲线轮廓上的标签，此间距较小。

fmtstr或dict，默认值：'%1.3f'

标签的格式字符串。

或者，这可以是一个字典，用任意字符串匹配每个轮廓级别（即，fmt [水平] =string），或者它可以是任何可调用的，例如 Formatter 实例，使用数字轮廓级别调用时返回字符串。

manualbool或iterable，默认值：False

如果 True ，轮廓标签将使用鼠标单击手动放置。单击轮廓附近的第一个按钮以添加标签，单击第二个按钮（或可能同时单击两个鼠标按钮）以完成添加标签。第三个按钮可用于删除最后添加的标签，但仅当标签不是内联的时候。或者，键盘可用于选择标签位置（输入到结束标签位置、删除或退格操作与第三个鼠标按钮类似，任何其他键都将选择标签位置）。

手册 也可以是（x，y）元组的iterable对象。轮廓标签将被创建，就像在每个（x，y）位置单击鼠标一样。

rightside_upbool，默认值：True

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

use_clabeltextbool，默认值：False

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

Z阶 ：float或None，默认值： (2 + contour.get_zorder())浮动或无，默认值：

等高线标签的顺序。

返回:

标签

列表 Text 标签的实例。

get_label_coords(distances, XX, YY, ysize, lw)

返回X、Y和标签位置的索引。

在轮廓与直线偏差最小的位置绘制标签，除非附近有另一个标签，在这种情况下，会拾取轮廓上的下一个最佳位置。如果所有这些候选对象都被拒绝，则选择轮廓的开始。

get_label_width(lev, fmt, fsize)

返回标签的宽度（以点为单位）。

get_text(lev, fmt)

获取标签的文本。

labels(inline, inline_spacing)

locate_label(linecontour, labelwidth)

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

pop_label(index=- 1)

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

print_label(linecontour, labelwidth)

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

set_label_props(label, text, color)

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

too_close(x, y, lw)

返回 True 如果标签已经靠近此位置。

class matplotlib.contour.ContourSet(ax, *args, levels=None, filled=False, linewidths=None, linestyles=None, hatches=(None), alpha=None, origin=None, extent=None, cmap=None, colors=None, norm=None, vmin=None, vmax=None, extend='neither', antialiased=None, nchunk=0, locator=None, transform=None, **kwargs)

基类：matplotlib.cm.ScalarMappable, matplotlib.contour.ContourLabeler

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

用户可调用方法： clabel

参数:

ax ： Axes轴线

levels[0级，1级，…，1级]

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

allsegs[等级0段，等级1段，…]

所有多边形段的列表 水平 . 用于轮廓线 len(allsegs) == len(levels) ，对于填充的轮廓区域 len(allsegs) = len(levels)-1 . 列表应该如下所示：

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

各种类型 ： None 或 [等级0，等级1，种类，…]无或 [等级0，等级1，种类，…]

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

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

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

**kwargs

关键字参数如 contour .

属性:

ax

绘制轮廓的轴对象。

collections

一个无声的线条集合或多集合列表。

levels

轮廓水平。

layers

与线轮廓的级别相同；填充轮廓的级别之间的中间。见 _process_colors() .

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

呼叫签名：

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)

参数:

ax ： Axes轴线

这个 Axes 要绘制的对象。

levels[0级，1级，…，1级]

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

allsegs[等级0段，等级1段，…]

所有多边形段的列表 水平 . 用于轮廓线 len(allsegs) == len(levels) ，对于填充的轮廓区域 len(allsegs) = len(levels)-1 . 列表应该如下所示：

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

allkinds[等级0，等级1，种类，…] 可选

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

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

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

**kwargs

关键字参数如 contour .

property ax

changed()

每当mappable被更改时调用此函数，以将“changed”信号通知所有callbackSM侦听器。

find_nearest_contour(x, y, indices=None, pixel=True)

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

参数:

x、 y:浮动

参考点。

indicesint或None列表，默认值：None

考虑轮廓水平的指标。如果没有（默认值），则考虑所有级别。

pixelbool，默认值：True

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

返回:

轮廓 ： CollectionCollection

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

segment利息

的索引 Path 在里面 轮廓 最接近 (x, y) .

index利息

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

xmin、ymin浮动

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

d浮动

距离 (xmin, ymin) 到 (x, y) .

get_alpha()

返回alpha以应用于所有轮廓集艺术家。

get_transform()

返回 Transform 此Contourset使用的实例。

legend_elements(variable_name='x', str_format=<class 'str'>)

返回适合传递到的艺术家和标签列表 legend 它代表了这个轮廓。

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

参数:

variable_nameSTR

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

str_format函数：float->str

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

返回:

艺术家 名单 [Artist]列表[

艺术家名单。

labels表 [str]

标签列表。

set_alpha(alpha)

为所有轮廓集艺术家设置alpha混合值。 阿尔法 必须介于0（透明）和1（不透明）之间。

class matplotlib.contour.QuadContourSet(ax, *args, levels=None, filled=False, linewidths=None, linestyles=None, hatches=(None), alpha=None, origin=None, extent=None, cmap=None, colors=None, norm=None, vmin=None, vmax=None, extend='neither', antialiased=None, nchunk=0, locator=None, transform=None, **kwargs)

基类：matplotlib.contour.ContourSet

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

用户可调用方法： clabel

属性:

ax

绘制轮廓的轴对象。

collections

一个无声的线条集合或多集合列表。

levels

轮廓水平。

layers

与线轮廓的级别相同；填充轮廓的级别之间的中间。见 _process_colors() 方法。

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

呼叫签名：

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)

参数:

ax ： Axes轴线

这个 Axes 要绘制的对象。

levels[0级，1级，…，1级]

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

allsegs[等级0段，等级1段，…]

所有多边形段的列表 水平 . 用于轮廓线 len(allsegs) == len(levels) ，对于填充的轮廓区域 len(allsegs) = len(levels)-1 . 列表应该如下所示：

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

allkinds[等级0，等级1，种类，…] 可选

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

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

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

**kwargs

关键字参数如 contour .