nipy.labs.viz_tools.activation_maps.plot_map(map, affine, cut_coords=None, anat=None, anat_affine=None, slicer='ortho', figure=None, axes=None, title=None, threshold=None, annotate=True, draw_cross=True, do3d=False, threshold_3d=None, view_3d=(38.5, 70.5, 300, (-2.7, -12, 9.1)), black_bg=False, **imshow_kwargs)

Plot three cuts of a given activation map (Frontal, Axial, and Lateral)

map3D ndarray

The activation map, as a 3D image.

affine4x4 ndarray

The affine matrix going from image voxel space to MNI space.

cut_coords: None, int, or a tuple of floats

The MNI coordinates of the point where the cut is performed, in MNI coordinates and order. If slicer is ‘ortho’, this should be a 3-tuple: (x, y, z) For slicer == ‘x’, ‘y’, or ‘z’, then these are the coordinates of each cut in the corresponding direction. If None or an int is given, then a maximally separated sequence ( with exactly cut_coords elements if cut_coords is not None) of cut coordinates along the slicer axis is computed automatically

anat3D ndarray or False, optional

The anatomical image to be used as a background. If None, the MNI152 T1 1mm template is used. If False, no anat is displayed.

anat_affine4x4 ndarray, optional

The affine matrix going from the anatomical image voxel space to MNI space. This parameter is not used when the default anatomical is used, but it is compulsory when using an explicite anatomical image.

slicer: {‘ortho’, ‘x’, ‘y’, ‘z’}

Choose the direction of the cuts. With ‘ortho’ three cuts are performed in orthogonal directions

figureinteger or matplotlib figure, optional

Matplotlib figure used or its number. If None is given, a new figure is created.

axesmatplotlib axes or 4 tuple of float: (xmin, ymin, width, height), optional

The axes, or the coordinates, in matplotlib figure space, of the axes used to display the plot. If None, the complete figure is used.

titlestring, optional

The title dispayed on the figure.

thresholda number, None, or ‘auto’

If None is given, the maps are not thresholded. If a number is given, it is used to threshold the maps: values below the threshold are plotted as transparent. If auto is given, the threshold is determined magically by analysis of the map.

annotate: boolean, optional

If annotate is True, positions and left/right annotation are added to the plot.

draw_cross: boolean, optional

If draw_cross is True, a cross is drawn on the plot to indicate the cut plosition.

do3d: {True, False or ‘interactive’}, optional

If True, Mayavi is used to plot a 3D view of the map in addition to the slicing. If ‘interactive’, the 3D visualization is displayed in an additional interactive window.


The threshold to use for the 3D view (if any). Defaults to the same threshold as that used for the 2D view.

view_3d: tuple,

The view used to take the screenshot: azimuth, elevation, distance and focalpoint, see the docstring of mlab.view.

black_bg: boolean, optional

If True, the background of the image is set to be black. If you whish to save figures with a black background, you will need to pass “facecolor=’k’, edgecolor=’k’” to pylab’s savefig.

imshow_kwargs: extra keyword arguments, optional

Extra keyword arguments passed to pylab.imshow


Arrays should be passed in numpy convention: (x, y, z) ordered.

Use masked arrays to create transparency:

import numpy as np map =, 0.5) plot_map(map, affine)