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.

# Figure decoration functions

## colorbar

`mayavi.mlab.``colorbar`(object=None, title=None, orientation=None, nb_labels=None, nb_colors=None, label_fmt=None)

  Adds a colorbar for the color mapping of the given object.

  If the object has scalar data, the scalar color mapping is represented. Elsewhere the vector color mapping is represented, if available. If no object is specified, the first object with a color map in the scene is used.

  Keyword arguments:

  > object

  >   Optional object to get the color map from

  > title

  >   The title string

  > orientation

  >   Can be ‘horizontal’ or ‘vertical’

  > nb_labels

  >   The number of labels to display on the colorbar.

  > label_fmt

  >   The string formater for the labels. This needs to be a formater for float number, eg ‘%.1f’.

  > nb_colors

  >   The maximum number of colors displayed on the colorbar.

## scalarbar

`mayavi.mlab.``scalarbar`(object=None, title=None, orientation=None, nb_labels=None, nb_colors=None, label_fmt=None)

  Adds a colorbar for the scalar color mapping of the given object.

  If no object is specified, the first object with scalar data in the scene is used.

  Keyword arguments:

  > object

  >   Optional object to get the scalar color map from

  > title

  >   The title string

  > orientation

  >   Can be ‘horizontal’ or ‘vertical’

  > nb_labels

  >   The number of labels to display on the colorbar.

  > label_fmt

  >   The string formater for the labels. This needs to be a formater for float number, eg ‘%.1f’.

  > nb_colors

  >   The maximum number of colors displayed on the colorbar.

## vectorbar

`mayavi.mlab.``vectorbar`(object=None, title=None, orientation=None, nb_labels=None, nb_colors=None, label_fmt=None)

  Adds a colorbar for the vector color mapping of the given object.

  If no object is specified, the first object with vector data in the scene is used.

  Keyword arguments

  > object

  >   Optional object to get the vector color map from

  > title

  >   The title string

  > orientation

  >   Can be ‘horizontal’ or ‘vertical’

  > nb_labels

  >   The number of labels to display on the colorbar.

  > label_fmt

  >   The string formater for the labels. This needs to be a formater for float number, eg ‘%.1f’.

  > nb_colors

  >   The maximum number of colors displayed on the colorbar.

## xlabel

`mayavi.mlab.``xlabel`(text, object=None)

  Creates a set of axes if there isn’t already one, and sets the x label

  Keyword arguments:

  > object

  >   The object to apply the module to, if not the whole scene is searched for a suitable object.

## ylabel

`mayavi.mlab.``ylabel`(text, object=None)

  Creates a set of axes if there isn’t already one, and sets the y label

  Keyword arguments:

  > object

  >   The object to apply the module to, if not the whole scene is searched for a suitable object.

## zlabel

`mayavi.mlab.``zlabel`(text, object=None)

  Creates a set of axes if there isn’t already one, and sets the z label

  Keyword arguments

  > object

  >   The object to apply the module to, if not the whole scene is searched for a suitable object.