HOWTO · Matplotlib
Matplotlib에서 X축 눈금 레이블 텍스트를 회전하는 방법
긴 레이블이 겹칠 때 Matplotlib의 x축 눈금 레이블을 회전하고 정렬하는 다섯 가지 방법을 알아보세요.
이 페이지의 내용
Matplotlib에서 x축 눈금 레이블을 회전하려면 plt.xticks, fig.autofmt_xdate, ax.set_xticklabels, plt.setp 또는 ax.tick_params에 rotation=45와 같은 각도를 지정하면 됩니다. 가로로 긴 레이블이 겹칠 때는 45도가 유용한 시작점입니다. 회전한 레이블의 끝이 눈금 가까이에 오도록 ha="right"로 정렬할 수 있습니다. 아래 예제에서는 각 API를 언제 사용하는지 살펴봅니다.
회전하지 않으면 월 이름 같은 범주 이름이 가로로 놓여 축 너비 전체를 차지하므로, 이름이 더 길거나 그림이 더 좁으면 이웃 레이블이 서로 붙어 버립니다:
plt.xticks로 x축 눈금 레이블 회전하기
pyplot을 사용할 때는 plt.xticks를 간결하게 사용할 수 있습니다. rotation 키워드로 각도를 도 단위로 지정하며, 기본값은 가로 방향입니다. 다음 예제는 범주를 표시하고 레이블을 45도 회전합니다.
import matplotlib.pyplot as plt
months = ["January", "February", "March", "April"]
values = [12, 18, 15, 22]
fig, ax = plt.subplots()
ax.plot(months, values, marker="o")
plt.xticks(rotation=45, ha="right")
ax.grid(True)
fig.tight_layout()
현재 축을 빠르게 변경하려면 plt.xticks를 사용하세요. 코드에서 이미 Axes 객체를 사용한다면 아래의 해당 메서드로 대상 축을 명시할 수 있습니다.
fig.autofmt_xdate로 날짜 축 레이블 회전하기
날짜를 표시하는 그래프에서는 fig.autofmt_xdate가 그림의 날짜 레이블 형식을 조정하고 가독성을 높이도록 회전합니다. 기본 설정은 정렬과 아래쪽 여백도 조정합니다. 원하는 각도가 있다면 rotation을 직접 지정할 수 있습니다. 동작은 그림의 축과 날짜 형식에 따라 달라지므로, 모든 눈금 레이블 설정을 대체하는 일반적인 방법이 아니라 날짜 축에 사용하세요.
import matplotlib.pyplot as plt
from datetime import date, timedelta
start = date(2024, 1, 1)
dates = [start + timedelta(days=7 * i) for i in range(6)]
values = [3, 5, 4, 7, 6, 9]
fig, ax = plt.subplots()
ax.plot(dates, values, marker="o")
fig.autofmt_xdate(rotation=45)
ax.grid(True)
x축에 날짜가 표시되고 형식이 지정된 레이블의 회전과 간격을 조정해야 할 때 편리합니다. 일반 범주에는 다른 섹션의 눈금 레이블 방법을 선택하세요.
ax.set_xticklabels로 레이블과 회전 설정하기
사용자 지정 레이블 텍스트와 회전을 함께 지정해야 한다면 ax.set_xticklabels를 사용하세요. 먼저 눈금 위치를 명시적으로 설정하고, 각 위치에 해당하는 레이블을 하나씩 제공해야 문자열이 의도한 눈금에 연결됩니다. 회전만 필요한 경우 레이블을 바꿀 필요는 없습니다. 기존 텍스트를 유지하려면 tick_params 또는 plt.setp를 사용하세요.
import matplotlib.pyplot as plt
positions = [0, 1, 2, 3]
labels = ["North region", "South region", "East region", "West region"]
values = [8, 5, 9, 6]
fig, ax = plt.subplots()
ax.plot(positions, values, marker="o")
ax.set_xticks(positions)
ax.set_xticklabels(labels, rotation=45, ha="right")
ax.grid(True)
fig.tight_layout()
위치와 레이블의 순서를 서로 맞추세요. 나중에 그래프의 눈금이 바뀌면 사용자 지정 레이블도 그에 맞게 갱신하세요.
plt.setp로 레이블 속성 설정하기
plt.setp는 기존 Matplotlib 아티스트의 속성을 갱신합니다. 여기에는 ax.get_xticklabels()가 반환하는 현재 x축 눈금 레이블 객체도 포함됩니다. 레이블이 이미 설정되어 있고 모양만 바꾸려는 경우에 유용합니다.
import matplotlib.pyplot as plt
categories = ["First quarter", "Second quarter", "Third quarter", "Fourth quarter"]
values = [14, 17, 13, 21]
fig, ax = plt.subplots()
ax.plot(categories, values, marker="o")
plt.setp(ax.get_xticklabels(), rotation=45, ha="right")
ax.grid(True)
fig.tight_layout()
여기서 rotation은 각도를 바꾸고 ha는 가로 정렬을 설정합니다. 이 방법은 텍스트를 바꾸지 않고 현재 눈금 레이블 객체를 갱신합니다.
ax.tick_params로 x축 레이블 회전 설정하기
ax.tick_params는 선택한 축의 눈금, 눈금 레이블, 격자선 속성을 설정합니다. axis="x"와 소문자로 표기한 labelrotation 키워드를 전달하면 텍스트와 위치는 그대로 두고 x축 레이블을 회전할 수 있습니다.
import matplotlib.pyplot as plt
categories = ["Planning", "Development", "Review", "Delivery"]
values = [2, 5, 3, 6]
fig, ax = plt.subplots()
ax.plot(categories, values, marker="o")
ax.tick_params(axis="x", labelrotation=45)
ax.grid(True)
fig.tight_layout()
이미 Axes 참조를 사용하는 경우 이 축 수준 메서드를 이용하세요. 키워드는 모두 소문자인 labelrotation입니다.
회전한 눈금 레이블 정렬하기
회전은 레이블의 각도를 바꾸고, 가로 정렬은 레이블의 어느 부분이 눈금에 놓일지 결정합니다. ha="right"이면 레이블의 오른쪽 끝이 눈금에 맞고, ha="left"이면 왼쪽 끝이 맞으며, ha="center"이면 가운데가 맞습니다. 눈금 왼쪽으로 뻗는 45도 레이블에는 오른쪽 정렬을 흔히 사용합니다. 레이블 길이와 그래프 배치에 맞춰 각 옵션을 살펴보세요.
import matplotlib.pyplot as plt
positions = [0, 1, 2, 3]
labels = ["January", "February", "March", "April"]
values = [4, 7, 5, 8]
alignments = ["right", "left", "center"]
fig, axes = plt.subplots(1, 3, figsize=(10, 3))
for ax, alignment in zip(axes, alignments):
ax.plot(positions, values, marker="o")
ax.set_xticks(positions)
ax.set_xticklabels(labels, rotation=45, ha=alignment)
ax.set_title(f'ha="{alignment}"')
ax.grid(True)
fig.tight_layout()
각 레이블을 어느 지점에 맞출지에 따라 정렬을 선택하세요. 그래도 레이블이 빽빽하다면 회전뿐 아니라 그림 너비를 조정하거나 레이블 문구를 짧게 바꿔 보세요.
잘린 레이블과 레이블 개수 오류 처리하기
회전 자체가 동작해도 두 가지 실패가 남습니다. 첫째, ax.set_xticklabels는 레이블 텍스트를 교체하므로 레이블 수는 눈금 위치 수와 같아야 합니다. 위치 4개에 레이블 3개를 전달하면 아무것도 그려지기 전에 호출이 실패합니다:
import matplotlib.pyplot as plt
positions = [0, 1, 2, 3]
labels = ["North", "South", "East"]
values = [8, 5, 9, 6]
fig, ax = plt.subplots()
ax.plot(positions, values, marker="o")
ax.set_xticks(positions)
ax.set_xticklabels(labels, rotation=45, ha="right")
호출은 다음 오류로 종료됩니다:
ValueError: The number of FixedLocator locations (4), usually from a call to set_ticks, does not match the number of labels (3).
누락된 레이블을 추가하여 두 시퀀스가 같은 순서로 같은 길이가 되게 하세요. 기존 텍스트만 회전하면 된다면 대신 plt.setp나 ax.tick_params를 사용하세요. 현재 레이블을 유지하므로 이런 불일치가 발생할 수 없습니다.
둘째, 회전은 각도를 바꾸지만 축 아래 공간을 만들지는 않습니다. 위의 set_xticklabels 예제를 fig.tight_layout() 호출 없이 렌더링하면 회전된 레이블이 그림 아래쪽 가장자리를 넘어갑니다. 기본 크기 렌더링에서는 약 31픽셀을 넘어가 텍스트 중간에서 잘립니다:
fig.tight_layout()는 모든 레이블이 들어가도록 그림 상자를 다시 계산합니다. 같은 방식으로 측정하면 레이블은 그림 가장자리에서 정확히 끝나고 밖에 나가는 것이 없습니다. fig.autofmt_xdate는 날짜 축에 대해 같은 종류의 여백 조정을 수행합니다. 레이아웃 조정 후에도 레이블이 계속 겹치면 각도를 키우지 말고 레이블 텍스트를 줄이거나 그림을 넓히세요.