### Navigation

- index
- previous |
- mayavi 4.3.1 documentation »
- Changelog »

# Mayavi 4.3.1

## Enhancements

20 Jan 2014 (PR)
  - New example mlab.test_mesh_mash_custom_colors illustrating masking and a custom color map.
12 Jan 2014 (PR)
  - Enabled Travis-CI for the repo.
17 Dec 2013 (dmsurti)
  - Upgrade to VTK 5.10.1 with VTK’s old pipeline. This upgrade does not yet make use of VTK’s new pipeline.
07 Aug 2013 (pratikmallya)
  - Added interactive superquadrics example. Thanks to Pratik for contributing this example.
03 Jun 2013 (PR)
  - Refactor the animation component so that corresponding examples display animations.

## Fixes

27 Jan 2014 (PR)
  - Many fixes to the test suite so the unit tests and integration tests all pass on OS X, Linux and Windows 32 and 64 bit with VTK 5.6.
08 Jan 2014 (PR)
  - tvtk_doc: Fix search when user enters a search string.
09 Jan 2014 (mindw)
  - Fix creation of scripts on win32 using gui_scripts. Thanks to Gabi Davar for this fix.
23 Dec 2013 (jenshnielsen)
  - Fix imshow by handling TraitError. Thanks to Jens Nielsen for this fix.
05 Apr 2013 (mindw)
  - Fix class browser when VTK is built with QT/SIP support. Thanks to Gabi Davar for this fix.
05 Apr 2013 (mluessi)
  - Fix wxpython 2.9 compatibility. Thanks to Martin Luessi for this fix.
19 Aug 2013 (senganal)
  - Fix MGlyphSource when assigning multi dimensional arrays to individual components of vector data. Thanks to Senganal for this fix.
  - Fix inconsistent handling of scalars. Thanks to Senganal for this fix.
10 Jun 2013 (PR)
  - Fix to use front buffer when off screen is False.

# Mayavi 4.3.0

## Enhancements

30 Oct 2012 (PR)
  - NEW: Adding a Qt version of the gradient editor. With this, all of Mayavi’s UI should be usable on Qt.

## Fixes

11 Mar 2013 (Aestrivex)
  - Fixed bug with incorrectly tiled snapshots while using savefig.
30 Oct 2012 (PR)
  - BUG: Qt: fix crashing full-screen-mode. Fixed segfault when you click on full-screen and press escape/q/e.

# Mayavi 4.2.1

## Enhancements

9 August 2012 (GV)
  - ENH: Add null engine to mlab.pipeline.open.

# Mayavi 3.4.0 (Oct 15, 2010)

## Enhancements

22 July 2010 (GV)
  - ENH: Add error management for extents in mlab: some module cannot be scaled [25683].

16 July 2010 (GV)

> - ENH: Enable LUT defined by tables to have their number of colors adjusted [25663].

## Fixes

2 August 2010 (GV)
  - BUG: Fix a segfault when updating lines on a MLineSource using ‘reset’ and reducing the number of points [25700].
1 August 2010 (GV)
  - BUG: Fix updating scalar scatters using mlab_source.set: a race condition under Qt prevented the scalar range to be updated in time [25699].
25 July 2010 (GV)
  - BUG: Fix corner cases in the pipeline browser: objects for which the number of inputs is misreported, and iterable objects to do not contain TVTKBase entries [25685,25686].
14 July 2010 (GV)
  - BUG: Fix a bug in the poll_file example. Thanks to Jonathan Guyer for pointing out the solution [25660].

# Mayavi 3.3.2 (May 25, 2010)

## Enhancements

DOCs: many docs and example improvements (GV).

13 April 2010 (GV)
  - API: Enforces wx >= 2.8 [25465,25471,25529]
11 April 2010 (GV)
  - ENH: Add figure management to mlab.roll [25464].
6 March 2010 (GV)
  - MISC: Change the default in iso_surface to compute normals, as with recent VTK versions colors look ugly when normals are not computed [25400].

## Fixes

17 May 2010 (PR)
  - BUG: Fixing wrapping for VTK-5.6 and above where one of the string traits default to a value with a special character like “n” “r” [25546].
17 April 2010 (GV)
  - BUG: Fix integer casting in magnification for mlab.savefig [25483]
5 April 2010 (GV)
  - BUG: A slight modification to enable inserting graph objects in the Mayavi pipeline: the polydata created by the GraphToPolyData filter had some ‘None’ arrays in their point_data [25434].
3 April 2010 (GV)
  - BUG: Make the ‘use_lookup_table’ traits of the image_plane_widget work. [25430]

# Mayavi 3.3.1 (Feb 24, 2010)

## Enhancements

20 Dec, 2009 (GV):
  - ENH: Merge in Scott Wart’s patch to add an ‘ImageChangeInformation filter to ArraySource, with additional work to get the tests to pass [25036], [25043]
14 Dec, 2009 (GV)
  - ENH: Add helper functions to interact with object via callbacks by clicking on them. The core function is the scene.on_mouse_pick, that is demoed in the new example ‘on_mouse_pick’ [25016], [25019]
13 Dec, 2009 (GV):
  - ENH: Make array_handler more robust to buffer protocole [25013]
  - ENH: Add support for assigning numbers to MGlyphSource x, y, z, and u, v, w [25015]
27 Nov 2009 (GV):
  - ENH: Add an auto mode for mlab.view, for distance and focal point [24971]
26 Nov, 2009 (GV):
  - ENH: Add a probe_data to retrieve data from Mayavi or VTK objects [24966]
25 Nov, 2009 (GV):
  - ENH: Usability: change the label of the ‘.‘ extension in th decorated scene save snapshot dialog [24963]
12 Oct, 2009 (GV):
  - ENH: Add script recording to the widget position for the DataSetClipper filter [24826]
17 Sep, 2009 (PR):
  - ENH: Making the widgets recordable [24738]
