mne.write_labels_to_annot

mne.write_labels_to_annot(labels, subject=None, parc=None, overwrite=False, subjects_dir=None, annot_fname=None, colormap='hsv', hemi='both', verbose=None)[source]

Create a FreeSurfer annotation from a list of labels.

Parameters
labelslist with instances of mne.Label

The labels to create a parcellation from.

subjectstr | None

The subject for which to write the parcellation.

parcstr | None

The parcellation name to use.

overwritebool

Overwrite files if they already exist.

subjects_dirstr, or None

Path to SUBJECTS_DIR if it is not set in the environment.

annot_fnamestr | None

Filename of the .annot file. If not None, only this file is written and ‘parc’ and ‘subject’ are ignored.

colormapstr

Colormap to use to generate label colors for labels that do not have a color specified.

hemi‘both’ | ‘lh’ | ‘rh’

The hemisphere(s) for which to write *.annot files (only applies if annot_fname is not specified; default is ‘both’).

verbosebool, str, int, or None

If not None, override default verbose level (see mne.verbose() and Logging documentation for more).

Notes

Vertices that are not covered by any of the labels are assigned to a label named “unknown”.