matplotlib.axes

轴类

class matplotlib.axes.Axes(fig, rect, facecolor=None, frameon=True, sharex=None, sharey=None, label='', xscale=None, yscale=None, box_aspect=None, **kwargs)[源代码]

基类：matplotlib.axes._base._AxesBase

这个 Axes 包含大多数图形元素： Axis ， Tick ， Line2D ， Text ， Polygon 等，并设置坐标系。

这个 Axes 实例通过回调属性支持回调，该属性是 CallbackRegistry 实例。您可以连接到的事件是'xlim_changed'和'ylim_changed'，回调将用func调用。（ ax 何处 ax 是 Axes 实例。

属性:
数据报 ： Bbox盒子

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

视窗 ： Bbox盒子

视图限制在数据坐标中。

在图形中构建轴。

参数:
fig ： Figure图形

轴内置于 Figure fig .

rect[左、下、宽、高]

轴内置在矩形中 rect . rect 是在 Figure 协调。

斯莱西 ： Axes 可选可选轴

X或Y axis 与输入中的X或Y轴共享 Axes .

frameonbool，默认值：True

轴框架是否可见。

box_aspect无，或数字，可选

设置轴框的纵横比。看到了吗 set_box_aspect 有关详细信息。

**kwargs

其他可选关键字参数：

财产 描述
adjustable 'box'、'datalim'
agg_filter 一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha 浮动或无
anchor 2-浮点数或'c'、'sw'、's'、'se'、…
animated 布尔
aspect {auto}或num
autoscale_on 布尔
autoscalex_on 布尔
autoscaley_on 布尔
axes_locator 可赎回的 [[轴，渲染器]] Bbox
axisbelow 布尔或“线”
box_aspect 没有，或者是一个数字
clip_box Bbox
clip_on 布尔
clip_path 面片或（路径、变换）或无
contains 未知的
facecolor 或fc 颜色
figure Figure
frame_on 布尔
gid STR
in_layout 布尔
label 对象
navigate 布尔
navigate_mode 未知的
path_effects AbstractPathEffect
picker 无、布尔或可呼叫
position [左、下、宽、高] 或 Bbox
prop_cycle 未知的
rasterization_zorder 浮动或无
rasterized 布尔或无
sketch_params （比例：浮动，长度：浮动，随机性：浮动）
snap 布尔或无
title STR
transform Transform
url STR
visible 布尔
xbound 未知的
xlabel STR
xlim （底部：浮动，顶部：浮动）
xmargin 浮动大于-0.5
xscale “Linear”，“Log”，“SymLog”，“Logit”，…
xticklabels 未知的
xticks 未知的
ybound 未知的
ylabel STR
ylim （底部：浮动，顶部：浮动）
ymargin 浮动大于-0.5
yscale “Linear”，“Log”，“SymLog”，“Logit”，…
yticklabels 未知的
yticks 未知的
zorder 浮动
返回:
Axes

新的 Axes 对象。

次要情节

SubplotBase 子批次的基类，它是 Axes 具有其他方法的实例，以便于生成和操作一组 Axes 在一个数字内。
subplot_class_factory 创建继承自的新类 SubplotBase 以及给定的轴类（假定为 axes.Axes ）

作图

基本的

Axes.plot 绘制Y和X作为直线和/或标记。
Axes.errorbar 将Y和X绘制为带有附加误差线的直线和/或标记。
Axes.scatter 散点图 y VS
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.stem 创建一个茎图。
Axes.eventplot 在给定位置绘制相同的平行线。
Axes.pie 绘制饼图。
Axes.stackplot 绘制堆积面积图。
Axes.broken_barh 绘制水平矩形序列。
Axes.vlines 绘制垂直线。
Axes.hlines 在每个位置绘制水平线 y 从 xmin 到 xmax .
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.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 注释该点 xy 带文字 text .
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 绘制一个二维倒钩区域。
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.get_frame_on 获取是否绘制轴矩形面片。
Axes.set_axisbelow 设置轴刻度线和网格线是在大多数艺术家的上方还是下方。
Axes.get_axisbelow 获取轴刻度线和网格线是在大多数艺术家的上方还是下方。
Axes.grid 配置网格线。
Axes.get_facecolor 获取轴的面颜色。
Axes.set_facecolor 设置轴的面颜色。

产权循环

Axes.set_prop_cycle 设置轴的属性循环。

轴/极限

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.update_datalim_bounds [Deprecated] 扩展 datalim Bbox包含给定的 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 获取依拉贝尔文本字符串。
Axes.set_title 为轴设置标题。
Axes.get_title 获取轴标题。
Axes.legend 在轴上放置图例。
Axes.get_legend 返回 Legend 实例，如果未定义任何图例，则为无。
Axes.get_legend_handles_labels 返回图例的手柄和标签

轴比例尺

Axes.set_xscale 设置X轴比例。
Axes.get_xscale 返回xaxis的刻度（作为str）。
Axes.set_yscale 设置Y轴比例。
Axes.get_yscale 返回yaxis'scale（作为str）。

自动缩放和页边距

Axes.use_sticky_edges 自动缩放时，是否全部服从 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.get_autoscale_on 获取是否对绘图命令上的两个轴应用自动缩放
Axes.set_autoscalex_on 设置是否在绘图命令上应用X轴的自动缩放
Axes.get_autoscalex_on 获取是否在绘图命令上应用X轴的自动缩放
Axes.set_autoscaley_on 设置是否在绘图命令上应用Y轴的自动缩放
Axes.get_autoscaley_on 获取是否将Y轴的自动缩放应用于绘图命令

宽高比