02 Sept 2009 (GV):
  - ENH: Add a new glyph source: a cross, that can be used as a cursor, or a axes [24678]
02 Sep, 2009 (GV):
  - ENH: Add a figure argument to mlab.view and try to lift the figure on screenshot [24676]
  - DOC: Add a detailed example of using ‘UserDefined’ contributed b Emmanuelle Gouillart [24677]
20 Aug, 2009 (PR):
  - ENH: Don’t persist mlab_source [24567]
14 Aug, 2009 (GV):
  - ENH: Stop gap solution to limit the cost of auto-scaling the glyph size with large arrays in barchart, when the positionning is implicite, and thus distance calculation is pointless [24526]
  - ENH: Do not update the rendering of the scene when using mlab helper functions that build one object after another [24529]
  - ENH: Add an argument to barchart to avoid expensive scaling computation [24531]
  - ENH: Make the scalars argument of mlab.pipeline.vector_field work with lists too [24532]
13 Aug, 2009 (GV):
  - ENH: Force an update of the data when using the set_active_attribute filter, so that the names of all defined arrays are displayed [24464] [24466], [24520], [24521], [24520]
04 Aug, 2009 (GV)
  - ENH: Add a screenshot function to mlab for easy capture of the pixmap to [24445]
  - ENH: Add a patch contributed by Chris Colbert for control of the array type in mlab.screenshot (rgb vs rgba) [24453]
03 Aug, 2009 (GV):
  - MISC: Fix long-standing usability complain: OK button on adder nodes not creating object [24443]
03 Aug, 2009 (PR):
  - ENH: Adding to/from_array to the Matrix4x4 class for convenience [24437]
  - ENH: Thanks to a suggestion from Gary Ruben, mlab.plot3d now uses tvtk.Stripper in the pipeline to produce smooth tubes [24438] [24442] [24439]
01 Aug, 2009 (GV):
  - DOC: Merge in Ondrej’s more precise instructions on installing SVN on an already-installed system [24428]
15 Jul, 2009 (GV):
  - ENH: Open the possibility to have image plane widget working with RGBA data [24169]
10 Jul, 2009 (GV):
  - ENH: Allows for use of lists as a scalar argument in mlab function [24094]
