安装

就Mayavi本身而言，它的安装并不复杂，但是它依赖很多库。所幸，它的依赖现在都能从PyPI获取。其中有两个非常重要的依赖：

  1. VTK 可视化工具箱

  2. GUI 图形化界面，PyQt4, PySide, PyQt5 或者 wxPython都是可以的。

最新的 VTK 包适用于所有主流操作系统 (Windows, MacOS,以及Linux)，但是仅支持64位。Python 3.x 已经完全支持所有的操作系统，Python 2.7.x 仅支持MacOS 和 Linux。如果您的系统不支持，则您需要自行安装VTK匹配您的发行版。更多信息详见：General Build and Installation instructions <http://docs.enthought.com/mayavi/mayavi/installation.html#installing-ready-made-distributions>

如果是Python 3.x 您需要安装 PyQt5 等相关依赖。对于2.7.x PySide, PyQt4, 以及wxPython会是您的选择。您既可以用pip方式安装，也可以使用包管理器安装。 译者注：包管理器值得是Anaconda等发行版。

当前，Mayavi和最新版的wxPython 4.x兼容，但是traitsui, pyface和其他的ETS包还无法支持，因此会导致UI发生错误。但是更早一点的版本是可以正常使用的。PyQt/PySide是可以直接使用的，PySide2则自行选择。

使用pip命令安装

pip是 PyPA推荐、用于从PyPi安装而使用的安装工具。在PyPI可以找到最新版的Mayavi。here <https://pypi.python.org/pypi/mayavi>

所需的依赖包可以自动获取并在pip下完成安装。

最新的稳定版

截止到最新版本，也就是4.6.0以上，如果您在64位系统上使用Python 3.x，最简单的方式是使用pip命令进行安装：

$ pip install mayavi

$ pip install PyQt5

这样就完成了！

如果您无法像这样安装，您需要阅读文档并寻找一种安装VTK的方式和一个合适的UI工具箱，然后再重复以上步骤。

如果您更喜欢jupyter notebook的方式，则您需要按照下面的方式进行（你需要确保已经安装了jupyter notebook）：

$ jupyter nbextension install --py mayavi --user
$ jupyter nbextension enable --py mayavi --user

您需要预装ipywidgets和ipyevents。它们可以直接使用pip安装，或者使用库管理器进行安装。

最新版

如果您想要从github安装最新版，您可以这样进行：

$ git clone https://github.com/enthought/mayavi.git
$ cd mayavi
$ pip install -r requirements.txt
$ pip install PyQt5  # replace this with any supported toolkit
$ python setup.py install  # or develop

按照前面的说明添加jupyter nbextensions扩展。

Mayavi 由几个扩展包组成，它们都是ETS的一部分。有时候Mayavi可能会对某些未发布的部分有依赖关系。Mayavi依赖的ETS扩展包有 apptools, traits, traitsui, pyface, 和envisage。如果需要它们，您可以通过git进行安装，它们都非常容易安装。

安装预制的发行版

Windows系统:

在Windows系统下，安装Mayavi的最好方法是安装完整的Python发行版，比如Enthought Canopy, Pythonxy,或者Anaconda。需要注意的是，对于Pythonxy，在安装过程中添加组件的时候，您需要加入’ETS’ 选项，如果您想节约磁盘空间，可以不勾选其它选项。

MacOSX 系统:

完整的Python发行版  Enthought Canopy（包含Mayavi）或者Anaconda对MacOSX都是支持的。

Ubuntu 或 Debian 译者注：Linux系统的2个发行版，实测Manjaro和Arch都可以正常使用。:

对于 Debian 和 Ubuntu系统 使用apt命令即可完成安装。

RedHat EL3 及 EL4::

完整的Python发行版`Enthought Canopy`（包括Mayavi）都支持RHEL3 及 RHEL4。

EDM是Enthought提供Python免费管理器。它可以为刚接触Python的用户创建轻量级的环境，也能创建自定义的环境。EDM的主要优点是它的稳定性，对依赖的管理出色，对依赖之间冲突的管理较佳及版本间的兼容性支持较好。它可以从这里下载：<https://www.enthought.com/products/edm/installers/>`

EDM提供Python 2.7x以及Python 3.x。其中Python2.7x是默认的版本。安装EDM之后，mayavi可以用edm从终端轻松完成安装：

$ edm install mayavi pyqt

这样的命令会将mayavi和pyqt同时进行安装。之后您可以打开shell使用默认的Python版本，通过以下命令：

$ edm shell

这将会把Mayavi设定为默认的python 2.7版本。

对于 Python3.6.x版本，您需要这样安装：

$ edm environments create –version 3.6 py3

其中 ‘py3’ 是环境的名称。您可以改成您想要的名称，当您完成创建，您可以用以下方式激活它：

$ edm shell -e py3

现在您可以使用以下方式安装mayavi：

$ edm install mayavi pyqt

需要注意的是，pyqt的安装需要明确指定是匹配的 python3.6 还是 python2.7。 译者注：以往的经历，这个位置是比较容易错的地方，pyqt的版本安装错误会导致错误。

开源的包管理器Conda，用于安装多种不同版本的依赖。Anaconda和Miniconda都有Conda管理器。

Miniconda 是一个包含conda管理器在内的轻量级辅助程序，它还囊括python及其支持的库在内。根据您的操作系统，您可以自行进行下载：<https://conda.io/miniconda.html>

安装完conda之后，您需要从cmd运行以下命令：

$ conda create -n pyconda python=3.5 pyqt=4
$ source activate pyconda
$ conda install -c menpo mayavi

您需要做一些设定，对于 Mayavi 4.6.0您可以使用``pyqt=5``。

使用”Conda-forge”进行安装

Conda-forge 是一个社区版的conda镜像，更多的信息，您可以参考conda-forge的网站。

您可以使用conda-forge进行以下步骤的安装：

首先是克隆或者创建的一个新的环境：

$ conda create --name pyforge --clone root
or
$ conda create --name pyforge python=2.7

添加 conda-forge镜像：

$ conda config --add channels conda-forge

激活 pyforce 环境：

$ source activate pyforge

您需要对Mayavi的依赖进行安装：

$ conda install vtk
$ conda install pyqt=4

最终，安装Mayavi：

$ conda install mayavi

测试您的安装结果

测试安装结果的最好的方式是运行mayavi2，就像这样：

mayavi2

从cmd获取更多mayavi的帮助信息：

mayavi2 -h

mayavi2 是 mayavi的应用。对于一些不同的操作系统，比如win32系统，您需要双击 “mayavi2.exe”程序。这个文件存在于您的”PythonXYScripts”文件夹中，您需要确保它在您的环境变量中。

备注

Mayavi可以有多种使用方式，但”Mayavi2”应用程序是最简单的方式。

如果您有mayavi的源码，或者确保了来源可靠的 github 仓库，您可以运行mayavi*/examples，里面有足够的案例说明其特性，另外测试案例也在其子目录 mayavi*/tests 中。

测试组

tvtk和mayavi的基础测试组可以使用nose运行：

nosetests -v tvtk/tests
nosetests -v mayavi

集成测试命令如下：

cd integrationtests/mayavi
python run.py

检修

如果您的安装出现了问题，而您想要检查，请参考 Getting help 页面寻找更多的细节，它将告诉您如何检索信息以及发送邮件。