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.fetch_atlas_basc_multiscale_2015

nilearn.datasets.fetch_atlas_basc_multiscale_2015(data_dir=None, url=None, resume=True, verbose=1, resolution=None, version='sym')

Download and load multiscale functional brain parcellations.

This Deterministic atlas includes group brain parcellations generated from resting-state functional magnetic resonance images from about 200 young healthy subjects.

Multiple resolutions (number of networks) are available, among 7, 12, 20, 36, 64, 122, 197, 325, 444. The brain parcellations have been generated using a method called bootstrap analysis of stable clusters called as BASC Bellec et al.[1], and the resolutions have been selected using a data-driven method called MSTEPS Bellec[2].

Note that two versions of the template are available, ‘sym’ or ‘asym’. The ‘asym’ type contains brain images that have been registered in the asymmetric version of the MNI brain template (reflecting that the brain is asymmetric), while the ‘sym’ type contains images registered in the symmetric version of the MNI template. The symmetric template has been forced to be symmetric anatomically, and is therefore ideally suited to study homotopic functional connections in fMRI: finding homotopic regions simply consists of flipping the x-axis of the template.

New in version 0.2.3.

Parameters:

data_dirpathlib.Path or str, optional

Path where data should be downloaded. By default, files are downloaded in a nilearn_data folder in the home directory of the user. See also nilearn.datasets.utils.get_data_dirs.

urlstr, default=None

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

resumebool, default=True

Whether to resume download of a partly-downloaded file.

verboseint, default=1

Verbosity level (0 means no message).

resolution: :ob:`int`, optional

Number of networks in the dictionary. Valid resolutions available are {7, 12, 20, 36, 64, 122, 197, 325, 444}

version{‘sym’, ‘asym’}, default=’sym’

Available versions are ‘sym’ or ‘asym’. By default all scales of brain parcellations of version ‘sym’ will be returned.

Returns:

datasklearn.utils.Bunch

Dictionary-like object, Keys are:

• “scale007”, “scale012”, “scale020”, “scale036”, “scale064”, “scale122”, “scale197”, “scale325”, “scale444”: str, path to Nifti file of various scales of brain parcellations. Images have shape (53, 64, 52) and contain consecutive integer values from 0 to the selected number of networks (scale).

• “description”: str, details about the data release.

Warns:

DeprecationWarning

If a resolution input is provided, the current behavior (returning multiple maps) is deprecated. Starting in version 0.13, one map will be returned in a ‘maps’ dict key depending on the resolution and version value.

Notes

For more information on this dataset’s structure, see https://figshare.com/articles/basc/1285615

References

[1]

Pierre Bellec, Pedro Rosa-Neto, Oliver C. Lyttelton, Habib Benali, and Alan C. Evans. Multi-level bootstrap analysis of stable clusters in resting-state fmri. NeuroImage, 51(3):1126–1139, 2010. URL: https://www.sciencedirect.com/science/article/pii/S1053811910002697, doi:https://doi.org/10.1016/j.neuroimage.2010.02.082.

[2]

Pierre Bellec. Mining the hierarchy of resting-state brain networks: selection of representative clusters in a multiscale structure. In 2013 International Workshop on Pattern Recognition in Neuroimaging, volume, 54–57. 06 2013. doi:10.1109/PRNI.2013.23.