安装

分节概述

这一节将介绍Mayavi不同的安装方法。

如果您已经有一个可以正常使用的Mayavi,您可以跳过本节。

就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 页面寻找更多的细节,它将告诉您如何检索信息以及发送邮件。