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_difumo

nilearn.datasets.fetch_atlas_difumo(dimension=64, resolution_mm=2, data_dir=None, resume=True, verbose=1, legacy_format=False)[source]

Fetch DiFuMo brain atlas.

Dictionaries of Functional Modes, or “DiFuMo”, can serve as probabilistic atlases to extract functional signals with different dimensionalities (64, 128, 256, 512, and 1024). These modes are optimized to represent well raw BOLD timeseries, over a with range of experimental conditions. See Dadi et al.[1].

Added in version 0.7.1.

Parameters:
dimensionint, default=64

Number of dimensions in the dictionary. Valid resolutions available are {64, 128, 256, 512, 1024}.

resolution_mmint, default=2mm

The resolution in mm of the atlas to fetch. Valid options available are {2, 3}.

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.

resumebool, default=True

Whether to resume download of a partly-downloaded file.

verboseint, default=1

Verbosity level (0 means no message).

legacy_formatbool, default=True

If set to True, the fetcher will return recarrays. Otherwise, it will return pandas dataframes.

Returns:
datasklearn.utils.Bunch

Dictionary-like object, the interest attributes are :

  • ‘maps’: str, path to 4D nifti file containing regions definition. The shape of the image is (104, 123, 104, dimension) where dimension is the requested dimension of the atlas.

  • ‘labels’: numpy.recarray containing the labels of the regions. The length of the label array corresponds to the number of dimensions requested. data.labels[i] is the label corresponding to volume i in the ‘maps’ image. If legacy_format is set to False, this is a pandas.DataFrame.

  • ‘description’: str, general description of the dataset.

Notes

Direct download links from OSF:

References

Examples using nilearn.datasets.fetch_atlas_difumo

Comparing connectomes on different reference atlases

Comparing connectomes on different reference atlases