설치 #

공식 릴리스 설치 #

Matplotlib 릴리스는 PyPI 에서 macOS, Windows 및 Linux용 휠 패키지로 제공됩니다 . 다음을 사용하여 설치하십시오 pip.

python -m pip install -U pip
python -m pip install -U matplotlib

이 명령으로 인해 소스에서 Matplotlib가 컴파일되고 컴파일에 문제가 있는 --prefer-binary경우 OS 및 Python용으로 사전 컴파일된 휠이 있는 최신 버전의 Matplotlib를 선택하도록 추가할 수 있습니다.

메모

다음 백엔드는 기본적으로 작동합니다. Agg, ps, pdf, svg

Python은 일반적으로 TkAgg에서 사용하는 tk 바인딩과 함께 제공됩니다.

다른 GUI 프레임워크, LaTeX 렌더링, 애니메이션 저장 및 다양한 파일 형식을 지원하려면 선택적 종속성 을 설치할 수 있습니다 .

타사 배포판 #

다양한 타사에서 환경에 Matplotlib를 제공합니다.

콘다 패키지 #

Matplotlib는 아나콘다 메인 채널 을 통해 모두 사용할 수 있습니다.

conda install matplotlib

뿐만 아니라 conda-forge 커뮤니티 채널 을 통해

conda install -c conda-forge matplotlib

파이썬 배포판 #

Matplotlib는 주요 Python 배포판의 일부입니다.

리눅스 패키지 매니저 #

Linux 배포판과 함께 제공되는 Python 버전을 사용하는 경우 다음과 같이 패키지 관리자를 통해 Matplotlib를 설치할 수 있습니다.

  • 데비안/우분투:sudo apt-get install python3-matplotlib

  • 페도라:sudo dnf install python3-matplotlib

  • 빨간 모자:sudo yum install python3-matplotlib

  • 아치:sudo pacman -S python-matplotlib

야간 빌드 설치 #

Matplotlib는 scipy-wheels-nightly Anaconda Cloud 조직 에서 야간 개발 빌드 휠을 사용할 수 있도록 합니다 . pip이 휠은 쿼리할 패키지 인덱스로 scipy-wheels-nightly를 지정하여 설치할 수 있습니다 .

python -m pip install \
  --upgrade \
  --pre \
  --index-url https://pypi.anaconda.org/scipy-wheels-nightly/simple \
  --extra-index-url https://pypi.org/simple \
  matplotlib

소스 # 에서 설치

Matplotlib 개발에 기여하거나 최신 소스 코드를 실행하는 데 관심이 있거나 모든 것을 직접 빌드하고 싶다면 소스에서 Matplotlib를 빌드하는 것이 어렵지 않습니다.

먼저 Dependencies 를 설치해야 합니다 .

AC 컴파일러가 필요합니다. 일반적으로 Linux에서는 gcc배포판의 패키지 관리자를 사용하여 설치해야 하는 가 필요합니다. macOS에서는 xcode 가 필요합니다 . Windows에서는 Visual Studio 2015 이상 이 필요합니다 .

Visual Studio를 사용하는 경우 "C++를 사용한 데스크톱 개발"이 선택되어 있고 최신 MSVC, "C++ CMake 도구 for Windows" 및 Windows 버전과 호환되는 Windows SDK가 선택되어 설치되어 있는지 확인하십시오. 기본적으로 "선택 사항" 하위 제목 아래에서 선택해야 하지만 소스에서 matplotlib를 빌드하는 데 필요합니다.

기여를 시작할 최신 개발 버전을 얻는 가장 쉬운 방법은 git 저장소 로 이동하여 다음 을 실행하는 것입니다.

git clone https://github.com/matplotlib/matplotlib.git

또는:

git clone git@github.com:matplotlib/matplotlib.git

