Note

This section is only a reference describing the function, please see the chapter on mlab: Python scripting for 3D plotting for an introduction to mlab and how to interact with and assemble the functions of mlab.

Please see the section on Running mlab scripts for instructions on running the examples.

# Filters, modules, other functions

## cell_derivatives

mayavi.tools.pipeline.cell_derivatives(*args, **kwargs)

  Calculate derivatives of input point/vector data and output these as cell data

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## cell_to_point_data

mayavi.tools.pipeline.cell_to_point_data(*args, **kwargs)

  Convert cell data to point data for the active data

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## contour

mayavi.tools.pipeline.contour(*args, **kwargs)

  Compute contours of the input dataset

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## contour_grid_plane

mayavi.tools.pipeline.contour_grid_plane(*args, **kwargs)
  ::

    Applies the ContourGridPlane mayavi module to the given data

  source (Mayavi source, or VTK dataset).

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > contours

  >   Integer/list specifying number/list of contours. Specifying a list of values will only give the requested contours asked for.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## contour_surface

mayavi.tools.pipeline.contour_surface(*args, **kwargs)

  Applies the Surface mayavi module to the given data source (Mayavi source, or VTK dataset) and turns contours on.

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > contours

  >   Integer/list specifying number/list of contours. Specifying a list of values will only give the requested contours asked for.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## custom_grid_plane

mayavi.tools.pipeline.custom_grid_plane(*args, **kwargs)
  ::

    Applies the CustomGridPlane mayavi module to the given VTK data

  source (Mayavi source, or VTK dataset).

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > contours

  >   Integer/list specifying number/list of contours. Specifying a list of values will only give the requested contours asked for.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## cut_plane

mayavi.tools.pipeline.cut_plane(*args, **kwargs)

  Slice the input dataset with a cut plane

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## data_set_clipper

mayavi.tools.pipeline.data_set_clipper(*args, **kwargs)

  Clip the input dataset

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## decimate_pro

mayavi.tools.pipeline.decimate_pro(*args, **kwargs)

  Simpilies a mesh using the DecimatePro filter

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## delaunay2d

mayavi.tools.pipeline.delaunay2d(*args, **kwargs)

  Perform a 2D Delaunay triangulation for the given data

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## delaunay3d

mayavi.tools.pipeline.delaunay3d(*args, **kwargs)

  Perform a 3D Delaunay triangulation for the given data

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## elevation

mayavi.tools.pipeline.elevation(*args, **kwargs)

  Creates scalar data from the elevation along a direction

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## elevation_filter

mayavi.tools.pipeline.elevation_filter(*args, **kwargs)

  Applies the Elevation Filter mayavi filter to the given VTK object.

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > high_point

  >   The end point of the projection line

  > low_point

  >   The start point of the projection line

  > name

  >   the name of the vtk object created.

## extract_edges

mayavi.tools.pipeline.extract_edges(*args, **kwargs)

  Turns edges into lines.

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## extract_grid

mayavi.tools.pipeline.extract_grid(*args, **kwargs)

  Extract/subsample part of any structured grid

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## extract_tensor_components

mayavi.tools.pipeline.extract_tensor_components(*args, **kwargs)

  Extract tensor components from tensor data

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## extract_unstructured_grid

mayavi.tools.pipeline.extract_unstructured_grid(*args, **kwargs)

  Extract part of an unstructured grid

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## extract_vector_components

mayavi.tools.pipeline.extract_vector_components(*args, **kwargs)

  Extract vector components from vector data

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## extract_vector_norm

mayavi.tools.pipeline.extract_vector_norm(*args, **kwargs)

  Compute the vector norm for the current vector data

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## gaussian_splatter

mayavi.tools.pipeline.gaussian_splatter(*args, **kwargs)

  Builds a structured set of points from a cloud of points, the local density defining the scalar. It is essentially equivalent to a 3D Gaussian kernel density estimate. Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## glyph

