matplotlib.axes.Axes#

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

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

它包含大多数（子）绘图元素：Axis、Tick、Line2D、Text、Polygon 等，并设置坐标系。

像图中的所有可见元素一样，Axes 是 Artist 的子类。

Axes 实例通过一个回调属性支持回调，该属性是一个 CallbackRegistry 实例。你可以连接的事件是 'xlim_changed' 和 'ylim_changed'，回调将以 func(ax) 的形式被调用，其中 ax 是 Axes 实例。

备注

作为用户，您不会直接实例化 Axes，而是使用 Axes 创建方法；例如，从 pyplot 或 Figure：subplots、subplot_mosaic 或 Figure.add_axes。

在图形中构建一个坐标轴。

参数:

fig图

Axes 是在 Figure fig 中构建的。

*args

*args 可以是一个 (左, 底, 宽, 高) 矩形或一个单一的 Bbox。这指定了 Axes 所在的位置（在图形坐标中）。

*args 也可以由三个数字或一个三位数的数字组成；在后一种情况下，数字被视为独立的数字。这些数字被解释为 (nrows, ncols, index)：(nrows, ncols) 指定了子图数组的大小，而 index 是正在创建的子图的基于1的索引。最后，*args 也可以直接是一个 SubplotSpec 实例。

sharex, sharey : Axes, 可选Axes，可选

x- 或 y-axis 与输入 Axes 中的 x- 或 y-轴共享。请注意，无法取消共享轴。

frameonbool, 默认值: True

Axes 框架是否可见。

box_aspect浮点数，可选

为 Axes 框设置固定纵横比，即高度与宽度的比率。详情请参见 set_box_aspect。

forward_navigation_eventsbool 或 "auto"，默认值："auto"

控制是否将平移/缩放事件传递给此图表下方的 Axes。"auto" 在图表补丁不可见时为 True，否则为 False。

**kwargs

其他可选的关键字参数：

属性	描述
`可调整`	{'box', 'datalim'}
`agg_filter`	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和两个从图像左下角开始的偏移量
`alpha`	标量或无
`锚点`	(float, float) 或 {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	布尔值
`aspect`	{'auto', 'equal'} 或 float
`autoscale_on`	布尔值
`autoscalex_on`	未知
`autoscaley_on`	未知
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	布尔值或 'line'
`box_aspect`	浮点数或无
`clip_box`	`BboxBase` 或 None
`clip_on`	布尔值
`clip_path`	补丁或（路径，变换）或无
`facecolor` 或 fc	color
`figure`	`Figure` 或 `SubFigure`
`forward_navigation_events`	布尔值或“自动”
`frame_on`	布尔值
`gid`	str
`in_layout`	布尔值
`标签`	对象
`鼠标悬停`	布尔值
`导航`	布尔值
`navigate_mode`	未知
`path_effects`	`AbstractPathEffect` 列表
`picker`	None 或 bool 或 float 或 callable
`位置`	[左, 底, 宽, 高] 或 `Bbox`
`prop_cycle`	`Cycler`
`rasterization_zorder`	浮点数或无
`光栅化`	布尔值
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	布尔值或无
`subplotspec`	未知
`标题`	str
`transform`	`Transform`
`url`	str
`可见`	布尔值
`xbound`	(下限: 浮点数, 上限: 浮点数)
`xlabel`	str
`xlim`	(左: 浮点数, 右: 浮点数)
`xmargin`	浮点数大于 -0.5
`xscale`	未知
`xticklabels`	未知
`xticks`	未知
`ybound`	(下限: 浮点数, 上限: 浮点数)
`ylabel`	str
`ylim`	(底部: 浮点数, 顶部: 浮点数)
`ymargin`	浮点数大于 -0.5
`yscale`	未知
`yticklabels`	未知
`yticks`	未知
`zorder`	浮动

返回:

Axes: 新的 Axes 对象。