개발 중인 경우 편집 가능 모드에서 수행하는 것이 좋습니다. 그 이유는 pytest의 테스트 검색은 설치가 이런 방식으로 수행된 경우에만 Matplotlib에서 작동하기 때문입니다. 또한 편집 가능 모드를 사용하면 재설치 없이 코드 변경 사항을 라이브러리 코드에 즉시 전파할 수 있습니다(Python 프로세스/커널을 다시 시작해야 함).

cd matplotlib
python -m pip install -e .

개발 중이 아닌 경우 다음과 같이 간단하게 소스 디렉토리에서 설치할 수 있습니다(마지막 단계만 교체).

python -m pip install .

테스트를 실행하려면 몇 가지 추가 종속성을 설치해야 합니다.

python -m pip install -r requirements/dev/dev-requirements.txt

그런 다음 언제든지 Matplotlib를 업데이트하려면 다음을 수행하십시오.

git pull

를 실행할 때 출력에 Python 파일만 업데이트되었다고 표시되면 모든 설정이 완료된 것입니다. C 파일이 변경된 경우 다시 실행하여 컴파일해야 합니다.git pullpip install -e .

개발자 문서에 git 사용 에 대한 자세한 정보가 있습니다 .

경고

이 섹션의 다음 지침은 Matplotlib의 매우 사용자 지정 설치를 위한 것입니다. 이러한 지침으로 인해 빌드가 예기치 않은 동작을 생성하거나 로컬 테스트가 실패할 수 있으므로 주의해서 진행하십시오.

tarball에서 빌드 하려면 PyPI 파일 페이지 에서 최신 tar.gz 릴리스 파일을 가져 옵니다 .

빌드 프로세스를 사용자 지정하는 데 사용할 수 있는 mplsetup.cfg 파일을 제공합니다 . 예를 들어 사용할 기본 백엔드, Matplotlib와 함께 제공되는 선택적 라이브러리 중 일부가 설치되어 있는지 여부 등입니다. 이 파일은 특히 Matplotlib 패키징에 유용합니다.

Windows에서 고유한 Matplotlib 휠(또는 sdists)을 빌드하는 경우 소스 트리에 복사하는 모든 DLL도 패키징됩니다.

개발용 설치 #

개발을 위한 Matplotlib 설정을 참조하십시오 .

자주 묻는 질문 #

컴파일 문제 신고 #

도움말 얻기를 참조하십시오 .

Matplotlib는 잘 컴파일되었지만 사용할 때 아무 것도 표시되지 않습니다 . #

가장 먼저 시도하는 것은 새로 설치 하고 그것이 도움이 되는지 확인하는 것입니다. 그렇지 않은 경우 설치를 테스트하는 가장 좋은 방법은 복잡성을 추가하는 IDLE 과 같은 통합 개발 환경이나 Python 셸에서 대화식으로 작업하는 대신 스크립트를 실행하는 것 입니다. UNIX 셸 또는 DOS 명령 프롬프트를 열고 예를 들어 다음을 실행합니다.

python -c "from pylab import *; set_loglevel('debug'); plot(); show()"

그러면 Matplotlib가 로드 중인 백엔드, 버전 정보 등에 대한 추가 정보가 제공됩니다. 이 시점 에서 Matplotlib 백엔드의 개념과 지침이 포함된 구성 파일 에 의해 제어되는 Matplotlib의 구성 프로세스 를 이해하고 있는지 확인하고 싶을 수 있습니다 .matplotlibrc

여전히 문제가 있는 경우 도움말 얻기 를 참조하십시오 .

Matplotlib를 완전히 제거하는 방법 #

경우에 따라 Matplotlib의 문제는 패키지를 새로 설치하여 해결할 수 있습니다. 설치된 Matplotlib를 완전히 제거하려면:

  1. Matplotlib 구성 디렉토리 에서 캐시를 삭제합니다 .

  2. 설치 디렉토리 에서 Matplotlib 디렉토리 또는 계란을 삭제하십시오 .

OSX 노트 #

OSX용 파이썬은 무엇입니까? #

