mne.random_parcellation#

mne.random_parcellation(subject, n_parcel, hemi, subjects_dir=None, surface='white', random_state=None)[source]#

Generate random cortex parcellation by growing labels.

This function generates a number of labels which don’t intersect and cover the whole surface. Regions are growing around randomly chosen seeds.

Parameters:
subjectstr

The FreeSurfer subject name.

n_parcelint

Total number of cortical parcels.

hemistr

Hemisphere id (ie 'lh', 'rh', 'both'). In the case of 'both', both hemispheres are processed with (n_parcel // 2) parcels per hemisphere.

subjects_dirpath-like | None

The path to the directory containing the FreeSurfer subjects reconstructions. If None, defaults to the SUBJECTS_DIR environment variable.

surfacestr

The surface along which to do the computations, defaults to 'white' (the gray-white matter boundary).

random_stateNone | int | instance of RandomState

A seed for the NumPy random number generator (RNG). If None (default), the seed will be obtained from the operating system (see RandomState for details), meaning it will most likely produce different output every time this function or method is run. To achieve reproducible results, pass a value here to explicitly initialize the RNG with a defined state.

Returns:
labelslist of Label

Random cortex parcellation.