Mayavi2 用户手册2 安装

内容来自Mayavi2的中文文档项目。本篇文档的源文件在这里。欢迎感兴趣的朋友加入。

---

章节概要

本章详细介绍各种安装和编译 Mayavi 的方法。

如果你已经可以运行 Mayavi ，请略过此部分。

最新的安装指南可以在 Mayavi2 的 wiki 页面找到。下面将给出通用的安装过程以及可以找到更多信息的地方。

安装准备好的发布

Windows:	在 Window 中，安装 Mayavi 的最好方式是安装一个完整的 Python 发行版，例如 EPD 或者 Pythonxy。注意，Pythonxy 有一个特殊的下载，提供 Mayavi 和所依赖的软件包的完整安装程序，比 EPD 和完整的 Pythonxy 小很多。
MacOSX:	MacOSX中也有完整的 Python 发行版，EPD_ (包括 Mayavi)。除非你真的喜欢复杂的编译过程，这是安装 Mayavi 的最好方式。
Ubuntu 或 Debian:	Mayavi 在 Debian 和 Ubuntu 中有打好的软件包。另外，对于 Ubuntu 的稳定版，在这里可以找到最新的 Mayavi 的发行包： https://launchpad.net/~gael-varoquaux/+archive。实验性的 Debian 包在这里：http://newpeople.debian.org/~varun/。
RedHat EL3 和 EL4:	对于 RHEL3 和 4，有完整的 Python 发行版 EPD (包含 Mayavi)。

手动安装的前提条件

如果你没有使用准备就绪的完整的科学计算 Python 发布，需要满足 Mayavi 的条件。

Mayavi 至少需要下面的软件包：

• VTK >= 4.4 (5.x 最佳)

• numpy >= 1.0.1

• setuptools (用于安装和建立egg)

• Traits >= 3.0 (Traits`，`TraitsGUI 和 TraitsBackendWX 或 TraitsBackendQt)

下面的要求是可选的，但是强烈建议安装，特别是初次使用 Mayavi 时：

• Envisage == 3.x (EnvisageCore 和 EnvisagePlugins)

• wxPython 2.8.x

• configobj

可以通过几种方式安装需要的软件包。

• Windows 和 MacOSX: 即使你想从源码安装，最好仍是安装一个上面提到的发布。注意：在Windows中，EPD_ 带了一个编译器 (mingw)，用来编译Mayavia。

• Linux：大部分 Linux 发行版都有上述软件包的二进制安装程序。例如， 在 Debian 或者 Ubuntu 中，需要安装 python-vtk， python-wxgtk2.6，python-setuptools， python-numpy，python-configobj。 更多关于特定发行版以及如何满足其安装要求的信息可以在这里找到：

  https://svn.enthought.com/enthought/wiki/Install

• Mac OS X：关于此平台的最有效信息在这里 IntelMacPython25。

下面将说明安装 TVTK，Traits 和 Mayavi 的几种方法。

自己动手：Python 软件包：Egg

首先确认已满足必需条件，例如已经安装下面的软件包：

• VTK >= 4.4 (5.x 最好)

• numpy >= 1.0.1

• wxPython >= 2.8.0

• configobj

• setuptools (用于安装和建立 egg；版本越新越好)

更多细节在前一节中。

Mayavi2 是 Enthought 工具套件(ETS)的一部分。它作为 ETS 的一部分而分发 ，所以 ETS 的二进制包和源码包包括 Mayavi2。Mayavi 的发布总是伴随着 ETS 的发布。你可以选择安装整个 ETS 或仅安装 Mayavi2。

ETS 被组织为几个不同 Python 包。这些包被分发为 Python Egg。Python egg 相当成熟，包含对其它 egg 的依赖关系。 因此它们很快成为分发 Python 包的标准。

使用 ETS egg 主要有两种方法。

1. 第一种，也是最容易的方法，是使用特定平台上的预编译包。下面会给出 更详细的说明。

2. 第二种是从源码 tarball 包建立 egg。如果你有正确的编译环境，这也是很 容易的方法。

要安装 egg，首先确认已满足必要条件，然后如下所示生成和安装 egg:

 $ easy_install "Mayavi[app]"

这个命令将下载、生成和安装所有需要的 ETS 相关模块，它们都是 Mayavi 所需的 ETS 最新发布版。如果你碰到问题，请查看此页 Enthought Install。

在安装中一个常见的问题来源是系统中存在下列软件包的旧版 本：traits，mayavi，envisage 或 tvtk。在安装 Mayavi 的新版本前首先确认 已经清除了 site-packages。另一个经常遇到的问题可能是生成系统的错 误，显示为“sandbox violation”。这种情况下，多试几次上面的下载和安装命令 会有用。

在此背景下，请看下面的说明：

• Enthought Install 讲述如何用 egg 安装 ETS。请首先查看此页，它含 有在各种平台上使用预编译的 egg 进行安装的信息，包括解决依赖关系。

在 Windows 中使用 egg 循序渐进安装说明

如果你不想在 Windows 中安装准备好的发行版，下面的说明(由 Guillaume Duclaux 提供)将指导你通过必要的步骤配置 Mayavi 运行的 Windows 环 境。

