显示标签为“python”的博文。显示所有博文
显示标签为“python”的博文。显示所有博文

2009年8月7日星期五

Mayavi2 用户手册4——使用Mayavi应用程序

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

章节概要

本章主要关注如何使用mayavi2应用程序。这里的一些内容也适用于在脚本中使用mayavi。我们建议新用户阅读此章以获得关于交互使用库程序的知识。

用户界面(UI)的通常布局

当mayavi2应用程序启动时,将出现一个如下图所示的用户界面。

Mayavi的初始用户界面窗口

Mayavi的初始用户界面窗口

此用户界面包括如下几部分。

菜单

使用菜单可以打开文件,载入模块,设置首选项等。

Mayavi引擎树视图(engine tree view)

这是mayavi管道的树视图。 * 右键单击一个树节点可以可以重命名、删除、复制对象。

  • 左键单击一个节点,可以在树视图下面的对象编辑器中编辑其属性。

  • 可以在树视图上拖动节点。例如可以把一个模块从一组模块拖到另一组,或者把一个场景从一个可视化移到另一个可视化。

对象编辑器(object editor)

当单击mayavi管道中的一个对象时,在这里可以编辑其属性。

TVTK场景(scene)

这里显示数据可视化结果。可以使用鼠标和键盘与场景交互。更多细节在下面的章节中。

Python解释器(interpreter)

内置的Python解释器可以用来执行mayavi脚本和做其他事情。可以从mayavi的树视图内将节点拖到解释器内,然后对此节点所代表的对象编写脚本。

如果你安装了高于0.9.1的IPython,Python解释器将使用IPython。

日志(Logger)

可以在此查看应用程序日志消息。

Mayavi的用户界面布局具有高可配置性:

  • 可以拖动各部分之间的线以改变相应视图的大小。

  • 大部分标签可以拖到程序内的任意地方。

  • 每个视图(mayavi引擎视图,对象编辑器,python解释器和日志)都可以在“View”菜单中打开和关闭。

每次改变mayavi的界面设置,都被保存下来,下一次启动应用程序会保持相同的设置。另外,也可以使用View->Perspectives菜单项将不同的布局保存为不同的“perspectives”。

下面是一个特定配置的mayavi用户界面。这里各部分的大小都被改变了。

特定配置的mayavi用户界面

特定配置的mayavi用户界面

可视化数据

在Mayavi中可视化数据可通过下列步骤实现:将数据载入为数据源(data sources),将可视化模块应用于这些数据源以可视化数据,更多描述请参考an-overview-of-mayavi和learning-mayavi-by-example。

在使用模块或过滤器之前,需要载入数据或进行类似的操作。Mayavi支持几种数据文件格式,最主要的是VTK数据文件格式。或者,mlab 可用来从numpy矩阵中载入数据。关于数据结构的更多信息,请参考 data-structures-used-by-mayavi。

数据被载入后,就可以使用各种过滤器filters过滤或其他方法修改数据,然后使用几个模块 modules来可视化数据。

这里列出所有的Mayavi模块和过滤器。此列表作为参考很有用:

Unknown element:
.. toctree::

modules.rst filters.rst

与场景交互

在用户界面中的TVTK场景可以通过单击标签的“x”图标来关闭。每个场景有一个工具栏,包括各种功能:

  • 设置沿着X、Y和Z轴正负方向的等比例视图的按钮。

  • 打开平行投影代替默认的透视投影的按钮。查看二维图形时特别有用。

  • 显示xyz坐标轴的按钮。

  • 打开全屏视图的按钮。注意,进入全屏模式后,可以输入“q”或“e”回到正常窗口。

  • 将场景保存为各种图形格式的按钮。图形格式取决于文件后缀。

  • 打开场景配置界面的按钮。

与场景交互的主要方法是使用鼠标和键盘。

鼠标交互

有两种鼠标交互的模式。

  • 照相机模式:默认模式,使用鼠标操作照相机。输入“c”键可激活此模式。

  • 角色模式(Actor mode):使用鼠标操作其所指向的角色。输入“a”键可激活此模式。

场景视图可以通过操作鼠标进行变换,通常是按住鼠标键然后拖动从而完成操作。

  • 按住鼠标左键并拖动将在移动的方向上旋转照相机/角色。

    • 同时按住“SHIFT”键将移动场景——正如按住鼠标中键并拖动一样。

    • 同时按住“CONTROL”将围绕照相机焦点旋转。

    • 同时按住“SHIFT”和“CONTROL”并向上拖动将放大,向下则缩小。这与右键相同。

  • 按住右键并向上拖动将放大(或增加角色比例),向下拖动则缩小(或减小角色比例)。

  • 按住鼠标中键并拖动将移动场景或移动(translate)对象。

  • 向上滚动鼠标滚轮将放大,反之缩小。

键盘交互

场景支持下列键盘命令:

  • '3': 打开/关闭立体渲染(stereo render)。如果“stereo”首选项没有设为True,此命令可能无效。

  • 'a': 将鼠标交互设为角色模式。

  • 'c': 将鼠标交互设为照相机模式。

  • 'e'/'q'/'Esc': 退出全屏模式。

  • 'f': 将照相机焦点移到鼠标所指位置。这将移动照相机焦点从而将视图中心移动至鼠标所指位置。

  • 'j': 将鼠标交互设为操纵杆模式。在操纵杆模式中,鼠标在一定程度上模拟操纵杆。例如,按住鼠标左键从中心移开将转动场景。

  • 'l': 配置场景的照明。这将打开一个弹出窗口以改变照明设置。

  • 'p': 获取鼠标位置处的数据。这将打开一个弹出窗口显示获取的数据。此界面允许用户改变获取数据的来源:单元(cell),点(point),或任意点(arbitrary point)。

  • 'r': 重置照相机焦点和位置。这是个很方便的命令。

  • 's': 将场景保存为图片。这将打开一个文件选择对话框,文件名后缀决定图片类型。

  • 't': 将鼠标交互设为轨迹球模式(trackball mode),此为鼠标交互的默认模式。

  • '='/'+': 放大。

  • '-': 缩小。

  • '方向键': 按方向键可以转动照相机。同时按下"SHIFT"键,则移动照相机。

内置的Python解释器