Apple은 자체 Python, in /usr/bin/python및 자체 Matplotlib 사본과 함께 OSX를 제공합니다. 불행하게도 Apple이 현재 NumPy, Scipy 및 Matplotlib의 자체 복사본을 설치하는 방식은 이러한 패키지를 업그레이드하기 어렵다는 것을 의미합니다( 시스템 Python 패키지 참조 ). 이러한 이유로 새로운 버전의 Python을 설치하고 NumPy 및 Matplotlib와 같은 라이브러리를 설치하기 위한 기반으로 사용할 것을 강력히 권장합니다. 다른 유용한 Python 소프트웨어와 함께 Matplotlib를 설치하는 한 가지 편리한 방법 은 Python 자체와 다양한 라이브러리를 포함 하는 Anaconda Python 과학 소프트웨어 컬렉션을 사용하는 것입니다. 컬렉션에서 사용할 수 없는 라이브러리가 필요한 경우 pip 와 같은 표준 방법을 사용하여 직접 설치할 수 있습니다.. 설치 지원에 대해서는 Anaconda 웹 페이지를 참조하십시오.

새로운 Python 설치를 위한 다른 옵션은 python.org 의 표준 설치 프로그램 또는 homebrew 또는 macports 와 같은 일반 OSX 패키지 관리 시스템을 사용하여 Python을 설치하는 것 입니다. OSX의 고급 사용자는 오픈 소스 소프트웨어 패키지를 설치하기 위해 시스템에 homebrew 또는 macport 중 하나를 원할 수 있지만 이러한 시스템을 Anaconda 또는 Python.org Python과 같은 Python 바이너리의 다른 소스와 함께 사용하는 것은 완벽하게 가능합니다.

OSX 바이너리 휠 설치 #

https://www.python.org , Homebrew 또는 Macports에서 Python을 사용하는 경우 표준 pip 설치 프로그램을 사용하여 바퀴 형태로 Matplotlib 바이너리를 설치할 수 있습니다.

pip는 기본적으로 python.org 및 Homebrew Python과 함께 설치되지만 다음을 사용하여 Macports에 수동으로 설치해야 합니다.

sudo port install py38-pip

pip가 설치되면 Terminal.app 명령줄에서 Matplotlib 및 모든 종속성을 설치할 수 있습니다.

python3 -m pip install matplotlib

IPython 또는 Jupyter 노트북( )을 설치할 수도 있습니다.python3 -m pip install ipython notebook

설치 확인 #

이제 Matplotlib의 새 버전이 Python "경로"에 있어야 합니다. Terminal.app 명령줄에서 다음을 확인합니다.

python3 -c 'import matplotlib; print(matplotlib.__version__, matplotlib.__file__)'

당신은 같은 것을 볼 수

3.6.0 /Library/Frameworks/Python.framework/Versions/3.9/lib/python3.9/site-packages/matplotlib/__init__.py

여기서 3.6.0는 방금 설치한 Matplotlib 버전이고 다음 경로는 Python.org Python, Homebrew 또는 Macports를 사용하는지 여부에 따라 다릅니다. 다른 버전이 표시되거나 다음과 같은 오류가 발생하는 경우

Traceback (most recent call last):
  File "<string>", line 1, in <module>
ImportError: No module named matplotlib

그런 다음 다음을 실행하여 Python 바이너리가 예상한 것인지 확인합니다.

which python3

와 같은 결과를 얻는다면 /usr/bin/python...OSX와 함께 설치된 Python을 얻고 있는 것입니다. 이는 아마도 원하는 것이 아닐 것입니다. 검사를 다시 실행하기 전에 Terminal.app를 닫고 다시 시작하십시오. 그래도 문제가 해결되지 않으면 사용하려는 Python에 따라 Python.org Python을 다시 설치하거나 homebrew 또는 macports 설정을 확인하세요. 디스크 이미지 설치 프로그램은 Python.org Python에서만 작동하며 다른 Python에서는 선택되지 않습니다. 모두 실패하면 저희에게 알려주십시오 .