mne.read_annotations

mne.read_annotations(fname, sfreq='auto', uint16_codec=None)[source]

Read annotations from a file.

This function reads a .fif, .fif.gz, .vrmk, .edf, .txt, .csv or .set file and makes an mne.Annotations object.

Parameters
fnamestr

The filename.

sfreqfloat | ‘auto’

The sampling frequency in the file. This parameter is necessary for *.vmrk files as Annotations are expressed in seconds and *.vmrk files are in samples. For any other file format, sfreq is omitted. If set to ‘auto’ then the sfreq is taken from the *.vhdr file that has the same name (without file extension). So data.vrmk looks for sfreq in data.vhdr.

uint16_codecstr | None

This parameter is only used in EEGLAB (*.set) and omitted otherwise. 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.

Returns
annotinstance of Annotations | None

The annotations.

Notes

The annotations stored in a .csv require the onset columns to be timestamps. If you have onsets as floats (in seconds), you should use the .txt extension.