HOWTO · Matplotlib
Matplotlib에서 서브 플롯에 제목을 추가하는 방법
Axes.set_title(), Axes.title.set_text() 또는 pyplot의 현재 axes(plt.gca())를 사용하여 Matplotlib의 서브플롯에 제목을 추가할 수 있습니다.
이 페이지의 내용
각 서브플롯에 제목을 붙이려면 해당 axes에서 Axes.set_title()을 호출하세요. 여러 그래프를 함께 만들 때 각 제목이 설명하는 axes와 연결되어 있으므로 가장 명확한 방법입니다. 서브플롯 제목은 하나의 axes에 적용됩니다. 그림 전체를 설명하는 제목 하나가 필요하다면 fig.suptitle() 같은 figure 수준의 제목을 사용하세요.
Axes.set_title()로 서브플롯 제목 설정하기
squeeze=False를 설정하면 plt.subplots()는 figure와 axes 배열을 반환합니다. 아래 예제는 네 개의 데이터 계열을 그린 뒤, 각 axes에 설명적인 제목을 연결하고 figure를 표시하기 전에 레이아웃을 조정합니다. 이 설정을 사용하면 2×2 격자, 단일 행(1×N), 단일 열(N×1), 단일 서브플롯(1×1) 모두에서 axes가 2차원 배열로 유지됩니다. 다른 크기의 격자를 만들려면 plt.subplots() 인수를 조정하고 모든 axes에 제목을 하나씩 제공하세요.
import numpy as np
import matplotlib.pyplot as plt
x = np.linspace(0, 2 * np.pi, 100)
series = [np.sin(x), np.cos(x), np.sin(2 * x), np.cos(2 * x)]
titles = ["Sine", "Cosine", "Sine, double frequency", "Cosine, double frequency"]
fig, axes = plt.subplots(2, 2, figsize=(8, 5), squeeze=False)
for ax, y, title in zip(axes.flat, series, titles):
ax.plot(x, y)
ax.set_title(title)
fig.tight_layout()
plt.show()
squeeze=False는 1×1 격자에서도 axes를 2차원 배열로 유지하므로 axes.flat을 사용하면 네 가지 격자 형태인 2×2, 1×N, N×1, 1×1을 같은 방식으로 순회할 수 있습니다. zip()은 각 axes와 데이터 계열을 제목과 짝지으므로, 각 항목의 순서와 개수를 맞추세요.
label 인수는 axes 위에 표시할 텍스트입니다. fontsize나 loc 같은 옵션을 전달해 제목의 모양과 위치를 조정할 수도 있습니다. 긴 제목은 간결하게 작성하세요. 인접한 제목이나 레이블이 서로 가까우면 figure 크기를 키우거나 표시 전에 간격을 조정하세요. tight_layout()은 유용한 출발점이지만, 장식 요소가 많은 레이아웃에는 간격을 추가로 조정해야 할 수 있습니다.
Axes.title.set_text()로 서브플롯 제목 설정하기
axes는 제목을 텍스트 객체로도 제공합니다. axes가 만들어진 뒤 그 텍스트를 설정하거나 업데이트하려면 Axes.title.set_text()를 사용하세요. 프로그램이 이미 제목 객체 참조를 보관하고 있거나 나중에 제목 문구를 바꾸는 경우 편리할 수 있습니다. 처음 그래프를 설정할 때는 Axes.set_title()이 대체로 더 직접적이며 axes를 호출하는 위치에서 작업을 명확하게 보여 줍니다.
import numpy as np
import matplotlib.pyplot as plt
x = np.linspace(0, 2 * np.pi, 100)
fig, axes = plt.subplots(1, 2, figsize=(8, 3.5), squeeze=False)
axes[0, 0].plot(x, np.sin(x))
axes[0, 1].plot(x, np.cos(x))
axes[0, 0].title.set_text("Sine")
axes[0, 1].title.set_text("Cosine")
fig.tight_layout()
plt.show()
예를 들어 ax라는 axes를 만든 뒤 ax.title.set_text("Updated title")을 호출할 수 있습니다. 이 호출은 해당 axes의 제목을 업데이트하며 figure의 모든 서브플롯에 제목을 설정하지는 않습니다. axes가 여러 개라면 업데이트할 대상을 명시적으로 선택하거나 첫 번째 예제처럼 axes와 각 제목 문자열을 함께 순회하세요. 두 API 모두 axes 제목을 다루므로 같은 작업에서 제목을 두 번 설정하지 말고 한 가지 방식을 선택하세요.
pyplot의 현재 axes를 사용해 서브플롯 제목 설정하기
pyplot의 상태 기반 인터페이스를 사용할 때 plt.gca()는 현재 axes를 반환합니다. plt.gca().set_title("Title")로 제목을 설정할 수 있으며, 이에 대응하는 텍스트 객체 방식은 plt.gca().title.set_text("Title")입니다. 괄호가 중요합니다. gca()는 현재 axes를 가져오는 함수 호출입니다. 이 방식은 그 순간 현재인 axes에만 적용되므로, 한 번에 하나의 axes를 그릴 때 유용합니다.
import numpy as np
import matplotlib.pyplot as plt
x = np.linspace(0, 2 * np.pi, 100)
series = [np.sin(x), np.cos(x), np.sin(2 * x), np.cos(2 * x)]
titles = ["Sine", "Cosine", "Sine, double frequency", "Cosine, double frequency"]
plt.figure(figsize=(8, 5))
for position, (y, title) in enumerate(zip(series, titles), start=1):
plt.subplot(2, 2, position)
plt.plot(x, y)
plt.gca().set_title(title)
plt.tight_layout()
plt.show()
격자를 사용할 때는 제목을 설정하기 전에 각 서브플롯을 선택하세요. 예를 들어 plt.subplot(2, 2, position)은 1부터 4까지의 위치 중 하나를 선택하고, 이어서 plt.gca().set_title(title)을 호출하면 선택된 axes에 제목이 적용됩니다. fig, axes = plt.subplots(...)로 격자를 만들었다면 반환된 axes 참조를 사용하는 편이 보통 더 이해하기 쉽고 pyplot의 현재 상태에도 덜 의존합니다.
plt.show()를 호출하기 전에 figure 설정을 마치세요. 특히 서브플롯 제목을 고려해 레이아웃을 조정할 수 있도록 표시 전에 plt.tight_layout()을 호출하세요.
겹치거나 잘리는 제목과 누락된 제목 수정하기
제목은 axes의 가운데에 배치되므로, 긴 제목은 axes 자체보다 넓어질 수 있습니다. 아래 예제에서 사용하는 두 제목을 크기 (8, 3.5)의 figure에 배치하면, 레이아웃 조정을 적용하지 않았을 때 측정한 제목 상자가 15픽셀 겹쳐 한 제목의 끝이 다음 제목의 시작 부분을 침범합니다. fig.tight_layout()을 호출하면 두 제목이 분리되지만(같은 측정에서 39픽셀의 간격이 생깁니다), tight_layout()은 서브플롯 사이의 공간을 재배분할 뿐 제목 텍스트를 줄이지는 않습니다. 그 figure 크기에서는 두 번째 제목이 figure의 오른쪽 가장자리를 11픽셀 넘어가 렌더링된 결과에서 잘립니다. 완전한 해결책은 제목에 공간을 주는 것입니다. 이 예제처럼 tight_layout()은 유지한 채 figure를 넓히거나, 제목을 짧게 줄이세요. 원래 크기에서 제목 fontsize를 11로 줄이는 방법도 두 제목을 모두 figure 안에 완전히 넣는 것을 확인했습니다.
import numpy as np
import matplotlib.pyplot as plt
x = np.linspace(0, 2 * np.pi, 100)
fig, axes = plt.subplots(1, 2, figsize=(9, 3.5), squeeze=False)
axes[0, 0].plot(x, np.sin(x))
axes[0, 1].plot(x, np.cos(x))
axes[0, 0].set_title("Sine wave measured at the first sensor")
axes[0, 1].set_title("Cosine wave measured at the second sensor")
fig.tight_layout()
plt.show()
크기 (9, 3.5)에서는 두 제목이 모두 figure 안에 들어가고 서로 간격이 있으며, 잘리는 텍스트가 없습니다. 반면 제목이 누락되는 경우는 조용히 실패합니다. 이 글의 루프는 zip()으로 axes와 제목을 짝짓는데, zip()은 더 짧은 시퀀스에서 멈추며 오류를 발생시키지 않습니다. 2×2 격자의 서브플롯 네 개에 제목을 세 개만 제공하면 네 번째 axes의 제목은 비어 있게 되고(ax.get_title()로 다시 읽으면 빈 문자열이 반환됩니다), 어떤 경고도 표시되지 않습니다. 서브플롯에 제목이 없는 것처럼 보이면, 제목 호출 자체를 확인하기 전에 먼저 제목과 axes의 개수를 세어 보세요.