轮廓

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 .

有效Kwargs是

财产	描述
agg_filter	一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha	浮动
animated	布尔
backgroundcolor	颜色
bbox	带有属性的dict patches.FancyBboxPatch
clip_box	matplotlib.transforms.Bbox
clip_on	布尔
clip_path	{ (path.Path, transforms.Transform), patches.Patch, None }
color	颜色
contains	可赎回的
figure	Figure
fontfamily	fontname，'serif'、'sans-serif'、'cursive'、'fantasy'、'monospace'
fontname	fontname，'serif'、'sans-serif'、'cursive'、'fantasy'、'monospace'
fontproperties	font_manager.FontProperties
fontsize	以点为单位的大小，'x x small'、'x-small'、'small'、'medium'、'large'、'x-large'、'x x 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	无或bool或float或callable
position	（浮标，浮标）
rasterized	布尔或无
rotation	角度（度）、“垂直”、“水平”
rotation_mode	无，'默认值'，'定位点'
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
text	可转换为字符串的字符串或对象（但 None 变成 '' ）
transform	Transform
url	STR
usetex	布尔或无
verticalalignment	‘中心’、‘顶部’、‘底部’、‘基线’、‘中心基线’；
visible	布尔
wrap	布尔
x	浮动
y	浮动
zorder	浮动

get_rotation()[源代码]¶

返回以度为单位的浮动文本角度。

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 : 浮动 标签的大致位置。 内联的 : bool，可选，默认值：true 如果 True 删除标签下的轮廓段。 inline_spacing : int，可选，默认值：5 以像素为单位的空间，放置在内嵌时留在标签的每一侧。对于轮廓笔直的位置的标签，此间距精确，而对于曲线轮廓上的标签，此间距较小。

calc_label_rot_and_inline(slc, ind, lw, lc=None, spacing=5)[源代码]¶

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

如果 lc 不为空（如果没有，LC默认为空列表）。 间距 标签周围以像素为单位的空白。

同时执行这两个任务以避免多次计算路径长度，这是相对昂贵的。

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

cl¶

3.0 版后已移除: Matplotlib 3.0中不推荐使用<lambda>函数，将在3.2中删除该函数。改用labeltexts。

cl_cvalues¶

3.0 版后已移除: Matplotlib 3.0中不推荐使用<lambda>函数，将在3.2中删除该函数。请改用labelcValues。

cl_xy¶

3.0 版后已移除: Matplotlib 3.0中不推荐使用<lambda>函数，将在3.2中删除该函数。改用labelxys。

clabel(*args, fontsize=None, inline=True, inline_spacing=5, fmt='%1.3f', colors=None, use_clabeltext=False, manual=False, rightside_up=True)[源代码]¶

标记轮廓图。

呼叫签名：

clabel(cs, [levels,] **kwargs)

将标签添加到线条轮廓中 cs 在哪里 cs 是一个 ContourSet 对象返回者 contour() .

参数:

cs ： ContourSet : ContourSet 要标注的轮廓线。 水平 : 类似数组，可选 应标记的级别值列表。列表必须是 cs.levels . 如果没有给出，所有级别都会被标记。 字体大小 : 字符串或浮点，可选 以点或相对大小表示的大小，例如“较小”、“x-large”。见 Text.set_size 对于接受的字符串值。 colors : 颜色规格，可选 标签颜色： 如果 None ，每个标签的颜色与对应轮廓的颜色匹配。 如果一个字符串颜色，例如， ** =“R”或 ** ='红色'，所有标签将以该颜色打印。 如果matplotlib颜色参数的元组（字符串、浮点、RGB等），则不同的标签将按指定的顺序以不同的颜色打印。 内联的 : 可选的布尔 如果 True 在放置标签的位置删除基础轮廓。默认是 True . inline_spacing : 可选浮动 以像素为单位的空间，放置在内嵌时留在标签的每一侧。默认值为5。 对于轮廓笔直的位置的标签，此间距精确，而对于曲线轮廓上的标签，此间距较小。 fmt : 字符串或dict，可选 标签的格式字符串。默认值为“%1.3f” 或者，这可以是一个字典，用任意字符串匹配每个轮廓级别（即，fmt [水平] =string），或者它可以是任何可调用的，例如 Formatter 实例，使用数字轮廓级别调用时返回字符串。 手册 : bool或iterable，可选 如果 True ，轮廓标签将使用鼠标单击手动放置。单击轮廓附近的第一个按钮以添加标签，单击第二个按钮（或可能同时单击两个鼠标按钮）以完成添加标签。第三个按钮可用于删除最后添加的标签，但仅当标签不是内联的时候。或者，键盘可用于选择标签位置（输入到结束标签位置、删除或退格操作与第三个鼠标按钮类似，任何其他键都将选择标签位置）。 手册 也可以是x，y元组的不可重复对象。创建轮廓标签时，就像在每个X、Y位置单击鼠标一样。 rightside_up : 可选的布尔 如果 True ，标签旋转将始终与水平面呈正负90度。默认是 True . use_clabeltext : 可选的布尔 如果 True ， ClabelText 类（而不是 Text ）用于创建标签。 ClabelText 在绘制期间重新计算文本的旋转角度，因此，如果轴的方面发生更改，则可以使用此方法。默认是 False .

返回:

标签 列表 Text 标签的实例。

get_label_coords(distances, XX, YY, ysize, lw)[源代码]¶

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

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

get_label_width(lev, fmt, fsize)[源代码]¶

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

get_real_label_width(lev, fmt, fsize)[源代码]¶

2.2 版后已移除: get real_label_width函数在matplotlib 2.2中已弃用，将在3.1中删除。

这将计算屏幕上的实际标签宽度。这使用一些黑色魔术来确定屏幕上未绘制标签的范围。这种魔力可能不是很强大。

此方法未被使用，可以修改或删除。

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, alpha=None, origin=None, extent=None, cmap=None, colors=None, norm=None, vmin=None, vmax=None, extend='neither', antialiased=None, **kwargs)[源代码]¶

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

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

用户可调用方法： clabel

参数:

ax ： Axes : 轴线 水平 : [0级，1级，…，1级] 指示轮廓级别的浮点数列表。 阿勒格斯 : [等级0段，等级1段，…] 所有多边形段的列表 水平 . 用于轮廓线 len(allsegs) == len(levels) ，对于填充的轮廓区域 len(allsegs) = len(levels)-1 . 列表应如下所示： level0segs = [polygon0, polygon1, ...] polygon0 = array_like [[x0,y0], [x1,y1], ...] 各种类型 ： None 或 [等级0，等级1，种类，…] : 无或 [等级0，等级1，种类，…] 路径中描述和使用的所有多边形顶点类型（代码类型）的可选列表。这用于允许多重连接路径，如填充多边形中的孔。如果没有 None ， len(allkinds) == len(allsegs) . 列表应如下所示： level0kinds = [polygon0kinds, ...] polygon0kinds = [vertexcode0, vertexcode1, ...] 如果 各种类型 不是 None ，通常将特定轮廓级别的所有多边形组合在一起，以便 level0segs = [polygon0] 和 level0kinds = [polygon0kinds] . 克沃斯： 关键字参数如 contour .

属性:

ax: 绘制轮廓的轴对象。 收藏： 一个无声的线条集合或多集合列表。 水平： 轮廓水平。 层： 与线轮廓的级别相同；填充轮廓的级别之间的中间。见 _process_colors() .

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

呼叫签名：

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

参数:

ax : 这个 Axes 要绘制的对象。 水平 : [0级，1级，…，1级] 指示轮廓级别的浮点数列表。 阿勒格斯 : [等级0段，等级1段，…] 所有多边形段的列表 水平 . 用于轮廓线 len(allsegs) == len(levels) ，对于填充的轮廓区域 len(allsegs) = len(levels)-1 . 列表应如下所示： level0segs = [polygon0, polygon1, ...] polygon0 = array_like [[x0,y0], [x1,y1], ...] 各种类型 : [等级0，等级1，种类，…] 可选 路径中描述和使用的所有多边形顶点类型（代码类型）的可选列表。这用于允许多重连接路径，如填充多边形中的孔。如果没有 None ， len(allkinds) == len(allsegs) . 列表应如下所示： level0kinds = [polygon0kinds, ...] polygon0kinds = [vertexcode0, vertexcode1, ...] 如果 各种类型 不是 None ，通常将特定轮廓级别的所有多边形组合在一起，以便 level0segs = [polygon0] 和 level0kinds = [polygon0kinds] . **kwargs 关键字参数如 contour .

changed()[源代码]¶

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

find_nearest_contour(x, y, indices=None, pixel=True)[源代码]¶

查找最接近点的轮廓。默认为以像素为单位测量距离（屏幕空间-用于手动轮廓标记），但可以通过关键字参数进行控制。

返回一个包含轮廓、段、段索引、段点X&Y和到最小点的距离的元组。

可选关键字参数：

指数 ：

查找最近点时要考虑的轮廓级别索引。默认为使用所有级别。

象素 ：

如果 True ，以像素空间测量距离，如果不是，则以轴空间测量距离。默认为 True .

get_alpha()[源代码]¶

返回要应用于所有轮廓线艺术家的alpha

get_transform()[源代码]¶

返回 Transform 此Contourset使用的实例。

legend_elements(variable_name='x', str_format=<class 'str'>)[源代码]¶

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

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

参数:	variable_name : STR 在标签上使用的不等式内部使用的字符串。 str_format : 函数：float->str 用于设置标签中数字格式的函数。
返回:	艺术家 名单 [Artist] : 表 [艺术家] 艺术家名单。 标签 : 表 [str] 标签列表。

set_alpha(alpha)[源代码]¶

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

class matplotlib.contour.QuadContourSet(ax, *args, levels=None, filled=False, linewidths=None, linestyles=None, alpha=None, origin=None, extent=None, cmap=None, colors=None, norm=None, vmin=None, vmax=None, extend='neither', antialiased=None, **kwargs)[源代码]¶

基类：matplotlib.contour.ContourSet

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

用户可调用方法： clabel

属性:	ax: 绘制轮廓的轴对象。 收藏： 一个无声的线条集合或多集合列表。 水平： 轮廓水平。 层： 与线轮廓的级别相同；填充轮廓的级别之间的中间。见 _process_colors() 方法。

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

呼叫签名：

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

参数:

ax : 这个 Axes 要绘制的对象。 水平 : [0级，1级，…，1级] 指示轮廓级别的浮点数列表。 阿勒格斯 : [等级0段，等级1段，…] 所有多边形段的列表 水平 . 用于轮廓线 len(allsegs) == len(levels) ，对于填充的轮廓区域 len(allsegs) = len(levels)-1 . 列表应如下所示： level0segs = [polygon0, polygon1, ...] polygon0 = array_like [[x0,y0], [x1,y1], ...] 各种类型 : [等级0，等级1，种类，…] 可选 路径中描述和使用的所有多边形顶点类型（代码类型）的可选列表。这用于允许多重连接路径，如填充多边形中的孔。如果没有 None ， len(allkinds) == len(allsegs) . 列表应如下所示： level0kinds = [polygon0kinds, ...] polygon0kinds = [vertexcode0, vertexcode1, ...] 如果 各种类型 不是 None ，通常将特定轮廓级别的所有多边形组合在一起，以便 level0segs = [polygon0] 和 level0kinds = [polygon0kinds] . **kwargs 关键字参数如 contour .