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', sort=True, table_name='MNE-Python Colortable', verbose=None)[source]¶
Create a FreeSurfer annotation from a list of labels.
- Parameters
- labels
list
with instances ofmne.Label
The labels to create a parcellation from.
- subject
str
|None
The subject for which to write the parcellation.
- parc
str
|None
The parcellation name to use.
- overwritebool
Overwrite files if they already exist.
- subjects_dir
str
|None
The path to the FreeSurfer subjects reconstructions. It corresponds to FreeSurfer environment variable
SUBJECTS_DIR
.- annot_fname
str
|None
Filename of the .annot file. If not None, only this file is written and ‘parc’ and ‘subject’ are ignored.
- colormap
str
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’).
- sortbool
If True (default), labels will be sorted by name before writing.
New in version 0.21.0.
- table_name
str
The table name to use for the colortable.
New in version 0.21.0.
- verbosebool,
str
,int
, orNone
If not None, override default verbose level (see
mne.verbose()
and Logging documentation for more). If used, it should be passed as a keyword-argument only.
- labels
See also
Notes
Vertices that are not covered by any of the labels are assigned to a label named “unknown”.