内置的Python解释器为产生超强功能提供了可能性。此解释器具有命令补全、文档自动生成、工具提示和多行编辑等功能。另外,它还提供下列功能:

  • 名字mayavi自动地绑定到enthought.mayavi.script.Script实例,方便编写mayavi脚本。

  • 名字``application``绑定到envisage程序。

  • 如果通过File->Open File...菜单项打开Python文件,可以使用一个具有语法高亮功能的编辑器对其编辑。使用Control-r可以执行脚本,Control-s可保存文件,当编写简单mayavi脚本时很方便。也可以使用Control-n和Control-s增大和减少字体。

  • 正如上面提到的,可以从Mayavi引擎树视图中将节点拖入Python解释器,对象将被正常写入脚本语句。通常使用的模式如下:

       >>> tvtk_scene_1

    >>> s = _

    在此例中,名称\ ``s``\ 被绑定到拖入的tvtk_scene对象。\ ``_``\ 变量保存了最后使用的表达式,这里即为拖入的对象。使用\ ``tvtk_scene_1``\ 也可以,但此变量名称是系统自动生成的,其中的数字没有具体含义(mouthful)。

自动生成脚本

Mayavi具有非常便利和强大的脚本记录功能,可用于下列方面:

  • 将所有操作记录为易于阅读的Python脚本,可以用来重新生成可视化结果。

  • 易于学习Mayavi的编码基础和如何编辑脚本。

录制mayavi操作为脚本

这里是使用此功能的方法:

  1. 当启动mayavi2程序时,引擎视图(树视图)的工具栏有一个红色的记录图标,在问号图标旁边,单击此图标。此操作也可以在独立的mlab会话中进行。

  2. 将弹出一个窗口,其中有一些样本代码行,可以独立运行或使用下列方式运行:mayavi2 -x script.py或者python script.py。

  3. 在UI内进行想做的操作,此时可以看到执行这些操作所需的代码。例如,产生一个新数据源(通过增加节点对话框,文件菜单或右键单击任意选项),然后增加一个模块/过滤器等等。在树视图中编辑对象。

  4. 移动UI中的照相机,旋转,放大,缩小。所有这些操作将产生相应的代码。对于照相机,只有最终位置被存下来(否则将产生无数无用的代码行)。对于场景的主要键盘操作将被记录(除了 'c'/'t'/'j'/'a')。这意味着程序将记录方向键和'+'/'-'键等。

    进行操作的同时代码被更新,这是学习mayavi API的好方式。

  5. 完成操作后,再次单击记录图标,程序将询问保存文件的名称,例如script.py。如果只对代码感兴趣而不愿保存文件,单击'cancel'。

  6. 关闭记录窗口,退出Mayavi(如果你愿意)。

  7. 现在从解释器输入:

     $  mayavi2 -x script.py

    或:

     $ python script.py

    这样将运行所有代码,回到你上次离开时的状态。你可以自由地修改此脚本--事实上这正是自动代码生成的意义所在!

也可以对现有的Mayavi会话进行编程,理解这一点很重要。所以,如果启动mayavi后,你做了一些操作,或运行一个mayavi脚本,接着想记录以 后的操作,这是可以完成的。按照以前一样的流程进行即可。这里需要记住的一点是脚本记录器不创建你在此会话中已经建立的对象。

Note

也可以删除或拖动mayavi树视图中的对象。然而这可能不是你想在自动记录的脚本中所进行的操作。

正如前面所谈到的,脚本记录在mlab会话中或其他使用mayavi的地方都有效。任何mlab专用代码不会被记录,只有使用OO Mayavi API的代码才会被记录下来。

限制

脚本记录器将记录大多数重要的操作。但不支持下列操作:

  • 在场景中,“c”/“t”/“j”/“a”/“p”按键操作不能正确地记录。原因在于其实现非常复杂,对于基本的脚本编写没有必要。

  • 对界面的任意的脚本显然不会正常工作。

  • 只有改变特性(trait)和执行的特定方法(call)能被记录在代码中。所以执行任意对象的任意方法通常不会被记录下来,只有mayavi引擎的特定方法可以被记录下来。

命令行参数

下面的章节将介绍几个``mayavi2``应用程序的命令行参数。这些介绍也可以在mayavi2的用户手册中找到。

完整的管道可以通过命令行建立起来,所以Mayavi可以集成在shell脚本中提供可视化功能。

可以如下运行Mayavi:

 mayavi2 [options] [args]

这里的arg1,arg2等等是可选的文件名,对应于已经保存的Mayavi2可视化(filename.mv2),Mayavi2脚本(filename.py)或任何Mayavi支持的数据文件。如果没有提供参数或选项,mayavi将以默认的空白场景启动。

这些选项如下:

-h

打印所有命令行选项然后退出。与--help相同。

-V

打印Mayavi版本然后退出。与--version相同。

-z file_name

载入之前保存的Mayavi2可视化。与--viz file_name及--visualization file_name相同。

-d data_file

打开所支持格式的数据文件或非文件的数据源对象,包括VTK文件格式(.vtk, .xml, .vt[i,p,r,s,u], .pvt[i,p,r,s,u]),VRML2 (.wrl),3D Studio (.3ds),PLOT3D (*.xyz)和其他所支持的格式。

data_file``也可以是非文件的数据源,例如\ ``ParametricSurface或PointLoad将载入对应的数据源。本选项与--data相同。

-m module-name

模块是事际上对数据进行可视化的对象。给定的module-name将被载入当前ModuleManager。模块名字必须有效,否则将得到出错信息。

如果模块像这样给出:package.sub.module.SomeModule,那么模块(SomeModule)将从``package.sub.module``中导入。mayavi2的标准模块不需要完整路径,例如:

 mayavi2 -d data.vtk -m Outline -m user_modules.AModule

在此例中,Outline是标准模块,user_modules.AModule是某个用户自定义模块。本选项与--module相同。

-f filter-name

过滤器是以某种方式过滤数据的对象。filter-name将载入并对应于当前的源对象或过滤器对象。过滤器必须有效,否则将得到出错信息。

如果过滤器像这样给出:package.sub.filter.SomeFilter,那么过滤器(SomeFilter)将从package.sub.filter导入。mayavi2的标准过滤器不需要完整路径。例如:

 mayavi2 -d data.vtk -f ExtractVectorNorm -f user_filters.AFilter

在此例中,ExtractVectorNorm是一个标准过滤器,user_filters.AFilter是某个用户定义的过滤器。本选项与--filter相同。

-M

在Mayavi管道中启动一个新模块管理器。与--module-mgr相同。

-n

建立一个新窗口或场景。在此之后的选项将作用于新创建的场景。与--new-window相同。

-o

