Matplotlib安装教程

有很多不同的方法来安装matplotlib,最好的方法取决于你正在使用什么操作系统,你已经安装了什么,以及如何使用它。为了避免在此页面上浏览所有细节(和潜在的并发症),有几个方便的选择。

安装预建的软件包

大多数平台:科学的Python发行

第一个选择是使用已经提供matplotlib内置的预包装的python发行版之一。Continuum.io Python发行版(Anacondaminiconda)和Enthought发行版(Canopy) 都是Windows即OSX和普通Linux平台“开箱即用”的绝佳选择。这两个分发包括matplotlib和许多其他有用的工具。

Linux系统:使用你的包管理

如果你在Linux上,你可能更喜欢使用你的软件包管理器。几乎每个主要的Linux发行版都包装了matplotlib。

  • Debian / Ubuntu: sudo apt-get install python-matplotlib
  • Fedora / Redhat: sudo yum install python-matplotlib

Mac OSX上:使用PIP

如果您在Mac OSX上,您可以使用标准的Python安装程序pip来安装matplotlib二进制文件。请参阅安装OSX二进制轮

Windows

如果您还没有安装Python,我们建议您使用与Scipy-stack兼容的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(64位 或 32位 为Python 2.7)或Microsoft Visual C ++ 2010(64位 或 32位 为Python 3.4)可重新分发包。

Matplotlib依赖于枕头 读取和保存JPEG,BMP和TIFF图像文件。Matplotlib需要MiKTeX和 GhostScript来渲染LaTeX的文本。 动画模块需要FFmpegavconv, mencoder或 ImageMagick

以下后端应该是开箱即用的:agg,tkagg,ps,pdf和svg。对于其他后端,您可能需要安装 pycairo, PyQt4, PyQt5, PySide, wxPythonPyGTK, Tornado或GhostScript。

TkAgg可能是从标准Python shell或IPython进行交互式使用的最佳后端。它被启用为官方二进制文件的默认后端。Windows不支持GTK3。

PyPI下载页面.whl上的Windows wheels()不包含测试数据或示例代码。如果你想尝试matplotlib源码分发中的许多演示,请下载文件并查看 子目录。要运行测试套件,将源分发中的目录和 目录复制到并 分别安装鼻子mock,Pillow,MiKTeX,GhostScript,ffmpeg,avconv,mencoder,ImageMagick和Inkscape.tar.gzexampleslib\matplotlib\testslib\mpl_toolkits\testssys.prefix\Lib\site-packages\matplotlibsys.prefix\Lib\site-packages\mpl_toolkits

从源代码安装

如果您有兴趣为matplotlib开发,运行最新的源代码,或者只是想自己构建一切,那么从源代码构建matplotlib并不难。从PyPI文件页面获取最新的tar.gz发行文件,或者如果要开发matplotlib或只需要最新的bugfixed版本,请从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.cfg 文件,setup.py您可以使用它来自定义构建过程。例如,哪些默认后端使用,是否安装了matplotlib附带的一些可选库,等等。这个文件对于那些包装matplotlib将是特别有用的。

如果您已经为非标准地点安装了先决条件,并且需要通知matplotlib,那么setupext.py请将基本目录编辑并添加到您的basedir字典条目中sys.platform。例如,如果某些所需库的头部在 /some/path/include/someheader.h,则放入您的平台/some/path的 basedir列表中。

构建要求

这些是在安装matplotlib之前需要安装的外部程序包。如果您正在OSX上构建,请参阅在OSX上 构建。如果您在Windows上构建,请参阅在Windows上 构建。如果要在Linux上安装与软件包管理器的依赖关系,则可能需要安装开发包(除了库之外还查找“-dev”后缀)。

必需依赖
  • python 2.7,3.4,3.5或3.6

下载python

  • numpy 1.7.1(或更高版本)

数组支持python(下载numpy

Setuptools为python包安装提供扩展。

提供python datetime处理的扩展。如果使用pip,easy_install或从源安装,安装程序将尝试python_dateutil从PyPI 下载并安装。

需要matplotlib的数学渲染支持。如果使用pip,easy_install或从源安装,安装程序将尝试pyparsing从PyPI 下载并安装。

用于加载和保存PNG文件的库(下载)。libpng需要zlib。

用于操纵时区感知的数据时间。https://pypi.python.org/pypi/pytz

用于读取真实类型字体文件的库。如果使用pip,easy_install或从源安装,安装程序将尝试在预期位置找到FreeType。如果不能,请尝试安装pkg-config,该工具用于查找所需的非python库。

用于构建样式周期的可组合循环类

需要python 2和python 3之间的兼容性

python 2的依赖

在Python 2.7中运行时需要兼容性。

可选,仅限unix。Subprocess标准库的Backport从3.2+ for Python 2.7。它提供更好的错误消息和超时支持。

可选GUI框架

这些是可选的包,您可能需要安装以使用带有用户界面工具包的matplotlib。看 什么是后端?有关可选的matplotlib后端及其提供的功能的更多详细信息。

  • tk 8.3或更高版本,不是8.6.0或8.6.1

TkAgg后端使用的TCL / Tk小部件库。

已知版本8.6.0和8.6.1具有在以错误的顺序关闭多个窗口时可能导致segfaults的问题。

  • pyqt 4.4或更高版本

用于Qt4Agg后端的Qt4小部件库python包装器

  • pygtk 2.4或更高版本

用于GTK小部件库的python包装器可用于GTK或GTKAGG后端

wx小部件库的python包装器用于WX或WXAgg后端

可选外部程序

需要将动画模块保存为电影格式。

动画模块需要保存为动画GIF。

可选依赖关系
  • 枕头 如果安装了Pillow,matplotlib可以读取和写入更多的图像文件格式。

  • pkg配置 用于查找所需的非python库的工具。这不是严格要求的,但是如果库和标题不在预期位置,则可以使安装更顺利。
需要的库,与matplotlib出货
  • agg 2.4 反叛C ++渲染引擎。matplotlib静态链接到agg模板源,所以它不会影响你的系统外的任何东西在matplotlib之外。

  • qhull 2012.1

用于计算Delaunay三角测量的图书馆。

  • ttconv

truetype字体实用程序

在Linux上构建

最简单的方法是使用您的系统软件包管理器来安装依赖项。

如果您使用的是Debian / Ubuntu,可以通过以下方式获取构建matplotlib所需的所有依赖项:

sudo  apt - get  build - dep  python - matplotlib

如果您使用的是Fedora / RedHat,则可以先安装yum-builddep然后运行以获取构建matplotlib所需的所有依赖项:

su  - c  “yum-builddep python-matplotlib”

这不构建matplotlib,但它确实获得了安装构建依赖关系,这将使源代码更容易构建。

在OSX上建立

OSX的构建情况复杂化,各种场合可以获得libpng和freetype要求(darwinports,fink,/ usr / X11R6)和不同的体系结构(例如x86,ppc,universal)和不同的OSX版本(例如, 10.4和10.5)。我们建议您构建OSX版本的方式:从tarball或git存储库获取源代码,并按照说明进行操作README.osx。

在Windows上构建

https://www.python.org发送的Python 是使用Visual Studio 2008编译的,版本为3.3之前,Visual Studio 2010为3.3和3.4,Visual Studio 2015为3.5和3.6。Python扩展程序建议使用相同的编译器进行编译。

由于没有规范的Windows软件包管理器,从源代码构建freetype,zlib和libpng的方法在matplotlib-winbuild中记录为构建脚本。