Note

This page is a reference documentation. It only explains the class signature, and not how to use it. Please refer to the user guide for the big picture.

nilearn.plotting.displays.BaseSlicer

class nilearn.plotting.displays.BaseSlicer(cut_coords, axes=None, black_bg=False, brain_color=(0.5, 0.5, 0.5), **kwargs)[source]

BaseSlicer implementation which main purpose is to auto adjust the axes size to the data with different layout of cuts.

It creates 3 linked axes for plotting orthogonal cuts.

Attributes:
cut_coords3 tuple of int

The cut position, in world space.

frame_axesmatplotlib.axes.Axes, optional

The matplotlib axes that will be subdivided in 3.

black_bgbool, default=False

Return black background.

brain_colortuple, default=(0.5, 0.5, 0.5)

Return brain color.

__init__(cut_coords, axes=None, black_bg=False, brain_color=(0.5, 0.5, 0.5), **kwargs)[source]
property brain_color

Return brain color.

property black_bg

Return black background.

static find_cut_coords(img=None, threshold=None, cut_coords=None)[source]

Act as placeholder and is not implemented in the base class and has to be implemented in derived classes.

classmethod init_with_figure(img, threshold=None, cut_coords=None, figure=None, axes=None, black_bg=False, leave_space=False, colorbar=False, brain_color=(0.5, 0.5, 0.5), **kwargs)[source]

Initialize the slicer with an image.

Parameters:
imgNiimg-like object

See Input and output: neuroimaging data representation.

cut_coords3 tuple of int

The cut position, in world space.

axesmatplotlib.axes.Axes, optional

The axes that will be subdivided in 3.

black_bgbool, default=False

If True, the background of the figure will be put to black. If you wish to save figures with a black background, you will need to pass facecolor='k', edgecolor='k' to matplotlib.pyplot.savefig.

brain_colortuple, default=(0.5, 0.5, 0.5)

The brain color to use as the background color (e.g., for transparent colorbars).

title(text, x=0.01, y=0.99, size=15, color=None, bgcolor=None, alpha=1, **kwargs)[source]

Write a title to the view.

Parameters:
textstr

The text of the title.

xfloat, default=0.01

The horizontal position of the title on the frame in fraction of the frame width.

yfloat, default=0.99

The vertical position of the title on the frame in fraction of the frame height.

sizeint, default=15

The size of the title text.

colormatplotlib color specifier, optional

The color of the font of the title.

bgcolormatplotlib color specifier, optional

The color of the background of the title.

alphafloat, default=1

The alpha value for the background.

kwargs

Extra keyword arguments are passed to matplotlib’s text function.

add_overlay(img, threshold=1e-06, colorbar=False, cbar_tick_format='%.2g', cbar_vmin=None, cbar_vmax=None, **kwargs)[source]

Plot a 3D map in all the views.

Parameters:
imgNiimg-like object

See Input and output: neuroimaging data representation. If it is a masked array, only the non-masked part will be plotted.

thresholdint or float or None, default=1e-6

Threshold to apply:

  • 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 (in absolute value) are plotted as transparent.

cbar_tick_format: str, default=”%.2g” (scientific notation)

Controls how to format the tick labels of the colorbar. Ex: use “%i” to display as integers.

colorbarbool, default=False

If True, display a colorbar on the right of the plots.

kwargsdict

Extra keyword arguments are passed to function imshow.

cbar_vminfloat, optional

Minimal value for the colorbar. If None, the minimal value is computed based on the data.

cbar_vmaxfloat, optional

Maximal value for the colorbar. If None, the maximal value is computed based on the data.

add_contours(img, threshold=1e-06, filled=False, **kwargs)[source]

Contour a 3D map in all the views.

Parameters:
imgNiimg-like object

See Input and output: neuroimaging data representation. Provides image to plot.

thresholdint or float or None, default=1e-6

Threshold to apply:

  • 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 (in absolute value) are plotted as transparent.

filledbool, default=False

If filled=True, contours are displayed with color fillings.

kwargsdict

Extra keyword arguments are passed to function contour, or function contourf. Useful, arguments are typical “levels”, which is a list of values to use for plotting a contour or contour fillings (if filled=True), and “colors”, which is one color or a list of colors for these contours.

Notes

If colors are not specified, default coloring choices (from matplotlib) for contours and contour_fillings can be different.

add_edges(img, color='r')[source]

Plot the edges of a 3D map in all the views.

Parameters:
imgNiimg-like object

See Input and output: neuroimaging data representation. The 3D map to be plotted. If it is a masked array, only the non-masked part will be plotted.

colormatplotlib color: str or (r, g, b) value, default=’r’

The color used to display the edge map.

add_markers(marker_coords, marker_color='r', marker_size=30, **kwargs)[source]

Add markers to the plot.

Parameters:
marker_coordsndarray of shape (n_markers, 3)

Coordinates of the markers to plot. For each slice, only markers that are 2 millimeters away from the slice are plotted.

marker_colorpyplot compatible color or list of shape (n_markers,), default=’r’

List of colors for each marker that can be string or matplotlib colors.

marker_sizefloat or list of float of shape (n_markers,), default=30

Size in pixel for each marker.

annotate(left_right=True, positions=True, scalebar=False, size=12, scale_size=5.0, scale_units='cm', scale_loc=4, decimals=0, **kwargs)[source]

Add annotations to the plot.

Parameters:
left_rightbool, default=True

If True, annotations indicating which side is left and which side is right are drawn.

positionsbool, default=True

If True, annotations indicating the positions of the cuts are drawn.

scalebarbool, default=False

If True, cuts are annotated with a reference scale bar. For finer control of the scale bar, please check out the draw_scale_bar method on the axes in “axes” attribute of this object.

sizeint, default=12

The size of the text used.

scale_sizeint or float, default=5.0

The length of the scalebar, in units of scale_units.

scale_units{‘cm’, ‘mm’}, default=’cm’

The units for the scalebar.

scale_locint, default=4

The positioning for the scalebar. Valid location codes are:

  • 1: “upper right”

  • 2: “upper left”

  • 3: “lower left”

  • 4: “lower right”

  • 5: “right”

  • 6: “center left”

  • 7: “center right”

  • 8: “lower center”

  • 9: “upper center”

  • 10: “center”

decimalsint, default=0

Number of decimal places on slice position annotation. If zero, the slice position is integer without decimal point.

kwargsdict

Extra keyword arguments are passed to matplotlib’s text function.

close()[source]

Close the figure.

This is necessary to avoid leaking memory.

savefig(filename, dpi=None)[source]

Save the figure to a file.

Parameters:
filenamestr

The file name to save to. Its extension determines the file type, typically ‘.png’, ‘.svg’ or ‘.pdf’.

dpiNone or scalar, default=None

The resolution in dots per inch.