在offscreen模式下运行Mayavi,没有任何图形用户界面。此模式在需要后台渲染图片(例如动画)时非常有用,避免弹出扰人的用户界面。Mayavi脚本(通过-x选项运行)应该在此模式下工作得很好。与--offscreen相同。

-x script-file

运行给定的脚本,同时确保名字空间中的“mayavi”是Mayavi的脚本实例 --就像在内置的Python解释器内一样。与--exec相同.

-s python-expression

对最后建立的对象执行Python命令。假设前一个对象是个模块,如果要设置其颜色并保存场景,可以这样做:

 $ mayavi2 [...] -m Outline -s"actor.property.color = (1,0,0)" \
-s "scene.save('test.png', size=(800, 800))"

应在命令前后使用引号。本选项与--set相同。

Warning

-x或--exec使用execfile,如果脚本做不合适的操作将很危险。类似的,-s或--set使用exec,如不适当使用也很危险。

还有很重要的一点,mayavi的命令行参数是按照给出顺序依次处理的。由此用户可以实现一些有趣的操作。

下面是一些命令行参数的例子:

 $ mayavi2 -d ParametricSurface -s "function='dini'" -m Surface \
-s "module_manager.scalar_lut_manager.show_scalar_bar = True" \
-s "scene.isometric_view()" -s "scene.save('snapshot.png')"

$ mayavi2 -d heart.vtk -m Axes -m Outline -m GridPlane \
-m ContourGridPlane -m IsoSurface

$ mayavi2 -d fire_ug.vtu -m Axes -m Outline -m VectorCutPlane \
-f MaskPoints -m Glyph

在上面的例子中,heart.vtk和fire_ug.vtu等VTK文件可以在源文件目录的examples/data中找到。它们是否安装到你的电脑取决于你的操作系统。

[......]

2009年7月12日星期日

Mayavi2 用户手册3.5——探索向量场

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

在此例中,我们从标量场的梯度(gradient)中产生向量场,然后交互地查看。此例介绍怎样交互地进行类似前面例子的操作,例如使用过滤器 (filter)和模块(module)。前面的例子使用 `numpy`进行大多数操作,这一步则需要对 Mayavi 和 VTK 过滤器有更多的了解。与之对应的益处是可以交互地进行可视化。

首先,我们生成与前面例子相同的标量场。打开 Mayavi,在 Python 命令行内输入下面的代码:

 from enthought.mayavi import mlab
import numpy as np

def V(x, y, z):
""" A 3D sinusoidal lattice with a parabolic confinement. """
return np.cos(10*x) + np.cos(10*y) + np.cos(10*z) + 2*(x**2 + y**2 + z**2)
X, Y, Z = np.mgrid[-2:2:100j, -2:2:100j, -2:2:100j]
mlab.contour3d(X, Y, Z, V)

像前面的例子一样,可以改变调色板(color map)和在等值面中选定的数值。

为了使用标量场梯度生成向量场,我们将使用`CellDerivative`滤波器。此滤波器可获得单元(也就是点之间,请参考data- structures-used-by-mayavi)内数据的微分。首先使用`PointToCellData`滤波器对单元内各点进行插值,然后使用 `CellDerivatives`滤波器,接着使用`CellToPointData`滤波器重新获得点数据。

使用`VectorCutPlane`模块可以可视化向量场。生成的标量数据太大,我们可以在`Glyph`标签(以及在此标签内的`Glyph` 标签)将缩放比例(scale factor)减少为0.2。向量场还是太密集,可以在`Masking`标签打开遮蔽(masking)功能,将`on ratio`设为6 (one arrow out of 6 is masked)并关闭随机模式(random mode)。

example_vector_cut_plane.jpg

为了获得更漂亮的颜色,可以改变向量场的调色板:在`VectorCutPlane`上面的`Colors and legend`节点,找到**in the VectorLUT**标签,选择查找表,那里有向量和标量数据的不同调色板。

不像之前的例子,我们可以在对话框中试试各种参数,例如遮蔽,或在`Glyph`标签选择`color_by_scalar`来显示势值(the value of the potential)。我们也可以拖动显示向量的剖面。

既然有了3D向量场,可以使用Mayavi集成(integrate)其中一个粒子的轨迹。为此,我们可以使用streamline模块。此模块显 示起始于种子(seed)表面顶点的轨迹。选择`Point Widget`作为种子(在`Seed`标签),可以在3D场景中拖动种子点。这使我们可以在产生于初始标量场的势位中探索轨迹。这里,所有的轨迹终止于 局部极小势位。可以移动种子点,使我们可以看到每个点将陷入的极小值之处,换句话说,每个局部极小的吸引盆(basin of attraction)。

example_streamline.jpg

[......]

2009年6月28日星期日

Mayavi2 用户手册3.4——与 scipy 一起使用 Mayavi

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

此教程的例子讲解当使用 scipy 进行数值计算时如何利用 Mayavi 交互地可视化 numpy 数组。此教程假设你熟悉 Python 的数值工具,然后讲解如何使用 Mayavi 与这些工具协同工作。

让我们来研究电势(potential)中例子的轨迹。这在物理和工程中是很常见的问题,电势和轨迹可视化的关键是理解此问题。

我们所关心的电势是一个周期性栅格(periodic lattice), 沉浸在抛物线约束(parabolic confinement)中。我们振动此电势然后查看粒子从一个栅格的洞(hole)跳到另一个的情况。抛物线约束在那里限制粒子的偏移 (excursion)。:

 import numpy as np

def V(x, y, z):
""" A 3D sinusoidal lattice with a parabolic confinement. """
return np.cos(10*x) + np.cos(10*y) + np.cos(10*z) + 2*(x**2 + y**2 + z**2)

既然我们定义好了电势,我们看看在三维中看起来是什么样子。我们可以创建一个点组成的三维网格,然后在这些点处进行采样:

 X, Y, Z = np.mgrid[-2:2:100j, -2:2:100j, -2:2:100j]
V(X, Y, Z)

我们将使用 mlab 模块(请参考simple-scripting-with-mlab)交互地可视化此容量数据(volumetric data)。为此,最好在 Python 的交互命令行输入命令,使用 Mayavi2 内建的命令行或 ipython -wthread。下面我们可视化电势的三维 iso 曲面:

 from enthought.mayavi import mlab
mlab.contour3d(X, Y, Z, V)

