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를 언제 사용하는지 살펴봅니다.

회전하지 않으면 월 이름 같은 범주 이름이 가로로 놓여 축 너비 전체를 차지하므로, 이름이 더 길거나 그림이 더 좁으면 이웃 레이블이 서로 붙어 버립니다:

January, February, March, April 가로 눈금 레이블이 축 너비를 가득 채운 월별 값 꺾은선 그래프.

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()

같은 월별 꺾은선 그래프. 눈금 레이블이 45도 회전하고 오른쪽 정렬되어 각 레이블이 해당 눈금에서 끝난다.
현재 축을 빠르게 변경하려면 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)

2024년 1월과 2월의 주간 날짜 6개에 대한 꺾은선 그래프. autofmt_xdate로 날짜 레이블이 45도 회전되어 있다.
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()

사용자 지정 레이블 North region, South region, East region, West region이 45도 회전하고 오른쪽 정렬된 꺾은선 그래프.
위치와 레이블의 순서를 서로 맞추세요. 나중에 그래프의 눈금이 바뀌면 사용자 지정 레이블도 그에 맞게 갱신하세요.

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()

분기 값 꺾은선 그래프. plt.setp로 눈금 레이블이 45도 회전하고 오른쪽 정렬되어 있다.
여기서 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()

프로젝트 단계 4개의 꺾은선 그래프. tick_params의 labelrotation 키워드로 눈금 레이블이 45도 회전되어 있다.
이미 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()

45도 눈금 레이블의 가로 정렬 right, left, center를 비교하는 나란히 배치된 꺾은선 그래프 3개.
각 레이블을 어느 지점에 맞출지에 따라 정렬을 선택하세요. 그래도 레이블이 빽빽하다면 회전뿐 아니라 그림 너비를 조정하거나 레이블 문구를 짧게 바꿔 보세요.

잘린 레이블과 레이블 개수 오류 처리하기

회전 자체가 동작해도 두 가지 실패가 남습니다. 첫째, 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픽셀을 넘어가 텍스트 중간에서 잘립니다:

tight_layout가 적용되지 않아 45도 지역 레이블이 그림 아래쪽 가장자리에서 잘린 꺾은선 그래프.

fig.tight_layout()는 모든 레이블이 들어가도록 그림 상자를 다시 계산합니다. 같은 방식으로 측정하면 레이블은 그림 가장자리에서 정확히 끝나고 밖에 나가는 것이 없습니다. fig.autofmt_xdate는 날짜 축에 대해 같은 종류의 여백 조정을 수행합니다. 레이아웃 조정 후에도 레이블이 계속 겹치면 각도를 키우지 말고 레이블 텍스트를 줄이거나 그림을 넓히세요.