Matplotlib 中文使用者指南 2 安裝

安裝

原文： Installing 譯者： 飛龍 協定： CC BY-NC-SA 4.0

有許多安裝 matplotlib 的不同方法，最好的方法取決于你使用的作業系統，已經安裝的内容以及如何使用它。 為了避免涉及本頁上的所有細節（和潛在的複雜性），有幾個友善的選項。

安裝預建構包

多數平台：Python 科學分發包

第一個選項是使用已經内置 matplotlib 的預打包的 Python 分發包。

Continuum.io

Python 分發包（Anaconda 或 miniconda）和 Enthought 分發包（Canopy）都是『在 Windows，OSX 和主流 Linux 平台開箱即用并正常工作』的出色選擇。 這兩個分發包包括 matplotlib 和許多其他有用的工具。

Linux：使用你的包管理器

如果你是用 Linux，你可能更傾向于使用包管理器。matplotlib 是用于多數主流 Linux 發行版的包。

• Debian / Ubuntu：

  sudo apt-get install python-matplotlib

• Fedora / Redhat：

  sudo yum install python-matplotlib

Mac OSX：使用

pip

如果你使用 MacOS，你可以使用 Python 标準安裝程式

pip

來安裝 matplotlib 二進制。參見

安裝 MacOS 二進制輪子

。

Windows

如果你還沒有安裝 Python，我們建議使用相容 SciPy 技術棧的 Python 分發版本，如 WinPython，Python(x, y)，Enthought Canopy 或 Continuum Anaconda，它們含有 matplotlib 和它的許多依賴，并預裝了其他有用的軟體包。

對于

Python 的标準安裝

，可以使用

pip

安裝 matplotlib ：

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

如果沒有為所有使用者安裝 Python 2.7 或 3.4，則需要安裝 Microsoft Visual C++ 2008（對于 Python 2.7 為 64 位或 32 位）或 Microsoft Visual C++ 2010（對于 Python 3.4 為 64 位或 32 位）再分發包。

Matplotlib 依賴于 Pillow 來讀取和儲存 JPEG，BMP 和 TIFF 圖像檔案。 Matplotlib 需要 MiKTeX 和 GhostScript 來使用LaTeX渲染文本。動畫子產品需要 FFmpeg，avconv，mencoder 或 ImageMagick。

以下後端應該開箱即用：agg，tkagg，ps，pdf 和 svg。對于其他後端，你可能需要安裝 pycairo，PyQt4，PyQt5，PySide，wxPython，PyGTK，Tornado 或 GhostScript。

TkAgg 可能是來自标準 Python shell 或 IPython 的，用于互動式的最佳後端。它被啟用為官方二進制檔案的預設後端。 Windows 不支援 GTK3。

PyPI 下載下傳頁面上的 Windows 輪子（

* .whl

）不包含測試資料或示例代碼。如果你想嘗試 matplotlib 源代碼中的許多示範，請下載下傳

*.tar.gz

檔案并檢視

examples

子目錄。要運作測試套件，請将源代碼發行版中的

lib\matplotlib\tests

和

lib\mpl_toolkits\tests

目錄分别複制到

sys.prefix\Lib\site-packages\matplotlib

sys.prefix\Lib\site-packages\mpl_toolkits

，并安裝 nose，mock，Pillow，MiKTeX，GhostScript，ffmpeg，avconv，mencoder，ImageMagick 和 Inkscape。

從源碼安裝

如果你有興趣為 matplotlib 開發做貢獻，運作最新的源代碼，或者隻是想自己建構一切，從源代碼建構 matplotlib 并不困難。

從 PyPI 檔案頁面

抓取最新的

tar.gz

釋出檔案，或者如果你想開發 matplotlib 或隻需要最新的 bug 修複版本，擷取最新的 git 版本，請見

從 git 安裝

源代碼遵守标準環境變量 CC，CXX，PKG_CONFIG。 這意味着如果你的工具鍊有字首，你可以設定它們。 這可以用于交叉編譯。

export CC=x86_64-pc-linux-gnu-gcc export CXX=x86_64-pc-linux-gnu-g++ export PKG_CONFIG=x86_64-pc-linux-gnu-pkg-config           

一旦你滿足的了面的具體需求（主要是 Python、NumPy、libpng 和 freetype），你就可以建構 matplotlib 了：

cd matplotlib
python setup.py build
python setup.py install           

我們提供與

setup.py

一起使用的

setup.cfg

檔案，你可以使用它來自定義建構過程。 例如，要使用的預設後端，是否安裝 matplotlib 附帶的某些可選庫，等等。 這個檔案會對那些包裝 matplotlib 的東西特别有用。

如果已經為非标準設施安裝了必備元件，并需要通知 matplotlib 它們在哪裡，請編輯

setupext.py

并将基本路徑添加為

sys.platform

的

basedir

字典條目。 例如，如果某些所需庫的頭檔案位于

/some/path/include/someheader.h

中，請在你的平台的

basedir

清單中輸入