我们可以与上面的命令产生的可视化结果进行交互,例如旋转视图。但是为了更好的理解电势的结构,变化 iso 曲面是很有用的。我们可以在 Mayavi 管道树(如果你从 ipython 中运行,需要单击场景中的 Mayavi 图标以弹出管道树) 中双击`IsoSurface`。这将打开一个对话框,允许我们选择轮廓的数值。好的电势视图可以这样获得:关闭 auto contour 并选择 -0.5 作为第一个轮廓数值 (例如,在左边的文本输入框输入数值并按 tab 键)。单击蓝色箭头并选择"Add after"可以加入第二个轮廓值。使用数值15可以得到较好的结果。

我们现在可以管道线中单击 Colors and legends 然后选择不同的 LUT (查找表)以改变使用的颜色。让我们选择 'Paired',因为它可以很好的分开层次。

example_potential_ipython.jpg

为了得到更好的电势视图,我们想显示更多的轮廓,但是其问题是封闭的轮廓隐藏了内部情况。一个解决方案是使用剖面。右击 IsoSurface 节点,通过 "Add module" 子菜单添加 ScalarCutPlane。单击并拖动它可以移动此剖面。

为了实现 numpy 数组和可视化之间的联系,我们可以使用相同的菜单添加 Axes 和 Outline。最后,让我们添加一个颜色条。输入下面的命令:

 mlab.colorbar(title='Potential', orientation='vertical')

或者使用先前使用的 LUT 中的选项。

example_potential.jpg

我们想研究此电势中粒子的运动。为此我们需要推导电势陡度(gradient)相应的力。我们建立陡度函数:

 def gradient(f, x, y, z, d=0.01):
""" Return the gradient of f in (x, y, z). """
fx = f(x+d, y, z)
fx_ = f(x-d, y, z)
fy = f(x, y+d, z)
fy_ = f(x, y-d, z)
fz = f(x, y, z+d)
fz_ = f(x, y, z-d)
return (fx-fx_)/(2*d), (fy-fy_)/(2*d), (fz-fz_)/(2*d)

为了检查陡度函数是否工作正常,让我们可视化它产生的向量场。为了避免显示太多的向量,我们将仅仅评定 X=50 处剖面的陡度,并且只在网格中每三个点评定一个:

 Vx, Vy, Vz = gradient(V, X[50, ::3, ::3], Y[50, ::3, ::3], Z[50, ::3, ::3])
mlab.quiver3d(X[50, ::3, ::3], Y[50, ::3, ::3], Z[50, ::3, ::3],
Vx, Vy, Vz, scale_factor=-0.2, color=(1, 1, 1))

example_gradient.jpg

现在我们可以使用 scipy 积分轨迹。首先必须定义动态流体,这是一个这些参数和时间的函数,返回不同参数的导数。此流体被每个 ODE (常微分方程) 解算器(solver)所使用。它给出系统动态(dynamic)。我们关心的动态由电势推导出的力造成,而我们在三个方向上随时间振动此电势,作为阻尼力。调节阻尼系数及振动的数量和频率可以给出有趣的动态。 :

 def flow(r, t):
""" The dynamical flow of the system """
x, y, z, vx, vy, vz = r
fx, fy, fz = gradient(V, x-.2*np.sin(6*t), y-.2*np.sin(6*t+1), z-.2*np.sin(6*t+2))
return np.array((vx, vy, vz, -fx - 0.3*vx, -fy - 0.3*vy, -fz - 0.3*vz))

现在我们可以积分轨迹:

 from scipy.integrate import odeint

# Initial conditions
R0 = (0, 0, 0, 0, 0, 0)
# Times at which we want the integrator to return the positions:
t = np.linspace(0, 50, 500)
R = odeint(flow, R0, t)

右击对应的管道线节点,选择 delete 可除去剖面和向量场。然后我们开始绘制此轨迹。同时关闭相应的 Colors and legends 节点的第一个颜色条。我们用与它相关的标量信息绘制轨迹,通过调色板(colormap)显示时间:

 x, y, z, vx, vy, vz = R.T
trajectory = mlab.plot3d(x, y, z, t, colormap='hot',
tube_radius=None)
mlab.colorbar(trajectory, title='Time', orientation='vertical')

example_trajectories.jpg
[......]

2009年6月27日星期六

Mayavi2 用户手册3.3——可视化富数据集(rich dataset): 例子数据 fire_ug.vtu

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

类似 heart.vtk,例子数据集 fire_ug.vtu 也可以在目录 examples/data 中找到。此数据集是一个非结构化的网格(unstructured grid),存在一个 VTK XML 文件中,表示一个角落中有火的房间。通过模拟此火焰的流体,将一个特定时刻的结果保存在此文件中。此数据集由 Philip Rubini 博士提供 (当时 Rubini 博士在 Cranfield 大学)。同时提供了一个 VRML 文件,显示火焰被取走的房间情况。

  1. 启动 mayavi2,选择 File->Load data->Open file 来载入数据。再次在左边的树形显示中看到一个节点,但在 TVTK 场景中没有任何显示。此数据集在一个文件中包含了不同的标量和向量数据。如果选择左边的 VTK XML file... 节点,在对象编辑器中将配置读入器(reader)。在其中,可以看到此数据文件中所有标量和向量的下拉列表。任意选择其中一个。

  2. 按照前面所述,使用 Outline 模块建立数据的轮廓。建立 IsoSurface 模块以查看数据的 iso-曲面。也请试试 ScalarCutPlane 模块。

  3. 单击 Colors and legends 节点,选中 Show scalar bar,显示映射颜色的标尺(通过查找表(Look up table)将标量映射为颜色)。试试不同的默认颜色映射。

  4. 现在单击 VTK XML file ... 并选择不同的标量来查看数据如何变化。当标量改变时,图例将自动更新。

  5. 此数据也包括向量。标量数据有 u,v和 w,但没有速度的大小。假设我们希望查看速度大小的 iso-曲面,可以使用 ExtractVectorNorm 过滤器。选择 Visualize->Filters->Extract Vector Norm 菜单可以使用此过滤器。

  6. 如果现在建立 ScalarCutPlane,可以在 ExtractVectorNorm 节点下看到 Colors and legends 节点。这个标量剖面用颜色显示此过滤器生成的速度大小。可以将 iso-曲面模块从另一个 Colors and legends 节点下拖到此 Colors and legends 节点下,使得生成的 Iso-曲面 是关于速度大小的,而不是关于所选的标量。

    注意:左边的显示树表示如下的数据流动管道, source -> filter -> modules。本质上是数据从父节点流到其下的子节点。

    现在如果你想在管道的不同分支进行可视化,例如你想查看温度数据的 iso 曲面,必须单击模块或源对象(VTK XML File ... 节点)本身,然后选择菜单项。当选择了显示树中的一项,此项目成为当前对象,其后选择的菜单项将在当前对象下建立新模块/滤波器。

  7. 可以过滤"已经过滤的数据"。选择 ExtractVectorNorm 节点使其成为当前对象。现在通过 Visualize->Filters->Threshold 建立 Threshold 滤波器。然后在对象编辑器中设置上限和下限,例如 0.5 和 3.0。如果在这里建立 VectorCutPlane 模块,并且移动此剖面,应该能看到箭头,但是只有位于上下限之间的箭头。因此可以使用这样的步骤建立很复杂的可视化管道。

  8. 有几个向量模块:VectorCutPlane,Vectors,WarpVectorCutPlane和Streamlines。如果查看流线(streamline),mayavi 将产生数据集中向量的流线。为了查看初始数据集的流线,可以单击原先的 Outline 模块(或数据源),然后选择 Streamline 菜单项。可以使用3D小部件移动屏幕上不同类型的种子(seed)。这些位置的种子点(seed point)用来跟踪流线。球(Sphere)、线和平面源可以用来初始化流线种子。

  9. 选择 File->Open->VRML2 file 菜单项打开 VRML 文件``room_vis.wrl``,可以查看着火的房间。

  10. 建立起复杂的可视化管道后,想将其保存下来以便以后再查看,可以通过 File->Save Visualization 菜单项保存整个可视化。可以使用 File->Load Visualization 菜单项载入保存后的文件。此选项并不是100%鲁棒,仍在实验阶段。后续版本将改善此功能。毕竟,此功能暂时可以使用。

