matplotlib.pyplot.axes¶

matplotlib.pyplot.axes(arg=None, **kwargs)[源代码]¶

将轴添加到当前图形并使其成为当前轴。

呼叫签名：

plt.axes()
plt.axes(rect, projection=None, polar=False, **kwargs)
plt.axes(ax)

参数:

arg无或4元组

此函数的确切行为取决于类型：

None ：使用添加新的全窗口轴 subplot(111, **kwargs) .
4个浮点数 rect = [left, bottom, width, height] . 新轴添加了尺寸 rect 在标准化（0，1）单位中使用 add_axes 在当前数字上。

projection无，'aitoff'、'hammer'、'lambert'、'mollweide'、'polar'、'rectlinear'、str，可选

的投影类型 Axes . str 是自定义投影的名称，请参见 projections . 默认的“无”将导致“直线”投影。

polarbool，默认值：False

如果为真，则相当于投影='polar'。

斯莱西 ： Axes 可选可选轴

共享X或Y axis 使用sharex和/或sharey。轴将具有与共享轴的轴相同的限制、刻度和比例。

labelSTR

返回轴的标签。

返回:

Axes, or a subclass of Axes: 返回的轴类取决于使用的投影。它是 Axes 如果使用直线投影 projections.polar.PolarAxes 如果使用极轴投影。

其他参数:

**kwargs

此方法还接受返回的axs类的关键字参数。直线轴类的关键字参数 Axes 可以在下表中找到，但如果使用其他投影，也可能有其他关键字参数，请参见实际的轴类。

财产	描述
`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`	浮动

参见

Figure.add_axes
pyplot.subplot
Figure.add_subplot
Figure.subplots
pyplot.subplots

笔记

如果图形已经有带键的轴（ args ， 关键字参数 ）然后它将简单地使该轴成为当前轴并返回它。此行为已被弃用。同时，如果您不希望此行为（即，您希望强制创建新轴），则必须使用一组唯一的args和kwargs。轴心标签为此，已公开属性：如果要将两个相同的轴添加到图形中，请确保为它们提供唯一的标签。

实例

# Creating a new full window axes
plt.axes()

# Creating a new axes with specified dimensions and some kwargs
plt.axes((left, bottom, width, height), facecolor='w')