Note

This page is a reference documentation. It only explains the function signature, and not how to use it. Please refer to the user guide for the big picture.

nilearn.datasets.load_mni152_gm_mask

nilearn.datasets.load_mni152_gm_mask(resolution=None, threshold=0.2, n_iter=2)[source]

Load the MNI152 grey-matter mask.

This function takes the grey-matter MNI152 template and threshold it, in order to obtain the corresponding grey-matter mask.

The default template of fMRIPrep is the asymmetrical ICBM152 2009, release c (MNI152NLin2009cSAsym). The NiLearn template is asymmetrical ICBM152 2009, release a. If you wish to use the exact same release as fMRIPrep, please refer to TemplateFlow (https://www.templateflow.org/).

Added in version 0.8.1.

Parameters:
resolutionint, default=None

Resolution in millimeters. If resolution is different from 1, the template is re-sampled with the specified resolution. Default to 1 if None is passed.

thresholdfloat, default=0.2

Values of the grey-matter MNI152 template above this threshold will be included.

n_iterint, default=2

Number of repetitions of dilation and erosion steps performed in scipy.ndimage.binary_closing function.

Returns:
gm_mask_imgNifti1Image, image corresponding to the grey-matter mask.

See also

nilearn.datasets.load_mni152_gm_template

for details about version of the MNI152 grey-matter template and related.

Notes

For more information see the dataset description.