Skip to main content

mne_morph_labels

Overview

mne_morph_labels morphs cortical label files from one subject's surface to another using the FreeSurfer spherical registration. This enables transferring ROI definitions across subjects for group analysis.

This is a C++ port of the original MNE-C tool by Matti Hämäläinen.

Usage

mne_morph_labels [options]

Options

OptionDescription
--from <subject>Source subject name
--to <subject>Destination subject name
--subjects_dir <dir>Subjects directory (default: $SUBJECTS_DIR)
--hemi <hemi>Hemisphere: lh or rh
--label <file>Input label file
--out <file>Output morphed label file
--helpPrint help
--versionPrint version

Description

The tool maps vertex coordinates from one subject's spherical surface registration to another's, effectively transferring cortical labels (ROIs) between subjects. This relies on the FreeSurfer ?h.sphere.reg surfaces.

Workflow Context

Label morphing is used in group analysis workflows:

  1. Define labels on one subject or on fsaveragemne_annot2labels or FreeSurfer tools
  2. Morph labels to each subject → mne_morph_labels
  3. Use subject-specific labels for ROI analysis → mne_compute_mne

This requires that the FreeSurfer spherical registration (?h.sphere.reg) is available for both subjects.

Example

# Morph a label from fsaverage to subject sam
mne_morph_labels --from fsaverage --to sam --hemi lh --label V1.label --out sam-V1.label