Python matplotlib Figure.add_subplot用法及代碼示例

本文簡要介紹 python 語言中 matplotlib.figure.Figure.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