/some/path

建構需求

這些是外部軟體包，你需要在安裝 matplotlib 之前安裝它們。 如果你在 OSX 上建構，請參閱

在 OSX 上建構

。 如果你在 Windows 上建構，請參閱

在 Windows 上建構

。 如果在 Linux 上使用軟體包管理器安裝依賴項，則除了庫本身之外，還可能需要安裝開發包（查找

-dev

字尾）。

所需依賴

Python 2.7，3.4，3.5 或 3.6

下載下傳 Python

NumPy 1.7.1（或更新）

Python 的數組支援（

下載下傳 NumPy

）

setuptools

setuptools 為 Python 包安裝提供擴充

dateutil

1.1 或更新

為 Python 時間日期的處理提供擴充。如果使用了

pip

，

easy_install

或者從源碼安裝，安裝器會嘗試從 PyPI 下載下傳并安裝

python_dateutil

pyparsing

需要為 matplotlib 的 mathtext 數學渲染提供支援。如果使用了

pip

easy_install

pyparsing

libpng 1.2 （或更新）

用于加載和儲存

PNG

檔案（

下載下傳

）。libong 需要 zlib。

pytz

用于操作時區感覺的日期時間。

https://pypi.python.org/pypi/pytz FreeType

2.3 或更新

用于讀取 TrueType 字型檔案。如果使用了

pip

easy_install

或者從源碼安裝，安裝器會嘗試從預期位置定位 FreeType。如果找病毒奧，嘗試安裝

pkg-config

，用于尋找所需非 Python 庫的工具。

cycler

0.10.1 或更新

可組合的循環類，用于構造 style-cycle。

six

需要用于 Python 2 和 3 之間的相容性。

Python 2 的依賴

functools32

需要用于 Python 2.7 上的相容性。

subprocess32

可選，僅用于 Unix。

subprocess

标準庫從 3.2+ 到 2.7 的 Backport。它提供了更好的錯誤資訊和逾時支援。

可選的 GUI 架構

這些是可選軟體包，你可能希望安裝這些軟體包來使 用matplotlib 和使用者界面工具包。 有關 matplotlib 可選後端和所提供功能的更多詳細資訊，請參閱

什麼是後端 tk

8.3 或更新，不包括 8.6.0 和 8.6.1

TkAgg 後端使用的 TCL/Tk 視窗控件庫。

版本 8.6. 0和 8.6.1 已知有問題，當以錯誤的順序關閉多個視窗時可能導緻段錯誤。

pyqt

4.4 或更新

Qt4 控件庫的 Python 包裝，用于 Qt4Agg 後端。

pygtk

2.4 或更新

GTK 控件庫的 Python 包裝，用于 GTK 或者 GTKAgg 後端。

wxpython

2.8 或更新

wx 控件庫的 Python 包裝，用于 WX 或 WXAgg 後端。

可選的外部程式

ffmpeg

/

avconv

或

mencoder

需要用于動畫子產品，将輸出儲存為電影格式。

ImageMagick

需要用于動畫子產品，能夠儲存 GIF 動畫。

可選依賴

Pillow

如果安裝了 Pillow，matplotlib 可以讀取或寫入大部分圖像檔案格式。

用于尋找所需非 Python 庫的工具。并不是嚴格需要它，但是如果庫和頭檔案不在預期位置，可以使安裝更加便捷。

matplotlib 自帶的所需庫

agg

2.4

C++ 渲染引擎。 matplotlib 靜态連結到 agg 模闆源碼，是以它除了 matplotlib 之外，不會影響你的系統的任何東西。

qhull 2012.1

用于計算 Delaunay 三角測量的庫。

ttconv

TureType 字型工具。

在 Linux 上建構

使用你的系統包管理器來安裝依賴最為簡單。

如果你使用 Debian/Ubuntu，可以使用以下指令在擷取需要用于建構 matplotlib 的所有依賴：

sudo apt-get build-dep python-matplotlib           

如果你使用 Fedora/RedHat，你可以使用以下指令：

su -c "yum-builddep python-matplotlib"           

這不會建構 matplotlib，但這會安裝所需依賴。這會使從源碼建構變得容易。

由于可以擷取

libpng

freetype

需求（darwinports，fink，/usr/X11R6）的不同位置，不同的架構（例如 x86，ppc，universal）和不同的 OSX 版本 10.4 和 10.5），OSX 的建構情況很複雜。我們建議你使用我們對 OSX 版本所做的方式來建構：從

tarball

git

倉庫擷取源代碼，并按照

README.osx

中的說明進行操作。

https://www.python.org

上釋出的 Python ，使用 VS2008 編譯 3.3 之前的版本，使用 VS2010 編譯 3.3，并且使用 VS2015 編譯 3.5 和 3.6。 建議使用相同的編譯器編譯 Python 擴充。

由于沒有規範的 Windows 包管理器，從源代碼建構

freetype

zlib

libpng

的方法被記錄為

matplotlib-winbuild

中的建構腳本。