mne.export.export_evokeds#

mne.export.export_evokeds(fname, evoked, fmt='auto', *, overwrite=False, verbose=None)[source]#

Export evoked dataset to external formats.

This function is a wrapper for format-specific export functions. The export function is selected based on the inferred file format. For additional options, use the format-specific functions.

Supported formats:

Warning

Since we are exporting to external formats, there’s no guarantee that all the info will be preserved in the external format. See Notes for details.

Parameters:
fnamestr

Name of the output file.

evokedEvoked instance, or list of Evoked instances

The evoked dataset, or list of evoked datasets, to export to one file. Note that the measurement info from the first evoked instance is used, so be sure that information matches.

fmt‘auto’ | ‘mff’

Format of the export. Defaults to 'auto', which will infer the format from the filename extension. See supported formats above for more information.

overwritebool

If True (default False), overwrite the destination file if it exists.

New in version 0.24.1.

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.

Notes

New in version 0.24.

Export to external format may not preserve all the information from the instance. To save in native MNE format (.fif) without information loss, use mne.Evoked.save() instead. Export does not apply projector(s). Unapplied projector(s) will be lost. Consider applying projector(s) before exporting with mne.Evoked.apply_proj().