matplotlib.axes

Axes 类表示图中的一个（子）图。它包含绘制的数据、轴刻度、标签、标题、图例等。其方法是操作图的主要接口。

Axes 类

Axes	Axes 对象封装了图形中一个独立（子）图的所有元素。

绘图

基本

Axes.plot	绘制 y 相对于 x 的线条和/或标记。
Axes.errorbar	绘制带有误差线的 y 相对于 x 的线图和/或标记图。
Axes.scatter	散点图 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 的水平线。
Axes.axhspan	在 Axes 上添加一个水平跨度（矩形）。
Axes.axvline	添加一条贯穿整个或部分 Axes 的垂直线。
Axes.axvspan	在Axes上添加一个垂直跨度（矩形）。
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.ecdf	计算并绘制 x 的经验累积分布函数。
Axes.boxplot	绘制一个箱线图。
Axes.violinplot	制作一个小提琴图。
Axes.bxp	从预先计算的统计数据中绘制箱线图。
Axes.violin	从预计算的统计数据中绘制小提琴图。

分箱

Axes.hexbin	绘制点 x, y 的二维六边形分箱图。
Axes.hist	计算并绘制直方图。
Axes.hist2d	制作一个二维直方图。
Axes.stairs	绘制一个分段常数函数作为线条或填充图。

轮廓

Axes.clabel	标注等高线图。
Axes.contour	绘制等高线。
Axes.contourf	绘制填充等高线。

二维数组

Axes.imshow	将数据显示为图像，即在二维规则栅格上。
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 添加文本。
Axes.table	向 Axes 添加一个表格。
Axes.arrow	在 Axes 中添加一个箭头。
Axes.inset_axes	将一个子嵌入的 Axes 添加到现有的 Axes 中。
Axes.indicate_inset	向 Axes 添加一个插入指示器。
Axes.indicate_inset_zoom	根据 inset_ax 的轴限制，在 Axes 中添加一个插入指示矩形，并在 inset_ax 和矩形之间绘制连接器。
Axes.secondary_xaxis	为这个 Axes 添加第二个 x 轴。
Axes.secondary_yaxis	为这个 Axes 添加第二个 y 轴。

矢量场

Axes.barbs	绘制风羽的二维场。
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 的属性循环。

轴 / 限制

Axes.get_xaxis	[不推荐] 返回 XAxis 实例。
Axes.get_yaxis	[不推荐] 返回 YAxis 实例。

轴的限制和方向

Axes.invert_xaxis	反转 x 轴。
Axes.xaxis_inverted	返回 x 轴是否朝“反向”方向。
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	扩展 dataLim Bbox 以包含给定的点。
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	获取 y 轴标签文本字符串。
Axes.label_outer	仅显示“外部”标签和刻度标签。
Axes.set_title	为Axes设置一个标题。
Axes.get_title	获取一个 Axes 标题。
Axes.legend	在 Axes 上放置一个图例。
Axes.get_legend	返回 Legend 实例，如果没有定义图例则返回 None。
Axes.get_legend_handles_labels	返回图例的句柄和标签

轴刻度

Axes.set_xscale	设置 x 轴的刻度。
Axes.get_xscale	返回 x 轴的刻度（以字符串形式）。
Axes.set_yscale	设置 y 轴的刻度。
Axes.get_yscale	返回 y 轴的刻度（以字符串形式）。

自动缩放和边距

Axes.use_sticky_edges	在自动缩放时，是否遵守所有 Artist.sticky_edges。
Axes.margins	设置或检索数据周围的自适应轴限制的边距。
Axes.get_xmargin	获取x轴的自动缩放边距。
Axes.get_ymargin	获取 y 轴的自动缩放边距。
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	设置在绘图时或通过 Axes.autoscale_view 是否自动缩放 x 轴。
Axes.get_autoscalex_on	返回 x 轴是否自动缩放。
Axes.set_autoscaley_on	设置在绘图时或通过 Axes.autoscale_view 时是否自动缩放 y 轴。
Axes.get_autoscaley_on	返回 y 轴是否自动缩放。

宽高比

Axes.apply_aspect	调整轴以适应指定的数据纵横比。
Axes.set_aspect	设置 Axes 的比例，即 y/x 比例。
Axes.get_aspect	返回 Axes 缩放的纵横比。
Axes.set_box_aspect	设置 Axes 的框体纵横比，即高度与宽度的比率。
Axes.get_box_aspect	返回 Axes 的框纵横比，即高度与宽度的比率。
Axes.set_adjustable	设置 Axes 如何调整以达到所需的纵横比。
Axes.get_adjustable	返回Axes是否会调整其物理尺寸（'box'）或其数据限制（'datalim'）以达到所需的纵横比。

