mne.viz.plot_head_positions#

mne.viz.plot_head_positions(pos, mode='traces', cmap='viridis', direction='z', show=True, destination=None, info=None, color='k', axes=None)[source]#

Plot head positions.

Parameters:
posndarray, shape (n_pos, 10) | list of ndarray

The head position data. Can also be a list to treat as a concatenation of runs.

modestr

Can be ‘traces’ (default) to show position and quaternion traces, or ‘field’ to show the position as a vector field over time.

cmapcolormap

Colormap to use for the trace plot, default is “viridis”.

directionstr

Can be any combination of “x”, “y”, or “z” (default: “z”) to show directional axes in “field” mode.

showbool

Show figure if True. Defaults to True.

destinationstr | array_like, shape (3,) | None

The destination location for the head, assumed to be in head coordinates. See mne.preprocessing.maxwell_filter() for details.

New in v0.16.

infomne.Info | None

The mne.Info object with information about the sensors and methods of measurement. If provided, will be used to show the destination position when destination is None, and for showing the MEG sensors.

New in v0.16.

colorcolor object

The color to use for lines in mode == 'traces' and quiver arrows in mode == 'field'.

New in v0.16.

axesarray_like, shape (3, 2)

The matplotlib axes to use. Only used for mode == 'traces'.

New in v0.16.

Returns:
figinstance of matplotlib.figure.Figure

The figure.

Examples using mne.viz.plot_head_positions#

Extracting and visualizing subject head movement

Extracting and visualizing subject head movement

Signal-space separation (SSS) and Maxwell filtering

Signal-space separation (SSS) and Maxwell filtering

Maxwell filter data with movement compensation

Maxwell filter data with movement compensation

Annotate movement artifacts and reestimate dev_head_t

Annotate movement artifacts and reestimate dev_head_t