mne.viz.plot_topo_image_epochs#

mne.viz.plot_topo_image_epochs(epochs, layout=None, sigma=0.0, vmin=None, vmax=None, colorbar=None, order=None, cmap='RdBu_r', layout_scale=0.95, title=None, scalings=None, border='none', fig_facecolor='k', fig_background=None, font_color='w', show=True)[source]#

Plot Event Related Potential / Fields image on topographies.

Parameters:

epochsinstance of Epochs: The epochs.
layoutinstance of Layout: System specific sensor positions.
sigmafloat: The standard deviation of the Gaussian smoothing to apply along the epoch axis to apply in the image. If 0., no smoothing is applied.
vminfloat: The min value in the image. The unit is µV for EEG channels, fT for magnetometers and fT/cm for gradiometers.
vmaxfloat: The max value in the image. The unit is µV for EEG channels, fT for magnetometers and fT/cm for gradiometers.
colorbarbool | None: Whether to display a colorbar or not. If None a colorbar will be shown only if all channels are of the same type. Defaults to None.
orderNone | array of int | callable(): If not None, order is used to reorder the epochs on the y-axis of the image. If it’s an array of int it should be of length the number of good epochs. If it’s a callable the arguments passed are the times vector and the data as 2d array (data.shape[1] == len(times)).
cmapcolormap: Colors to be mapped to the values.
layout_scalefloat: Scaling factor for adjusting the relative size of the layout on the canvas.
titlestr: Title of the figure.
scalingsdict | None: The scalings of the channel types to be applied for plotting. If None, defaults to dict(eeg=1e6, grad=1e13, mag=1e15).
borderstr: Matplotlib borders style to be used for each sensor plot.
fig_facecolorcolor: The figure face color. Defaults to black.
fig_backgroundNone | array: A background image for the figure. This must be a valid input to matplotlib.pyplot.imshow(). Defaults to None.
font_colorcolor: The color of tick labels in the colorbar. Defaults to white.
showbool: Whether to show the figure. Defaults to True.

Returns:

figinstance of matplotlib.figure.Figure: Figure distributing one image per channel across sensor topography.

Notes

In an interactive Python session, this plot will be interactive; clicking on a channel image will pop open a larger view of the image; this image will always have a colorbar even when the topo plot does not (because it shows multiple sensor types).