read_events(filename, include=None, exclude=None, mask=None, mask_type='and', return_event_id=False, verbose=None)¶
Read events from fif or text file.
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).
A event id to include or a list of them. If None all events are included.
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.
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’ (default) for MNE-C masking behavior.
New in version 0.13.
event_idwill be returned. This is only possible for
-annot.fiffiles produced with MNE-C
New in version 0.20.
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