mne.viz.plot_evoked_topo(evoked, layout=None, layout_scale=0.945, color=None, border='none', ylim=None, scalings=None, title=None, proj=False, vline=[0.0], fig_facecolor=None, fig_background=None, axis_facecolor=None, font_color='w', merge_grads=False, legend=True, axes=None, background_color=None, show=True)[source]

Plot 2D topography of evoked responses.

Clicking on the plot of an individual sensor opens a new figure showing the evoked response for the selected sensor.


evoked : list of Evoked | Evoked

The evoked response to plot.

layout : instance of Layout | None

Layout instance specifying sensor positions (does not need to be specified for Neuromag data). If possible, the correct layout is inferred from the data.

layout_scale: float

Scaling factor for adjusting the relative size of the layout on the canvas

color : list of color objects | color object | None

Everything matplotlib accepts to specify colors. If not list-like, the color specified will be repeated. If None, colors are automatically drawn.

border : str

matplotlib borders style to be used for each sensor plot.

ylim : dict | None

ylim for plots (after scaling has been applied). The value determines the upper and lower subplot limits. e.g. ylim = dict(eeg=[-20, 20]). Valid keys are eeg, mag, grad, misc. If None, the ylim parameter for each channel is determined by the maximum absolute peak.

scalings : dict | None

The scalings of the channel types to be applied for plotting. If None,` defaults to dict(eeg=1e6, grad=1e13, mag=1e15).

title : str

Title of the figure.

proj : bool | ‘interactive’

If true SSP projections are applied before display. If ‘interactive’, a check box for reversible selection of SSP projection vectors will be shown.

vline : list of floats | None

The values at which to show a vertical line.

fig_facecolor : str | obj

The figure face color. Defaults to black.


The parameter will be removed in version v0.16. Use background_color parameter instead.

fig_background : None | numpy ndarray

A background image for the figure. This must work with a call to plt.imshow. Defaults to None.

axis_facecolor : str | obj

The face color to be used for each sensor plot. Defaults to black.


The parameter will be removed in version v0.16. Use background_color parameter instead.

font_color : str | obj

The color of text in the colorbar and title. Defaults to white.


The parameter will be removed in version v0.16. Use background_color parameter instead.

merge_grads : bool

Whether to use RMS value of gradiometer pairs. Only works for Neuromag data. Defaults to False.

legend : bool | int | string | tuple

If True, create a legend based on evoked.comment. If False, disable the legend. Otherwise, the legend is created and the parameter value is passed as the location parameter to the matplotlib legend call. It can be an integer (e.g. 0 corresponds to upper right corner of the plot), a string (e.g. ‘upper right’), or a tuple (x, y coordinates of the lower left corner of the legend in the axes coordinate system). See matplotlib documentation for more details.

axes : instance of matplotlib Axes | None

Axes to plot into. If None, axes will be created.

background_color : str | obj

Background color. Typically ‘k’ (black) or ‘w’ (white). It will be set to ‘w’ by default in v0.16

New in version 0.15.0.

show : bool

Show figure if True.


fig : instance of matplotlib.figure.Figure

Images of evoked responses at sensor locations