matplotlib.pyplot.subplot #

matplotlib.pyplot。subplot ( * args , ** kwargs ) [来源] #

将轴添加到当前图窗或检索现有轴。

这是一个包装器，Figure.add_subplot它在使用隐式 API 时提供额外的行为（请参阅注释部分）。

来电签名：

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

参数：

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

由其中之一描述的子图的位置

三个整数（nrows，ncols，index）。子图将在具有nrows行和ncols列的网格上获取索引位置。索引从左上角的 1 开始，向右增加。index也可以是一个二元组，指定子图的 ( first , last ) 索引（从 1 开始，并包括last），例如，创建一个跨越图上 2/3 的子图。fig.add_subplot(3, 1, (1, 2))
一个 3 位整数。这些数字被解释为好像分别作为三个个位数整数给出，即fig.add_subplot(235)与相同。请注意，这只能在不超过 9 个子图的情况下使用。fig.add_subplot(2, 3, 5)
一个SubplotSpec。

投影{无，'aitoff'，'hammer'，'lambert'，'mollweide'，'polar'，'rectilinear'，str}，可选

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

极地布尔，默认值：False

如果为 True，则相当于 projection='polar'。

sharex，sharey Axes，可选

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

标签str

返回轴的标签。

返回：

axes.SubplotBase，或另一个子类Axes: 子图的轴。返回的坐标区基类取决于使用的投影。是Axes使用直线投影还是使用projections.polar.PolarAxes极坐标投影。然后返回的轴是基类的子图子类。

其他参数：

**kwargs

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

财产	描述
`adjustable`	{'box', 'datalim'}
`agg_filter`	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
`alpha`	标量或无
`anchor`	(float, float) 或 {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	布尔
`aspect`	{'auto', 'equal'} 或浮动
`autoscale_on`	布尔
`autoscalex_on`	未知
`autoscaley_on`	未知
`axes_locator`	可调用[[轴，渲染器]，Bbox]
`axisbelow`	布尔或“线”
`box_aspect`	浮动或无
`clip_box`	`Bbox`
`clip_on`	布尔
`clip_path`	补丁或（路径，变换）或无
`facecolor`或 fc	颜色
`figure`	`Figure`
`frame_on`	布尔
`gid`	字符串
`in_layout`	布尔
`label`	目的
`mouseover`	布尔
`navigate`	布尔
`navigate_mode`	未知
`path_effects`	`AbstractPathEffect`
`picker`	None 或 bool 或 float 或可调用
`position`	[左、下、宽、高] 或`Bbox`
`prop_cycle`	未知
`rasterization_zorder`	浮动或无
`rasterized`	布尔
`sketch_params`	（比例：浮动，长度：浮动，随机性：浮动）
`snap`	布尔或无
`title`	字符串
`transform`	`Transform`
`url`	字符串
`visible`	布尔
`xbound`	未知
`xlabel`	字符串
`xlim`	（底部：浮动，顶部：浮动）
`xmargin`	浮动大于 -0.5
`xscale`	未知
`xticklabels`	未知
`xticks`	未知
`ybound`	未知
`ylabel`	字符串
`ylim`	（底部：浮动，顶部：浮动）
`ymargin`	浮动大于 -0.5
`yscale`	未知
`yticklabels`	未知
`yticks`	未知
`zorder`	漂浮

也可以看看

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

笔记

创建一个新的 Axes 将删除与它重叠的任何预先存在的 Axes，而不是共享一个边界：

import matplotlib.pyplot as plt
# plot a line, implicitly creating a subplot(111)
plt.plot([1, 2, 3])
# now create a subplot which represents the top plot of a grid
# with 2 rows and 1 column. Since this subplot will overlap the
# first, the plot (and its axes) previously created, will be removed
plt.subplot(211)

如果您不想要这种行为，请改用Figure.add_subplot方法或pyplot.axes函数。

如果没有传递任何kwargs并且在args指定的位置存在 Axes，则将返回该 Axes 而不是创建新的 Axes。

如果传递了kwargs ，并且在args指定的位置存在 Axes ，则投影类型相同，并且 kwargs与现有 Axes 匹配，则返回现有 Axes。否则，将使用指定的参数创建一个新轴。我们保存了对用于此比较的kwargs的引用。如果kwargs中的任何值是可变的，我们将不会检测到它们发生突变的情况。在这些情况下，我们建议使用Figure.add_subplot显式 Axes API 而不是隐式 pyplot API。

例子

plt.subplot(221)

# equivalent but more general
ax1 = plt.subplot(2, 2, 1)

# add a subplot with no frame
ax2 = plt.subplot(222, frameon=False)

# add a polar subplot
plt.subplot(223, projection='polar')

# add a red subplot that shares the x-axis with ax1
plt.subplot(224, sharex=ax1, facecolor='red')

# delete ax2 from the figure
plt.delaxes(ax2)

# add ax2 to the figure again
plt.subplot(ax2)

# make the first axes "current" again
plt.subplot(221)