使用 plt.subplots 创建多个子图#

pyplot.subplots 通过单个调用创建一个图形和子图网格,同时为如何创建各个绘图提供合理的控制。对于更高级的用例,您可以使用 GridSpec 获取更通用的子图布局,或使用 Figure.add_subplot 在图形内的任意位置添加子图。

import matplotlib.pyplot as plt
import numpy as np

# Some example data to display
x = np.linspace(0, 2 * np.pi, 400)
y = np.sin(x ** 2)

只有一个子图的图形#

不带参数的 subplots() 返回一个 Figure 和一个 Axes

这实际上是创建单个图形和轴的最简单和推荐的方法。

fig, ax = plt.subplots()
ax.plot(x, y)
ax.set_title('A single plot')
A single plot

在一个方向堆叠子图#

pyplot.subplots 的前两个可选参数定义子图网格的行数和列数。

仅在一个方向堆叠时,返回的 axs 是一个 1D numpy 数组,其中包含已创建轴的列表。

fig, axs = plt.subplots(2)
fig.suptitle('Vertically stacked subplots')
axs[0].plot(x, y)
axs[1].plot(x, -y)
Vertically stacked subplots

如果只创建几个轴,立即将它们解包到每个轴的专用变量会很方便。这样,我们可以使用 ax1 而不是更冗长的 axs[0]

fig, (ax1, ax2) = plt.subplots(2)
fig.suptitle('Vertically stacked subplots')
ax1.plot(x, y)
ax2.plot(x, -y)
Vertically stacked subplots

要获得并排的子图,请传递参数 1, 2 表示一行和两列。

fig, (ax1, ax2) = plt.subplots(1, 2)
fig.suptitle('Horizontally stacked subplots')
ax1.plot(x, y)
ax2.plot(x, -y)
Horizontally stacked subplots

在两个方向堆叠子图#

在两个方向堆叠时,返回的 axs 是一个 2D NumPy 数组。

如果必须为每个子图设置参数,则使用 for ax in axs.flat: 迭代 2D 网格中的所有子图会很方便。

fig, axs = plt.subplots(2, 2)
axs[0, 0].plot(x, y)
axs[0, 0].set_title('Axis [0, 0]')
axs[0, 1].plot(x, y, 'tab:orange')
axs[0, 1].set_title('Axis [0, 1]')
axs[1, 0].plot(x, -y, 'tab:green')
axs[1, 0].set_title('Axis [1, 0]')
axs[1, 1].plot(x, -y, 'tab:red')
axs[1, 1].set_title('Axis [1, 1]')

for ax in axs.flat:
    ax.set(xlabel='x-label', ylabel='y-label')

# Hide x labels and tick labels for top plots and y ticks for right plots.
for ax in axs.flat:
    ax.label_outer()
Axis [0, 0], Axis [0, 1], Axis [1, 0], Axis [1, 1]

您也可以在 2D 中使用元组解包来将所有子图分配给专用变量

fig, ((ax1, ax2), (ax3, ax4)) = plt.subplots(2, 2)
fig.suptitle('Sharing x per column, y per row')
ax1.plot(x, y)
ax2.plot(x, y**2, 'tab:orange')
ax3.plot(x, -y, 'tab:green')
ax4.plot(x, -y**2, 'tab:red')

for ax in fig.get_axes():
    ax.label_outer()
Sharing x per column, y per row

共享轴#

默认情况下,每个坐标轴(Axes)都是单独缩放的。因此,如果范围不同,子图的刻度值就不会对齐。

fig, (ax1, ax2) = plt.subplots(2)
fig.suptitle('Axes values are scaled individually by default')
ax1.plot(x, y)
ax2.plot(x + 1, -y)
Axes values are scaled individually by default

您可以使用 sharexsharey 来对齐水平或垂直轴。

fig, (ax1, ax2) = plt.subplots(2, sharex=True)
fig.suptitle('Aligning x-axis using sharex')
ax1.plot(x, y)
ax2.plot(x + 1, -y)
Aligning x-axis using sharex

sharexsharey 设置为 True 将启用整个网格的全局共享,即,当使用 sharey=True 时,垂直堆叠的子图的 y 轴也具有相同的刻度。

fig, axs = plt.subplots(3, sharex=True, sharey=True)
fig.suptitle('Sharing both axes')
axs[0].plot(x, y ** 2)
axs[1].plot(x, 0.3 * y, 'o')
axs[2].plot(x, y, '+')
Sharing both axes

对于共享坐标轴的子图,一组刻度标签就足够了。内部坐标轴的刻度标签会自动被 sharexsharey 删除。不过,子图之间仍然存在未使用的空白空间。

要精确控制子图的位置,可以显式创建一个 GridSpec,使用 Figure.add_gridspec,然后调用其 subplots 方法。例如,我们可以使用 add_gridspec(hspace=0) 来减小垂直子图之间的高度。

label_outer 是一个方便的方法,可以从不在网格边缘的子图中删除标签和刻度。

fig = plt.figure()
gs = fig.add_gridspec(3, hspace=0)
axs = gs.subplots(sharex=True, sharey=True)
fig.suptitle('Sharing both axes')
axs[0].plot(x, y ** 2)
axs[1].plot(x, 0.3 * y, 'o')
axs[2].plot(x, y, '+')

# Hide x labels and tick labels for all but bottom plot.
for ax in axs:
    ax.label_outer()
Sharing both axes

除了 TrueFalsesharexsharey 都接受值 'row' 和 'col',以便仅在每行或每列中共享值。

fig = plt.figure()
gs = fig.add_gridspec(2, 2, hspace=0, wspace=0)
(ax1, ax2), (ax3, ax4) = gs.subplots(sharex='col', sharey='row')
fig.suptitle('Sharing x per column, y per row')
ax1.plot(x, y)
ax2.plot(x, y**2, 'tab:orange')
ax3.plot(x + 1, -y, 'tab:green')
ax4.plot(x + 2, -y**2, 'tab:red')

for ax in fig.get_axes():
    ax.label_outer()
Sharing x per column, y per row

如果您想要更复杂的共享结构,可以首先创建没有共享的坐标轴网格,然后调用 axes.Axes.sharexaxes.Axes.sharey 以事后添加共享信息。

fig, axs = plt.subplots(2, 2)
axs[0, 0].plot(x, y)
axs[0, 0].set_title("main")
axs[1, 0].plot(x, y**2)
axs[1, 0].set_title("shares x with main")
axs[1, 0].sharex(axs[0, 0])
axs[0, 1].plot(x + 1, y + 1)
axs[0, 1].set_title("unrelated")
axs[1, 1].plot(x + 2, y + 2)
axs[1, 1].set_title("also unrelated")
fig.tight_layout()
main, unrelated, shares x with main, also unrelated

极坐标轴#

pyplot.subplots 的参数 subplot_kw 控制子图的属性(另请参阅 Figure.add_subplot)。特别是,这可以用来创建一个极坐标轴网格。

fig, (ax1, ax2) = plt.subplots(1, 2, subplot_kw=dict(projection='polar'))
ax1.plot(x, y)
ax2.plot(x, y ** 2)

plt.show()
subplots demo

标签: 组件: 子图 组件: 坐标轴 组件: 轴 绘图类型: 折线图 绘图类型: 极坐标图 级别: 初学者 目的: 展示

脚本的总运行时间:(0 分钟 8.717 秒)

由 Sphinx-Gallery 生成的画廊