再次说明,此例中的可视化是使用用户界面生成的,但可以完全使用 Python 脚本完成。一个简单的脚本 examples/streamline.py 演示了几个上面的模块。用户可以研究一下此文件。可按照如下方式运行此脚本:

 $ cd examples
$ python streamline.py

或者:

 $ mayavi2 -x streamline.py

从此例可以看到,编写脚本使用 mayavi 进行可视化是很简单的。下面是此脚本生成的图形。


[......]

2009年5月19日星期二

VPython和WxPython协作的演示程序


一直在用VPython 4.0Beta,忽然发现VPython跳过4.0直接发布了5.0,特发一个自己编写的VPython和WxPython协作的演示程序以示祝贺。

此演示程序在VPython 4.0Beta和WxPython 2.8下测试通过,操作系统为WinXP和Hiweed2RC3,不过在Hiweed中似乎不能正常退出。程序很简单:
  1. 显示一个VPython生成的动画窗口和WxPython生成的控制窗口
  2. 在动画窗口中有一辆行驶的汽车
  3. 在控制窗口中可以启动、停止动画窗口内的汽车,可调节行驶速度,可单步前进后退


下面的命令可启动程序:
python main.py


欢迎来信指教、讨论。源程序在这里:


[......]

2009年4月12日星期日

Mayavi2 用户手册3.2——载入标量数据: 例子heart.vtk

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

本章介绍一个使用 heart.vtk 文件的简单例子。这是一个 32 x 32 x 12 个点的3D 数据,每个点处是标量数据,并且这些点在空间平均分布。这是一个结构化数据集(structured dataset),事实上是 ImageData。以后我们会读入很多这样的数据,但是现在只要将其当作空间上平均分布的点,每个点有标量数据与之相对应。此数据显然是心脏的CT扫描数据--我不知道这是谁的心脏。此文件是一个易读的文本文件,如果你愿意,可以使用文本编辑器查看。

  1. 确保 mayavi2 已经启动。首先打开数据文件。使用 File->Load data->Open file 菜单项,在打开的文件对话框内,找到包含例子数据的目录,选中 heart.vtk 文件。

    一旦选中数据,可以在 Mayavi 左面的显示树中看到新节点,VTK file (heart.vtk)。注意,在 TVTK 场景中还看不到任何图形。

  2. 为了查看轮廓(outline)——一个方框,找到 Visualize->Modules 菜单项,选择 Outline 模块。在 TVTK 场景中可以立刻看到一个白色方框。在显示树中,也应看到两个新节点,`Colors and legends` 和其下面的 Outline。

  3. 单击左面的 Outline 节点可以改变轮廓的属性。这将在窗口的左下部,显示树的下面,生成“对象编辑窗口”。试着修改其设置,并查看结果。如果你双击左面的节点,将弹出编辑器对话框,而不是嵌入的对象编辑器。

    注意,通常 Module 的编辑器窗口有一部分是 Actor`(角色),一部分为 `Mapper`(映射器),一部分为 `Property`(属性)。这些对应于 TVTK/VTK 术语。可以将 `Property 看作与颜色、表示(representation)(曲面、线框等等)、线宽等等相关。Actor 部分与屏幕上渲染的对象有关,编辑器通常可设置其是否显示。 在 VTK 术语中,Mapper 是指将数据转换为图元(graphics primitive)的对象。与其相关的属性包含在 Mapper 部分。

  4. 关于与 TVTK 场景交互的详细信息,请参考此章节 interaction-with-the-scene并尝试其例子直到熟悉为止。

  5. 现在,保持选中 Outline 节点,选择 Visualize->Modules->IsoSurface 菜单项,生成 iso-曲面。在左面可以看到一个新节点 IsoSurface,在场景中可以看到标量数据的 iso-轮廓。当选中某个 iso数值时,此 iso-曲面被相应地染上颜色。试试修改此模块的各项设置。

  6. 要产生有意义的可视化图形,需要了解每种颜色代表什么。单击显示树的 Colors and legends 节点,在对象编辑器内选中 Show scalar bar`,将在 TVTK 场景中显示颜色图例。单击并拖动图例可以将其在场景中任意移动,单击并拖动其边缘,可以改变其大小。在对象编辑器中选择不同的选项可以改变颜色映射特性。

  7. 生成一个简单的"网格平面(grid plane)"来查看点在网格上的情况。这可以通过 `Visualize->Modules->GridPlane 菜单项,使用 GridPlane 模块来实现。

  8. 右键单击一个特定模块并选择"删除"可将其删除。请在 GridPlane 模块中试试删除以及其他右键菜单选项。

  9. 试试 ContourGridPlane 模块和 ScalarCutPlane 模块。

    ScalarCutPlane 模块有个很强大的特性,称为 三维小部件(3D widgets)。在 TVTK 场景窗口中,可以看到一个剖面(cut plane) 以不同颜色表示切片上的数据。此剖面轮廓为红色,有一个箭头伸出来。可以直接点击并拖动此剖面;点击并拖动箭头可以转动此剖面。也可以使用对象编辑器窗口重设标量剖面。

  10. 单击 TVTK 场景中的保存图标或使用 File->Save Scene As 菜单项可以将可视化结果保存为图片。

