eeg_getepochevent

eeg_getepochevent(EEG, *args, **kwargs)

Return a selected event-field value for each epoch.

Both EEGLAB’s positional form (type, timewin, fieldname) and its key/value form are accepted. Trial selections are 1-based; stored event fields such as urevent are returned in EEGPrep’s 0-based form. As in EEGLAB, numeric event types match by value (2, 2.0 and "2") and text types match exactly. Events of continuous data, where no event has an epoch field, belong to epoch 1.

Raises:

ValueError – an event has no epoch while others have one, or its epoch is outside 1..trials.

Parameters:

• EEG (dict[str, Any] | list[dict[str, Any]])

• args (Any)

• kwargs (Any)

Return type:

tuple[Any, list[list[Any]]]