09 Jul 2009 (PR):
  - ENH/API: Checking in patch from Erik Tollerud which adds a move, yaw and `pitch to the mlab camera. Many thanks to Erik for this patch [24083], [24084]
08 Jul, 2009 (GV):
  - ENH: Capture any errors while building docs and fail gracefully during the build [24067]
08 Jul, 2009 (GV):
  - ENH: Try to force the use of wx2.8, or else do not display the logger [24064], [24060]
07 Jul, 2009 (GV):
  - ENH: Add a button and a menu entry to display the VTK documentation browser [25058]
22 Jul, 2009 (Dave Peterson):
  - Updated all __init__.py files with modulefinder code so that py2app/py2exe can correctly determine what to include when packaging a distribution. This is necessary due to the use of namespace packages [24339]

## Fixes

21 Feb, 2010 (GV)
  - BUG: Make the threshold filter better behaved when there are nans in the data [25280]
  - BUG: Remove callbacks on OrientationAxis that where triggering useless redraws [25279]
15 Feb, 2010 (PR):
  - BUG: Fix issue when an automatically generated trait name was actually Python keyword. In these cases the trait name is simply appended with a underscore (_). This should hopefully fix problems with building TVTK with VTK from CVS [25236]
12 Feb, 2010 (Scott Warts):
  - Reset the current scene if it is removed [ 25219]
08 Jan, 2010 (GV):
  - BUG: Radius and length of a cylinder had upper bounds to 100, where they should really be confined only to positive numbers. Fix with kludge. Thanks to Michele Mattioni for pointing out the bug, and providing the patch [25097]
20 Dec, 2009 (GV):
  - BUG: Correct bug with visibility of OrientationAxes reported by Uche Mennel [25037]
  - BUG: Patch by Varun Hiremath to make build docs more robust [25039]
  - BUG: Fix scalarbar positionning for VTK >= 5. [25040]
  - BUG: Avoid a segfault when enabling the OrientationAxes without an interactor [25044]
  - MISC: Disable the use of IPython by default, there are right now too many bugs with it [25041]
14 Dec, 2009 (GV):
  - BUG: Fix test on pick dispatcher [25020]
  - BUG: Fix a bug in tvtk.py, in the loading of tvtk classes generated code when the path is not in the sys.path Thank you to Ram Rachum for finding this problem, and the fix [25021]
26 Nov, 2009 (GV):
  - BUG: Add forgotten file. Thanks to Darren Dale for reporting [24967]
  - BUG: Fix mlab.pipeline.get_vtk_src for VTK dataset [24968]
25 Nov, 2009 (GV):
  - BUG: Fix a bug in barchart [24962]
18 Nov, 2009 (Scott Warts):
  - Don’t reset the zoom level if there are volumes or actors. Before we were just checking for actors [24932]
04 Nov, 2009 (GV):
  - BUG: mlab.clf() was renabling rendering on figures, had it been disabled [24874]
22 Oct, 2009 (Scott Warts):
  - BUG: Fixed memory leak. Switched to using tvtk.messenger when adding observers to keep from creating uncollectable cycles [24856], [24857]
14 Sep, 2009 (GV):
  - BUG: Fix trivial bug when size in savefig was not specified, and magnification was set to auto [24733]
19 Aug, 2009 (GV):
  - BUG: Fix ‘feature’ of mlab.colorbar which would show up on objects with scalar representation not enabled [24559]
19 Aug, 2009 (PR):
  - BUG: Fixing some of the issues with colorbar and VTK versions greater than 5.2 [24558]
18 Aug, 2009 (GV):
  - BUG: The figure magnification was not working correctly. Fix [24569]
  - BUG: Fix a traceback in mlab.show_pipeline if no scene was open [24553]
17 Aug, 2009 (PR):
  - BUG: TVTK was not correctly wrapping newer versions of VTK Specifically the vtkArray class was causing a traceback. This patch appears to fix the problem. Thanks to Kyle Mandli for helping with debugging this issue and testing the fix
14 Aug, 2009 (GV):
  - BUG: Fix a bug when reseting the MlabTriangularMeshSource: when growing the number of points, triangles were created before the corresponding points. Thanks to Ondrej Certik for reporting this one
08 Aug, 2009 (GV):
  - BUG: Fix a bug for with the notebook in wx example for which objects were not added to the right scene [24492]
07 Aug, 2009 (Scott Warts):
  - Added two more exceptions to state methods from ImageReslice: SetOutputOriginToDefault and SetOutputExtentToDefault [24480]
06 Aug, 2009 (PR):
  - BUG: vtkImageReslice’s SetOutputSpacingToDefault does not make OutputSpacing a state method. Thanks to Scott Swarts for pointing this out [24476]
01 Aug, 2009 (Robert Kern):
  - BUG: With a vtkWin32OpenGLRenderWindow, set the parent widget info before resizing in order to avoid an offset bug [24427]
23 Jul, 2009 (Evan Patterson):
  - BUG: Replacing deprecated calls to wx.Yield() [24379]

# Mayavi 3.3.0 (July 15, 2009)

## Enhancements

06 Jul, 2009 (PR):
  - ENH/API: No longer save to a file (with a popup when a user unchecks the record icon). Also added start_recording and stop_recording functions to mlab to make it easier to do this via scripts [24048]
08 Jul, 2009 (GV):
  - ENH: Make the MlabSceneModel manage the mlab current scene so that in plots to the embedded scene, but does not upset the current mlab figure [24040], [24065]
05 Jul 2009 (GV):
  - ENH: Add the possibility to specify figures to mlab.figure by instance rather than name [24039]
  - ENH: Add an example of using multiple mlab scene models [24041]
  - ENH: Add a figure keyword argument to mlab.pipeline factories to control which figure objects are added on [2403]
02 July, 2009 (PR):
  - ENH: The record icon on the engine view is smarter now and will automatically be checked on and off if the engine’s recorder trait in set. This paves the way for a convenient mlab one liner to start recording [24025]
01 Jul, 2009 (PR):
  - NEW: Adding a new filter that clips an input dataset. Also added an ImplicitWidgets component that abstracts a box, plane, sphere and implicit plane widget into one reusable component. An initial patch was contributed by Suyog and them modified by PR. Many thanks to Suyog for this patch [24017]
01 Jul, 2009 (GV):
  - ENH: Add an mlab.close function to close figures controled by mlab [24006]
30 Jun, 2009 (PR):
  - ENH/API: Checking in improved patch sent by Suyog along with fixes from me. This adds a can_read_test metadata attribute for sources which can be optionally specified, the function should return True if the reader can read a given file. The patch also adds a volume reader and a chaco reader and also supports the .xyz format reader provided in VTK. A test for the new registry functionality is also added. The API has only changed for the manner in which the registry is queried for a reader using the file itself rather than the file extension. Many thanks to Suyog for this work [24002]
29 Jun, 2009 (GV):
  - ENH: Add an option to show_engine to show the rich view [23981]
14 Jun, 2009 (GV):
  - BUG: mlab.set_engine was not registering engines, causing testing to be difficult [23819]
  - ENH: expose text3d in mlab [23820]
  - ENH/TEST: rewamp the mlab testing infrastructure [23822]
13 Jun, 2009 (GV):
  - ENH: Adapt mlab.savefig code to make it easier to save figures with size larger than window size [23813]
  - ENH: Add a text3d module, for displaying text located in the 3D scene scaling and hiding as the other 3D actors [23809], [23810].
  - ENH: Add a helper function to mlab to syncronize cameras on two scenes [23814]
10 Jun, 2009 (PR):
  - API: The name of the scene created on the mayavi2 app now defaults to “Mayavi Scene %d” rather than “TVTK Scene %d”. This is to make this consistent with what mlab.figure() does and to avoid user confusion [23787]
2 Jun, 2009 (PR):
  - ENH: Ensuring that the scene editor’s name is synced with the scene’ name. Also making the scene itself “renamable” [23710]
29 May, 2009 (PR):
  - ENH: Also pickle the name of the scene – it shouldn’t hurt [23691]
18 May, 2009 (GV):
  - ENH: cleaner exception capture for sensible error message [23660]
10 May, 2009 (GV):
  - ENH: Use pickle rather than numpy npz for lookup table [23618] [23619]
  - API: Add PipelineBase to mayavi.core.api as it is needed for the interactive example [23617]
9 May, 2009 (PR):
  - ENH/API: Adding to the API of the lut manager with a show_legend boo which is an alias for show_scalar_bar. This makes the UI a littl clearer [23608]
  - ENH: Adding ID’s to the various pop-up editors for the lut manager s their sizing etc. is persisted [23609]
  - ENH/API: Exposing the scalar_bar_widget’s representation in the UI an API and recording it so changes to the scalar bar’s position ar recorded and editable on the UI [23610]

20 Apr, 2009 (GV): ENH [23545]:

> - Add an example gallery to the documentation
> - Rewamp the documentation-generation code, and its packaging. Th generation code was made more robust, and as a result n generated test files are checked in svn. The images for th mlab documentation and the mlab examples are generated by th render_images.py script
> - Space has been optimized by removing duplicated artwork an moving outside of the source distribution files no required for distribution

19 Apr, 2009 (GV)
  - ENH: Use numpy’s npz format for storing LUT information. This saves ~1Mo from the source and binary distributions[23544]
11 Apr, 2009 (GV):
  - ENH/API: add an API module to core, to give a central place for important core import [23520]

## Fixes

15 Jul, 2009 (PR):
  - BUG: Fix what I think is a long standing bug. You couldn’t use the envisage backend with mlab because of a problem with envisage’. workbench application. I’ve worked around the problem in mayavi’ workbench subclass and added a test to ensure that this is now fixed This basically adds a new trait to the Mayavi app and the mayavi workbench application called start_gui_event_loop that is disabled when used from mlab [24171]
6 Jul, 2009 (Dave Martin):
  - BUG: If the scene being closed has None for scene.scene, call registry.find_scene_engine(scene) instead of “scene.scene” [24052] [24055]
05 Jul, 2009 (GV):
  - BUG: small fix for successive builds of the tvtk code generation, by Rakesh Pandit [24038]
  - BUG: Do not create application directories on import of mayavi preferences. [24036]
29 Jun, 2009 (GV):
  - BUG: Make sure that the vertical vector source used for barchart is well-behaved with regards to mlab_source.update [23983]
28 Jun, 2009 (PR):
  - BUG: Mlab’s barchart uses the scale_by_vector_components which was not exposed by the glyph component leading to update problems reported by Christian Vollmer. This is now fixed along with a simple test case. There are deeper problems with barchart that do need attention though - if a user changes the data inplace and calls the mlab_source.update() nothing updates correctly since the data is really copied over to the vector components. This can be fixed with a callback and will be done later. [23980]
25 Jun, 2009 (PR):
  - BUG: Was checking for attribute in editor assuming they were all scene editors which is clearly wrong. This bug fixes problems with using mayavi and a text editor say [23933]
2, Jun 2009 (PR):
  - BUG: With recent versions of VTK when a VTK array is exported to a numpy array, the numpy array is already a view so resetting the VTK array back to the numpy array for some reason triggers a segfault. This is now fixed [23711]
  - BUG: The Engine’s open method did not work with a null engine. Tested and fixed [23713]
30 May, 2009 (PR):
  - [TVTK] BUG: Working around problem with parser for vtkRenderedGraphRepresentation which has non-standard arguments for some of its SetIvarToState methods [23696]
26 Lay, 2009 (GV):
  - BUG: Fix scaling bug for surf with warp_scale=’auto’. Thanks to Jakob Rohrhirsch for reporting it [23682]
6 May, 2009 (PR):
  - BUG: The implicit plane widget was not recordable [23595]
  - BUG: [mlab] mlab.pipeline.contour_grid_plane was broken [23596]
27 Apr, 2009 (GV):
  - API: add an API module for core.ui [23562]
  - DOC: Put up to date information on the engine [23560]
23 Apr, 2009 (GV):
  - DOC: Add an example to show how you can have different engines in an application [23558]
13 April, 2009 (PR):
  - BUG: The trailing ‘|’ in the wildcard breaks the file dialog’s filterin for user defined readers. Thanks to B. P. Thrane for reporting the bug
27 March, 2009 (GV):
  - BUG: Fixed bug with importing customization contributions. Added a test case for this. Thanks to Mario Ceresa for reporting the bug [23438]
23 March, 2009 (GV):
  - BUG: Fix TVTK possible build failure, reported by Andrew Straw https://bugs.launchpad.net/bugs/34693 [23371]
20 March, 2009 (PR):
  - TEST/BUG: Adding a new test for the tvtk.util.ctf utility functions. Also fixed a bug that affects VTK-5.2 and above where the range of the CTF must be set [23267]
  - BUG/CLEAN: Fixing a 5.2 specific bug in the volume module mlab function Also cleaned up the mlab code for this a little [23268]

# Mayavi 3.2.0 (March 23, 2009)

A log of significant changes made to the package especially API changes. This is only partial and only covers the developments after the 2.x series.

17, 18 March, 2009 (PR):
  - NEW: A simple example to show how one can use TVTK’s visual module with mlab. [23250]
  - BUG: The size trait was being overridden and was different from the parent causing a bug with resizing the viewer. [23243]
15 March, 2009 (GV):
  - ENH: Add a volume factory to mlab that knows how to set color, vmin and vmax for the volume module [23221].
14 March, 2009 (PR):
  - API/TEST: Added a new testing entry point: ‘mayavi -t’ now runs tests in separate process, for isolation. Added `mayavi.api.test` to allow for simple testing from the interpreter [23195]...[23200], [23213], [23214], [23223].
  - BUG: The volume module was directly importing the wx_gradient_editor leading to an import error when no wxPython is available. This has been tested and fixed. Thanks to Christoph Bohme for reporting this issue. [23191]
14 March, 2009 (GV):
  - BUG: [mlab]: fix positioning for titles [23194], and opacity for titles and text [23193].
  - ENH: Add the mlab_source attribute on all objects created by mlab, when possible [23201], [23209].
  - ENH: Add a message to help the first-time user, using the new banner feature of the IPython shell view [23208].
13 March, 2009 (PR):
  - NEW/API: Adding a powerful TCP/UDP server for scripting mayavi via the network. This is available in `mayavi.tools.server` and is fully documented. It uses twisted and currently only works with wxPython. It is completely insecure though since it allows a remote user to do practically anything from mayavi.
13 March, 2009 (GV)
  - API: rename mlab.orientationaxes to mlab.orientation_axes [23184]
11 March, 2009 (GV)
  - API: Expose ‘traverse’ in mlab.pipeline [23181]
10 March, 2009 (PR)
  - BUG: Fixed a subtle bug that affected the ImagePlaneWidget. This happened because the scalar_type of the output data from the VTKDataSource was not being set correctly. Getting the range of any input scalars also seems to silence warnings from VTK. This should hopefully fix issues with the use of the IPW with multiple scalars. I’ve added two tests for this, one is an integration test since those errors really show up only when the display is used. The other is a traditional unittest. [23166]
08 March, 2009 (GV)
  - ENH: Raises an error when the user passes to mlab an array with infinite values [23150]
07 March, 2009 (PR)
  - BUG: A subtle bug with a really gross error in the GridPlane component, I was using the extents when I should really have been looking at the dimensions. The extract grid filter was also not flushing the data changes downstream leading to errors that are also fixed now. These errors would manifest when you use an ExtractGrid to select a VOI or a sample rate and then used a grid plane down stream causing very wierd and incorrect rendering of the grid plane (thanks to conflation of extents and dimensions). This bug was seen at NAL for a while and also reported by Fred with a nice CME. The CME was then converted to a nice unittest by Suyog and then improved. Thanks to them all. [23146]
28 February, 2009 (PR)
  - BUG: Fixed some issues reported by Ondrej Certik regarding the use Of mlab.options.offscreen, mlab.options.backend = ‘test’, removed cruft from earlier ‘null’ backend, fixed bug with incorrect imports, add_dataset set no longer adds one new null engine each time figure=False is passed, added test case for the options.backend test. [23088]
23 February, 2009 (PR)
  - ENH: Updating show so that it supports a stop keyword argument that pops up a little UI that lets the user stop the mainloop temporarily and continue using Python [23049]
21 February, 2009 (GV)
  - ENH: Add a richer view for the pipeline to the MayaviScene [23035]
  - ENH: Add safegards to capture wrong triangle array sizes in mlab.triangular_mesh_source. [23037]
21 February, 2009 (PR)
  - ENH: Making the transform data filter recordable. [23033]
  - NEW: A simple animator class to make it relatively to create animations. [23036] [23039]
20 February, 2009 (PR)
  - ENH: Added readers for various image file formats, poly data readers and unstructured grid readers. These include DICOM, GESigna, DEM, MetaImage (mha,mhd) MINC, AVSucd, GAMBIT, Exodus, STL, Points, Particle, PLY, PDB, SLC, OBJ, Facet and BYU files. Also added several tests for most of this functionality along with small data files. These are additions from PR’s project staff, Suyog Jain and Sreekanth Ravindran. [23013]
  - ENH: We now change the default so the ImagePlaneWidget does not control the LUT. Also made the IPW recordable. [23011]
18 February, 2009 (GV)
  - ENH: Add a preference manager view for editing preferences outside envisage [22998]
08 February, 2009 (GV)
  - ENH: Center the glyphs created by barchart on the data points, as mentioned by Rauli Ruohonen [22906]
29 January, 2009 (GV)
  - ENH: Make it possible to avoid redraws with mlab by using mlab.gcf().scene.disable_render = True [22869]
28 January, 2009 (PR and GV)
  - ENH: Make the mlab.pipeline.user_defined factory function usable to add arbitrary filters on the pipeline. [22867], [22865]
11 January, 2009 (GV)
  - ENH: Make mlab.imshow use the ImageActor. Enhance the ImageActor to map scalars to colors when needed. [22816]

# Mayavi 3.1.0

3 December, 2008 (PR)
  - BUG: Fixing bugs with persistence of VTKDataSource objects wrapping a structured grid in VTK-5.2. This resulted in hard to debug test errors. [22624]
1 December, 2008 (GV):
  - API: Promote the TestEngine to a first-class citizen NullEngine and

      make mlab use it when a source has a keyword argument “figure=False”. [22594]

30 November, 2008 (PR)
  - NEW: New sources called BuiltinSurface and BuiltinImage that let users create simple polygonal data and images using basic VTK sources. Thanks to Suyog Jain for this code. [22586], [22597].
27 November, 2008 (GV):
  - ENH: Add control of the seed size and resolution to

      mlab.pipeline_basene.streamline [22573].

  - DOC: Documentation work, especially in the scripting parts of the

      docs. [22572], [22561], [22560], [22546], [22545]

26 November, 2008 (GV):
  - ENH: Add keyword arguments to the cutplanes in mlab.pipeline. [22567]

      Also add masking to glyph-based mlab.pipeline factories [22568]

19 November, 2008 (GV):

  - UI: Rename ‘Modules’ to ‘Colors and legends’ [22512]

  - API: Change defaults [22513]:
      - CellToPointData and PointToCellData filters to pass the existing dataset.
      - The ouline of the implicite plane is no longer draggable by default.
15-16 November, 2008 (PR)
  - ENH/API: Exposing the glyph source choices via a dictionary rather than having the user remember the index in a list. [22497]
  - ENH: Adding a button to the LUT UI so the LUT editor can be launched from the UI. [22498]
  - DOC: Updating advanced scripting chapter. [22495].
13 November, 2008 (GV)
  - ENH: [mlab] Add keyword arguments to colobars to control label number and format, as well as colors number. [22489]
10 November, 2008 (PR)
  - TEST: Adding 43 new mayavi tests. These are based on the integration tests but don’t pop up a user interface. Thanks to Suyog Jain for doing bulk of the work. [22465]
27 October, 2008 (GV)
  - ENH: [mlab] If a module or filter is added to the pipeline using the mlab.pipeline functions, the source on which it is added onto is automatically added to the scene if not alread present. It is also automatically converted from a tvtk dataset to a mayavi source, if needed. [22375], [22377]
  - ENH: [mlab] Make mlab.axes and mlab.outline use the extents of the current object when none specified explicitely. [22372]
24-27 October, 2008 (PR)
  - NEW: Adding an ImageChangeInformation filter to let users change the origin, spacing and extents of input image data, [22351].
  - API: Adding a set_viewer function to tvtk.tools.visual so one may specify a viewer to render into. This lets us use visual with a mayavi scene. [22363]
  - BUG: Fix a major bug with TVTK when VTK is built with 64 bit ids (VTK_USE_64BIT_IDS is on). The examples and tests should all run in this case now. [22365]
  - ENH: [mlab] Added an mlab.view method that actually works [22366].
19 October, 2008 (GV)
  - ENH: mlab.text can now take 3D positioning [22331].
17-20 October, 2008 (PR)
  - ENH: Modified TVTK and Mayavi UI editors so that text entry boxes are only set when the user hits <enter> or <tab> rather than on each keystroke. [22321], [22323]
  - ENH/BUG/WARN: Fixed warnings at TVTK build time, fixed bugs with ImageData’s scalar_type trait. [22320], [22321], [22325].
  - NEW/API: Adding preference option to ease task of loading contrib packages (via a pkg/user_mayavi.py) in mayavi. Also added a contrib finder that trawls sys.path to find contributions. This can be set from the preferences UI. [22324], [22326], [22327].
  - BUG: Fixing problems with the gradient_editor and newer VTK versions. This is required for the Volume module to work correctly. [22329], [22341]
13 October, 2008 (GV):

  - ENH: Bind the ‘explore’ function in the python shell [22307]

  - ENH: mlab: axes and outline now find the extents from the objects

      they are given, if any. [22305]

12 October, 2008 (GV):
  - API: mlab: Add a barchart function, with the corresponding pipeline source function. [22286]
11 October, 2008 (PR):
  - ENH/API: Improving texture map support, you can now generate the texture coords on an arbitrary actor. This adds to the API of the actor component. [22283]
  - API: Adding a mayavi.preferences.bindings module that abstracts out setting of preferences for common objects. Currently it exposes a set_scene_preferences so the non-envisage and off screen scenes have the right preferences. See [22280] and [22295].
  - REFACTOR/API: The script recording code is now in apptools.scripting, the mayavi.core.recorder was only a temporary solution. See [22277] and [22279].
10 October, 2008 (GV):
  - API: mlab: Expose pipeline.set_extent (former private function tools._set_extent) [22251]
9 October, 2008 (GV):
  - ENH: Use the IPython shell plugin only if the ipython, envisage and pyface versions are recent-enough. Mayavi now uses an ipython widget instead of the pyshell one if you have the right components installed, but should fall back to pyshell gracefully. [21678], [22245]
4 October, 2008 (PR):
  - TEST: Added a ‘test’ backend to mlab so you can run mlab tests without a display. Fixing core code so that all the unittests run when the ETS_TOOLKIT env var is set to ‘null’. [22198]
30 September, 2008 (GV):
  - API: mlab: Expose pipeline.add_dataset (former private function tools._data) [22162].
  - API: The mlab source functions can now optionaly work without creating a figure (using figure=None) [22161].
  - API: The mlab source functions are more robust to various input-argument shape (they accept lists, and 1D or 2D arrays when possible) [22161].
29 September, 2008 (GV):
  - NEW: Add a mlab.triangular_mesh function to create meshes with arbitrary triangular connectivity. Also add a corresponding triangular_mesh_source mlab source. [22155]
  - ENH: Make mlab.points3d and other mlab functions accept scalars as coordinnates, in addition to arrays. [22156]
12 September, 2008 (PR)
  - NEW: Create a separate OffScreenEngine for use to reduce code duplication. This is also available as part of mayavi.api. [21880]
  - TEST: Creating a common.py that contains a TestEngine mayavi engine subclass for easily testing mayavi. [21881]
8-12 September, 2008 (PR)
  - NEW: Adding full support for script recording. With this you can pretty much record all UI actions performed on the Mayavi UI (both standalone and application) to human-readable and runnable Python scripts. It also serves as a nice learning tool since it shows the lines of code as the UI actions are performed. Note that interacting with the camera is also recorded which is very convenient. This has been implemented in a pretty general fashion (using TDD) so is reusable in other traits based applications also. Major checkins [21722], [21728], [21776], [21812], [21865] [21878].

# Mayavi 3.0.3

7 September, 2008 (PR):

  - ENH: The mayavi2 application now ([21713], [21714]) supports command line args like the following:

        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')"

6 September, 2008 (PR):
  - ENH/API: Cleaned up the mayavi.core.traits to remove buggy, and unused DRange and SimpleDRange traits. [21705]
  - BUG/TEST: Added tests for some of the MlabSource subclasses and fixed many bugs in the code. [21708]
  - TEST: Modified pipeline_base.py so mayavi objects may be started without creating a scene (and therefore a UI). This allows us to create completely non-interactive tests. [21709]
  - ENH: Adding X3D and POVRAY export options. [21711]
23 August, 2008 (PR):
  - ENH: Adding an offscreen option for mlab. Now you can set mlab.options.offscreen = True. [21510]
  - ENH: Setting the window size to (1,1) if the window is offscreen, this prevents the window from showing up prominently – it still does show up though. [21519]
21 August, 2008 (PR):
  - ENH: Adding the logger plugin to the mayavi2 app. [21487]

# Mayavi 3.0.1 and 3.0.2

16 August, 2008 (PR):
  - BUG: fixed various miscellaneous bugs including a testing error[21304], a long standing Mac bug with picking [21310], a segfault [21453] and a bug in tvtk when wrapping certain methods [21475].

# Mayavi 3.0.0

15 August, 2008 (PR):
  - NEW: Adding a fully tested data set manager that lets users add/remove/modify attribute arrays to a tvtk dataset. This is fully tested and also does not influence any other code. [21300]
10 August, 2008 (PR):
  - ENH/API: [mlab] Added a MlabSource class to abstract out the data creation and modification into one object that may be modified. This source object is injected in the form of a mlab_source trait on objects returned by any of the helper functions (surf, plot3d etc.) or the sources. The user can use this to modify the data visualized without recreating the pipeline each time, making animations very easy and smooth. There are several examples of the form test_blah_anim showing how this is done. [21098], [21103].
27 July, 2008 (GV):

  - ENH: Add an option (on by default) to open the docs in a chromeless window when using firefox. [20451] [20450]

  - ENH: Add toolbar to the engine view [20447]

  - ENH: Selected item on the tree jumps to newly created objects [20454]

  - ENH: Add a button on the viewer using by mayavi in standalone to open up the engine view [20456] [20462]

  - ENH: Clean UI for adding sources/filters/modules (Adder nodes) [20461] [20460] [20458] [20452]

  - ENH: [mlab] add a resolution argument to glyphs [20465]

  - API: [mlab] API Breakage!

      Make mlab source names compatible with ETS standards: grid_source rather than gridsource [20466]

  - NEW: Add image_plane_widget to mlab.pipeline, with helpful keyword

      arguments.

23 July, 2008 (GV):
  - ENH: The mlab API can now take either engine or figure keyword arguments. This allows to avoid the use of the global sate set in the mlab engine. Mlab also now exposes a set_engine function. [20245]
23 July, 2008 (PR)
  - ENH/NEW: The mlab.pipeline sources, modules and filters now feature automatic source/filter/module generation functions from registry information. This means mlab fully supports creating objects on the mayavi pipeline with easy one-liners. [20239]
  - API: The API has broken! Sources, filters and modules that mirror an existing mayavi class now are named with underscores. For example, isosurface has become iso_surface, extractedges becomes extract_edges etc.
  - NEW: Exposing the engine’s open method to mlab so it is easy to open data files from mlab also.
  - ENH: Implemented an mlab.show decorator so one can write out a normal function for visualization which will work from ipython, standalone and mayavi completely seamlessly.
18, 19 July, 2008 (PR)

  - TEST/API: The mayavi tests are now split into integration and unit tests. Unit tests go into mayavi/tests. Integration tests are in integrationtests/mayavi. Major changes:

    > - Removed most of the image based tests except one (test_streamline.py) for reference.
    > - Modified the testing code so the standalone mode is the default.
    > - Modified so nose picks up the integrationtests. However, there are problems running the test via nosetests on Linux that need investigating.

  - ENH: Creating a new object on the pipeline via envisage or right click now sets the active selection to the created object so it is easy to edit.

  - API: Moving mayavi/view/engine_view.py to mayavi/core/ui. [20098]

  - API: Added method to engine (get_viewer) so it gets the viewer associated with a particular scene. [20101]

12 July, 2008 (PR):
  - ENH/API: Adding support for global (system wide) and local customizations via a site_mayavi.py and user_mayavi.py (in ~/.mayavi2/). This allows users to register new modules/filters and sources and also add any envisage plugins to the mayavi2 app easily. [19920]
9 July, 2008 (Judah, PR)
  - ENH: Adding the core code for an AdderNode that shows up on the engine view and lets a user easily create new scenes/sources/filters and modules.
8 July, 2008 (PR)
  - BUG: Ported various bug fixes from branches for ETS-2.8.0 release.
  - ENH/API: Added datatype, attribute type and attribute information to all pipeline objects (both at the object and metadata levels). This lets one query if an object will support a given input and what outputs it will provide (this can be changed dynamically too). This allows us to create context sensitive menus. The traits UI menus for the right click is now modified to use this information. We therefore have context sensitive right click menus depending on the nature of the object we right click on. At this point we don’t yet check for the attribute_type and attributes metadata information to enable/disable menus, this may be implemented later – the framework makes this quite easy to do. [19512].
  - ENH: Envisage menus are now context sensitive [19520].
5 July, 2008 (PR):

  - ENH: One can create objects on the pipeline using right-clicks [19469].

  - ENH: All the envisage menus and actions for sources, filters and modules now are autogenerated from the metadata for these.

  - NEW/API: [19458] adds the following features:
      - A Registry (mayavi.core.registry.Registry) to register engines, sources, filters and modules. Source, filter and module metadata is registered and this can be used to do various things like generate menus, register data file extension handlers and whatnot. The metadata related classes are in mayavi.core.metadata.
      - This registry and metadata information is used to generate the envisage menus and actions.
      - The registry can be used by users to register new sources, readers, filters and modules.
      - A method to Engine and Script to easily open any supported data file.
      - Simplify the open file interface so it is just one menu item that supports different file extensions.
      - Changed the command line options for the mayavi2 application so you can open any supported data file format with the -d option. This breaks backwards compatibility but makes it very easy to open supported data files – even if the new ones are added by users.
      - Fixed the PLOT3DReader so it opens the q file using the xyz filenames basename.
29 June, 2008 (GV):
  - ENH: Updated Sphinx docs [19318].
  - ENH: New splash screen [19319].
  - ENH: mlab now works with envisage, including in “mayavi2 -x” [19321] [19323]
27 June, 2008 (Vibha):
  - API: Remove SimpleScene class [19285].
  - API: Moved tvtk-related examples from TraitsGUI to Mayavi [19191] [19197] [19231] [19280]
27 June, 2008 (GV):
  - BUG: tvtk: proper handling of non-float numpy arrays. Added test case [19297]
25 June, 2008 (GV):
  - ENH: Add autoscale to mlab.surf (scalez keyword argument) [19131]
  - ENH: mlab.usrf and mlab.mesh can now take x and y arguments with a more flexible shape [19114].
12 June, 2008 (PR):
  - ENH: Adding an offscreen option to the mayavi2 application. This lets you run a normal mayavi Python script in offscreen mode without the full UI. This is very convenient when you want to render a huge number of images from a visualization and don’t want the UI to bother you or create a special script for the purpose. See [18951], [18955].
07, 08 June, 2008 (PR):
  - API: TVTK: Added two methods setup_observers and teardown_observers that let one turn on/off the observer for the ModifiedEvent fired on each VTK object that a TVTK object wraps to keep the traits updated. Thus, if you call teardown_observers the traits will not be automatically updated if the wrapped VTK object is changed. This can be manually updated by calling the update_traits method. It is OK to call the setup/teardown_observers method as often as needed. This is also tested. See [18885].
  - API: TVTK: Removed the __del__ method on all TVTK objects. This should make it much nicer for proper garbage collection. See [18886], [18887].
06 June, 2008 (PR):
  - TEST: Added a standalone mode to the tests so you can test without starting up the envisage app. Envisage imports may be required however. To use this run any test with the -s option. [18880]
  - TEST: Added a way to run the tests on one application launch instead of starting mayavi each time. To use this execute run.py with the –one-shot command line option. [18880] [18881].
  - TEST: The standalone offscreen mode now should work without a single Traits UI showing up with just a dummy blank window being used. This demonstrates how mayavi scripts can work in completely different contexts. [18881].
31 May, 2008 (PR):
  - PORT: Backported important additions to the 2.2.0 branch.
  - BUG: Added a test case for the hide/show functionality and fixed known bugs.
  - API: Adding elementary support for texturing an actor (if it has texture coords). This was thanks to a patch from Chandrashekhar Kaushik. [18827]
30 May, 2008 (PR):
  - API: Adding closing, closed lifecycle events to the scene [18806].
27 May, 2008 (PR):
  - NEW: Adding a Labels module to label input data. This is like MayaVi1’s module and with this checkin all important mayavi1 modules and filters are supported in mayavi2. The only missing one is Locator which hardly anyone uses I think. See [18801].
27 May, 2008 (PR):
  - NEW: Adding an ImageDataProbe filter which does the same thing that MayaVi-1.5’s StructuredPointsProbe does. [18792]
25 May, 2008 (PR):
  - NEW: Adding CellDerivatives and Vorticity filters. [18785]
24 May, 2008 (PR):
  - NEW: Adding a tvtk_doc.py module that doubles as a TVTK Class/Filter/Source/Sink chooser and also as a documentation browser (with search!) like Mayavi1.x’s vtk_doc.py. tvtk_doc is also installed as a console script now. [18776]
  - NEW: Adding a UserDefined filter where the user can wrap around any TVTK filter. [18780]
23 May, 2008 (PR):
  - NEW: SetActiveAttribute filter that lets you select the active attribute. This makes it very easy to find the contours of one scalar on the iso-contour of another. The example contour_contour.py shows how this is done. See [18774], [18775].
22 May, 2008 (PR):
  - NEW: Adding Contour and CutPlane filters that use the Wrapper filter and respective components. This is very convenient.
  - Checked in modified patch from Chandrashekhar Kaushik (CSE IITB), which reimplements hide/show using a visible trait.
21 May, 2008 (PR):
  - TEST: Adding an @test decorator to make it easy to create a mayavi test case from a mayavi script. While this is convenient, I still prefer to explicitly use the TestCase class since this makes the code compatible with the 2.2.0 branch.
  - The GenericModule is now tested.
20 May, 2008 (PR):
  - NEW: Adding a GenericModule to easily put together a bunch of Filters and Components. Using this code it takes 30 simple lines of code for a ScalarCutPlane compared to the 300 complex ones we need for the current implementation! This is because the module takes care of all the dirty work.
  - NEW: Adding Wrapper, Optional and Collection filters that make it easy to wrap around existing Components and Filters, make them optional and create collections of them very easily. This gives us a great deal of reuse and makes it very easy to create new filters.
18 May, 2008 (PR):
  - ENH: Improved the PLOT3D reader and added a test for it.
  - Added a menu item to allow a user to run a Python script from the UI.
  - API: Added a close method to pyface.tvtk.tvtk_scene.TVTKScene. This class is inherited by all Scenes (DecoratedScene and Scene). The close method shuts down the scene properly. This should hopefully prevent async errors when closing editors/windows containing scenes. See [18708].
  - Updated the scene plugin, scene_editor (TraitsBackend*), actor_editor and the ivtk code to use the close method.
  - TEST: All the tests run on the trunk and pass when the offscreen option is used (which was also added).
17 May, 2008 (PR):
  - NEW: Adding an SelectOutput filter that should address bug number 478359 in the Debian BTS. See [18700].
  - API: mayavi.plugins.app.Mayavi now defines a setup_logger method so this can be overridden by subclasses, see [18703].
13 May, 2008 (PR):
  - NEW: Adding an ExtractVectorComponents filter contributed by Varun Hiremath.
11,12 May 2008 (PR):
  - ENH/API: The plugins now start the engine themselves and also do the binding to the shell. Earlier this was done by the application. This makes the plugins reusable. Also added a running trait to the engine to check on its status. [18672], [18678].
  - At this point all examples in trunk work save the mayavi_custom_ui plugin stuff.
10 May 2008 (PR):
  - API: Moving mayavi/engine.py -> mayavi/core/engine.py where it really belongs; see [18667].
7,8 May 2008 (PR):
  - API: The plugins_e3 package is now moved into plugins. This breaks the tvtk.plugins API and also the mayavi.mayavi_*_definition modules. The older envisage2 plugin code is all removed. See: [18649], [18650], [18651], [18652], [18655], [18657], [18662].
6 May 2008 (PR):

  - API: The mayavi.core.Base.confirm_delete class attribute is gone since it is no longer needed [18635].

  - API: Removed config directory, integrated all mlab preferences into the the mayavi preferences framework, see [18632]. To get the preferences just do:

        from mayavi.preferences.api import preference_manager

    This is the preference manager that manages all prefs. To see the code look in mayavi.preferences.preference_manager. It is also a good idea to read the apptools.preferences documentation.

  - BUG: [18627] Fixed bug number 478844 on the Debian BTS here: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=478844

4 May 2008 (PR):
  - API: Added to api. Added a new preferences framework for mayavi2. This uses apptools.preferences and works well both standalone and with envisage3. It makes it easy to create/define/change preferences at the application and library level.
2 May, 2008 (PR):
  - API: Ported the mayavi2 application and plugin to work with Envisage3. See changesets [18595] and [18598]. This obviously breaks the plugin API completely!
  - Got the mlab envisage_engine_manager working with new changes [18599].

Before this changeset, the code was that of the 2.x series.

### Navigation

- index
- previous |
- mayavi 4.3.1 documentation »
- Changelog »