Function read_labels_from_annot

mne/label.py:2249–2374

Read labels from a FreeSurfer annotation file. Note: Only cortical labels will be returned. Parameters ---------- %(subject)s parc : str The parcellation to use, e.g., ``'aparc'`` or ``'aparc.a2009s'``. hemi : str The hemisphere from which to read the parcel

(
    subject,
    parc="aparc",
    hemi="both",
    surf_name="white",
    annot_fname=None,
    regexp=None,
    subjects_dir=None,
    sort=True,
    verbose=None,
)

@verbose
def read_labels_from_annot(
    subject,
    parc="aparc",
    hemi="both",
    surf_name="white",
    annot_fname=None,
    regexp=None,
    subjects_dir=None,
    sort=True,
    verbose=None,
):
    """Read labels from a FreeSurfer annotation file.

    Note: Only cortical labels will be returned.

    Parameters
    ----------
    %(subject)s
    parc : str
        The parcellation to use, e.g., ``'aparc'`` or ``'aparc.a2009s'``.
    hemi : str
        The hemisphere from which to read the parcellation, can be ``'lh'``,
        ``'rh'``, or ``'both'``.
    surf_name : str
        Surface used to obtain vertex locations, e.g., ``'white'``, ``'pial'``.
    annot_fname : path-like | None
        Filename of the ``.annot`` file. If not None, only this file is read
        and the arguments ``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)s
    sort : bool
        If true, labels will be sorted by name before being returned.

        .. versionadded:: 0.21.0
    %(verbose)s

    Returns
    -------
    labels : list of Label
        The labels, sorted by label name (ascending).

    See Also
    --------
    write_labels_to_annot
    morph_labels
    """
    logger.info("Reading labels from parcellation...")

    subjects_dir = get_subjects_dir(subjects_dir)
    if subjects_dir is not None:
        subjects_dir = str(subjects_dir)

    # get the .annot filenames and hemispheres
    annot_fname, hemis = _get_annot_fname(
        annot_fname, subject, hemi, parc, subjects_dir