你应该得到一个如下所示的图像。

由 heart.vtk 获得的可视化例子

mayavi 的一个优点是:虽然这里所有的操作都通过用户界面完成,但是所有这些操作都可以通过 Python 脚本完成。相关的更多信息请参考这里simple-scripting-with-mlab (更深入的内容请参考advanced-scripting-with-mayavi)。

打开数据文件和启动模块也可以通过命令行完成。例如,可以简单的使用下面的命令:

 $ mayavi2 -d /path/to/heart.vtk -m Outline -m IsoSurface \
> -m GridPlane -m ScalarCutPlane

更多信息在此章command-line-arguments。

[......]

Mayavi2 用户手册3.1——参数曲面(parametric surface): 对可视化的简单介绍

内容来自Mayavi2的中文文档项目。本篇文档的源文件在这里。欢迎感兴趣的朋友加入。
如果不能立刻找到作为例子的数据,参数曲面是非常方便的选择。参数曲面通常由两个变量 u 和 v 参数化获得。VTK 有一系列的类可用来查看参数曲面。Mayavi 也有这个功能。这样的数据是嵌入到三维中的两维表面。曲面上也有标量数据。有关 VTK 参量曲面的更多信息,可以参看 Andrew Maclean 的 Parametric Surfaces。
  1. 启动 mayavi2 后,选择 File->Load data->Create Parametric Surface source 可以生成参数曲面源。生成数据后,可以在 Mayavi 左面的显示树(tree view)中的 ParametricSurface 部分看到新节点。请注意,在 TVTK 场景中,目前还看不到可视化图形。

    可以通过单击 ParametricSurface 的节点来修改参数曲面的特性。

  2. 为了查看轮廓(outline)——一个方框,找到 Visualize->Modules 菜单项,选择 Outline 模块。也可以右键单击 ParametricSurface 节点打开上下文菜单,选择 Add Module->Surface。在 TVTK 场景中将立刻看到一个网架立方体。在显示树中,也应看到两个新节点,`Colors and legends` 和其下面的 Outline。

  3. 单击左面的 Outline 节点可以改变轮廓的属性。这将在窗口的左下部,显示树的下面,生成“对象编辑窗口”。试着修改其设置,并查看结果。例如,修改颜色域的数值以改变轮廓方框的颜色。如果你双击左面的节点,将弹出编辑器对话框,而不是嵌入的对象编辑器。

  4. 关于场景的详细信息,请参考此章节 interaction-with-the-scene并尝试其例子。

  5. 选择 Visualize->Modules->Surface 生成 Surface 模块,可以查看实际的曲面。单击左面的 Surface 节点,打开 Enable contours`,可以显示此曲面上的标量数据。

  6. 单击显示树的 `Modules 节点,可以显示颜色图例(用于将标量数值映射为颜色)。在 'Scalar LUT' 标签,选中 Show scalar bar`,将在 TVTK 场景中显示图例。单击并拖动图例可以将其在场景中任意移动,单击并拖动其边缘,可以改变其大小。在对象编辑器中选择不同的查询表(lookup table),可以改变颜色映射特性。

  7. 可以添加任意多的模块,但不是所有的模块对所有数据都有意义。Mayavi 还没有将对特定数据无意义的模块变成灰色(使其无效)。这一功能将在未来实现。但是犯错误并不可怕,所以请大胆尝试。

  8. 可以添加任意多的数据源。通过选择场景节点然后载入另一个参数曲面源,可以在同一场景中添加两个不同的参数曲面。这是否有意义,取决于用户。也可以添加任 意多的场景,并在其中查看任意数据。还可以在显示树上单击右键,通过上下文菜单在任意节点间剪切/粘贴/复制数据源和模块。

  9. 右键单击 `Outline 节点,选择 Delete,可以删除 Outline 模块。你也可以试试其他的选项。

  10. 使用 File->Save Scene As 菜单项可以将渲染的可视化结果保存为多种文件格式。

  11. 可视化本身可以通过 File->Save Visualization 菜单项保存为文件,也可以使用 Load visualization 菜单项重新载入。

下面是一个使用参数曲面数据源的可视化例子。请注意,在屏幕上移动角色(actor)会影响不同曲面的定位(使用场景的角色模式,通过‘a’键可以移动角色)。更多信息请参考interaction-with-the-scene.

使用参数曲面的可视化例子

[......]

Mayavi2 用户手册3——使用例子学习 Mayavi

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

本章给出一些例子,详细解释如何使用 Mayavi 应用程序,同时介绍其特点。

本章主要介绍 Mayavi 应用程序,这也是将 Mayavi 作为库程序使用的基础。如果你只希望尽快将 Mayavi 简单地像 Matlab 一样作为画图库程序使用,可以直接跳到这一章 simple-scripting-with-mlab,然后再回来深入理解。

要认识 mayavai,首先像下面这样在命令行启动 Mayavi2:

 $ mayavi2

在 Windows 中,可以双击可执行文件 mayavi2.exe (通常在 Python2X\Scripts 目录中);如果你安装了 python(x,y) 或 EPD,可以使用开始菜单中的快捷方式。

Mayavi 启动后,可以改变用户界面各个面板的大小以获得舒服的布局。这些设置将成为mayavi的默认属性。有关用户界面的详细信息可以在此章节获得general-layout-of-ui。

在进行下一步之前,有必要首先找到一些用来做实验的数据。下面的例子中,有两个要使用mayavi 自带的数据,可以在 mayavi 根目录中的 examples/data 目录中找到。如果没有安装这些数据,可以从这里下载: http://code.enthought.com/enstaller/eggs/source/

例子:

  1. 参数曲面(parametric surface): 对可视化的简单介绍
  2. 载入标量数据: 例子heart.vtk
  3. 可视化富数据集(rich dataset): 例子数据 fire_ug.vtu
  4. 与 scipy 一起使用 Mayavi
  5. 探索向量场
[......]

2009年3月11日星期三

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 时:

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

  • 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

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

