matplotlib.axes

继承

轴类

类 matplotlib.axes。轴（fig， rect， *， facecolor = None， frameon = True， sharex = None， sharey = None， label = ''， xscale = None， yscale = None， box_aspect = None， ** kwargs）

基地：_AxesBase

Axes包含大部分图形元素：、Axis、 Tick、Line2D、等，并设置坐标系Text。Polygon

该Axes实例通过作为实例的回调属性支持回调CallbackRegistry。您可以连接到的事件是 'xlim_changed' 和 'ylim_changed'，回调将使用 func( ax ) 调用，其中ax是Axes实例。

属性：

数据林Bbox

包围轴中显示的所有数据的边界框。

视界Bbox

数据坐标中的视图限制。

在图中构建一个轴。

参数：

图Figure

轴建在图中。Figure

矩形元组（左、下、宽、高）。

Axes 建在矩形rect中。rect在 Figure坐标中。

sharex，sharey Axes，可选

x 或 yaxis与 input 中的 x 或 y 轴共享Axes。

frameon布尔值，默认值：True

Axes 框架是否可见。

box_aspect浮动，可选

为 Axes 框设置一个固定的纵横比，即高宽比。详情请参阅set_box_aspect。

**kwargs

其他可选关键字参数：

财产	描述
adjustable	{'box', 'datalim'}
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	标量或无
anchor	(float, float) 或 {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	布尔
aspect	{'auto', 'equal'} 或浮动
autoscale_on	布尔
autoscalex_on	未知
autoscaley_on	未知
axes_locator	可调用[[轴，渲染器]，Bbox]
axisbelow	布尔或“线”
box_aspect	浮动或无
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
facecolor或 fc	颜色
figure	Figure
frame_on	布尔
gid	字符串
in_layout	布尔
label	目的
mouseover	布尔
navigate	布尔
navigate_mode	未知
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
position	[左、下、宽、高] 或Bbox
prop_cycle	未知
rasterization_zorder	浮动或无
rasterized	布尔
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
title	字符串
transform	Transform
url	字符串
visible	布尔
xbound	未知
xlabel	字符串
xlim	（底部：浮动，顶部：浮动）
xmargin	浮动大于 -0.5
xscale	未知
xticklabels	未知
xticks	未知
ybound	未知
ylabel	字符串
ylim	（底部：浮动，顶部：浮动）
ymargin	浮动大于 -0.5
yscale	未知
yticklabels	未知
yticks	未知
zorder	漂浮

返回：

Axes

新Axes对象。

子图

SubplotBase	子图的基类，它是Axes具有附加方法的实例，以方便Axes在图形中生成和操作一组。
subplot_class_factory

绘图

基本

Axes.plot	将 y 与 x 绘制为线条和/或标记。
Axes.errorbar	将 y 与 x 绘制为带有附加误差线的线和/或标记。
Axes.scatter	y与y的散点图
Axes.plot_date	[劝阻] 绘制强制轴以将浮点数视为日期。
Axes.step	制作阶梯图。
Axes.loglog	在 x 和 y 轴上绘制对数缩放的图。
Axes.semilogx	在 x 轴上绘制对数缩放的图。
Axes.semilogy	在 y 轴上绘制对数缩放的图。
Axes.fill_between	填充两条水平曲线之间的区域。
Axes.fill_betweenx	填充两条垂直曲线之间的区域。
Axes.bar	制作条形图。
Axes.barh	制作水平条形图。
Axes.bar_label	标记条形图。
Axes.stem	创建一个茎图。
Axes.eventplot	在给定位置绘制相同的平行线。
Axes.pie	绘制饼图。
Axes.stackplot	绘制堆积面积图。
Axes.broken_barh	绘制矩形的水平序列。
Axes.vlines	在每个x处绘制从ymin到ymax的垂直线。
Axes.hlines	在从xmin到xmax的每个y处绘制水平线。
Axes.fill	绘制填充多边形。

跨度

Axes.axhline	在轴上添加一条水平线。
Axes.axhspan	在轴上添加一个水平跨度（矩形）。
Axes.axvline	在轴上添加一条垂直线。
Axes.axvspan	在轴上添加一个垂直跨度（矩形）。
Axes.axline	添加一条无限长的直线。

光谱

Axes.acorr	绘制x的自相关。
Axes.angle_spectrum	绘制角度谱。
Axes.cohere	绘制x和y之间的相干性。
Axes.csd	绘制交叉光谱密度。
Axes.magnitude_spectrum	绘制幅度谱。
Axes.phase_spectrum	绘制相位谱。
Axes.psd	绘制功率谱密度。
Axes.specgram	绘制频谱图。
Axes.xcorr	绘制x和y之间的互相关。

统计

Axes.boxplot	绘制箱须图。
Axes.violinplot	制作小提琴情节。
Axes.violin	小提琴绘图的绘图功能。
Axes.bxp	箱线图和须线图的绘图功能。

分箱

Axes.hexbin	制作点x和y的二维六边形分箱图。
Axes.hist	计算并绘制直方图。
Axes.hist2d	制作二维直方图。
Axes.stairs	逐步常数函数作为具有边界的线或填充图。

轮廓

Axes.clabel	标记等高线图。
Axes.contour	绘制等高线。
Axes.contourf	绘制填充轮廓。

二维数组

Axes.imshow	将数据显示为图像，即在 2D 常规栅格上。
Axes.matshow	将二维矩阵或数组的值绘制为彩色编码图像。
Axes.pcolor	使用非常规矩形网格创建伪彩色图。
Axes.pcolorfast	使用非常规矩形网格创建伪彩色图。
Axes.pcolormesh	使用非常规矩形网格创建伪彩色图。
Axes.spy	绘制二维数组的稀疏模式。

非结构化三角形

Axes.tripcolor	创建非结构化三角形网格的伪彩色图。
Axes.triplot	绘制一个非结构化的三角形网格作为线条和/或标记。
Axes.tricontour	在非结构化三角形网格上绘制等高线。
Axes.tricontourf	在非结构化三角形网格上绘制轮廓区域。

文本和注释

Axes.annotate	用文本text注释点xy。
Axes.text	将文本添加到轴。
Axes.table	将表添加到Axes.
Axes.arrow	在轴上添加一个箭头。
Axes.inset_axes	将子插入轴添加到此现有轴。
Axes.indicate_inset	向轴添加一个插入指示器。
Axes.indicate_inset_zoom	根据inset_ax的轴限制向轴添加一个插入指示矩形，并在inset_ax和矩形之间绘制连接器。
Axes.secondary_xaxis	向此轴添加第二个 x 轴。
Axes.secondary_yaxis	向此轴添加第二个 y 轴。

向量场

Axes.barbs	绘制一个 2D 倒钩场。
Axes.quiver	绘制一个二维箭头场。
Axes.quiverkey	为箭袋图添加一个键。
Axes.streamplot	绘制矢量流的流线。

清算

Axes.cla	清除轴。
Axes.clear	清除轴。

外观

Axes.axis	获取或设置某些轴属性的便捷方法。
Axes.set_axis_off	关闭 x 轴和 y 轴。
Axes.set_axis_on	打开 x 轴和 y 轴。
Axes.set_frame_on	设置是否绘制 Axes 矩形补丁。
Axes.get_frame_on	获取是否绘制了 Axes 矩形补丁。
Axes.set_axisbelow	设置轴刻度和网格线是高于还是低于大多数艺术家。
Axes.get_axisbelow	获取轴刻度和网格线是高于还是低于大多数艺术家。
Axes.grid	配置网格线。
Axes.get_facecolor	获取 Axes 的 facecolor。
Axes.set_facecolor	设置 Axes 的 facecolor。

属性周期

Axes.set_prop_cycle

设置轴的属性循环。

轴/限制

Axes.get_xaxis	[劝阻] 返回 XAxis 实例。
Axes.get_yaxis	[劝阻] 返回 YAxis 实例。

轴范围和方向

Axes.invert_xaxis	反转 x 轴。
Axes.xaxis_inverted	返回 xaxis 是否朝向“反向”方向。
Axes.invert_yaxis	反转 y 轴。
Axes.yaxis_inverted	返回 y 轴是否朝向“反向”方向。
Axes.set_xlim	设置 x 轴视图限制。
Axes.get_xlim	返回 x 轴视图范围。
Axes.set_ylim	设置 y 轴视图范围。
Axes.get_ylim	返回 y 轴视图范围。
Axes.update_datalim	扩展dataLimBbox 以包含给定的点。
Axes.set_xbound	设置 x 轴的数值下限和上限。
Axes.get_xbound	按升序返回 x 轴上下界。
Axes.set_ybound	设置 y 轴的数值下限和上限。
Axes.get_ybound	按升序返回 y 轴上下界。

轴标签、标题和图例

Axes.set_xlabel	设置 x 轴的标签。
Axes.get_xlabel	获取 xlabel 文本字符串。
Axes.set_ylabel	设置 y 轴的标签。
Axes.get_ylabel	获取 ylabel 文本字符串。
Axes.set_title	为轴设置标题。
Axes.get_title	获取轴标题。
Axes.legend	在轴上放置一个图例。
Axes.get_legend	返回Legend实例，如果没有定义图例，则返回 None。
Axes.get_legend_handles_labels	返回图例的句柄和标签

轴刻度

Axes.set_xscale	设置 xaxis 的比例。
Axes.get_xscale	返回 xaxis 的比例（作为 str）。
Axes.set_yscale	设置y轴的比例。
Axes.get_yscale	返回 yaxis 的比例（作为 str）。

自动缩放和边距

Axes.use_sticky_edges	自动缩放时，是否服从 all Artist.sticky_edges。
Axes.margins	设置或检索自动缩放边距。
Axes.set_xmargin	在自动缩放之前设置 X 数据限制的填充。
Axes.set_ymargin	在自动缩放之前设置 Y 数据限制的填充。
Axes.relim	根据当前艺术家重新计算数据限制。
Axes.autoscale	将轴视图自动缩放到数据（切换）。
Axes.autoscale_view	使用数据限制自动缩放视图限制。
Axes.set_autoscale_on	设置是否在下一次绘制或调用时将自动缩放应用于每个轴Axes.autoscale_view。
Axes.get_autoscale_on	如果每个轴都自动缩放，则返回 True，否则返回 False。
Axes.set_autoscalex_on	设置绘制时是否自动缩放 xaxis 或按Axes.autoscale_view.
Axes.get_autoscalex_on	返回 xaxis 是否自动缩放。
Axes.set_autoscaley_on	设置绘制时是否自动缩放 y 轴或按Axes.autoscale_view.
Axes.get_autoscaley_on	返回 yaxis 是否自动缩放。

纵横比

Axes.apply_aspect	为指定的数据纵横比调整轴。
Axes.set_aspect	设置轴缩放的纵横比，即y/x-scale。
Axes.get_aspect	返回轴缩放的纵横比。
Axes.set_box_aspect	设置轴箱纵横比，即高宽比。
Axes.get_box_aspect	返回轴箱纵横比，即高宽比。
Axes.set_adjustable	设置轴如何调整以实现所需的纵横比。
Axes.get_adjustable	返回轴是否将调整其物理尺寸（'box'）或其数据限制（'datalim'）以实现所需的纵横比。

刻度和刻度标签

Axes.set_xticks	设置 xaxis 的刻度位置和可选的标签。
Axes.get_xticks	在数据坐标中返回 xaxis 的刻度位置。
Axes.set_xticklabels	使用字符串标签列表设置 xaxis 的标签。
Axes.get_xticklabels	获取 xaxis 的刻度标签。
Axes.get_xmajorticklabels	返回 xaxis 的主要刻度标签，作为Text.
Axes.get_xminorticklabels	返回 xaxis 的次要刻度标签，作为Text.
Axes.get_xgridlines	将 xaxis 的网格线作为Line2Ds 的列表返回。
Axes.get_xticklines	将 xaxis 的刻度线作为Line2Ds 列表返回。
Axes.xaxis_date	设置轴刻度和标签以将沿 xaxis 的数据视为日期。
Axes.set_yticks	设置 yaxis 的刻度位置和可选的标签。
Axes.get_yticks	在数据坐标中返回 yaxis 的刻度位置。
Axes.set_yticklabels	使用字符串标签列表设置 yaxis 的标签。
Axes.get_yticklabels	获取 yaxis 的刻度标签。
Axes.get_ymajorticklabels	返回 yaxis 的主要刻度标签，作为Text.
Axes.get_yminorticklabels	返回 yaxis 的次要刻度标签，作为Text.
Axes.get_ygridlines	将 yaxis 的网格线作为Line2Ds 的列表返回。
Axes.get_yticklines	将 yaxis 的刻度线作为Line2Ds 的列表返回。
Axes.yaxis_date	设置轴刻度和标签以将沿 y 轴的数据视为日期。
Axes.minorticks_off	从轴上删除次要刻度。
Axes.minorticks_on	在轴上显示次要刻度。
Axes.ticklabel_format	配置ScalarFormatter默认使用的线性轴。
Axes.tick_params	更改刻度、刻度标签和网格线的外观。
Axes.locator_params	控制主要刻度定位器的行为。

单位

Axes.convert_xunits	使用 xaxis 的单位类型转换x 。
Axes.convert_yunits	使用 y 轴的单位类型转换y 。
Axes.have_units	返回是否在任何轴上设置单位。

添加艺术家

Axes.add_artist	在轴上添加一个Artist；返回艺术家。
Axes.add_child_axes	AxesBase给 Axes 的孩子添加一个；返回子轴。
Axes.add_collection	在轴上添加一个Collection；返回集合。
Axes.add_container	将 a 添加Container到 Axes 的容器中；返回容器。
Axes.add_image	在轴上添加一个AxesImage；返回图像。
Axes.add_line	在轴上添加一个Line2D；返回线。
Axes.add_patch	在轴上添加一个Patch；返回补丁。
Axes.add_table	在轴上添加一个Table；返回表。

结对和分享

Axes.twinx	创建一个共享 xaxis 的双轴。
Axes.twiny	创建一个共享 y 轴的双轴。
Axes.sharex	与其他人共享 x 轴。
Axes.sharey	与其他人共享 y 轴。
Axes.get_shared_x_axes	返回共享 x 轴 Grouper 上的不可变视图。
Axes.get_shared_y_axes	返回共享 y 轴 Grouper 上的不可变视图。

轴位置

Axes.get_anchor	获取锚点位置。
Axes.set_anchor	定义锚点位置。
Axes.get_axes_locator	返回轴定位器。
Axes.set_axes_locator	设置轴定位器。
Axes.reset_position	将活动位置重置为原始位置。
Axes.get_position	将图中 Axes 的位置返回为 a Bbox。
Axes.set_position	设置轴位置。

基于异步/事件

Axes.stale	艺术家是否“过时”并且需要重新绘制输出以匹配艺术家的内部状态。
Axes.pchanged	调用所有注册的回调。
Axes.add_callback	Artist添加一个回调函数，只要的属性之一发生更改，就会调用该回调函数。
Axes.remove_callback	根据观察者 ID 移除回调。

互动

Axes.can_pan	返回此轴是否支持任何平移/缩放按钮功能。
Axes.can_zoom	返回此轴是否支持缩放框按钮功能。
Axes.get_navigate	获取轴是否响应导航命令。
Axes.set_navigate	设置轴是否响应导航工具栏命令。
Axes.get_navigate_mode	获取导航工具栏按钮状态：“PAN”、“ZOOM”或“无”。
Axes.set_navigate_mode	设置导航工具栏按钮状态。
Axes.start_pan	当平移操作开始时调用。
Axes.drag_pan	在平移操作期间鼠标移动时调用。
Axes.end_pan	当平移操作完成时调用（当鼠标按钮向上时）。
Axes.format_coord	返回格式化x，y坐标的格式字符串。
Axes.format_cursor_data	返回data的字符串表示形式。
Axes.format_xdata	返回x格式化为 x 值。
Axes.format_ydata	返回格式化为 y 值的 y 。
Axes.mouseover	返回当鼠标光标移动到该艺术家上时是否向其查询自定义上下文信息。
Axes.in_axes	返回给定事件（在显示坐标中）是否在轴中。
Axes.contains	测试艺术家是否包含鼠标事件。
Axes.contains_point	返回点（像素坐标对）是否在 Axes 补丁内。
Axes.get_cursor_data	返回给定事件的光标数据。

儿童

Axes.get_children	Artist返回this的子节点列表Artist。
Axes.get_images	返回AxesImageAxes 包含的 s 列表。
Axes.get_lines	返回轴包含的行列表。
Axes.findobj	查找艺术家对象。

绘图

Axes.draw	使用给定的渲染器绘制艺术家（及其子级）。
Axes.draw_artist	有效地重绘单个艺术家。
Axes.redraw_in_frame	有效地重绘 Axes 数据，但不重绘轴刻度、标签等。
Axes.get_renderer_cache	[已弃用]
Axes.get_rasterization_zorder	返回艺术家将被光栅化的 zorder 值。
Axes.set_rasterization_zorder	为矢量图形输出设置光栅化的 zorder 阈值。
Axes.get_window_extent	返回显示空间中的 Axes 边界框；args和kwargs是空的。
Axes.get_tightbbox	返回轴的紧密边界框，包括轴及其装饰器（xlabel、title 等）。

投影

Axis对于非直线轴，必须覆盖其使用的方法。

Axes.name
Axes.get_xaxis_transform	获取用于绘制 x 轴标签、刻度和网格线的转换。
Axes.get_yaxis_transform	获取用于绘制 y 轴标签、刻度和网格线的转换。
Axes.get_data_ratio	返回缩放数据的纵横比。
Axes.get_xaxis_text1_transform	返回：
Axes.get_xaxis_text2_transform	返回：
Axes.get_yaxis_text1_transform	返回：
Axes.get_yaxis_text2_transform	返回：

其他

Axes.zorder
Axes.get_default_bbox_extra_artists	返回用于边界框计算的默认艺术家列表。
Axes.get_transformed_clip_path_and_affine	返回应用了其变换的非仿射部分和其变换的剩余仿射部分的剪辑路径。
Axes.has_data	返回是否已将任何艺术家添加到轴。
Axes.set	一次设置多个属性。

类 matplotlib.axes.Axes。ArtistList（轴， prop_name， add_name， valid_types = None， invalid_types = None）

基于类型的 Axes 子项的子列表。

在 Matplotlib 3.7 中，特定类型的子子列表将变得不可变。然后，这些艺术家列表可能会被元组替换。就好像这已经是一个元组一样使用。

此类仅在过渡期间存在，以警告不推荐修改艺术家列表。

参数：

轴.axes.Axes

该子列表将从中拉出子艺术家的轴。

prop_name str

用于从轴访问此子列表的属性名称；用于生成弃用警告。

add_name str

用于将此子列表类型的艺术家添加到轴的方法名称；用于生成弃用警告。

valid_types类型列表，可选

确定此子列表将返回哪些子项的类型列表。如果指定，则子列表中的艺术家必须是任何这些类型的实例。如果未指定，则任何类型的 Artist 都是有效的（除非受 invalid_types限制。）

invalid_types元组，可选

确定此子列表不会返回哪些子项的类型列表。如果指定，则子列表中的 Artists 将永远不会是这些类型的实例。否则，不会排除任何类型。

插入（索引，项目）

S.insert(index, value) -- 在索引之前插入值