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

Read labels from a FreeSurfer annotation file.

Note: Only cortical labels will be returned.


subject : str

The subject for which to read the parcellation for.

parc : str

The parcellation to use, e.g., ‘aparc’ or ‘aparc.a2009s’.

hemi : str

The hemisphere to read the parcellation for, can be ‘lh’, ‘rh’, or ‘both’.

surf_name : str

Surface used to obtain vertex locations, e.g., ‘white’, ‘pial’

annot_fname : str or None

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

regexp : str

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_dir : string, or None

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

verbose : bool, str, int, or None

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


labels : list of Label

The labels, sorted by label name (ascending).