更多细节在前一节中。

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/ )

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

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

     easy_install Sphinx EnvisageCore EnvisagePlugins configobj
  3. 最后,在命令行(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 获得如何查询信息和使用邮件列表的详细信息。

[......]

2009年2月23日星期一

Mayavi2 用户手册1 概览


这个帖子说明有朋友在寻找Mayavi的信息时访问了本园子,现在就贴一篇关于Mayavi2的介绍,希望他们能再次光临。

内容来自Mayavi2的中文文档项目。去年10月底就建立了此项目,由于时间比较紧,进展极其缓慢。Mayavi2的文档采用reStructuredText格式(本篇文档的源文件在这里),使用Sphinx将rst文件及图片等转换为完整的文档网站。帖子中没有给出的链接,正是指向其它文档页面。我会陆续贴上来。也欢迎感兴趣的朋友加入。

章节摘要

本章简要介绍什么是 Mayavi,并告诉你在这本手册的什么地方可以找到与你的情况相关的信息。

简介

Mayavi2 致力于简便的3D数据可视化功能。主要通过下列方式实现:

  • 可选的富用户界面,包括可与可视化中的所有数据和对象交互的对话框。

  • 简洁的 Python 脚本界面,包括即用型3D可视化功能,与 Matlab 或 matplotlib (使用 mlab ), 或面向对象的编程界面。

  • 不需要 VTK 即可使用其强大功能。

另外,Mayavi2 努力成为可重用的工具,即以各种方式嵌入你的库程序或应用软件里,或与 Envisage 应用程序创建框架(application-building framework)共同组建特定领域的工具。

Mayavi2 是什么?

Mayavi2 是一个通用的、跨平台 3D 科学数据可视化工具。其特点如下:

  • 标量、向量、张量的 2D 和 3D 的可视化。

  • 可方便地使用Python编写脚本。

  • 可方便地修改源代码,模块和数据过滤器进行扩展。

  • 可读入多种数据格式:VTK (legacy 和 XML), PLOT3D 等。

  • 保存可视化操作。

  • 以多种图形格式保存渲染的可视化结果。

  • 通过 mlab 为快速科学绘图提供方便的功能。 (参考 simple-scripting-with-mlab).

不像它的前身 Mayavi1,Mayavi2 重新设计为具有脚步和可扩展功能。Mayavi2 提供 ``mayavi2``应用程序,其本身可独立使用。而且,Mayavi2 可以像 matplotlib 或 gnuplot 那样在脚本中用作绘图引擎,就像其它应用程序中用作交互可视化的库程序。它也可以用作 Envisage 的插件,天然地嵌入基于 Envisage 的应用程序中。

技术细节

Mayavi2 提供通用的可视化引擎,像VTK那样基于管道架构。Mayavi2 也提供 Envisage 插件,用于2D/3D科学数据可视化。Mayavi2 使用 Enthought 工具包(ETS),如 Traits, TVTK 和 Envisage_,下面是它的一部分特点:

  • Pythonic API 利用了 Traits 的所有优势。

  • Mayavi 可以天然地、透明地与 numpy 矩阵一起使用。(得益于 TVTK 的使用)

  • 由于使用了 MVC 设计,比 Mayavi-1 更容易编写脚本。

  • 方便地通过加入资源、组件、模块和数据过滤器进行扩展。

  • 提供 Envisage 插件,这意味着:

    • 在 Mayavi 中很容易地使用其他 Envisage 插件。例如,Mayavi 提供嵌入的 Python 命令行解释器。这是一个 Envisage 插件,在 Mayavi 中只需要一行代码。

    • 在基于 Envisage 的应用程序中容易地使用 Mayavi。因此所有基于 Envisage 的应用程序可以轻松使用 Mayavi 插件,编写脚本以可视化数据。

  • 基于 wxPython/Qt4 的 GUI(得益于 Traits,PyFace 和 Envisage). 很重要的一点是 Mayavi 的源程序中没有直接使用 wxPython 或 Qt4。

  • 非侵入式、重用型设计。不用基于 wxPython 或 Qt4 的图形界面,也可以使用 Mayavi。

Note

下面所有章节均假设你已经有工作正常的 Mayavi 。下载和安装 Mayavi,请参考下一章 installation.

将 Mayavi 作为独立程序或库程序?

用户主要有三种方法使用 Mayavi :

  1. 图形方式使用 mayavi2 应用程序.更多相关信息请参考 :ref:using-the-mayavi-application`。

  2. 在简单的 Python 脚本中用作绘图引擎. 脚本 API mlab 提供了在批处理脚本中使用 Mayavi 的简单方式,更多相关 信息请参考 :ref:`simple-scripting-with-mlab`。

  3. 在 Python 中编写 Mayavi 应用脚本。Mayavi 应用程序本身提供了强大的 通用脚本 API,可以适应你的需求。

    1. 可在使用 mayavi2 应用程序时编写脚本自动完成任务及扩展 Mayavi。

    2. 可在自己的基于 Python 的应用中编写 Mayavi 脚本。

    3. 可使用 Envisage 或其他各种方式将 Mayavi 嵌入你的应用中。

    更多详细信息请参考 :ref:`advanced-scripting-with-mayavi`。

场景(Scenes)、数据源和可视化模块:管道模块

Mayavi 使用类似 VTK 的管道(pipeline)结构。对用户而言,可以简化为如下层次。

  • 数据被载入 Mayavi 后存储在数据源中(使用文件或由脚本产生)。可以打开任意多个数据文件或数据对象。数据源是富对象,描述了数据但没有指定如何可视化。

  • 这些数据可以使用过滤器处理(可选),使用可视化模块进行可视化操作。这些过滤器和模块可以通过用户界面的 `Visualize 菜单项或上下文菜单访问到,或在编写 Mayavi 脚本将其实例化为 Python 对象。

    区别数据源、数据容器和可视化工具的原因是由于有很多不同的查看数据方式。例如下面的图片都是相同数据通过应用不同的模块而获得的。



  • 所有对象属于一个 场景 -- 这是 3D 可视化中的一片区域。在交互应用程序中,新的场景可以通过使用菜单 File->New->VTK Scene 来创建。

将数据载入 Mayavi

Mayavi 是一个科学数据可视化工具。准备数据的主要方式有两个:

  1. 将数据存入其所支持的数据文件格式,例如 VTK legacy 或 VTK XML 文件等。更多关于 VTK 的信息请参考 VTK 文件格式 VTK file formats。这些文件在交互应用程序中可以通过菜单载入。

  2. 通过 numpy 数组或其它序列产生 TVTK 数据集(dataset)。最容易的方式是使用脚本API, 例如 `mlab`。 (参看这一段 creating data sources with mlab ,或者 3D 绘图函数: mlab_plotting_functions).

另外,如果你希望通过建立 VTK 数据结构或文件以获得更深入的理解,请参考此章节关于数据集的一般信息 data-structures-used-by-mayavi。

[......]

2009年1月7日星期三

最具建设性的Traceback

面对错误跟踪信息(traceback),我常常丈二和尚摸不着头脑。

很多情况下,根据traceback只可以估计错误可能在哪一行附近——注意,这里用了“可能”和“附近”——真正的错误原因和代码行可能与traceback的提示相差十万八千里。但是,也有例外。

执行下面的命令
esn@esn-laptop:~$ python -c 'sum(["a","b","c"],"")'
Traceback (most recent call last):
File "<string>", line 1, in <module>
TypeError: sum() can't sum strings [use ''.join(seq) instead]

哈,这是我见到的最具建设性的错误反馈。

如果所有的Traceback都这么智能,编程就简单了,不过,那样的话还需要人编程吗?

注:python的版本
esn@esn-laptop:~$ python -V
Python 2.5.2


[......]

2008年12月24日星期三

解决在pythonxy 2.1 里使用SPE时的错误

在 Pythonxy 2.1 (windows xp)环境里使用SPE,会遇到下面的错误:
This application requires a version of wxPython greater than or equal to 2.5.4.1, but a matching version was not found.
You currently have these version(s) installed:
Would you like to download a new version of wxPython?
在Pythonxy的google code上有关于此bug的说明:Issue 37 - pythonxy - Google Code。安装新的wxPython插件就可以解决问题。

另外,建立一个这样的快捷方式,可以方便地启动SPE
C:\pythonxy\python\pythonw.exe C:\_spe\SPE.pyw

[......]

2008年12月20日星期六

在vim中修改 python 程序的缩进方式

我自己的 VIM 里为 python 设置的缩进为4个空格,但是从网上找到的程序有时是一个空格或两个空格。可以在VIM中用下面的命令改为4空格缩进:
1转4的情况:
:%s/\(^\s*\)\@<=\s\s/    /
2转4的情况
:%s/\(^\(\s\s\)*\)\@<=\s\s/    /
注意:上述命令中,最后的两个斜杠中间是4个空格

这两个命令用到了正则表达式,下面以第一个命令为例进行说明。
  • 这条命令的作用
将每一行开头的每个空格分别替换为4个空格。
  • VIM中替换命令的基本结构
:范围s/被替换掉的字符串/替换为的字符串/选项
其中s表示substitute
  • 具体说明
% 表示整个文件内容
^ 匹配一行的开头
\s 匹配空格
* 表示此符号前面的部分出现0次或多次,例如 \s* 匹配0个或多个空格
\(...\) 表示分组
\@<= 表示此符号之前的部分必须位于匹配结果之前(不准确),称为“向前查看”。 \(^\s*\)\@<= 意为所匹配结果到此行开头什么都没有或只有空格
在Vim中使用“:help regex”可以查看关于正则表达式的帮助信息,非常详细。也可以使用这样的命令“:help \@<=”直接找到相关的帮助信息。当然也可以搜索google。

另外,网上有大量关于perl的正则表达式教程,原理基本相同。其中(?=)即对应为Vim中的\@<=,另一个区别是
# Perl的写法
(?<=查看内容)匹配内容

# Vim的写法
\(查看内容\)\@<=匹配内容
[......]

2008年12月18日星期四

安装Python-visual 4.0beta

Vpython
为了使用 Python-visual 的新特性——表面材质(Surface Texture),更多的框架特性,灯光等等,在 hiweed2rc 上安装了最新的 4.0beta。
sudo apt-get install libboost-python-dev ftgl-dev libgtkglextmm-x11-dev libgle3-dev libgtkmm-dev libglademm-2.4-dev  scons
tar xjf visual-4.beta26.tar.bz2
  • 修改visual-4.beta26/src/core/util/errors.cpp,在开头加入“#include <stdlib.h>”,否则make时会出现下面的错误:
./core/util/errors.cpp: In function 'void cvisual::write_note(std::string, int,
std::string)':
./core/util/errors.cpp:40: error: 'getenv' was not declared in this scope
这是gcc-4.3的问题
  • 编译