刻度和刻度标签

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

单位

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

添加艺术家

Axes.add_artist	将一个 Artist 添加到 Axes；返回该 artist。
Axes.add_child_axes	将一个 Axes 添加到 Axes 的子元素中；返回子 Axes。
Axes.add_collection	将 Collection 添加到 Axes；返回集合。
Axes.add_container	将 Container 添加到 Axes 的容器中；返回该容器。
Axes.add_image	将一个 AxesImage 添加到 Axes；返回图像。
Axes.add_line	将一个 Line2D 添加到 Axes；返回该线条。
Axes.add_patch	向 Axes 添加一个 Patch；返回该 patch。
Axes.add_table	向 Axes 添加一个 Table；返回表格。

Twinning and sharing

Axes.twinx	创建一对共享x轴的Axes。
Axes.twiny	创建一对共享y轴的Axes。
Axes.sharex	与 other 共享 x 轴。
Axes.sharey	与 other 共享 y 轴。
Axes.get_shared_x_axes	返回共享 x 轴分组器的不可变视图。
Axes.get_shared_y_axes	返回共享 y 轴分组器的不可变视图。

坐标轴位置

Axes.get_anchor	获取锚点位置。
Axes.set_anchor	定义锚点位置。
Axes.get_axes_locator	返回 axes_locator。
Axes.set_axes_locator	设置坐标轴定位器。
Axes.get_subplotspec	返回与子图关联的 SubplotSpec，如果没有则返回 None。
Axes.set_subplotspec	设置 SubplotSpec。
Axes.reset_position	将活动位置重置为原始位置。
Axes.get_position	返回Axes在图形中的位置，作为一个`.Bbox`。
Axes.set_position	设置坐标轴位置。

异步/基于事件

Axes.stale	艺术家是否'过时'，需要重新绘制以使输出与艺术家的内部状态匹配。
Axes.pchanged	调用所有已注册的回调函数。
Axes.add_callback	添加一个回调函数，该函数将在 Artist 的任何属性更改时被调用。
Axes.remove_callback	根据其观察者ID移除回调。

交互式

Axes.can_pan	返回此 Axes 是否支持任何平移/缩放按钮功能。
Axes.can_zoom	返回此 Axes 是否支持缩放框按钮功能。
Axes.get_navigate	获取Axes是否响应导航命令。
Axes.set_navigate	设置Axes是否响应导航工具栏命令。
Axes.get_navigate_mode	获取导航工具栏按钮状态：'平移'，'缩放'，或无。
Axes.set_navigate_mode	设置导航工具栏按钮状态。
Axes.get_forward_navigation_events	获取如何将平移/缩放事件转发到此下方的 Axes。
Axes.set_forward_navigation_events	设置如何将平移/缩放事件转发到此图表下方的 Axes。
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	返回 *point*（像素坐标对）是否在 Axes 补丁内。
Axes.get_cursor_data	返回给定事件的光标数据。

子节点

Axes.get_children	返回此 Artist 的子 Artist 列表。
Axes.get_images	返回包含在 Axes 中的 AxesImage 列表。
Axes.get_lines	返回包含在 Axes 中的线条列表。
Axes.findobj	查找艺术家对象。

绘图

Axes.draw	使用给定的渲染器绘制艺术家（及其子项）。
Axes.draw_artist	高效地重绘单个艺术家。
Axes.redraw_in_frame	高效地重绘 Axes 数据，但不包括轴刻度、标签等。
Axes.get_rasterization_zorder	返回将被光栅化的艺术家以下的zorder值。
Axes.set_rasterization_zorder	设置向量图形输出的栅格化zorder阈值。
Axes.get_window_extent	返回显示空间中的 Axes 边界框。
Axes.get_tightbbox	返回 Axes 的紧密边界框，包括轴及其装饰器（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。
Axes.set	一次性设置多个属性。

class matplotlib.axes.Axes.ArtistList(axes, prop_name, valid_types=None, invalid_types=None)

基于其类型的 Axes 子列表。

在 Matplotlib 3.7 中，特定类型的子列表被设置为不可变。未来这些艺术家列表可能会被元组替换。请像使用元组一样使用它们。

参数:

axesAxes

此子列表将从中提取子元素的轴。

prop_namestr

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

有效类型类型列表，可选

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

无效类型tuple, 可选

一个类型列表，用于确定哪些子项将 不 被此子列表返回。如果指定，则子列表中的艺术家永远不会是这些类型的实例。否则，不会排除任何类型。