mne.merge_events¶

mne.merge_events(events, ids, new_id, replace_events=True)[source]¶

Merge a set of events.

Parameters:	events : array, shape (n_events_in, 3) Events. ids : array of int The ids of events to merge. new_id : int The new id. replace_events : bool If True (default), old event ids are replaced. Otherwise, new events will be added to the old event list.
Returns:	new_events: array, shape (n_events_out, 3) The new events

Notes

Rather than merging events you can use hierarchical event_id in Epochs. For example, here:

>>> event_id = {'auditory/left': 1, 'auditory/right': 2}

And the condition ‘auditory’ would correspond to either 1 or 2.

Examples

Here is quick example of the behavior:

>>> events = [[134, 0, 1], [341, 0, 2], [502, 0, 3]]
>>> merge_events(events, [1, 2], 12, replace_events=True)
array([[134,   0,  12],
       [341,   0,  12],
       [502,   0,   3]])
>>> merge_events(events, [1, 2], 12, replace_events=False)
array([[134,   0,   1],
       [134,   0,  12],
       [341,   0,   2],
       [341,   0,  12],
       [502,   0,   3]])