cd ./visual-4.beta26
./configure; make
  • 安装
sudo make install
  • 测试
cd ./example
python texture_and_lighting.py
一切正常的话,就可以看到文章开头那样的动画。
[......]

2008年11月30日星期日

安装最新的 Mayavi2

为了安装Mayavi2,需要vtk4.4以上版本,dapper源里是4.2,所以下载源码安装。主要参考此文
sudo apt-get install mesa-common-dev
  • cmake成功后,make时又有错误,找不到GL/glx.h。
在网上搜索无果,只好放弃在Hiweed1上安装。转而在virtualbox上安装基于ubuntu8.10的hiweed2RC,源里的软件都新,可以方便的用apt-get安装,省得自己从源码装。等Hiweed出正式版了,再安装在硬盘上--这是后话。

此时virtualbox是1.6.2版,无法正常安装Guest Addition。于是
  • 卸载旧的,下载安装最新的2.0版:
sudo apt-get remove virtualbox
sudo dpkg -i virtualbox-2.0_2.0.4-38406_Ubuntu_dapper_i386.deb
sudo sh /media/cdrom0/VBoxLinuxAdditions-x86.run
这里有个奇怪的问题,首先在PCMan File Manager里打开光驱,然后才能在LXTerminal里看到光驱里的文件。
  • 最后记得重启guest。

按照Mayavi2用户指南开始安装最新的svn。
  • 首先安装必须的包。
sudo apt-get install python-vtk python-wxgtk2.8 python-setuptools python-numpy python-configobj
svn co https://svn.enthought.com/svn/enthought/ETSProjectTools/trunk ETSProjectTools
cd ETSProjectTools
sudo python setup.py install
  • 下载安装所有ETS包,包括Mayavi2
ets co "ets"
cd ETS3.0.3
sudo ets develop
此时遇到无数的错误信息,原来是没有安装g++,及python的dev包。补上:
sudo apt-get install build-essential python-dev
  • 然后再次
ets develop
  • 测试
mayavi2
大功告成。
[......]