matplotlib.figure.Figure.add_axes#

Figure.add_axes(*args, **kwargs)[源代码]#

将一个 Axes 添加到图中。

调用签名

add_axes(rect, projection=None, polar=False, **kwargs)
add_axes(ax)

参数:

rect元组 (left, bottom, width, height): 新的 Axes 的尺寸（左、下、宽、高）。所有量都以图的宽度和高度的分数表示。
projection{None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, 可选: Axes 的投影类型。str 是自定义投影的名称，详见 projections。默认 None 会生成一个 'rectilinear' 投影。
polarbool, 默认值: False: 如果为 True，相当于 projection='polar'。
axes_classAxes 的子类类型，可选: 被实例化的 axes.Axes 子类。此参数与 projection 和 polar 不兼容。有关示例，请参阅 axisartist。
sharex, shareyAxes，可选: 与 sharex 和/或 sharey 共享 x 轴或 y 轴。该轴将与共享 Axes 的轴具有相同的限制、刻度和比例。
labelstr: 返回的 Axes 的标签。

返回:

Axes，或 Axes 的子类: 返回的 Axes 类取决于所使用的投影。如果使用直角投影，则为 Axes；如果使用极坐标投影，则为 projections.polar.PolarAxes。

其他参数:

**kwargs

此方法还接受返回的 Axes 类的关键字参数。直角坐标系 Axes 类 Axes 的关键字参数可在下表中找到，但如果使用其他投影，可能还有其他关键字参数，请参阅实际的 Axes 类。

属性	描述
`adjustable`	{'box', 'datalim'}
`agg_filter`	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
`alpha`	浮点数或 None
`anchor`	(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`	浮点数或 None
`clip_box`	`BboxBase` 或 None
`clip_on`	布尔值
`clip_path`	Patch 或 (Path, Transform) 或 None
`facecolor` 或 `fc`	color
`figure`	`Figure` 或 `SubFigure`
`forward_navigation_events`	bool 或 "auto"
`frame_on`	布尔值
`gid`	str
`in_layout`	布尔值
`label`	object
`mouseover`	布尔值
`navigate`	布尔值
`navigate_mode`	未知
`path_effects`	`AbstractPathEffect` 的列表
`picker`	None 或布尔值或浮点数或可调用对象
`position`	[left, bottom, width, height] 或 `Bbox`
`prop_cycle`	`Cycler`
`rasterization_zorder`	浮点数或 None
`rasterized`	布尔值
`sketch_params`	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
`snap`	布尔值或 None
`subplotspec`	未知
`title`	str
`transform`	`变换`
`url`	str
`visible`	布尔值
`xbound`	(lower: float, upper: float)
`xlabel`	str
`xlim`	(left: float, right: float)
`xmargin`	float 大于 -0.5
`xscale`	未知
`xticklabels`	未知
`xticks`	未知
`ybound`	(lower: float, upper: float)
`ylabel`	str
`ylim`	(bottom: float, top: float)
`ymargin`	float 大于 -0.5
`yscale`	未知
`yticklabels`	未知
`yticks`	未知
`zorder`	浮点数

另请参阅

Figure.add_subplot
pyplot.subplot
pyplot.axes
Figure.subplots
pyplot.subplots

备注

在极少数情况下，add_axes 可能会在仅传递一个参数的情况下被调用，该参数是已在当前图中创建但不在图的 Axes 列表中的 Axes 实例。

示例

一些简单的例子

rect = l, b, w, h
fig = plt.figure()
fig.add_axes(rect)
fig.add_axes(rect, frameon=False, facecolor='g')
fig.add_axes(rect, polar=True)
ax = fig.add_axes(rect, projection='polar')
fig.delaxes(ax)
fig.add_axes(ax)