Axes.apply_aspect 根据指定的数据纵横比调整轴。
Axes.set_aspect 设置轴缩放的纵横比，即Y单位与X单位的比率。
Axes.get_aspect
Axes.set_box_aspect 设置轴框纵横比。
Axes.get_box_aspect 获取轴盒外观。
Axes.set_adjustable 设置轴如何调整以达到所需的纵横比。
Axes.get_adjustable 返回轴是调整其物理尺寸（“box”）还是调整其数据限制（“datalim”），以达到所需的纵横比。

刻度线和刻度线标签

Axes.set_xticks 设置X轴的刻度位置。
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的网格线作为 Line2D S
Axes.get_xticklines 返回xaxis的刻度线作为 Line2D S
Axes.xaxis_date 设置轴记号和标签，将沿X轴的数据视为日期。
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的网格线作为 Line2D S
Axes.get_yticklines 返回yaxis的记号行作为 Line2D S
Axes.yaxis_date 设置轴记号和标签，将沿Y轴的数据视为日期。
Axes.minorticks_off 从轴上删除次要刻度。
Axes.minorticks_on 在轴上显示小刻度。
Axes.ticklabel_format 配置 ScalarFormatter 默认情况下用于线性轴。
Axes.tick_params 更改刻度线、刻度标签和网格线的外观。
Axes.locator_params 控制主要蜱虫定位器的行为。

单位

Axes.convert_xunits 转换 x 使用xaxis的单位类型。
Axes.convert_yunits 转换 y 使用yaxis的单位类型。
Axes.have_units 返回 True 如果在任何轴上设置了单位。

添加艺术家

Axes.add_artist 添加一个 Artist 回到斧头上，把艺术家还给我。
Axes.add_child_axes 添加一个 AxesBase 给斧子的孩子们；把孩子们的斧子还给他们。
Axes.add_collection 添加 Collection 到轴的集合；返回集合。
Axes.add_container 添加 Container 放回斧子的容器里；把容器放回原处。
Axes.add_image 添加一个 AxesImage 到轴的图像；返回图像。
Axes.add_line 添加 Line2D 回到轴线上；返回直线。
Axes.add_patch 添加 Patch 到轴的补丁；返回补丁。
Axes.add_table 添加 Table 回到轴心的桌子上；归还桌子。

结对与分享

Axes.twinx 创建一个共享X轴的双轴。
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 获取轴矩形的副本作为 Bbox .
Axes.set_position 设置轴位置。

异步/基于事件

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

互动式

Axes.can_pan 返回 True 如果此轴支持任何平移/缩放按钮功能。
Axes.can_zoom 返回 True 如果此轴支持缩放框按钮功能。
Axes.get_navigate 获取轴是否响应导航命令
Axes.set_navigate 设置轴是否响应导航工具栏命令
Axes.get_navigate_mode 获取导航工具栏按钮状态：“平移”、“缩放”或“无”
Axes.set_navigate_mode 设置导航工具栏按钮状态；
Axes.start_pan 在启动PAN操作时调用。
Axes.drag_pan 当鼠标在平移操作期间移动时调用。
Axes.end_pan 当pan操作完成时调用（当鼠标按钮打开时）。
Axes.format_coord 返回格式化字符串 x ， y 协调。
Axes.format_cursor_data 返回的字符串表示形式 data .
Axes.format_xdata 返回 x 格式化为x值。
Axes.format_ydata 返回 y 格式化为y值。
Axes.mouseover 如果此属性设置为 True ，则当鼠标光标移动到艺术家身上时，将查询该艺术家的自定义上下文信息。
Axes.in_axes 返回 True 如果给定 鼠标移动 （在显示坐标中）在轴中
Axes.pick 处理pick事件。
Axes.pickable 返回艺术家是否可选择。
Axes.get_picker 返回艺术家的拾取行为。
Axes.set_picker 定义艺术家的采摘行为。
Axes.set_contains [Deprecated] 为艺术家定义自定义包含测试。
Axes.get_contains [Deprecated] 返回艺术家的自定义包含函数（如果设置），或 None .
Axes.contains 测试艺术家是否包含鼠标事件。
Axes.contains_point 返回是否 点 （一对像素坐标）位于轴面片内。
Axes.get_cursor_data 返回游标的给定数据事件。

儿童

Axes.get_children 返回孩子的列表 Artist 这是什么 Artist .
Axes.get_images 返回的列表 AxesImage 轴所包含的。
Axes.get_lines 返回轴包含的行列表。
Axes.findobj 查找艺术家对象。

绘图

Axes.draw 使用给定的渲染器绘制艺术家（及其子对象）。
Axes.draw_artist 高效地重画一个艺术家。
Axes.redraw_in_frame 有效地重新绘制轴数据，但不绘制轴记号、标签等。
Axes.get_renderer_cache
Axes.get_rasterization_zorder 返回zorder值，低于该值艺术家将被栅格化。
Axes.set_rasterization_zorder
参数:
Axes.get_window_extent 返回显示空间中的轴边界框； args 和 关键字参数 是空的。
Axes.get_tightbbox 返回轴的紧边界框，包括轴及其装饰器（xlabel、title等）。

投影

方法使用 Axis 对于非直线轴必须重写。

Axes.name
Axes.get_xaxis_transform 获取用于绘制X轴标签、刻度和网格线的转换。
Axes.get_yaxis_transform 获取用于绘制Y轴标签、刻度和网格线的转换。
Axes.get_data_ratio 返回缩放数据的纵横比。
Axes.get_data_ratio_log [Deprecated] 以日志刻度返回原始数据的纵横比。
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 返回 True 如果有艺术家被添加到轴。