1. 安装 Python 2.5。把 “C:\Python25;” 添加到系统路径里。

2. 安装 Mingw32。使用 http://www.mingw.org/ 的下载部分的 MinGW5.1.4 安 装程序。把 “C:\MinGW\bin;” 添加到系统路径里。

3. 创建文件 “c:\documents and settings\USERNAME\pydistutils.cfg” (这里 的USERNAME是登录名)，内容如下:

    [build]
   compiler=mingw32
   

4. 建立新的环境变量 HOME，并设置其值为： 'c:\docume~1\USERNAME;' (这里的 USERNAME 是登录用户名)

5. 下载安装 Setuptools(0.6c9 二进制包)，添加系统路径“C:\Python25\Scripts;”

6. 安装 VTK 5.2(使用 Charl P. Botha 博士的 Windows 二进制包， http://cpbotha.net/2008/09/23/python-25-enabled-vtk-52-windows-binaries/)

   • 解压缩此目录中的内容“C:\Program Files\VTK5.2_cpbotha”

   • 添加系统路径“C:\Program Files\VTK5.2_cpbotha\bin;”

   • 创建新系统变量 PYTHONPATH 并设其值为“C:\Program Files\VTK5.2_cpbotha\lib\site-packages;”

7. 安装 Numpy (1.2.1 版的二进制包可以从这里下载 http://numpy.scipy.org/ )

8. 安装 wxPython (2.8 版的二进制包可以从这里下载 http://www.wxpython.org/ )

9. 在命令行(cmd.exe)运行:

    easy_install Sphinx EnvisageCore EnvisagePlugins configobj
   

10. 最后，在命令行(cmd.exe)运行:

     easy_install Mayavi[app]
    

最前沿：SVN

如果你想获得最新的 Mayavi 开发版，我们推荐从 SVN 检出源码。Mayavi 依赖于几 个属于 ETS 的软件包。开发中的 Mayavi 非常有可能依赖于一些还未发布的组件的特性。所以一次检出所有 Mayavi 递进依赖的 ETS 项目是非常方便的。为了方便执行此操作，Dave Peterson 创建了一个软件包 ETSProjectTools。首先安装此软件包，即可检出任何与 ETS 有关的软件仓库。下面是如何获得最新 的开发源码。

1. 按照下面的步骤安装 ETSProjectTools :

    $ svn co https://svn.enthought.com/svn/enthought/ETSProjectTools/trunk \
          ETSProjectTools
   $ cd ETSProjectTools
   $ python setup.py install
   

   这样会有一个很有用的脚本 ets。关于此工具的详细信息和选项，请查看 ETSProjectTools 的 wiki 页面。

2. 为了获得 Mayavi 的源码和所有依赖的包，运行下列下面的命令:

    $ ets co "Mayavi[app]"
   

   此命令将查找最新的 mayavi，解析 ETS 的依赖关系，检出相关的源码。如果想要某个特定版本的 Mayavi，运行如下命令:

    $ ets co "Mayavi[app]==3.0.1"
   

   如果想得到整个 ETS，运这样的命令(示例):

    $ ets co "ets==3.0.2"
   

   此命令将从 SVN 检出所有相关的源码。请耐心等待，这要花一些时间。关于 ets 工具的更多选项，请看此页面 ETSProjectTools。

3. 一旦检出源码，就可以执行下面的命令:

    $ ets develop
   

   此命令将通过对每个软件包执行 setup.py develop 命令而安装所有检出的源码。

4. 或者，你可能想从源码建立二进制 egg。ets bdist 命令可以像下面这样用来建立 egg (这里我们假设 ets co 将源码检出到 ets-3.0.3):

    $ cd ets-3.0.3
   $ ets bdist
   

   上面的命令将建立所有 egg 并放到 dist 子目录中。运行 ets bdist -h 可以获得更多 bdist 的选项。可以通过下面的命令安装Mayavi 的开发 egg 和依赖软件的 egg:

    $ easy_install -f dist "Mayavi[app]"
   

   或者，如果你希望通过 setup.py develop 只安装 Mayavi，而其它的保持为二进制 egg，可以执行下面的命令:

    $ cd Mayavi_x.y.z
   $ python setup.py develop -f ../dist
   

   上面的命令将从 egg 获得各种依赖关系。

现在你已经安装了最新版 Mayavi，并可以使用了。

测试你的安装

测试安装是否正确的最简单方法是像下面这样运行 mayavi2 应用程序:

 mayavi2

如下可以获得关于此命令更多的帮助信息:

 mayavi2 -h

mayavi2 是 mayavi 的应用程序。在一些平台上，如 win32，你需要双击 Python2X\Scripts 目录中的 mayavi2.exe 程序。请确认这个目录在系统路径中。

Note

Mayavi 有其它多种使用方式，但是 mayavi2 应用程序是最简单的开始方式。

如果你有 mayavi 的 tarball 源码包，或者从 SVN 仓库检出了源码，可以运行 enthought.mayavi*/examples 里的例子，这里有大量的例子演示各种特性。在子目录 enthought.mayavi*/tests 中有测试程序。

解决问题

如果你在安装过程中遇到问题，可以在此页 getting-help 获得如何查询信息和使用邮件列表的详细信息。