安裝
原文：Installing
譯者：飛龍
協(xié)議：CC BY-NC-SA 4.0
有許多安裝 matplotlib 的不同方法，最好的方法取決于你使用的操作系統(tǒng)，已經(jīng)安裝的內(nèi)容以及如何使用它扫腺。 為了避免涉及本頁上的所有細(xì)節(jié)（和潛在的復(fù)雜性）绞旅，有幾個方便的選項(xiàng)。
安裝預(yù)構(gòu)建包
多數(shù)平臺：Python 科學(xué)分發(fā)包
第一個選項(xiàng)是使用已經(jīng)內(nèi)置 matplotlib 的預(yù)打包的 Python 分發(fā)包多艇。 Continuum.io Python 分發(fā)包（Anaconda 或 miniconda）和 Enthought 分發(fā)包（Canopy）都是『在 Windows逻恐，OSX 和主流 Linux 平臺開箱即用并正常工作』的出色選擇。 這兩個分發(fā)包包括 matplotlib 和許多其他有用的工具墩蔓。
Linux：使用你的包管理器
如果你是用 Linux梢莽，你可能更傾向于使用包管理器。matplotlib 是用于多數(shù)主流 Linux 發(fā)行版的包奸披。
- Debian / Ubuntu：
sudo apt-get install python-matplotlib - Fedora / Redhat：
sudo yum install python-matplotlib
Mac OSX：使用pip
如果你使用 MacOS昏名，你可以使用 Python 標(biāo)準(zhǔn)安裝程序pip來安裝 matplotlib 二進(jìn)制。參見安裝 MacOS 二進(jìn)制輪子阵面。
Windows
如果你還沒有安裝 Python轻局，我們建議使用兼容 SciPy 技術(shù)棧的 Python 分發(fā)版本洪鸭，如 WinPython，Python(x, y)仑扑，Enthought Canopy 或 Continuum Anaconda览爵，它們含有 matplotlib 和它的許多依賴，并預(yù)裝了其他有用的軟件包镇饮。
對于 Python 的標(biāo)準(zhǔn)安裝蜓竹，可以使用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 位）再分發(fā)包储藐。
Matplotlib 依賴于 Pillow 來讀取和保存 JPEG俱济，BMP 和 TIFF 圖像文件。 Matplotlib 需要 MiKTeX 和 GhostScript 來使用LaTeX渲染文本钙勃。動畫模塊需要 FFmpeg蛛碌，avconv，mencoder 或 ImageMagick辖源。
以下后端應(yīng)該開箱即用：agg蔚携，tkagg，ps克饶，pdf 和 svg酝蜒。對于其他后端，你可能需要安裝 pycairo彤路，PyQt4秕硝，PyQt5，PySide洲尊，wxPython远豺，PyGTK，Tornado 或 GhostScript坞嘀。
TkAgg 可能是來自標(biāo)準(zhǔn) Python shell 或 IPython 的躯护，用于交互式的最佳后端。它被啟用為官方二進(jìn)制文件的默認(rèn)后端丽涩。 Windows 不支持 GTK3棺滞。
PyPI 下載頁面上的 Windows 輪子（* .whl）不包含測試數(shù)據(jù)或示例代碼。如果你想嘗試 matplotlib 源代碼中的許多演示矢渊，請下載*.tar.gz文件并查看examples子目錄继准。要運(yùn)行測試套件，請將源代碼發(fā)行版中的lib\matplotlib\tests和lib\mpl_toolkits\tests目錄分別復(fù)制到sys.prefix\Lib\site-packages\matplotlib和sys.prefix\Lib\site-packages\mpl_toolkits矮男，并安裝 nose移必，mock，Pillow毡鉴，MiKTeX崔泵，GhostScript秒赤，ffmpeg，avconv憎瘸，mencoder入篮，ImageMagick 和 Inkscape。
從源碼安裝
如果你有興趣為 matplotlib 開發(fā)做貢獻(xiàn)幌甘，運(yùn)行最新的源代碼潮售，或者只是想自己構(gòu)建一切，從源代碼構(gòu)建 matplotlib 并不困難含潘。 從 PyPI 文件頁面抓取最新的tar.gz發(fā)布文件饲做，或者如果你想開發(fā) matplotlib 或只需要最新的 bug 修復(fù)版本，獲取最新的 git 版本遏弱，請見從 git 安裝。
源代碼遵守標(biāo)準(zhǔn)環(huán)境變量 CC塞弊，CXX漱逸，PKG_CONFIG。 這意味著如果你的工具鏈有前綴游沿，你可以設(shè)置它們饰抒。 這可以用于交叉編譯。
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），你就可以構(gòu)建 matplotlib 了：
cd matplotlib
python setup.py build
python setup.py install
我們提供與setup.py一起使用的setup.cfg文件眯勾，你可以使用它來自定義構(gòu)建過程枣宫。 例如，要使用的默認(rèn)后端吃环，是否安裝 matplotlib 附帶的某些可選庫也颤，等等。 這個文件會對那些包裝 matplotlib 的東西特別有用郁轻。
如果已經(jīng)為非標(biāo)準(zhǔn)設(shè)施安裝了必備組件翅娶，并需要通知 matplotlib 它們在哪里，請編輯setupext.py并將基本路徑添加為sys.platform的basedir字典條目好唯。 例如竭沫，如果某些所需庫的頭文件位于/some/path/include/someheader.h中，請在你的平臺的basedir列表中輸入/some/path骑篙。
構(gòu)建需求
這些是外部軟件包蜕提，你需要在安裝 matplotlib 之前安裝它們。 如果你在 OSX 上構(gòu)建替蛉，請參閱在 OSX 上構(gòu)建贯溅。 如果你在 Windows 上構(gòu)建拄氯，請參閱在 Windows 上構(gòu)建。 如果在 Linux 上使用軟件包管理器安裝依賴項(xiàng)它浅，則除了庫本身之外译柏，還可能需要安裝開發(fā)包（查找-dev后綴）。
所需依賴
Python 2.7姐霍，3.4鄙麦，3.5 或 3.6
NumPy 1.7.1（或更新）
Python 的數(shù)組支持（下載 NumPy）
setuptools 為 Python 包安裝提供擴(kuò)展
dateutil 1.1 或更新
為 Python 時間日期的處理提供擴(kuò)展。如果使用了pip镊折，easy_install或者從源碼安裝胯府，安裝器會嘗試從 PyPI 下載并安裝python_dateutil。
需要為 matplotlib 的 mathtext 數(shù)學(xué)渲染提供支持恨胚。如果使用了pip骂因，easy_install或者從源碼安裝，安裝器會嘗試從 PyPI 下載并安裝pyparsing赃泡。
用于加載和保存 PNG 文件（下載）寒波。libong 需要 zlib。
用于操作時區(qū)感知的日期時間升熊。https://pypi.python.org/pypi/pytz
FreeType 2.3 或更新
用于讀取 TrueType 字體文件俄烁。如果使用了pip，easy_install或者從源碼安裝级野，安裝器會嘗試從預(yù)期位置定位 FreeType页屠。如果找病毒奧，嘗試安裝 pkg-config蓖柔，用于尋找所需非 Python 庫的工具辰企。
cycler 0.10.1 或更新
可組合的循環(huán)類，用于構(gòu)造 style-cycle渊抽。
需要用于 Python 2 和 3 之間的兼容性蟆豫。
Python 2 的依賴
需要用于 Python 2.7 上的兼容性。
可選懒闷，僅用于 Unix十减。subprocess標(biāo)準(zhǔn)庫從 3.2+ 到 2.7 的 Backport。它提供了更好的錯誤信息和超時支持愤估。
可選的 GUI 框架
這些是可選軟件包帮辟，你可能希望安裝這些軟件包來使 用matplotlib 和用戶界面工具包。 有關(guān) matplotlib 可選后端和所提供功能的更多詳細(xì)信息玩焰，請參閱什么是后端由驹。
tk 8.3 或更新，不包括 8.6.0 和 8.6.1
TkAgg 后端使用的 TCL/Tk 窗口控件庫。
版本 8.6. 0和 8.6.1 已知有問題蔓榄，當(dāng)以錯誤的順序關(guān)閉多個窗口時可能導(dǎo)致段錯誤并炮。
pyqt 4.4 或更新
Qt4 控件庫的 Python 包裝，用于 Qt4Agg 后端甥郑。
pygtk 2.4 或更新
GTK 控件庫的 Python 包裝逃魄，用于 GTK 或者 GTKAgg 后端。
wxpython 2.8 或更新
wx 控件庫的 Python 包裝澜搅，用于 WX 或 WXAgg 后端伍俘。
可選的外部程序
需要用于動畫模塊，將輸出保存為電影格式勉躺。
需要用于動畫模塊癌瘾，能夠保存 GIF 動畫。
可選依賴
如果安裝了 Pillow饵溅，matplotlib 可以讀取或?qū)懭氪蟛糠謭D像文件格式妨退。
用于尋找所需非 Python 庫的工具。并不是嚴(yán)格需要它概说，但是如果庫和頭文件不在預(yù)期位置碧注，可以使安裝更加便捷。
matplotlib 自帶的所需庫
agg 2.4
C++ 渲染引擎糖赔。 matplotlib 靜態(tài)鏈接到 agg 模板源碼，所以它除了 matplotlib 之外轩端，不會影響你的系統(tǒng)的任何東西放典。
qhull 2012.1
用于計算 Delaunay 三角測量的庫。
ttconv
TureType 字體工具基茵。
在 Linux 上構(gòu)建
使用你的系統(tǒng)包管理器來安裝依賴最為簡單奋构。
如果你使用 Debian/Ubuntu，可以使用以下命令在獲取需要用于構(gòu)建 matplotlib 的所有依賴：
sudo apt-get build-dep python-matplotlib
如果你使用 Fedora/RedHat拱层，你可以使用以下命令：
su -c "yum-builddep python-matplotlib"
這不會構(gòu)建 matplotlib弥臼，但這會安裝所需依賴。這會使從源碼構(gòu)建變得容易根灯。
在 OSX 上構(gòu)建
由于可以獲取libpng和freetype需求（darwinports径缅，fink，/usr/X11R6）的不同位置烙肺，不同的架構(gòu)（例如 x86纳猪，ppc，universal）和不同的 OSX 版本 10.4 和 10.5）桃笙，OSX 的構(gòu)建情況很復(fù)雜氏堤。我們建議你使用我們對 OSX 版本所做的方式來構(gòu)建：從tarball或git倉庫獲取源代碼，并按照README.osx中的說明進(jìn)行操作搏明。
在 Windows 上構(gòu)建
https://www.python.org 上發(fā)布的 Python 鼠锈，使用 VS2008 編譯 3.3 之前的版本闪檬，使用 VS2010 編譯 3.3，并且使用 VS2015 編譯 3.5 和 3.6购笆。 建議使用相同的編譯器編譯 Python 擴(kuò)展粗悯。
由于沒有規(guī)范的 Windows 包管理器，從源代碼構(gòu)建freetype由桌，zlib和libpng的方法被記錄為matplotlib-winbuild中的構(gòu)建腳本为黎。
