matplotlib.figure.SubFigure.add_axes#

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

将 Axes 添加到图形中。

调用签名:

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

参数:

rect元组 (左, 底, 宽, 高): 新 Axes 的尺寸（左、底、宽、高）。所有量都是图形宽度和高度的分数。
投影{None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, 可选: Axes 的投影类型。str 是自定义投影的名称，参见 projections。默认的 None 结果是 'rectilinear' 投影。
极地bool, 默认值: False: 如果为真，等同于 projection='polar'。
axes_class : Axes 的子类类型，可选子类类型: 实例化的 axes.Axes 子类。此参数与 projection 和 polar 不兼容。有关示例，请参见 axisartist。
sharex, sharey : Axes, 可选坐标轴，可选: 使用 sharex 和/或 sharey 共享 x 或 y axis。轴将具有与共享的 Axes 相同的限制、刻度和比例。
标签str: 返回的 Axes 的标签。

返回:

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

其他参数:

**kwargs

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

属性	描述
`可调整`	{'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
`position`	[左, 下, 宽, 高] 或 `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`	float

参见

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)