mne.read_labels_from_annot¶

mne.read_labels_from_annot(subject, parc='aparc', hemi='both', surf_name='white', annot_fname=None, regexp=None, subjects_dir=None, sort=True, verbose=None)[source]¶

Read labels from a FreeSurfer annotation file.

Note: Only cortical labels will be returned.

Parameters

subjectstr: The FreeSurfer subject name.
parcstr: The parcellation to use, e.g., ‘aparc’ or ‘aparc.a2009s’.
hemistr: The hemisphere from which to read the parcellation, can be ‘lh’, ‘rh’, or ‘both’.
surf_namestr: Surface used to obtain vertex locations, e.g., ‘white’, ‘pial’.
annot_fnamestr or None: Filename of the .annot file. If not None, only this file is read and ‘parc’ and ‘hemi’ are ignored.
regexpstr: Regular expression or substring to select particular labels from the parcellation. E.g. ‘superior’ will return all labels in which this substring is contained.
subjects_dirstr | pathlib.Path | None: The path to the directory containing the FreeSurfer subjects reconstructions. If None, defaults to the SUBJECTS_DIR environment variable.
sortbool: If true, labels will be sorted by name before being returned.

New in version 0.21.0.
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