mne.read_epochs_eeglab#

mne.read_epochs_eeglab(input_fname, events=None, event_id=None, eog=(), *, uint16_codec=None, montage_units='auto', verbose=None)[source]#

Reader function for EEGLAB epochs files.

Parameters:
input_fnamepath-like

Path to the .set file. If the data is stored in a separate .fdt file, it is expected to be in the same folder as the .set file.

eventspath-like | array, shape (n_events, 3) | None

Path to events file. If array, it is the events typically returned by the read_events function. If some events don’t match the events of interest as specified by event_id, they will be marked as ‘IGNORED’ in the drop log. If None, it is constructed from the EEGLAB (.set) file with each unique event encoded with a different integer.

event_idint | list of int | dict | None

The id of the event to consider. If dict, the keys can later be used to access associated events. Example:

{"auditory":1, "visual":3}

If int, a dict will be created with the id as string. If a list, all events with the IDs specified in the list are used. If None, the event_id is constructed from the EEGLAB (.set) file with each descriptions copied from eventtype.

eoglist | tuple | ‘auto’

Names or indices of channels that should be designated EOG channels. If ‘auto’, the channel names containing EOG or EYE are used. Defaults to empty tuple.

uint16_codecstr | None

If your set file contains non-ascii characters, sometimes reading it may fail and give rise to error message stating that “buffer is too small”. uint16_codec allows to specify what codec (for example: ‘latin1’ or ‘utf-8’) should be used when reading character arrays and can therefore help you solve this problem.

montage_unitsstr

Units that channel positions are represented in. Defaults to “mm” (millimeters), but can be any prefix + “m” combination (including just “m” for meters).

New in v1.3.

Changed in version 1.6: Support for 'auto' was added and is the new default.

verbosebool | str | int | None

Control verbosity of the logging output. If None, use the default verbosity level. See the logging documentation and mne.verbose() for details. Should only be passed as a keyword argument.

Returns:
epochsinstance of Epochs

The epochs.

See also

mne.Epochs

Documentation of attributes and methods.

Notes

New in v0.11.0.

Examples using mne.read_epochs_eeglab#

Importing data from EEG devices

Importing data from EEG devices