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.

8.2.11. nilearn.datasets.fetch_atlas_aal

nilearn.datasets.fetch_atlas_aal(version='SPM12', data_dir=None, url=None, resume=True, verbose=1)[source]

Downloads and returns the AAL template for SPM 12.

This atlas is the result of an automated anatomical parcellation of the spatially normalized single-subject high-resolution T1 volume provided by the Montreal Neurological Institute (MNI) (D. L. Collins et al., 1998, Trans. Med. Imag. 17, 463-468, PubMed).

For more information on this dataset’s structure, see 1, and 2.

versionstring {‘SPM12’, ‘SPM5’, ‘SPM8’}, optional

The version of the AAL atlas. Must be SPM5, SPM8 or SPM12. Default=’SPM12’.

data_dirpathlib.Path or str, optional

Path where data should be downloaded. By default, files are downloaded in home directory.

urlstr, optional

URL of file to download. Override download URL. Used for test only (or if you setup a mirror of the data). Default=None.

resumebool, optional

Whether to resume download of a partly-downloaded file. Default=True.

verboseint, optional

Verbosity level (0 means no message). Default=1.


Dictionary-like object, keys are:

  • “maps”: str. path to nifti file containing regions.

  • “labels”: list of the names of the regions


Licence: unknown.



Aal template for spm 12. Accessed: 2021-05-19.


N. Tzourio-Mazoyer, B. Landeau, D. Papathanassiou, F. Crivello, O. Etard, N. Delcroix, B. Mazoyer, and M. Joliot. Automated anatomical labeling of activations in spm using a macroscopic anatomical parcellation of the mni mri single-subject brain. NeuroImage, 15(1):273–289, 2002. URL:, doi: