Python matplotlib FigureBase.add_subplot用法及代码示例

本文简要介绍 python 语言中 matplotlib.figure.FigureBase.add_subplot 的用法。

用法

add_subplot(*args, **kwargs)

在图中添加 Axes 作为子图排列的一部分。

调用签名：

add_subplot(nrows, ncols, index, **kwargs)
add_subplot(pos, **kwargs)
add_subplot(ax)
add_subplot()

参数：

*args int, (int, int, index ), 或 SubplotSpec , 默认: (1, 1, 1)

由其中之一说明的子图的位置

• 三个整数(nrows、ncols、index)。子图将在具有nrows 行和ncols 列的网格上占据index 位置。 index 从左上角的 1 开始，向右递增。 index 也可以是一个二元组，指定子图的(first、last)索引(从 1 开始，包括 last)，例如，fig.add_subplot(3, 1, (1, 2)) 生成一个跨越上 2 的子图/3 图。

• 一个 3 位整数。这些数字被解释为好像分别作为三个 single-digit 整数给出，即 fig.add_subplot(235) 与 fig.add_subplot(2, 3, 5) 相同。请注意，这只能在不超过 9 个子图的情况下使用。

• 一个 SubplotSpec 。

在极少数情况下，可以使用单个参数调用 add_subplot，即已在当前图中创建的子图 Axes 实例，但不在该图的 Axes 列表中。

projection {无，'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear'，str}，可选

子图的投影类型 ( Axes )。 str 是自定义投影的名称，请参阅 projections 。默认无导致 'rectilinear' 投影。

polar 布尔值，默认值：假

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

axes_class Axes 的子类类型，可选

实例化的 axes.Axes 子类。此参数与 projection 和 polar 不兼容。有关示例，请参见axisartist。

sharex, sharey Axes ，可选

与 sharex 和/或 sharey 共享 x 或 y axis 。该轴将具有与共享轴的轴相同的限制、刻度和比例。

label str

返回轴的标签。

返回：

Axes

子图的轴。返回的 Axes 实际上可以是子类的实例，例如极坐标投影的 projections.polar.PolarAxes 。

其他参数：

**kwargs

此方法还采用返回的 Axes 基类的关键字参数；除了 figure 参数。直线基类 Axes 的关键字参数可以在下表中找到，但如果使用另一个投影，也可能存在其他关键字参数。

属性	说明
adjustable	{'box', 'datalim'}
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	标量或无
anchor	(浮点数、浮点数)或 {'C'、'SW'、'S'、'SE'、'E'、'NE'、...}
animated	bool
aspect	{'auto', 'equal'} 或浮点数
autoscale_on	bool
autoscalex_on	unknown
autoscaley_on	unknown
axes_locator	可调用[[轴，渲染器]，Bbox]
axisbelow	布尔或'line'
box_aspect	浮点数或无
clip_box	BboxBase 或无
clip_on	bool
clip_path	补丁或(路径，变换)或无
facecolor 或 fc	color
figure	Figure
frame_on	bool
gid	str
in_layout	bool
label	object
mouseover	bool
navigate	bool
navigate_mode	unknown
path_effects	AbstractPathEffect 列表
picker	None 或 bool 或 float 或可调用
position	[左、下、宽、高]或 Bbox
matplotlib.axes.Axes.set_prop_cycle	Cycler
rasterization_zorder	浮点数或无
rasterized	bool
sketch_params	(比例：浮点数，长度：浮点数，随机性：浮点数)
snap	布尔或无
subplotspec	unknown
title	str
transform	Transform
url	str
visible	bool
xbound	(下：浮点数，上：浮点数)
xlabel	str
matplotlib.axes.Axes.set_xlim	(左：浮点数，右：浮点数)
xmargin	浮点数大于 -0.5
xscale	unknown
xticklabels	unknown
xticks	unknown
ybound	(下：浮点数，上：浮点数)
ylabel	str
matplotlib.axes.Axes.set_ylim	(底部：浮点数，顶部：浮点数)
ymargin	浮点数大于 -0.5
yscale	unknown
yticklabels	unknown
yticks	unknown
zorder	float

例子

fig = plt.figure()

fig.add_subplot(231)
ax1 = fig.add_subplot(2, 3, 1)  # equivalent but more general

fig.add_subplot(232, frameon=False)  # subplot with no frame
fig.add_subplot(233, projection='polar')  # polar subplot
fig.add_subplot(234, sharex=ax1)  # subplot sharing x-axis with ax1
fig.add_subplot(235, facecolor="red")  # red subplot

ax1.remove()  # delete ax1 from the figure
fig.add_subplot(ax1)  # add ax1 back to the figure