mayavi.tools.pipeline.glyph(*args, **kwargs)

  Applies the Glyph mayavi module to the given VTK data source (Mayavi source, or VTK dataset).

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > mask_points

  >   If supplied, only one out of ‘mask_points’ data point is displayed. This option is useful to reduce the number of points displayed on large datasets Must be an integer (int or long) or None.

  > mode

  >   the mode of the glyphs. Must be ‘2darrow’ or ‘2dcircle’ or ‘2dcross’ or ‘2ddash’ or ‘2ddiamond’ or ‘2dhooked_arrow’ or ‘2dsquare’ or ‘2dthick_arrow’ or ‘2dthick_cross’ or ‘2dtriangle’ or ‘2dvertex’ or ‘arrow’ or ‘axes’ or ‘cone’ or ‘cube’ or ‘cylinder’ or ‘point’ or ‘sphere’. Default: sphere

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > resolution

  >   The resolution of the glyph created. For spheres, for instance, this is the number of divisions along theta and phi. Must be an integer (int or long). Default: 8

  > scale_factor

  >   the scaling applied to the glyphs. The size of the glyph is by default in drawing units. Must be a float. Default: 1.0

  > scale_mode

  >   the scaling mode for the glyphs (‘vector’, ‘scalar’, or ‘none’).

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## greedy_terrain_decimation

mayavi.tools.pipeline.greedy_terrain_decimation(*args, **kwargs)

  Simplifies image data and performs a triangulation

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## grid_plane

mayavi.tools.pipeline.grid_plane(*args, **kwargs)

  Shows a grid plane for the given input

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## hyper_streamline

mayavi.tools.pipeline.hyper_streamline(*args, **kwargs)

  Shows hyper streamlines for tensor data

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## image_actor

mayavi.tools.pipeline.image_actor(*args, **kwargs)

  Applies the ImageActor mayavi module to the given VTK data object.

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > interpolate

  >   if the pixels in the image are to be interpolated or not. Must be a boolean. Default: True

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   the opacity of the image. Must be a legal value. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## image_change_information

mayavi.tools.pipeline.image_change_information(*args, **kwargs)

  Change the origin, spacing and extents of an image dataset

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## image_data_probe

mayavi.tools.pipeline.image_data_probe(*args, **kwargs)

  Samples arbitrary datasets onto an image dataset (cube of data)

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## image_plane_widget

mayavi.tools.pipeline.image_plane_widget(*args, **kwargs)
  ::

    Applies the ImagePlaneWidget mayavi module to the given data

  source (Mayavi source, or VTK dataset).

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > plane_opacity

  >   the opacity of the plane actor. Must be a legal value. Default: 1.0

  > plane_orientation

  >   the orientation of the plane Must be a legal value. Default: x_axes

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > slice_index

  >   The index along wich the image is sliced.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## iso_surface

mayavi.tools.pipeline.iso_surface(*args, **kwargs)

  Applies the IsoSurface mayavi module to the given data source (Mayavi source, or VTK dataset).

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > contours

  >   Integer/list specifying number/list of contours. Specifying a list of values will only give the requested contours asked for.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## labels

mayavi.tools.pipeline.labels(*args, **kwargs)

  Display labels for active dataset or active module

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## mask_points

mayavi.tools.pipeline.mask_points(*args, **kwargs)

  Mask the input points in the data

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## outline

mayavi.tools.pipeline.outline(*args, **kwargs)

  Draw an outline for given input

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## point_to_cell_data

mayavi.tools.pipeline.point_to_cell_data(*args, **kwargs)

  Convert point data to cell data for the active data

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## poly_data_normals

mayavi.tools.pipeline.poly_data_normals(*args, **kwargs)

  Compute normals and smooth the appearance

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## quadric_decimation

mayavi.tools.pipeline.quadric_decimation(*args, **kwargs)

  Simplifies a triangular mesh

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## scalar_cut_plane

mayavi.tools.pipeline.scalar_cut_plane(*args, **kwargs)
  ::

    Applies the ScalarCutPlane mayavi module to the given data

  source (Mayavi source, or VTK dataset).

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > plane_orientation

  >   the orientation of the plane Must be a legal value. Default: x_axes

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > view_controls

  >   Whether or not the controls of the cut plane are shown. Must be a boolean. Default: True

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## select_output

mayavi.tools.pipeline.select_output(*args, **kwargs)

  Choose the output of the source that should be used

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## set_active_attribute

mayavi.tools.pipeline.set_active_attribute(*args, **kwargs)
  ::

    Applies the SetActiveAttribute Filter mayavi filter to the given

  VTK object.

  Keyword arguments:

  > cell_scalars

  >   The name of the active cell scalars

  > cell_tensors

  >   The name of the active cell tensors

  > cell_vectors

  >   The name of the active cell vectors

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

  > point_scalars

  >   The name of the active point scalars

  > point_tensors

  >   The name of the active point tensors

  > point_vectors

  >   The name of the active point vectors

## slice_unstructured_grid

mayavi.tools.pipeline.slice_unstructured_grid(*args, **kwargs)

  Slice an unstructured grid to show cells

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## streamline

mayavi.tools.pipeline.streamline(*args, **kwargs)

  Applies the Streamline mayavi module to the given VTK data object.

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > integration_direction

  >   The direction of the integration. Must be ‘forward’ or ‘backward’ or ‘both’. Default: forward

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > linetype

  >   the type of line-like object used to display the streamline. Must be ‘line’ or ‘ribbon’ or ‘tube’. Default: line

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > seed_resolution

  >   The resolution of the seed. Determines the number of seed points Must be an integer (int or long) or None.

  > seed_scale

  >   Scales the seed around its default center Must be a float. Default: 1.0

  > seed_visible

  >   Control the visibility of the seed. Must be a boolean. Default: True

  > seedtype

  >   the widget used as a seed for the streamlines. Must be ‘line’ or ‘plane’ or ‘point’ or ‘sphere’. Default: sphere

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## stripper

mayavi.tools.pipeline.stripper(*args, **kwargs)

  Regularizes surfaces by creating triangle strips

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## structured_grid_outline

mayavi.tools.pipeline.structured_grid_outline(*args, **kwargs)

  Draw a grid-conforming outline for structured grids

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## surface

mayavi.tools.pipeline.surface(*args, **kwargs)

  Applies the Surface mayavi module to the given data source (Mayavi source, or VTK dataset).

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > representation

  >   the representation type used for the surface. Must be ‘surface’ or ‘wireframe’ or ‘points’. Default: surface

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## tensor_glyph

mayavi.tools.pipeline.tensor_glyph(*args, **kwargs)

  Displays glyphs scaled and oriented as per tensor data

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## text3d

mayavi.tools.pipeline.text3d(*args, **kwargs)

  Displays user-specified text at a 3D location in the scene

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## threshold

mayavi.tools.pipeline.threshold(*args, **kwargs)

  Applies the Threshold mayavi filter to the given VTK object.

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > filter_type

  >   If threshold is put on cells or points

  > low

  >   The lower threshold

  > name

  >   the name of the vtk object created.

  > up

  >   The upper threshold

## transform_data

mayavi.tools.pipeline.transform_data(*args, **kwargs)

  Transform (rotate/translate/scale) non ImageData datasets

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## triangle_filter

mayavi.tools.pipeline.triangle_filter(*args, **kwargs)

  Convert input polygons and triangle strips to triangles

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## tube

mayavi.tools.pipeline.tube(*args, **kwargs)

  Applies the Tube mayavi filter to the given VTK object.

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

  > tube_radius

  >   radius of the tubes used to represent the lines. Must be a float. Default: 0.05

  > tube_sides

  >   number of sides of the tubes used to represent the lines. Must be an integer (int or long). Default: 6

## user_defined

mayavi.tools.pipeline.user_defined(*args, **kwargs)

  Applies the UserDefined mayavi filter to the given TVTK object.

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > filter

  >   the tvtk filter to adapt. Thisbe either an instance of the filter, or thename of this filter.

  > name

  >   the name of the vtk object created.

## vector_cut_plane

mayavi.tools.pipeline.vector_cut_plane(*args, **kwargs)
  ::

    Applies the VectorCutPlane mayavi module to the given data

  source (Mayavi source, or VTK dataset).

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > mask_points

  >   If supplied, only one out of ‘mask_points’ data point is displayed. This option is useful to reduce the number of points displayed on large datasets Must be an integer (int or long) or None.

  > mode

  >   the mode of the glyphs. Must be ‘2darrow’ or ‘2dcircle’ or ‘2dcross’ or ‘2ddash’ or ‘2ddiamond’ or ‘2dhooked_arrow’ or ‘2dsquare’ or ‘2dthick_arrow’ or ‘2dthick_cross’ or ‘2dtriangle’ or ‘2dvertex’ or ‘arrow’ or ‘axes’ or ‘cone’ or ‘cube’ or ‘cylinder’ or ‘point’ or ‘sphere’. Default: 2darrow

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > plane_orientation

  >   the orientation of the plane Must be a legal value. Default: x_axes

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > resolution

  >   The resolution of the glyph created. For spheres, for instance, this is the number of divisions along theta and phi. Must be an integer (int or long). Default: 8

  > scale_factor

  >   the scaling applied to the glyphs. The size of the glyph is by default in drawing units. Must be a float. Default: 1.0

  > scale_mode

  >   the scaling mode for the glyphs (‘vector’, ‘scalar’, or ‘none’).

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > view_controls

  >   Whether or not the controls of the cut plane are shown. Must be a boolean. Default: True

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## vectors

mayavi.tools.pipeline.vectors(*args, **kwargs)

  Applies the Vectors mayavi module to the given data object source (Mayavi source, or VTK dataset).

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > mask_points

  >   If supplied, only one out of ‘mask_points’ data point is displayed. This option is useful to reduce the number of points displayed on large datasets Must be an integer (int or long) or None.

  > mode

  >   the mode of the glyphs. Must be ‘2darrow’ or ‘2dcircle’ or ‘2dcross’ or ‘2ddash’ or ‘2ddiamond’ or ‘2dhooked_arrow’ or ‘2dsquare’ or ‘2dthick_arrow’ or ‘2dthick_cross’ or ‘2dtriangle’ or ‘2dvertex’ or ‘arrow’ or ‘axes’ or ‘cone’ or ‘cube’ or ‘cylinder’ or ‘point’ or ‘sphere’. Default: 2darrow

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > resolution

  >   The resolution of the glyph created. For spheres, for instance, this is the number of divisions along theta and phi. Must be an integer (int or long). Default: 8

  > scale_factor

  >   the scaling applied to the glyphs. The size of the glyph is by default in drawing units. Must be a float. Default: 1.0

  > scale_mode

  >   the scaling mode for the glyphs (‘vector’, ‘scalar’, or ‘none’).

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used

## volume

mayavi.tools.pipeline.volume(*args, **kwargs)
  ::

    Applies the Volume mayavi module to the given VTK data

  source (Mayavi source, or VTK dataset).

  Note

  The range of the colormap can be changed simply using the vmin/vmax parameters (see below). For more complex modifications of the colormap, here is some pseudo code to change the ctf (color transfer function), or the otf (opacity transfer function):

      vol = mlab.pipeline.volume(src)

      # Changing the ctf:
      from tvtk.util.ctf import ColorTransferFunction
      ctf = ColorTransferFunction()
      ctf.add_rgb_point(value, r, g, b)  # r, g, and b are float
                                         # between 0 and 1
      ctf.add_hsv_point(value, h, s, v)
      # ...
      vol._volume_property.set_color(ctf)
      vol._ctf = ctf
      vol.update_ctf = True

      # Changing the otf:
      from tvtk.util.ctf import PiecewiseFunction
      otf = PiecewiseFunction()
      otf.add_point(value, opacity)
      vol._otf = otf
      vol._volume_property.set_scalar_opacity(otf)

  Also, it might be useful to change the range of the ctf:

      ctf.range = [0, 1]

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

  > vmax

  >   vmax is used to scale the transparency gradient. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the transparency gradient. If None, the min of the data will be used

## vorticity

mayavi.tools.pipeline.vorticity(*args, **kwargs)

  Calculate the vorticity (curl) of input vector field

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## warp_scalar

mayavi.tools.pipeline.warp_scalar(*args, **kwargs)

  Applies the WarpScalar mayavi filter to the given VTK object.

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

  > warp_scale

  >   scale of the warp scalar

## warp_vector

mayavi.tools.pipeline.warp_vector(*args, **kwargs)

  Move points of data along the vector data at point

  Keyword arguments:

  > figure

  >   Must be a Scene or None.

  > name

  >   the name of the vtk object created.

## warp_vector_cut_plane

mayavi.tools.pipeline.warp_vector_cut_plane(*args, **kwargs)

  Warp cut plane along scaled input vectors

  Keyword arguments:

  > color

  >   the color of the vtk object. Overides the colormap, if any, when specified. This is specified as a triplet of float ranging from 0 to 1, eg (1, 1, 1) for white.

  > colormap

  >   type of colormap to use.

  > extent

  >   [xmin, xmax, ymin, ymax, zmin, zmax] Default is the x, y, z arrays extent. Use this to change the extent of the object created.

  > figure

  >   Must be a Scene or None.

  > line_width

  >   The width of the lines, if any used. Must be a float. Default: 2.0

  > name

  >   the name of the vtk object created.

  > opacity

  >   The overall opacity of the vtk object. Must be a float. Default: 1.0

  > reset_zoom

  >   Reset the zoom to accomodate the data newly added to the scene. Defaults to True.

  > transparent

  >   make the opacity of the actor depend on the scalar.

  > vmax

  >   vmax is used to scale the colormap. If None, the max of the data will be used

  > vmin

  >   vmin is used to scale the colormap. If None, the min of the data will be used