mne.read_events(filename, include=None, exclude=None, mask=None, mask_type=None)[source]

Read events from fif or text file.

See Epoching and averaging (ERP/ERF) as well as Reading an event file for more information about events.


filename : string

Name of the input file. If the extension is .fif, events are read assuming the file is in FIF format, otherwise (e.g., .eve, .lst, .txt) events are read as coming from text. Note that new format event files do not contain the “time” column (used to be the second column).

include : int | list | None

A event id to include or a list of them. If None all events are included.

exclude : int | list | None

A event id to exclude or a list of them. If None no event is excluded. If include is not None the exclude parameter is ignored.

mask : int | None

The value of the digital mask to apply to the stim channel values. If None (default), no masking is performed.

mask_type: ‘and’ | ‘not_and’

The type of operation between the mask and the trigger. Choose ‘and’ for MNE-C masking behavior. The default (‘not_and’) will change to ‘and’ in 0.16.

New in version 0.13.


events: array, shape (n_events, 3)

The list of events


This function will discard the offset line (i.e., first line with zero event number) if it is present in a text file.

For more information on mask and mask_type, see mne.find_events().

Examples using mne.read_events