matplotlib RuntimeError: Matplotlib은 현재 GUI 백엔드가 아닌 agg를 사용하고 있습니다 오류 해결하기

소개

파이썬의 데이터 시각화 라이브러리인 Matplotlib을 사용할 때 'RuntimeError: Matplotlib은 현재 GUI 백엔드가 아닌 agg를 사용하고 있습니다'라는 오류를 마주할 수 있습니다. 이 오류는 주로 그래프를 표시하려고 하는데 GUI 백엔드 설정이 명시적이지 않아서 발생합니다. 이번 블로그 글에서는 이 문제의 원인과 해결 방법에 대해 알아보겠습니다.

에러 발생 예시 코드

다음은 'RuntimeError'를 발생시킬 수 있는 간단한 Matplotlib 코드 예시입니다.

import matplotlib.pyplot as plt

# 간단한 선 그래프 그리기
plt.plot([1, 2, 3, 4], [1, 4, 2, 3])
plt.title("샘플 그래프")
plt.show()  # GUI 백엔드에서 오류 발생 가능

에러 해결 방법

1. 적절한 백엔드 설정하기

Matplotlib의 백엔드를 명시적으로 설정해서 GUI 모드를 사용하도록 할 수 있습니다. 아래의 코드를 통해 'TkAgg'와 같은 GUI 백엔드를 설정해 보세요.

import matplotlib
matplotlib.use('TkAgg')  # 백엔드를 'TkAgg'로 설정

import matplotlib.pyplot as plt

# 간단한 선 그래프 그리기
plt.plot([1, 2, 3, 4], [1, 4, 2, 3])
plt.title("샘플 그래프")
plt.show()  # 이제 오류가 발생하지 않아야 합니다.

2. IPython 또는 Jupyter Notebook 사용 시

IPython이나 Jupyter Notebook에서 작업 중이라면, %matplotlib inline 또는 %matplotlib notebook 명령어를 사용하세요. 이를 통해 해당 환경에 맞는 설정이 자동으로 적용됩니다.

%matplotlib inline  # 또는 %matplotlib notebook

import matplotlib.pyplot as plt

# 간단한 선 그래프 그리기
plt.plot([1, 2, 3, 4], [1, 4, 2, 3])
plt.title("샘플 그래프")
plt.show()  # 정상적으로 그래프가 표시됩니다.

3. 다른 환경에서 실행하기

오류가 해결되지 않는 경우 IDE(예: PyCharm, VSCode)를 사용하여 실행해 보세요. 일부 환경에서는 올바른 백엔드가 자동으로 설정되지 않을 수 있습니다.

마무리

이 블로그 글에서는 Matplotlib에서 'RuntimeError: Matplotlib은 현재 GUI 백엔드가 아닌 agg를 사용하고 있습니다'라는 오류에 대한 다양한 해결 방법을 살펴보았습니다. 백엔드를 적절히 설정하거나, 특정 환경에서 실행하여 오류를 방지할 수 있다는 점을 기억하세요. 데이터 시각화는 중요한 작업이니 항상 올바른 설정으로 작업을 진행하시길 바랍니다!